Predaj gotov UBL ili CII dokument (prosljeđivanje)
- U sandboxu
Jednostavnim riječima
Za ERP-ove koji već pišu UBL ili CII, ili FA(3) za kanal KSeF. Mapiranja nema: usluga pokreće
službene validatore kanala (za FA(3): XSD plus KSeF-ova pravila o datoteci i datumu) i šalje
datoteku nepromijenjenu. PDF Factur-X ili ZUGFeRD ide kroz istu krajnju točku
kao application/pdf. XML se obrađuje s isključenim entitetima, DTD-ovima i pristupom mreži, a datoteka s
DOCTYPE-om odbija se (EI-XML-DTD) prije nego je pročita bilo koji validator, kao i datoteka koja nije ispravno oblikovana
(EI-XML-SYNTAX) ili nije račun koji kanal poznaje (EI-XML-TYPE). Od 0.18.4 ista datoteka poslana ponovno
za klijenta i kanal jest račun koji već postoji (duplicate_of), kao na POST /invoices; ništa se novo ne šalje.
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č.
route*stringKanal slanja za zemlju. Iste vrijednosti kao country_route u statusnim događajima.
"PEPPOL""PL-KSEF""RO-EFACTURA""FR-PA""DE-XRECHNUNG"invoice_ref*stringVlastiti ID dokumenta u ERP-u.
length <= 100Idempotency-Key*stringJedinstveni ključ za svaki logički zahtjev (UUID je dovoljan). Čuva se onoliko dugo koliko se čuvaju podaci klijenta. S ključem operatera ne smije počinjati s client: (400), oblikom pod kojim se spremaju ključevi klijenata.
8 <= length <= 100body*stringPrihvaćeno na obradu.
application/json- response
id*stringstate*InvoiceStateVlastito stanje usluge za račun. Statusni događaji prijavljuju životni ciklus vidljiv partneru;
queued i submitting unutarnji su koraci između validated i submitted. validation_failed znači da su službena pravila odbila dokument; od
0.18.4 provjera koja nije pokrenuta (KOSIT-RUN, EI-PDF-CHECK) ponavlja se, a zatim završava kao dead_letter s tom
šifrom. dead_letter zadržava svoj dokument, pa ista datoteka dobiva odgovor s duplicate_of; od 0.18.6
operater može otkazati onaj za koji nije upućen nijedan poziv kanalu, i tada datoteka može ponovno ići.
"received""source_error""validated""validation_failed""queued""submitting""submitted""ready""accepted""rejected""delivered""cancelled""dead_letter"duplicate_of?|Postavljeno kada je isti dokument već prihvaćen za ovog klijenta i kanal; ništa novo se ne šalje. Predaja koja je završila kao rejected, validation_failed ili cancelled ne računa se, pa se datoteka može ponovno poslati. Od 0.18.5 to vrijedi i za dva zahtjeva poslana u isti trenutak, pod različitim ključevima; jedan izrađuje račun, a drugi odgovara s duplicate_of.
links*route?RouteSamo kada je kanal odabrao usmjerivač.
"PEPPOL""PL-KSEF""RO-EFACTURA""FR-PA""DE-XRECHNUNG"route_chosen_by?"router"Samo kada je zahtjev izostavio kanal.
"router"route_rule?stringPravilo usmjerivača koje je odabralo kanal; zapisuje se i u revizijski dnevnik kao route_chosen.
"fr-domestic""fr-cross-border""pl-domestic""ro-domestic""be-domestic""de-domestic-peppol""de-domestic""cross-border-peppol"curl -X POST "https://example.com/invoices/xml?route=PL-KSEF&invoice_ref=INV-2026-0042" \ -H "Authorization: Bearer <your-api-key>" \ -H "Idempotency-Key: order-2026-0001" \ -H "Content-Type: application/xml" \ -d '<?xml version="1.0" encoding="UTF-8"?><Faktura xmlns="http://crd.gov.pl/wzor/2025/06/25/13775/"><Naglowek><KodFormularza kodSystemowy="FA (3)" wersjaSchemy="1-0E">FA</KodFormularza><WariantFormularza>3</WariantFormularza><DataWytworzeniaFa>2026-10-01T05:44:07Z</DataWytworzeniaFa><SystemInfo>eurinvoice</SystemInfo></Naglowek><Podmiot1><DaneIdentyfikacyjne><NIP>1234567890</NIP><Nazwa>Wisła Systemy sp. z o.o.</Nazwa></DaneIdentyfikacyjne><Adres><KodKraju>PL</KodKraju><AdresL1>ul. Floriańska 22</AdresL1><AdresL2>31-019 Kraków</AdresL2></Adres><DaneKontaktowe><Email>[email protected]</Email><Telefon>+48 12 345 67 89</Telefon></DaneKontaktowe></Podmiot1><Podmiot2><DaneIdentyfikacyjne><NIP>5213000000</NIP><Nazwa>Mazowiecka Hurtownia S.A.</Nazwa></DaneIdentyfikacyjne><Adres><KodKraju>PL</KodKraju><AdresL1>al. Jerozolimskie 100</AdresL1><AdresL2>00-807 Warszawa</AdresL2></Adres><JST>2</JST><GV>2</GV></Podmiot2><Fa><KodWaluty>PLN</KodWaluty><P_1>2026-09-26</P_1><P_1M>Kraków</P_1M><P_2>FV/2026/09/057</P_2><P_6>2026-09-25</P_6><P_13_1>25450.00</P_13_1><P_14_1>5853.50</P_14_1><P_15>31303.50</P_15><Adnotacje><P_16>2</P_16><P_17>2</P_17><P_18>2</P_18><P_18A>2</P_18A><Zwolnienie><P_19N>1</P_19N></Zwolnienie><NoweSrodkiTransportu><P_22N>1</P_22N></NoweSrodkiTransportu><P_23>2</P_23><PMarzy><P_PMarzyN>1</P_PMarzyN></PMarzy></Adnotacje><RodzajFaktury>VAT</RodzajFaktury><FaWiersz><NrWierszaFa>1</NrWierszaFa><P_7>Wdrożenie KSeF 2.0</P_7><P_8A>LS</P_8A><P_8B>1</P_8B><P_9A>24000.00</P_9A><P_11>24000.00</P_11><P_12>23</P_12></FaWiersz><FaWiersz><NrWierszaFa>2</NrWierszaFa><P_7>Obsługa odrzuconych faktur</P_7><P_8A>MON</P_8A><P_8B>1</P_8B><P_9A>1450.00</P_9A><P_11>1450.00</P_11><P_12>23</P_12></FaWiersz><Platnosc><TerminPlatnosci><Termin>2026-10-10</Termin></TerminPlatnosci><FormaPlatnosci>6</FormaPlatnosci><RachunekBankowy><NrRB>61109010140000071219812874</NrRB><SWIFT>WBKPPLPP</SWIFT></RachunekBankowy></Platnosc><WarunkiTransakcji><Zamowienia><DataZamowienia>2026-09-26</DataZamowienia><NrZamowienia>ZAM-2026-311</NrZamowienia></Zamowienia></WarunkiTransakcji></Fa><Stopka><Rejestry><PelnaNazwa>Wisła Systemy sp. z o.o.</PelnaNazwa><KRS>0000123456</KRS></Rejestry></Stopka></Faktura>'{ "links": { "self": "/invoices/inv_d249e33382ce2911876b7295", "events": "/invoices/inv_d249e33382ce2911876b7295/events" }, "id": "inv_d249e33382ce2911876b7295", "state": "queued"}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.
Pronađi pogrešku ili šifru razloga GET
Vraća unos kataloga za ID pravila, šifru pogreške kanala ili francusku šifru razloga (ID-ovi i aliasi).