Перейти до вмісту
FOPilot

Чеки 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).