Overenie príjemcu

SMP lookup cez GET /v1/agent/peppol/recipient — „je tento účastník na Peppole?“. Použite ho pred odoslaním na overenie, že príjemca vie prijímať faktúry cez Peppol. Endpoint vždy vráti 200; chýbajúci účastník je found: false, nikdy nie chyba.

Endpoint

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

Query parametre

Parameter	Typ	Povinné	Popis
`peppolId`	string	Áno	Peppol identifikátor účastníka (napr. 0245:DIČ pre SK produkciu, 9915:DIČ pre sandbox).

GET /v1/agent/peppol/recipient?peppolId=0245:2123456789
X-API-Key: efk_pk_test_...
X-Organization-Id: 0a2c1f3e-…

Odpoveď

Aj keď účastník nie je registrovaný, odpoveď je 200 s found: false. Polia sml_state, pd_state a lookup_unavailable sú voliteľné.

{
  "data": {
    "peppol_id": "0245:2123456789",
    "found": true,
    "sml_state": "active",
    "pd_state": "published",
    "lookup_unavailable": false
  }
}

Pole	Typ	Popis
`peppol_id`	string	Overovaný identifikátor (echo vstupu).
`found`	boolean	true, ak je účastník registrovaný v SMP (vie prijímať cez Peppol).
`sml_state`	string (voliteľné)	Stav v SML (napr. active).
`pd_state`	string (voliteľné)	Stav v Peppol Directory (napr. published).
`lookup_unavailable`	boolean (voliteľné)	true, ak SMP/SML lookup nebol dostupný — found je vtedy neistý, skúste neskôr.

SMP lookup nikdy neblokuje odoslanie — slúži len ako kontrola pred odoslaním. Aj pri found: false môžete odoslať (príjemca sa mohol práve registrovať); preferujte však odoslanie až po overení, aby ste predišli zbytočným zlyhaniam.

Súvislosti

Rovnaký lookup vie spraviť aj Preflight (keď v tele pošlete receiverPeppolId) — výsledok je tam v poli recipient. Tento samostatný endpoint použite, keď chcete overiť príjemcu bez toho, aby ste mali pripravené XML. Smerovanie v SK Peppol prebieha cez DIČ príjemcu (0245:<DIČ> produkcia, 9915:<DIČ> sandbox).