
Сначала проверьте готовый путь
Для интеграции Checkbox с BAS не всегда нужно писать новый сервис. В документации Checkbox о BAS и 1С есть отдельное направление готовой интеграции. Проверять нужно точную конфигурацию, версию и сценарии вашей компании: название «BAS» объединяет разные решения.
На странице интеграции ПРРО можно описать свои системы и получить оценку. До этого полезно составить короткую матрицу: что уже покрывает модуль, что требует настройки, а чего в нём нет. Так смета будет привязана к конкретному пробелу.
Не начинайте с требования «хотим API». API — это способ обмена, а не бизнес-результат. Нужный результат — заказ и оплата находятся в согласованном состоянии, нужный чек создан, его статус известен, повторное событие не создаёт дубль, а ошибка доходит до ответственного человека.
Когда достаточно настроить модуль
Готовый модуль стоит проверить первым, если есть одна основная учётная система, стандартные продажи и поддерживаемая конфигурация. Попросите демонстрацию на копии вашей базы. Общая презентация без ваших типов оплат не отвечает на вопрос о совместимости.
Проверьте, кто сопровождает модуль и что происходит после обновления BAS. Выясните, нужно ли менять конфигурацию, как вернуть предыдущую версию и где смотреть журнал. Стоимость лицензии не равна полной стоимости эксплуатации: есть настройка, обучение, поддержка и повторная проверка после изменений.
| Ситуация | Что проверить сначала | Возможный подход |
|---|---|---|
| Стандартная продажа из BAS | Поддержка конфигурации | Готовый модуль |
| Сайт, CRM и BAS одновременно | Кто управляет статусами | Модуль плюс обмен |
| Частичные оплаты и возвраты | Полный жизненный цикл | Дополнительные правила |
| Собственная кассовая программа | Доступные методы и события | Интеграция через API |
| Дубли после сбоев | Идентификаторы и повторы | Доработка контроля |
Где начинается собственная разработка
Нестандартный сценарий часто возникает между системами. Платёжный сервис подтвердил оплату, CRM ещё не обновила заказ, а BAS уже получила повторный запрос. Без одного ответственного за состояние каждая система может считать себя главной.
Нужна согласованная цепочка событий: откуда пришла оплата, как она связана с заказом, кто инициирует фискализацию, где хранится результат и кто повторяет неудачную попытку. Модель AI не должна самостоятельно решать сумму или момент финансовой операции.
Новая разработка может понадобиться и для нескольких юридических лиц, разных касс, сложного маршрута возврата или контроля расхождений. Но каждую такую потребность нужно сверить с текущими возможностями модуля. Не стоит воспроизводить готовую функцию только потому, что её не проверили при оценке.
Какие сбои включить в приёмку
Повторите одно и то же событие оплаты дважды. Отключите сеть после отправки запроса, но до получения ответа. Перезапустите обработчик. Для каждого случая проверьте конечное состояние заказа и количество созданных чеков.
Таймаут не означает, что операция не выполнена. Сначала нужно установить результат предыдущей попытки по доступному идентификатору, а уже потом решать вопрос повтора. Именно здесь простой сценарий «ошибка — отправить ещё раз» создаёт дорогостоящие дублирования.
Добавьте закрытую смену, нехватку прав и несоответствие справочника товаров. Журнал должен содержать технический идентификатор и понятное человеку объяснение. Сообщение «что-то пошло не так» не помогает бухгалтеру закрыть день.
Как разделить ответственность
Бухгалтер определяет правила операций для вашей деятельности. Поставщик ПРРО описывает возможности сервиса. Разработчик реализует согласованный обмен и контроль. Эта статья посвящена техническому выбору; конкретные требования к фискализации нужно проверять отдельно для вашей модели работы.
Перед стартом согласуйте, кто контролирует необработанные события и что делать, если ответственный недоступен. Сохраните возможность ручного разбора без повторного запуска всего потока. Для поддержки важны не только скорость первого запуска, но и диагностика через несколько месяцев.
Описание API сверяйте с официальной спецификацией Checkbox. В техническом задании зафиксируйте версию или дату проверки документации. Наличие метода в документации ещё не доказывает, что конкретный доступ и сценарий работают в вашем аккаунте.
Что отправить для предметной сметы
Подготовьте схему систем, точную конфигурацию BAS, перечень оплат, примеры возвратов, количество касс и краткое описание нынешних сбоев. Добавьте обезличенные примеры заказа, платежа и ожидаемого документа.
Попросите разделить оценку на проверку модуля, настройку, дополнительный обмен, тесты и сопровождение. Отдельно укажите работы, без которых возможен первый запуск. Это позволяет начать со стандартного сценария и не оплачивать сразу все редкие исключения.
Если проблема шире, чем чеки, рассмотрите интеграцию BAS и CRM. Полезный результат аудита — решение «готового модуля достаточно» или чёткий перечень доработок с критериями приёмки, а не обещание автоматизировать всё без ограничений.
Частые вопросы
Нужна ли каждому магазину собственная интеграция?
Нет. Если готовый модуль поддерживает вашу конфигурацию и все рабочие сценарии, его настройки может быть достаточно.
Можно ли создавать чек по статусу «оплачено» в CRM?
Только после определения надёжного источника подтверждения оплаты и согласования правил с бухгалтером. Название статуса само по себе не описывает финансовое событие.
Какие данные нужны для оценки?
Конфигурация и версия BAS, способ приёма оплат, системы учёта заказов, кассы, примеры возвратов и список проблем текущего обмена.