Робота з Замовленнями (Покупець (Дистрибʼютор))
Для роботи з методами користувач повинен бути авторизованим.
Зберегти (відредагувати) Замовлення за «Прайс-листом»
PUT /api/distribex/preorder
REQUEST
|
URL |
https://edo-v2.edin.ua |
|
Метод запиту |
PUT |
|
URL запиту |
/api/distribex/preorder |
|
URL параметри |
gln (обов’язково) String - GLN Покупця (Дистрибʼютора) producerId (обов’язково) String - ідентифікатор Продавця (Виробника) id (обов’язково) String - ідентифікатор Попереднього замовлення positions (обов’язково) String - позиції Попереднього замовлення doc_uuid (опціонально) UUID - ідентифікатор документа-підстави type_id (опціонально) int - ідентифікатор підтипу документа:
|
|
Headers |
|
|
Authorization |
SID - токен, отриманий при авторизації |
|
Content-Type |
application/json |
|
REQUEST |
|
|
JSON Body |
В тілі запиту методу передається масив об'єкта XDistribexPreorderPosition |
RESPONSE
В тілі відповіді передаються дані для збереження Замовлення по «Прайс-листу» (об’єкт XDistribexPreorder)
Отримати дані для формування Замовлення по «Прайс-листу»
GET /api/distribex/preorder
REQUEST
|
URL |
https://edo-v2.edin.ua |
|
Метод запиту |
GET |
|
URL запиту |
/api/distribex/preorder |
|
URL параметри |
gln (обов’язково) String - GLN Покупця (Дистрибʼютора) producerId (обов’язково) String - ідентифікатор Продавця (Виробника) type_id (опціонально) int - ідентифікатор підтипу документа:
|
|
Headers |
|
|
Authorization |
SID - токен, отриманий при авторизації |
|
Content-Type |
application/json |
RESPONSE
В тілі відповіді передаються дані для формування Замовлення по «Прайс-листу» (об’єкт XDistribexPreorder)
Зберегти Замовлення по «Прайс-листу»
POST /api/distribex/preorder
REQUEST
|
URL |
https://edo-v2.edin.ua |
|
Метод запиту |
POST |
|
URL запиту |
/api/distribex/preorder |
|
URL параметри |
gln (обов’язково) String - GLN Покупця (Дистрибʼютора) producerId (обов’язково) String - ідентифікатор Продавця (Виробника) positions (обов’язково /-) String - позиції Попереднього замовлення. Параметр відсутній при наявності load_excel параметра load_excel (обов’язково /-) boolean - load_excel=true при передачі значень через xls-файл. Параметр відсутній при наявності positions параметра doc_uuid (опціонально) UUID - ідентифікатор документа-підстави type_id (опціонально) int - ідентифікатор підтипу документа:
|
|
Headers |
|
|
Authorization |
SID - токен, отриманий при авторизації |
|
Content-Type |
application/json |
|
REQUEST |
|
|
JSON Body |
При передачі значень вручну (через positions параметр): в тілі запиту методу передається масив об’єктів XDistribexPreorderPosition з вказаною кількістю відповідних товарних позицій для Попереднього замовлення. При передачі значень через xls-файл (вказується параметр load_excel=true): в тілі запиту передається заповнений шаблон order_upload_ua.xls (вкладення ліворуч) |
RESPONSE
В тілі відповіді передаються дані для збереження Замовлення по «Прайс-листу» (об’єкт XDistribexPreorder)
Видалити Замовлення
DELETE /api/distribex/preorder
REQUEST
|
URL |
https://edo-v2.edin.ua |
|
Метод запиту |
DELETE |
|
URL запиту |
/api/distribex/preorder |
|
URL параметри |
gln (обов’язково) String - GLN Покупця (Дистрибʼютора) preorder_id (обов’язково) String - ідентифікатор Попереднього замовлення |
|
Headers |
|
|
Authorization |
SID - токен, отриманий при авторизації |
|
Content-Type |
application/json |
RESPONSE
Код сервера 200 (ok).
Надсилання документа (без створення чернетки)
POST /api/eds/doc/create_and_send
Метод є універсальним для різних типів документів і дозволяє одночасно створити та відправити документ без створення чернетки.
REQUEST
|
URL |
https://edo-v2.edin.ua |
|
Метод запиту |
POST |
|
URL запиту |
/api/eds/doc/create_and_send |
|
URL параметри |
gln - рядок (13); номер GLN організації, яка пов’язана з авторизованим користувачем платформи EDIN 2.0 на рівні акаунта doc_type - рядок; тип документа |
|
Headers |
|
|
Authorization |
SID - токен, отриманий при авторизації |
|
Content-Type |
|
|
REQUEST |
|
|
JSON Body |
В тілі запиту методу передається тільки один файл-вкладення в форматі
При вказуванні |
Приклад запиту в json форматі:
POST /api/eds/doc/create_and_send?doc_type=orders&gln=9864065702429 HTTP/1.1
Content-Type: multipart/form-data; boundary=-------------573cf973d5228
...else headers...
---------------573cf973d5228
Content-Disposition: form-data; name="file"; filename="file.json"
Content-Type: application/json
{Content of JSON file}Приклад запиту в xml форматі:
POST /api/eds/doc/create_and_send?doc_type=orders&gln=9864065702429 HTTP/1.1
Content-Type: multipart/form-data; boundary=-------------573cf973d5228
...else headers...
---------------573cf973d5228
Content-Disposition: form-data; name="file"; filename="file.xml"
Content-Type: application/xml
{Content of XML file}Приклад запиту в p7s форматі:
POST /api/eds/doc/create_and_send?doc_type=orders&gln=9864065702429 HTTP/1.1
Content-Type: multipart/form-data; boundary=-------------573cf973d5228
...else headers...
---------------573cf973d5228
Content-Disposition: form-data; name="file"; filename="file.p7s"
Content-Type: application/pkcs7-signature
{Content of P7S file}
RESPONSE
- chain_uuid - ідентифікатор ланцюжка, в якому знаходиться документ;
- doc_uuid - ідентифікатор документа на платформі EDIN 2.0;
- ticket_uuid - ідентифікатор квитанції
Параметр ticket_uuid повертається системою лише у випадках створення додаткового тікета до вже існуючого документа (наприклад: підписання у відповідь, відмова від підпису, запит на анулювання).
Якщо документ є новим, у відповіді система повертає лише chain_uuid та doc_uuid.
Приклад відповіді:
{
"chain_uuid": "7ccff78e-ea42-47ea-81e4-5508ed4fbd51",
"doc_uuid": "3698b501-e1ef-464d-a71a-58066f556114",
"ticket_uuid": "1003706c-3656-497b-9438-c6f33e27c36d"
}
No comments to display
No comments to display