Docs

1 Začnite tu1.3

1.3

Ako putuje jedna faktúra

Jedna faktúra, od exportu z ERP po stavové udalosti.

  • V sandboxe
  • Zatiaľ nie v sandboxe

Jednoducho povedané

Táto stránka sleduje jednu faktúru od ERP klienta až po zoznam neúspešných faktúr. Pre firmu je dôležité toto: keď je faktúra chybná, odpoveď pomenuje pole v exporte klienta a uvedie, kto ho opraví, a to ešte predtým, než sa čokoľvek odošle. V hostovanom sandboxe zatiaľ posledný krok nemá napojenie na krajinu.

Jedna faktúra, od exportu z ERP po zoznam na riešenie. Žltý lístok je odpoveď, ktorá pomenuje pole v exporte klienta. Prerušovaný rámček je sieť. Hostovaný sandbox zatiaľ žiadnu nemá nastavenú.

Ako putuje jedna faktúraOsem krokov od exportu z ERP po zoznam na riešenie. Po pravidlách kanála je odpoveď 202 s ID alebo 422 s kódom z katalógu. Krok siete odošle faktúru tam, kde má kanál prístupové údaje; hostovaný sandbox ich zatiaľ nemá.1Export z ERPBusiness Central,JSON alebo XML2VstupVolanie API alebo súbor3Kontrola schémyKanonický model faktúry4Pravidlá kanálaKoSIT, Schematron,schéma FA(3)202 + ID5FrontRýchly pruh: KSeF, Peppol,Francúzsko, NemeckoPomalý pruh: ANAFvýsledok adaptéra6SieťOdošle tam, kde je sieť pripojená7Stavové udalostiJedna na krok, v poradítrvalé odmietnutie8Na riešenieTrvalé odmietnutia422Kód z katalógupomenuje polespäť k partnerovi
  1. Faktúra opustí ERP klienta ako export z ERP (Business Central alebo SAP Business One), kanonický JSON alebo hotový súbor XML.
  2. Prichádza cez POST /invoices, POST /invoices/xml alebo ako súbor v priečinku na odovzdávanie.
  3. Kanonický model skontroluje štruktúru. Pri chybe pomenuje pole.
  4. Spustia sa vlastné validátory kanála: KoSIT pre Nemecko, Schematron pre Peppol, Francúzsko a Rumunsko, schéma FA(3) pre Poľsko. Odpoveď je 202 s ID alebo 422 s kódom z katalógu, ktorý pomenuje pole, uvedie, kto má konať, a dá radu na opravu.
  5. Faktúra, ktorá prejde, čaká vo fronte. KSeF, Peppol, Francúzsko a Nemecko zdieľajú rýchly pruh. ANAF má vlastný pomalý pruh.
  6. Kanál s prístupovými údajmi k sieti faktúru odošle. Nemecko nemá sieť: jeho faktúra končí v stave ready a súbor doručí partner. Kanál bez prístupových údajov, ako dnes v hostovanom sandboxe, nič neodošle.
  7. Každý výsledok sa stane stavovou udalosťou, uloženou v poradí. Pozri stavy.
  8. Trvalé odmietnutie skončí v zozname na riešenie. Pri dočasnom zlyhaní sa pokus opakuje a faktúra sa doň dostane, až keď sa opakované pokusy vyčerpajú.

Poznámka

Hotový súbor XML ide skratkou. Prejde bezpečnostnou kontrolou a validátormi kanála (krok 4), ale bez kanonickej kontroly a mapovania, a do frontu sa zaradí v kroku 5.

POST /validate spustí len kroky 3 a 4. Nič neuloží, nič neodošle a vždy odpovie 200 s protokolom. Pozri skúšobný beh.