Експрес-накладні в системі checkbox - це проект фіскального чека, який повʼязаний із накладною Нової Пошти та буде фіскалізовано автоматично після отримання покупцем посилки.
❗️ Важливо: щоб опція створення проектів експрес-накладних стала доступною, спершу активуйте її у вашому особистому кабінеті checkbox за інструкцією.
❗️ Увага: дані методи API checkbox - не створюють саму ТТН в Новій Пошті. Продавцю необхідно створити окремо або через бізнес-кабінет, або на відділені саму ТТН (ІЗ КОНТРОЛЕМ ОПЛАТИ В ОБОХ ВИПАДКАХ) і після цього вже створювати проект експрес-накладної в системі checkbox.
ТЕСТОВИХ ДАНИХ - НЕ ІСНУЄ.
ПІДКЛЮЧИТИ ТОКЕН НОВОЇ ПОШТИ МОЖЛИВО ТІЛЬКИ НА БОЙОВУ (РЕАЛЬНУ) ФІСКАЛЬНУ КАСУ.
ТЕСТУВАННЯ МОЖЛИВЕ ТІЛЬКИ НА РЕАЛЬНІЙ ФІСКАЛЬНІЙ КАСІ ІЗ РЕАЛЬНОЮ НАКЛАДНОЮ НОВОЇ ПОШТИ.
Використовуйте цей метод для створення проекта фіскального чека та експрес-накладних в системі checkbox.
Перед початком необхідно виконати певні налаштування в особистому кабінеті checkbox.
Додавання проекту експрес-накладної дозволено у закритій касовій зміні.
cancelled (скасовано). В такому випадку рекомендуємо видалити її із системи checkbox.returned (повернуто)accept: application/json
Authorization: <токен авторизації>
X-Client-Name: <назва інтеграції (обов`язково)>
X-Client-Version: <версія інтеграції (обов`язково)>
X-License-Key: <ключ ліцензії каси (обов`язково)>
Content-Type: application/json
{
"receipt_body": {
"payments": [
{
"value": "<сума оплати у копійках - має відповідти сумі експрес-накладної НП>",
"ettn": "<номер накладної Нової Пошти>",
"type": "<""ETTN"" (завжди має значення ETTN)>",
"label": "<текстова назва форми оплати (завжди має значення "Експрес-накладна")>"
}
],
"rounding": <активація режиму заокруглення (завжди true)>,
"footer": "<футер чека>",
"delivery": {
"emails": ["<e-mail клієнта для відправки копії чека 1>","<e-mail клієнта для відправки копії чека 2>"],
"phone": "<номер телефона клієнта для відправки копії чека по SMS/Viber (для роботи функції має бути налаштована та підключена відповідна послуга). Формат 380...>"
},
"goods": [
{
"good": {
"code": "<Код товару>",
"name": "<Назва товару>",
"barcode": "<Штрих-код товару>",
"excise_barcodes": [
"<цифрове позначення штрих-коду акцизної марки 1>",
"<цифрове позначення штрих-коду акцизної марки 2>"
],
"header": "<Хедер товару 1>",
"footer": "<Футер товару 1>",
"price": "<ціна у копійках>",
"tax": [
"<цифровий або літерний код ставки податку (попередньо програмується у особистому кабінеті). Якщо до товару потрібно застосувати декілька податків - вказати через кому>"
],
"uktzed": "<код УКТЗЕД>"
},
"good_id": "<UUID v4 товару (якщо ви користуєтесь залишками на сайті checkbox)>",
"quantity": "<кількість у тисячах", 1 шт = 1000>,
"is_return": "<флаг true/false, що визначає, чи це чек повернення>",
"discounts": [
{
"type": "<тип знижки - "DISCOUNT"/"EXTRA_CHARGE" (ЗНИЖКА/НАДБАВКА)>",
"mode": "<режим знижки "VALUE"/"PERCENT (АБСОЛЮТНЕ ЗНАЧЕННЯ/ВІДСОТКОВА ЗНИЖКА - рекомендуємо відмовлятись від вказування відсоткової знижки та передавати у фіскальний чек абсолютне значення)>",
"value": "<значення знижки>",
"tax_code": "<код податку", який застосовується для товару. Потрібно вказувати для коректного обрахунку знижки, якщо товар має податкову ставку>",
"tax_codes":[
"<коди податкових ставок, що застосовуються для товару (якщо їх >1). Потрібно вказувати через кому для коректного обрахунку знижки, якщо товар має податкову ставку>"
],
"name": "<назва знижки або надбавки>"
}
]
}
],
"discounts":[
{
"type": "<тип знижки - "DISCOUNT"/"EXTRA_CHARGE" (ЗНИЖКА/НАДБАВКА)>",
"mode": "<режим знижки "VALUE"/"PERCENT (АБСОЛЮТНЕ ЗНАЧЕННЯ/ВІДСОТКОВА ЗНИЖКА - рекомендуємо відмовлятись від вказування відсоткової знижки та передавати у фіскальний чек абсолютне значення)>",
"value": "<значення знижки>",
"tax_code": "<код податку", який застосовується для товару. Потрібно вказувати для коректного обрахунку знижки, якщо товар має податкову ставку>",
"tax_codes":[
"<коди податкових ставок, що застосовуються для товару (якщо їх >1). Потрібно вказувати через кому для коректного обрахунку знижки, якщо товар має податкову ставку>"
],
"name": "<назва знижки або надбавки>"
}
]
},
"senderPhone": "<Телефон відправника. Формат 380...>"
}
curl -X 'POST' \ 'https://api.checkbox.ua/api/v1/np/ettn' \ -H 'accept: application/json' \ -H 'X-Client-Name: X-Client-Name' \ -H 'X-Client-Version: X-Client-Version' \ -H 'X-License-Key: 60ba422ff0d6421294311111' \ -H 'Authorization: Bearer token' \ -H 'Content-Type: application/json' \ -d '{ "employee":"7152306f-d2a2-4dd2-a9c4-037df6811111", "cashRegister":"fcf13176-f972-4f5b-bae0-54abf9211111", "receipt_body":{ "goods":[ { "good":{ "code":"22", "name":"Документи", "price":20000, "tax":[ 8 ] }, "quantity":1000, "is_return":false } ], "payments":[ { "type":"ETTN", "label":"Експрес-накладна", "value":20000, "ettn":"20450963211111" } ], "footer":"<футер чека>" }}'
{
"ettnNumber": "20450963211111",
"description": "Документи",
"recipientPhone": "380500511111",
"receiptBody": {
"payments": [
{
"value": 20000,
"type": "CARD",
"label": "Безготівкова"
}
],
"rounding": true,
"footer": "<футер чека>",
"delivery": [],
"goods": [
{
"good": {
"code": "22",
"name": "Документи",
"barcode": null,
"excise_barcode": null,
"excise_barcodes": null,
"header": null,
"footer": null,
"price": 20000,
"tax": [
8
],
"uktzed": null
},
"good_id": null,
"quantity": 1000,
"is_return": false
}
],
"id": "ca6d9fe9-f3f0-49b9-858d-bda023111111"
},
"receiptId": "ca6d9fe9-f3f0-49b9-858d-bda023111111",
"receiptRelationId": null,
"returnReceiptId": null,
"totalSum": 20000,
"employee": {
"dateCreated": "2022-09-09T14:35:44+03:00",
"id": "7152306f-d2a2-4dd2-a9c4-037df6811111"
},
"cashRegister": {
"id": "06fbc9f0-0bed-487b-b0be-598278c11111",
"dateCreated": "2024-05-30T15:18:30+03:00"
},
"status": "created",
"lastCheckDate": "2024-07-25T15:25:47+03:00",
"rawError": null,
"hasWebhook": false,
"deliveryPhone": null,
"deliveryEmail": null,
"id": "b8c6558e-760b-43c2-af2a-6803c3211111",
"dateCreated": "2024-07-25T15:25:47+03:00"
}
curl -X 'POST' \ 'https://api.checkbox.ua/api/v1/np/ettn' \ -H 'accept: application/json' \ -H 'X-License-Key: 60ba422ff0d6421294311111' \ -H 'Authorization: Bearer token' \ -H 'Content-Type: application/json' \ -d '{ "employee":"7152306f-d2a2-4dd2-a9c4-037df6811111", "cashRegister":"fcf13176-f972-4f5b-bae0-54abf9211111", "receipt_body":{ "goods":[ { "good":{ "code":"22", "name":"Документи", "price":20000, "tax":[ 8 ] }, "quantity":1000, "is_return":false } ], "payments":[ { "type":"ETTN", "label":"Експрес-накладна", "value":20000, "ettn":"20450963211111" } ], "footer":"<футер чека>" }}'
"ettnNumber" - номер експрес-накладної Нової Пошти
"description" - опис відправлення експрес-накладної Нової Пошти
"recipientPhone" - номер телефону отримувача експрес-накладної Нової Пошти
"receiptBody" - блок даних з інформацією про чек:
"payments" - блок даних з інформацією про платежі:
"rounding" - активація режиму заокруглення (завжди true)
"footer" - футер чека
"delivery" - блок даних з інформацією про доставку чека
"goods" - масив даних з переліком товарів
"id" - UUID v4 створеного чека після отримання покупцем експрес-накладної
"receiptId" - UUID v4 створеного чека після отримання покупцем експрес-накладної
"receiptRelationId" -
"returnReceiptId" -
"totalSum" - сума оплати у копійках
"employee" - блок даних з інформацією про касира:
- "dateCreated" - мітка часу створення касира у форматі ISO 8601 за шаблоном YYYY-MM-DDThh:mm:ss.ssssss±hh:mm
- "id" - унікальний ідентифікатор касира у форматі UUID v4
"cashRegister" - блок даних з інформацією про касу:
- "id" - унікальний ідентифікатор каси у форматі UUID v4
- "dateCreated" - мітка часу створення касир у форматі ISO 8601 за шаблоном YYYY-MM-DDThh:mm:ss.ssssss±hh:mm
"status" - статус експрес-накладної і системі checkbox. Можливі статуси: created - створено, done - отримано та фіскалізовано, receipt_error - помилка видачі фіскального чека, cancelled - покупець відмовився від отримання експрес-накладної, returned - чек повернуто.
"lastCheckDate" - мітка часу останньої перевірки експрес-накладної у форматі ISO 8601 за шаблоном YYYY-MM-DDThh:mm:ss.ssssss±hh:mm
"rawError" - опис помилки (при статусі експрес-накладної receipt_error)
"hasWebhook" - false,
"deliveryPhone" - номер телефону отримувача фіскального чек після його створення
"deliveryEmail" - e-mail отримувача фіскального чек після його створення
"id" - order_id унікальний ідентифікатор експрес-накладної в системі checkbox у форматі UUID v4
"dateCreated" - мітка часу створення експрес-накладної в системі checkbox у форматі ISO 8601 за шаблоном YYYY-MM-DDThh:mm:ss.ssssss±hh:mm
Використовуйте цей метод для додавання до експрес-накладних способу доставки фіскального чека покупцеві.
accept: application/json
Authorization: <токен авторизації>
X-Client-Name: <назва інтеграції (обов`язково)>
X-Client-Version: <версія інтеграції (обов`язково)>
X-License-Key: <ключ ліцензії каси (обов`язково)>
order_id: <унікальний ідентифікатор експрес-накладної в системі checkbox (обов`язково)>
Content-Type: application/json
{
"delivery_phone": "<номер телефона клієнта для відправки копії чека по SMS/Viber (для роботи функції має бути налаштована та підключена відповідна послуга)>. Формат 380..",
"delivery_email": "<e-mail клієнта для відправки копії чека>"
}
curl -X 'PUT' \ 'https://api.checkbox.ua/api/v1/np/ettn/b8c6558e-760b-43c2-af2a-6803c3211111' \ -H 'accept: application/json' \ -H 'X-Client-Name: X-Client-Name' \ -H 'X-Client-Version: X-Client-Version' \ -H 'X-License-Key: 60ba422ff0d6421294311111' \ -H 'Authorization: Bearer token' \ -H 'Content-Type: application/json' \ -d '{ "delivery_phone": "380500511111", "delivery_email": "[email protected]"}'
{
"ettnNumber": "20450963211111",
"description": "Документи",
"recipientPhone": "380500511111",
"receiptBody": {
"payments": [
{
"value": 20000,
"type": "CARD",
"label": "Безготівкова"
}
],
"rounding": true,
"footer": "<футер чека>",
"delivery": {
"email": "[email protected]"
},
"goods": [
{
"good": {
"code": "22",
"name": "Документи",
"barcode": null,
"excise_barcode": null,
"excise_barcodes": null,
"header": null,
"footer": null,
"price": 20000,
"tax": [
8
],
"uktzed": null
},
"good_id": null,
"quantity": 1000,
"is_return": false
}
],
"id": "ca6d9fe9-f3f0-49b9-858d-bda023111111"
},
"receiptId": "ca6d9fe9-f3f0-49b9-858d-bda023111111",
"receiptRelationId": null,
"returnReceiptId": null,
"totalSum": 20000,
"employee": {
"dateCreated": "2022-09-09T14:35:44+03:00",
"id": "7152306f-d2a2-4dd2-a9c4-037df6811111"
},
"cashRegister": {
"id": "06fbc9f0-0bed-487b-b0be-598278c11111",
"dateCreated": "2024-05-30T15:18:30+03:00"
},
"status": "created",
"lastCheckDate": "2024-07-25T15:59:47+03:00",
"rawError": null,
"hasWebhook": false,
"deliveryPhone": null,
"deliveryEmail": "[email protected]",
"id": "b8c6558e-760b-43c2-af2a-6803c3211111",
"dateCreated": "2024-07-25T15:25:47+03:00"
}
"ettnNumber" - номер експрес-накладної Нової Пошти
"description" - опис відправлення експрес-накладної Нової Пошти
"recipientPhone" - номер телефону отримувача експрес-накладної Нової Пошти
"receiptBody" - блок даних з інформацією про чек:
"payments" - блок даних з інформацією про платежі:
"rounding" - активація режиму заокруглення (завжди true)
"footer" - футер чека
"delivery" - блок даних з інформацією про доставку чека
"goods" - масив даних з переліком товарів
"id" - UUID v4 створеного чека після отримання покупцем експрес-накладної
"receiptId" - UUID v4 створеного чека після отримання покупцем експрес-накладної
"receiptRelationId" -
"returnReceiptId" -
"totalSum" - сума оплати у копійках
"employee" - блок даних з інформацією про касира:
- "dateCreated" - мітка часу створення касира у форматі ISO 8601 за шаблоном YYYY-MM-DDThh:mm:ss.ssssss±hh:mm
- "id" - унікальний ідентифікатор касира у форматі UUID v4
"cashRegister" - блок даних з інформацією про касу:
- "id" - унікальний ідентифікатор каси у форматі UUID v4
- "dateCreated" - мітка часу створення касир у форматі ISO 8601 за шаблоном YYYY-MM-DDThh:mm:ss.ssssss±hh:mm
"status" - статус експрес-накладної і системі checkbox. Можливі статуси: created - створено, done - отримано та фіскалізовано, receipt_error - помилка видачі фіскального чека, cancelled - покупець відмовився від отримання експрес-накладної, returned - чек повернуто.
"lastCheckDate" - мітка часу останньої перевірки експрес-накладної у форматі ISO 8601 за шаблоном YYYY-MM-DDThh:mm:ss.ssssss±hh:mm
"rawError" - опис помилки (при статусі експрес-накладної receipt_error)
"hasWebhook" - false,
"deliveryPhone" - номер телефону отримувача фіскального чек після його створення
"deliveryEmail" - e-mail отримувача фіскального чек після його створення
"id" - order_id унікальний ідентифікатор експрес-накладної в системі checkbox у форматі UUID v4
"dateCreated" - мітка часу створення експрес-накладної в системі checkbox у форматі ISO 8601 за шаблоном YYYY-MM-DDThh:mm:ss.ssssss±hh:mm
Використовуйте цей метод для видалення експрес-накладної та проеку фіскального чека із системи checkbox. При цьому ЕТТН має бути у статусі 'скасовано' (cancelled) або 'створено' (created).
accept: application/json
Authorization: <токен авторизації>
X-Client-Name: <назва інтеграції (обов`язково)>
X-Client-Version: <версія інтеграції (обов`язково)>
X-License-Key: <ключ ліцензії каси (обов`язково)>
order_id: <унікальний ідентифікатор експрес-накладної в системі checkbox (обов`язково)>
Тіло запиту у даному випадку має бути порожнім.
curl -X 'DELETE' \ 'https://api.checkbox.ua/api/v1/np/ettn/b8c6558e-760b-43c2-af2a-6803c3211111' \ -H 'accept: application/json' \ -H 'X-Client-Name: X-Client-Name' \ -H 'X-Client-Version: X-Client-Version' \ -H 'X-License-Key: 60ba422ff0d6421294311111' \ -H 'Authorization: Bearer token'
""
"" - у разі успішного видалення експрес-накладної в системі checkbox.
Використовуйте цей метод для отримання деталей експрес-накладної в системі checkbox.
accept: application/json
Authorization: <токен авторизації>
X-Client-Name: <назва інтеграції (обов`язково)>
X-Client-Version: <версія інтеграції (обов`язково)>
X-License-Key: <ключ ліцензії каси (обов`язково)>
order_id: <унікальний ідентифікатор експрес-накладної в системі checkbox (обов`язково)>
Тіло запиту у даному випадку має бути порожнім.
curl -X 'GET' \ 'https://api.checkbox.ua/api/v1/np/ettn/b8c6558e-760b-43c2-af2a-6803c3211111' \ -H 'accept: application/json' \ -H 'X-Client-Name: X-Client-Name' \ -H 'X-Client-Version: X-Client-Version' \ -H 'X-License-Key: 60ba422ff0d6421294311111' \ -H 'Authorization: Bearer token'
{
"ettnNumber": "20450963211111",
"description": "Документи",
"recipientPhone": "380500511111",
"receiptBody": {
"payments": [
{
"value": 20000,
"type": "CARD",
"label": "Безготівкова"
}
],
"rounding": true,
"footer": "<футер чека>",
"delivery": [],
"goods": [
{
"good": {
"code": "22",
"name": "Документи",
"barcode": null,
"excise_barcode": null,
"excise_barcodes": null,
"header": null,
"footer": null,
"price": 20000,
"tax": [
8
],
"uktzed": null
},
"good_id": null,
"quantity": 1000,
"is_return": false
}
],
"id": "ca6d9fe9-f3f0-49b9-858d-bda023111111"
},
"receiptId": "ca6d9fe9-f3f0-49b9-858d-bda023111111",
"receiptRelationId": null,
"returnReceiptId": null,
"totalSum": 20000,
"employee": {
"dateCreated": "2022-09-09T14:35:44+03:00",
"id": "7152306f-d2a2-4dd2-a9c4-037df6811111"
},
"cashRegister": {
"id": "06fbc9f0-0bed-487b-b0be-598278c11111",
"dateCreated": "2024-05-30T15:18:30+03:00"
},
"status": "created",
"lastCheckDate": "2024-07-25T15:59:47+03:00",
"rawError": null,
"hasWebhook": false,
"deliveryPhone": null,
"deliveryEmail": null,
"id": "b8c6558e-760b-43c2-af2a-6803c3211111",
"dateCreated": "2024-07-25T15:25:47+03:00"
}
"ettnNumber" - номер експрес-накладної Нової Пошти
"description" - опис відправлення експрес-накладної Нової Пошти
"recipientPhone" - номер телефону отримувача експрес-накладної Нової Пошти
"receiptBody" - блок даних з інформацією про чек:
"payments" - блок даних з інформацією про платежі:
"rounding" - активація режиму заокруглення (завжди true)
"footer" - футер чека
"delivery" - блок даних з інформацією про доставку чека
"goods" - масив даних з переліком товарів
"id" - UUID v4 створеного чека після отримання покупцем експрес-накладної
"receiptId" - UUID v4 створеного чека після отримання покупцем експрес-накладної
"receiptRelationId" -
"returnReceiptId" -
"totalSum" - сума оплати у копійках
"employee" - блок даних з інформацією про касира:
- "dateCreated" - мітка часу створення касира у форматі ISO 8601 за шаблоном YYYY-MM-DDThh:mm:ss.ssssss±hh:mm
- "id" - унікальний ідентифікатор касира у форматі UUID v4
"cashRegister" - блок даних з інформацією про касу:
- "id" - унікальний ідентифікатор каси у форматі UUID v4
- "dateCreated" - мітка часу створення касир у форматі ISO 8601 за шаблоном YYYY-MM-DDThh:mm:ss.ssssss±hh:mm
"status" - статус експрес-накладної і системі checkbox. Можливі статуси: created - створено, done - отримано та фіскалізовано, receipt_error - помилка видачі фіскального чека, cancelled - покупець відмовився від отримання експрес-накладної, returned - чек повернуто.
"lastCheckDate" - мітка часу останньої перевірки експрес-накладної у форматі ISO 8601 за шаблоном YYYY-MM-DDThh:mm:ss.ssssss±hh:mm
"rawError" - опис помилки (при статусі експрес-накладної receipt_error)
"hasWebhook" - false,
"deliveryPhone" - номер телефону отримувача фіскального чек після його створення
"deliveryEmail" - e-mail отримувача фіскального чек після його створення
"id" - order_id унікальний ідентифікатор експрес-накладної в системі checkbox у форматі UUID v4
"dateCreated" - мітка часу створення експрес-накладної в системі checkbox у форматі ISO 8601 за шаблоном YYYY-MM-DDThh:mm:ss.ssssss±hh:mm
Використовуйте цей метод для отримання списку переліку експрес-накладних в системі checkbox. Параметри пошуку доступні за посиланням вище.
accept: application/json
Authorization: <токен авторизації>
X-Client-Name: <назва інтеграції (обов`язково)>
X-Client-Version: <версія інтеграції (обов`язково)>
X-License-Key: <ключ ліцензії каси (обов`язково)>
Тіло запиту у даному випадку має бути порожнім.
curl -X 'GET' \ 'https://api.checkbox.ua/api/v1/np/ettn' \ -H 'accept: application/json' \ -H 'X-Client-Name: X-Client-Name' \ -H 'X-Client-Version: X-Client-Version' \ -H 'X-License-Key: 60ba422ff0d6421294311111' \ -H 'Authorization: Bearer token'
[
{
"ettnNumber": "20450963211111",
"description": "Документи",
"recipientPhone": "380500511111",
"receiptId": "ca6d9fe9-f3f0-49b9-858d-bda023111111",
"receiptRelationId": null,
"returnReceiptId": null,
"totalSum": 20000,
"employee": {
"login": "test_fyvw11111",
"dateCreated": "2022-09-09T14:35:44+03:00",
"id": "7152306f-d2a2-4dd2-a9c4-037df6811111"
},
"cashRegister": {
"fiscalNumber": "4000811111",
"id": "06fbc9f0-0bed-487b-b0be-598278c11111",
"dateCreated": "2024-05-30T15:18:30+03:00"
},
"status": "created",
"lastCheckDate": "2024-07-25T15:59:47+03:00",
"deliveryPhone": null,
"deliveryEmail": null,
"id": "b8c6558e-760b-43c2-af2a-6803c3211111",
"dateCreated": "2024-07-25T15:25:47+03:00"
}
]
"ettnNumber" - номер експрес-накладної Нової Пошти
"description" - опис відправлення експрес-накладної Нової Пошти
"recipientPhone" - номер телефону отримувача експрес-накладної Нової Пошти
"receiptId" - UUID v4 створеного чека після отримання покупцем експрес-накладної
"receiptRelationId" -
"returnReceiptId" -
"totalSum" - сума оплати у копійках
"employee" - блок даних з інформацією про касира:
- "dateCreated" - мітка часу створення касира у форматі ISO 8601 за шаблоном YYYY-MM-DDThh:mm:ss.ssssss±hh:mm
- "id" - унікальний ідентифікатор касира у форматі UUID v4
"cashRegister" - блок даних з інформацією про касу:
- "id" - унікальний ідентифікатор каси у форматі UUID v4
- "dateCreated" - мітка часу створення касир у форматі ISO 8601 за шаблоном YYYY-MM-DDThh:mm:ss.ssssss±hh:mm
"status" - статус експрес-накладної і системі checkbox. Можливі статуси: created - створено, done - отримано та фіскалізовано, receipt_error - помилка видачі фіскального чека, cancelled - покупець відмовився від отримання експрес-накладної, returned - чек повернуто.
"lastCheckDate" - мітка часу останньої перевірки експрес-накладної у форматі ISO 8601 за шаблоном YYYY-MM-DDThh:mm:ss.ssssss±hh:mm
"rawError" - опис помилки (при статусі експрес-накладної receipt_error)
"hasWebhook" - false,
"deliveryPhone" - номер телефону отримувача фіскального чек після його створення
"deliveryEmail" - e-mail отримувача фіскального чек після його створення
"id" - order_id унікальний ідентифікатор експрес-накладної в системі checkbox у форматі UUID v4
"dateCreated" - мітка часу створення експрес-накладної в системі checkbox у форматі ISO 8601 за шаблоном YYYY-MM-DDThh:mm:ss.ssssss±hh:mm
Цей метод дозволяє зв’язати експрес-накладну Нової Пошти (ETTN) з фіскальним чеком післяплати
Authorization: Bearer <токен>
X-Client-Name: <інтеграція>
X-Client-Version: <версія>
X-License-Key: <ключ ліцензії каси>
Content-Type: application/json
accept: application/json
{
"receipt_body": {
"payments": [
{
"value": 0,
"type": "ETTN",
"label": "Експрес-накладна",
"ettn": "номер_ЕН"
}
],
"rounding": true,
"footer": "Дякуємо за покупку!",
"delivery": {},
"relationId": "унікальний ідентифікатор чеків"
},
"receiptRelationId": "унікальний ідентифікатор чеків (номер замовлення) передплати і післяплати в системі checkbox",
"senderPhone": "380XXXXXXXXX"
}
curl -X 'POST' \'https://api.checkbox.ua/api/v1/np/ettn/prepayment' \ -H 'Authorization: Bearer YOUR_TOKEN' \-H 'X-Client-Name: my-client' \-H 'X-Client-Version: 1.0' \ -H 'X-License-Key: YOUR_LICENSE_KEY' \ -H 'Content-Type: application/json' \ -H 'accept: application/json' \ -d '{"receipt_body": {"payments": [ {"value": 0,"type": "ETTN", "label": "Експрес-накладна", "ettn": "12345678-aaaa-bbbb-cccc-1234567890ab"}],"rounding": true,"footer": "Дякуємо за замовлення!","delivery": {}, "relationId": "order-001-abc"},"receiptRelationId": "order-001-abc","senderPhone": "380931234567"}'
{
"ettnNumber": "string",
"description": "string",
"recipientPhone": "string",
"senderPhone": "string",
"receiptBody": {},
"receiptId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"receiptRelationId": "string",
"returnReceiptId": "string",
"totalSum": 0,
"employee": {
"login": "string",
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"dateCreated": "2025-08-04T06:54:52.697Z"
},
"cashRegister": {
"fiscalNumber": "string",
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"dateCreated": "2025-08-04T06:54:52.697Z"
},
"status": "string",
"lastCheckDate": "2025-08-04T06:54:52.697Z",
"rawError": "string",
"hasWebhook": true,
"deliveryPhone": "string",
"deliveryEmail": "string",
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"dateCreated": "2025-08-04T06:54:52.697Z"
}
ettnNumber – номер експрес-накладної Нової Пошти
description – опис відправлення експрес-накладної Нової Пошти
recipientPhone – номер телефону отримувача експрес-накладної Нової Пошти
senderPhone – номер телефону відправника експрес-накладної Нової Пошти
receiptBody – тіло фіскального чека, що містить інформацію про оплату, товари, доставку тощо
receiptId – унікальний ідентифікатор сформованого чека (UUID v4)
receiptRelationId – зв’язок чека з іншими документами, наприклад з оплатою чи поверненням
returnReceiptId – ID чека, що повертається (якщо є повернення)
totalSum – загальна сума чека у копійках (наприклад, 10500 = 105.00 грн)
employee – інформація про касира:
login – логін касира
id – унікальний ідентифікатор касира (UUID v4)
dateCreated – дата створення облікового запису касира у системі Checkbox (формат ISO 8601)
cashRegister – інформація про касу:
fiscalNumber – фіскальний номер каси, зареєстрованої в ДПС
id – унікальний ідентифікатор каси (UUID v4)
dateCreated – дата реєстрації каси у системі Checkbox (формат ISO 8601)
status – поточний статус обробки експрес-накладної в Checkbox:
created – створено
done – фіскалізовано
receipt_error – помилка при створенні чека
cancelled – скасовано
returned – повернуто
lastCheckDate – дата останньої перевірки стану експрес-накладної або чека (формат ISO 8601)
rawError – текст помилки, якщо чек не вдалося створити (актуально для статусу receipt_error)
hasWebhook – чи налаштовано вебхук для цієї накладної (true або false)
deliveryPhone – номер телефону для надсилання копії чека отримувачу (SMS/Viber)
deliveryEmail – e-mail для надсилання копії чека отримувачу
"id" - order_id унікальний ідентифікатор експрес-накладної в системі checkbox у форматі UUID v4
"dateCreated" - мітка часу створення експрес-накладної в системі checkbox у форматі ISO 8601 за шаблоном YYYY-MM-DDThh:mm:ss.ssssss±hh:mm