Робота з Графіком замовлень
Для роботи з методами користувач повинен бути авторизованим.
Отримати список графіків замовлень
(Продавець (Виробник)
GET /api/distribex/producer/schedules
REQUEST
|
URL |
https://edo-v2.edin.ua |
|
Метод запиту |
GET |
|
URL запиту |
/api/distribex/producer/schedules |
|
URL параметри |
gln (обов’язково) String - GLN Продавця (Виробника) limit (опціонально) int - ліміт вибірки (за замовчуванням=20); offset (опціонально) int - зміщення відносно верхньої межі вибірки (за замовчуванням=0) |
|
Headers |
|
|
Authorization |
SID - токен, отриманий при авторизації |
|
Content-Type |
application/json |
RESPONSE
В тілі відповіді передається список графіків замовлень (масив об’єктів Schedule) відсортованих за датою створення/оновлення.
Створити графік замовлень
(Продавець (Виробник)
POST /api/distribex/producer/schedules
Правило створення графіка замовлень
Не допускається створення графіка замовлень, який має перетин дат з іншим графіком для одного й того ж Покупця (Дистриб’ютора) та типу графіка.
- При створенні графіка для конкретного Покупця (Дистриб’ютора) з type = 1 система виконує перевірку усіх існуючих графіків цього Продавця (Виробника) для вказаного Покупця (Дистриб’ютора) (також з типом = 1).
- Якщо буде знайдено перетин дат, система поверне помилку:
Dates can’t overlap with already existing schedule, name - [Test2]. Please edit your schedule.
REQUEST
|
URL |
https://edo-v2.edin.ua |
|
Метод запиту |
POST |
|
URL запиту |
/api/distribex/producer/schedules |
|
URL параметри |
gln (обов’язково) String - GLN Продавця (Виробника) |
|
Headers |
|
|
Authorization |
SID - токен, отриманий при авторизації |
|
Content-Type |
application/json |
|
REQUEST |
|
|
JSON Body |
В тілі запиту методу передаються дані графіка замовлень (об’єкт Schedule) |
RESPONSE
В тілі відповіді передаються дані графіка замовлень (об’єкт Schedule).
Оновити графік замовлення
(Продавець (Виробник)
PATCH /api/distribex/producer/schedules
Правило оновлення графіка замовлень
-
При оновленні графіка необхідно передавати всі параметри, так само як і при створенні.
Параметри, що не передаються в «оновленому графіку», автоматично затираються.
- Не допускається графік замовлень, який має перетин дат з іншим графіком для одного й того ж Покупця (Дистриб’ютора) та типу графіка.
- При створенні графіка для конкретного Покупця (Дистриб’ютора) з type = 1 система виконує перевірку усіх існуючих графіків цього Продавця (Виробника) для вказаного Покупця (Дистриб’ютора) (також з типом = 1).
- Якщо буде знайдено перетин дат, система поверне помилку:
Dates can’t overlap with already existing schedule, name - [Test2]. Please edit your schedule.
REQUEST
|
URL |
https://edo-v2.edin.ua |
|
Метод запиту |
PATCH |
|
URL запиту |
/api/distribex/producer/schedules |
|
URL параметри |
gln (обов’язково) String - GLN Продавця (Виробника) |
|
Headers |
|
|
Authorization |
SID - токен, отриманий при авторизації |
|
Content-Type |
application/json |
|
REQUEST |
|
|
JSON Body |
В тілі запиту методу передаються нові дані для зазначеного графіка замовлень (об’єкт Schedule) |
RESPONSE
Код сервера 200 (ok).
Видалити графік замовлення
(Продавець (Виробник)
DELETE /api/distribex/producer/schedules
REQUEST
|
URL |
https://edo-v2.edin.ua |
|
Метод запиту |
DELETE |
|
URL запиту |
/api/distribex/producer/schedules |
|
URL параметри |
gln (обов’язково) String - GLN Продавця (Виробника) schedule_id (обов’язково) long - ідентифікатор графіка замовлень |
|
Headers |
|
|
Authorization |
SID - токен, отриманий при авторизації |
|
Content-Type |
application/json |
RESPONSE
Код сервера 200 (ok).
Отримати найактуальніші графіки замовлень для зазначеного списку Продавців (Виробників)
(Покупець (Дистриб'ютор))
POST /api/distribex/distributor/schedules
Метод враховує ієрархію типів графіків: якщо у Продавця (Виробника) вже діє загальний графік, але для конкретного Покупця (Дистрибʼютора) існує індивідуальний графік, який починає діяти пізніше (після поточної дати), у відповіді буде повернено саме індивідуальний графік.
REQUEST
|
URL |
https://edo-v2.edin.ua |
|
Метод запиту |
POST |
|
URL запиту |
/api/distribex/distributor/schedules |
|
URL параметри |
gln (обов’язково) String - GLN Покупця (Дистрибʼютора) |
|
Headers |
|
|
Authorization |
SID - токен, отриманий при авторизації |
|
Content-Type |
application/json |
|
REQUEST |
|
|
JSON Body |
В тілі запиту методу передається список ідентифікаторів GLN Продавців (Виробників) (масив значень gln_id), наприклад: [13200757] |
RESPONSE
В тілі відповіді передаються дані графіка замовлень за кожним вказаним Продавцем (Виробником) (об’єкт Schedule).
Отримати перелік дат доступних для відправлення замовлень у вибраному місяці згідно з графіком Продавця (Виробника)
(Покупець (Дистриб'ютор))
POST /api/distribex/schedule/dates
REQUEST
|
URL |
|
|
Метод запиту |
POST |
|
URL запиту |
/api/distribex/schedule/dates |
|
URL параметри |
year (обов’язково) int - рік; month (обов’язково) int - порядковий номер місяця |
|
Headers |
|
|
Authorization |
SID - токен, отриманий при авторизації |
|
Content-Type |
application/json |
|
REQUEST |
|
|
JSON Body |
В тілі запиту методу передається повний об’єкт графіка замовлень (об’єкт Schedule), що може бути отриманий методом POST /api/distribex/distributor/schedules |
RESPONSE
В тілі відповіді передається список дат, наприклад: [1,2,3,4,5,6,7,8,9,10]
No comments to display
No comments to display