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, alebo invoice_id, ktoré platforma zrkadlila pri odoslaní hotového UBL (connector, SAPI-SK, SFTP). Ak pre faktúru neexistuje žiadny Peppol prenos (ešte nebola odoslaná, alebo patrí inej organizácii), endpoint vráti 404.

Ak máte z odpovede na odoslanie hotového UBL len ID podania (SAPI-SK providerDocumentId alebo connector-send document_id, obe sú tá istá hodnota), invoice_id najprv zistite cez GET /v1/agent/peppol/submissions/{submissionId} (scope invoice:read). Vracia invoice_id, status a error_message podania.

Odpoveď

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

{
  "data": {
    "invoice_id": "b1f0d7a2-…",
    "document_id": "d4f8…@phase4.phoss-ap",
    "sbdh_instance_id": "5e0a1c9b-…",
    "ubl_sha256": "9f2b…c41d",
    "delivery_status": {
      "state": "delivered",
      "at": "2026-06-22T10:00:05.000Z"
    },
    "layers": {
      "transport": { "state": "accepted", "label": "Transport (AS4)" },
      "mls": { "state": "not_reported", "label": "Message Level Response (MLR)" },
      "businessResponse": { "state": "not_reported", "label": "Business-Level Response (BLR)" }
    },
    "transactions": [
      {
        "state": "SENT",
        "mode": "live",
        "document_id": "d4f8…@phase4.phoss-ap",
        "sbdh_instance_id": "5e0a1c9b-…",
        "ubl_sha256": "9f2b…c41d",
        "mls_status": null,
        "mls_at": null,
        "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	AS4 message id, ktoré prenosu pridelil Access Point (posledný prenos).
`sbdh_instance_id`	string \| null	Nemenný SBDH InstanceIdentifier posledného prenosu: ID, ktorým sa na doklad odkazuje prichádzajúce MLS.
`ubl_sha256`	string \| null	SHA-256 (hex) presných archivovaných bajtov odoslaného UBL: kryptografický dôkaz integrity.
`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	AS4 message id tohto prenosu.
`sbdh_instance_id`	string \| null	SBDH InstanceIdentifier tohto prenosu.
`ubl_sha256`	string \| null	SHA-256 (hex) archivovaných bajtov odoslaného UBL.
`mls_status`	`accepted` \| `rejected` \| `null`	Výsledok prichádzajúceho MLS spárovaného s týmto prenosom; null = MLS neprišlo.
`mls_at`	ISO 8601 \| null	Čas prijatia MLS.
`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 mnohí príjemcovia MLS ani business response nikdy nepošlú: terminálnym úspešným stavom je vtedy transport: accepted a delivery_status.state: delivered, pričom vrstvy mls / businessResponse ostanú not_reported, čo nie je chyba. Keď prijímajúci Access Point MLS pošle, vrstva mls ho odzrkadlí (accepted alebo failed) a každá transakcia nesie mls_status/mls_at. Evidence JSON je podporovaný export dôkazu; surový AS4 receipt sa ako samostatný súbor neposkytuje: namiesto neho dostávate nemenné identifikátory (document_id, sbdh_instance_id) a ubl_sha256. 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.