В большинстве бизнесов контрольно-кассовая машина (далее–ККМ) не работает сама по себе.
Продажа формируется в учетной системе, сайте, POS-терминале или платежном автомате, после чего данные отправляются в кассу для фискализации и передачи данных в налоговые органы.
За счет многолетнего опыта в Webkassa учтены всевозможные сценарии для надежной интеграции с системами, в которых формируются продажи. Именно поэтому его можно встроить в существующую архитектуру бизнеса быстро и с минимальными затратами.
Общая логика интеграции
Независимо от того, где формируется продажа - в POS-системе, на сайте, вендингом аппарате или в собственном программном обеспечении компании, принцип работы всегда одинаков:
система формирует данные о продаже
эти данные передаются в Webkassa через API
Webkassa отправляет чек в ОФД
ОФД фискализирует операцию и передает данные в КГД
Webkassa возвращает ответ с фискальным признаком
ваша система отображает или печатает чек
Важно знать, что касса отвечает за формированиефискального чека, а также за передачу данных ОФД и далее в налоговые органы. А интегрируемая система формирует данные о продаже и передает их в кассу, исключая ручной ввод и связанные с ним ошибки.
С чем может интегрироваться Webkassa
Webkassa можно интегрировать слюбыми системами, в которых формируется продажа, включая:
системы автоматизации торговли и склада
вендинговые и платежные автоматы
POS-терминалы
сайты, онлайн-платформы и собственные системы компании
Интеграция позволяет автоматизировать передачу данных в кассу, исключить двойной ввод и снизить влияние человеческого фактора на ошибки в суммах или пропущенную фискализацию.
Как быстро можно подключить интеграцию?
Срок подключения интеграции зависит от того, в какой системе работает клиент. Есть решения, с которыми уже реализована интеграция, а есть системы, с которыми интеграции пока не было, но техническая возможность подключения предусмотрена.
С кем уже готова интеграция?
Webkassa уже интегрирована с основными типами систем и оборудования, используемыми в бизнесе:
кофейные, торговые автоматы, флороматы, фотобудки - любая модель подойдет, для интеграции с ними вам нужно обратиться к техникам данного аппарата
Платежные автоматы
паркоматы - любая модель подойдет, для интеграции с ними вам нужно обратиться к техникам данного аппарата
POS-терминалы
Kaspi - A90, A80, Smart POS 1, Smart POS 3 Halyk - PAX (A930RTX) Forte - PAX (A930RTX) и SunMi Р2
При использовании одного из вышеупомянутых решений интеграция, как правило, настраивается в течение нескольких часов. Основное время при этом занимает получение доступов и согласований со стороны владельца системы или оборудования.
Когда требуется дополнительное время?
Дополнительные работы могут потребоваться, если используется:
собственная система компании
сайт или онлайн-платформа с индивидуальной архитектурой
новая или иностранная система автоматизации, только выходящая на рынок Казахстана
новые модели вендинговых или платежных автоматов
новые типы POS-терминалов банков
Со стороны Webkassa предусмотрены все условия для оперативного проведения интеграции. Разработчики могут получить доступ к официальной документации и тестовой среде на официальном ресурсе компании, что позволяет проводить работы без ограничений и задержек.
Что нужно для интеграции
Чтобы подключить Webkassa к своей системе или оборудованию, достаточно выполнить несколько шагов:
Передать эти данные разработчикам или подрядчику, которые настраивают вашу систему.
Все технические работы выполняются на стороне разработчиков по официальной документации Webkassa.
На этапе тестирования техническая поддержка Webkassa сопровождает процесс и отвечает на вопросы в отдельном чате.
Как начать работу с API
Для начала нужно протестировать интеграцию. Для этого существует бесплатная тестовая среда Webkassa, позволяющая проверить все основные сценарии работы с кассой.
Чтобы начать тестовую интеграцию с Webkassa через API, необходимо:
Подтвердить адрес электронной почты (если письмо не пришло, проверьте папку «Спам»)
Перейти в раздел “Кабинет интегратора”
Нажать «Добавить кассу» и получить тестовую кассу с API-KEY.
Скопировать ваш API-Key
Скачать готовую Postman-коллекцию для интеграции.
В документации доступно более 26 методов, включая:
операции по чекам
получение данных об организации
внесение и изъятие наличных
получение чека по номеру и другие
Для получения более подробной информации ознакомьтесь с инструкцией в личном кабинете, нажав на иконку вопроса.
Далее просмотрите файл “Для передачи интеграторам”:
Итог
Интеграция с Webkassa позволяет встроить кассу в любую бизнес-логику без привязки к языку программирования или архитектуре.
Открытый API, тестовая среда и единый принцип интеграции дают возможность использовать Webkassa как в типовых системах автоматизации торговли и склада, так и в сложных кастомных проектах, где важно сохранить существующие процессы и обеспечить корректную фискализацию без ручных операций.