Интеграция интернет-магазина с онлайн-кассами нужна, чтобы согласованные кассовые документы формировались из реальных событий покупки и исполнения. NetLabCS связывает состав заказа, оплату и кассовый сервис, получает итог обработки и показывает незавершённые операции. Эквайринг, касса и ОФД решают разные части процесса; подтверждённая оплата не означает автоматически готовый фискальный документ.
Где формируется чек и кто запускает операцию
Выбираем схему: кассовое оформление через платёжный провайдер, самостоятельную облачную кассу или доступный интерфейс собственной ККТ. Проверяем, какие события уже покрывает текущая настройка магазина и учёта. Второй компонент не должен повторно запускать документ по тому же основанию.
Назначаем единственного инициатора каждого типа события. Магазин может знать оформление, платёжная система — деньги, учёт — фактическую отгрузку. Интеграция получает нужные данные и связывает их, а не предполагает, что один источник автоматически содержит всю картину.
Кассовую модель и применимые реквизиты утверждает заказчик с профильным специалистом. Разработчик реализует их передачу и проверку по протоколу, не выбирает налоговый режим по названию товара и не заменяет регистрацию кассы программной настройкой.
АТОЛ Онлайн, CloudKassir и другие сервисы
Подключении АТОЛ Онлайн
Для АТОЛ Онлайн проверяем группу касс, протокол, авторизацию, регистрацию задания и итоговый статус. Детальная реализация доступна в подключении АТОЛ Онлайн. При выборе этой платформы её особенности рассматриваем в собственном маршруте, а не копируем payload другого сервиса.
Подробнее об услугеCloudKassir предоставляет отдельный API кассы и асинхронный результат: постановка в очередь не равна обработанному документу. При совместной работе с CloudPayments выясняем, где уже передаётся состав чека и какие операции запускаются платёжным контуром. Разные продукты одного поставщика тоже могут использовать разные контракты.
Для Orange Data проверяем действующий API и требования подключения, включая доступный способ подписи и тестовый контур. Для другого кассового решения выполняем такую же предметную проверку. Наличие HTTP-интерфейса не означает одинаковую поддержку специальных реквизитов и схем продаж.
Номенклатура, суммы и контакты
Состав документа включает нужные позиции, количество, цену, скидку и утверждённые признаки расчёта. Источником может быть CMS или учёт. Распределение скидки и округление должны сохранять итог; одна общая сумма без строк не заменяет модель кассового документа.
Доставка, комплект, услуга и товар могут иметь разную роль в согласованной схеме. Несколько продавцов или организаций требуют отдельной маршрутизации и реквизитов; нельзя отправлять всё на одну кассу из-за единой корзины без разбора модели.
Контакт для электронного документа проверяем в допустимом формате и используем по назначению. Адрес доставки и email получения чека — разные данные. Недостающий реквизит получает понятную ошибку и путь исправления, а операция не исчезает из контроля.
Предоплата и исполнение
Разбираем, какой документ требуется по каждому подтверждённому событию: оплате, частичному получению денег и исполнению в рамках утверждённой схемы. Момент заказа, момент банковского расчёта и передача товара могут различаться.
Для частичной отгрузки сохраняем состав и связь с исходной покупкой. Новая текущая цена каталога не должна менять уже подтверждённые данные. Если после оплаты заменили товар или отменили часть, нужен отдельный согласованный путь, а не незаметная перезапись обработанного документа.
Интеграцией платёжных систем
Платёжную часть связываем с интеграцией платёжных систем. Каждое подтверждение используется по своему смыслу: успешный чек не доказывает любой банковский статус, а банковский успех не закрывает кассовую ошибку.
Подробнее об услугеВозврат и специальные сценарии
Возврат денег и кассовое оформление обратной операции имеют отдельные идентификаторы и состояния. Связываем их с исходной покупкой и возвращаемыми позициями. Частичный состав требует корректного количества и распределённых сумм, а не автоматического возврата всего заказа.
Маркированные товары, агентские реквизиты и другие специальные условия включаем, если они есть в бизнесе. Проверяем источник данных, поддержку сервиса и конкретной конфигурации. Обычный тест немаркированного товара не подтверждает готовность всех специальных сценариев.
Исправление ошибочной операции выполняется по утверждённому маршруту и правилам сервиса. Не создаём универсальную кнопку «повторить как новую» для любого отказа: сначала устанавливаем результат и причину, затем выбираем допустимое действие.
Асинхронная обработка и ежедневный контроль
Сохраняем ID исходного события, ID задания и окончательный результат. Ожидание, успешная обработка и отказ показываются отдельно. Callback и контрольный запрос при их поддержке связываются с той же операцией; повторное уведомление об оплате не выпускает второй документ.
При потере ответа сначала выясняем состояние. Временный сетевой отказ и ошибка суммы имеют разные действия. Очередь хранит нужный контекст, а частичные ошибки не блокируют бесконтрольно весь поток без видимого объяснения.
Интеграцию с учётной системой
Сверяем оплаты и исполнение с требуемыми кассовыми результатами. Сотрудник видит отсутствующие, ожидающие и ошибочные документы, основание и следующую операцию. Для данных 1С или другого контура используем интеграцию с учётной системой, сохраняя единый источник состава.
Подробнее об услугеПриёмка и передача процесса
Проверяем согласованные продажу, предоплату, исполнение, полный и частичный возврат. Добавляем повтор события, потерю ответа, ошибочный контакт или сумму, недоступность и применимые специальные реквизиты. Сверяем позиции и итоговый статус, а не только принятие запроса.
Заказчик получает карту событий и реквизитов, рабочий обмен, журнал и инструкцию разбора ошибок. Договорные и регистрационные действия и утверждение применимых правил определяются ответственными заказчика; технический запуск подтверждает именно проверенный состав интеграции.
Вопросы об интеграции
Если эквайринг подключён, кассовый контур уже готов?
Не обязательно. Нужно проверить, кто и по каким событиям формирует документы, получает результат и обрабатывает возвраты. Банковская оплата и фискализация имеют отдельные состояния.
Можно использовать готовый модуль CMS?
Да, если он поддерживает нужную схему и совместим с источниками данных. Проверяем не только обычную продажу, но и исполнение, повторы и возвраты в применимом составе.
Кто утверждает налоговые и кассовые реквизиты?
Заказчик с профильным специалистом. Интеграция передаёт утверждённую модель по документации сервиса и выявляет технические несоответствия. Программная настройка не заменяет выбор применимых правил.
Принятое задание уже означает готовый чек?
Нет. У сервисов может быть асинхронная обработка. Сохраняем ID и получаем итог, показывая ожидание и ошибку отдельно от успеха.
Что делать с частичным возвратом?
Связать исходный заказ, денежную операцию и возвращаемые строки, затем выполнить согласованное кассовое действие и проверить его результат. Общий статус отмены не заменяет этот маршрут.
Можно повторить любой неудачный запрос с новым ID?
Нет. Сначала устанавливаем фактическое состояние и причину. Потеря ответа после обработки и подтверждённый отказ требуют разных действий; слепой повтор может создать дубль.