Tagasi lükatud Peppol’i arve kukub ühes kahest kihist ja veakood ütleb, kummas. XSD-vead tähendavad, et XML-i struktuur ise on vale – element puudub, on vales kohas või vale tüübiga UBL-skeemi suhtes. Schematroni vead tähendavad, et XML on korrektne, aga sisu rikub ärireeglit; just need kannavad koodiperesid, mida arendajad AI-abilistele kleebivad: `BR-` reeglid tulevad Euroopa standardist EN 16931, `PEPPOL-EN16931-R` reeglid on võrgu enda lisandused. Loe koodipere enne veateksti ja tead juba, kelle reegliraamatut rikkusid – standardi või võrgu oma.
Mida koodipered tähendavad?
| Koodipere | Kiht | Mida kontrollib |
|---|---|---|
| (parseri viga) | XSD | UBL-struktuur: elemendid, järjekord, tüübid |
| BR- | Schematron / EN 16931 | Põhireeglid: kohustuslikud andmed olemas |
| BR-CO- | Schematron / EN 16931 | Arvutused: summad peavad klappima |
| BR-S/E/AE/K/G/O- | Schematron / EN 16931 | Käibemaksukategooriate reeglid |
| PEPPOL-EN16931-R | Schematron / Peppol | Võrgu reeglid standardi peal |
| -CL | Schematron | Kooditabelid: valuuta, riik, skeemikoodid |
Reeglitel on ka raskusaste: fataalne viga blokeerib dokumendi, hoiatus mitte – seda tasub vaadata enne, kui kulutad pärastlõuna asjale, mille võrk oleks niikuinii vastu võtnud.
Miks summad nii tihti läbi kukuvad?
Arvutusreeglid (`BR-CO-*` pere) ristkontrollivad dokumendi aritmeetikat: ridade netosummad peavad andma maksuvaba kogusumma, käibemaksukategooriate summad peavad vastama baasidele ja määradele ning tasumisele kuuluv summa peab keti sulgema. Klassikaline põhjus on ümardamine: rakendus ümardab rea kaupa, reegel kontrollib summat ja sendine nihe lükkab arve tagasi. Töökindel lahendus on arvutada UBL-i kogusummad samadest ümardatud väärtustest, mis ridadel näha, mitte andmebaasi ümardamata numbritest.
Kuidas tagasilükatud arvet siluda: õiges järjekorras
Paranda kõigepealt XSD-vead: kuni struktuur ei parseeru, on Schematroni tulemused müra. Siis paranda esimene Schematroni viga ja valideeri uuesti: hilisemad vead kaskaadituvad sageli esimesest (üks puuduv käibemaksurida võib komistada pool tosinat sõltuvat reeglit). Kontrolli raskusastet, enne kui iga sõnumit blokeerijaks pead. Ja kui valideerid ligipääsupunkti API kaudu, mis kontrollib sünkroonselt enne vastuvõtmist, juhi need struktureeritud raportid oma testidesse: siis ilmuvad vastavusvead CI-s, mitte toodangus. Standardikaardi nende kihtide taga leiad juhendist kuidas luua korrektne UBL-arve.
Loe ka: English
Viimati kontrollitud:
Mis vahe on XSD ja Schematroni vigadel Peppol’is?
XSD-vead tähendavad, et XML-i struktuur on UBL-skeemi suhtes vale; Schematroni vead tähendavad, et XML on korrektne, kuid selle sisu rikub ärireeglit (BR-* standardist EN 16931, PEPPOL-* on võrgu enda lisandus).
Mis on BR-CO vead?
EN 16931 arvutus- ja tingimusreeglid – need ristkontrollivad summasid: ridade summad, käibemaksukategooriate summad ja tasumisele kuuluv summa peavad aritmeetiliselt kokku minema. Klassikaline põhjus on ümardamise nihe.
Kas kõik Peppol’i valideerimisvead blokeerivad arve?
Ei. Reeglitel on raskusaste – fataalsed vead blokeerivad dokumendi, hoiatused mitte. Kontrolli raskusastet, enne kui pead iga teadet veaks.
Millises järjekorras tasub tagasilükatud Peppol’i arvet siluda?
Kõigepealt paranda XSD struktuur, seejärel esimene Schematroni viga (hilisemad vead sageli kaskaaduvad sellest), kontrollides samal ajal reeglite raskusastet. Sünkroonne API valideerimine võimaldab need vead püüda juba CI-s, mitte toodangus.