Docs
PL

Wybierz język

eurinvoice.com
Docs
PL

Wybierz język

Zapisanie danych dostępowych w postaci zaszyfrowanej; wartość nigdy nie jest zwracana

  • W sandboxie

Prostymi słowami

Zapisuje dane dostępowe do sieci w postaci zaszyfrowanej. Wartość nigdy nie jest zwracana.
POST
/credentials

Proces zapisuje dane dostępowe tylko dla własnego środowiska. legal_entity wiąże je z identyfikatorem sprzedawcy, w imieniu którego działają (numer VAT, NIP, SIREN lub identyfikator firmy); dane bez takiego oznaczenia obsługują pozostałe faktury klienta. Klucz administratora klienta zapisuje tylko dla własnego klienta.

Autoryzacja

apiKey
headerAuthorizationBearer <token>

Klucz należy wysyłać jako token typu bearer: Authorization: Bearer <your-api-key>. Wywołanie stanu usługi jest jedynym, które nie wymaga klucza.

Treść żądania

application/json
  1. body
client*string

Opcjonalne z kluczem klienta

Wzorzec^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$
route*string
Wartość spośród"PL-KSEF""RO-EFACTURA""PEPPOL""FR-PA""DE-XRECHNUNG"
kind*string
issued_by*string
issued_on*string
Formatdate
expires_on?string
Formatdate
environment?string

Musi być środowiskiem tego procesu; to jest wartość domyślna.

Wartość spośród"sandbox""production"
legal_entity?string
Długośćlength <= 64
value*string

Treść odpowiedzi

Zapisano.

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

sandbox lub production; null dla danych dostępowych zapisanych przed 3.10.2026, których używa tylko 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}

Cofnięcie danych dostępowych; zapis pozostaje w śladzie audytu POST

Wstecz

Zatrzymanie faktury, która nie została jeszcze przesłana POST

Działa tylko wtedy, gdy faktura ma stan received, validated lub queued. Od 0.18.3, jeśli wysyłkę podjęto, a jej odpowiedź zaginęła (przekroczenie czasu lub 5xx), faktura ma stan submitting, a anulowanie daje odpowiedź 409 send-in-progress, ponieważ kanał może ją mieć; proces roboczy ustala ją jako submitted lub dead_letter. Gdy kanał ją ma, anulowanie jest dokumentem biznesowym (notą kredytową, a w Polsce korektą KOR), a nie wywołaniem API. Od 0.18.5 anulowanie faktury, która jest już anulowana, daje odpowiedź 200 z tą fakturą, więc ponowienie po zaginionej odpowiedzi jest bezpieczne. Od 0.18.6 klucz operatora może anulować fakturę dead_letter, gdy nigdy nie wykonano dla niej wywołania do kanału: nic nie może być w kanale, więc ten sam dokument można potem wysłać ponownie. Gdy wywołanie wykonano, odpowiedzią jest 409 dead-letter-reached-rail, ponieważ wysyłka z zaginioną odpowiedzią mogła dotrzeć: najpierw należy sprawdzić w kanale. Klucz klienta dostaje 409 dead-letter; decyduje operator.