Peppol XML kļūdas: 12 iemesli, kāpēc validācija neiziet (un kā salabot)

Tu esi paveicis visu smago darbu. Pakalpojums sniegts, rēķins izrakstīts, XML fails ģenerēts. Tu to augšupielādē valsts E-adresē vai nosūti lielajam klientam un... BAM! Ekrāns iedegas sarkanā krāsā.

Kļūda: [BR-CO-10]-Sum of Invoice line net amount must equal Tax Exclusive Amount. Kļūda: [BR-O-02]-An Invoice shall contain the Seller postal address.

Sirds noiet papēžos. Ko tas nozīmē? Vai man jāsauc programmētājs? Vai es nesaņemšu naudu?

Nomierinies. Peppol XML validācija ir kā stingrs apsargs naktsklubā – viņš nelaiž iekšā, ja kurpes nav tīras vai kaklasaite šķība. Bet, atšķirībā no cilvēka, sistēma ir 100% loģiska. Ja Tu zini noteikumus, Tu vari tos izpildīt.

Šajā rakstā mēs iztulkosim "robotu valodu" cilvēku valodā. Mēs apskatīsim 12 visbiežāk sastopamās Peppol XML kļūdas, kas liedz rēķinam nokļūt pie klienta, un parādīsim precīzus soļus, kā tās salabot.

Apnicis cīnīties ar kļūdām manuāli? Sāc bez maksas un izmēģini sistēmu, kas novērš kļūdas pirms tās rodas: https://www.erekini.eu

Kā strādā validācija (cilvēcīgi)

Lai saprastu kļūdas, jāsaprot process. Eiropas standarts EN16931 ir noteikumu kopums, kas nosaka, kādam jābūt e-rēķinam.

Kad Tu ģenerē XML eksportu, fails netiek vienkārši nosūtīts. Tas iziet cauri "Validācijas dzinējam" (Validation Engine). Šis dzinējs pārbauda divas lietas:

1. Sintakse (Formāts): Vai fails vispār ir XML? Vai visas iekavas ir aizvērtas? (Lielākoties par to atbild Tava rēķinu programma).
2. Biznesa noteikumi (Schematron): Vai saturs ir loģisks?
   • Piemērs: Ja PVN likme ir 21% un summa ir 100 EUR, tad nodoklim jābūt 21 EUR. Ja failā rakstīts 21.05 EUR, validācija neiziet.
   • Piemērs: Ja pircējs ir no Latvijas, vai viņam ir LV reģistrācijas numurs?

Ja validācija neiziet, rēķins tiek uzskatīts par nepiegādātu. Klients to pat neredz. Tāpēc kļūdu labošana ir kritiska.

Top 12 kļūdas (ar “kā izlabot” katrai)

Mēs esam apkopojuši biežākās problēmas, ar kurām saskaras uzņēmēji, mēģinot sagatavot e-rēķina XML.

1. Kļūda: "Address is not structured"

Simptoms: Paziņojums, ka trūkst ielas nosaukuma, pilsētas vai pasta indeksa. Iemesls: PDF rēķinos mēs esam pieraduši rakstīt adresi vienā garā rindā: "Brīvības 1, Rīga, LV-1010". Peppol standartā katrai detaļai ir savs plauktiņš (<cbc:StreetName>, <cbc:CityName>). Ja visa adrese ielikta vienā laukā, sistēma to nevar nolasīt.

• Kā salabot: Ieej klienta vai sava uzņēmuma profilā un sadali adresi pa laukiem: Iela atsevišķi, Mājas Nr. atsevišķi, Pilsēta atsevišķi, Indekss atsevišķi.

Vairāk par datu sagatavošanu: https://www.erekini.eu/app/blog/peppol-xml-dati-uznemumam.

2. Kļūda: "Invalid VAT ID format"

Simptoms: Kļūda par "Party Tax Scheme". Iemesls: Ievadīts PVN numurs bez valsts koda vai ar atstarpēm.

• Slikti: 40003000000 vai LV 40003000000
• Labi: LV40003000000
• Kā salabot: Pārliecinies, ka PVN numura laukā nav atstarpju un obligāti ir divu burtu valsts kods (piem., LV).

3. Kļūda: "VAT category code mismatch" (S vs Z)

Simptoms: "Tax category code S implies standard rate". Iemesls: Tu rēķinā norādīji 21% likmi, bet XML kodā (vai iestatījumos) ir izvēlēts kods "Z" (Zero) vai otrādi.

• Kā salabot:
  • Ja 21%: Lieto kodu S (Standard).
  • Ja 0% (Eksports): Lieto kodu Z (Zero rated).
  • Ja Nav PVN (Mazais uzņēmums): Lieto kodu O (Outside scope).
  • Ja Reversais (Būvniecība): Lieto kodu AE. erekini.eu sistēma šos kodus piešķir automātiski, ja izvēlies pareizo likmi nolaižamajā izvēlnē.

4. Kļūda: Matemātiskā neprecizitāte (Rounding error)

Simptoms: "Sum of line amounts does not equal total amount". Iemesls: Klasiska problēma. * Rinda 1: 10.004 EUR -> noapaļojas uz 10.00 * Rinda 2: 10.004 EUR -> noapaļojas uz 10.00 * Kopā: 20.008 -> noapaļojas uz 20.01 (atkarībā no loģikas). Peppol prasa, lai rindu summa precīzi sakristu ar kopsummu līdz centam.

• Kā salabot: Pārbaudi cenas un daudzumus. Izmanto sistēmu, kas veic aprēķinus saskaņā ar XML noapaļošanas noteikumiem (uz leju/augšu uz tuvāko 2. zīmi aiz komata).

5. Kļūda: Trūkst Mērvienības koda (Unit Code)

Simptoms: Kļūda pie "Invoiced Quantity". Iemesls: Ierakstīts "kaste" vai "paka", bet sistēma gaida ISO kodu.

• Kā salabot: Vienmēr izvēlies mērvienību no klasifikatora.
  • Gabali -> C62 vai H87
  • Stundas -> HUR
  • Kilogrami -> KGM

6. Kļūda: "Payment Means missing IBAN"

Simptoms: Rēķins ir derīgs, bet nav norādīts, kur maksāt. Iemesls: XML failā trūkst <cac:PayeeFinancialAccount>. Lai gan PDFā bankas konts var būt rakstīts piezīmēs, XML tas ir obligāts strukturēts lauks.

• Kā salabot: Pārliecinies, ka uzņēmuma iestatījumos ir ievadīts IBAN un tas ir piesaistīts konkrētajam rēķinam.

7. Kļūda: "Endpoint ID scheme missing"

Simptoms: Sistēma nesaprot, kas ir pircējs. Iemesls: Peppol tīklā uzņēmumus identificē pēc "Endpoint ID". Latvijā tas parasti ir reģistrācijas numurs, bet tam priekšā vajag shēmas kodu 0208.

• Kā salabot: Ģenerējot XML erekini.eu, pārliecinies, ka pircējam ir ievadīts pareizs Reģ. Nr. Sistēma automātiski pieliks 0208: prefiksu.

8. Kļūda: Datuma formāts

Simptoms: "Invalid date format". Iemesls: Mēģināts nosūtīt "05.01.2026".

• Kā salabot: XML standartā vienīgais pieļaujamais formāts ir YYYY-MM-DD (2026-01-05).

9. Kļūda: "Invoice Line Net Amount must be positive"

Simptoms: Negatīva rinda rēķinā. Iemesls: Tu gribēji iedot atlaidi un ierakstīji rindu "-10 EUR". Lai gan dažas sistēmas to pieļauj, stingrā validācija var pieprasīt, lai atlaides tiktu noformētas kā atsevišķs "Allowance" elements, nevis negatīva cena.

• Kā salabot: Izmanto sistēmas "Atlaides" funkciju, nevis mīnusa zīmi pie cenas, vai pārbaudi, vai konkrētais profils atļauj negatīvas rindas.

10. Kļūda: "Missing Order Reference"

Simptoms: "Buyer requires Order Reference". Iemesls: Tehniski rēķins ir pareizs, bet Tavs klients (pircējs) ir iestatījis noteikumu, ka nepieņems rēķinus bez Pasūtījuma numura. Tas bieži notiek valsts iepirkumos.

• Kā salabot: Rēķina ievades formā atrodi lauku "Pasūtījuma Nr." (Purchase Order / Reference) un ievadi numuru, ko Tev iedeva klients.

11. Kļūda: "Seller name is empty"

Simptoms: Trūkst pārdevēja nosaukuma. Iemesls: Ja esi pašnodarbinātais, dažreiz lauks "Uzņēmuma nosaukums" tiek atstāts tukšs.

• Kā salabot: Arī pašnodarbinātajiem XML failā laukā <cac:PartyName> jābūt vērtībai. Ieraksti savu Vārdu, Uzvārdu.

12. Kļūda: Sajauktas valūtas

Simptoms: "CurrencyID does not match". Iemesls: Rēķina kopsumma ir EUR, bet kādā rindā vai nodokļu aprēķinā "ieslīdējusi" cita valūta.

• Kā salabot: Peppol XML parasti paredz vienu valūtu visam dokumentam. Pārliecinies, ka viss ir EUR.

Vairāk par to, kā pareizi ģenerēt failu no nulles: https://www.erekini.eu/app/blog/peppol-xml-en16931-ka-generate.

Mini-checklist pirms eksporta

Pirms nospied "Lejupielādēt XML" vai "Sūtīt e-rēķinu", velti 10 sekundes šai pārbaudei. Tas ietaupīs Tev stundas problēmu risināšanā.

• [ ] Manas adreses dati: Vai mana adrese profilā ir sadalīta pa laukiem (Iela, Pilsēta, Indekss)?
• [ ] Klienta dati: Vai klientam ir ievadīts Reģ. Nr. un precīza adrese?
• [ ] PVN: Vai esmu izvēlējies pareizo PVN statusu (Maksātājs/Nemaksātājs)?
• [ ] IBAN: Vai ir norādīts bankas konts?
• [ ] Mērvienības: Vai precēm ir izvēlētas standarta mērvienības (gab, h, kg)?

Sīkāku rekvizītu skaidrojumu meklē šeit: https://www.erekini.eu/app/blog/rekina-rekviziti-sia-pasnodarbinatais.

Kad ir vērts automatizēt procesu

Ja Tu izraksti vienu rēķinu gadā, varbūt vari mēģināt "izburties" cauri kļūdām. Bet ja Tev ir regulāri darījumi ar valsts iestādēm vai lieliem uzņēmumiem, cīņa ar validācijas kļūdām ir dārga laika izšķiešana.

Katra kļūda nozīmē:

1. Rēķina noraidīšanu.
2. Zvanu no klienta grāmatveža.
3. Labošanu un sūtīšanu no jauna.
4. Apmaksas termiņa "resetu" (naudu saņemsi vēlāk).

Solo plāns (€12/mēn) noņem šīs galvassāpes:

• Automātiska validācija: Sistēma neļauj Tev saglabāt rēķinu ar nepareiziem datiem. Tā Tevi brīdina pirms kļūda notiek.
• Gatavi šabloni: PVN kodi, mērvienības un adreses struktūras jau ir ieprogrammētas. Tev nav jādomā par "C62" vai "S" kodiem.
• Peppol atbilstība: Fails tiek ģenerēts tieši pēc EN16931 standarta.

Ja vēlies, lai Tavs bizness strādātu bez aizķeršanās, automatizācija ir vienīgais ceļš.

Apskati, kā Solo plāns var palīdzēt: https://www.erekini.eu/pricing

Kopsavilkums

Peppol XML kļūdas nav pasaules gals. Tās ir tikai signāls, ka dati nav pietiekami precīzi. Strukturēts e-rēķins pieprasa kārtību, un ilgtermiņā šī kārtība nāk par labu Tavam biznesam – mazāk pārpratumu, ātrāka apmaksa, sakārtota grāmatvedība.

Izmantojot pareizos rīkus un zinot "lamatas", no kurām izvairīties, Tu vari ģenerēt validus e-rēķinus ar aizvērtām acīm.

Neļauj tehnoloģijām bremzēt Tavu naudas plūsmu.

Sāc ar PDF bez maksas: https://www.erekini.eu Vajag XML bez kļūdām? Pārej uz Solo plānu: https://www.erekini.eu/pricing

Biežāk uzdotie jautājumi (FAQ)

Kas ir Schematron validācija? Tā ir tehnoloģija, ko izmanto e-rēķinu pārbaudē. Schematron faili satur biznesa noteikumus (piemēram, "Ja valsts ir LV, PVN likmei jābūt 21% vai 12%..."). Ja XML fails neatbilst šiem noteikumiem, tas tiek noraidīts.

Vai es varu izlabot XML failu ar Notepad? Teorētiski varat, bet tas ir ļoti riskanti. XML struktūra ir trausla. Ja nejauši izdzēsīsiet vienu < zīmi, viss fails būs nelasāms. Labāk labot datus rēķinu sistēmā un ģenerēt failu no jauna.

Ko darīt, ja klients prasa "CIUS" noteikumus? CIUS (Core Invoice Usage Specification) ir specifiski nacionālie noteikumi, kas ierobežo vai papildina vispārējo EN16931 standartu. Latvijā īpašu CIUS ierobežojumu ir maz, bet, piemēram, Igaunijā vai Vācijā var būt specifiskas prasības. erekini.eu standarta XML atbilst vispārējam Peppol BIS Billing 3.0 profilam, kas tiek pieņemts visā ES.

Vai PDF validācija eksistē? Nē. PDF failus nevar automātiski validēt pēc satura, jo tas ir tikai attēls. Tāpēc PDF kļūdas atklāj tikai cilvēks (grāmatvedis), parasti pēc vairākām dienām.

Vai bankas konts (IBAN) ir obligāts e-rēķinā? Jā, Peppol XML failā maksājuma informācija ir obligāta. Bez tās pircēja sistēma nevarēs sagatavot maksājuma uzdevumu.

Kāpēc sistēma prasa "Pasūtījuma Nr."? To parasti prasa pircēja sistēma, lai veiktu automātisku "3-way matching" (Pasūtījums - Preču saņemšana - Rēķins). Ja rēķinā nav pasūtījuma numura, robots nevar to savienot ar pasūtījumu un aptur apmaksu.

Vai es varu redzēt XML failu pirms sūtīšanas? Jā, erekini.eu sistēmā Jūs varat nospiest "Lejupielādēt XML" un atvērt to savā datorā (ar pārlūku vai teksta redaktoru), lai apskatītu saturu. Bet vislabākā pārbaude ir sistēmas iebūvētā validācija.