Робота з документами
Для роботи з методами користувач повинен бути авторизованим.
Створити (розрахувати) номер «Замовлення» (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 - код умови відвантаження:
payment_method (опціонально) String - код способу оплати:
doc_type (опціонально) String - підтип документа «Замовлення» (ORDER.DOCTYPE); можливі варіанти:
|
|
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 та тип тіла документа.