Что такое модуль Webkassa в 1С Казахстана и как он работает?

Да, знаю. Webkassa в казахстанских конфигурациях 1С обычно используется как интеграционный модуль для фискализации чеков через сервис облачной онлайн-ККМ Webkassa.

Обычно модуль обеспечивает:

— передачу чека продажи в Webkassa;
— печать или получение электронного чека;
— фискализацию возврата продажи;
— открытие и закрытие смены;
— получение статуса операции;
— повторную отправку чека при ошибке связи;
— хранение номера чека, фискального признака и других данных фискализации;
— передачу чека по SMS или на электронную почту покупателя;
— работу с оплатой наличными, картой и другими видами расчетов.

В конфигурациях 1С для Казахстана модуль может быть реализован по-разному:

1. Внешняя обработка или расширение конфигурации
Подключается через дополнительные отчеты и обработки либо устанавливается расширением.

2. Общий модуль конфигурации
Вызовы Webkassa встроены непосредственно в документы реализации, чеки ККМ, возвраты и операции по кассовым сменам.

3. Подключаемое оборудование
В некоторых решениях Webkassa воспринимается как кассовое оборудование, хотя фактически обмен идет через HTTP API облачного сервиса.

4. Прямая интеграция с API Webkassa
Документ 1С формирует структуру чека, модуль отправляет HTTP-запрос в Webkassa, получает ответ и записывает результат в документ.

Типовая схема работы выглядит так:

Чаще всего проблемы возникают в следующих местах:

— неверный API-адрес или режим подключения, тестовый/боевой;
— неправильный логин, пароль или токен кассы;
— касса не зарегистрирована или заблокирована в Webkassa;
— смена закрыта;
— в чеке отсутствует обязательный ИИН/БИН, телефон или e-mail покупателя;
— некорректно передан признак оплаты;
— не совпадают суммы строк, скидок, оплат и итоговой суммы;
— неправильно передается ставка НДС;
— товар передается без корректного наименования, цены или единицы измерения;
— чек уже был отправлен, но 1С не получила ответ из-за обрыва связи;
— в 1С документ проводится повторно и создается дубль фискального чека;
— возврат не связан с исходным чеком;
— используется устаревшая версия модуля API;
— сервер 1С не имеет доступа к адресу Webkassa по HTTPS;
— обмен выполняется на сервере, а сертификаты или настройки доступа установлены только на клиентском компьютере.

Особенно важно различать два результата:

— ошибка отправки запроса: чек, скорее всего, не принят Webkassa;
— таймаут после отправки: чек мог быть принят, но ответ не дошел до 1С.

Во втором случае нельзя сразу отправлять чек повторно. Сначала нужно проверить статус операции по идентификатору запроса или получить список чеков в Webkassa. Иначе можно сформировать два фискальных чека на одну продажу.

В коде 1С такую интеграцию обычно строят через HTTPСоединение, HTTPЗапрос, JSON и серверный общий модуль. Для расширения безопаснее выносить работу с Webkassa в отдельный общий модуль, а в документах оставлять только вызов, например:

Настройки подключения лучше хранить не в коде обработки, а в регистре сведений или настройках организации/кассы:

— адрес сервиса;
— идентификатор кассы;
— логин;
— пароль или токен;
— режим работы;
— организация;
— магазин или торговая точка;
— таймаут подключения;
— параметры повторной проверки статуса.

Точный способ исправления зависит от того, о чем именно идет речь: установка модуля, ошибка при пробитии чека, возврат, закрытие смены, подключение к серверной 1С или доработка обмена. Также нужно учитывать конфигурацию: 1С:Бухгалтерия для Казахстана, 1С:Розница для Казахстана, 1С:Управление торговлей для Казахстана или самописная конфигурация.