еОтпремнице – нова верзија 0.5.0

10.11.2025.ВестиПривредни субјекти / делатности

На интернет страни еОтпремница објављен је следећи документ:

Подсећамо да је за сада Систем електронских отпремница доступан само на ДЕМО окружењу (од марта 2025. године – видети овде).

У наставку је дат преглед свих функционалности и промена које су део нове верзије 0.5.0 еОтпремница:

1. Додата шифра објекта

Опис: На документима еОтпремница и еПријемница, у оквиру Адресе отпреме и Адресе одредишта, омогућен је унос Шифре објекта.

Коришћење шифре објекта (object code-а) у API одговорима и у догађајима пословних промена (Business Changes):

Шифра објекта за адресу отпреме и адресу испоруке сада је видљива у свим релевантним API одговорима и у догађајима пословних промена. На овај начин се омогућава јединствена идентификација објеката (нпр. складишта или локација) директно из података докумената и event pavioad-а.

Технички детаљи измене:

  • Поље objectCode додато је у API одговоре свуда где се приказују подаци о адреси отпреме или адреси испоруке (нпр. get despatch advice by id, get receipt advice by id).
  • Поље је опционо и не мора бити присутно уколико шифра објекта није унета приликом креирања документа.
  • Исти податак сада је доступан и у догађајима пословних промена за оба типа документа:
    • DespatchAdviceCreated -> поља DeliveryAddressObjectCode, DespatchAddressObjectCode
    • ReceiptAdviceCreated -> поља DeliveryAddressObjectCode, DespatchAddressObjectCode

UBL мапирање:

Пример у Business Changes догађајима:

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. Униформисани називи докумената који се преузимају преко апликативног интерфејса

Функционалност: Уједначавање формата назива фајлова који се преузимају преко Public API и корисничког интерфејса

Опис измене:

Фајлови преузети преко корисничког интерфејса имају стандардизован формат који садржи тип документа и јединствени идентификатор.

Овом изменом, именовање фајлова у Public API биће усклађено са форматом који се користи у корисничком интерфејсу.

Након измене:

Називи фајлова који се преузимају преко Public API биће у истом формату као код корисничког интерфејса, односно:

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

Погођени Public API ендпоинти:

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
Повезани текстови

Поделите: