Skip to main content

Робота з товарними пропозиціями Комерційних пропозицій

Всі запити нижче перерахованих API методів платформи EDIN 2.0 направляються на адресу: https://edo-v2.edin.ua

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

Додати товарну позицію до чернетки Комерційної пропозиції (Постачальник)
POST /api/es/position

REQUEST

URL

 

Метод запиту

POST

URL запиту

/api/es/position?gln=9864066822430&agreement_uuid=2d7d91c6-b769-419d-953d-44ed2966213a

URL параметри

gln (обов’язково) String - GLN власної Компанії;

agreement_uuid (обов’язково) String - унікальний ідентифікатор Комерційної пропозиції

Headers

 

Authorization

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

Content-Type

application/json

REQUEST

 

JSON Body

В тілі запиту методу передаються дані позицій Комерційної пропозиції (масив об’єктів XAgreemDocPosition).

RESPONSE

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

Отримати дані товарних позицій Комерційної пропозиції
GET /api/es/position

REQUEST

URL

 

Метод запиту

GET

URL запиту

/api/es/position?gln=9864066822430&agreement_uuid=2d7d91c6-b769-419d-953d-44ed2966213a

URL параметри

gln (обов’язково) String - GLN власної Компанії;

agreement_uuid (обов’язково) String - унікальний ідентифікатор Комерційної пропозиції;

position_id (опціонально) String - ідентифікатор товарної позиції

Headers

 

Authorization

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

Content-Type

application/json

RESPONSE

В тілі відповіді передаються дані всіх товарних позицій Комерційної пропозиції або конкретної товарної позиції (якщо передавати position_id) - масив об’єктів XAgreemDocPosition.

Отримати дані товарних позицій всіх Комерційних пропозицій за фільтром
POST /api/es/position/search

REQUEST

URL

 

Метод запиту

POST

URL запиту

/api/es/position/search?gln=9864066822430&agreement_uuid=2d7d91c6-b769-419d-953d-44ed2966213a

URL параметри

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

Headers

 

Authorization

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

Content-Type

application/json

REQUEST

 

JSON Body

В тілі запиту методу передається набір фільтрів для відбору позицій Комерційних пропозицій (об’єкт XSearchPositionsQuery).

RESPONSE

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

Редагувати товарну позицію чернетки Комерційної пропозиції (Постачальник)
PUT /api/es/position

REQUEST

URL

 

Метод запиту

PUT

URL запиту

/api/es/position?gln=9864066822430&agreement_uuid=2d7d91c6-b769-419d-953d-44ed2966213a

URL параметри

gln (обов’язково) String - GLN власної Компанії;

agreement_uuid (обов’язково) String - унікальний ідентифікатор Комерційної пропозиції

Headers

 

Authorization

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

Content-Type

application/json

REQUEST

 

JSON Body

В тілі запиту методу передаються дані позиції Комерційної пропозиції (об’єкт XAgreemDocPosition).

RESPONSE

Код сервера 200 (ok).

Видалити товарну позицію чернетки Комерційної пропозиції (Постачальник)
DELETE /api/es/position

REQUEST

URL

 

Метод запиту

DELETE

URL запиту

/api/es/position?gln=9864067620417&agreement_uuid=3cbb2868-b61b-42d2-86d1-11ffdf4445aa&position_id=746

URL параметри

gln (обов’язково) String - GLN власної Компанії;

agreement_uuid (обов’язково) String - унікальний ідентифікатор Комерційної пропозиції;

position_id (обов’язково) String - ідентифікатор товарної позиції

Headers

 

Authorization

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

Content-Type

application/json

RESPONSE

Код сервера 200 (ok).

Додати зображення до товарної позиції (чернетка Комерційної пропозиції)
POST /api/es/position/image

Даний метод може бути використано лише користувачем з роллю «Постачальник» для комерційних пропозицій в статусі «Чернетка». Розмір зображення, що додається, не повинен перевищувати 5Мб.

REQUEST

URL

 

Метод запиту

POST

URL запиту

/api/es/position/image?gln=9864067620417&position_id=746&image_type=logo&mime_type=image/png

URL параметри

gln (обов’язково) String - GLN власної Компанії;

position_id (обов’язково) String - ідентифікатор товарної позиції;

image_type (обов’язково) String - тип зображення:

  • icon - маленький логотип

  • logo - великий логотип (оригінальний розмір)

mime_type (обов’язково) String - згідно MIME типізації може бути переданий image/png або image/jpeg для відповідного формату зображення

Headers

 

Authorization

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

Content-Type

application/json

REQUEST

 

JSON Body

В тілі запиту методу передається файл (зображення) в вигляді набору байтів

RESPONSE

В тілі відповіді в текстовому вигляді передається посилання на збережене зображення:

https://static.edin.ua/agreement/positions/eds_ua_158182/logo/24523c0a-ea3e-4239-b15b-0a027cb991e2.jpg
Отримати зображення до товарної позиції Комерційної пропозиції
GET /api/es/position/image

REQUEST

URL

 

Метод запиту

GET

URL запиту

/api/es/position/image?gln=9864067620417&position_id=746&image_type=logo

URL параметри

gln (обов’язково) String - GLN власної Компанії;

position_id (обов’язково) String - ідентифікатор товарної позиції;

image_type (обов’язково) String - тип зображення:

  • icon - маленький логотип

  • logo - великий логотип (оригінальний розмір)

Headers

 

Authorization

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

Content-Type

application/json

RESPONSE

В тілі відповіді в текстовому вигляді передається посилання на зображення:

https://static.edin.ua/agreement/positions/eds_ua_158182/logo/24523c0a-ea3e-4239-b15b-0a027cb991e2.jpg

 

Видалити зображення до товарної позиції (чернетка Комерційної пропозиції)
DELETE /api/es/position/image

Даний метод може бути використано лише користувачем з роллю «Постачальник» для комерційних пропозицій в статусі «Чернетка».

REQUEST

URL

 

Метод запиту

DELETE

URL запиту

/api/es/position/image?gln=9864067620417&position_id=746&image_type=logo

URL параметри

gln (обов’язково) String - GLN власної Компанії;

position_id (обов’язково) String - ідентифікатор товарної позиції;

image_type (обов’язково) String - тип зображення:

  • icon - маленький логотип

  • logo - великий логотип (оригінальний розмір)

Headers

 

Authorization

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

Content-Type

application/json

RESPONSE

Код сервера 200 (ok).