Conservare una credenziale, cifrata; il valore non viene mai restituito
- Nella sandbox
In parole semplici
Un processo conserva credenziali solo per il proprio ambiente. legal_entity ne lega una all’id del venditore per cui agisce (partita IVA, NIP, SIREN o id aziendale); una senza etichetta serve le altre fatture del cliente. La chiave admin di un cliente conserva solo per il proprio cliente.
apiKeyAuthorizationBearer <token>Inviare la chiave come token bearer: Authorization: Bearer <your-api-key>. Lo stato del servizio è l’unica chiamata che non richiede una chiave.
application/json- body
client*stringFacoltativo con la chiave di un cliente
^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$route*string"PL-KSEF""RO-EFACTURA""PEPPOL""FR-PA""DE-XRECHNUNG"kind*stringissued_by*stringissued_on*stringdateexpires_on?stringdateenvironment?stringDeve essere l’ambiente di questo processo; è il valore predefinito.
"sandbox""production"legal_entity?stringlength <= 64value*stringConservata.
application/json- response
id?stringclient?stringroute?stringkind?stringissued_by?stringissued_on?stringexpires_on?stringenvironment?|sandbox o production; null per una credenziale conservata prima del 3 ott. 2026, che solo una sandbox usa.
legal_entity?stringrevoked_at?stringstored?booleancurl -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}Revocare una credenziale; la registrazione resta per la traccia di audit POST
Precedente
Fermare una fattura non ancora inviata POST
Funziona solo finché la fattura è received, validated o queued. Dalla 0.18.3, quando un invio è stato tentato e la sua risposta è andata persa (un timeout o un 5xx), la fattura risulta submitting e un annullamento risponde 409 send-in-progress, perché il canale potrebbe averla; il worker la chiude come submitted o dead_letter. Una volta che il canale ce l’ha, l’annullamento è un documento commerciale (una nota di credito, o un KOR in Polonia), non una chiamata API. Dalla 0.18.5 l’annullamento di una fattura già annullata risponde 200 con la fattura, così un nuovo tentativo dopo una risposta andata persa è sicuro. Dalla 0.18.6 la chiave dell’operatore può annullare una fattura dead_letter quando non è mai stata fatta alcuna chiamata al canale per essa: sul canale non può esserci nulla, quindi lo stesso documento può essere inviato di nuovo. Quando una chiamata è stata fatta, la risposta è 409 dead-letter-reached-rail, perché un invio la cui risposta è andata persa potrebbe essere lì: verificare prima con il canale. La chiave di un cliente riceve 409 dead-letter; decide l’operatore.