Docs

Înregistrarea clientului

  • În sandbox
GET
/clients/{client}/profile

De la versiunea 0.24.0 (C14). Cheia operatorului sau cheia de operator doar pentru citire, iar de la versiunea 0.25.0 și o cheie de partener pentru un client a cărui înregistrare îl numește pe partenerul respectiv (403 pentru orice altul). 404 când nu este stabilită nicio înregistrare.

Autorizare

apiKey
headerAuthorizationBearer <token>

Trimiteți cheia ca token de tip bearer: Authorization: Bearer <your-api-key>. Starea serviciului este singurul apel care nu necesită cheie.

Parametri de cale

client*string
Model^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$

Corpul răspunsului

Înregistrarea.

application/json
  1. response
client*string
name*string
partner?string|null
stage*string
Valori permise"pilot""production""paused"
contact_email?string|null
legal_entities*array<string>
countries*array<string>
updated_at*string
Formatdate-time
curl -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"}

Transmiteți un document UBL sau CII finalizat (transmitere directă) POST

Pentru ERP-urile care scriu deja UBL sau CII, sau FA(3) pentru canalul KSeF. Nu are loc nicio mapare: serviciul rulează validatoarele oficiale ale canalului (pentru FA(3): XSD plus regulile KSeF pentru fișier și dată) și trimite fișierul neschimbat. Un PDF Factur-X sau ZUGFeRD trece prin același punct final ca application/pdf. XML-ul este analizat cu entitățile, DTD-urile și accesul la rețea dezactivate, iar un fișier cu DOCTYPE este refuzat (EI-XML-DTD) înainte ca vreun validator să îl citească, la fel ca un fișier care nu este bine format (EI-XML-SYNTAX) sau nu este o factură pe care canalul o cunoaște (EI-XML-TYPE). Începând cu 0.18.4, același fișier trimis din nou pentru același client și canal este factura deja păstrată (duplicate_of), ca la POST /invoices; nu se trimite nimic nou.

Înregistrările clienților, pe partener GET

De la versiunea 0.24.0 (C14). Cheia operatorului sau cheia de operator doar pentru citire; de la versiunea 0.25.0 și o cheie de partener, care primește lista propriului partener (numirea altui partner primește 403). Înregistrările stabilite cu PUT /clients/{client}/profile, după ID-ul clientului în ordinea octeților, câte 500 odată. Când truncated este true, next este ultimul ID al paginii, iar after= cu acel ID citește pagina următoare. partner restrânge lista la clienții unui singur partener. Un client cu chei, dar fără înregistrare, nu apare în listă.