Чеки Checkbox через AI
Як працювати зі зміною і фіскальними чеками Checkbox у FOPilot: продаж, повернення, Z-звіт, перегляд чеків.
Інструменти
| Інструмент | Тип | Що робить |
|---|---|---|
checkbox_get_shift |
читання | стан поточної зміни, каса, касир, продажі й повернення за зміну |
checkbox_list_receipts |
читання | чеки за період з фіскальними номерами й сумами |
checkbox_open_shift |
дія | відкриває зміну (потрібен ключ ліцензії каси) |
checkbox_create_receipt |
незворотна | чек продажу — з позицій замовлення або з переданих позицій |
checkbox_create_return_receipt |
незворотна | чек повернення, бажано з посиланням на чек продажу |
checkbox_close_shift |
незворотна | закриває зміну і формує Z-звіт |
Чек із замовлення
«Видай чек на замовлення Prom 312874561, оплата карткою» — FOPilot візьме позиції і ціни із замовлення, переведе суми в копійки, кількості — у тисячні, як вимагає Checkbox. Якщо сума замовлення менша за суму позицій (знижка), додамо знижку на чек. За бажанням Checkbox надішле електронний чек покупцю на email — вказаний у запиті або з замовлення. Повторний чек продажу на те саме замовлення протягом 30 днів не створюється, якщо явно не дозволити повтор (allow_repeat).
Податки
Якщо ваша каса налаштована з податковими ставками, вкажіть їхні коди в налаштуваннях підключення Checkbox — вони додаються до кожної позиції. ФОП без ПДВ зазвичай не потребує податкових кодів; точні налаштування погодьте з бухгалтером.
Безпека
- Незворотні дії позначені
destructiveHint, тому Claude і ChatGPT показують їх окремо й просять підтвердження. - Ідентифікатор чека генерується до відправлення — повторний запит після обриву зв'язку не створить дубль.
- Рекомендуємо спочатку підключити тестову касу (середовище dev).