Serbian eOtpremnica: ERP-, WMS- ja TMS-järjestelmien liittäminen 1. lokakuuta 2027 mennessä

Lokakuun 2027 alusta lähtien jokainen tavaroiden siirto kahden Serbiassa arvonlisäverorekisteröidyn yksityisen yrityksen välillä vaatii sähköisen lähetysluettelon, eOtpremnican, joka lähetetään valtiovarainministeriön järjestelmän kautta ennen kuin tavarat lähtevät. Tavarat vastaanottavan yrityksen on vahvistettava vastaanotto samassa järjestelmässä muutaman päivän kuluessa, ja kuljetusliikkeen on pystyttävä esittämään lähetysluettelo tarkastuksessa.

Tämä kattaa myyntitoimitukset, palautukset ja siirrot omien varastojen välillä. Lähetysluettelo lakkaa olemasta lomake, jonka toiminnanohjausjärjestelmä tulostaa. Siitä tulee UBL-tiedosto, joka kulkee valtion API:n kautta, palaa tunnisteen ja QR-koodin kanssa ja etenee sitten tilatyönkulussa molemmilla osapuolilla.

Kenen kannattaa lukea tämä

Jos laskutat ja lähetät Minimaxista, BizniSoftista tai Pantheonista, toimittajasi tarjoaa jo eOtpremnica-tuen. Jos volyymisi on niin pieni, että lähetysluettelot voi kirjoittaa ministeriön maksuttomaan verkkoportaaliin tai sen mobiilisovellukseen, sekin toimii. Lue vastaanoton määräaikoja käsittelevä osio, kouluta lastauslaiturin henkilöstö, ja olet pääosin valmis.

Tämä artikkeli on toiselle ryhmälle: jakelijoille, valmistajille, tukkukaupoille ja kuljetusliikkeille, joiden lähetykset ja tavaroiden vastaanotto kulkevat oman toiminnanohjausjärjestelmän, räätälöidyn WMS:n, TMS:n tai B2B-tilauksia kirjaavan verkkokaupan taustajärjestelmän kautta. Kukaan ei toimita sinulle päivitystä. Integraatio on rakennettava itse.

Mitä jo sovelletaan ja mikä muuttuu

Sähköisiä lähetysluetteloita koskeva laki (Zakon o elektronskim otpremnicama) on vuodelta 2024, ja sitä on sen jälkeen muutettu kahdesti. Uusin muutoslaki, joka julkaistiin Službeni glasnikissa 80/2026 31. elokuuta 2026, säilytti lokakuun 2027 päivämäärän. Ministeriön FAQ ja konsolidoitu teksti kuvaavat vaiheet.

1. tammikuuta 2026 alkaen:

• Yksityiset yritykset lähettävät ja vastaanottavat eOtpremnican valmisteveronalaisista tavaroista: tupakasta, nikotiinituotteista, kahvista, alkoholijuomista ja öljytuotteista.
• Yksityiset yritykset lähettävät sen kaikista julkisen sektorin yksikölle toimitetuista tavaroista, ja julkisen sektorin yksiköt lähettävät sen omista siirroistaan.
• Kuljetusliikkeet esittävät lähetysluettelon näistä siirroista.

Tuotantojärjestelmä on ollut käytössä 30. joulukuuta 2025 alkaen. Demoympäristö, joka on tarkoitettu sisäisten ohjelmistojen testaamiseen, on ollut auki 5. maaliskuuta 2025 alkaen.

1. lokakuuta 2027 alkaen:

• Lähetysvelvoite silloin, kun sekä lähettäjä että vastaanottaja ovat yksityisen sektorin toimijoita eivätkä tavarat ole valmisteveronalaisia.
• Jokaisen yksityisen sektorin toimijan vastaanottovelvoite.
• Kuljetusliikkeiden velvoite esittää lähetysluettelo näistä siirroista.

Muutama yksityiskohta yllättää. Siirto kahden saman tehdasalueen varaston välillä vaatii sisäisen lähetysluettelon (XML:ssä tyyppi Int), jos tavarat vaihtavat osoitetta ja kulkevat yleisellä tiellä. Tuonti vaatii sisäisen lähetysluettelon paikasta, jossa sait määräysvallan tavaroihin, tai joissakin tapauksissa tullitoimipaikasta omaan varastoosi. Vienti vaatii yleensä lähetysluettelon siihen pisteeseen, jossa huolitsija ottaa tavarat haltuunsa. Fiskalisointilain alainen vähittäismyynti on vapautettu, joten verkkokauppa, joka myy kassakuittia vastaan, on näiden tilausten osalta soveltamisalan ulkopuolella. Sen tukkupuoli ei ole.

Elokuun muutos sanoo myös, että valvojat eivät 1. tammikuuta 2027 asti ota huomioon lähetettyjen lähetysluetteloiden ja vastaanottoilmoitusten tietovirheitä. Se auttaa valmisteveronalaisten tavaroiden ja julkisen sektorin lähettäjiä. Lokakuulle 2027 se ei tee mitään.

Voiko päivämäärä siirtyä? Lakia on muutettu kahdesti alle kahdessa vuodessa, joten uudet muutokset ovat mahdollisia. Mutta juuri hyväksytty muutos säilytti päivämäärän. Suunnittele sen mukaan.

Määräajat ovat vastaanottovaiheessa

Lähettäminen on helpompi puolisko. Konsolidoitu laki asettaa tiukat määräajat vastaanottavalle puolelle.

1. Ennen kuin tavarat liikkuvat, lähettäjä lähettää lähetysluettelon. Kunnes vastaanottaja vahvistaa fyysisen vastaanoton, lähettäjä voi perua sen syy mainiten.
2. Fyysinen vastaanotto on vahvistettava sinä päivänä, jona tavarat otetaan vastaan, tai viimeistään kolmen työpäivän kuluttua vastaanoton alkamisesta.
3. Kahdeksan päivän kuluessa tästä vahvistuksesta vastaanottaja hyväksyy tai hylkää toimituksen kokonaan tai osittain lähettämällä ePrijemnican (sähköisen vastaanottoilmoituksen).
4. Yksityisen sektorin vastaanottajan, joka ei lähetä mitään kahdeksassa päivässä, katsotaan hylänneen toimituksen kokonaan. Julkisen sektorin vastaanottajalla tilanne on päinvastainen: hiljaisuus tarkoittaa hyväksyntää.
5. Osittaisessa hyväksynnässä lähettäjällä on 30 päivää vastaanottoilmoituksen saapumisesta hyväksyä erot. Muussa tapauksessa sen katsotaan hylänneen vastaanottoilmoituksen kokonaan.
6. Lähetysluettelo, jonka fyysistä vastaanottoa ei ole vahvistettu, lakkaa olemasta voimassa 30 päivää siirron alkamisesta.

Kun molemmat osapuolet ovat yhtä mieltä, asiakirjat saavuttavat tilan Usaglašeno (API:ssa Fulfilled), eikä mitään voi sen jälkeen muuttaa.

Fyysisen vastaanoton määräajan laiminlyönti on lueteltu rikkomus: yritykselle 200 000 dinaarista 2 000 000 dinaariin ja vastuuhenkilölle 50 000 dinaarista 150 000 dinaariin. Sama haarukka koskee lähetysluettelon lähettämättä jättämistä kokonaan.

Käytännön johtopäätös: fyysinen vastaanotto kuuluu lastauslaiturille, WMS:ään, sille hetkelle, kun tavarat kirjataan sisään. Jos se odottaa jotakuta, joka täsmäyttää kuun lopussa, määräaika on jo umpeutunut.

Mitä ministeriön API:a vasten rakennetaan

Tekninen dokumentaatio kuvaa REST API:n, joka vaihtaa UBL 2.1 -XML:ää. eOtpremnica on DespatchAdvice, ePrijemnica ReceiptAdvice, ja jokainen muu vaihe (peruutus, kuljetuksen alku, ajoneuvon vaihto, fyysinen vastaanotto, vastaanottoilmoituksen hyväksyminen tai hylkääminen) on ApplicationResponse numerokoodilla. Ministeriö järjesti 5. joulukuuta 2025 työpajan IT-alalle asiakirjatyypeistä, XML-laajennuksista, lähettämisestä ja webhookeista.

Lähettäminen

Jokainen asiakirja menee yhteen päätepisteeseen, POST /public/documents/requests, omalla yksilöllisellä pyyntötunnisteella. Käsittely on asynkronista. Tulos saapuu myöhemmin webhookin kautta tai kyselemällä päätepistettä /public/documents/requests/changes, joka ilmoittaa jokaisen pyynnön tilaksi odottava, onnistunut tai epäonnistunut ja liittää mukaan liiketoimintavirheet.

Toiminnanohjausjärjestelmä tarvitsee siis lähtevien jonon (outbox): tietueen jokaista lähetysluetteloa kohden, tilakoneen ja uudelleenyrityspolun, joka ei luo kaksoiskappaleita. Järjestelmä hylkää asiakirjanumeron, joka on jo olemassa yrityksellesi, mikä auttaa, mutta vain jos numerointi pysyy vakaana uudelleenyrityksissä.

Ministeriön API-FAQ:n virheluettelo näyttää, missä datatyö on:

• Antopäivän on oltava tämä päivä Serbian aikaa. Ei takautuvia päivämääriä eikä eilisten lähetysluetteloiden pitämistä jonossa yön yli.
• Jokainen osoite (oma, asiakkaan, kuljetusliikkeen, lastaus- ja purkupaikat) tarvitsee kadun ja kaupungin.
• Omassa kuljetuksessa, kuljetusliikkeen kuljetuksessa tai vastaanottajan kuljetuksessa kuljetusliike, ajoneuvon rekisterinumero ja kuljetusväline ovat pakollisia. Oma kuljetus edellyttää lisäksi kuljetusliikestatuksen kytkemistä päälle yrityksellesi.
• Määrillä on mittayksikkökoodi. Rivit numeroidaan ykkösestä alkaen. Jos GTIN annetaan, se sisältää vain numeroita.
• Vastaanottajan on oltava rekisteröitynyt ja aktiivinen. GET /public/companies/status tarkistaa PIB:n ennen lähettämistä.

Perustiedot ovat yleensä suurempi työ kuin XML. Validointipäätepisteellä voi testata asiakirjoja ennen lähettämistä, ja se kuuluu testisarjaasi.

Vastaanotto ja varasto

Saapuvat lähetysluettelot tulevat päätepisteen /public/documents/customers/changes kautta, jota kysellään päivämäärittäin 1 000 muutosta sivulla, tai webhookilla. Webhook-tilaus on päiväkohtainen: kutsu /public/webhook-notifications/subscribe kattaa seuraavan päivän. Aja se ajastettuna työnä, hälytä, kun se epäonnistuu, ja pidä noutopäätepiste öisenä täsmäytyksenä, jotta väliin jäänyt ilmoitus ei muutu väliin jääneeksi määräajaksi.

Jokaisen saapuvan lähetysluettelon pitäisi päätyä WMS:ään odotettuna vastaanottona, ja toimittajan nimikekoodit on kohdistettava omiisi. Kun tavarat kirjataan sisään, WMS lähettää fyysisen vastaanoton toiminnon. Määrä- ja laatutarkastusten jälkeen se lähettää ePrijemnican: riveittäin saapunut määrä sekä hylätty ja samalla ajoneuvolla palautettu määrä. Järjestelmä ei hyväksy hylättyä määrää, joka on suurempi kuin vastaanotettu.

Ministeriön oma roolimalli on hyödyllinen pohja. Sen varastorooli voi listata ja ladata saapuvia lähetysluetteloita ja vahvistaa fyysisen vastaanoton. Se on oikea muoto myös WMS-käyttöoikeudelle.

Lähettäjänä saat myös toisen osapuolen vastaanottoilmoituksen, ja sinun on hyväksyttävä tai hylättävä se. Seuraa 30 päivän sopimisikkunaa toiminnanohjausjärjestelmässä, älä jonkun sähköpostilaatikossa.

Linkitys SEF-verkkolaskuihin

Lähetysluettelon linkittäminen SEF:n verkkolaskuun on vapaaehtoista. Kun lähetysluettelo on lähetetty ja sen todellinen lähtöaika on ohitettu, SEF voi linkittää yhden tai useamman lähetysluettelon yhteen verkkolaskuun, eikä laskun tarvitse odottaa vastaanottotyönkulun valmistumista. Jos tilauksen, toimituksen ja laskun kolmisuuntainen täsmäytys toimii jo toiminnanohjausjärjestelmässä, linkki antaa asiakkaasi ostoreskontralle saman näytön. Verkkolaskuintegraatiotyömme kattaa SEF-puolen.

Kuljettajat ja tie

Kuljettaja voi näyttää lähetysluettelon ministeriön kuljettajasovelluksesta. Jos kuljetusliike ei ole järjestelmän käyttäjä, lähettäjä tulostaa lähetysluettelon, kuljettaja allekirjoittaa sen ennen lähtöä ja lähettäjä lataa allekirjoitetun kopion ennen kuin tavarat liikkuvat. Elokuun muutoksen jälkeen kuljetusliike, joka ei voi käyttää järjestelmää, voi sen sijaan näyttää QR-koodin, joka luotiin lähetysluetteloa lähetettäessä; lähettäjä liittää tällöin tulostettavan näkymän ennen lähtöä. TMS:n on tuotettava se näistä, jota kuljetusliikkeesi käyttävät, ja API palauttaa QR-koodin myös erikseen etikettejä varten.

Katkojen varalle on paperinen varamenettely: kolme tulostettua kopiota, joissa on Serbian keskuspankin Topčiderin rahapajan turvahologrammitarrat ja jotka kirjataan järjestelmään seuraavaan työpäivään mennessä. Osta tarrat ennen kuin tarvitset niitä.

Miten API-avain toimii

Laillinen edustaja rekisteröi yrityksen kirjautumalla valtion eID-portaalin kautta. Avaimet luodaan sitten verkkokäyttöliittymässä (Settings, API settings, Admin module, API keys). Demo ja tuotanto ovat erillisiä ympäristöjä, joten varaudu avaimiin molemmissa.

Avain yksilöi yrityksen. API-FAQ on suorasanainen: asiakirjoja ei voi lähettää toisen yrityksen puolesta, ja järjestelmä tunnistaa yrityksen sen esittämän API-avaimen perusteella. Käytännössä:

• Konserni, jossa on viisi oikeushenkilöä, tarvitsee viisi avainta ja reitittimen, joka valitsee oikean PIB:n perusteella.
• Jaettu palvelukeskus tai ohjelmistotalo ei voi lähettää jokaisen asiakkaansa asiakirjoja yhdellä avaimella.
• Avaimet kuuluvat salaisuuksien hallintaan, jolla on omistaja ja kierrätysmenettely, eivät konfiguraatiotiedostoon toiminnanohjausjärjestelmän palvelimelle.

12 kuukauden suunnitelma

On lokakuu 2026. Taaksepäin 1. lokakuuta 2027 alkaen:

Lokakuusta joulukuuhun 2026: kartoitus ja pääsy.

• Listaa jokainen siirtotyyppi: myynnit, palautukset, varastojen väliset siirrot, tuonti, vienti, oma kalusto, ulkopuoliset kuljetusliikkeet, asiakkaan nouto.
• Rekisteröi yritys tuotantoon ja hanki demon API-avaimet.
• Aloita perustietojen siivous: osoitteet, kumppanien PIB- ja rekisterinumerot, kuljetusliikkeet, ajoneuvot, mittayksiköt.

Tammikuusta maaliskuuhun 2027: lähetyspolku.

• DespatchAdvice muodostetaan lähetyksistä, mukana lähtevien jono, asynkroninen tilaseuranta ja virheenkäsittely.
• Päivittäinen webhook-tilausajo sekä noutoon perustuva täsmäytys.
• Validaattori ajetaan CI:ssä demoympäristöä vasten.

Huhtikuusta kesäkuuhun 2027: vastaanotto ja vastaanottoilmoitus.

• Saapuvat lähetysluettelot WMS:ään odotettuina vastaanottoina.
• Fyysinen vastaanotto lastauslaiturilla, ePrijemnica tarkastusten jälkeen, hälytykset kolmen päivän määräajan toisena päivänä ja kahdeksan päivän määräajan kuudentena päivänä.
• Lähettäjänä saamiesi vastaanottoilmoitusten hyväksynnän ja hylkäyksen käsittely. SEF-linkitys, jos haluat sen.

Heinäkuusta syyskuuhun 2027: tie ja pilotti.

• Kuljetusliikkeiden työnkulku, tulostus ja QR, offline-menettely tarroineen paikan päällä.
• Aja oikeita lähetysluetteloita tuotannossa rekisteröityneiden kumppanien kanssa; yksityiset yritykset voivat jo käyttää järjestelmää vapaaehtoisesti.
• Kouluta varastohenkilöstö ja kuljettajat. Jäädytä muutokset syyskuussa.

Kaksitoista kuukautta on väljä aika yhdelle oikeushenkilölle, jonka data on siistiä. Se on tiukka konsernille, jossa on useita oikeushenkilöitä, useita varastoja ja perustietoja, joihin kukaan ei ole koskenut vuosiin.

Mistä saat apua

C9 Groupilla on toimisto Novi Sadissa, joten Serbian säännöt ovat meille kotikenttää. Rakennamme itse integraation: UBL-muodostuksen, API-asiakkaan, webhookien käsittelyn ja varaston vastaanottotyönkulun nykyiseen toiminnanohjausjärjestelmääsi, WMS:ään tai verkkokaupan taustajärjestelmään. Katso toiminnanohjausjärjestelmän modernisointipalvelumme tai kirjoita osoitteeseen office@c9group.dev.