I file generati di un massimo di 200 fatture in un unico zip
- Nella sandbox
Dalla 0.33.0 (16 ott. 2026). Corpo {"ids": [...]}, da 1 a 200 id di fattura. Lo zip contiene un file per ogni
documento generato (UBL, CII, FA(3), XRechnung, Factur-X, ZUGFeRD, PDF, oppure l’XML così come ricevuto per un pass-through), chiamato
<invoice_number>.<xml|pdf> (con il tipo aggiunto quando una fattura ha due file XML), e manifest.csv con
invoice_id,invoice_ref,invoice_number,route,state,file,kind,sha256. Il JSON canonico, il rapporto di validazione
e l’export dell’ERP non sono inclusi. Un id sconosciuto o di un altro cliente viene saltato senza essere nominato,
come una fattura che non ha ancora un file generato; X-Export-Skipped li conta. Ambito read; 10 esportazioni al minuto per
cliente, condivise con GET /exports/{dataset}; una riga di audit data_exported con lo SHA-256 dello zip.
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
ids*array<>1 <= items <= 200Lo zip.
response?fileapplication/zipbinarycurl -X POST "https://example.com/invoices/export" \ -H "Authorization: Bearer <your-api-key>" \ -H "Content-Type: application/json" \ -d '{ "ids": [ "string" ] }'"string"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.
Leggere lo stato attuale di una fattura GET
Successiva