eOtpremnice – nova verzija 0.5.0

10.11.2025.VestiPrivredni subjekti / delatnosti

Na internet strani eOtpremnica objavljen je sledeći dokument:

Podsećamo da je za sada Sistem elektronskih otpremnica dostupan samo na DEMO okruženju (od marta 2025. godine – videti ovde).

U nastavku je dat pregled svih funkcionalnosti i promena koje su deo nove verzije 0.5.0 eOtpremnica:

1. Dodata šifra objekta

Opis: Na dokumentima eOtpremnica i ePrijemnica, u okviru Adrese otpreme i Adrese odredišta, omogućen je unos Šifre objekta.

Korišćenje šifre objekta (object code-a) u API odgovorima i u događajima poslovnih promena (Business Changes):

Šifra objekta za adresu otpreme i adresu isporuke sada je vidljiva u svim relevantnim API odgovorima i u događajima poslovnih promena. Na ovaj način se omogućava jedinstvena identifikacija objekata (npr. skladišta ili lokacija) direktno iz podataka dokumenata i event pavioad-a.

Tehnički detalji izmene:

  • Polje objectCode dodato je u API odgovore svuda gde se prikazuju podaci o adresi otpreme ili adresi isporuke (npr. get despatch advice by id, get receipt advice by id).
  • Polje je opciono i ne mora biti prisutno ukoliko šifra objekta nije uneta prilikom kreiranja dokumenta.
  • Isti podatak sada je dostupan i u događajima poslovnih promena za oba tipa dokumenta:
    • DespatchAdviceCreated -> polja DeliveryAddressObjectCode, DespatchAddressObjectCode
    • ReceiptAdviceCreated -> polja DeliveryAddressObjectCode, DespatchAddressObjectCode

UBL mapiranje:

Primer u Business Changes događajima:

DespatchAdviceCreated

„Data“: {
„DespatchAdvice“: {
„Id“: „b3fa00fb-f586-4730-9ef4-e815010fe8df“,
„DocumentNumber“: „BZ-20250626-04“,
„Status“: „Sent“,
„DeliveryAddressObjectCode“: „12345“,
„DespatchAddressObjectCode“: „123456“
}
}

ReceiptAdviceCreated

„Data“: {
„ReceiptAdvice“: {
„Id“: “ 1eb64816- 136b-4f53-8e3b-f61c141d6183″,
„DocumentNumber“: „BZ-20250626-06-01“,
„Status“: „Received“,
„DeliveryAddressObjectCode“: „12345“,
„DespatchAddressObjectCode“: „123456“
},
„DespatchAdvice“: {
„Id“: „5df2eaf4-4061-44a2-bc22-00e8426f03a1“,
„DocumentNumber“: „0310202501006“
}
}

2. Uniformisani nazivi dokumenata koji se preuzimaju preko aplikativnog interfejsa

Funkcionalnost: Ujednačavanje formata naziva fajlova koji se preuzimaju preko Public API i korisničkog interfejsa

Opis izmene:

Fajlovi preuzeti preko korisničkog interfejsa imaju standardizovan format koji sadrži tip dokumenta i jedinstveni identifikator.

Ovom izmenom, imenovanje fajlova u Public API biće usklađeno sa formatom koji se koristi u korisničkom interfejsu.

Nakon izmene:

Nazivi fajlova koji se preuzimaju preko Public API biće u istom formatu kao kod korisničkog interfejsa, odnosno:

  • {documentId}.xml
  • {documentId}.pdf
  • {documentId}_signature.xml

Pogođeni Public API endpointi:

Carrier:

  • GET /public/documents/carriers/despatch-advices/{id}/xml/download
  • GET /public/documents/carriers/application-responses/{id}/xml/download
  • GET /public/documents/carriers/despatch-advices/{id}/pdf/download

Customer:

  • GET /public/documents/customers/despatch-advices/{id}/xml/download
  • GET /public/documents/customers/despatch-advices/{id}/signature/download
  • GET /public/documents/customers/receipt-advices/{id}/xml/download
  • GET /public/documents/customers/receipt-advices/{id}/signature/download
  • GET /public/documents/customers/application-responses/{id}/xml/download
  • GET /public/documents/customers/despatch-advices/{id}/pdf/download
  • GET /public/documents/customers/receipt-advices/{id}/pdf/download

Supplier:

  • GET /public/documents/suppliers/despatch-advices/{id}/xml/download
  • GET /public/documents/suppliers/receipt-advices/{id}/xml/download
  • GET /public/documents/suppliers/ despatch -advices/{id}/signature/download
  • GET /public/documents/suppliers/receipt-advices/{id}/signature/download
  • GET /public/documents/suppliers/application-responses/{id}/xml/download
  • GET /public/documents/suppliers/despatch-advices/{id}/pdf/download
  • GET /public/documents/suppliers/receipt-advices/{id}/pdf/download
Povezani tekstovi

Podelite: