Друкована форма і підпис інвойсу для міжнародних експрес-накладних з України в світ

При оформленні міжнародних відправлень з України клієнт має надати інвойс у друкованій формі з підписом, оскільки цей документ є обов’язковим для митного оформлення товару. Для зручності клієнтів створено методи, які дозволяють сформувати друковану форму інвойсу та накласти електронний підпис. Він надає такі дані:

друковану форму інвойсу в форматі base64, яку можна роздрукувати, підписати фізично, відсканувати та підвантажити при створенні МЕН;
посилання на сервіс NovaDoc, де інвойс можна завантажити на комп’ютер, підписати КЕП, завантажити підписану версію та підвантажити при створенні МЕН.

Як це виглядає?

Дані, що використовуються для формування міжнародної експрес-накладної, потрібні й для друкованої форми інвойсу. Тому схема запиту дуже схожа на ту, що ви використовуєте для створення МЕН.

Запит

Метод POST v.1.0/invoise-sign-form

Авторизація: jwt-token

{
  "invoice": {
        "incoterm": "DDP",
        "payerFeesCustoms": "Sender",
        "currency": "UAH",
        "exportReason": "Selling",
        "invoiceType": "Invoice", 
        "customerNumber": "123-11",
        "customerCreatedAt": "2026-05-21",
        "items": [
            {
                "name": "Книжка Плоть і вогонь. Книга 2: Світло у пломені",
                "nameEng": "Book Flesh and fire. Book 2. Light in the flame",
                "measurementCode": "pieces",
                "amount": 1,
                "weight": 500,
                "cost": 100,
                "material": "paper",
                "hsCode": "4901990000"
            }
        ]
    },
    "parcelsCount": 1,
    "sender": {
        "companyTin": "1122334455",
        "companyName": "My company",
        "phone": "380501112283",
        "email": "11@mail.net",
        "name": "Oksana Hrechaniuk",
        "countryCode": "UA",
        "settlementId": 126956,
        "registrationAddressParts": 
        {
            "city": "Петропавлівська Борщагівка",
            "region": "Київська область",
            "street": "Соборна",
            "postCode": "08129",
            "building": " 117-А",
            "flat": ""
        }
    },
    "recipient": {
        "companyTin": "",
        "companyName": "",
        "phone": "48503221212",
        "email": "111@mail.net",
        "name": "Dzheripa Ihor",
        "countryCode": "PL",
        "settlementId": 26024,
        "divisionId": null,
        "addressParts": {
            "city": "Krakow",
            "region": "Krakow County",
            "street": "Studencka",
            "postCode": "31117",
            "building": " 17",
            "flat": ""
        }
    }
}

Схема для запиту

Поле

Обов'язковість

Тип

Опис

invoice[]

Обов'язкове, не null

Масив інформації про інвойс

incoterm

Обов'язкове

enum

Тип митного оформлення:

DAP

DDP

payerFeesCustoms

Обов'язкове

enum

Платник за мито:

Sender, Recipient, ThirdPerson

currency

Обов'язкове

enum

Валюта інвойса

exportReason

Обов'язкове

enum

Причина експорту:

ForPersonalPurposes

Selling

Repair

Return

Other

invoiceType

Обов'язкове

enum

Тип формуємого інвойсу:

Invoice

ProformaInvoice

customerNumber

Обов'язкове

string (20)

Клієнтський номер інвойсу. Клієнт має сам пронумерувати свій інвойс.

customerCreatedAt

Обов'язкове

date

Дата інвойсу в форматі YYYY-MM-DD

items[]

Обов'язкове

Масив позицій інвойсу

items[].name

Обов'язкове

string

Назва позиції українською мовою

items[].nameEng

Обов'язкове

string

Назва позиції англійською мовою

items[].measurementCode

Обов'язкове

string

Код виміру позиції

Приклад: pieces

items[].amount

Обов'язкове

int

Кількість шт в позиції

items[].cost

Обов'язкове

int

Вартість штуки

items[].material

Обов'язкове

string

Матеріал

items[].weight

Обов'язкове

int

Вага всіх шт в позиціі

items[].hsCode

Обов'язкове

string

УКТЗЕД

parcelsCount

Обов'язкове

int

Загальна кількість посилок у відправленні

sender

Обов'язкове

Масив інформації про відправника

sender.companyTin

Обов'язкове

string

ЄРДПОУ компанії / ІПН ФОП

sender.companyName

Обов'язкове

string

Назва компанії

sender.phone

Обов'язкове

string

Номер телефона відправника

sender.email

Обов'язкове

string

Адреса електронної пошти відправника

sender.name

Обов'язкове

string

Прізвище і ім'я відправника

sender.countryCode

Обов'язкове

enum

Alpha-2-code країни відправника

sender.settlementId

Обов'язкове

int

Ідентифікатор міста відправника з довідника міст

sender.registrationAddressParts

Обов'язкове

Масив інформації для регістраційної адреси компанії-відправника

sender.registrationAddressParts.city

Обов'язкове

string

Місто регістраційної адреси компанії-відправника

sender.registrationAddressParts.region

Обов'язкове

string

Область регістраційної адреси компанії-відправника

sender.registrationAddressParts.street

Обов'язкове

string

Вулиця регістраційної адреси компанії-відправника

sender.registrationAddressParts.postCode

Обов'язкове

string

Поштовий індекс регістраційної адреси компанії-відправника

sender.registrationAddressParts.building

Обов'язкове

string

Номер будинку регістраційної адреси компанії-відправника

sender.registrationAddressParts.flat

Необов'язкове

string

Номер квартири регістраційної адреси компанії-відправника

recipient

Обов'язкове

Масив інформації про отримувача

recipient.phone

Обов'язкове

string

Номер телефона отримувача

recipient.email

Обов'язкове

string

Адреса електронної пошти отримувача

recipient.name

Обов'язкове

string

Прізвище і ім'я отримувача

recipient.countryCode

Обов'язкове

enum

Alpha-2-code країни отримувача

recipient.settlementId

Обов'язкове

int

Ідентифікатор міста отримувача з довідника міст

recipient.divisionId

Необов'язкове, якщо заповнено city, region, street, postCode, building в recipient.addressParts

int

Ідентифікатор відділення отримувача з довідника відділень

recipient.addressParts

Масив інформації про адрес отримувача при адресній доставці

recipient.addressParts.city