Skip to main content

Робота з актами до e-TTH

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

Створення/редагування чернетки «Акт коригування»

POST /api/eds/doc/ettn/adjustment

 

Вибір дії (створення чи редагування) визначається параметрами запиту:

  • якщо в URL присутній ідентифікатор документа (doc_uuid), відбувається редагування документа сервісу «ETTN» з указаним Id;

  • якщо параметр doc_uuid відсутній, створюється новий документ, тип якого задається в URL.

REQUEST

URL

https://edo-v2.edin.ua

Метод запиту

POST

URL запиту

/api/eds/doc/ettn/adjustment

URL параметри

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

doc_uuid (опціонально) UUID - ідентифікатор документа (передається для редагування (оновлення) даних раніше створеного документа)

new_doc_uuid (опціонально) UUID - ідентифікатор створюваного документа (може передаватись і бути назначеним при створенні документа зі сторони Вашого клієнта)

Headers

 

Authorization

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

Content-Type

application/json or application/xml

REQUEST

 

JSON Body

В тілі запиту методу передається тіло документа Акта коригування в форматі json чи xml залежно від Content-Type. Важливо: в тілі Акта має передаватись ідентифікатор (guid) е-ТТН (детальніше за посиланням вище).

RESPONSE

В тілі відповіді (json) передається doc_uuid - унікальний ідентифікатор документа на платформі

{"doc_uuid":"6cd39021-bb80-4eb6-a6f9-03f76a2a9d54"}

Створення/редагування чернетки «Акт про заміну пункту призначення вантажу»

POST /api/eds/doc/ettn/consignee_change

 

 

Вибір дії (створення чи редагування) визначається параметрами запиту:

  • якщо в URL присутній ідентифікатор документа (doc_uuid), відбувається редагування документа сервісу «ETTN» з указаним Id;

  • якщо параметр doc_uuid відсутній, створюється новий документ, тип якого задається в URL.

REQUEST

URL

https://edo-v2.edin.ua

Метод запиту

POST

URL запиту

/api/eds/doc/ettn/consignee_change

URL параметри

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

doc_uuid (опціонально) UUID - ідентифікатор документа (передається для редагування (оновлення) даних раніше створеного документа)

new_doc_uuid (опціонально) UUID - ідентифікатор створюваного документа (може передаватись і бути назначеним при створенні документа зі сторони Вашого клієнта)

Headers

 

Authorization

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

Content-Type

application/json or application/xml

REQUEST

 

JSON Body

В тілі запиту методу передається тіло документа Акта про заміну пункту призначення вантажу в форматі json чи xml залежно від Content-Type. Важливо: в тілі Акта має передаватись ідентифікатор (guid) е-ТТН (детальніше за посиланням вище).

RESPONSE

В тілі відповіді (json) передається doc_uuid - унікальний ідентифікатор документа на платформі

{"doc_uuid":"6cd39021-bb80-4eb6-a6f9-03f76a2a9d54"}

Створення/редагування чернетки «Акт розбіжностей про вантаж»

POST /api/eds/doc/ettn/disagreement

 

 

Вибір дії (створення чи редагування) визначається параметрами запиту:

  • якщо в URL присутній ідентифікатор документа (doc_uuid), відбувається редагування документа сервісу «ETTN» з указаним Id;

  • якщо параметр doc_uuid відсутній, створюється новий документ, тип якого задається в URL.

REQUEST

URL

https://edo-v2.edin.ua

Метод запиту

POST

URL запиту

/api/eds/doc/ettn/disagreement

URL параметри

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

doc_uuid (опціонально) UUID - ідентифікатор документа (передається для редагування (оновлення) даних раніше створеного документа)

new_doc_uuid (опціонально) UUID - ідентифікатор створюваного документа (може передаватись і бути назначеним при створенні документа зі сторони Вашого клієнта)

Headers

 

Authorization

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

Content-Type

application/json or application/xml

REQUEST

 

JSON Body

В тілі запиту методу передається тіло документа Акта розбіжностей про вантаж в форматі json чи xml залежно від Content-Type. Важливо: в тілі Акта має передаватись ідентифікатор (guid) е-ТТН (детальніше за посиланням вище).

RESPONSE

В тілі відповіді (json) передається doc_uuid - унікальний ідентифікатор документа на платформі

{"doc_uuid":"6cd39021-bb80-4eb6-a6f9-03f76a2a9d54"}

Створення/редагування чернетки «Акт про відмову вантажити до e-TTN»

POST /api/eds/doc/ettn/load_reject

 

 

Вибір дії (створення чи редагування) визначається параметрами запиту:

  • якщо в URL присутній ідентифікатор документа (doc_uuid), відбувається редагування документа сервісу «ETTN» з указаним Id;

  • якщо параметр doc_uuid відсутній, створюється новий документ, тип якого задається в URL.

REQUEST

URL

https://edo-v2.edin.ua

Метод запиту

POST

URL запиту

/api/eds/doc/ettn/load_reject

URL параметри

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

doc_uuid (опціонально) UUID - ідентифікатор документа (передається для редагування (оновлення) даних раніше створеного документа)

new_doc_uuid (опціонально) UUID - ідентифікатор створюваного документа (може передаватись і бути назначеним при створенні документа зі сторони Вашого клієнта)

Headers

 

Authorization

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

Content-Type

application/json or application/xml

REQUEST

 

JSON Body

В тілі запиту методу передається тіло документа Акта про відмову вантажити в форматі json чи xml залежно від Content-Type. Важливо: в тілі Акта має передаватись ідентифікатор (guid) е-ТТН (детальніше за посиланням вище).

RESPONSE

В тілі відповіді (json) передається doc_uuid - унікальний ідентифікатор документа на платформі

{"doc_uuid":"6cd39021-bb80-4eb6-a6f9-03f76a2a9d54"}

Створення/редагування чернетки «Акт перевантаження до e-TTN»

POST /api/eds/doc/ettn/reload

 

 

Вибір дії (створення чи редагування) визначається параметрами запиту:

  • якщо в URL присутній ідентифікатор документа (doc_uuid), відбувається редагування документа сервісу «ETTN» з указаним Id;

  • якщо параметр doc_uuid відсутній, створюється новий документ, тип якого задається в URL.

REQUEST

URL

https://edo-v2.edin.ua

Метод запиту

POST

URL запиту

/api/eds/doc/ettn/reload

URL параметри

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

doc_uuid (опціонально) UUID - ідентифікатор документа (передається для редагування (оновлення) даних раніше створеного документа)

new_doc_uuid (опціонально) UUID - ідентифікатор створюваного документа (може передаватись і бути назначеним при створенні документа зі сторони Вашого клієнта)

Headers

 

Authorization

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

Content-Type

application/json or application/xml

REQUEST

 

JSON Body

В тілі запиту методу передається тіло документа Акта перевантаження в форматі json чи xml залежно від Content-Type. Важливо: в тілі Акта має передаватись ідентифікатор (guid) е-ТТН (детальніше за посиланням вище).

RESPONSE

В тілі відповіді (json) передається doc_uuid - унікальний ідентифікатор документа на платформі

{"doc_uuid":"6cd39021-bb80-4eb6-a6f9-03f76a2a9d54"}

Створення/редагування чернетки «Акт перепломбування до e-TTN»

POST /api/eds/doc/ettn/resealing

 

Вибір дії (створення чи редагування) визначається параметрами запиту:

  • якщо в URL присутній ідентифікатор документа (doc_uuid), відбувається редагування документа сервісу «ETTN» з указаним Id;

  • якщо параметр doc_uuid відсутній, створюється новий документ, тип якого задається в URL.

REQUEST

URL

https://edo-v2.edin.ua

Метод запиту

POST

URL запиту

/api/eds/doc/ettn/resealing

URL параметри

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

doc_uuid (опціонально) UUID - ідентифікатор документа (передається для редагування (оновлення) даних раніше створеного документа)

new_doc_uuid (опціонально) UUID - ідентифікатор створюваного документа (може передаватись і бути назначеним при створенні документа зі сторони Вашого клієнта)

Headers

 

Authorization

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

Content-Type

application/json or application/xml

REQUEST

 

JSON Body

В тілі запиту методу передається тіло документа Акта перепломбування в форматі json чи xml залежно від Content-Type. Важливо: в тілі Акта має передаватись ідентифікатор (guid) е-ТТН (детальніше за посиланням вище).

RESPONSE

В тілі відповіді (json) передається doc_uuid - унікальний ідентифікатор документа на платформі

{"doc_uuid":"6cd39021-bb80-4eb6-a6f9-03f76a2a9d54"}

Створення/редагування чернетки «Акт примусового завершення e-TTN»

POST /api/eds/doc/ettn/stop

 

 

Вибір дії (створення чи редагування) визначається параметрами запиту:

  • якщо в URL присутній ідентифікатор документа (doc_uuid), відбувається редагування документа сервісу «ETTN» з указаним Id;

  • якщо параметр doc_uuid відсутній, створюється новий документ, тип якого задається в URL.

REQUEST

URL

https://edo-v2.edin.ua

Метод запиту

POST

URL запиту

/api/eds/doc/ettn/stop

URL параметри

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

doc_uuid (опціонально) UUID - ідентифікатор документа (передається для редагування (оновлення) даних раніше створеного документа)

new_doc_uuid (опціонально) UUID - ідентифікатор створюваного документа (може передаватись і бути назначеним при створенні документа зі сторони Вашого клієнта)

Headers

 

Authorization

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

Content-Type

application/json or application/xml

REQUEST

 

JSON Body

В тілі запиту методу передається тіло документа Акта примусового завершення е-ТТН у форматі json чи xml залежно від Content-Type. Важливо: в тілі Акта має передаватись ідентифікатор (guid) е-ТТН (детальніше за посиланням вище).

RESPONSE

В тілі відповіді (json) передається doc_uuid - унікальний ідентифікатор документа на платформі

{"doc_uuid":"6cd39021-bb80-4eb6-a6f9-03f76a2a9d54"}

Створення/редагування чернетки «Акт розвантаження на проміжному складі до e-TTN»

POST /api/eds/doc/ettn/storage_delivery

 

 

Вибір дії (створення чи редагування) визначається параметрами запиту:

  • якщо в URL присутній ідентифікатор документа (doc_uuid), відбувається редагування документа сервісу «ETTN» з указаним Id;

  • якщо параметр doc_uuid відсутній, створюється новий документ, тип якого задається в URL.

REQUEST

URL

https://edo-v2.edin.ua

Метод запиту

POST

URL запиту

/api/eds/doc/ettn/storage_delivery

URL параметри

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

doc_uuid (опціонально) UUID - ідентифікатор документа (передається для редагування (оновлення) даних раніше створеного документа)

new_doc_uuid (опціонально) UUID - ідентифікатор створюваного документа (може передаватись і бути назначеним при створенні документа зі сторони Вашого клієнта)

Headers

 

Authorization

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

Content-Type

application/json or application/xml

REQUEST

 

JSON Body

В тілі запиту методу передається тіло документа Акта розвантаження на проміжному складі в форматі json чи xml залежно від Content-Type. Важливо: в тілі Акта має передаватись ідентифікатор (guid) е-ТТН (детальніше за посиланням вище).

RESPONSE

В тілі відповіді (json) передається doc_uuid - унікальний ідентифікатор документа на платформі

{"doc_uuid":"6cd39021-bb80-4eb6-a6f9-03f76a2a9d54"}

Створення/редагування чернетки «Акт завантаження на проміжному складі до e-TTN»

POST /api/eds/doc/ettn/storage_pickup

 

Вибір дії (створення чи редагування) визначається параметрами запиту:

  • якщо в URL присутній ідентифікатор документа (doc_uuid), відбувається редагування документа сервісу «ETTN» з указаним Id;

  • якщо параметр doc_uuid відсутній, створюється новий документ, тип якого задається в URL.

REQUEST

URL

https://edo-v2.edin.ua

Метод запиту

POST

URL запиту

/api/eds/doc/ettn/storage_pickup

URL параметри

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

doc_uuid (опціонально) UUID - ідентифікатор документа (передається для редагування (оновлення) даних раніше створеного документа)

new_doc_uuid (опціонально) UUID - ідентифікатор створюваного документа (може передаватись і бути назначеним при створенні документа зі сторони Вашого клієнта)

Headers

 

Authorization

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

Content-Type

application/json or application/xml

REQUEST

 

JSON Body

В тілі запиту методу передається тіло документа Акта завантаження на проміжному складі в форматі json чи xml залежно від Content-Type. Важливо: в тілі Акта має передаватись ідентифікатор (guid) е-ТТН (детальніше за посиланням вище).

RESPONSE

В тілі відповіді (json) передається doc_uuid - унікальний ідентифікатор документа на платформі

{"doc_uuid":"6cd39021-bb80-4eb6-a6f9-03f76a2a9d54"}

Створення/редагування нової транзакції (чернетки) до Актів сервісу

POST /api/eds/doc/ettn/act/transaction

При повторному виклику методу з тими самими URL-параметрами відбувається оновлення (перезапис) вже вкладеного контенту.

REQUEST

URL

https://edo-v2.edin.ua

Метод запиту

POST

URL запиту

/api/eds/doc/ettn/act/transaction

URL параметри

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

doc_uuid (обов’язково) UUID - ідентифікатор документа

Headers

 

Authorization

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

Content-Type

application/json або application/xml

REQUEST

 

JSON Body

В тілі запиту методу (в json/xml форматі) передається транзакція - контент документа без підписів (об’єкт EcmrAct)

RESPONSE

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

Після відпрацювання методу, та до надсилання транзакції, результат отримання документа сервісу матиме відмінність для інших контрагентів.

Надсилання нової транзакції до Актів сервісу

PUT /api/eds/doc/ettn/act/transaction
REQUEST

URL

https://edo-v2.edin.ua 

Метод запиту

PUT

URL запиту

/api/eds/doc/ettn/act/transaction

URL параметри

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

doc_uuid (обов’язково) UUID - ідентифікатор документа

Headers

 

Authorization

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

Content-Type

application/json або application/xml

RESPONSE

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

Відхилення Актів сервісу 

PUT /api/eds/doc/ettn/act/reject

Відхилення документа можливе лише щодо вхідного документа до моменту його підтвердження або підписання.

REQUEST

URL

https://edo-v2.edin.ua

Метод запиту

PUT

URL запиту

/api/eds/doc/ettn/act/reject

URL параметри

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

doc_uuid (обов’язково) UUID - ідентифікатор документа

rejected_by (обов’язково) String - ПІБ співробітника

Headers

 

Authorization

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

Content-Type

application/json

REQUEST

 

JSON Body

В тілі запиту методу (в json форматі) передається причина відхилення документа в текстовому вигляді.

RESPONSE

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

Надсилання Актів з Чернеток

PATCH /api/eds/doc/ettn/act/send

Метод призначений для надсилання нових документів, які вже підписані. У разі внесення змін чи доповнень, їх надсилання здійснюється через методи /api/eds/doc/ettn/act/transaction.

REQUEST

URL

https://edo-v2.edin.ua

Метод запиту

PATCH

URL запиту

/api/eds/doc/ettn/act/send

URL параметри

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

doc_uuid (обов’язково) UUID - ідентифікатор документа

Headers

 

Authorization

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

Content-Type

application/json

RESPONSE

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

При повторному виклику методу з тими самими URL-параметрами відбувається оновлення (перезапис) вже вкладеного контенту.