Интеграция 1С с Kaspi: платежи из почты и чеки Webkassa
Платежи Kaspi из почты сами превращаются в проведённые оплаты в 1С:Бухгалтерии для Казахстана, по каждой пробивается чек Webkassa. Кассовые смены закрываются вовремя, а отчёт показывает, всё ли разнесено.
- Назначение
- Разнесение платежей Kaspi и чеки Webkassa
- Формат
- Расширение конфигурации (.cfe)
- Режим работы
- Автоматически, по расписанию
- Источник данных
- Письма Kaspi о платежах
Покупатель платит через Kaspi, и на почту приходит уведомление: номер накладной, сумма, дата и идентификатор платежа. Дальше бухгалтер ищет реализацию, создаёт оплату картой, пробивает чек и следит, чтобы ничего не потерялось. При десятках платежей в день на это уходит несколько часов, и всегда есть риск ошибиться: пропустить платёж, разнести его дважды или оставить оплату без чека.
Расширение «Авиорд: Каспи-платежи» делает эту работу за бухгалтера. Оно читает письма Kaspi, создаёт и проводит оплаты, пробивает чеки в Webkassa и следит за кассовыми сменами. Человеку остаются только спорные платежи, и по каждому расширение пишет, что именно пошло не так.
Что меняется в работе
Было: письмо Kaspi → поиск реализации → оплата вручную → чек → сверка в конце дня.
Стало: письмо Kaspi → оплата и чек появляются в 1С сами → бухгалтер разбирает только то, что требует внимания.
Как это работает
Продажа. Вы оформляете в 1С «Реализацию товаров и услуг». Покупатель оплачивает её через Kaspi и указывает номер документа.
Уведомление. Kaspi присылает письмо о платеже, 1С загружает его штатным почтовым клиентом.
Оплата. Каждые 15 минут расширение разбирает новые письма, находит реализацию по номеру из письма и создаёт проведённую «Оплату от покупателя платёжной картой». Эквайрер, договор и счёт учёта берутся из настройки.
Чек. Расширение пробивает чек в Webkassa и сохраняет ссылку на чек ОФД: чек открывается прямо из документа оплаты.
Контроль. Письмо, реализация, оплата и чек связаны между собой. Если платёж разнести не удалось, письмо попадает в рабочее место оператора вместе с причиной.
Что расширение делает само
Разбирает новые письма Kaspi по расписанию. Разбор можно запустить и вручную, одной кнопкой.
Закрывает кассовую смену, которой больше 23 часов, и открывает новую. Webkassa не принимает чеки в смену старше суток, поэтому смену закрывают заранее.
Если Webkassa всё же отказала из-за смены, закрывает её принудительно и отправляет чек повторно.
Повторно пробивает чеки по оплатам, которые созданы, но не прошли фискализацию.
Повторяет обработку писем, которые не разобрались с первого раза. Число попыток ограничено.
Не даёт разнести один платёж дважды: проверяет идентификатор платежа Kaspi. Оплату, созданную вручную, расширение тоже узнаёт, если идентификатор указан в её комментарии.
Отмечает разобранные письма признаком «Рассмотрено», чтобы они не мешали в почте.
Устанавливает новые версии решения, когда в базе никто не работает.
Кому подойдёт
Магазинам и компаниям, которые принимают оплату через Kaspi и ведут учёт в 1С:Бухгалтерии для Казахстана.
Тем, у кого платежей Kaspi больше, чем бухгалтер успевает разнести вручную.
Тем, кто пробивает чеки в Webkassa и устал закрывать зависшие смены.
Тем, кто уже разносит Kaspi внешней обработкой и хочет получить контроль и отчёты.
Частые вопросы
Обязательно ли подключать Webkassa?
Нет. Фискализацию можно выключить в настройке, тогда расширение будет только создавать и проводить документы оплаты.
Нужно ли снимать конфигурацию с поддержки?
Нет. Решение поставляется как расширение, обновления Бухгалтерии устанавливаются как обычно.
Что будет, если Kaspi изменит текст письма?
Названия полей задаются в настройке разбора. Новые формулировки проверяются кнопкой «Проверить разбор», программист для этого не нужен. Если письмо не удалось разобрать, оно не пропадёт: получит статус «Ошибка разбора» и появится в отчёте.
Как обновляется решение?
Новые версии входят в подписку и устанавливаются автоматически, когда в базе никто не работает. Если вы хотите ставить обновления сами, мы включим ручной режим, и администратор будет обновлять решение одной кнопкой в рабочем месте.
Что будет, если подписка закончится?
Разбор новых писем и фискализация приостановятся. Данные, отчёты и рабочее место останутся доступны. Письма, которые пришли за время паузы, никуда не денутся: после продления расширение разнесёт их само в пределах глубины поиска (по умолчанию 3 месяца).
Работает ли решение без интернета?
Для работы с Kaspi-почтой и Webkassa интернет нужен в любом случае. Если ненадолго недоступен сервер лицензирования Авиорд, решение продолжает работать по сохранённой лицензии.
У нас несколько организаций в одной базе. Это подходит?
Да. Для каждой организации создаётся своя настройка разбора, лицензия оформляется на каждый БИН/ИИН.
Можно ли использовать решение во второй базе?
Лицензия действует в одной информационной базе. Если нужна ещё одна база, например отдельная копия для тестирования, напишите нам.
Мы уже разносим Kaspi внешней обработкой. Будут ли дубли?
Нет. Оплаты, созданные прежней обработкой, расширение находит по идентификатору Kaspi. Прежнюю обработку нужно отключить, иначе два механизма будут одновременно работать с кассовой сменой.
Разнесение платежей
Поиск реализации по номеру из письма с отбором по организации. Глубина поиска настраивается, по умолчанию это 3 месяца.
Частичная оплата: несколько платежей по одной реализации, у каждого свой чек.
Допустимое превышение остатка: расхождение в копейках не останавливает разнесение, а крупное превышение уходит на проверку оператору.
Двенадцать статусов обработки. По статусу сразу понятно, что делать: найти реализацию, проверить сумму или ничего не делать.
Фискализация в Webkassa
Чек по каждой оплате, ссылка на чек ОФД в документе.
Номер смены, номер чека и текст ошибки фискализации хранятся в базе.
Журнал кассовых смен: когда какая смена открывалась и закрывалась и почему.
Пароль от кассы хранится в защищённом хранилище платформы, а не открытым текстом.
Можно работать без Webkassa: тогда создаются только документы оплаты.
Настройка без программиста
Названия полей в письме Kaspi задаются в настройке. Если Kaspi поменяет формулировки, достаточно поправить настройку.
Проверка разбора: вставьте текст письма, нажмите «Проверить разбор» и сразу увидите, что распозналось.
Кнопка «Проверить подключение» к Webkassa прямо в настройке.
Несколько организаций, почтовых ящиков и складов (бизнес-регионов) в одной базе: на каждую связку своя настройка.
Контроль: всё ли разнесено
Рабочее место оператора. На одном экране период и итоги: сколько разнесено и на какую сумму, сколько оплат без чека, сколько писем требуют внимания, есть ли просроченные смены. Ниже список писем со статусами и причинами ошибок и состояние каждой кассы. Там же кнопки для ручных действий: повторить обработку, пробить чек, исключить письмо, которое не является платежом, закрыть просроченные смены.
Отчёт «Разнесение Kaspi-платежей» с шестью готовыми вариантами:
Сводка: сколько писем разнесено и на какую сумму, в разрезе статусов.
Реестр писем: что с каждым платежом, то есть реализация, оплата, чек и ошибка.
Проблемные письма: что нужно разобрать вручную.
Оплаты без чека: где оплата есть, а чека нет, и почему.
Контроль полноты: какие письма Kaspi разбор вообще не обработал. В норме список пуст.
Реализации без оплаты картой: где платёж не дошёл до 1С.
Команды в документах. Из письма можно разнести платёж и посмотреть результат разбора. Из оплаты открываются письмо-основание и чек ОФД, из реализации все платежи Kaspi по ней.
Переход с другой обработки
Оплаты, созданные прежней обработкой, расширение находит по идентификатору Kaspi и не дублирует.
Кнопка «Перенести историю» связывает письма с прежними оплатами за 12 месяцев, чтобы в отчётах была вся история.
Основное
- Назначение
- Разнесение платежей Kaspi и чеки Webkassa
- Формат
- Расширение конфигурации (.cfe)
- Режим работы
- Автоматически, по расписанию
- Источник данных
- Письма Kaspi о платежах
Технические данные
- Конфигурация
- 1С:Бухгалтерия для Казахстана, ред. 3.0
- Проверено на версиях
- 3.0.72 и 3.0.74
- Платформа
- 1С:Предприятие 8.3.21 и новее
- Тип базы
- Файловая и клиент-серверная
- Кассовый сервис
- Webkassa (необязательно)
Работа и обновления
- Разбор писем
- Каждые 15 минут
- Контроль кассовых смен
- Каждый час
- Снятие с поддержки
- Не требуется
- Обновления
- Автоматически, входят в подписку
- Лицензирование
- На организацию (БИН/ИИН) и одну базу
Совместимость и покупка
- Конфигурации 1С
- Бухгалтерия для Казахстана
- Варианты покупки
- Разовая покупка или подписка на 1, 3, 6, 12 мес
- Лицензия
- Привязывается к БИН организации
Что входит
- ✓Расширение «Авиорд: Каспи-платежи» (.cfe)
- ✓Руководство оператора (PDF)
- ✓Новые версии решения на весь срок подписки
Требования
- •Включён почтовый клиент 1С, уведомления Kaspi приходят на подключённую учётную запись почты
- •Заведены договор эквайринга и вид оплаты Kaspi
- •Для чеков заведена касса Webkassa (логин, пароль, ККТ)
- •Расширение подключено без безопасного режима: ему нужен доступ в интернет к Webkassa и серверу лицензирования
- •У сервера 1С есть исходящий доступ по HTTPS к license.aviord.kz
Отзывы и вопросы появляются на сайте после проверки модератором.
Как проходит подключение
- 1КонсультацияРасскажите, сколько у вас платежей Kaspi и какая касса. Подскажем, подойдёт ли решение.
- 2Оплата и лицензияПосле оплаты выдаём лицензию на вашу организацию. Она привязывается к базе при первом запуске.
- 3УстановкаРасширение устанавливается в вашу 1С:Бухгалтерию, конфигурация остаётся на поддержке.
- 4НастройкаПодключаются почта, договор эквайринга и касса Webkassa, разбор проверяется на ваших письмах.
- 5ЗапускВключается расписание. Если раньше работала другая обработка, история переносится, а обработка отключается, чтобы не было дублей.
Условия лицензии
Лицензия оформляется на одну организацию (БИН/ИИН) и одну информационную базу.
Если в одной базе ведётся учёт нескольких организаций, лицензия нужна на каждую из них.
При подписке все новые версии решения входят в стоимость и устанавливаются автоматически.
Дополнительные услуги
Установка и первичная настройка решения.
Подключение почты и Webkassa в 1С.
Доработка под нестандартный формат писем или особый порядок учёта.
Сопровождение 1С:Бухгалтерии для Казахстана.
Стоимость дополнительных услуг рассчитывается индивидуально.
