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

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

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

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

1. Веза еФактуре и еПријемнице

Опис измене

Oмогућено је креирати везу између еФактуре на СЕФ-у и еПријемнице, на исти начин као и за еОтпремницу.

Детаљи измене

  • Приликом креирања еФактуре на СЕФ-у, корисник поред повезивања еФактуре и еОтпремнице има могућност да повеже и еПријемницу под следећим условима:
    • Статус еОтпремнице је Усаглашено, тј. постоји еПријемница која је у статусу Прихваћена од стране пошиљаоца робе
    • еПријемница није већ повезана са другом еФактуром,
    • Уколико дође до сторнирања еФактуре, раскида се и веза са еПријемницом која постаје доступна за ново повезивање.
  • Корисник и даље има могућност повезивања са еОтпремницом на исти начин као до сада.

Очекивани резултат:

  • еПријемница је електронски документ који се креира и прихвата на самом крају процеса, због чега постаје релевантнији као основ за фактурисање, јер представља усаглашено стање између пошиљаоца и примаоца робе.

2. API Претрага докумената/захтева/промена по requestID параметру

Опис измене

Унапређена је функционалност прегледа докумената, захтева и измена тако што је омогућено филтрирање по идентификатору захтева (requestId).

Ова измена омогућава корисницима и интеграционим системима брже и прецизније проналажење конкретних захтева у систему.

Детаљи измене

1) Нови параметар за филтрирање

  • Ендпоинти за преглед documents / requests / changes сада прихватају опциони query параметар requestId.
  • Параметар се користи искључиво за филтрирање резултата.

2) Правила понашања

  • requestId је опциони параметар:
    • ако је параметар прослеђен → враћају се само резултати који одговарају датом requestId
    • ако параметар није прослеђен → враћа се комплетна листа резултата (постојеће понашање)

Обухваћени ендпоинти

  • /documents/carriers/changes
  • /documents/customers/changes
  • /documents/requests/changes
  • /documents/suppliers/changes

Очекивани резултат:

  • Корисници могу ефикасно да филтрирају и пронађу конкретне захтеве и измене на основу requestId.
  • Очувано је постојеће понашање ендпоинта када параметар није прослеђен.
  • Обезбеђена је додатна сигурност и стабилност система кроз контролисану валидацију улазних параметара.

3. PDF приказ непланираног претовара

Опис измене

У случају непланираног претовара, могуће је на PDF приказу еОтпремнице, поред свих података са еОтпремнице, приказати и податке који се тичу претовара и свих, унетих, фаза вожњи.

Детаљи измене

  • Приликом преузимања PDF еОтпремнице, у случају да постоји један или више претовара у току вожње, систем омогућава преглед свих података који су релевантни за све тренутке процеса:
    • Приказ података иницијалне еОтпремнице
    • Приказ свих непланираних претовара (сваки непланирани претовар се приказује на новој страни PDF документа)

Очекивани резултат:

  • У случају непланираног претовара, корисник има могућност прегледа свих релевантних података, тј. има увид у податке оригиналне еОтпремнице, као и увид у све могуће измене плана транспорта (податке непланираних претовара).
  • Портал приказује само ажурно стање, а уколико је дошло до непланираног претовара и то је могуће видети кроз историју промена у систему. Са овом изменом, сви релевантни подаци ће бити приказани на PDF документу.

4. Промена возача и возила пре почетка вожње

Опис измене

Уведена је нова функционалност која омогућава пошиљаоцу робе да изврши измену возила и возача на већ регистрованој еОтпремници, пре почетка транспорта.

Ова измена омогућава да се транспорт коректно реализује у случајевима када првобитно планирано возило или возач више нису доступни, без утицаја на статус пошиљке.

Детаљи измене

  • Пошиљалац може изменити возило и возача на еОтпремници која је већ регистрована у Централном регистру, пре почетка транспорта и пре потврде испоруке.
  • Измена се покреће из детаљног приказа излазне еОтпремнице, тј. кликом на дугме Промена возила

  • Уносе се нови подаци о:
    • возилу (регистрациона ознака – обавезно),
    • возачу (опционо: име, презиме, имејл и број возачке дозволе).

  • Статус пошиљке остаје непромењен.
  • Нови подаци у потпуности замењују претходне и примењују се на иницијалну фазу транспорта, чак и ако пошиљка има више фаза. 
  • Измена се региструје у Централном регистру путем UBL Application Response документа са ResponseCode = 8 (Change of Vehicle).
  • Након успешне валидације, корисник добија обавештење о успешној измени; у случају грешке, корисник се обавештава о неуспешној обради.

Очекивани резултат:

  • Пошиљалац може благовремено да измени податке о возилу и возачу без поништавања или поновног креирања еОтпремнице.
  • Обезбеђена је тачност података о транспорту пре почетка вожње.
  • Све измене су званично регистроване у Централном регистру и прате важећа UBL правила.
  • Очуван је интегритет статуса и ток обраде пошиљке.

5. Централизација системских подешавања и увођење подешавања комуникационих канала

Опис измене

Сва централизована подешавања платформе премештена су у нови Админ модул. Иако су подешавања логички издвојена у посебан модул, корисницима су и даље доступна на истом месту као и раније, при чему систем у позадини аутоматски врши редирекцију на Админ модул.

Додатно, уведена је нова функционалност за подешавање комуникационих канала, којом корисници могу дефинисати начин пријема системских обавештења.

Детаљи измене

  • Следећа подешавања су измештена из локалних подешавања еОтпремнице у централнизовани Админ модул:
    • Мој налог,
    • Детаљи компаније,
    • Корисници,
    • API подешавања.
  • У оквиру локалних подешавања остају:
    • Складишта,
    • Канали комуникације,
    • Подешавање превозника.
  • Уведена је могућност конфигурације Канала комуникације, где корисник може да одабере да ли жели и на који начин да прима обавештења:
    • Искључене нотификације,
    • Webhook (уз унос валидне URL адресе),
    • Имејл нотификације (уз унос валидне имејл адресе).

  • Подешавања превозника су издвојена као посебна картица, са одговараућим описом да се активирање врши само за систем еОтпремнице.

Очекивани резултат:

  • Системска подешавања су јасно централизована и управљана кроз Админ модул.
  • Корисници задржавају исти начин приступа подешавањима, без промене корисничког искуства.
  • Омогућена је флексибилна и транспарентна конфигурација начина пријема нотификација.

6. Имејл обавештења

Опис измене

Уведен је нови сервис за слање имејл нотификација корисницима, који омогућава информисање о променама у вези са пошиљкама.

Сервис подржава слање обавештења у реалном времену, као и слање дневних збирних (summary) извештаја, у складу са подешавањима компаније.

Детаљи измене

  • Систем подржава две врсте имејл нотификација:
    • Тренутне нотификације – шаљу се аутоматски као реакција на пословне догађаје:
      • Заплене,
      • Сторнирања;
    • Дневни збирни извештаји – једном дневно се шаље обједињен преглед активности пошиљки за претходни дан.
  • Слање нотификација је условљено подешавањима компаније:
    • компанија може да укључи или искључи пријем имејл нотификација,
    • могуће је дефинисати једну имејл адресу за пријем обавештења.
  • Дневни збирни извештај садржи агрегиране податке о пошиљкама за одређени дан и креира се појединачно за сваку компанију.

Потребно је да корисник одабере опцију да прима обавештења путем имејл нотификације и да унесе валидну имејл адресу.

Очекивани резултат:

  • Корисници добијају благовремене информације о променама у вези са пошиљкама путем имејла.
  • Компаније имају контролу над тим да ли и на које адресе се шаљу нотификације.
  • Омогућен је јасан преглед дневних активности пошиљки кроз збирне извештаје.
  • Побољшана је информисаност корисника без потребе за сталним приступом систему.

Поделите: