Dôkaz o doručení

Org-scoped dôkaz o doručení odoslanej faktúry cez GET /v1/agent/peppol/sent/{invoiceId}/evidence. Vráti agregovaný stav doručenia, jednotlivé vrstvy (transport AS4, MLS, business response) a celú históriu prenosov. Doplnok k stavu odoslania — kým /peppol/status dá jeden súhrnný stav, tu dostanete rozpad po vrstvách pre audit a archiváciu.

Endpoint

Metóda	Cesta	Scope	Hlavičky
GET	`/v1/agent/peppol/sent/{invoiceId}/evidence`	`invoice:read`	`X-API-Key`, `X-Organization-Id`

invoiceId je id faktúry vystavenej cez POST /v1/agent/invoices. Ak pre faktúru neexistuje žiadny Peppol prenos (ešte nebola odoslaná, alebo patrí inej organizácii), endpoint vráti 404.

Odpoveď

GET /v1/agent/peppol/sent/b1f0d7a2-…/evidence
X-API-Key: efk_pk_test_...
X-Organization-Id: 0a2c1f3e-…

{
  "data": {
    "invoice_id": "b1f0d7a2-…",
    "document_id": "0245:2123456789#OF2026001",
    "delivery_status": {
      "state": "delivered",
      "at": "2026-06-22T10:00:05.000Z"
    },
    "layers": {
      "transport": { "state": "accepted", "label": "Transport (AS4)" },
      "mls": { "state": "accepted", "label": "Message Level Status" },
      "business_response": { "state": "pending", "label": "Business response" }
    },
    "transactions": [
      {
        "state": "SENT",
        "mode": "live",
        "document_id": "0245:2123456789#OF2026001",
        "error_message": null,
        "created_at": "2026-06-22T10:00:00.000Z",
        "updated_at": "2026-06-22T10:00:05.000Z"
      }
    ]
  }
}

Pole	Typ	Popis
`invoice_id`	UUID	ID faktúry.
`document_id`	string \| null	Identifikátor dokladu v prenose.
`delivery_status`	objekt	Agregovaný stav doručenia: state (delivered \| failed \| pending) a at (ISO 8601 \| null).
`layers`	objekt	Stav po vrstvách: transport, mls, business_response. Každá má state a label.
`transactions`	pole objektov	História prenosov (od najnovšieho). Viď tabuľku nižšie.

Objekt transaction

Pole	Typ	Popis
`state`	string	Stav prenosu (napr. SENT, QUEUED, ERROR).
`mode`	`live` \| `test`	live = reálne odoslanie (live kľúč), test = sandbox AP (test kľúč).
`document_id`	string \| null	Identifikátor dokladu v tomto prenose.
`error_message`	string \| null	Dôvod zlyhania, ak prenos zlyhal.
`created_at`	ISO 8601	Čas vytvorenia prenosu.
`updated_at`	ISO 8601	Čas poslednej zmeny stavu.

Vrstvy doručenia

Vrstva	Význam
`transport`	AS4 prijatie dokladu Peppol sieťou (transportný receipt).
`mls`	Message Level Status — potvrdenie/odmietnutie na úrovni správy.
`business_response`	Obchodná odpoveď príjemcu (akceptácia/odmietnutie dokladu), ak ju pošle.

Na slovenskej sieti príjemcovia spravidla neposielajú MLS ani business response — terminálnym úspešným stavom je transport: accepted a delivery_status.state: delivered. Vrstvy mls / business_response môžu ostať v stave pending, čo nie je chyba. Pre push notifikáciu doručenia použite webhook peppol.document.delivered.

404 znamená, že pre danú faktúru neexistuje žiadny Peppol prenos — najprv ju odošlite cez POST /v1/agent/peppol/send/{invoiceId} a stav sledujte cez Prijímanie a stavy.