API

EDI Network

Підказка

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

Метод	URL запиту	Опис
POST	/api/authorization/hash	Авторизація
GET	/api/auth_check	Перевірка активності сесії

Метод	URL запиту	Опис
GET	/api/oas/user	Отримання інформації по авторизованому користувачу
GET	/api/oas/account/users	Отримання інформації про всіх користувачів компанії (на рівні акаунта)
GET	/api/oas/account/identifiers	Отримання інформації по GLN номерами, пов’язаним з авторизованим користувачем (на рівні акаунта)
GET	/api/oas/retailers	Отримання переліку роздрібних мереж, які пов’язані із заданим GLN
GET	/api/oas/retailer/identificators	Отримання переліку GLN номерів, які пов’язані із заданою роздрібною мережею
GET	/api/oas/allretailers	Отримання переліку всіх мереж
GET	/api/oas/units	Отримання переліку доступних одиниць виміру
GET	/api/oas/identifiers	Отримання інформації про організацію по Назві/ІПН/КПП/GLN

Метод	URL запиту	Опис
GET	/api/uds/dictionary	Отримати значення з віртуального довідника
POST	/api/uds/dictionary	Створити новий довідник
PUT	/api/uds/dictionary	Оновити довідник
DELETE	/api/uds/dictionary	Видалити довідник
POST	/api/uds/dictionary/values	Додати значення в довідник
DELETE	/api/uds/dictionary/values	Видалити значення з довідника

Метод	URL запиту	Опис
POST	/api/v2/eds/doc	Створення чернетки документа
PATCH	/api/eds/doc/send	Відправка чернетки
POST	/api/eds/doc/create_and_send	Відправка документа (без створення чернетки)
POST	/api/eds/docs/search	Пошук документів (з фільтрацією), вибір списку документів
GET	/api/eds/doc	Отримання інформації (мета-даних) про документ
GET	/api/eds/chain	Отримання конкретного ланцюжка документів
GET	/api/eds/doc/body	Отримання контента документа
GET	/api/eds/doc/xml	Отримання XML контента документа
GET	/api/eds/doc/download	Завантажити тіло документа/підпису
GET	/api/eds/doc/condra/body	Завантажити «Неструктурований (універсальний) документ» (CONDRA) в вигляді архіву
PATCH	/api/eds/doc/condra/send	Відправка «Неструктурованого (універсального) документа» (CONDRA)
POST	/api/v2/eds/doc/condra/create	Створення чернетки «Універсального/неструктурованого документа» (CONDRA)
POST	/api/v2/eds/doc/condra/create_and_send	Створення й відправка «Універсального/неструктурованого документа» (CONDRA) без створення чернетки
POST	/api/eds/doc/statuses	Відправка статусу документа
GET	/api/eds/doc/statuses	Отримання статусу документа
POST	/api/eds/doc/body	Додавання файла-вкладення (для CONDRA)
POST	/api/eds/doc	Створення чернетки документа (для CONDRA та TRANSPORTATIONORDER)
PUT	/api/eds/doc	Редагування чернетки документа
GET	/api/office/uuid	Отримання UUID (для CONDRA)
POST	/api/eds/doc/body	Підписання файла (для CONDRA)
PUT	/api/eds/doc/extra_fields	Заповнення індексів (додавання / оновлення полей екстрапараметрів)
PATCH	/api/eds/chain/archive	Архівування / Розархівування ланцюжка документів
GET	/api/eds/doc/reports/doctype	Отримати реєстр документів в xls форматі
GET	/api/eds/doc/print	Роздрукувати вкладення документа
POST	/api/eds/doc/attachment/sign	Додавання підпису до вкладень документа-чернетки
GET	/api/eds/doc/attachment/sign/hash	Отримати хеш вкладення (контейнера) документа для підписання
GET	/api/eds/doc/attachment/sign/info	Отримання інформації про підпис/підписантів
PATCH	/api/v2/eds/condra/reject	Відхилити «Універсальний/неструктурований документ» (CONDRA). Створення квитанції №13
PATCH	/api/v2/eds/condra/withdraw	Відкликати «Універсальний/неструктурований документ» (CONDRA). Створення квитанції №14
PATCH	/api/v2/eds/condra/confirm/send	Прийняти «Універсальний/неструктурований документ» (CONDRA)
DELETE	/api/eds/doc/attachment	Видалити файл-вкладення (чернетка)
GET	/api/eds/doc/attachment	Отримати файл-вкладення
POST	/api/eds/doc/attachment	Додати файл до документа-чернетки
PATCH	/api/eds/docs	Видалити документи-чернетки
POST	/api/v2/eds/doc/content	Отримати тіла документів (json) за вказаними UUID

Метод	URL запиту	Опис
GET	/api/eds/doc/tickets	Отримання всіх квитанцій вказаного документа
GET	/api/eds/doc/signers	Отримання інформації про підписантів
GET	/api/eds/doc/ticket/body	Отримання даних/контенту квитанції
GET	/api/v2/eds/comdoc/repeal	Створення на сервері квитанції «Анулювання» (COMDOC_019)
GET	/api/v2/eds/comdoc/reject	Створення на сервері квитанції «Повідомлення про відмову від підписання документу» (COMDOC_021) для COMDOC документів
GET	/api/v2/eds/doc/reject	Створення на сервері квитанції «Повідомлення про відмову від підписання документу» (COMDOC_021)
POST	/api/v2/eds/doc/ticket	Створення квитанції №1 (підпис чернетки)
POST	/api/v2/eds/comdoc/accept	Створення квитанції №2 (прийняття документа COMDOC)
POST	/api/v2/eds/comdoc/repeal	Створення квитанції №11 (запит на анулювання COMDOC)
POST	/api/v2/eds/comdoc/repeal/accept	Створення квитанції №12 (прийняття запиту на анулювання COMDOC)
POST	/api/v2/eds/comdoc/reject	Створення квитанції №13 (відхилення документа COMDOC)
POST	/api/v2/eds/comdoc/revoke	Створення квитанції №14 (відкликати підписання документа COMDOC)
POST	/api/v2/eds/comdoc/repeal/reject	Створення квитанції №15 (відмова від анулювання COMDOC)
POST	/api/v2/eds/doc/reject	Відправка відмови від підписання (створення квитанції №13)

Метод	URL запиту	Опис
POST	/api/eds/tags	Створити новий тег
GET	/api/eds/tags	Отримати теги
PUT	/api/eds/tags	Редагувати тег
DELETE	/api/eds/tags	Видалити теги
POST	/api/eds/doc/tags	Додати теги до документа
DELETE	/api/eds/doc/tags	Вилучити теги з документа

Примітка

1. Обираєте ідентифікатор документу, з якого Ви плануєте розпочати отримувати всі наступні події.

2. Надсилаєте запит на отримання останнього ідентифікатора події за документом.

3. В отриманному у відповідь об’єкті XEvent зберігаєте значення параметра id.

4. Надсилаєте запит для пошуку подій. В об’єкті запиту EventsStorageQuery, в параметрі fromId вказуєте ідентифікатор події який Ви отримали в пункті 3.

5. З отриманного у відповідь об’єкта EventsStorageQueryResult зберігаєте значення параметра lastEventId замість того, що зберегли в пункті 3.

6. Опрацьовуєте документи в EventsStorageQueryResult.

7. Якщо кількість значень в параметрі items об’єкта EventsStorageQueryResult:

   • дорівнює вказаному ліміту (limit) або рівне 100, то повторюйте операції з 4 по 7.

   • меньше вказаного ліміту (limit) або менше 100, то необхідно зробити паузу (1 хвилина) для подальшого виконання операцій з 4 по 7.

Метод	URL запиту	Опис
GET	/api/eds/docs/event/last	Отримати останню подію за документом
GET	/api/eds/docs/events	Отримати список подій
POST	/api/eds/docs/events	Пошук подій

Метод	URL запиту	Опис
POST	/api/eds/doc/attachment	Додати файл до документа-чернетки
GET	/api/eds/doc/attachment	Отримати файл-вкладення
DELETE	/api/eds/doc/attachment	Видалити файл-вкладення (чернетка)

Метод	URL запиту	Опис
POST	/api/eds/doc/approval/scenario	Створити сценарій погодження документів
GET	/api/eds/doc/approval/scenario	Отримати сценарій/-ії (на рівні GLN)
PUT	/api/eds/doc/approval/scenario	Редагувати / видалити сценарій погодження документів
POST	/api/eds/doc/approval/step	Запуск документа на погодження / Зміна статуса кроку погодження
GET	/api/eds/doc/approval/step	Отримання кроків погодження за документом

API «ETTN» v3

Підказка

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

Метод	URL запиту	Опис
POST	/api/authorization/hash	Авторизація
GET	/api/auth_check	Перевірка активності сесії

Метод	URL запиту	Опис
GET	/api/eds/doc/ettn/body	Отримання (завантаження) тіла документа сервісу «ЕТТН» в JSON/XML/ECMR/PDF/ZIP форматі
POST	/api/eds/doc/ettn/sign	Підписання даних сервісу «ЕТТН» (збереження підпису)
GET	/api/eds/doc/tickets	Отримання всіх квитанцій вказаного документа
GET	/api/eds/doc	Отримання інформації (мета-даних) про документ
GET	/api/eds/doc/ettn/sign/info	Отримання інформації про підписантів е-ТТН та Актів v3 (family=7)
PATCH	/api/eds/docs	Видалити документи-чернетки

Метод	URL запиту	Опис
POST	/api/eds/doc/ettn/ttn	Створення/редагування чернетки «Електронної товарно-транспортної накладної» (е-ТТН)
PATCH	/api/eds/doc/ettn/ttn/send	Відправка електронної товарно-транспортної накладної («е-ТТН») з Чернеток
POST	/api/eds/doc/ettn/ttn/transaction	Створення/редагування нової транзакції (чернетки) до е-ТТН документа
PUT	/api/eds/doc/ettn/ttn/transaction	Відправка нової транзакції до е-ТТН документа
PUT	/api/eds/doc/ettn/ttn/reject	Відхилення «Електронної товарно-транспортної накладної» (е-ТТН)
POST	/api/eds/doc/ettn/ttn/attachment	Додавання до документа вкладення (pdf) до документа е-ТТН
GET	/api/eds/doc/ettn/ttn/attachment	Отримання (завантаження) файлу-вкладення до документа е-ТТН
PATCH	/api/eds/doc/ettn/ttn/attachment	Відправки вкладення на повторну реєстрацію (при виникненні помилки)
DELETE	/api/eds/doc/ettn/ttn/attachment	Видалення файлу-вкладення до документа е-ТТН
POST	/api/eds/doc/ettn/ttn/create_and_send	Створення та відправка «е-ТТН» документа (без створення чернетки)

Метод	URL запиту	Опис
POST	/api/eds/doc/ettn/adjustment	Створення/редагування чернетки «Акта коригування» до е-ТТН
POST	/api/eds/doc/ettn/consignee_change	Створення/редагування чернетки «Акта про заміну пункту призначення вантажу» до е-ТТН
POST	/api/eds/doc/ettn/disagreement	Створення/редагування чернетки «Акта розбіжностей про вантаж» до е-ТТН
POST	/api/eds/doc/ettn/load_reject	Створення/редагування чернетки «Акта про відмову вантажити» до е-ТТН
POST	/api/eds/doc/ettn/reload	Створення/редагування чернетки «Акта перевантаження» до е-ТТН
POST	/api/eds/doc/ettn/resealing	Створення/редагування чернетки «Акта перепломбування» до е-ТТН
POST	/api/eds/doc/ettn/stop	Створення/редагування чернетки «Акта примусового завершення е-ТТН»
POST	/api/eds/doc/ettn/storage_delivery	Створення/редагування чернетки «Акта розвантаження на проміжному складі» до е-ТТН
POST	/api/eds/doc/ettn/storage_pickup	Створення/редагування чернетки «Акта завантаження на проміжному складі» до е-ТТН

Метод	URL запиту	Опис
POST	/api/eds/doc/ettn/act/transaction	Створення/редагування нової транзакції (чернетки) до Актів сервісу
PUT	/api/eds/doc/ettn/act/transaction	Відправка нової транзакції до Актів сервісу
PUT	/api/eds/doc/ettn/act/reject	Відхилення Актів сервісу
PATCH	/api/eds/doc/ettn/act/send	Відправка Актів з Чернеток

Метод	URL запиту	Опис
GET	/api/mintrans/subscribe	Отримання даних про підписки на події (отримання документів)
POST	/api/mintrans/subscribe	Створення (оформлення) підписки на події (отримання документів)
DELETE	/api/mintrans/subscribe	Видалення підписки на події (отримання документів)
GET	/api/mintrans/events	Отримання списку подій з ЦБД
GET	/api/mintrans/doc	Отримання документа з ЦБД

Код відповіді	Текст помилки	Індекс	Опис
400	SETUP_DOC_NUMBER_ERROR	TTN_ERR-1	Setup document number [%s] Заповніть номер документу [%s]
400	SETUP_DOC_DATE_ERROR	TTN_ERR-2	Setup document date [%s] Заповніть дату документу [%s]
400	SETUP_ETTN_REF_ERROR	TTN_ERR-3	Setup reference to ettn Заповніть посилання на ТТН
400	EMPTY_GLN_FIELD_ERROR	TTN_ERR-4	[%s] is not filled in gln [%s] [%s] не заповнено в gln [%s]
400	TRADE_PARTY_ID_NOT_FILED_ERROR	TTN_ERR-5	Field [id.value] in trade party for role [%s] is not filled Поле [id.value] учасника ролі [%s] не заповнено
400	EMPTY_FIELD_ERROR	TTN_ERR-6	field [%s] is not filled Поле [%s] не заповнене
400	UNKNOWN_INITIATOR_ERROR	TTN_ERR-7	Unknown initiator Невідомий ініціатор
400	UNKNOWN_CARRIER_ERROR	TTN_ERR-8	Unknown carrier Невідомий перевізник
400	UNKNOWN_UNLOAD_STORAGE	TTN_ERR-9	Unknown unload storage Невідомий склад розвантаження
400	UNKNOWN_LOAD_STORAGE	TTN_ERR-10	Unknown load storage Невідомий склад навантаження
400	UNKNOWN_CONSIGNOR_ERROR	TTN_ERR-11	Unknown consignor Невідомий вантажовідправник
400	UNKNOWN_CONSIGNEE_ERROR	TTN_ERR-12	Unknown consignee Невідомий вантажоотримувач
400	UNKNOWN_CUSTOMER_ERROR	TTN_ERR-13	Unknown customer Невідомий замовний
400	UNKNOWN_NEW_CONSIGNEE_ERROR	TTN_ERR-14	Unknown new consignee Невідомий новий вантажоотримувач
400	UNKNOWN_NEW_CARRIER_ERROR	TTN_ERR-15	Unknown new carrier Невідомий новий перевізник
400	UNKNOWN_DRIVER_ERROR	TTN_ERR-16	Unknown driver Невідомий водій
400	UNKNOWN_NEW_DRIVER_ERROR	TTN_ERR-17	Unknown new driver Невідомий новий водій
400	UNKNOWN_INITIATOR_GLN_ERROR	TTN_ERR-18	Unknown initiator gln [%s] Невідомий ініціатор gln [%s]
400	DETERMINE_GLN_ERROR	TTN_ERR-19	Failed to determine gln for trade party [%s] Не вдалося визначити gln для учасника [%s]
400	DETERMINE_DRIVER_GLN_ERROR	TTN_ERR-20	Failed to determine gln for driver [%s] Не вдалося визначити gln для водія [%s]
400	DETERMINE_TRADE_PARTY_ERROR	TTN_ERR-21	Failed to determine trading party for gln [%s] Не вдалося визначити учасника для gln [%s]
400	GLN_TRADEPARTY_ERROR	TTN_ERR-22	Unknown gln [%s] for tradeParty with role: [%s], and name [%s] Невідомий gln [%s] для учасника з роллю: [%s] і назвою [%s]
400	IS_NOT_DRIVER_GLN_ERROR	TTN_ERR-23	gln [%s] is not driver gln gln [%s] не є gln-ом водія
400	INCORRECT_DRIVER_TIN	TTN_ERR-24	Incorrect driver TIN in field [taxRegistration.id], expected [%s] Неправильний ІПН водія в полі [taxRegistration.id], очікується [%s]
400	EDRPOU_MISMATCH	TTN_ERR-25	Edrpou [%s] in gln [%s] and document [%s] are different ЄДРПОУ [%s] в gln [%s] та документі [%s] відрізняються
400	TIN_MISMATCH	TTN_ERR-26	TIN [%s] in gln [%s] and document [%s] are different ІПН [%s] в gln [%s] та документі [%s] відрізняються
400	PARENT_ETTN_NOT_FOUND_ERROR	TTN_ERR-27	Parent ettn not found Документ підстава (ТТН) не знайдено
400	PARENT_STORAGE_DELIVERY_DOC_FOUND_ERROR	TTN_ERR-28	Parent storage delivery doc not found Документ підстава (акт розвантаження на проміжному складі) не знайдено
400	PARENT_ETTN_STATUS_ERROR	TTN_ERR-29	Parent TTN has incorrect status Документ підстава (ТТН) має некоректний статус
400	ETTN_ONSTORAGE_ERROR	TTN_ERR-30	TTN status «ONSTORAGE» can be changed automatically only after the completion of the life cycle of the storage pick up act or the stop TTN act Статус ТТН «ONSTORAGE» може бути змінено автоматично лише після завершення життєвого циклу акта завантаження на складі або акту зупинки ТТН
400	ACT_IN_PROCESS_ERROR	TTN_ERR-31	Work with TTN is temporarily unavailable. Due to the unfinished process of working with the act [%s] to this TTN. Wait for the completion of work on it. Робота з ТТН тимчасово недоступна. У зв’язку з незавершеним процесом роботи з актом [%s] до цієї ТТН. Дочекайтеся завершення роботи над ним.
400	WAITING_FOR_TTN_UPDATE_ERROR	TTN_ERR-32	We have already created a new transaction for TTN. Please use API method GET, "/api/eds/doc/ettn/body" for receiving this new transaction. Ми вже створили нову транзакцію для ТТН. Будь ласка, використовуйте метод API GET, "/api/eds/doc/ettn/body" для отримання цієї нової транзакції.
400	KEY_BLOCKED_ERROR	TTN_ERR-33	Key blocked. EDRPOU/TIN mismatch. Ключ заблоковано. Невідповідність ЄДРПОУ/ІПН.
400	CONTENT_FOR_SIGN_IS_NOT_CREATED_ERROR	TTN_ERR-34	No signature content created. Resave document Вміст для підписання не створено. Збережіть документ повторно
400	SIGN_HASH_ERROR	TTN_ERR-35	sign_hash is broken, resave document невідповідний sign_hash, повторно збережіть документ
400	ONLY_SIGNED_STAMP_ERROR	TTN_ERR-36	The document cannot be signed only with the stamp. Sign the document with your signature. Документ не може бути підписаний лише печаткою. Підпишіть документ своїм підписом.
400	INCORRECT_CONTENT_TYPE_ERROR	TTN_ERR-37	Setup correct content type in request. Use „application/json“ or „application/xml“ Вкажіть content type в запиті. Використовуйте «application/json» або «application/xml».
400	ACTION_NOT_AVAILABLE	TTN_ERR-38	Action not available. Дія недоступна.
400	DOCUMENT_NOT_FOUND_ERROR	TTN_ERR-39	Document not found Документ не знайдено
400	TICKET_NOT_FOUND_ERROR	TTN_ERR-40	The required ticket was not found Необхідна квитанція не знайдена
400	ROLE_MISMATCH_ERROR	TTN_ERR-41	The company role specified in the URL parameter does not match the role of this company in the document structure Вказана в URL-параметрі роль компанії не відповідає ролі цієї компанії в структурі документа
400	UNSUPPORTED_DOC_TYPE_ERROR	TTN_ERR-42	Unknown or unsupported doc type. Невідомий або непідтримуваний тип документа.
400	MINTRANS_STATUS_ERROR	TTN_ERR-43	Mintrans status error. expected: [%s], actual: [%s] Невідповідність статусу від Мінтранс. Очікуваний [%s], фактичний [%s].
400	INITIATOR_ROLE_ERROR	TTN_ERR-44	Invalid initiator role Некоректна роль ініціатора
400	TTN_ACT_INP_ROCESS_ERROR	TTN_ERR-45	Act for TTN is in process Присутній незавершенний акт до ТТН
400	TEMPLATE_DOC_UUID_PARAMS_ERROR	TTN_ERR-46	"template_doc_uuid" and "doc_uuid" parameters cannot be set at the same time Параметри "template_doc_uuid" і "doc_uuid" не можна встановити одночасно
400	INCORRECT_DOC_STATUS	TTN_ERR-47	Incorrect doc status Неправильний статус документа
400	UNSUPPORTED_ROLE_CODE	TTN_ERR-48	Unknown or unsupported role_code [%s] Невідомий або непідтримуваний role_code [%s]
400	UNSUPPORTED_FORMAT_ERROR	TTN_ERR-49	Unsupported format [%s] Непідтримуваний формат [%s]
400	UNSUPPORTED_RESPONSE_TYPE_ERROR	TTN_ERR-50	Unsupported response_type [%s] Непідтримуваний response_type [%s]
400	INCORRECT_SUBSTATUS_ERROR	TTN_ERR-51	Detect sub_status error. Current sub_status: [%s] Некорекнтий сабстатус. Поточний сабстатус: [%s]
400	ACT_IS_COMPLETED_ERROR	TTN_ERR-52	Act is completed Акт завершено
400	DELIVERY_COMPLETED_ERROR	TTN_ERR-53	Delivery is completed Поставку завершено
400	ATTACHMENT_TYPE_ERROR	TTN_ERR-54	Incorrect attachment type: [%s] one of: [%s] expected Неправильний тип вкладення: очікується [%s] один із: [%s].
400	ATTACHMENT_FILE_TYPE_ERROR	TTN_ERR-55	Unsupported file type [%s] Непідтримуваний тип файлу [%s].
400	ATTACHMENT_FILE_COUNT_ERROR	TTN_ERR-56	Expected 1 file in multipart/form data Очікується 1 файл у multipart/form data
400	ATTACHMENT_NOT_FOUND_ERROR	TTN_ERR-57	Attachment not found Вкладення не знайдено
400	PARENT_DOC_PARTICIPANTS_MISMATCHED	TTN_ERR-58	The list of participants in the basis document does not correspond to the list of participants in the current document Перелік учасників документа підстави не відповідає переліку учасників поточного документа
400	MINTRANS_ERROR	TTN_ERR-59	MINTRANS_ERROR: [%s] Помилка від Мінтранс: [%s]
400	FAIL_TO_PARSE_CONTENT	TTN_ERR-60	Fail to parse content in field [%s] Не вдалося опрацювати контент у полі [%s]
400	INVALID_SIGN_FORMAT_ERROR	TTN_ERR-61	INVALID_SIGN_FORMAT, CADES_X_LONG is expected Некоректний форма підпису, допустимий лише CADES_X_LONG
400	GLN_ADDRESS_NOT_FOUND	TTN_ERR-62	Gln for address [%s] not found Не вдалося визначити gln для адреси [%s]
400	KATOTTG_MISMATCH	TTN_ERR-63	katottg [%s] in gln [%s] and document [%s] are different катоттг [%s] в gln [%s] та документі [%s] відрізняються
400	SIGN_CONTAINER_IS_EMPTY	TTN_ERR-64	Signs not found В документі відсутні підписи
400	XSD_VALIDATION_ERROR	TTN_ERR-65	xsd validation error: [%s] Помилка при валідації за xsd: [%s]
400	APPLICATION_XML_CONTENT_TYPE_EXPECTED	TTN_ERR-66	Setup correct content type in request. Use „application/xml“ Вкажіть content type в запиті. Використовуйте «application/xml».
400	XML_BODY_IS_NOT_CANONICAL	TTN_ERR-67	xml body is not canonical or invalid xml тіло не канонізоване або некоректне
400	DOCUMENT_VALIDATION_ERROR	TTN_ERR-68	Validation document errors: [%s] Документ містить помилки: [%s]
400	DOCUMENT_XSD_VALIDATION_ERROR	TTN_ERR-69	XSD Validation document error: [%s] Помилка валідації документа за XSD: [%s]
400	DRIVER_RESP_PERSON_NTO_FOUND	TTN_ERR-70	No person with the driver’s TIN was found among the responsible persons of the carrier Серед відповідальних осіб перевізника не знайдено особу з ІПН водія
400	EMPTY_LINK_DOC_LIST	TTN_ERR-72	empty link doc list Порожній список документів
400	LINK_DOCS_LIMIT_EXCEEDED	TTN_ERR-73	The limit of the number of linked documents has been exceeded. Limit: [%s], 1 Перевищено ліміт кількості пов’язаних документів. Ліміт: [%s], 1
400	INCORRECT_LINKED_DOC_UUID_LIST	TTN_ERR-74	Incorrect list uuid of documents Некоректний список uuid-ів документів
400	INCORRECT_LINK_DOCS_DATA	TTN_ERR-75	Errors found when checking documents: [%s], 1 Знайдені помилки при перевірці документів: [%s], 1
400	SIGN_ERROR	TTN_ERR-76	Signs is invalid: [%s], 1 Помилка при перевірці підпису: [%s], 1
400	SIGN_EDRPOU_MISMATCH_COMPANY_EDRPOU	TTN_ERR-77	EDRPOU from sign: [%s] is not equals gln EDRPOU: [%s], 2 ЄДРПОУ з підписа: [%s] не відповідає ЄДРПОУ з глн: [%s], 2
400	INCORRECT_LINK_DOC_STATUSES	TTN_ERR-78	Some link docs has incorrect status Деякі пов’язані документи знаходяться в некоректному статусі
500	Internal server error: sd898sdf63		Виникає в разі неможливості опрацювати запит (рекомендуємо звернутись до нашої технічної підтримки: support@edin.ua)

Помилки, що можуть виникнути на стороні ЦБД:

Код відповіді	Код помилки	Опис
400	0	Внутрішня помилка ЦБД
400	1	Некоректно сформований запит
400	2	Некоректний токен
400	4	Некоректний тип транспортного засобу
400	5	Некоректна роль представника
400	6	Об’єкт eTTN не знайдений
400	7	Некоректний перехід між станами eTTN
400	9	Завантаження у поточному стані не дозволене
400	10	Об’єкт супровідного документу не знайдений
400	11	Запропонований тип супровідного документу відрізняється від поточного
400	12	Некоректний перехід між станами супровідних документів
400	13	Некоректний запропонований час відміни супровідного документу
400	14	Підпис подіїї більше не дійсний
400	15	Відсутній ідентифікатор події
400	16	Розбіжність у текстах згоди
400	17	Споживач не підписаний на події
400	18	Відсутній текст згоди
400	19	Токен доступу більше не дійсний
400	20	Некоректна роль підписанта eTTN
400	21	Некоректна роль підписанта супровідного документу
400	22	Некоректне посилання на документ
400	24	Некоректна комбінація станів eTTN та супровідного документу
400	25	Некоректна операція з оновлення представників
400	26	Некоректна кількість підписів супровідного документу
400	27	Некоректний тип супровідного документу
400	28	Некоректний запропонований час оновлення супровідного документу
400	29	Документ не відповідає схемі
400	30	Підпис документу не пройшов перевірку
400	31	Невалідна попередня версія документу
400	32	Не вдалося завантажити документ
400	33	Невалідний токен для отримання документу

Код помилки	Опис	Рекомендовані дії
500	Не класифікована помилка	У випадку, якщо Ви отримали у тілі відповіді подібний текст “Internal Server Error. Channel ID: 45b696af”, то зверніться за допомогою до нашої тех. підтримки. Якщо Ви отримали інший текст помилки, то прочитайте її і спробуйте зрозуміти. В багатьох випадках, проблема буде описана.
502	Сервер не відповідає	Перевірте ваше інтернет з’єднання. Якщо все гаразд, то спробуйте повторити раніше надісланий запит.
504	Тайм-аут отримання відповіді з сервера	У випадку надсилання запиту, що змінює дані (наприклад, підписання документа) ми рекомендуємо перевіряти виконання попереднього запиту (наприклад, чи був доданий підпис). З затримкою в 5 секунд надішліть запит для перевірки виконання Вашого попереднього запиту. Якщо Ваш попередній запит не виконався з будь-яких причин, повторіть його.
520	Сервісна помилка	Запит не був опрацьований нашими серверами. З затримкою в 5 секунд, повторіть Ваш запит.
521	Сервісна помилка	Запит не був опрацьований нашими серверами. З затримкою в 5 секунд, повторіть Ваш запит.
522	Сервісна помилка	Запит не був опрацьований нашими серверами. З затримкою в 5 секунд, повторіть Ваш запит.
523	Сервісна помилка	Запит не був опрацьований нашими серверами. З затримкою в 5 секунд, повторіть Ваш запит.
524	Сервісна помилка	Запит не був опрацьований нашими серверами. З затримкою в 5 секунд, повторіть Ваш запит.
525	Сервісна помилка	Запит не був опрацьований нашими серверами. З затримкою в 5 секунд, повторіть Ваш запит.
526	Сервісна помилка	Запит не був опрацьований нашими серверами. З затримкою в 5 секунд, повторіть Ваш запит.

Комерційна пропозиція

Підказка

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

Метод	URL запиту	Опис
POST	/api/authorization	Авторизація

Метод	URL запиту	Опис
GET	/api/es/agreements	Отримати список документів в журналі
POST	/api/es/agreement	Створити комерційну пропозицію (для Постачальника)
GET	/api/es/agreement	Отримати дані комерційної пропозиції
PUT	/api/es/agreement	Редагувати комерційну пропозицію (для Постачальника)
DELETE	/api/es/agreement	Видалення комерційної пропозиції
PATCH	/api/es/agreement	Надіслати комерційну пропозицію (для Постачальника)
PUT	/api/es/agreement/status	Оновити статус документа (комерційної пропозиції / товарного узгодження)
GET	/api/es/agreement/offer/excel	Отримати Комерційну пропозицію в xlsx форматі (Excel)
POST	/api/es/agreement/body	Створити тіло документа (комерційної пропозиції / товарного узгодження) / Додати обгрунтування до пропозиції
GET	/api/es/agreement/body	Отримати тіло документа (комерційної пропозиції / товарного узгодження)
PUT	/api/es/agreement/body	Оновити тіло документа (комерційної пропозиції / товарного узгодження)

Метод	URL запиту	Опис
POST	/api/es/position	Додати товарну позицію до чернетки Комерційної пропозиції (Постачальник)
GET	/api/es/position	Отримати дані товарних позицій Комерційної пропозиції
POST	/api/es/position/search	Отримати дані товарних позицій всіх Комерційних пропозицій за фільтром
PUT	/api/es/position	Редагувати товарну позицію чернетки Комерційної пропозиції (Постачальник)
DELETE	/api/es/position	Видалити товарну позицію чернетки Комерційної пропозиції (Постачальник)
POST	/api/es/position/image	Додати зображення до товарної позиції (чернетка Комерційної пропозиції)
GET	/api/es/position/image	Отримати зображення до товарної позиції Комерційної пропозиції
DELETE	/api/es/position/image	Видалити зображення до товарної позиції (чернетка Комерційної пропозиції)

Метод	URL запиту	Опис
GET	/api/products/group	Отримати доступні групи/категорії
PUT	/api/products/group	Відредагувати групу / категорію (Мережа)
POST	/api/products/group	Створити нову групу / категорію (Мережа)
DELETE	/api/products/group	Видалити групу / категорію (Мережа)

Е-Специфікація

• Після погодження (обоюдного підписання) «Товарної специфікації» (COMDOC_008) реалізована автоматична відправка документа «Електронна специфікація» (PRODUCTLIST) з урахуванням усіх погоджених змін. Мережа при цьому отримує документ через FTP сервіс EDIN. Перегляд усіх Cпецифікацій / Переглянути Специфікацію з конкретним контрагентом.

Підказка

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

Метод	URL запиту	Опис
POST	/api/authorization	Авторизація

Метод	URL запиту	Опис
GET	/api/oas/account/users	Отримання інформації про всіх користувачів компанії (на рівні акаунта)
GET	/api/es/user/spec_all_glns	Отримати всі пов’язані GLN користувача в сервісі «Е-Специфікація»
GET	/api/es/user/spec_view_statuses	Отримати всі статуси документів, в яких документи доступні користувачу до перегляду
GET	/api/es/user/spec_view_glns	Отримати всі активні GLN користувача (за якими відображаються категорії товарів)
GET	/api/es/user/spec_status	Отримати налаштування дій узгодження для вказаного користувача в розрізі кожного підтипу документа AGREEM
POST	/api/es/user/spec_view_statuses	Вказати нові статуси документів, в яких документи будуть доступні користувачу до перегляду
POST	/api/es/user/spec_view_glns	Вказати нові активні GLN користувача (за якими відображаються категорії товарів)
POST	/api/es/user/spec_status	Вказати нові дії узгодження для вказаного користувача в розрізі кожного підтипу документа AGREEM

Метод	URL запиту	Опис
POST	/api/es/contract	Створення нової специфікації (Мережа)
PUT	/api/es/contract	Оновлення раніше створеної специфікації (Мережа)
GET	/api/es/contracts	Перегляд усіх контрактів/специфікацій
GET	/api/es/contract	Переглянути контракт з конкретним контрагентом
DELETE	/api/es/contract/data	Видалити контракт/товарні позиції в контракті
POST	/api/es/contracts/search	Пошук контрактів/специфікацій (з фільтрацією)

Метод	URL запиту	Опис
GET	/api/es/agreements	Отримати список документів в журналі
GET	/api/oas/retailer/settings	Переглянути налаштування мережі
GET	/api/es/agreement	Отримати дані товарного узгодження
POST	/api/es/agreement	Створити пропозицію (переузгодження) (для Постачальника)
PUT	/api/es/agreement	Редагувати пропозицію (переузгодження) (для Постачальника)
POST	/api/es/agreement/body	Створити тіло документа (комерційної пропозиції / товарного узгодження) / Додати обгрунтування до пропозиції
GET	/api/es/agreement/body	Отримати тіло документа (комерційної пропозиції / товарного узгодження)
PUT	/api/es/agreement/body	Оновити тіло документа (комерційної пропозиції / товарного узгодження)
DELETE	/api/es/agreement	Видалити пропозицію
DELETE	/api/es/agreement/attachment	Видалити вкладення (обгрунтування) пропозиції товарного переузгодження
GET	/api/es/attachment	Отримати список вкладень до пропозиції товарного переузгодження чи конкретного коментаря документа
GET	/api/es/attachment/body	Отримати контент файлу-вкладення товарного узгодження чи коментаря
POST	/api/es/attachment	Додати обгрунтування до пропозиції товарного переузгодження (Постачальник)
PATCH	/api/es/agreement	Надіслати пропозицію (переузгодження) (для Постачальника)
PATCH	/api/es/agreement/comdoc	Надіслати підписану пропозицію
GET	/api/es/agreement/signers	Отримання інформації про сертифікати підписантів
PUT	/api/es/agreement/copy	Клонування товарного узгодження (створення пропозиції)
POST	/api/es/agreements/search	Пошук «Товарних узгоджень» (AGREEM) з фільтрацією
GET	/api/es/agreement/excel	Формування та отримання Excel-звіту по акціях
PATCH	/api/v2/es/agreement/positions	Приймання/Відхилення позицій «Товарного узгодження» (Мережа)
PATCH	/api/v2/es/agreement/reject	Відхилення «Товарного узгодження» (Мережа)
POST	/api/v2/es/agreement/comdoc	Прийняти «Товарне узгодження» (Мережа)
PATCH	/api/v2/es/agreement/comdoc	Відправити підписаний документ «Товарна специфікація» (Мережа)
GET	/api/v2/es/agreement/comdoc	Отримати XML контента документа «Товарна специфікація» (Мережа)

Метод	URL запиту	Опис
POST	/api/es/agreement/comment	Створити коментар до пропозиції товарного переузгодження
GET	/api/es/agreement/comments	Переглянути коментарі

Метод	URL запиту	Опис
PUT	/api/es/agreement/status	Оновити статус документа (комерційної пропозиції / товарного узгодження)
PUT	/api/es/agreement/sub_status	Оновити внутрішній статус пропозиції

Маркет

Підказка

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

Метод	URL запиту	Опис
POST	/api/authorization/hash	Авторизація
GET	/api/auth_check	Перевірка активності сесії

Метод	URL запиту	Опис
POST	/api/distribex/limits	Додати/змінити обмеження
GET	/api/distribex/limits	Отримати обмеження контрагента за GLN
DELETE	/api/distribex/limits	Видалити обмеження для контрагента

Метод	URL запиту	Опис
PUT	/api/distribex/quotas	Встановити нові квоти для Дистриб’юторів
GET	/api/distribex/quotas	Отримати квоти по товару для вказаного Дистриб’ютора
DELETE	/api/distribex/quotas	Масово видалити квоти в прайс-листі для Дистриб’ютора

Метод	URL запиту	Опис
PUT	/api/distribex/surcharge	Встановити відмітку «Надбавка» для Дистриб’юторів
GET	/api/distribex/surcharge	Отримати дані надбавки по товару для вказаного Дистриб’ютора
DELETE	/api/distribex/surcharge	Масово видалити відмітку надбавки в прайс-листі для Дистриб’ютора

Метод	URL запиту	Опис
POST	/api/distribex/pricelist	Додати нові/оновлені дані товарів, що долучаються в Прайс-лист до вказаних Дистриб’юторів
PUT	/api/distribex/pricelist	Редагувати дані товарів «Прайс-листа» вказаного Дистриб’ютора
GET	/api/distribex/pricelist	Отримати дані «Прайс-листа» для вказаного Дистриб’ютора
DELETE	/api/distribex/pricelist	Видалити позицію або «Прайс-лист» повністю для вказаного Дистриб’ютора

Метод	URL запиту	Опис
PUT	/api/distribex/preorder	Зберегти (відредагувати) Попереднє замовлення за «Прайс-листом»
GET	/api/distribex/preorder	Отримати дані для формування Попереднього замовлення по «Прайс-листу»
POST	/api/distribex/preorder	Зберегти Попереднє замовлення по «Прайс-листу»
DELETE	/api/distribex/preorder	Видалити Попереднє замовлення
POST	/api/eds/doc/create_and_send	Відправка документа (без створення чернетки)

Метод	URL запиту	Опис
POST	/api/eds/doc/create_and_send	Відправити рекомендації до замовлення за «Прайс-листом»

Метод	URL запиту	Опис
GET	/api/oas/doc_counter	Створити (розрахувати) номер «Замовлення» (ORDER)
POST	/api/distribex/doc/order	Створити документ «Замовлення» (ORDER) за «Прайс-листом»
POST	/api/distribex/order/copy	Повторити (скопіювати) документ «Замовлення» (ORDER) згідно актуального «Прайс-листа»
GET	/api/eds/doc/body	Отримання контента документа
POST	/api/eds/docs/search	Пошук документів (з фільтрацією), вибір списку документів

Метод	URL запиту	Опис
GET	/api/distribex/distributor/list	Отримати список контрагентів-Дистриб’юторів
GET	/api/distribex/producers/list	Отримати список контрагентів-Виробників

Метод	URL запиту	Опис
PUT	/api/distribex/product	Відредагувати товарну позицію «Прайс-листа»
GET	/api/distribex/categories	Отримати список категорій товарів Прайс-листа
DELETE	/api/distribex/product	Видалити товарну позицію з «Прайс-листа»

Метод	URL запиту	Опис
GET	/api/distribex/accessgroup	Отримати дані про створені групи Дистриб’юторів (Виробник)
POST	/api/distribex/accessgroup	Створити групу Дистриб’юторів (Виробник)
PUT	/api/distribex/accessgroup	Переіменувати існуючу групу Дистриб’юторів (Виробник)
DELETE	/api/distribex/accessgroup	Видалити групу Дистриб’юторів (Виробник)
POST	/api/distribex/useraccessgroup	Додати Дистриб’ютора до групи Дистриб’юторів (Виробник)
DELETE	/api/distribex/useraccessgroup	Видалити Дистриб’ютора з групи Дистриб’юторів (Виробник)

Тендер

Підказка

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

Метод	URL запиту	Опис
POST	/api/authorization/hash	Авторизація
GET	/api/auth_check	Перевірка активності сесії

Метод	URL запиту	Опис
POST	/api/v1/tender/lot/bets	Зробити ставку по лоту (Учасник)
DELETE	/api/v1/tender/lot/bets	Видалити ставку по лоту тендера (Організатор)

Метод	URL запиту	Опис
POST	/api/v1/tender/auctions	Створити новий тендер (чернетку)
PATCH	/api/v1/tender/auctions/publish	Опублікувати тендер
GET	/api/v1/tender/auction	Отримати дані тендера (за id)
GET	/api/v1/tender/auctions/drafts	Отримання списку тендерів з «Чернеток»
GET	/api/v1/tender/auctions/my	Отримання списку тендерів з «Мої тендери»
GET	/api/v1/tender/auctions/all	Отримання списку з «Усі тендери»
GET	/api/v1/tender/auction/views	Отримати дані про перегляди тендера (за id)
GET	/api/v1/tender/guest/auctions/all	Отримання списку тендерів для неавторизованого користувача
PATCH	/api/v1/tender/auctions/close	Завершити тендер (Організатор)
POST	/api/v1/tender/auction/access/invite	Запросити компанії взяти участь в тендері (Організатор)
POST	/api/v1/tender/auction/access/request	Подати заявку на участь в закритому аукціоні (Учасник)
GET	/api/v1/tender/auction/access/company/outgoing	Отримати дані по заявкам на участь в закритих аукціонах (Учасник)
PATCH	/api/v1/tender/auction/access/confirm	Схвалити заявку на участь в закритому аукціоні (Організатор)
PATCH	/api/v1/tender/auction/access/reject	Відхилити заявку на участь в закритому аукціоні (Організатор)

Метод	URL запиту	Опис
POST	/api/v1/tender/attachments	Додати вкладення до тендера, лота (Організатор) / Додати вкладення до ставки (Учасник)
GET	/api/v1/tender/attachments	Отримати список вкладень до тендера/лота/ставки
GET	/api/v1/tender/attachment	Отримати файл-вкладення до тендера/лота/ставки
DELETE	/api/v1/tender/attachment	Видалити вкладення до тендера / лота (Організатор)

Метод	URL запиту	Опис
GET	/api/v1/tender/user/subscribes	Отримати список користувачів, на яких підписаний поточний Адміністратор акаунта
POST	/api/v1/tender/user/subscribes	Додати підписку на користувача (Адміністратор акаунта)
DELETE	/api/v1/tender/user/subscribes	Видалити підписку на користувача (Адміністратор акаунта)

Метод	URL запиту	Опис
GET	/api/v1/tender/categories	Отримати довідник категорій
GET	/api/v1/tender/currency	Отримати довідник валют
GET	/api/v1/tender/regions	Отримати довідник регіонів
GET	/api/v1/tender/units	Отримати довідник одиниць виміру

Метод	URL запиту	Опис
GET	/api/v1/tender/participant_group/list	Отримати список всіх наявних груп учасників
GET	/api/v1/tender/participant_group	Отримати дані групи учасників
POST	/api/v1/tender/participant_group	Створити/Редагувати групу учасників
DELETE	/api/v1/tender/participant_group	Видалити групу учасників

Код помилки	Опис	Рекомендовані дії
500	Не класифікована помилка	У випадку, якщо Ви отримали у тілі відповіді подібний текст “Internal Server Error. Channel ID: 45b696af”, то зверніться за допомогою до нашої тех. підтримки. Якщо Ви отримали інший текст помилки, то прочитайте її і спробуйте зрозуміти. В багатьох випадках, проблема буде описана.
502	Сервер не відповідає	Перевірте ваше інтернет з’єднання. Якщо все гаразд, то спробуйте повторити раніше надісланий запит.
504	Тайм-аут отримання відповіді з сервера	У випадку надсилання запиту, що змінює дані (наприклад, підписання документа) ми рекомендуємо перевіряти виконання попереднього запиту (наприклад, чи був доданий підпис). З затримкою в 5 секунд надішліть запит для перевірки виконання Вашого попереднього запиту. Якщо Ваш попередній запит не виконався з будь-яких причин, повторіть його.
520	Сервісна помилка	Запит не був опрацьований нашими серверами. З затримкою в 5 секунд, повторіть Ваш запит.
521	Сервісна помилка	Запит не був опрацьований нашими серверами. З затримкою в 5 секунд, повторіть Ваш запит.
522	Сервісна помилка	Запит не був опрацьований нашими серверами. З затримкою в 5 секунд, повторіть Ваш запит.
523	Сервісна помилка	Запит не був опрацьований нашими серверами. З затримкою в 5 секунд, повторіть Ваш запит.
524	Сервісна помилка	Запит не був опрацьований нашими серверами. З затримкою в 5 секунд, повторіть Ваш запит.
525	Сервісна помилка	Запит не був опрацьований нашими серверами. З затримкою в 5 секунд, повторіть Ваш запит.
526	Сервісна помилка	Запит не був опрацьований нашими серверами. З затримкою в 5 секунд, повторіть Ваш запит.

Вільний

Підказка

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

Метод	URL запиту	Опис
POST	/api/authorization/hash	Авторизація
GET	/api/auth_check	Перевірка активності сесії

Метод	URL запиту	Опис
POST	/api/sd/eds/doc	Створити документ з метаданими (чернетку)
GET	/api/sd/eds/doc	Отримати документ
PATCH	/api/sd/eds/doc	Редагувати метадані документа (чернетка)
DELETE	/api/sd/eds/doc	Видалити документ (чернетку)
POST	/api/sd/eds/doc/decline	Відхилити вхідний документ
GET	/api/sd/eds/doc/zip	Завантажити документ (zip-архів)
GET	/api/sd/eds/doc/body	Отримати метадані документа
PATCH	/api/sd/eds/doc/send	Відправити документ (чернетку)
PATCH	/api/sd/eds/doc/important	Відмітити документа, як «важливий» / «звичайний»
POST	/api/sd/eds/docs/search	Отримати список документів
PATCH	/api/sd/eds/doc/send/recipients	Додати отримувача до відправленого документа

Метод	URL запиту	Опис
POST	/api/sd/eds/doc/attachment	Додати файл до документа-чернетки
GET	/api/sd/eds/doc/attachment	Отримати файл-вкладення
DELETE	/api/sd/eds/doc/attachment	Видалити файл-вкладення (чернетка)

Метод	URL запиту	Опис
POST	/api/sd/eds/doc/sign	Підписати документ
GET	/api/sd/eds/doc/sign	Отримати дані про підписання файлу-вкладення
POST	/api/sd/eds/doc/create_and_send	Створення та відправка документа (без створення чернетки)

Метод	URL запиту	Опис
GET	/api/oas/v2/employees/search	Отримання даних контрагента за ім’ям / ІПН / email / ЄДРПОУ / номером телефону

Метод	URL запиту	Опис
POST	/api/oas/partner	Додати в сервіс дані нового контрагента / Редагувати дані контрагента
GET	/api/oas/partner	Отримати дані контрагента (розділ «Контрагенти»)
POST	/api/oas/partners	Завантажити в сервіс список контрагентів з Excel
GET	/api/oas/partners	Отримати список контрагентів (розділ «Контрагенти»)
POST	/api/oas/partners/invite	Відправити запрошення контрагентам

Метод	URL запиту	Опис
POST	/api/sd/eds/employee/tags	Створити новий тег
GET	/api/sd/eds/employee/tags	Отримати теги
PUT	/api/sd/eds/employee/tags	Редагувати тег
DELETE	/api/sd/eds/employee/tags	Видалити тег
POST	/api/sd/eds/doc/tags	Додати теги до документа
DELETE	/api/sd/eds/doc/tags	Вилучити теги з документа

Код помилки	Опис	Рекомендовані дії
500	Не класифікована помилка	У випадку, якщо Ви отримали у тілі відповіді подібний текст “Internal Server Error. Channel ID: 45b696af”, то зверніться за допомогою до нашої тех. підтримки. Якщо Ви отримали інший текст помилки, то прочитайте її і спробуйте зрозуміти. В багатьох випадках, проблема буде описана.
502	Сервер не відповідає	Перевірте ваше інтернет з’єднання. Якщо все гаразд, то спробуйте повторити раніше надісланий запит.
504	Тайм-аут отримання відповіді з сервера	У випадку надсилання запиту, що змінює дані (наприклад, підписання документа) ми рекомендуємо перевіряти виконання попереднього запиту (наприклад, чи був доданий підпис). З затримкою в 5 секунд надішліть запит для перевірки виконання Вашого попереднього запиту. Якщо Ваш попередній запит не виконався з будь-яких причин, повторіть його.
520	Сервісна помилка	Запит не був опрацьований нашими серверами. З затримкою в 5 секунд, повторіть Ваш запит.
521	Сервісна помилка	Запит не був опрацьований нашими серверами. З затримкою в 5 секунд, повторіть Ваш запит.
522	Сервісна помилка	Запит не був опрацьований нашими серверами. З затримкою в 5 секунд, повторіть Ваш запит.
523	Сервісна помилка	Запит не був опрацьований нашими серверами. З затримкою в 5 секунд, повторіть Ваш запит.
524	Сервісна помилка	Запит не був опрацьований нашими серверами. З затримкою в 5 секунд, повторіть Ваш запит.
525	Сервісна помилка	Запит не був опрацьований нашими серверами. З затримкою в 5 секунд, повторіть Ваш запит.
526	Сервісна помилка	Запит не був опрацьований нашими серверами. З затримкою в 5 секунд, повторіть Ваш запит.

Е-Сертифікати

Е-ТТН (ТТН v2)

Підказка

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

Метод	URL запиту	Опис
POST	/api/authorization/hash	Авторизація
GET	/api/auth_check	Перевірка активності сесії

Метод	URL запиту	Опис
POST	/api/ettn/eds/ettn/consignor	Створення чернетки нової е-ТТН
POST	/api/ettn/eds/doc/v2/xml	Створення XML документа для подальшого підписання
GET	/api/ettn/v2/eds/doc/body /api/ettn/doc/xml	Отримання (завантаження) документа сервісу «ЕТТН» в JSON/XML/PDF/ZIP форматі Отримання (завантаження) документа сервісу «ЕТТН» в JSON/XML/PDF/ZIP форматі
POST	/api/ettn/eds/doc/xml/v2/sign	Підписання даних сервісу «ЕТТН» (збереження підпису)
PATCH	/api/ettn/eds/doc/read	Відмітити документ, як «прочитаний»
GET	/api/ettn/v2/eds/doc/body/final	Отримання фінальної версії е-ТТН (разом зі змінами, що були внесені актами)
POST	/api/ettn/v2/eds/doc/processing_status	Відправка статуса обробки документа ТТН

Метод	URL запиту	Опис
POST	/api/ettn/eds/doc/attachment	Створення вкладення до документа
GET	/api/ettn/eds/doc/attachment	Отримання вкладення документа сервісу «ЕТТН»
DELETE	/api/ettn/eds/doc/attachment	Видалення вкладення документа сервісу «ЕТТН»
POST	/api/ettn/eds/booking	Створення/редагування чернетки «Заявка на транспортування»
POST	/api/ettn/eds/booking/confirmation	Створення/редагування чернетки «Підтвердження транспортування»
POST	/api/ettn/eds/acceptance	Створення/редагування чернетки «Акта приймання-передавання»
POST	/api/ettn/eds/discrepancy	Створення/редагування чернетки «Акта розбіжностей»
POST	/api/ettn/eds/completion	Створення/редагування чернетки «Акта виконаних робіт»
PATCH	/api/ettn/eds/doc/from_draft	Створення документу еТТН на основі чернетки, створеної контрагентом
PATCH	/api/ettn/eds/doc/send	Відправка документа сервісу «ЕТТН» з Чернеток
PATCH	/api/ettn/eds/docs	Видалення документів сервісу «ЕТТН» з «Чернеток»
PATCH	/api/ettn/eds/doc/clone	Створити копію документа сервісу «ЕТТН» / Замінити документ е-ТТН
GET	/api/ettn/eds/doc	Отримання документа сервісу «ЕТТН»
GET	/api/ettn/eds/chain	Отримання ланцюжка документів сервісу «ЕТТН» по id ланцюжка чи id документа
GET	/api/ettn/eds/doc/body	Отримання тіла документа сервісу «ЕТТН» в json форматі
GET	/api/ettn/eds/doc/signers	Отримання даних підписантів документа сервісу «ЕТТН»
GET	/api/ettn/eds/doc/links	Отримання пов’язаних документів сервісу «ETTN»
GET	/api/ettn/eds/doc/xml/ticket	Отримання даних документа сервісу «ЕТТН» для підписання
GET	/api/ettn/eds/doc/tickets	Отримання всіх квитанцій вказаного документа
PATCH	/api/ettn/eds/doc/confirm	Підтвердити документ сервісу «ЕТТН»
PUT	/api/ettn/eds/doc/reject	Відмовити в підписанні документа сервісу «ЕТТН»
POST	/api/ettn/eds/chains/search	Отримання списку ланцюжків документів сервісу «ЕТТН»
POST	/api/ettn/eds/docs/search	Отримання списку документів сервісу «ЕТТН»
POST	/api/ettn/eds/doc/xml/sign	Підписання даних сервісу «ЕТТН»
PATCH	/api/ettn/eds/chains/archive	Заархівувати всі документи у вказаному ланцюжку
POST	/api/ettn/eds/doc/comment	Додати коментар до документа сервісу «ЕТТН»
GET	/api/ettn/eds/doc/comments	Отримання коментарів до документу сервісу «ЕТТН»

Метод	URL запиту	Опис
POST	/api/ettn/eds/reload	Створення/редагування чернетки «Акта перевантаження»
POST	/api/ettn/eds/disagreement	Створення/редагування чернетки «Акта розбіжностей» до е-ТТН
POST	/api/ettn/eds/warehouse_change	Створення/редагування чернетки «Акта про заміну пункту призначення вантажу» до е-ТТН
POST	/api/ettn/eds/adjustment	Створення/редагування чернетки «Акта коригування» до е-ТТН
POST	/api/ettn/eds/act/xml	Створення XML Акта для подальшого підписання
POST	/api/ettn/eds/act/sign	Підписання «Акта»
PATCH	/api/ettn/eds/act/send	Відправка «Акта»
PUT	/api/ettn/eds/act/reject	Відхилити «Акт»

Метод	URL запиту	Опис
POST	/api/oas/v2/exdata	Отримання даних компанії, співробітників, адрес з довідників сервісу «ЕТТН»
GET	/api/oas/v2/company/search	Отримання даних про компанію за назвою / ІНН / ЄДРПОУ
GET	/api/oas/v2/company/employees/search	Отримання даних співробіника компанії за прізвищем / ІПН / номером посвідчення водія
GET	/api/oas/v2/company/addresses/search	Отримання адреси з довідника компанії за назвою / містом / вулицею / кодом КОАТУУ / кодом КАТОТТГ
GET	/api/oas/v2/katottg/search	Отримання данних КАТОТТГ за кодом / назвою населеного пункту
GET	/api/oas/v2/company	Отримання даних про компанію по ідентифікатору компанії
GET	/api/oas/invitation	Отримання запрошення для незареєстрованого користувача в сервісі ЕТТН
PUT	/api/oas/v2/employee	Створення співробітника
PUT	/api/oas/v2/employee/join/company	Приєднання/від’єднання співробітника до/від компанії
PUT	/api/oas/v2/employee/update	Оновлення даних співробітника

Код відповіді	Індекс	Опис
400	ERR_TTN-1	Setup document number [%s] Заповніть номер документу [%s]
400	ERR_TTN-2	Setup document date [%s] Заповніть дату документу [%s]
400	ERR_TTN-3	Setup reference to ettn Заповніть посилання на ТТН
400	ERR_TTN-4	[%s] is not filled in gln [%s] [%s] не заповнено в gln [%s]
400	ERR_TTN-5	Field [id.value] in trade party for role [%s] is not filled Поле [id.value] учасника ролі [%s] не заповнено
400	ERR_TTN-6	field [%s] is not filled Поле [%s] не заповнене
400	ERR_TTN-7	Unknown initiator Невідомий ініціатор
400	ERR_TTN-8	Unknown carrier Невідомий перевізник
400	ERR_TTN-8	Unknown carrier [%s] Невідомий перевізник [%s]
400	ERR_TTN-9	Unknown unload storage Невідомий склад розвантаження
400	ERR_TTN-10	Unknown load storage Невідомий склад навантаження
400	ERR_TTN-11	Unknown consignor Невідомий вантажовідправник
400	ERR_TTN-11	Unknown consignor [%s] Невідомий вантажовідправник [%s]
400	ERR_TTN-12	Unknown consignee Невідомий вантажоотримувач
400	ERR_TTN-12	Unknown consignee [%s] Невідомий вантажоотримувач [%s]
400	ERR_TTN-13	Unknown customer Невідомий замовник
400	ERR_TTN-13	Unknown customer [%s] Невідомий замовник [%s]
400	ERR_TTN-14	Unknown new consignee Невідомий новий вантажоотримувач
400	ERR_TTN-14	Unknown new consignee [%s] Невідомий новий вантажоотримувач [%s]
400	ERR_TTN-15	Unknown new carrier Невідомий новий перевізник
400	ERR_TTN-15	Unknown new carrier [%s] Невідомий новий перевізник [%s]
400	ERR_TTN-16	Unknown driver Невідомий водій
400	ERR_TTN-17	Unknown new driver Невідомий новий водій
400	ERR_TTN-18	Unknown initiator gln [%s] Невідомий ініціатор gln [%s]
400	ERR_TTN-19	Failed to determine gln for trade party [%s] Не вдалося визначити gln для учасника [%s]
400	ERR_TTN-20	Failed to determine gln for driver [%s] Не вдалося визначити gln для водія [%s]
400	ERR_TTN-21	Failed to determine trading party for gln [%s] Не вдалося визначити учасника для gln [%s]
400	ERR_TTN-22	Unknown gln [%s] for tradeParty with role: [%s], and name [%s] Невідомий gln [%s] для учасника з роллю: [%s] і назвою [%s]
400	ERR_TTN-23	gln [%s] is not driver gln gln [%s] не є gln-ом водія
400	ERR_TTN-24	Incorrect driver TIN in field [taxRegistration.id], expected [%s] Неправильний ІПН водія в полі [taxRegistration.id], очікується [%s]
400	ERR_TTN-25	Edrpou [%s] in gln [%s] and document [%s] are different ЄДРПОУ [%s] в gln [%s] та документі [%s] відрізняються
400	ERR_TTN-26	TIN [%s] in gln [%s] and document [%s] are different ІПН [%s] в gln [%s] та документі [%s] відрізняються
400	ERR_TTN-27	Parent ettn not found Документ підстава (ТТН) не знайдено
400	ERR_TTN-28	Parent storage delivery doc not found Документ підстава (акт розвантаження на проміжному складі) не знайдено
400	ERR_TTN-29	Parent TTN has incorrect status Документ підстава (ТТН) має некоректний статус
400	ERR_TTN-30	TTN status «ONSTORAGE» can be changed automatically only after the completion of the life cycle of the storage pick up act or the stop TTN act Статус ТТН «ONSTORAGE» може бути змінено автоматично лише після завершення життєвого циклу акта завантаження на складі або акту зупинки ТТН
400	ERR_TTN-31	Work with TTN is temporarily unavailable. Due to the unfinished process of working with the act [%s] to this TTN. Wait for the completion of work on it. Робота з ТТН тимчасово недоступна. У зв’язку з незавершеним процесом роботи з актом [%s] до цієї ТТН. Дочекайтеся завершення роботи над ним.
400	ERR_TTN-32	We have already created a new transaction for TTN. Please use API method GET, «/api/eds/doc/ettn/body» for receiving this new transaction. Ми вже створили нову транзакцію для ТТН. Будь ласка, використовуйте метод API GET, «/api/eds/doc/ettn/body» для отримання цієї нової транзакції.
400	ERR_TTN-33	Key blocked. EDRPOU/TIN mismatch. Ключ заблоковано. Невідповідність ЄДРПОУ/ІПН.
400	ERR_TTN-34	No signature content created. Resave document Вміст для підписання не створено. Збережіть документ повторно
400	ERR_TTN-35	sign_hash is broken, resave document невідповідний sign_hash, повторно збережіть документ
400	ERR_TTN-36	The document cannot be signed only with the stamp. Sign the document with your signature. Документ не може бути підписаний лише печаткою. Підпишіть документ своїм підписом.
400	ERR_TTN-37	Setup correct content type in request. Use „application/json“ or „application/xml“ Вкажіть content type в запиті. Використовуйте «application/json» або «application/xml».
400	ERR_TTN-38	Action not available. Дія недоступна.
400	ERR_TTN-39	Document not found Документ не знайдено
400	ERR_TTN-40	The required ticket was not found Необхідна квитанція не знайдена
400	ERR_TTN-41	The company role specified in the URL parameter does not match the role of this company in the document structure Вказана в URL-параметрі роль компанії не відповідає ролі цієї компанії в структурі документа
400	ERR_TTN-42	Unknown or unsupported doc type. Невідомий або непідтримуваний тип документа.
400	ERR_TTN-43	Mintrans status error. expected: [%s], actual: [%s] Невідповідність статусу від Мінтранс. Очікуваний [%s], фактичний [%s].
400	ERR_TTN-44	Invalid initiator role Некоректна роль ініціатора
400	ERR_TTN-45	Act for TTN is in process Присутній незавершений акт до ТТН
400	ERR_TTN-46	«template_doc_uuid» and «doc_uuid» parameters cannot be set at the same time Параметри «template_doc_uuid» і «doc_uuid» не можна встановити одночасно
400	ERR_TTN-47	Incorrect doc status Неправильний статус документа
400	ERR_TTN-48	Unknown or unsupported role_code [%s] Невідомий або непідтримуваний role_code [%s]
400	ERR_TTN-49	Unsupported format [%s] Непідтримуваний формат [%s]
400	ERR_TTN-50	Unsupported response_type [%s] Непідтримуваний response_type [%s]
400	ERR_TTN-50	Unsupported %s [%s] Непідтримуваний %s [%s]
400	ERR_TTN-51	Detect sub_status error. Current sub_status: [%s] Некоректний сабстатус. Поточний сабстатус: [%s]
400	ERR_TTN-51	Detect sub_status error. Current sub_status: [%s], allowed sub_statuses: [%s] Некоректний сабстатус. Поточний сабстатус: [%s], допустимі статуси: [%s]
400	ERR_TTN-52	Act is completed Акт завершено
400	ERR_TTN-53	Delivery is completed Поставку завершено
400	ERR_TTN-54	Incorrect attachment type: [%s] one of: [%s] expected Неправильний тип вкладення: [%s] очікується один із: [%s].
400	ERR_TTN-55	Unsupported file type [%s] Непідтримуваний тип файлу [%s].
400	ERR_TTN-56	Expected 1 file in multipart/form data Очікується 1 файл у multipart/form data
400	ERR_TTN-57	Attachment not found Вкладення не знайдено
400	ERR_TTN-58	The list of participants in the basis document does not correspond to the list of participants in the current document Перелік учасників документа підстави не відповідає переліку учасників поточного документа
400	ERR_TTN-59	MINTRANS_ERROR: [%s] Помилка від Мінтранс: [%s]
400	ERR_TTN-60	Fail to parse content in field [%s] Не вдалося опрацювати контент у полі [%s]
400	ERR_TTN-61	INVALID_SIGN_FORMAT, CADES_X_LONG is expected Некоректний формат підпису, допустимий лише CADES_X_LONG
400	ERR_TTN-62	Gln for address [%s] not found Не вдалося визначити gln для адреси [%s]
400	ERR_TTN-63	katottg [%s] in gln [%s] and document [%s] are different катоттг [%s] в gln [%s] та документі [%s] відрізняються
400	ERR_TTN-64	Signs not found В документі відсутні підписи
400	ERR_TTN-66	Setup correct content type in request. Use „application/xml“ Вкажіть content type в запиті. Використовуйте «application/xml».
400	ERR_TTN-67	xml body is not canonical or invalid xml тіло не канонізоване або некоректне
400	ERR_TTN-68	Validation document errors: [%s] Документ містить помилки: [%s]
400	ERR_TTN-69	XSD Validation document error: [%s] Помилка валідації документа за XSD: [%s]
400	ERR_TTN-70	No person with the driver’s TIN was found among the responsible persons of the carrier Серед відповідальних осіб перевізника не знайдено особу з ІПН водія
400	ERR_TTN-71	TTN data has been changed Дані ТТН було змінено
400	ERR_TTN-72	empty link doc list Порожній список документів
400	ERR_TTN-73	The limit of the number of linked documents has been exceeded. Limit: [%s] Перевищено ліміт кількості пов’язаних документів. Ліміт: [%s]
400	ERR_TTN-74	Incorrect list uuid of documents Некоректний список uuid-ів документів
400	ERR_TTN-75	Errors found when checking documents: [%s] Знайдені помилки при перевірці документів: [%s]
400	ERR_TTN-76	Signs is invalid: [%s] Помилка при перевірці підпису: [%s]
400	ERR_TTN-77	EDRPOU from sign: [%s] is not equals gln EDRPOU: [%s] ЄДРПОУ з підписа: [%s] не відповідає ЄДРПОУ з глн: [%s]
400	ERR_TTN-78	It is not possible to generate a new bill of lading with the same data of ORDER_NO, ORDER_DATE, DELIVERY_NOTE_NO, DELIVERY_NOTE_DATE according to the settings of the consignee Неможливо створити нову накладну з тими самими даними ORDER_NO, ORDER_DATE, DELIVERY_NOTE_NO, DELIVERY_NOTE_DATE відповідно до налаштувань одержувача
400	ERR_TTN-79	Unknown performer Невідомий виконавець
400	ERR_TTN-80	Key blocked. Key is not on secure media Ключ заблоковано. Ключ знаходиться на незахищеному носії
400	ERR_TTN-82	Key blocked. Signer position is required Ключ заблоковано. Наявність посади підписанта обов’язкова
400	ERR_TTN-83	Company not found by code: [%s] За кодом [%s] компанія не знайдена
400	ERR_TTN-84	Document body not found or not created, try to resave document Тіло документа не знайдено або ще не створено, спробуйте повторно зберегти документ
400	ERR_TTN-85	Setup url params: [%s] Вкажіть url-параметри: [%s]
400	ERR_TTN-86	Request body is empty or invalid Тіло запиту порожнє або некоректне
400	ERR_TTN-88	Document is not signed Документ не підписаний
400	ERR_TTN-89	Completed doc [%s] for parent eTTN already exists Для документа підстави (ТТН) вже зареєстровано документ: [%s]
400	ERR_TTN-90	Unsupported status [%s], one of [%s] is expected Некоректний статус [%s]. Очікується один з наступних: [%s]
400	ERR_TTN-91	Confirm document error Помилка при підтвердження документа
400	ERR_TTN-92	Reject document error Помилка при відхиленні документа
400	ERR_TTN-93	Company not found for this user Не знайдено компанію для поточного юзера
400	ERR_TTN-94	No supported documents Відсутні підтримувані документи

Код помилки	Опис	Рекомендовані дії
500	Не класифікована помилка	У випадку, якщо Ви отримали у тілі відповіді подібний текст “Internal Server Error. Channel ID: 45b696af”, то зверніться за допомогою до нашої тех. підтримки. Якщо Ви отримали інший текст помилки, то прочитайте її і спробуйте зрозуміти. В багатьох випадках, проблема буде описана.
502	Сервер не відповідає	Перевірте ваше інтернет з’єднання. Якщо все гаразд, то спробуйте повторити раніше надісланий запит.
504	Тайм-аут отримання відповіді з сервера	У випадку надсилання запиту, що змінює дані (наприклад, підписання документа) ми рекомендуємо перевіряти виконання попереднього запиту (наприклад, чи був доданий підпис). З затримкою в 5 секунд надішліть запит для перевірки виконання Вашого попереднього запиту. Якщо Ваш попередній запит не виконався з будь-яких причин, повторіть його.
520	Сервісна помилка	Запит не був опрацьований нашими серверами. З затримкою в 5 секунд, повторіть Ваш запит.
521	Сервісна помилка	Запит не був опрацьований нашими серверами. З затримкою в 5 секунд, повторіть Ваш запит.
522	Сервісна помилка	Запит не був опрацьований нашими серверами. З затримкою в 5 секунд, повторіть Ваш запит.
523	Сервісна помилка	Запит не був опрацьований нашими серверами. З затримкою в 5 секунд, повторіть Ваш запит.
524	Сервісна помилка	Запит не був опрацьований нашими серверами. З затримкою в 5 секунд, повторіть Ваш запит.
525	Сервісна помилка	Запит не був опрацьований нашими серверами. З затримкою в 5 секунд, повторіть Ваш запит.
526	Сервісна помилка	Запит не був опрацьований нашими серверами. З затримкою в 5 секунд, повторіть Ваш запит.