Popis i pretraga računa
- U sandboxu
Jednostavnim riječima
Ključ klijenta vidi račune svojeg klijenta; operater vidi račune svih klijenata ili jednog klijenta pomoću client. Retci nose ono što nosi GET /invoices/{id}, bez documents, i bez sadržaja računa: bez kupca ili iznosa,
i bez datuma izdavanja (za Rumunjsku i Poljsku iz njega proizlazi deadline_at, s točnošću od nekoliko dana). Nepoznati parametar vraća 400.
apiKeyAuthorizationBearer <token>Ključ pošaljite kao bearer token: Authorization: Bearer <your-api-key>. Poziv za stanje usluge jedini je poziv za koji nije potreban ključ.
q?stringDio invoice_ref ili broja računa, bez razlikovanja velikih i malih slova. Najviše 100 znakova.
length <= 100route?array<>Jedan ili više kanala, odvojenih zarezom.
state?array<>Jedno ili više stanja, odvojenih zarezom.
client?stringFiltar operatera na jednog klijenta. Ključ klijenta smije navesti samo svojeg klijenta; svaki drugi vraća 404. Drugi oblik vraća 400.
^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$received_from?stringPrvi UTC dan primitka računa, uključivo.
datereceived_to?stringZadnji UTC dan primitka računa, uključivo.
datesort?stringPo vremenu primitka. Izjednačenja se razrješavaju po id-u, pa se stranica ne mijenja između poziva.
"newest""newest""oldest"page?integer1 <= value1page_size?integer252550100200Jedna stranica podudaranja.
application/json- response
data*array<>total*integerPodudaranja prije straničenja.
page*integerVraćena stranica. Stranica iza kraja svodi se na zadnju.
page_size*integercounts_by_state*Podudaranja po stanju sa svim filtrima osim state. Stanje bez podudaranja izostavlja se.
curl -X GET "https://example.com/invoices" \ -H "Authorization: Bearer <your-api-key>"{ "data": [ { "id": "string", "invoice_ref": "string", "invoice_number": "string", "route": "PEPPOL", "environment": "sandbox", "state": "received", "legal_id": "string", "buyer_status": "string", "document_sha256": "string", "attempts": [ { "id": "string", "state": "received", "created_at": "2019-08-24T14:15:22Z" } ], "errors": [ { "code": "string", "source": "string", "message": "string", "field": "string", "fix_hint": "string", "who_fixes": "us", "related": [ { "code": "string", "source": "string" } ] } ], "documents": [ { "kind": "string", "sha256": "string", "href": "string" } ], "created_at": "2019-08-24T14:15:22Z", "updated_at": "2019-08-24T14:15:22Z", "deadline_at": "2019-08-24T14:15:22Z" } ], "total": 0, "page": 0, "page_size": 0, "counts_by_state": { "property1": 0, "property2": 0 }}Primljeni i odbijeni računi po danu i kanalu GET
Izračunava se iz pohrane pri svakom pozivu. received broji račune po UTC danu njihova dolaska; rejected broji račune koji su sada odbijeni po UTC danu njihove zadnje promjene. Dan bez računa ima nule, pa grafikon nema rupa. Opseg kao kod GET /invoices.
Predaj račun ili odobrenje kao kanonski JSON POST
Usluga odmah provjerava dokument prema kanonskom modelu i preliminarnim provjerama te odgovara 422 ako jedna od njih ne prođe. Sve nakon toga radi asinkrono (izrada, službena validacija, predaja kanalu, statusi) i prijavljuje se statusnim događajima. Ispravljeno ponovno slanje odbijenog računa koristi isti invoice_ref i novi Idempotency-Key; usluga povezuje pokušaje. U produkciji se izvoz iz ERP-a čita samo kada postavke konektora klijenta sadrže vlastitog prodavatelja i plaćanje, a ne primjer iz mapiranja: inače 422 connector-settings-missing, uz navod što nedostaje. Sandbox ga čita s primjerom, kao i prije.