Skip to main content

Опис помилок сервісу e-TTН

ДляНа роботисторінці знаведено методамиопис користувачпомилок повиненсервісу бути«e-TTН». Опис загальних помилок для всіх сервісів EDIN доступний за авторизованимпосиланням.

ОтриманняОпис пов'язанихпомилок документівсервісу «Зведеної e-ТТН»
GET /api/eds/doc/ettn/ttn/link_docs

 

REQUEST

URLКод відповіді

https://edo-v2.edin.ua

Метод запиту

GETТекст помилки

Індекс

Опис

URL запиту400

/api/eds/doc/ettn/ttn/link_docsSETUP_DOC_NUMBER_ERROR

ERR_TTN-1

Setup document number [%s]

Заповніть номер документу [%s]

URL параметри400

glnSETUP_DOC_DATE_ERROR

(обов’язково) String -

ERR_TTN-2

GLN власної Компанії;

Setup document date [%s]

doc_uuidЗаповніть (обов’язково)дату UUIDдокументу - ідентифікатор документа «Зведена ТТН»[%s]

Headers

 

Authorization400

SIDSETUP_ETTN_REF_ERROR

- токен, отриманий

ERR_TTN-3

при авторизації

Setup reference to ettn

Заповніть посилання на ТТН

Content-Type400

EMPTY_GLN_FIELD_ERROR

ERR_TTN-4

[%s] is not filled in gln [%s]

[%s] не заповнено в gln [%s]

400

TRADE_PARTY_ID_NOT_FILED_ERROR

ERR_TTN-5

Field [id.value] in trade party for role [%s] is not filled

Поле [id.value] учасника ролі [%s] не заповнено

400

EMPTY_FIELD_ERROR

ERR_TTN-6

field [%s] is not filled

Поле [%s] не заповнене

400

UNKNOWN_INITIATOR_ERROR

ERR_TTN-7

Unknown initiator

Невідомий ініціатор

400

UNKNOWN_CARRIER_ERROR

ERR_TTN-8

Unknown carrier

Невідомий перевізник

400

UNKNOWN_UNLOAD_STORAGE

ERR_TTN-9

Unknown unload storage

Невідомий склад розвантаження

400

UNKNOWN_LOAD_STORAGE

ERR_TTN-10

Unknown load storage

Невідомий склад навантаження

400

UNKNOWN_CONSIGNOR_ERROR

ERR_TTN-11

Unknown consignor

Невідомий вантажовідправник

400

UNKNOWN_CONSIGNEE_ERROR

ERR_TTN-12

Unknown consignee

Невідомий вантажоотримувач

400

UNKNOWN_CUSTOMER_ERROR

ERR_TTN-13

Unknown customer

Невідомий замовний

400

UNKNOWN_NEW_CONSIGNEE_ERROR

ERR_TTN-14

Unknown new consignee

Невідомий новий вантажоотримувач

400

UNKNOWN_NEW_CARRIER_ERROR

ERR_TTN-15

Unknown new carrier

Невідомий новий перевізник

400

UNKNOWN_DRIVER_ERROR

ERR_TTN-16

Unknown driver

Невідомий водій

400

UNKNOWN_NEW_DRIVER_ERROR

ERR_TTN-17

Unknown new driver

Невідомий новий водій

400

UNKNOWN_INITIATOR_GLN_ERROR

ERR_TTN-18

Unknown initiator gln [%s]

Невідомий ініціатор gln [%s]

400

DETERMINE_GLN_ERROR

ERR_TTN-19

Failed to determine gln for trade party [%s]

Не вдалося визначити gln для учасника [%s]

400

DETERMINE_DRIVER_GLN_ERROR

ERR_TTN-20

Failed to determine gln for driver [%s]

Не вдалося визначити gln для водія [%s]

400

DETERMINE_TRADE_PARTY_ERROR

ERR_TTN-21

Failed to determine trading party for gln [%s]

Не вдалося визначити учасника для gln [%s]

400

GLN_TRADEPARTY_ERROR

ERR_TTN-22

Unknown gln [%s] for tradeParty with role: [%s], and name [%s]

Невідомий gln [%s] для учасника з роллю: [%s] і назвою [%s]

400

IS_NOT_DRIVER_GLN_ERROR

ERR_TTN-23

gln [%s] is not driver gln

gln [%s] не є gln-ом водія

400

INCORRECT_DRIVER_TIN

ERR_TTN-24

Incorrect driver TIN in field [taxRegistration.id], expected [%s]

Неправильний ІПН водія в полі [taxRegistration.id], очікується [%s]

400

EDRPOU_MISMATCH

ERR_TTN-25

Edrpou [%s] in gln [%s] and document [%s] are different

ЄДРПОУ [%s] в gln [%s] та документі [%s] відрізняються

400

TIN_MISMATCH

ERR_TTN-26

TIN [%s] in gln [%s] and document [%s] are different

ІПН [%s] в gln [%s] та документі [%s] відрізняються

400

PARENT_ETTN_NOT_FOUND_ERROR

ERR_TTN-27

Parent ettn not found

Документ підстава (ТТН) не знайдено

400

PARENT_STORAGE_DELIVERY_DOC_FOUND_ERROR

ERR_TTN-28

Parent storage delivery doc not found

Документ підстава (акт розвантаження на проміжному складі) не знайдено

400

PARENT_ETTN_STATUS_ERROR

ERR_TTN-29

Parent TTN has incorrect status

Документ підстава (ТТН) має некоректний статус

400

ETTN_ONSTORAGE_ERROR

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

ACT_IN_PROCESS_ERROR

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

WAITING_FOR_TTN_UPDATE_ERROR

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

KEY_BLOCKED_ERROR

ERR_TTN-33

Key blocked. EDRPOU/TIN mismatch.

Ключ заблоковано. Невідповідність ЄДРПОУ/ІПН.

400

CONTENT_FOR_SIGN_IS_NOT_CREATED_ERROR

ERR_TTN-34

No signature content created. Resave document

Вміст для підписання не створено. Збережіть документ повторно

400

SIGN_HASH_ERROR

ERR_TTN-35

sign_hash is broken, resave document

невідповідний sign_hash, повторно збережіть документ

400

ONLY_SIGNED_STAMP_ERROR

ERR_TTN-36

The document cannot be signed only with the stamp. Sign the document with your signature.

Документ не може бути підписаний лише печаткою. Підпишіть документ своїм підписом.

400

INCORRECT_CONTENT_TYPE_ERROR

ERR_TTN-37

Setup correct content type in request. Use „application/jsonjson“ or „application/xml“

Вкажіть content type в запиті. Використовуйте «application/json» або «application/xml».

400

ACTION_NOT_AVAILABLE

ERR_TTN-38

Action not available.

Дія недоступна.

400

DOCUMENT_NOT_FOUND_ERROR

ERR_TTN-39

Document not found

Документ не знайдено

400

TICKET_NOT_FOUND_ERROR

ERR_TTN-40

The required ticket was not found

Необхідна квитанція не знайдена

400

ROLE_MISMATCH_ERROR

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

UNSUPPORTED_DOC_TYPE_ERROR

ERR_TTN-42

Unknown or unsupported doc type.

Невідомий або непідтримуваний тип документа.

400

MINTRANS_STATUS_ERROR

ERR_TTN-43

Mintrans status error. expected: [%s], actual: [%s]

Невідповідність статусу від Мінтранс. Очікуваний [%s], фактичний [%s].

400

INITIATOR_ROLE_ERROR

ERR_TTN-44

Invalid initiator role

Некоректна роль ініціатора

400

TTN_ACT_INP_ROCESS_ERROR

ERR_TTN-45

Act for TTN is in process

Присутній незавершенний акт до ТТН

400

TEMPLATE_DOC_UUID_PARAMS_ERROR

ERR_TTN-46

"template_doc_uuid" and "doc_uuid" parameters cannot be set at the same time

Параметри "template_doc_uuid" і "doc_uuid" не можна встановити одночасно

400

INCORRECT_DOC_STATUS

ERR_TTN-47

Incorrect doc status

Неправильний статус документа

400

UNSUPPORTED_ROLE_CODE

ERR_TTN-48

Unknown or unsupported role_code [%s]

Невідомий або непідтримуваний role_code [%s]

400

UNSUPPORTED_FORMAT_ERROR

ERR_TTN-49

Unsupported format [%s]

Непідтримуваний формат [%s]

400

UNSUPPORTED_RESPONSE_TYPE_ERROR

ERR_TTN-50

Unsupported response_type [%s]

Непідтримуваний response_type [%s]

400

INCORRECT_SUBSTATUS_ERROR

ERR_TTN-51

Detect sub_status error. Current sub_status: [%s]

Некорекнтий сабстатус. Поточний сабстатус: [%s]

400

ACT_IS_COMPLETED_ERROR

ERR_TTN-52

Act is completed

Акт завершено

400

DELIVERY_COMPLETED_ERROR

ERR_TTN-53

Delivery is completed

Поставку завершено

400

ATTACHMENT_TYPE_ERROR

ERR_TTN-54

Incorrect attachment type: [%s] one of: [%s] expected

Неправильний тип вкладення: очікується [%s] один із: [%s].

400

ATTACHMENT_FILE_TYPE_ERROR

ERR_TTN-55

Unsupported file type [%s]

Непідтримуваний тип файлу [%s].

400

ATTACHMENT_FILE_COUNT_ERROR

ERR_TTN-56

Expected 1 file in multipart/form data

Очікується 1 файл у multipart/form data

400

ATTACHMENT_NOT_FOUND_ERROR

ERR_TTN-57

Attachment not found

Вкладення не знайдено

400

PARENT_DOC_PARTICIPANTS_MISMATCHED

ERR_TTN-58

The list of participants in the basis document does not correspond to the list of participants in the current document

Перелік учасників документа підстави не відповідає переліку учасників поточного документа

400

MINTRANS_ERROR

ERR_TTN-59

MINTRANS_ERROR: [%s]

Помилка від Мінтранс: [%s]

400

FAIL_TO_PARSE_CONTENT

ERR_TTN-60

Fail to parse content in field [%s]

Не вдалося опрацювати контент у полі [%s]

400

INVALID_SIGN_FORMAT_ERROR

ERR_TTN-61

INVALID_SIGN_FORMAT, CADES_X_LONG is expected

Некоректний форма підпису, допустимий лише CADES_X_LONG

400

GLN_ADDRESS_NOT_FOUND

ERR_TTN-62

Gln for address [%s] not found

Не вдалося визначити gln для адреси [%s]

400

KATOTTG_MISMATCH

ERR_TTN-63

katottg [%s] in gln [%s] and document [%s] are different

катоттг [%s] в gln [%s] та документі [%s] відрізняються

400

SIGN_CONTAINER_IS_EMPTY

ERR_TTN-64

Signs not found

В документі відсутні підписи

400

XSD_VALIDATION_ERROR

ERR_TTN-65

xsd validation error: [%s]

Помилка при валідації за xsd: [%s]

400

APPLICATION_XML_CONTENT_TYPE_EXPECTED

ERR_TTN-66

Setup correct content type in request. Use „application/xml“

Вкажіть content type в запиті. Використовуйте «application/xml».

400

XML_BODY_IS_NOT_CANONICAL

ERR_TTN-67

xml body is not canonical or invalid

xml тіло не канонізоване або некоректне

400

DOCUMENT_VALIDATION_ERROR

ERR_TTN-68

Validation document errors: [%s]

Документ містить помилки: [%s]

400

DOCUMENT_XSD_VALIDATION_ERROR

ERR_TTN-69

XSD Validation document error: [%s]

Помилка валідації документа за XSD: [%s]

400

DRIVER_RESP_PERSON_NTO_FOUND

ERR_TTN-70

No person with the driver’s TIN was found among the responsible persons of the carrier

Серед відповідальних осіб перевізника не знайдено особу з ІПН водія

400

EMPTY_LINK_DOC_LIST

ERR_TTN-72

empty link doc list

Порожній список документів

400

LINK_DOCS_LIMIT_EXCEEDED

ERR_TTN-73

The limit of the number of linked documents has been exceeded. Limit: [%s], 1

Перевищено ліміт кількості пов’язаних документів. Ліміт: [%s], 1

400

INCORRECT_LINKED_DOC_UUID_LIST

ERR_TTN-74

Incorrect list uuid of documents

Некоректний список uuid-ів документів

400

INCORRECT_LINK_DOCS_DATA

ERR_TTN-75

Errors found when checking documents: [%s], 1

Знайдені помилки при перевірці документів: [%s], 1

400

SIGN_ERROR

ERR_TTN-76

Signs is invalid: [%s], 1

Помилка при перевірці підпису: [%s], 1

400

SIGN_EDRPOU_MISMATCH_COMPANY_EDRPOU

ERR_TTN-77

EDRPOU from sign: [%s] is not equals gln EDRPOU: [%s], 2

ЄДРПОУ з підписа: [%s] не відповідає ЄДРПОУ з глн: [%s], 2

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_DATEaccording 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], companyCode

За кодом [%s] компанія не знайдена, companyCode

400

 

ERR_TTN-84

Document body not found or not created, try to resave document

Тіло документа не знайдено або ще не створено, спробуйте повторно зберегти документ

400

 

ERR_TTN-85

Setup url params: [%s], params

Вкажіть url-параметри: [%s], params

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

Відсутні підтримувані документи

400

 

ERR_TTN-95

Invalid format of transport id, only Latin uppercase letters and numbers are expected.

Некоректний формат транспортного засобу, очікуються лише латинські великі літери та цифри.

400

 

ERR_TTN-96

Some link docs has incorrect status

Деякі пов’язані документи знаходяться в некоректному статусі.

400

 

ERR_TTN-97

Katottg code for [%s] is required

КАТОТТГ для адреси [%s] є обов’язковим

400

 

ERR_TTN-98

Rejection unavailable after carrier signing

Відхилення неможливе після підписання перевізником

400

 

ERR_TTN-99

The signature is not available according to the recipient’s requirements

Підпис недоступний відповідно до вимог одержувача

400

 

ERR_TTN-100

It is not possible to create / send a new transaction to a document in Draft status

Неможливо створити / відправити нову транзакцію до документа в статусі Чернетка

400

 

ERR_TTN-101

Дія недоступна для поточної ролі учасника

Action not available for current party role

400

 

ERR_TTN-102

The action is not available for a document in draft status

Дія недоступна для документа в статусі чернетка

400

 

ERR_TTN-103

Field {field} has invalid value {value}

Поле {поле} має недопустиме значення {значення}

400

 

ERR_TTN-105

The action is not available. TTN lifecycle was terminated

Дія недоступна. Життєвий цикл ТТН було завершено

400

 

ERR_TTN-106

The action is not available. TTN lifecycle was terminated based on {doc name}

Дія недоступна. Життєвий цикл ТТН було завершено на підставі {назва документа}

500

Internal server error: sd898sdf63

 

Виникає в разі неможливості опрацювати запит (рекомендуємо звернутись до нашої технічної підтримки: support@edin.ua)

RESPONSE
Помилки,

Вщо тіліможуть відповідівиникнути вна jsonстороні форматі передається масив об’єктів з даними пов’язаних документів (об’єкт XDoc).

Прив'язка ТТН до «Зведеної ТТН»

POST /api/eds/doc/ettn/ttn/link_docs

 

 

Правила формування зв’язку між ТТН та «Зведеною ТТН»

    Унікальність зв’язку

      Одна ТТН може бути пов’язана лише з однією «Зведеною ТТН».

      Для створення нового зв’язку попередній необхідно розірвати.

      Умови формування зв’язку

        «Зведена ТТН» має перебувати у статусі «Чернетка».

        ТТН може перебувати в одному з допустимих статусів:

          OPEN (чернетка відправника) зі значенням ready_for_sign == 1 (готовий до підписання);

          SENT (відправлений відправником).

          Вимоги до узгодженості даних

            Поле carrier_uuid («Перевізник») у всіх пов’язаних ТТН має збігатися.

            Значення наступних додаткових полів у всіх ТТН повинні бути однаковими та відповідати даним «Зведеної ТТН»:

              consignee_uuid – Вантажоотримувач,

              consignor_uuid – Вантажовідправник,

              driver_uuid – Водій,

              load_place_uuid – Місце завантаження,

              delivery_place_uuid – Місце доставки.

              Обмеження

                До однієї «Зведеної ТТН» можна прив’язати не більше 100 ТТН документів.

                REQUESTЦБД

                URLКод відповіді

                https://edo-v2.edin.ua

                Метод запиту

                POSTКод помилки

                Опис

                URL запиту400

                /api/eds/doc/ettn/ttn/link_docs0

                Внутрішня помилка ЦБД

                URL параметри400

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

                doc_uuidНекоректно (обов’язково)сформований UUID - ідентифікатор документа «Зведена ТТН»запит

                Headers

                 

                Authorization400

                SID2

                - токен, отриманий

                Некоректний при авторизаціїтокен

                Content-Type400

                application/json4

                Некоректний тип транспортного засобу

                REQUEST

                 

                JSON Body400

                В тілі запиту методу (в json форматі) передається масив UUID-ів ТТН документів, що будуть пов’язані зі «Зведеною ТТН».

                Приклад запиту

                ["doc_uuid одиночної ТТН №1", "doc_uuid одиночної ТТН №2", "doc_uuid одиночної ТТН №3"]
                RESPONSE

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

                Видалення прив’язки ТТН до «Зведеної ТТН»

                DELETE /api/eds/doc/ettn/ttn/link_docs
                REQUEST

                URL

                https://edo-v2.edin.ua

                Метод запиту5

                DELETEНекоректна роль представника

                URL запиту400

                /api/eds/doc/ettn/ttn/link_docs6

                Об’єкт eTTN не знайдений

                URL параметри400

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

                doc_uuidНекоректний (обов’язково)перехід UUIDміж -станами ідентифікатор документа «Зведена ТТН»eTTN

                Headers

                 

                Authorization400

                SID9

                - токен, отриманий

                Завантаження приу авторизаціїпоточному стані не дозволене

                Content-Type400

                application/json10

                Об’єкт супровідного документу не знайдений

                REQUEST400

                11

                Запропонований тип супровідного документу відрізняється від поточного

                JSON Body400

                В12

                тілі запиту методу

                Некоректний перехід jsonміж форматі)станами передаєтьсясупровідних масивдокументів

                UUID-ів ТТН документів, що будуть

                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

                Невалідний токен для отримання документу

                Приклад запиту

                ["doc_uuid одиночної ТТН №1", "doc_uuid одиночної ТТН №2", "doc_uuid одиночної ТТН №3"]
                RESPONSE

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