Robokassa и 1С: варианты интеграции, обмен данными и фискализация
Table of contents
Зачем и кому нужна интеграция
Интеграция 1С и Robokassa закрывает сразу три критически важных задачи: прием онлайн-платежей, автоматизацию обмена статусами заказов и корректную фискализацию чеков по 54‑ФЗ. Для компаний, которые ведут склад, бухгалтерию и продажи в 1С (УТ, БП, ERP, Розница), связка 1C—Robokassa помогает:
- уменьшить ручные операции с оплатами и возвратами;
- синхронизировать статусы заказов из интернет-магазина или CRM;
- автоматически формировать и отправлять чеки через ОФД;
- видеть полную картину по оплатам и выручке в одном окне.
Если вы уже используете онлайн-платежи и интернет-эквайринг, интеграция ускорит обработку заказов и снизит ошибки в учете. А если только выбираете провайдера платежей, посмотрите разделы про платежи и чеки.
![Схема интеграции Robokassa и 1С: платеж, уведомление, фискализация]
Варианты интеграции 1С Robokassa
Запросы вроде 1с робокасса и интеграция 1С robokassa обычно приводят к четырем моделям подключения. Ниже — краткое сравнение.
| Вариант |
Кому подходит |
Схема обмена |
Плюсы |
Минусы |
| Готовая robokassa обработка 1С (внешняя обработка или расширение) |
1С:УТ, БП, ERP, Розница, где требуется запуск из 1С |
1С формирует счет и редирект на оплату, Robokassa присылает ResultURL в 1С |
Быстрый старт, минимум доработок |
Нужен опубликованный веб-сервис 1С, администрирование веб-сервера |
| Через сайт или CMS (CommerceML) |
Есть интернет-магазин, 1С — только учет |
Оплата на сайте, статусы платежей тянутся в 1С вместе с заказами |
Самая простая интеграция, без публичного 1С |
Статусы идут через сайт, не прямой webhook в 1С |
| Прямое API из 1С (HTTP-запросы) |
Нужна гибкая логика, нестандартные сценарии |
1С сама вызывает API Robokassa, принимает webhooks |
Максимальный контроль, тонкая настройка фискализации |
Требуются доработки, поддержка API, логирование |
| Облачный коннектор-мост |
Когда 1С недоступна извне |
Robokassa -> облако -> 1С по защищенному каналу |
Не нужен внешний доступ к 1С |
Стоимость и зависимость от посредника |
Совет: начинайте с готовой обработки или связки через сайт. Если нужно больше контроля над обмен статусами 1с robokassa и фискализацией, переходите к прямой работе с API.
Что нужно для старта
Перед настройкой подготовьте:
- Доступ к Robokassa: вход и личный кабинет. Если еще не подключены — смотрите страницу подключить.
- Созданный магазин в ЛК и настроенные пароли №1 и №2, алгоритм подписи SHA‑256.
- Адреса уведомлений в ЛК: ResultURL (серверное уведомление), SuccessURL и FailURL. При необходимости ограничьте IP отправителя.
- В 1С: платформа 8.3+, опубликованный HTTP-сервис или внешний веб-сервер, права на интеграцию и обмен, настроенные ставки НДС и признаки способов/предметов расчета по 54‑ФЗ.
- Определитесь с фискализацией: будет ли Robokassa фискализировать чеки или вы печатаете чеки на ККТ из 1С. Подробнее — в разделе ниже.
![Экран настроек магазина в личном кабинете Robokassa: пароли, ResultURL, SuccessURL, FailURL]
Полезные ссылки: официальный сайт, карточка ООО Робокасса.
Обмен статусами 1С—Robokassa
Ключевое место интеграции — корректный обмен статусами 1с robokassa. Процесс обычно выглядит так:
- В 1С создается документ заказа/счета и генерируется ссылка на оплату через Robokassa.
- Покупатель оплачивает, Robokassa отправляет серверное уведомление на ResultURL.
- 1С проверяет подпись SHA‑256, сумму и номер, обновляет статус документа. В ответ 1С возвращает OK и номер заказа, чтобы Robokassa зафиксировала успешную доставку уведомления.
- Покупатель видит SuccessURL или FailURL, но именно ResultURL считается источником истины для статуса оплаты.
Сопоставление статусов удобно закрепить таблично:
| Robokassa |
1С (рекомендуемо) |
Комментарий |
| initiated/pending |
Ожидает оплаты |
Счет сформирован, оплаты нет |
| success/paid |
Оплачено |
Уведомление принято, подпись корректна |
| canceled/failed |
Отменено |
Оплата не прошла или отменена |
| refund/chargeback |
Возврат |
Создавайте документ возврата и сторнируйте чек |
| partial_refund |
Частичный возврат |
Отражайте сумму частично, корректируйте чек |
Практические советы:
- Идентификатором связки используйте InvId из Robokassa и внутренний номер документа 1С.
- Делайте идемпотентную обработку уведомлений: если уведомление пришло повторно, не дублируйте оплату.
- Логируйте сырое уведомление и результат проверки подписи.
Фискализация и чеки 1С Robokassa
Есть два основных подхода к фискализации чеков:
A. Фискализация на стороне Robokassa
- 1С при создании оплаты передает массив позиций, НДС, признак способа/предмета расчета и итоги.
- Robokassa формирует чек, отправляет в ОФД и возвращает в уведомлении фискальные реквизиты: номер фискального документа, фискальный признак, номер ФН и ссылку на чек.
- 1С записывает эти данные в документ оплаты или отдельный регистр. Это сценарий «чеки 1с robokassa» с делегированной фискализацией.
B. Фискализация на стороне 1С
- Robokassa принимает платеж, а чек выбивается вашими ККТ из 1С при поступлении оплаты.
- Важно исключить двойную фискализацию: либо Robokassa, либо ваша ККТ.
C. Гибридная модель
- Предоплата при оформлении заказа и итоговый расчет при отгрузке. Части чека фискализируются в разные моменты с корректными признаками оплаты.
Что обязательно передавать в чеке по 54‑ФЗ:
- Наименование, цена, количество, ставка НДС.
- Признак способа расчета и предмета расчета.
- Признаки агента, если есть, и коды маркировки для Честного Знака.
Подробнее о фискальных документах — раздел чеки.
Пошаговая настройка в 1С
Ниже общий порядок для конфигураций уровня УТ/ERP; точные названия пунктов могут отличаться.
- Установка: подключите внешнюю обработку или расширение 1С для Robokassa, либо реализуйте HTTP‑сервис для приема ResultURL.
- Платежный способ: создайте вид оплаты Robokassa, укажите MerchantLogin, пароли №1 и №2, метод подписи SHA‑256.
- Адреса: в настройках магазина ЛК пропишите ResultURL, SuccessURL, FailURL. Если 1С принимает уведомления, опубликуйте веб-сервис и проверьте доступность извне.
- Фискализация: выберите режим — Robokassa или ККТ 1С. В первом случае включите формирование чеков на стороне Robokassa и передачу позиций; во втором — настройте драйвер ККТ и параметры 54‑ФЗ в 1С.
- Сопоставление налогов: настройте ставки НДС и, при необходимости, отображение без НДС.
- Обмен статусами: проверьте, что документ оплаты/заказа в 1С обновляется при входящем ResultURL. Фиксируйте OK с номером документа в ответе.
- Возвраты: предусмотрите сценарии возврата и частичного возврата, синхронизируйте их с чеками коррекции.
Эта последовательность покрывает сценарии robokassa обработка 1с без лишней ручной работы.
Тестирование и мониторинг
- Включите тестовый режим в ЛК и проведите оплату на небольшую сумму.
- Проверьте, что SuccessURL отображается, а уведомление на ResultURL получено и подтверждено ответом OK с номером.
- Сверьте суммы OutSum и валюту. Ошибки округления — частая причина отказа подписи.
- Убедитесь, что чеки формируются по выбранному сценарию и сохраняются ссылки на фискальные документы.
- В 1С настройте журнал регистрации и отдельный лог интеграции, чтобы видеть входящие запросы, подписи, ответы и задержки.
![Мониторинг входящих уведомлений и ответов OK в 1С]
Безопасность и соответствие 54-ФЗ
- Проверяйте подписи SHA‑256 и держите пароли в защищенном хранилище.
- Ограничьте прием ResultURL по IP и используйте HTTPS.
- Реализуйте антидубль: одна оплата — одна запись в 1С, даже если уведомление пришло повторно.
- Для 54‑ФЗ проследите корректность предметов и способов расчета, признаков агента и возвратов, чтобы исключить двойную фискализацию.
- Храните ссылку на чек и фискальные реквизиты. Это упростит ответ на запросы ФНС и покупателей.
Типичные ошибки и как их избежать
- Несовпадение суммы и валюты между 1С и Robokassa. Решение: фиксируйте валюту платежа и приводите суммы к двум знакам после запятой.
- Неверная подпись. Решение: одинаковый порядок параметров, единый алгоритм SHA‑256, корректные пароли №1 и №2.
- Уведомления не доходят до 1С. Решение: проверьте публичный адрес, SSL‑сертификат, доступность порта и белый список IP.
- Двойная фискализация. Решение: заранее выбирайте, кто выбивает чек — Robokassa или ККТ 1С; в гибриде разделяйте предоплату и окончательный расчет.
- Потеря связи статусов. Решение: используйте устойчивый идентификатор InvId + внутренний номер, ведите журнал идемпотентности.
Документация и поддержка
Итоги и следующий шаг
Интеграция 1С robokassa решает ключевые задачи: автоматический обмен статусами, корректная передача позиций в чек и удобная работа с возвратами. Выберите подходящий сценарий — готовая обработка, через сайт, прямой API или облачный коннектор — и начните с тестового стенда. Когда процесс отработан, вы получите быструю оплату, прозрачную выручку и меньше ручных операций.
Готовы настроить и запустить интеграцию под ваш бизнес-процесс? Оставьте заявку на странице подключить и мы поможем подобрать оптимальную схему приема платежей и фискализации чеков с учетом ваших целей и требований 54‑ФЗ.