Список eТТН
URI: /ettn
Використовується для отримання списку доступних eТТН.
Запит виконується методом GET у json форматі з даними.
Параметри запиту
| Ім'я | Тип | Обов. | Опис |
|---|---|---|---|
| offset | integer | Ні | Початковий номер, з якого необхідно виводити записи |
| limit | integer | Ні | Кількість рядків на сторінці |
Параметри відповіді
| Ім'я | Тип | Опис |
|---|---|---|
| ettns | list[object] | Список eТТН |
| ettns._id | object | |
| ettns._id.cbdEttnId | string | |
| ettns.ettnID | string | Ідентифікатор eТТН |
| ettns.document_data | object | Зміст документа |
| ettns.document_data. exchangedDocumentContext | Технічні дані | Технічні дані |
| ettns.document_data. exchangedDocumentContext.id | string | Код типу документа |
| ettns.document_data. exchangedDocumentContext.logisticName | string | Місце складання документа |
| ettns.document_data. exchangedDocumentContext.logisticDescription | string | Адреса місця складання документа |
| ettns.document_data. exchangedDocumentContext.transactionID | integer | |
| ettns.document_data. exchangedDocumentContext.businessProcess | string | |
| ettns.document_data. exchangedDocumentContext.guideline | string | |
| ettns.document_data. exchangedDocumentContext.hNum | string | |
| ettns.document_data. exchangedDocumentContext.dateTime | string | Дата і час складання документа |
| ettns.document_data. chainConsignment | object | Інформація про перевезення |
| ettns.document_data. chainConsignment.grossWeightUnitCode | string | Одиниця виміру ваги брутто (можливе тільки одне значення KGM) |
| ettns.document_data. chainConsignment.grossWeightMeasure | string | Маса брутто вантажу |
| ettns.document_data. chainConsignment.associatedInvoiceCurrencyID | string | Код одиниці виміру (UAH) |
| ettns.document_data. chainConsignment.associatedInvoiceAmount | string | Ціна без ПДВ за одиницю |
| ettns.document_data. chainConsignment.quantity | string | Загальна кількість місць вантажу (контейнерів) |
| ettns.document_data. consignorTradeParty | object | Вантажовідправник |
| ettns.document_data. consignorTradeParty.id | string | ЄДРПОУ/КАТОТТГ/РНОКПП/УКТЗЕД вантажовідправника |
| ettns.document_data. consignorTradeParty.schemeAgencyID | string | Назва ідентифікатора (ЄДРПОУ, КАТОТТГ, РНОКПП, УКТЗЕД) |
| ettns.document_data. consignorTradeParty.name | string | Ім'я вантажовідправника |
| ettns.document_data. consignorTradeParty.surname | string | Прізвище вантажовідправника |
| ettns.document_data. consignorTradeParty.patronymic | string | По батькові вантажовідправника |
| ettns.document_data. consignorTradeParty.roleCode | string | Роль учасника (Вантажовідправник - CZ) |
| ettns.document_data. consignorTradeParty.telephone | string | Основний телефон вантажовідправника |
| ettns.document_data. consignorTradeParty.mobile | string | Мобільний телефон вантажовідправника |
| ettns.document_data. consignorTradeParty.email | string | Електронна адреса вантажовідправника |
| ettns.document_data. consignorTradeParty.postCode | string | Поштовий індекс вантажовідправника |
| ettns.document_data. consignorTradeParty.street | string | Адреса (назва вулиці + номер будівлі) |
| ettns.document_data. consignorTradeParty.city | string | Місто (назва населеного пункту) |
| ettns.document_data. consignorTradeParty.countryID | string | Країна (UA) |
| ettns.document_data. consignorTradeParty.countryName | string | Назва країни |
| ettns.document_data. consignorTradeParty.taxRegistration | string | ЄДРПОУ підприємства, та/або РНОКПП всіх відповідальних осіб |
| ettns.document_data. consigneeTradeParty | object | Вантажоодержувач |
| ettns.document_data. consigneeTradeParty.schemeAgencyID | string | Назва ідентифікатора (ЄДРПОУ, КАТОТТГ, РНОКПП, УКТЗЕД) |
| ettns.document_data. consigneeTradeParty.name | string | Ім'я вантажоодержувача |
| ettns.document_data. consigneeTradeParty.surname | string | Прізвище вантажоодержувача |
| ettns.document_data. consigneeTradeParty.patronymic | string | По батькові вантажоодержувача |
| ettns.document_data. consigneeTradeParty.roleCode | string | Роль учасника (Вантажоодержувач - CN) |
| ettns.document_data. consigneeTradeParty.telephone | string | Основний телефон вантажоодержувача |
| ettns.document_data. consigneeTradeParty.mobile | string | Мобільний телефон вантажоодержувача |
| ettns.document_data. consigneeTradeParty.email | string | Електронна адреса вантажоодержувача |
| ettns.document_data. consigneeTradeParty.postCode | string | Поштовий індекс вантажоодержувача |
| ettns.document_data. consigneeTradeParty.street | string | Адреса (назва вулиці + номер будівлі) |
| ettns.document_data. consigneeTradeParty.city | string | Місто (назва населеного пункту) |
| ettns.document_data. consigneeTradeParty.countryID | string | Країна (UA) |
| ettns.document_data. consigneeTradeParty.countryName | string | Назва країни |
| ettns.document_data. consigneeTradeParty.taxRegistration | string | ЄДРПОУ підприємства, та/або РНОКПП всіх відповідальних осіб |
| ettns.document_data. consigneeTradeParty.id | string | ЄДРПОУ/КАТОТТГ/РНОКПП/УКТЗЕД вантажоодержувача |
| ettns.document_data. carrierTradeParty | object | Перевізник |
| ettns.document_data. carrierTradeParty.schemeAgencyID | string | Назва ідентифікатора (ЄДРПОУ, КАТОТТГ, РНОКПП, УКТЗЕД) |
| ettns.document_data. carrierTradeParty.name | string | Ім'я перевізника |
| ettns.document_data. carrierTradeParty.surname | string | Прізвище перевізника |
| ettns.document_data. carrierTradeParty.patronymic | string | По батькові перевізника |
| ettns.document_data. carrierTradeParty.roleCode | string | Роль учасника (Перевізник - CA) |
| ettns.document_data. carrierTradeParty.telephone | string | Основний телефон перевізника |
| ettns.document_data. carrierTradeParty.mobile | string | Мобільний телефон перевізника |
| ettns.document_data. carrierTradeParty.email | string | Електронна адреса перевізника |
| ettns.document_data. carrierTradeParty.postCode | string | Поштовий індекс перевізника |
| ettns.document_data. carrierTradeParty.street | string | Адреса (назва вулиці + номер будівлі) |
| ettns.document_data. carrierTradeParty.city | string | Місто (назва населеного пункту) |
| ettns.document_data. carrierTradeParty.countryID | string | Країна (UA) |
| ettns.document_data. carrierTradeParty.countryName | string | Назва країни |
| ettns.document_data. carrierTradeParty.taxRegistration | string | ЄДРПОУ підприємства, та/або РНОКПП всіх відповідальних осіб. У випадку перевізника - РНОКПП водія обов'язково! |
| ettns.document_data. carrierTradeParty.id | integer | ЄДРПОУ/КАТОТТГ/РНОКПП/УКТЗЕД перевізника |
| ettns.document_data. forwarder | object | Експедитор |
| ettns.document_data. forwarder.schemeAgencyID | string | Назва ідентифікатора (ЄДРПОУ, КАТОТТГ, РНОКПП, УКТЗЕД) |
| ettns.document_data. forwarder.name | string | Ім'я експедитора |
| ettns.document_data. forwarder.surname | string | Прізвище експедитора |
| ettns.document_data. forwarder.patronymic | string | По батькові експедитора |
| ettns.document_data. forwarder.roleCode | string | Роль учасника (Експедитор - FW) |
| ettns.document_data. forwarder.telephone | string | Основний телефон експедитора |
| ettns.document_data. forwarder.mobile | string | Мобільний телефон експедитора |
| ettns.document_data. forwarder.email | string | Електронна адрес експедитора |
| ettns.document_data. forwarder.postCode | string | Поштовий індекс експедитора |
| ettns.document_data. forwarder.street | string | Адреса (назва вулиці + номер будівлі) |
| ettns.document_data. forwarder.city | string | Місто (назва населеного пункту) |
| ettns.document_data. forwarder.countryID | string | Країна (UA) |
| ettns.document_data. forwarder.countryName | string | Назва країни |
| ettns.document_data. forwarder.taxRegistration | string | РНОКПП всіх відповідальних осіб за необхідності |
| ettns.document_data. forwarder.id | integer | ЄДРПОУ/КАТОТТГ/РНОКПП/УКТЗЕД експедитора |
| ettns.document_data. customer | object | Замовник |
| ettns.document_data. customer.schemeAgencyID | string | Назва ідентифікатора (ЄДРПОУ, КАТОТТГ, РНОКПП, УКТЗЕД) |
| ettns.document_data. customer.name | string | Ім'я замовника |
| ettns.document_data. customer.surname | string | Прізвище замовника |
| ettns.document_data. customer.patronymic | string | По батькові замовника |
| ettns.document_data. customer.roleCode | string | Роль учасника (Замовник - OB) |
| ettns.document_data. customer.telephone | string | Основний телефон замовника |
| ettns.document_data. customer.mobile | string | Мобільний телефон замовника |
| ettns.document_data. customer.email | string | Електронна адреса замовника |
| ettns.document_data. customer.postCode | string | Поштовий індекс замовника |
| ettns.document_data. customer.street | string | Адреса (назва вулиці + номер будівлі) |
| ettns.document_data. customer.city | string | Місто (назва населеного пункту) |
| ettns.document_data. customer.countryID | string | Країна (UA) |
| ettns.document_data. customer.countryName | string | Назва країни |
| ettns.document_data. customer.taxRegistration | string | ЄДРПОУ підприємства, та/або РНОКПП всіх відповідальних осіб за необхідності |
| ettns.document_data. customer.id | integer | ЄДРПОУ/КАТОТТГ/РНОКПП/УКТЗЕД замовника |
| ettns.document_data. security | object | Охоронна компанія |
| ettns.document_data. security.id | string | ЄДРПОУ/КАТОТТГ/РНОКПП/УКТЗЕД охоронної компанії |
| ettns.document_data. security.companyName | string | Повне найменування охоронної компанії, що надає охоронні послуги вантажу під час перевезення |
| ettns.document_data. security.roleCode | string | Роль учасника (Охоронна компанія - COP) |
| ettns.document_data. security.contact | string | Контакти відповідального представника |
| ettns.document_data. carrierLogistics | object | Пункт навантаження |
| ettns.document_data. carrierLogistics.id | string | КАТОТТГ пункту навантаження |
| ettns.document_data. carrierLogistics.name | string | Найменування пункту навантаження |
| ettns.document_data. carrierLogistics.schemeAgencyID | string | Назва ідентифікатора (ЄДРПОУ, КАТОТТГ, РНОКПП, УКТЗЕД) |
| ettns.document_data. carrierLogistics.typeCode | string | Тип операції: 10 - навантаження; 5 - розвантаження |
| ettns.document_data. carrierLogistics.latitudeMeasure | string | Географічні координати (широта) |
| ettns.document_data. carrierLogistics.longitudeMeasure | string | Географічні координати (довгота) |
| ettns.document_data. consigneeLogistics | object | Пункт розвантаження |
| ettns.document_data. consigneeLogistics.id | string | КАТОТТГ пункту розвантаження |
| ettns.document_data. consigneeLogistics.name | string | Найменування пункту розвантаження |
| ettns.document_data. consigneeLogistics.schemeAgencyID | string | Назва ідентифікатора (ЄДРПОУ, КАТОТТГ, РНОКПП, УКТЗЕД) |
| ettns.document_data. consigneeLogistics.typeCode | string | Тип операції: 10 - навантаження; 5 - розвантаження |
| ettns.document_data. consigneeLogistics.latitudeMeasure | string | Географічні координати (широта) |
| ettns.document_data. consigneeLogistics.longitudeMeasure | string | Географічні координати (довгота) |
| ettns.document_data. transportEquipmentCar | object | Автомобіль |
| ettns.document_data. transportEquipmentCar.id | string | Реєстраційний номер автомобіля згідно з техпаспортом |
| ettns.document_data. transportEquipmentCar.code | integer | |
| ettns.document_data. transportEquipmentCar.country | string | Країна реєстрації автомобіля |
| ettns.document_data. transportEquipmentCar.applicableNote | list[object] | Додаткові параметри |
| ettns.document_data. transportEquipmentCar.applicableNote.code | string | Назва параметра (BRAND, MODEL, COLOR) |
| ettns.document_data. transportEquipmentCar.applicableNote.content | string | Значення параметра |
| ettns.document_data. transportTrailer | object | Причіп/напівпричіп |
| ettns.document_data. transportTrailer.id | string | Реєстраційний номер причіпа/напівпричіпа згідно з техпаспортом |
| ettns.document_data. transportTrailer.code | integer | |
| ettns.document_data. transportTrailer.country | string | Країна реєстрації причепа |
| ettns.document_data. transportTrailer.categoryCode | string | Категорія причепа: BX - Boxcar (ЗД вагон) CN - Контейнер TE - Trailer (причеп) |
| ettns.document_data. transportTrailer.characteristicCode | string | Тип причепа: 14 - причеп 17 - напів-причеп |
| ettns.document_data. transportTrailer.affixedLogisticsSeal | list[object] | Інформація про пломбування SEAL_NO |
| ettns.document_data. transportTrailer.affixedLogisticsSeal.id | string | Номер пломби, якою проводилося пломбування причіпа/напівпричіпа |
| ettns.document_data. transportTrailer.applicableNote | list[object] | Додаткові параметри |
| ettns.document_data. transportTrailer.applicableNote.code | string | Назва параметра (BRAND, MODEL) |
| ettns.document_data. transportTrailer.applicableNote.content | string | Значення параметра |
| ettns.document_data. uaSignatureStorage | object | Підписи |
| ettns.document_data. uaSignatureStorage.typeCode | string | |
| ettns.document_data. uaSignatureStorage.signature | list[object] | Base64 документа |
| ettns.document_data. uaSignatureStorage.signature.taxRegistration | string | Параметри підпису документа |
| ettns.document_data. uaSignatureStorage.signature.signingPartyRoleName | string | Назва ролі підписанта |
| ettns.document_data. uaSignatureStorage.signature.signingPartyRoleCode | string | Роль підписанта |
| ettns.document_data. uaSignatureStorage.signature.PartySignature | string | |
| ettns.document_data. uaSignatureStorage.signature.name | string | ПІБ підписанта |
| ettns.document_data. uaSignatureStorage.signature.positionID | integer | Ідентифікатор посади підписанта |
| ettns.document_data. uaSignatureStorage.signature.position | string | Посада підписанта |
Приклад успішної відповіді
200 OK
Відповідь: /ettn
{
"ettns": [
{
"_id": {
"cbdEttnId": "7ecd0c06-916e-4f09-a08e-6db7ca76bac1"
},
"cbdEttnId": "7ecd0c06-916e-4f09-a08e-6db7ca76bac1",
"ettnID": "6514036ff003d4ae20010893",
"document_data": {
"exchangedDocumentContext": {
"id": "232",
"logisticName": "Місце складання документу1",
"logisticDescription": "79000, м.Львів, вул. Словацького, 1",
"transactionID": 0,
"businessProcess": "urn:ua:e-transport.gov.ua:ettn:01",
"guideline": "urn:ua:e-transport.gov.ua:ettn:01:generic:01",
"hNum": "",
"dateTime": "2023-09-27T10:26:55+00:00"
},
"chainConsignment": {
"grossWeightUnitCode": "KGM",
"grossWeightMeasure": "24601",
"associatedInvoiceCurrencyID": "UAH",
"associatedInvoiceAmount": "100",
"quantity": "11"
},
"consignorTradeParty": {
"id": "2884700372",
"schemeAgencyID": "ЄДРПОУ",
"name": "ІВАН",
"surname": "ІВАНОВ",
"patronymic": "ІВАНОВИЧ",
"roleCode": "CZ",
"telephone": "0441112233",
"mobile": "0931112233",
"email": "[email protected]",
"postCode": "01001",
"street": "вул.Хрещатик, 22",
"city": "Київ",
"countryID": "UA",
"countryName": "м.Київ",
"taxRegistration": "2884700372"
},
"consigneeTradeParty": {
"schemeAgencyID": "ЄДРПОУ",
"name": "ІВАН",
"surname": "ІВАНОВ",
"patronymic": "ІВАНОВИЧ",
"roleCode": "CN",
"telephone": "0441112233",
"mobile": "0931112233",
"email": "[email protected]",
"postCode": "01001",
"street": "вул.Хрещатик, 22",
"city": "Київ",
"countryID": "UA",
"countryName": "м.Київ",
"taxRegistration": "42152964",
"id": 6
},
"carrierTradeParty": {
"schemeAgencyID": "ЄДРПОУ",
"name": "ІВАН",
"surname": "ІВАНОВ",
"patronymic": "ІВАНОВИЧ",
"roleCode": "CA",
"telephone": "0441112233",
"mobile": "0931112233",
"email": "[email protected]",
"postCode": "01001",
"street": "вул.Хрещатик, 22",
"city": "Київ",
"countryID": "UA",
"countryName": "м.Київ",
"taxRegistration": "2884700372",
"id": 5
},
"forwarder": {
"schemeAgencyID": "ЄДРПОУ",
"name": "Василь",
"surname": "Васильченко",
"patronymic": "Васильович",
"roleCode": "FW",
"telephone": "0441112233",
"mobile": "0931112233",
"email": "[email protected]",
"postCode": "01001",
"street": "вул.Хрещатик, 22",
"city": "Київ",
"countryID": "UA",
"countryName": "м.Київ",
"taxRegistration": "30582191",
"id": 3
},
"customer": {
"schemeAgencyID": "ЄДРПОУ",
"name": "Василь",
"surname": "Васильченко",
"patronymic": "Васильович",
"roleCode": "OB",
"telephone": "0441112233",
"mobile": "0931112233",
"email": "[email protected]",
"postCode": "01001",
"street": "вул.Хрещатик, 22",
"city": "Київ",
"countryID": "UA",
"countryName": "м.Київ",
"taxRegistration": "30582191",
"id": 2
},
"security": {
"id": "12345678",
"companyName": "ТОВ Компанія охорона",
"roleCode": "COP",
"contact": "Небезпечний Іван Іванович"
},
"carrierLogistics": {
"id": "test",
"name": "test 2",
"schemeAgencyID": "КАТОТТГ",
"typeCode": "5",
"latitudeMeasure": "48.138708833123815",
"longitudeMeasure": "11.503074665045691"
},
"consigneeLogistics": {
"id": "test",
"name": "test 2",
"schemeAgencyID": "КАТОТТГ",
"typeCode": "10",
"latitudeMeasure": "48.138708833123815",
"longitudeMeasure": "11.503074665045691"
},
"transportEquipmentCar": {
"id": "АА1234ВВ",
"code": 2,
"country": "UK",
"applicableNote": [
{
"code": "BRAND",
"content": "Volvo"
},
{
"code": "MODEL",
"content": "Truck"
},
{
"code": "COLOR",
"content": "Синій"
}
]
},
"transportTrailer": {
"id": "АА1234ВВ",
"code": 4,
"country": "UK",
"categoryCode": "TE",
"characteristicCode": "14",
"affixedLogisticsSeal": [
{
"id": "123123"
},
{
"id": "23456"
}
],
"applicableNote": [
{
"code": "BRAND",
"content": "Volvo"
},
{
"code": "MODEL",
"content": "Super Trailer"
}
]
},
"uaSignatureStorage": {
"typeCode": "730",
"signature": [
{
"taxRegistration": "1234567890",
"signingPartyRoleName": "Carrier",
"signingPartyRoleCode": "CA",
"PartySignature": "MIIlJwYJKoZIhvcNAQcC***U8Xm9gSzuvw4P7wsFTk=",
"name": "ІВАНОВ ІВАН ІВАНОВИЧ",
"positionID": 7,
"position": "директор"
},
{
"taxRegistration": "1234567890",
"signingPartyRoleName": "Carrier",
"signingPartyRoleCode": "CA",
"PartySignature": "MIIlJwYJKoZIhvcNAQcC***U8Xm9gSzuvw4P7wsFTk=",
"name": "ІВАНОВ ІВАН ІВАНОВИЧ",
"positionID": 4,
"position": "водій"
}
]
}
}
}
]
}