Skip to main content

Робота з документами

Для роботи з методами користувач повинен бути авторизованим.

Створити (розрахувати) номер «Замовлення» (ORDER)

GET /api/oas/doc_counter
REQUEST

URL

https://edo-v2.edin.ua

Метод запиту

GET

URL запиту

/api/oas/doc_counter

URL параметри

gln (обов’язково) String - GLN Покупця (Дистрибʼютора)

Headers

 

Authorization

SID - токен, отриманий при авторизації

Content-Type

application/json

RESPONSE

В тілі відповіді передається розрахований номер «Замовлення» (ORDER), наприклад: 1000253.

Створити документ «Замовлення» (ORDER) за «Прайс-листом»

POST /api/distribex/doc/order

При формуванні «Замовлення» необхідно враховувати обмеження, визначені в «Прайс-листі».
Методи API для роботи з обмеженнями.

REQUEST

URL

https://edo-v2.edin.ua

Метод запиту

POST

URL запиту

/api/distribex/doc/order

URL параметри

gln (обов’язково) String - GLN Покупця (Дистрибʼютора) АБО guid (обов’язково) String - унікальний ідентифікатор організації Покупця (Дистрибʼютора) на платформі

producer_gln (обов’язково) String - GLN Продавця (Виробника)

number (обов’язково) String - номер документа ORDER

doc_date (опціонально) String - дата документа («YYYY-MM-DD»). При відсутності параметра автоматично проставляється поточна дата на момент формування запиту.

delivery_date (опціонально) String - дата доставки («YYYY-MM-DD»). При відсутності параметра автоматично проставляється поточна дата на момент формування запиту.

delivery_gln (обов’язково) String - GLN точки доставки

delivery_terms (обов’язково) String - код умови відвантаження:

  • 1 - Самовивіз;

  • 2 - Доставка транспортом Продавця (Виробника).

payment_method (опціонально) String - код способу оплати:

  • 1 - Готівковий розрахунок

  • 2 - Безготівковий розрахунок

doc_type (опціонально) String - підтип документа «Замовлення» (ORDER.DOCTYPE); можливі варіанти:

  • O - Оригінал замовлення (за замовчуванням)

  • PO - Попереднє замовлення

  • R - Заміна

  • D - Видалення

Headers

 

Authorization

SID - токен, отриманий при авторизації

Content-Type

application/json

REQUEST

 

JSON Body

В тілі запиту методу передається масив об’єктів, що містить інформацію про кількість відповідних товарних позицій для замовлення або дані для додавання контактної особи до замовлення.

RESPONSE

В тілі відповіді передається об’єкт DistribexOrderResult з деталями результату операції створення документа «Замовлення» (ORDER).

 

Створити копію документа «Замовлення» (ORDER) відповідно до актуального «Прайс-листа»

POST /api/distribex/order/copy

При формуванні «Замовлення» необхідно враховувати обмеження, визначені в «Прайс-листі».
Методи API для роботи з обмеженнями.

REQUEST

URL

https://edo-v2.edin.ua

Метод запиту

POST

URL запиту

/api/distribex/order/copy?

URL параметри

gln (обов’язково) String - GLN Покупця (Дистрибʼютора) АБО guid (обов’язково) String - унікальний ідентифікатор організації Покупця (Дистрибʼютора) на платформі;

doc_uuid (обов’язково) UUID - ідентифікатор документа (Замовлення), який потрібно повторити/скопіювати;

actualize (обов’язково) boolean = true - актуалізація нового повтореного/скопійованого Замовлення відносно Замовлення-основи на підставі актуального Прайс-листа Продавця (Виробника).

Актуалізація означає врахування всіх змін згідно з актуальним Прайс-листом: оновлених цін, наявності товарів та інших відмінностей у документі.

Headers

 

Authorization

SID - токен, отриманий при авторизації

Content-Type

application/json

RESPONSE

В тілі відповіді передається об’єкт DistribexOrderResult з деталями результату операції створення документа «Замовлення» (ORDER).

Отримання контенту документа

GET /api/eds/doc/body

За допомогою методу api/eds/doc/body можливо швидко отримати контент документа без підписів/печаток, а також тіло підпису, тіло печатки. У запиті повинен бути присутнім ідентифікатор авторизованого користувача (GLN), ID документа (doc_uuid), тип тіла документа.

Метод api/eds/doc/body повертає контент документа без підписів і печаток, а також тіла підпису та печатки. У запиті передаються GLN користувача, doc_uuid та тип тіла документа.

 

REQUEST