Il record del cliente
- Nella sandbox
Dalla 0.24.0 (C14). La chiave dell’operatore o la chiave dell’operatore in sola lettura, e dalla 0.25.0 una chiave partner per un cliente il cui record indica il suo partner (403 per ogni altro). 404 quando non è impostato alcun record.
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.
client*string^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$Il record.
application/json- response
client*stringname*stringpartner?string|nullstage*string"pilot""production""paused"contact_email?string|nulllegal_entities*array<string>countries*array<string>updated_at*stringdate-timecurl -X GET "https://example.com/clients/string/profile" \ -H "Authorization: Bearer <your-api-key>"{ "client": "string", "name": "string", "partner": "string", "stage": "pilot", "contact_email": "string", "legal_entities": [ "string" ], "countries": [ "string" ], "updated_at": "2019-08-24T14:15:22Z"}Inviare un documento UBL o CII già pronto (pass-through) POST
Per gli ERP che già scrivono UBL o CII, oppure FA(3) per il canale KSeF. Non avviene alcuna mappatura: il servizio esegue i validatori ufficiali del canale (per FA(3): l’XSD più le regole di KSeF sul file e sulle date) e invia il file senza modificarlo. Un PDF Factur-X o ZUGFeRD passa dallo stesso endpoint come application/pdf. L’XML viene letto con entità, DTD e accesso alla rete disattivati, e un file con un DOCTYPE viene rifiutato (EI-XML-DTD) prima che un validatore lo legga, così come un file non ben formato (EI-XML-SYNTAX) o che non è una fattura che il canale conosce (EI-XML-TYPE). Dalla 0.18.4 lo stesso file inviato di nuovo per lo stesso cliente e canale è la fattura già conservata (duplicate_of), come su POST /invoices; non viene inviato nulla di nuovo.
I record dei clienti, per partner GET
Dalla 0.24.0 (C14). La chiave dell’operatore o la chiave dell’operatore in sola lettura; dalla 0.25.0 una chiave partner, che riceve l’elenco del proprio partner (indicare un altro partner risponde 403). I record impostati con PUT /clients/{client}/profile, per id cliente in ordine di byte, 500 alla volta. Quando truncated è true, next è l’ultimo id della pagina e after= con quell’id legge la pagina successiva. partner limita l’elenco ai clienti di un partner. Un cliente con chiavi ma senza record non compare nell’elenco.