Docs
SK

Vyberte jazyk

eurinvoice.com
Docs
SK

Vyberte jazyk

Uloženie prístupových údajov, šifrovane; hodnota sa nikdy nevracia

  • V sandboxe

Jednoducho povedané

Uloží prístupové údaje siete, šifrované. Hodnota sa nikdy nevráti.
POST
/credentials

Proces ukladá prístupové údaje len pre vlastné prostredie. legal_entity viaže údaje na ID predávajúceho, za ktorého konajú (IČ DPH, NIP, SIREN alebo ID spoločnosti); údaje bez označenia slúžia ostatným faktúram klienta. Administrátorský kľúč klienta ukladá len pre vlastného klienta.

Autorizácia

apiKey
headerAuthorizationBearer <token>

Kľúč posielajte ako token typu Bearer: Authorization: Bearer <your-api-key>. Stav služby je jediné volanie, ktoré nevyžaduje kľúč.

Telo požiadavky

application/json
  1. body
client*string

Voliteľné s kľúčom klienta

Zhoda^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$
route*string
Hodnota z"PL-KSEF""RO-EFACTURA""PEPPOL""FR-PA""DE-XRECHNUNG"
kind*string
issued_by*string
issued_on*string
Formátdate
expires_on?string
Formátdate
environment?string

Musí byť prostredie tohto procesu; to je predvolené.

Hodnota z"sandbox""production"
legal_entity?string
Dĺžkalength <= 64
value*string

Telo odpovede

Uložené.

application/json
  1. response
id?string
client?string
route?string
kind?string
issued_by?string
issued_on?string
expires_on?string
environment?|

sandbox alebo production; null pre prístupové údaje uložené pred 3. okt. 2026, ktoré používa len sandbox.

legal_entity?string
revoked_at?string
stored?boolean
curl -X POST "https://example.com/credentials" \  -H "Authorization: Bearer <your-api-key>" \  -H "Content-Type: application/json" \  -d '{    "client": "string",    "route": "PL-KSEF",    "kind": "string",    "issued_by": "string",    "issued_on": "2019-08-24",    "value": "string"  }'
{  "id": "string",  "client": "string",  "route": "string",  "kind": "string",  "issued_by": "string",  "issued_on": "string",  "expires_on": "string",  "environment": "string",  "legal_entity": "string",  "revoked_at": "string",  "stored": true}

Zrušenie prístupových údajov; záznam ostáva pre auditnú stopu POST

Predchádzajúca

Zastavenie faktúry, ktorá ešte nebola podaná POST

Funguje len dovtedy, kým je faktúra received, validated alebo queued. Od 0.18.3, keď sa odoslanie skúsilo a jeho odpoveď sa stratila (časový limit alebo 5xx), faktúra je submitting a zrušenie odpovie 409 send-in-progress, pretože ju kanál môže mať; worker ju uzavrie ako submitted alebo dead_letter. Keď ju kanál má, zrušenie je obchodný doklad (dobropis alebo KOR v Poľsku), nie volanie API. Od 0.18.5 zrušenie faktúry, ktorá je už zrušená, odpovie 200 s ňou, takže opakovanie po stratenej odpovedi je bezpečné. Od 0.18.6 môže kľúč operátora zrušiť faktúru v dead_letter, ak sa pre ňu nikdy neuskutočnilo volanie kanála: nemôže byť na kanáli, takže ten istý dokument možno potom poslať znova. Ak sa volanie uskutočnilo, odpoveď je 409 dead-letter-reached-rail, pretože tam môže byť odoslanie, ktorého odpoveď sa stratila: najprv overte u kanála. Kľúč klienta dostane 409 dead-letter; rozhoduje operátor.