Serbia eOtpremnica: kuidas ühendada ERP, WMS ja TMS 1. oktoobriks 2027

Alates 1. oktoobrist 2027 on Serbias iga kaubaliikumise jaoks kahe käibemaksukohustuslasest eraettevõtte vahel vaja elektroonilist saatelehte, eOtpremnicat, mis tuleb saata rahandusministeeriumi süsteemi kaudu enne, kui kaup teele läheb. Kauba vastuvõtja peab kättesaamist samas süsteemis mõne päeva jooksul kinnitama ja vedaja peab suutma saatelehe kontrolli käigus ette näidata.

See hõlmab müügitarneid, tagastusi ja ümberpaigutusi teie enda ladude vahel. Saateleht ei ole enam vorm, mille teie ERP välja prindib. Sellest saab UBL-fail, mis liigub läbi riikliku API, tuleb tagasi identifikaatori ja QR-koodiga ning läbib seejärel mõlemal poolel olekute töövoo.

Kellele see artikkel on mõeldud

Kui esitate arveid ja saadate kaupa Minimaxist, BizniSoftist või Pantheonist, on teie tarnija eOtpremnica toe juba välja andnud. Kui teie maht on nii väike, et saatelehti saab sisestada ministeeriumi tasuta veebiportaalis või mobiilirakenduses, sobib ka see. Lugege läbi vastuvõtu tähtaegade osa, koolitage laadimisplatvormi töötajad ja suurem osa tööst on tehtud.

See artikkel on mõeldud teisele rühmale: hulgimüüjatele, tootjatele, edasimüüjatele ja vedajatele, kelle kaubasaatmine ja kauba vastuvõtt käivad läbi oma ERP-i, kohandatud WMS-i, TMS-i või B2B-tellimusi kirjendava e-poe tagasüsteemi. Keegi ei saada teile uuendust. Liidestuse peate ise ehitama.

Mis juba kehtib ja mis muutub

Elektrooniliste saatelehtede seadus (Zakon o elektronskim otpremnicama) on 2024. aastast ja seda on pärast seda kaks korda muudetud. Viimane muutmisseadus, mis avaldati 31. augustil 2026 Službeni glasnikus nr 80/2026, jättis 2027. aasta oktoobri kuupäeva alles. Etapid on kirjas ministeeriumi KKK-s ja seaduse terviktekstis.

Alates 1. jaanuarist 2026:

• Eraettevõtted saadavad ja võtavad vastu eOtpremnicat aktsiisikaupade puhul: tubakas, nikotiinitooted, kohv, alkohoolsed joogid ja naftatooted.
• Eraettevõtted saadavad selle mis tahes kauba kohta, mis tarnitakse avaliku sektori üksusele, ja avaliku sektori üksused saadavad selle oma kaubaliikumiste kohta.
• Vedajad esitavad saatelehe nende liikumiste puhul.

Tootmissüsteem on töötanud alates 30. detsembrist 2025. Demokeskkond, mis on mõeldud ettevõttesisese tarkvara testimiseks, on avatud alates 5. märtsist 2025.

Alates 1. oktoobrist 2027:

• Saatmiskohustus juhul, kui nii saatja kui ka saaja on erasektori üksused ja kaup ei ole aktsiisikaup.
• Iga erasektori üksuse kohustus saatelehti vastu võtta.
• Vedajad esitavad saatelehe nende liikumiste puhul.

Mõni üksikasi tuleb paljudele üllatusena. Ümberpaigutus kahe lao vahel sama tehase territooriumil vajab sisemist saatelehte (XML-is tüüp Int), kui kauba aadress muutub ja kasutatakse avalikku teed. Import vajab sisemist saatelehte kohast, kus omandasite käsutusõiguse, või mõnel juhul tollipunktist teie lattu. Ekspordi puhul on see tavaliselt vaja kuni punktini, kus ekspedeerija kauba üle võtab. Fiskaliseerimisseaduse alusel tehtud jaemüük on vabastatud, nii et fiskaaltšekkide alusel müüv e-pood jääb nende tellimuste osas kohaldamisalast välja. Selle hulgimüügi pool mitte.

Augustikuine muudatus ütleb ka, et kuni 1. jaanuarini 2027 ei võta järelevalveasutused saadetud saatelehtede ja vastuvõtuteatiste andmevigu arvesse. See aitab aktsiisikaupade ja avaliku sektori saatjaid. 2027. aasta oktoobri jaoks ei muuda see midagi.

Kas kuupäev võib nihkuda? Seadust on vähem kui kahe aasta jooksul muudetud kaks korda, nii et uued muudatused on võimalikud. Kuid äsja vastu võetud muudatus jättis kuupäeva paika. Planeerige selle järgi.

Tähtajad on vastuvõtu sammus

Saatmine on lihtsam pool. Seaduse tervikteksti järgi on ranged tähtajad vastuvõtja poolel.

1. Enne kauba liikumist saadab saatja saatelehe. Kuni saaja ei ole füüsilist kättesaamist kinnitanud, võib saatja selle põhjendusega tühistada.
2. Füüsiline kättesaamine tuleb kinnitada kauba ülevõtmise päeval või hiljemalt kolm tööpäeva pärast vastuvõtu algust.
3. Kaheksa päeva jooksul pärast seda kinnitust võtab saaja tarne vastu või lükkab selle tagasi, täielikult või osaliselt, saates ePrijemnica (elektroonilise vastuvõtuteatise).
4. Erasektori saaja, kes kaheksa päeva jooksul midagi ei saada, loetakse tarne täielikult tagasi lükanuks. Avaliku sektori saaja puhul on vastupidi: vaikimine tähendab nõustumist.
5. Osalise vastuvõtmise korral on saatjal e-vastuvõtuteatise saabumisest 30 päeva aega erinevustega nõustuda. Vastasel juhul loetakse, et ta on e-vastuvõtuteatise täielikult tagasi lükanud.
6. Saateleht, mille füüsilist kättesaamist pole kinnitatud, kaotab kehtivuse 30 päeva pärast liikumise algust.

Kui mõlemad pooled on kokku leppinud, saavad dokumendid oleku Usaglašeno (API-s Fulfilled) ja pärast seda ei saa midagi muuta.

Füüsilise kättesaamise tähtaja ületamine on seaduses loetletud rikkumine: ettevõttele 200 000 kuni 2 000 000 dinaari ja vastutavale isikule 50 000 kuni 150 000 dinaari. Sama vahemik kehtib siis, kui saatelehte üldse ei saadeta.

Praktiline järeldus: füüsiline kättesaamine kuulub laadimisplatvormile, WMS-i, sellesse hetke, kui kaup arvele võetakse. Kui see jääb ootama kedagi, kes kuu lõpus andmeid võrdleb, on tähtaeg juba möödas.

Mida ehitada ministeeriumi API vastu

Tehniline dokumentatsioon kirjeldab REST API-t, mis vahetab UBL 2.1 XML-i. eOtpremnica on DespatchAdvice, ePrijemnica on ReceiptAdvice ja iga muu samm (tühistamine, veo algus, sõiduki vahetus, füüsiline kättesaamine, e-vastuvõtuteatise aktsepteerimine või tagasilükkamine) on numbrilise koodiga ApplicationResponse. Ministeerium korraldas 5. detsembril 2025 IT-sektorile töötoa dokumendiliikide, XML-laienduste, esitamise ja veebikonksude (webhook) teemal.

Saatmine

Kõik dokumendid lähevad ühte otspunkti, POST /public/documents/requests, koos teie enda unikaalse päringu-ID-ga. Töötlemine on asünkroonne. Tulemus saabub hiljem veebikonksu kaudu või päringuga otspunkti /public/documents/requests/changes, mis näitab iga päringu olekut (ootel, õnnestunud või ebaõnnestunud) koos äriliste vigadega.

Seega vajab teie ERP väljaminevate dokumentide järjekorda: kirje iga saatelehe kohta, olekumasinat ja korduskatsete teed, mis ei tekita duplikaate. Süsteem lükkab tagasi dokumendinumbri, mis teie ettevõttel juba olemas on, ja see aitab, kuid ainult siis, kui teie numeratsioon jääb korduskatsete vahel samaks.

Ministeeriumi API KKK vealoetelu näitab, kus andmetöö on:

• Väljastamise kuupäev peab olema tänane, Serbia aja järgi. Tagantjärele dateerida ei saa ja eilseid saatelehti ei saa üleöö järjekorras hoida.
• Igal aadressil (teie, kliendi, vedaja, laadimis- ja mahalaadimiskohtade aadressil) peab olema tänav ja linn.
• Oma transpordi, vedaja või saaja transpordi puhul on vedaja, sõiduki registreerimisnumber ja transpordivahend kohustuslikud. Oma transpordi korral tuleb lisaks teie ettevõttele sisse lülitada vedaja staatus.
• Kogustel on mõõtühiku kood. Read nummerdatakse alates 1-st. GTIN, kui see on antud, koosneb ainult numbritest.
• Saaja peab olema registreeritud ja aktiivne. GET /public/companies/status kontrollib PIB-i enne saatmist.

Põhiandmed on tavaliselt suurem töö kui XML. Valideerimise otspunkt võimaldab dokumente enne esitamist testida ja see kuulub teie testikomplekti.

Vastuvõtmine ja ladu

Sissetulevad saatelehed saabuvad otspunkti /public/documents/customers/changes kaudu, mida küsitakse kuupäevade kaupa 1 000 muudatust lehel, või veebikonksuga. Veebikonksu tellimus kehtib päevakaupa: päring /public/webhook-notifications/subscribe katab järgmise päeva. Käivitage see ajastatud tööna, seadke tõrke korral häire ja hoidke tõmbeotspunkt öise kontrollina alles, et vahele jäänud teavitusest ei saaks vahele jäänud tähtaeg.

Iga sissetulev saateleht peaks jõudma WMS-i oodatava vastuvõtuna, kus tarnija tootekoodid on vastendatud teie omadega. Kui kaup arvele võetakse, saadab WMS füüsilise kättesaamise toimingu. Pärast koguse ja kvaliteedi kontrolli saadab see ePrijemnica: iga rea kohta saabunud kogus ning tagasi lükatud ja sama sõidukiga tagasi saadetud kogus. Süsteem ei aktsepteeri tagasilükatud kogust, mis on suurem kui vastu võetud kogus.

Ministeeriumi enda rollimudel on kasulik eeskuju. Selle laoroll saab sissetulevaid saatelehti loetleda ja alla laadida ning füüsilist kättesaamist kinnitada. Sama kuju sobib ka WMS-i õigusteks.

Saatjana saate ka teise poole e-vastuvõtuteatise ning peate selle aktsepteerima või tagasi lükkama. Jälgige 30-päevast kokkuleppe akent ERP-is, mitte kellegi postkastis.

Sidumine SEF-i e-arvetega

Saatelehe sidumine SEF-i e-arvega on vabatahtlik. Kui saateleht on saadetud ja selle tegelik väljasaatmise aeg on möödas, saab SEF siduda ühe või mitu saatelehte ühe e-arvega ja arve ei pea ootama vastuvõtu töövoo lõppu. Kui teie tellimuse, tarne ja arve kolmepoolne võrdlus juba ERP-is töötab, annab sidumine teie kliendi ostureskontrole samad tõendid. SEF-i poole katab meie e-arvete liidestuse töö.

Vedajad ja maantee

Juht saab saatelehte näidata ministeeriumi vedajarakendusest. Kui vedaja ei ole süsteemi kasutaja, prindib saatja saatelehe välja, vedaja allkirjastab selle enne väljasõitu ja saatja laadib allkirjastatud koopia üles enne, kui kaup liikuma hakkab. Alates augustikuisest muudatusest võib vedaja, kes süsteemi kasutada ei saa, näidata selle asemel saatelehe saatmisel loodud QR-koodi; saatja lisab siis enne väljasõitu prinditava vaate. Teie TMS peab suutma toota seda varianti, mida teie vedajad kasutavad, ja API tagastab QR-koodi siltide jaoks eraldi.

Rikke puhuks on olemas paberil varulahendus: kolm prinditud eksemplari Serbia Rahvapanga Topčideri rahapajast pärit turvahologrammkleebistega, mis kantakse süsteemi järgmiseks tööpäevaks. Ostke kleebised enne, kui neid vaja läheb.

Kuidas API-võti töötab

Ettevõtte registreerib seaduslik esindaja, kes logib sisse riikliku e-ID portaali kaudu. Seejärel luuakse võtmed veebiliideses (Settings, API settings, Admin module, API keys). Demo ja tootmine on eraldi keskkonnad, nii et arvestage võtmetega mõlemas.

Võti tuvastab ettevõtte. API KKK on otsekohene: teise ettevõtte nimel dokumente saata ei saa ja süsteem tunneb ettevõtte ära esitatud API-võtme järgi. Praktikas tähendab see järgmist:

• Viie juriidilise isikuga kontsern vajab viit võtit ja marsruuterit, mis valib PIB-i järgi õige võtme.
• Jagatud teenuskeskus või tarkvaraettevõte ei saa kõiki kliente ühe võtmega läbi lasta.
• Võtmed kuuluvad saladuste hoidlasse, millel on omanik ja rotatsioonikord, mitte ERP-serveri konfiguratsioonifaili.

12 kuu plaan

Praegu on 2026. aasta oktoober. Tagurpidi alates 1. oktoobrist 2027:

Oktoobrist detsembrini 2026: inventuur ja juurdepääs.

• Loetlege kõik liikumisliigid: müük, tagastused, ladudevahelised ümberpaigutused, import, eksport, oma autopark, kolmandatest osapooltest vedajad, kliendi ise järeletulek.
• Registreerige ettevõte tootmiskeskkonnas ja hankige demokeskkonna API-võtmed.
• Alustage põhiandmete korrastamist: aadressid, partnerite PIB-id ja registrikoodid, vedajad, sõidukid, mõõtühikud.

Jaanuarist märtsini 2027: saatmise rada.

• DespatchAdvice'i genereerimine saadetistest koos väljaminevate dokumentide järjekorra, asünkroonse olekute jälgimise ja veakäsitlusega.
• Igapäevane veebikonksu tellimise töö ja tõmbepäringutega kontroll.
• Validaator käib CI-s demokeskkonna vastu.

Aprillist juunini 2027: vastuvõtmine ja vastuvõtuteatis.

• Sissetulevad saatelehed WMS-i oodatavate vastuvõttudena.
• Füüsiline kättesaamine laadimisplatvormil, ePrijemnica pärast kontrolli, häired kolmest päevast teisel ja kaheksast päevast kuuendal päeval.
• Saatjana saadud e-vastuvõtuteatiste aktsepteerimine ja tagasilükkamine. SEF-iga sidumine, kui seda soovite.

Juulist septembrini 2027: maantee ja pilootprojekt.

• Vedajate töövoog, printimine ja QR-kood, võrguühenduseta protseduur koos kleebistega kohapeal.
• Saatke tootmiskeskkonnas päris saatelehti partneritega, kes on end registreerinud; eraettevõtted võivad süsteemi juba vabatahtlikult kasutada.
• Koolitage laotöötajaid ja juhte. Septembris külmutage muudatused.

Kaksteist kuud on mugav aeg ühe puhaste andmetega juriidilise isiku jaoks. Kontserni jaoks, kus on mitu juriidilist isikut, mitu ladu ja põhiandmed, mida keegi pole aastaid puudutanud, on see napp.

Kust abi saada

C9 Groupil on kontor Novi Sadis, nii et Serbia reeglid on meile koduväljak. Ehitame liidestuse ise: UBL-i genereerimise, API kliendi, veebikonksude käsitluse ja lao vastuvõtu töövoo teie olemasolevas ERP-is, WMS-is või e-poe tagasüsteemis. Vaadake meie ERP moderniseerimise teenust või kirjutage aadressil office@c9group.dev.