Serbijos eOtpremnica: kaip prijungti ERP, WMS ir TMS iki 2027 m. spalio 1 d.

Nuo 2027 m. spalio 1 d. kiekvienam prekių judėjimui tarp dviejų PVM mokėtojais įregistruotų privačių įmonių Serbijoje reikės elektroninio važtaraščio, eOtpremnica, išsiųsto per Finansų ministerijos sistemą prieš prekėms išvykstant. Prekes gaunanti įmonė per kelias dienas turi patvirtinti gavimą toje pačioje sistemoje, o vežėjas patikrinimo metu turi galėti parodyti važtaraštį.

Tai apima pardavimo pristatymus, grąžinimus ir perkėlimus tarp jūsų pačių sandėlių. Važtaraštis nebėra forma, kurią atspausdina jūsų ERP. Jis tampa UBL failu, kuris keliauja per valstybės API, grįžta su identifikatoriumi ir QR kodu, o tada abiejose pusėse juda per būsenų darbo eigą.

Kam verta tai perskaityti

Jei sąskaitas išrašote ir prekes siunčiate iš Minimax, BizniSoft ar Pantheon, jūsų tiekėjas eOtpremnica palaikymą jau teikia. Jei jūsų apimtys tokios mažos, kad važtaraščius galite įvesti nemokamame ministerijos interneto portale ar mobiliojoje programėlėje, tai irgi tinka. Perskaitykite skyrių apie gavimo terminus, apmokykite krovos zonos darbuotojus, ir didžiąja dalimi būsite pasiruošę.

Šis straipsnis skirtas kitai grupei: platintojams, gamintojams, didmenininkams ir vežėjams, kurių išsiuntimas ir prekių priėmimas vyksta per jų pačių ERP, pritaikytą WMS, TMS ar e. parduotuvės užpakalinę dalį, kurioje registruojami B2B užsakymai. Niekas jums atnaujinimo neatsiųs. Integraciją teks sukurti patiems.

Kas jau galioja ir kas keičiasi

Elektroninių važtaraščių įstatymas (Zakon o elektronskim otpremnicama) priimtas 2024 m. ir nuo to laiko keistas du kartus. Naujausias pakeitimų įstatymas, paskelbtas Službeni glasnik 80/2026 2026 m. rugpjūčio 31 d., išlaikė 2027 m. spalio datą. Etapus išdėsto ministerijos DUK ir konsoliduotas tekstas.

Nuo 2026 m. sausio 1 d.:

• Privačios įmonės siunčia ir gauna eOtpremnica akcizinėms prekėms: tabakui, nikotino produktams, kavai, alkoholiniams gėrimams ir naftos produktams.
• Privačios įmonės ją siunčia už bet kokias viešojo sektoriaus subjektui pristatomas prekes, o viešojo sektoriaus subjektai siunčia ją už savo pačių prekių judėjimą.
• Vežėjai šiems judėjimams pateikia važtaraštį.

Gamybinė sistema veikia nuo 2025 m. gruodžio 30 d. Demonstracinė aplinka, skirta vidinei programinei įrangai testuoti, atidaryta nuo 2025 m. kovo 5 d.

Nuo 2027 m. spalio 1 d.:

• Prievolė siųsti, kai siuntėjas ir gavėjas yra privataus sektoriaus subjektai, o prekės nėra akcizinės.
• Kiekvieno privataus sektoriaus subjekto prievolė gauti.
• Vežėjai šiems judėjimams pateikia važtaraštį.

Kelios detalės dažnai užklumpa netikėtai. Perkėlimui tarp dviejų sandėlių tame pačiame gamyklos komplekse reikia vidinio važtaraščio (XML tipas Int), jei prekės keičia adresą ir naudojamas viešasis kelias. Importui reikia vidinio važtaraščio nuo vietos, kurioje įgijote teisę disponuoti prekėmis, arba kai kuriais atvejais nuo muitinės įstaigos, iki jūsų sandėlio. Eksportui paprastai reikia važtaraščio iki vietos, kurioje prekes perima ekspeditorius. Mažmeninė prekyba pagal fiskalizavimo įstatymą atleidžiama, todėl e. parduotuvė, parduodanti su fiskaliniais kvitais, šiems užsakymams nepatenka į taikymo sritį. Jos didmeninė dalis patenka.

Rugpjūčio pakeitime taip pat numatyta, kad iki 2027 m. sausio 1 d. priežiūros institucijos neatsižvelgs į duomenų klaidas išsiųstuose važtaraščiuose ir gavimo dokumentuose. Tai padeda akcizinių prekių ir viešojo sektoriaus siuntėjams. 2027 m. spaliui tai nieko nekeičia.

Ar data gali pasikeisti? Įstatymas per mažiau nei dvejus metus pakeistas du kartus, todėl tolesni pakeitimai įmanomi. Tačiau ką tik priimtas pakeitimas datą išlaikė. Planuokite pagal ją.

Terminai slypi gavimo etape

Siuntimas yra lengvoji pusė. Konsoliduotas įstatymas griežtus terminus nustato gavimo pusei.

1. Prieš prekėms pajudant siuntėjas išsiunčia važtaraštį. Kol gavėjas nepatvirtino fizinio gavimo, siuntėjas gali jį atšaukti, nurodydamas priežastį.
2. Fizinis gavimas turi būti patvirtintas tą dieną, kai prekės perimamos, arba vėliausiai per tris darbo dienas nuo gavimo pradžios.
3. Per aštuonias dienas nuo šio patvirtinimo gavėjas priima arba atmeta pristatymą, visą ar dalį, išsiųsdamas ePrijemnica (elektroninį gavimo dokumentą).
4. Laikoma, kad privataus sektoriaus gavėjas, per aštuonias dienas nieko neišsiuntęs, atmetė visą pristatymą. Viešojo sektoriaus gavėjui priešingai: tyla reiškia priėmimą.
5. Dalinio priėmimo atveju siuntėjas turi 30 dienų nuo e. gavimo dokumento gavimo sutikti su skirtumais. Priešingu atveju laikoma, kad jis visą e. gavimo dokumentą atmetė.
6. Važtaraštis be fizinio gavimo patvirtinimo nustoja galioti praėjus 30 dienų nuo judėjimo pradžios.

Kai abi pusės sutaria, dokumentai pasiekia būseną Usaglašeno (API: Fulfilled), ir po to nieko pakeisti nebegalima.

Fizinio gavimo termino praleidimas yra įvardytas pažeidimas: nuo 200 000 iki 2 000 000 dinarų įmonei ir nuo 50 000 iki 150 000 dinarų atsakingam asmeniui. Tas pats intervalas taikomas, jei važtaraštis visai neišsiunčiamas.

Praktinė išvada: fizinis gavimas turi būti patvirtinamas krovos zonoje, WMS sistemoje, tuo metu, kai prekės priimamos. Jei jis laukia, kol kas nors sutikrins mėnesio pabaigoje, terminas jau bus praėjęs.

Ką kurti ministerijos API pagrindu

Techninėje dokumentacijoje aprašoma REST API, kuria keičiamasi UBL 2.1 XML dokumentais. eOtpremnica yra DespatchAdvice, ePrijemnica yra ReceiptAdvice, o kiekvienas kitas žingsnis (atšaukimas, transportavimo pradžia, transporto priemonės pakeitimas, fizinis gavimas, e. gavimo dokumento priėmimas ar atmetimas) yra ApplicationResponse su skaitiniu kodu. 2025 m. gruodžio 5 d. ministerija surengė seminarą IT sektoriui apie dokumentų tipus, XML plėtinius, pateikimą ir webhook pranešimus.

Siuntimas

Kiekvienas dokumentas siunčiamas į vieną galinį tašką, POST /public/documents/requests, su jūsų pačių unikaliu užklausos ID. Apdorojimas asinchroninis. Rezultatas ateina vėliau, per webhook arba užklausiant /public/documents/requests/changes, kuris kiekvienos užklausos būseną nurodo kaip laukiančią, sėkmingą arba nesėkmingą, pridėdamas verslo klaidas.

Todėl jūsų ERP reikia siunčiamųjų dėžutės: įrašo kiekvienam važtaraščiui, būsenų mašinos ir pakartotinio bandymo kelio, kuris nesukuria dublikatų. Sistema atmeta dokumento numerį, kuris jūsų įmonei jau egzistuoja, ir tai padeda, bet tik jei jūsų numeracija išlieka stabili per pakartotinius bandymus.

Klaidų sąrašas ministerijos API DUK parodo, kur slypi darbas su duomenimis:

• Išrašymo data turi būti šiandienos, pagal Serbijos laiką. Jokio datavimo atgaline data ir jokio vakarykščių važtaraščių laikymo eilėje per naktį.
• Kiekvienam adresui (jūsų, kliento, vežėjo, pakrovimo ir iškrovimo vietų) reikia gatvės ir miesto.
• Savo transportui, vežėjui ar gavėjo transportui privaloma nurodyti vežėją, transporto priemonės registracijos numerį ir transporto rūšį. Savam transportui taip pat reikia jūsų įmonei įjungti vežėjo statusą.
• Kiekiai turi matavimo vieneto kodą. Eilutės numeruojamos nuo 1. GTIN, jei nurodomas, sudarytas tik iš skaitmenų.
• Gavėjas turi būti registruotas ir aktyvus. GET /public/companies/status patikrina PIB prieš siunčiant.

Pagrindiniai duomenys paprastai yra didesnis darbas nei XML. Tikrinimo galinis taškas leidžia testuoti dokumentus prieš pateikiant, ir jam vieta jūsų testų rinkinyje.

Gavimas ir sandėlis

Gaunami važtaraščiai ateina per /public/documents/customers/changes, užklausiamą pagal datą po 1 000 pakeitimų puslapyje, arba per webhook. Webhook prenumerata galioja dieną: kvietimas /public/webhook-notifications/subscribe apima kitą dieną. Vykdykite jį kaip suplanuotą užduotį, nustatykite įspėjimą, jei ji nepavyksta, ir išlaikykite traukimo galinį tašką naktiniam sutikrinimui, kad praleistas pranešimas nevirstų praleistu terminu.

Kiekvienas gautas važtaraštis turėtų patekti į WMS kaip laukiamas priėmimas, su tiekėjo prekių kodais, susietais su jūsų kodais. Kai prekės priimamos, WMS išsiunčia fizinio gavimo veiksmą. Po kiekio ir kokybės patikrų jis išsiunčia ePrijemnica: kiekvienai eilutei atvykusį kiekį ir kiekį, atmestą ir grąžintą ta pačia transporto priemone. Sistema nepriims atmesto kiekio, didesnio už gautą.

Pačios ministerijos vaidmenų modelis yra naudingas šablonas. Jos sandėlio vaidmuo gali peržiūrėti ir atsisiųsti gaunamus važtaraščius bei patvirtinti fizinį gavimą. Toks pats turėtų būti ir WMS leidimų modelis.

Būdami siuntėju, jūs taip pat gaunate kitos pusės e. gavimo dokumentą ir turite jį priimti arba atmesti. 30 dienų suderinimo laikotarpį sekite ERP sistemoje, o ne kieno nors pašto dėžutėje.

Susiejimas su SEF e. sąskaitomis

Važtaraščio susiejimas su e. sąskaita SEF sistemoje neprivalomas. Kai važtaraštis išsiųstas ir faktinis jo išsiuntimo laikas praėjo, SEF gali susieti vieną ar kelis važtaraščius su viena e. sąskaita, ir sąskaita neturi laukti, kol baigsis gavimo darbo eiga. Jei jūsų trijų dokumentų sutikrinimas (užsakymas, pristatymas, sąskaita) jau vyksta ERP sistemoje, šis susiejimas jūsų kliento mokėtinų sumų skyriui suteikia tuos pačius įrodymus. SEF pusę apima mūsų e. sąskaitų integracijos darbai.

Vežėjai ir kelias

Vairuotojas gali parodyti važtaraštį iš ministerijos vežėjų programėlės. Jei vežėjas nėra sistemos naudotojas, siuntėjas atspausdina važtaraštį, vežėjas jį pasirašo prieš išvykdamas, o siuntėjas įkelia pasirašytą kopiją prieš prekėms pajudant. Nuo rugpjūčio pakeitimo vežėjas, kuris negali naudotis sistema, vietoj to gali parodyti QR kodą, sugeneruotą išsiunčiant važtaraštį; tada siuntėjas prieš išvykimą prideda spausdinamą vaizdą. Jūsų TMS turi pateikti tai, ką naudoja jūsų vežėjai, o API atskirai grąžina QR kodą etiketėms.

Sistemos sutrikimo atveju yra popierinė atsarginė tvarka: trys atspausdinti egzemplioriai su apsauginiais hologramos lipdukais iš Serbijos nacionalinio banko Topčider kalyklos, įregistruojami sistemoje iki kitos darbo dienos. Lipdukus įsigykite anksčiau, nei jų prireiks.

Kaip veikia API raktas

Teisinis atstovas įregistruoja įmonę, prisijungdamas per valstybinį eID portalą. Tada raktai kuriami žiniatinklio sąsajoje (Settings, API settings, Admin module, API keys). Demonstracinė ir gamybinė aplinka yra atskiros, todėl planuokite raktus abiem.

Raktas identifikuoja įmonę. API DUK sako tiesiai: siųsti dokumentų kitos įmonės vardu negalite, o sistema įmonę atpažįsta pagal pateiktą API raktą. Praktiškai:

• Grupei su penkiais juridiniais asmenimis reikia penkių raktų ir maršrutizatoriaus, kuris pagal PIB parenka tinkamą.
• Bendrųjų paslaugų centras ar programinės įrangos įmonė negali visų klientų siųsti per vieną raktą.
• Raktams vieta slaptųjų duomenų saugykloje su savininku ir keitimo procedūra, o ne konfigūracijos faile ERP serveryje.

12 mėnesių planas

Dabar 2026 m. spalis. Skaičiuojant atgal nuo 2027 m. spalio 1 d.:

Nuo 2026 m. spalio iki gruodžio: inventorizacija ir prieiga.

• Išvardykite visus judėjimo tipus: pardavimus, grąžinimus, perkėlimus tarp sandėlių, importą, eksportą, savą transportą, trečiųjų šalių vežėjus, kliento atsiėmimą.
• Įregistruokite įmonę gamybinėje aplinkoje ir gaukite demonstracinės aplinkos API raktus.
• Pradėkite valyti pagrindinius duomenis: adresus, partnerių PIB ir registracijos numerius, vežėjus, transporto priemones, matavimo vienetus.

Nuo 2027 m. sausio iki kovo: siuntimo kelias.

• DespatchAdvice generavimas iš siuntų, su siunčiamųjų dėžute, asinchroniniu būsenų sekimu ir klaidų apdorojimu.
• Kasdienė webhook prenumeratos užduotis ir traukimo sutikrinimas.
• Tikrinimo galinis taškas paleidžiamas CI konvejeryje prieš demonstracinę aplinką.

Nuo 2027 m. balandžio iki birželio: gavimas ir priėmimas.

• Gaunami važtaraščiai į WMS kaip laukiami priėmimai.
• Fizinis gavimas krovos zonoje, ePrijemnica po patikrų, įspėjimai antrą iš trijų ir šeštą iš aštuonių dienų.
• E. gavimo dokumentų, kuriuos gaunate kaip siuntėjas, priėmimas ir atmetimas. SEF susiejimas, jei jo norite.

Nuo 2027 m. liepos iki rugsėjo: kelias ir bandomasis etapas.

• Vežėjų srautas, spausdinimas ir QR, neprisijungus taikoma procedūra su lipdukais vietoje.
• Tikrų važtaraščių siuntimas gamybinėje aplinkoje su užsiregistravusiais partneriais; privačios įmonės jau gali naudotis sistema savanoriškai.
• Sandėlio darbuotojų ir vairuotojų mokymas. Pakeitimų įšaldymas rugsėjį.

Dvylikos mėnesių patogiai pakanka vienam juridiniam asmeniui su tvarkingais duomenimis. Grupei su keliais juridiniais asmenimis, keliais sandėliais ir pagrindiniais duomenimis, kurių niekas nelietė daugelį metų, to vos pakanka.

Kur gauti pagalbos

C9 Group turi biurą Novi Sade, todėl Serbijos taisyklės mums savos. Kuriame pačią integraciją: UBL generavimą, API klientą, webhook apdorojimą ir sandėlio priėmimo darbo eigą jūsų esamoje ERP, WMS ar e. parduotuvės užpakalinėje dalyje. Susipažinkite su mūsų ERP modernizavimo paslauga arba rašykite office@c9group.dev.