eOtpremnica w Serbii: podłączenie ERP, WMS i TMS do 1 października 2027

Od 1 października 2027 każde przemieszczenie towarów między dwiema prywatnymi firmami zarejestrowanymi do VAT w Serbii wymaga elektronicznego dowodu dostawy, czyli eOtpremnicy, wysłanej przez system Ministerstwa Finansów, zanim towar wyjedzie. Firma, która go przyjmuje, musi w ciągu kilku dni potwierdzić odbiór w tym samym systemie, a przewoźnik musi umieć okazać dokument podczas kontroli.

Dotyczy to dostaw sprzedażowych, zwrotów i przesunięć między własnymi magazynami. Dowód dostawy przestaje być formularzem drukowanym przez ERP. Staje się plikiem UBL, który przechodzi przez państwowe API, wraca z identyfikatorem i kodem QR, a potem przechodzi przez obieg statusów po obu stronach.

Kto powinien to przeczytać

Jeśli fakturujesz i wysyłasz towar z Minimax, BizniSoft albo Pantheon, producent już dostarcza obsługę eOtpremnicy. Jeśli wolumen jest na tyle mały, że dokumenty można wpisywać w bezpłatnym portalu internetowym ministerstwa albo w jego aplikacji mobilnej, to też działa. Przeczytaj część o terminach odbioru, przeszkol ludzi przy rampie i w zasadzie masz to z głowy.

Ten artykuł jest dla drugiej grupy: dystrybutorów, producentów, hurtowni i przewoźników, u których wydanie i przyjęcie towaru przechodzi przez własny ERP, dostosowany WMS, TMS albo zaplecze sklepu internetowego, które księguje zamówienia B2B. Nikt nie dostarczy Ci aktualizacji. Integrację trzeba zbudować.

Co już obowiązuje i co się zmienia

Ustawa o elektronicznych dowodach dostawy (Zakon o elektronskim otpremnicama) pochodzi z 2024 i od tego czasu była nowelizowana dwa razy. Najnowsza ustawa zmieniająca, opublikowana w Službeni glasnik 80/2026 31 sierpnia 2026, utrzymała datę październikową 2027. Etapy opisują FAQ ministerstwa i tekst jednolity.

Od 1 stycznia 2026:

• Firmy prywatne wysyłają i odbierają eOtpremnicę dla wyrobów akcyzowych: tytoniu, wyrobów nikotynowych, kawy, napojów alkoholowych i produktów naftowych.
• Firmy prywatne wysyłają ją dla wszelkich towarów dostarczanych podmiotowi sektora publicznego, a podmioty sektora publicznego wysyłają ją dla własnych przemieszczeń.
• Przewoźnicy okazują dokument przy tych przemieszczeniach.

System produkcyjny działa od 30 grudnia 2025. Środowisko demonstracyjne, przeznaczone do testowania oprogramowania wewnętrznego, jest otwarte od 5 marca 2025.

Od 1 października 2027:

• Obowiązek wysyłania, gdy nadawca i odbiorca są podmiotami sektora prywatnego, a towary nie są wyrobami akcyzowymi.
• Obowiązek odbioru dla każdego podmiotu sektora prywatnego.
• Okazywanie dokumentu przez przewoźników przy tych przemieszczeniach.

Kilka szczegółów zaskakuje. Przesunięcie między dwoma magazynami na terenie tego samego zakładu wymaga dokumentu wewnętrznego (typ Int w XML), jeśli towar zmienia adres i korzysta z drogi publicznej. Import wymaga dokumentu wewnętrznego z miejsca, w którym uzyskano prawo do rozporządzania towarem, albo w niektórych przypadkach z urzędu celnego, do Twojego magazynu. Eksport zwykle wymaga dokumentu do miejsca, w którym towar przejmuje spedytor. Sprzedaż detaliczna objęta ustawą o fiskalizacji jest zwolniona, więc sklep internetowy sprzedający na paragony fiskalne jest w tych zamówieniach poza zakresem. Jego część hurtowa już nie.

Nowelizacja sierpniowa stanowi też, że do 1 stycznia 2027 organy nadzoru nie będą brać pod uwagę błędów w danych w wysłanych dokumentach i potwierdzeniach odbioru. To pomaga nadawcom wyrobów akcyzowych i dostawcom sektora publicznego. Dla października 2027 nie zmienia niczego.

Czy data może się przesunąć? Ustawę znowelizowano dwa razy w niecałe dwa lata, więc kolejne zmiany są możliwe. Ale nowelizacja, którą właśnie uchwalono, utrzymała datę. Planuj pod nią.

Terminy kryją się w kroku odbioru

Wysyłka to łatwiejsza połowa. Tekst jednolity ustawy umieszcza twarde terminy po stronie odbiorcy.

1. Zanim towar ruszy, nadawca wysyła dokument. Dopóki odbiorca nie potwierdzi fizycznego odbioru, nadawca może go anulować, podając przyczynę.
2. Fizyczny odbiór trzeba potwierdzić w dniu przejęcia towaru, najpóźniej trzy dni robocze po rozpoczęciu przyjęcia.
3. W ciągu ośmiu dni od tego potwierdzenia odbiorca przyjmuje albo odrzuca dostawę, w całości lub w części, wysyłając ePrijemnicę (elektroniczny dowód przyjęcia).
4. Odbiorca z sektora prywatnego, który w ciągu ośmiu dni nic nie wyśle, jest traktowany tak, jakby odrzucił całą dostawę. Dla odbiorcy z sektora publicznego jest odwrotnie: milczenie oznacza przyjęcie.
5. Przy częściowym przyjęciu nadawca ma 30 dni od otrzymania elektronicznego dowodu przyjęcia na zaakceptowanie różnic. W przeciwnym razie uznaje się, że odrzucił dowód przyjęcia w całości.
6. Dokument bez potwierdzenia fizycznego odbioru traci ważność 30 dni po rozpoczęciu przemieszczenia.

Gdy obie strony się zgodzą, dokumenty uzyskują status Usaglašeno (Fulfilled w API) i od tej chwili nic nie można już zmienić.

Niedotrzymanie terminu potwierdzenia fizycznego odbioru jest wymienionym w ustawie wykroczeniem: od 200 000 do 2 000 000 dinarów dla firmy i od 50 000 do 150 000 dinarów dla osoby odpowiedzialnej. Ten sam przedział dotyczy niewysłania dokumentu w ogóle.

Wniosek praktyczny: fizyczny odbiór należy do rampy, do WMS, do chwili przyjęcia towaru na stan. Jeśli czeka na kogoś, kto uzgadnia dokumenty na koniec miesiąca, termin już minął.

Co zbudować na API ministerstwa

Dokumentacja techniczna opisuje REST API wymieniające XML w UBL 2.1. eOtpremnica to DespatchAdvice, ePrijemnica to ReceiptAdvice, a każdy inny krok (anulowanie, rozpoczęcie transportu, zmiana pojazdu, fizyczny odbiór, przyjęcie albo odrzucenie dowodu przyjęcia) to ApplicationResponse z kodem liczbowym. Ministerstwo zorganizowało 5 grudnia 2025 warsztaty dla sektora IT o typach dokumentów, rozszerzeniach XML, przesyłaniu i webhookach.

Wysyłka

Każdy dokument trafia na jeden punkt końcowy, POST /public/documents/requests, z własnym, unikalnym identyfikatorem żądania. Przetwarzanie jest asynchroniczne. Wynik przychodzi później, przez webhook albo przez odpytywanie /public/documents/requests/changes, które zgłasza każde żądanie jako oczekujące, zakończone sukcesem albo nieudane, z dołączonymi błędami biznesowymi.

ERP potrzebuje więc skrzynki nadawczej: rekordu dla każdego dokumentu, maszyny stanów i ścieżki ponowień, która nie tworzy duplikatów. System odrzuca numer dokumentu, który już istnieje dla Twojej firmy, co pomaga, ale tylko wtedy, gdy numeracja pozostaje stabilna przy ponowieniach.

Lista błędów w FAQ ministerstwa dla użytkowników API pokazuje, gdzie leży praca na danych:

• Data wystawienia musi być dzisiejsza, według czasu serbskiego. Bez antydatowania i bez trzymania wczorajszych dokumentów w kolejce przez noc.
• Każdy adres (Twój, klienta, przewoźnika, miejsca załadunku i rozładunku) wymaga ulicy i miejscowości.
• Przy transporcie własnym, przewoźniku zewnętrznym albo transporcie odbiorcy obowiązkowe są przewoźnik, numer rejestracyjny pojazdu i środek transportu. Transport własny wymaga też włączenia statusu przewoźnika dla Twojej firmy.
• Ilości mają kod jednostki miary. Pozycje są numerowane od 1. GTIN, jeśli jest podany, składa się wyłącznie z cyfr.
• Odbiorca musi być zarejestrowany i aktywny. GET /public/companies/status sprawdza PIB przed wysłaniem.

Dane podstawowe to zwykle większa praca niż sam XML. Punkt końcowy walidatora pozwala testować dokumenty przed wysłaniem i powinien być częścią Twojego zestawu testów.

Odbiór i magazyn

Przychodzące dokumenty docierają przez /public/documents/customers/changes, odpytywane dla każdej daty po 1000 zmian na stronę, albo przez webhook. Subskrypcja webhooka obowiązuje na jeden dzień: wywołanie /public/webhook-notifications/subscribe obejmuje dzień następny. Uruchamiaj je jako zadanie harmonogramu, alarmuj przy niepowodzeniu i zachowaj punkt końcowy do pobierania jako nocne uzgadnianie, żeby pominięte powiadomienie nie zamieniło się w przekroczony termin.

Każdy przychodzący dokument powinien trafić do WMS jako oczekiwane przyjęcie, z kodami towarów dostawcy zmapowanymi na Twoje. Gdy towar zostaje przyjęty na stan, WMS wysyła akcję fizycznego odbioru. Po kontroli ilości i jakości wysyła ePrijemnicę: dla każdej pozycji ilość, która dotarła, i ilość odrzuconą i zwróconą tym samym pojazdem. System nie przyjmie ilości odrzuconej większej niż przyjęta.

Model ról samego ministerstwa to dobry wzorzec. Jego rola magazynowa może wyświetlać i pobierać przychodzące dokumenty oraz potwierdzać fizyczny odbiór. To właściwy kształt także dla uprawnień w WMS.

Jako nadawca również otrzymujesz dowód przyjęcia od drugiej strony i musisz go przyjąć albo odrzucić. Śledź 30-dniowe okno na uzgodnienie w ERP, a nie w czyjejś skrzynce pocztowej.

Powiązanie z e-fakturami w SEF

Powiązanie dowodu dostawy z e-fakturą w SEF jest opcjonalne. Gdy dokument został wysłany, a faktyczny czas wysyłki minął, SEF może powiązać jeden lub więcej dokumentów z jedną e-fakturą, a faktura nie musi czekać na zakończenie obiegu odbioru. Jeśli trójstronne uzgadnianie zamówienia, dostawy i faktury już działa w Twoim ERP, powiązanie daje działowi rozrachunków klienta te same dowody. Stronę SEF obejmuje nasza praca nad integracją e-fakturowania.

Przewoźnicy i droga

Kierowca może okazać dokument w aplikacji ministerstwa dla przewoźników. Jeśli przewoźnik nie jest użytkownikiem systemu, nadawca drukuje dokument, przewoźnik podpisuje go przed wyjazdem, a nadawca przesyła podpisaną kopię, zanim towar ruszy. Od nowelizacji sierpniowej przewoźnik, który nie może korzystać z systemu, może zamiast tego okazać kod QR wygenerowany przy wysłaniu dokumentu; nadawca dołącza wtedy wersję do druku przed wyjazdem. Twój TMS musi generować tę formę, z której korzystają Twoi przewoźnicy, a API zwraca sam kod QR do etykiet.

Na wypadek awarii istnieje procedura papierowa: trzy wydrukowane egzemplarze z naklejkami z hologramem zabezpieczającym z mennicy Topčider Narodowego Banku Serbii, wprowadzone do systemu do następnego dnia roboczego. Kup naklejki, zanim będą potrzebne.

Jak działa klucz API

Przedstawiciel prawny rejestruje firmę, logując się przez państwowy portal eID. Klucze tworzy się potem w interfejsie internetowym (Ustawienia, ustawienia API, moduł administracyjny, klucze API). Środowisko demonstracyjne i produkcyjne są osobne, więc zaplanuj klucze w obu.

Klucz identyfikuje firmę. FAQ API mówi wprost: nie można wysyłać dokumentów w imieniu innej firmy, a system rozpoznaje firmę po przedstawionym kluczu API. W praktyce:

• Grupa z pięcioma podmiotami prawnymi potrzebuje pięciu kluczy i routera, który wybiera właściwy według PIB.
• Centrum usług wspólnych albo software house nie może przepuszczać wszystkich klientów przez jeden klucz.
• Klucze należą do magazynu sekretów, z właścicielem i procedurą rotacji, a nie do pliku konfiguracyjnego na serwerze ERP.

Plan na 12 miesięcy

Jest październik 2026. Licząc wstecz od 1 października 2027:

Od października do grudnia 2026: inwentaryzacja i dostęp.

• Spisz każdy typ przemieszczenia: sprzedaż, zwroty, przesunięcia międzymagazynowe, import, eksport, własna flota, przewoźnicy zewnętrzni, odbiór osobisty przez klienta.
• Zarejestruj firmę w środowisku produkcyjnym i uzyskaj klucze API do środowiska demonstracyjnego.
• Zacznij porządkować dane podstawowe: adresy, numery PIB i numery rejestrowe partnerów, przewoźników, pojazdy, jednostki miary.

Od stycznia do marca 2027: ścieżka wysyłki.

• Generowanie DespatchAdvice z wysyłek, ze skrzynką nadawczą, asynchronicznym śledzeniem statusów i obsługą błędów.
• Codzienne zadanie subskrypcji webhooka plus uzgadnianie przez pobieranie.
• Walidator uruchamiany w CI na środowisku demonstracyjnym.

Od kwietnia do czerwca 2027: odbiór i przyjęcie.

• Przychodzące dokumenty w WMS jako oczekiwane przyjęcia.
• Fizyczny odbiór przy rampie, ePrijemnica po kontroli, alerty drugiego dnia z trzech i szóstego dnia z ośmiu.
• Obsługa przyjmowania i odrzucania dowodów przyjęcia, które dostajesz jako nadawca. Powiązanie z SEF, jeśli go chcesz.

Od lipca do września 2027: droga i pilotaż.

• Przepływ dla przewoźników, druk i QR, procedura awaryjna z naklejkami na miejscu.
• Prawdziwe dokumenty na produkcji z partnerami, którzy już się zarejestrowali; firmy prywatne mogą już dobrowolnie korzystać z systemu.
• Szkolenie pracowników magazynu i kierowców. Zamrożenie zmian we wrześniu.

Dwanaście miesięcy to wygodny zapas dla jednego podmiotu z czystymi danymi. Dla grupy z kilkoma podmiotami, kilkoma magazynami i danymi podstawowymi, których nikt nie ruszał od lat, to mało.

Gdzie szukać pomocy

C9 Group ma biuro w Nowym Sadzie, więc serbskie przepisy to dla nas teren domowy. Budujemy samą integrację: generowanie UBL, klienta API, obsługę webhooków i obieg przyjęcia magazynowego w Twoim istniejącym ERP, WMS albo zapleczu sklepu internetowego. Zobacz naszą usługę modernizacji ERP albo napisz na office@c9group.dev.