БЛОГ WEBKASSA

Как интегрироваться с Webkassa

В большинстве бизнесов контрольно-кассовая машина (далее–ККМ) не работает сама по себе.
Продажа формируется в учетной системе, сайте, POS-терминале или платежном автомате, после чего данные отправляются в кассу для фискализации и передачи данных в налоговые органы.
За счет многолетнего опыта в Webkassa учтены всевозможные сценарии для надежной интеграции с системами, в которых формируются продажи. Именно поэтому его можно встроить в существующую архитектуру бизнеса быстро и с минимальными затратами.

Общая логика интеграции

Независимо от того, где формируется продажа - в POS-системе, на сайте, вендингом аппарате или в собственном программном обеспечении компании, принцип работы всегда одинаков:
  1. система формирует данные о продаже
  2. эти данные передаются в Webkassa через API
  3. Webkassa отправляет чек в ОФД
  4. ОФД фискализирует операцию и передает данные в КГД
  5. Webkassa возвращает ответ с фискальным признаком
  6. ваша система отображает или печатает чек
Важно знать, что касса отвечает за формирование фискального чека, а также за передачу данных ОФД и далее в налоговые органы. А интегрируемая система формирует данные о продаже и передает их в кассу, исключая ручной ввод и связанные с ним ошибки.

С чем может интегрироваться Webkassa

Webkassa можно интегрировать с любыми системами, в которых формируется продажа, включая:
  • системы автоматизации торговли и склада
  • вендинговые и платежные автоматы
  • POS-терминалы
  • сайты, онлайн-платформы и собственные системы компании
Интеграция позволяет автоматизировать передачу данных в кассу, исключить двойной ввод и снизить влияние человеческого фактора на ошибки в суммах или пропущенную фискализацию.

Как быстро можно подключить интеграцию?

Срок подключения интеграции зависит от того, в какой системе работает клиент. Есть решения, с которыми уже реализована интеграция, а есть системы, с которыми интеграции пока не было, но техническая возможность подключения предусмотрена.

С кем уже готова интеграция?

Webkassa уже интегрирована с основными типами систем и оборудования, используемыми в бизнесе:
  • Системы автоматизации торговли и склада
1С, UMAG, R Keeper, IIKO, МойСклад, Rubus, Birsan, Rosta, Paloma365, MasterPOS, Poster, Servio Pump, Frontol, Game Keeper, Raspberry Pi, SAP, Стандарт-Н, СКИФ, Tillypad, Kafesoft.kz, Microinvest, Битрикс24, Штрих-М, Shop Uchet, BILLZ
  • Онлайн платформы
Яндекс
  • Вендинговые аппараты
кофейные, торговые автоматы, флороматы, фотобудки - любая модель подойдет, для интеграции с ними вам нужно обратиться к техникам данного аппарата
  • Платежные автоматы
паркоматы - любая модель подойдет, для интеграции с ними вам нужно обратиться к техникам данного аппарата
  • POS-терминалы
Kaspi - A90, A80, Smart POS 1, Smart POS 3
Halyk - PAX (A930RTX)
Forte - PAX (A930RTX) и SunMi Р2
При использовании одного из вышеупомянутых решений интеграция, как правило, настраивается в течение нескольких часов. Основное время при этом занимает получение доступов и согласований со стороны владельца системы или оборудования.

Когда требуется дополнительное время?

Дополнительные работы могут потребоваться, если используется:
  • собственная система компании
  • сайт или онлайн-платформа с индивидуальной архитектурой
  • новая или иностранная система автоматизации, только выходящая на рынок Казахстана
  • новые модели вендинговых или платежных автоматов
  • новые типы POS-терминалов банков
Со стороны Webkassa предусмотрены все условия для оперативного проведения интеграции. Разработчики могут получить доступ к официальной документации и тестовой среде на официальном ресурсе компании, что позволяет проводить работы без ограничений и задержек.

Что нужно для интеграции

Чтобы подключить Webkassa к своей системе или оборудованию, достаточно выполнить несколько шагов:
  • Зарегистрироваться в тестовом кабинете Webkassa:
https://devkkm.webkassa.kz
  • Получить API-ключ и готовую Postman-коллекцию.
  • Передать эти данные разработчикам или подрядчику, которые настраивают вашу систему.
Все технические работы выполняются на стороне разработчиков по официальной документации Webkassa.
На этапе тестирования техническая поддержка Webkassa сопровождает процесс и отвечает на вопросы в отдельном чате.

Как начать работу с API

Для начала нужно протестировать интеграцию. Для этого существует бесплатная тестовая среда Webkassa, позволяющая проверить все основные сценарии работы с кассой.
Чтобы начать тестовую интеграцию с Webkassa через API, необходимо:
  1. Зарегистрироваться в тестовом личном кабинете Webkassa (https://devkkm.webkassa.kz/)
  1. Подтвердить адрес электронной почты (если письмо не пришло, проверьте папку «Спам»)
  2. Перейти в раздел “Кабинет интегратора”
  1. Нажать «Добавить кассу» и получить тестовую кассу с API-KEY.
  2. Скопировать ваш API-Key
  3. Скачать готовую Postman-коллекцию для интеграции.
В документации доступно более 26 методов, включая:
  • операции по чекам
  • получение данных об организации
  • внесение и изъятие наличных
  • получение чека по номеру и другие
Для получения более подробной информации ознакомьтесь с инструкцией в личном кабинете, нажав на иконку вопроса.
Далее просмотрите файл “Для передачи интеграторам”:

Итог

Интеграция с Webkassa позволяет встроить кассу в любую бизнес-логику без привязки к языку программирования или архитектуре.
Открытый API, тестовая среда и единый принцип интеграции дают возможность использовать Webkassa как в типовых системах автоматизации торговли и склада, так и в сложных кастомных проектах, где важно сохранить существующие процессы и обеспечить корректную фискализацию без ручных операций.
2026-02-11 16:17 #Интеграции