Kādi testi e-rēķinu API jāiztur pirms palaišanas produkcijā?

Pirms produkcijas e-rēķinu API integrācijai jāiztur četras testgadījumu grupas: korekti dokumenti (parasts rēķins, daudzrindu rēķins ar vairākām PVN likmēm, atlaide vai piemaksa dokumenta līmenī, apaļošanas robežgadījums, pircēja atsauce pret pasūtījuma atsauci, avansa rēķins, pilns un daļējs kredītrēķins), apzināti kļūdaini dokumenti, maršruta testi līdz reālam un pārbaudītam saņēmējam, kā arī ekspluatācijas testi: nepareizas piekļuves tiesības, dublēta nosūtīšana, atkārtota nosūtīšana, statusa pieprasījums un ikdienas salīdzinājums. Validēt vajag pret spēkā esošo noteikumu kopu: Peppol BIS Billing versija 3.0.21 ir obligāti jālieto no 2026. gada 17. augusta. Klāt nāk vietējās pārbaudes: vai Igaunijas pircējs ir e-komercreģistrā reģistrējies kā e-rēķinu saņēmējs un vai Latvijas darījumu dati laikus nonāk VID.

Galvenie fakti

FaktsVērtībaSpēkā noAvots
Peppol BIS Billing versija 3.0.21 ir obligātaObligāti jālieto no 17.08.2026; laidiens publicēts 20.05.20262026-08-17docs.peppol.eu
Validācijas artefakti (UBL un CII)Versija 1.3.16, publicēta 10.04.20262026-04-10docs.peppol.eu
EAS kodu saraksta labojums un stingrāki noteikumiIzņemti 14 nelietojami EAS kodi; PEPPOL-COMMON-R052 un R053 tagad ir kļūdas, nevis brīdinājumi2026-05-20docs.peppol.eu
Vispārējais noteikums par atsaucēm rēķināRēķinā jābūt vai nu pircēja atsaucei (BT-10), vai pasūtījuma atsaucei (BT-13)uz 2026-09docs.peppol.eu
Igaunija: tiesības pieprasīt e-rēķinuE-rēķinu var pieprasīt katrs grāmatvedības kārtošanas pienākuma subjekts, kas e-komercreģistrā reģistrējies kā e-rēķinu saņēmējs (Grāmatvedības likuma 7¹ panta 7. daļa); ap 18 000 uzņēmumu2025fin.ee
Latvija: e-rēķinu datu iesniegšana VIDNo 01.01.2026 B2G, G2B un G2G darījumos Latvijā reģistrētām personām; dati ne vēlāk kā 5 darbdienu laikā; B2B pārcelts uz 01.01.20282026-01-01vid.gov.lv

Vai zaļa atbilde testa vidē jau nozīmē gatavību?

Komandas integrāciju uzskata par pabeigtu pārāk agri, jo viens solis no četriem izdevās. Patiesībā šie četri soļi ir savstarpēji neatkarīgi.

Četri soļi, kas notiek pēc nosūtīšanas

Pirmkārt, jūsu grāmatvedības programma no saviem datiem izveido dokumentu UBL 2.1 formātā. Peppol BIS Billing izmanto UBL 2.1 Invoice un CreditNote shēmas, tāpēc korekts XML ir dokuments, kas validēts pret shēmu, nevis vienkārši glīti izskatīgs fails.

Otrkārt, jūsu sistēma to nosūta pakalpojuma sniedzēja saskarnē. Finbite gadījumā publiski norādītā datu apmaiņas adrese ir app.finbite.eu/finance/erp kopā ar WSDL aprakstu, taču konkrētos galvas laukus un piekļuves tiesības vienmēr saņemat no savas uzsākšanas instrukcijas.

Treškārt, pakalpojuma sniedzēja piekļuves punkts (Access Point) atrod saņēmēju reģistrā un nodod dokumentu pircēja piekļuves punktam, kas to savukārt nodod pircēja programmatūrai.

Ceturtkārt, jūs vēlāk spējat pierādīt, kas tieši ar dokumentu notika.

Kur visbiežāk rodas pārpratums

Visbiežāk sajauc otro un trešo soli. „API atbildēja 200“ nozīmē, ka pieprasījums tika pieņemts. Tas nenozīmē, ka dokuments nonāca līdz pircējam un ka pircējs to var izmantot savā grāmatvedībā.

Kādiem paraugdokumentiem jābūt komplektā pirms produkcijas?

Paraugdokumenti, proti, iepriekš sagatavoti testa rēķini, ir visa pasākuma kodols. Bez tiem jūs testējat nejaušu izlasi no tiem rēķiniem, kurus pārdošanas nodaļa nejauši izrakstīja pagājušajā nedēļā.

Derīgie gadījumi

  • parasts rēķins ar vienu rindu un vienu PVN likmi;
  • daudzrindu rēķins ar vismaz divām atšķirīgām PVN likmēm un korektu PVN kopsavilkumu;
  • atlaide un piemaksa dokumenta līmenī kopā ar pamatojumu;
  • apaļošanas robežgadījums, kurā rindu summa un dokumenta kopsumma atšķiras centos;
  • divi atsauču varianti, no kuriem viens nes tikai pircēja atsauci, otrs tikai pirkuma pasūtījuma atsauci. Specifikācija prasa, lai rēķinā būtu vai nu pircēja atsauce (BT-10), vai pasūtījuma atsauce (BT-13);
  • rēķins ar pielikumu, ja jūsu procesā pielikumi tiek izmantoti;
  • avansa rēķins. Latvijā šeit jābūt precīziem: VID skaidro, ka tikai informatīvs avansa rēķins nav jānoformē kā e-rēķins un tā dati nav jāiesniedz VID;
  • pilns un daļējs kredītrēķins ar atsauci uz sākotnējo rēķinu, kā arī negatīvs rēķins. Peppol prasa, lai saņemošā sistēma atbalstītu abus labošanas mehānismus, proti, gan kredītrēķinus, gan negatīvus rēķinus.

Apzināti kļūdainie gadījumi

Tie ir tikpat svarīgi. Minimālais komplekts: dokuments bez pircēja un bez pasūtījuma atsauces; dokuments ar nederīgu EAS kodu (Electronic Address Scheme, proti, kods, kas norāda, kurā reģistrā meklēt saņēmēja adresi); dokuments, kura PVN kopsavilkums nesakrīt ar rindām; un dokuments, kura CustomizationID laukā (tas norāda, pret kuru noteikumu kopu dokuments validējams) ir iekļauts versijas numurs. Pēdējo pārbaudi precizēja 3.0.21 laidienā, un runa ir par fatālu kļūdu.

Pie katra kļūdainā gadījuma pierakstiet, kādu kļūdas kodu jūs gaidāt. Ja gaidītais un rezultāts atšķiras, jūsu validatoram ir nepareiza versija.

Pret kuru noteikumu versiju validēt?

Validācijas slāņi un kļūdu kodi

Peppola pārbaude ir slāņota: vispirms XML sintakse un UBL struktūra, tad EN 16931 semantiskie noteikumi jeb Eiropas e-rēķina standarta prasības, tad Peppola paša CIUS noteikumi, proti, šā standarta sašaurinājums, un beigās valstu noteikumi, kas ieslēdzas pēc pārdevēja valsts koda.

Kļūdas labojiet tādā pašā secībā. XSD kļūda nozīmē, ka dokumenta struktūra ir salauzta. Kodi, kas sākas ar BR, norāda uz Eiropas standarta saturisku noteikumu, piemēram, summu vai PVN loģiku. Priedēklis PEPPOL nozīmē Peppola papildu ierobežojumu. Valsts koda noteikumi norāda uz vietējo prasību. BR kļūdas labošana pirms XSD kļūdas novēršanas ir laika izšķiešana, jo nākamais slānis vispār netiek darbā.

Kāpēc versijas numuram ir nozīme

3.0.21 publicēta 2026. gada 20. maijā, un tā izmanto UBL un CII validācijas artefaktus versijā 1.3.16, kas publicēta 2026. gada 10. aprīlī. Tas pats laidiens izlaboja EAS kodu sarakstu un izņēma 14 nelietojamus kodus, kā arī noteikumus PEPPOL-COMMON-R052 un PEPPOL-COMMON-R053 no brīdinājumiem pārvērta par kļūdām visos profilos.

Tulkojumā: identifikatoru paraugdokumenti, kas pērn deva dzeltenu brīdinājumu, šodien var tikt atgrūsti. Palaidiet validatoru lokāli, savā CI konveijerā, un artefaktu versiju nofiksējiet konfigurācijā, nevis izstrādātāja portatīvajā datorā.

Kāpēc nepietiek tikai ar XML testēšanu?

Formāli korekts rēķins, kas aiziet nepareizam saņēmējam, ir sliktāks par atgrūstu rēķinu. Tāpēc maršrutu pārbaudiet atsevišķi no formāta.

Saņēmēja identifikators un shēma

Vai Peppol ID veidojat no pareizā reģistrācijas numura vai PVN numura un ar pareizo EAS shēmas kodu? Pievienojiet šeit negatīvu testu ar kodu, kas ir izņemts no saraksta.

Spēju pieprasījums un profila izvēle

Pirms nosūtīšanas reģistrā jāpajautā, vai adresāts vispār pieņem šo dokumenta veidu. Ja jūsu sistēma to nedara, kļūdu uzzināsiet no klienta.

Pēc noklusējuma izmantojat profilu 01 (Billing). Jaunais izvēles profils 02, proti, Billing with Response, prasa atsevišķu SMP reģistrāciju. SMP (Service Metadata Publisher) ir publisks reģistrs, kurā norādīts, ko saņēmējs spēj pieņemt. Šo profilu testējiet tikai tad, ja tam reģistrēts gan sūtītājs, gan saņēmējs.

Piegāde līdz īstam saņēmējam

Vismaz vienam dokumentam jānonāk līdz galam kontā, kas ir jūsu kontrolē, vai pie sadarboties gatava partnera, kurš apstiprina, ka dati viņa programmatūrā atvērās salasāmi.

Kādas kļūdas jāizraisa pašiem, pirms tās atrod klients?

Produkcijā rodas kļūdas, kādas testa vide nerada. Tās jāizraisa pašiem.

Piekļuves tiesības, noildzes un atkārtota nosūtīšana

  • nepareizas vai novecojušas piekļuves tiesības: vai kļūda tiek saprotami ierakstīta žurnālā un vai nosūtīšana apstājas, nevis atkārtojas bezgalīgi;
  • kļūdains pieprasījums (trūkst obligāta lauka, salauzts XML): vai jūsu pusē atšķir „mūsu kļūdu“ un „pakalpojuma sniedzēja kļūdu“;
  • noildze un pārtraukts savienojums: vai atkārtota nosūtīšana ir droša un vai tai ir augšējā robeža.

Dublēšanās, statusi un ikdienas salīdzinājums

  • dublēšanās novēršana: viena un tā paša rēķina numura otrreizēja nosūtīšana nedrīkst radīt pircējam divus rēķinus. Kā pakalpojuma sniedzējs apstrādā atkārtotu pieprasījumu, ir katra sniedzēja līgumiska detaļa, tāpēc pārvaicājiet to rakstiski un nepaļaujieties uz pieņēmumiem;
  • statusu atšķiršana: starpstatuss („apstrādē“) nav gala statuss. Saglabājiet pakalpojuma sniedzēja piešķirto dokumenta identifikatoru pie katra sūtījuma, citādi vēlāk nebūs ar ko strīdēties;
  • ikdienas salīdzinājums: ERP sistēmā par nosūtītiem atzīmēto rēķinu skaits pret sniedzēja žurnālu. Atšķirība, kuru neviens neskatās, klusi aug.

Kādi grāmatvedības scenāriji atklāj vāju integrāciju?

Pirms palaišanas produkcijā paņemiet divas stundas grāmatveža laika. Pārbaudiet numerācijas nepārtrauktību, PVN un kopsummu sakritību starp ERP un nosūtīto failu, pircēja atsauces redzamību pircēja pusē, kredītrēķina sasaisti ar sākotnējo rēķinu, pielikumu nonākšanu adresātam un cilvēkam salasāmo formu. Pēdējais nav kosmētika: Igaunijas Finanšu ministrija uzsver, ka attaisnojuma dokumentam jāļauj katram lasītājam saprast darījuma saturu, tāpēc praksē blakus mašīnlasāmam e-rēķinam bieži ceļo arī PDF.

Ejiet produkcijā ar nelielu un pārraugāmu plūsmu

Iesaldējiet pārbaudīto kartējumu (mapping) un validatora versiju. Apstipriniet produkcijas piekļuves tiesības un saņēmēju datus. Pirmajā dienā nosūtiet pāris īstus rēķinus, kuriem paši sekojat, un vakarā salīdziniet sniedzēja un ERP ierakstus. Nosakiet vārdā, kas nākamās darbdienas rītā paņem atgrūsto dokumentu.

Igaunijas klienta papildu pārbaude

Laidiena pārbaudei pievienojiet vienu pieprasījumu: vai pircējs ir Igaunijas e-komercreģistrā reģistrējies kā e-rēķinu saņēmējs. No 2025. gada katram tādam grāmatvedības kārtošanas pienākuma subjektam ir tiesības pieprasīt e-rēķinu (Grāmatvedības likuma 7¹ panta 7. daļa). Tas pats avots skaidri norāda, ka Igaunija balstās uz formāta brīvību: atļauts gan Igaunijas, gan Eiropas standarts. Tāpēc nav vērts kodēt pieņēmumu, ka vienīgā pareizā izvade ir Peppol.

Latvijas klienta kalendārs un VID dati

Latvijā reģistrētu uzņēmumu rēķiniem publiskā sektora saņēmējiem jābūt strukturētiem e-rēķiniem no 2025. gada 1. janvāra, un no 2026. gada 1. janvāra B2G, G2B un G2G darījumu e-rēķinu dati jāiesniedz arī VID, ne vēlāk kā piecu darbdienu laikā no rēķina nosūtīšanas. Ārvalstu uzņēmumam šā VID iesniegšanas pienākuma pašlaik nav. Obligātā B2B strukturēto rēķinu aprite un datu iesniegšana pārcelta uz 2028. gada 1. janvāri, nevis 2026. gadu, kā sākotnēji plānots.

Praktisks testgadījums: nosūtiet rēķinu, saglabājiet nosūtīšanas laika zīmogu un pārbaudiet, vai jūsu sistēma prot parādīt, kuri Latvijas rēķini ir iesniegti VID un kuri vēl ir atvērti piecu darbdienu robežās.

Pēdējo reizi pārbaudīts:

Vai API atbildes kods 200 apstiprina e-rēķina sekmīgu nonākšanu līdz pircējam?

Nē, API statusa kods 200 apstiprina vienīgi to, ka pakalpojuma sniedzējs ir pieņēmis pieprasījumu. Tas negarantē, ka fails ir izturējis Peppol validāciju, nonācis saņēmēja piekļuves punktā vai korekti atvēries pircēja grāmatvedības programmā.

Kuru Peppol noteikumu kopas versiju jāņem par pamatu, testējot e-rēķinu API?

Validējot jāvadās pēc Peppol BIS Billing 3.0.21 noteikumiem kopā ar validācijas artefaktiem versijā 1.3.16, kas obligāti jālieto no 2026. gada 17. augusta. Šajā versijā par kļūdām pārvērsti identifikatoru noteikumi PEPPOL-COMMON-R052 un R053, kas agrāk darbojās kā brīdinājumi.

Kādi kļūdaini gadījumi noteikti jāpārbauda e-rēķinu API?

Testu komplektā jāiekļauj dokumenti bez pircēja un pasūtījuma atsauces, ar novecojušiem EAS kodiem, kā arī ar kļūdainiem PVN ierakstiem. Papildus jāsimulē tīkla noildzes, nederīgas autentifikācijas pilnvaras un dublēta nosūtīšana ar vienu un to pašu rēķina numuru, lai pārbaudītu sistēmas spēju atgūties.