> ## Documentation Index
> Fetch the complete documentation index at: https://docs.plata-app.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Фіскалізація Checkbox

> Як підключити касу Checkbox, налаштувати автоматичні правила й керувати фіскальними чеками прямо в замовленні Shopify.

Plata створює фіскальні чеки Checkbox для замовлень Shopify — автоматично за правилом або вручну з блоку «Фіскалізація» на сторінці замовлення. Фіскальні дані зберігаються в Checkbox, який звітує перед ДПС.

<video controls poster="https://plata-app.com/videos/checkbox/checkbox-demo-poster.jpg" src="https://plata-app.com/videos/checkbox/checkbox-demo.mp4" />

## Перед початком

У кабінеті [Checkbox](https://checkbox.ua) мають бути:

* торгова точка, **каса** і **касир**;
* підписаний договір із фіскальним сервером;
* податкові ставки (меню «Податкові ставки»), якщо ви платник ПДВ або акцизу.

Для підключення знадобляться **ліцензійний ключ каси** (вкладка «Каси») і **PIN-код касира** (вкладка «Касири»).

> [!TIP]
>
> Почніть із **тестової каси** Checkbox. Тестові чеки не є фіскальними документами, тож можна спокійно перевірити весь сценарій.

## 1. Відкрийте інтеграцію

Магазин → **Інтеграції** → вкладка **Фіскалізація** → картка **Checkbox** → **Підключити** (або **Керувати**, якщо вже підключено).

![Інтеграції → Фіскалізація → Checkbox](https://mintcdn.com/plata-app/nftCbsHcUcF0Rm8U/images/checkbox/integrations-fiscalization.png?fit=max\&auto=format\&n=nftCbsHcUcF0Rm8U\&q=85\&s=9069c84765a712c56581350d0e13f4f6)

Вгорі сторінки — зведення: **Режим** (тестовий / бойовий), **Каса**, стан **Блоку у Shopify** і дата, з якої Plata обробляє замовлення.

## 2. Підключіть касу

У блоці **Підключення каси**:

1. Оберіть **Тестова** або **Бойова** каса.
2. Вкажіть **Назву каси**, **Ліцензійний ключ** і **PIN касира**.
3. Натисніть **Зберегти касу**, потім — **Перевірити підключення**.

![Підключення каси Checkbox](https://mintcdn.com/plata-app/nftCbsHcUcF0Rm8U/images/checkbox/cash-register.png?fit=max\&auto=format\&n=nftCbsHcUcF0Rm8U\&q=85\&s=e774308346eb445b41a5a617146283d8)

Після перевірки в полі **Стан** з’являться організація, фіскальний номер, касир і підпис. Ключ і PIN зберігаються зашифровано й більше не показуються. Щоб змінити лише одне значення, залиште інше поле порожнім — збережений секрет не зміниться.

> [!WARNING]
>
> **Бойовий режим створює реальні фіскальні документи.** Перемикайтеся на бойову касу тільки після перевірки на тестовій.

## 3. Параметри чеків

| Параметр | Що робить |
| - | - |
| **Тестовий режим** | Увімкнено — чеки йдуть на тестову касу. |
| **Податкова ставка** | Застосовується до всіх товарів і доставки. Кнопка **Отримати податки** підтягує ставки з Checkbox. Зміна не впливає на вже створені чеки. |
| **Чек на email** | **Надсилати покупцю** — Checkbox відправляє чек, якщо в замовленні є коректний email. |

## 4. Зміна каси

* **Поточна зміна** — статус і кнопки **Відкрити зміну** / **Закрити зміну**. Перша операція дня відкриває зміну автоматично.
* **Автозакриття зміни** — час за Києвом. Увага: автозакриття закриває зміну і для інших систем (наприклад, CRM), які працюють із цією касою.

## 5. Способи оплати

Зіставте кожен спосіб оплати Shopify з тим, як він з’явиться в чеку:

| Поле | Приклад |
| - | - |
| Спосіб оплати Shopify | `manual` |
| Тип оплати в Checkbox | Безготівкова / Готівка |
| Напис у чеку | Карта |
| Тип чека | Повна оплата |

Кнопка **Оновити з Shopify** оновлює список способів оплати магазину.

## 6. Правила автоматичної фіскалізації

Правило визначає, для яких замовлень чек створюється сам. Умови:

* **Спосіб оплати**
* **Фінансовий статус** (наприклад, «Оплачено»)
* **Статус виконання** (наприклад, «Виконано»)
* **Канал продажу**
* **Тип чека** (наприклад, «Повна оплата»)

![Правило: оплачено + виконано](https://mintcdn.com/plata-app/nftCbsHcUcF0Rm8U/images/checkbox/auto-rules.png?fit=max\&auto=format\&n=nftCbsHcUcF0Rm8U\&q=85\&s=245b2adb530b7c078f2c356b5544e8fe)

**Логіка:** умови поєднуються через «і», значення всередині однієї умови — через «або». Перемикач **Автоматично** вмикає або вимикає автофіскалізацію загалом, а перемикач біля правила — окреме правило.

> [!WARNING]
>
> Якщо замовленню підходить **кілька правил**, чек **не створюється**. Робіть умови правил такими, щоб вони не перетиналися.

Типове правило для оплати при отриманні: **Фінансовий статус = Оплачено** і **Статус виконання = Виконано**.

## 7. Блок «Фіскалізація» в замовленні Shopify

На сторінці замовлення в адмінці Shopify з’являється блок **Фіскалізація** від Plata App.

| Стан замовлення | Що показує блок |
| - | - |
| Не оплачено | «Спершу оплатіть замовлення» — фіскалізувати ще не можна. |
| Оплачено | «Замовлення можна фіскалізувати» і кнопка **Фіскалізувати** з попереднім переглядом: каса, позиції, кількість, ціна, знижка, сума, податок і оплата. |
| Чек створено | Фіскальний номер, касу, дату і дії з чеком. |

![Чек створено](https://mintcdn.com/plata-app/nftCbsHcUcF0Rm8U/images/checkbox/receipt-created.png?fit=max\&auto=format\&n=nftCbsHcUcF0Rm8U\&q=85\&s=bcec0fa2e6af44c1840c352596d8c798)

### Дії з готовим чеком

* **Роздрукувати** — попередній перегляд чека і друк із Shopify.
* **Відкрити чек** — сторінка чека Checkbox, де його можна зберегти або переглянути в ДПС.
* **Копіювати посилання** — посилання на чек для покупця. Якщо браузер не дає скопіювати, посилання з’явиться в полі під кнопками.
* **Історія** — усі фіскальні операції замовлення.

### Скасування фіскалізації

**Скасувати фіскалізацію** → **Створити чек повернення**.

![Підтвердження чека повернення](https://mintcdn.com/plata-app/nftCbsHcUcF0Rm8U/images/checkbox/receipt-return.png?fit=max\&auto=format\&n=nftCbsHcUcF0Rm8U\&q=85\&s=71d1f2af1ea8cf699729f49ee80b15cb)

* Створюється **повний фіскальний чек повернення**.
* **Гроші покупцю не повертаються** — повернення коштів робіть окремо в Shopify або платіжному сервісі.
* Новий чек для цього замовлення можна створити **лише вручну**.

## Журнал

Унизу сторінки інтеграції — **Журнал** з останніми фіскальними операціями магазину та їхніми статусами: «Фіскалізовано», «Очікує», «Помилка» тощо.

## Перевірка перед запуском

1. Тестова каса підключена, **Перевірити підключення** показує «Підключення працює».
2. Створіть тестове замовлення, позначте його як оплачене і виконане.
3. У блоці **Фіскалізація** з’явилося «Чек створено.»
4. Відкрийте чек, перевірте суму, позиції, податок і тип оплати.
5. Перемкніть касу на **Бойову** і знову натисніть **Перевірити підключення**.

## Часті проблеми

> **Чек не створився автоматично**
>
> Перевірте, що перемикач **Автоматично** увімкнений, замовлення відповідає умовам правила, і йому не підходить кілька правил одночасно. Якщо так і є — подивіться статус у **Журналі**.

> **«Спершу оплатіть замовлення»**
>
> Фіскалізувати можна лише оплачене замовлення. Позначте оплату в Shopify (**Mark as paid**) або дочекайтеся підтвердження платежу.

> **Помилка підключення каси**
>
> Перевірте ліцензійний ключ каси й PIN касира в кабінеті Checkbox, збережіть їх заново і натисніть **Перевірити підключення**. Переконайтеся, що вибрано правильний тип каси (тестова / бойова).

> **Покупець не отримав чек на email**
>
> Перевірте, що в параметрах чеків увімкнено **Надсилати покупцю** і в замовленні вказаний коректний email. Посилання на чек завжди можна скопіювати з блоку **Фіскалізація**.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.