Orange Data: фискализация

Orange Data — облачный сервис фискализации, который выбивает чеки по 54-ФЗ через API без покупки кассового аппарата. Разбираем, как подключить Orange Data к RetailCRM, чем отличается его настройка от АТОЛ и как обеспечить корректные чеки прихода и возврата.

Что такое Orange Data

Orange Data — это сервис аренды облачных касс и фискализации: магазин передаёт данные заказа, а сервис формирует фискальный чек, передаёт его в ОФД и покупателю. Как и АТОЛ Онлайн, он избавляет от покупки и обслуживания физического ККТ, но использует собственную схему авторизации на основе криптографической подписи.

• Облачные кассы — фискальный накопитель и связь с ОФД на стороне сервиса;
• API-фискализация — чек создаётся по запросу из RetailCRM;
• Подпись запросов — каждый чек подписывается закрытым ключом магазина.

Подписи и сертификаты

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

1. Ключевая пара — закрытый и открытый ключ, сгенерированные для интеграции;
2. Идентификатор клиента в системе Orange Data;
3. Сертификат для защищённого соединения с API;
4. Настройка боевого или тестового окружения.

Закрытым ключом подписывается каждый запрос на фискализацию, а Orange Data проверяет подпись открытым ключом. Это надёжно защищает данные чека, но требует аккуратной установки ключей в модуль RetailCRM.

Подключение модуля в RetailCRM

Orange Data подключается модулем из маркетплейса. Последовательность:

1. Оформите договор с Orange Data и сгенерируйте ключевую пару;
2. Установите модуль в Настройки → Интеграция → Маркетплейс;
3. Загрузите закрытый ключ и укажите идентификатор клиента;
4. Выберите систему налогообложения (СНО) магазина;
5. Свяжите фискализацию с нужными типами оплаты в Настройки → Финансы.

После активации Orange Data будет получать данные заказа при оплате и формировать чек. Проверьте на тестовом окружении, что подпись сходится и чек возвращается с фискальным признаком до перехода на бой.

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

Фискальные признаки позиций

Как и любая касса по 54-ФЗ, Orange Data требует корректных признаков по каждой позиции чека. RetailCRM передаёт их из настроек товара и типа оплаты:

Ставку НДС и признак предмета закрепляют в товарном каталоге, чтобы не заполнять их в каждом заказе. Признак способа расчёта критичен для предоплат: при частичной оплате в чеке стоит Предоплата, при полной отгрузке — Полный расчёт.

Чеки прихода и возврата

Orange Data формирует разные типы чеков в зависимости от операции:

• Приход — при оплате заказа;
• Возврат прихода — при возврате средств покупателю;
• Коррекция — для исправления ранее пробитых сумм.

Чек прихода выбивается при поступлении оплаты. Возврат оформляется из карточки заказа RetailCRM — на всю сумму или частично, и Orange Data формирует чек возврата прихода. Так фискальный учёт остаётся сбалансированным перед ФНС: каждой продаже соответствует чек, каждому возврату — свой.

Контроль ошибок фискализации

Фискализация асинхронна: запрос уходит в Orange Data, а результат возвращается отдельно. Отслеживайте состояние чека, чтобы не пропустить непробитый документ. Типичные причины ошибок:

• Ошибка подписи — неверный или скомпрометированный закрытый ключ;
• Неверная СНО — указана не та система налогообложения;
• Пустое наименование — позиция без читаемого названия;
• Нет ставки НДС — не задан налог у товара;
• Смешаны окружения — данные тестового контура на бою.

Итог

Orange Data закрывает фискализацию онлайн-оплат в RetailCRM через API и криптографическую подпись, без покупки кассового аппарата. От АТОЛ Онлайн его отличает прежде всего схема авторизации ключами — за ней нужно следить особенно внимательно. В остальном логика та же: корректные признаки позиций, чеки прихода и возврата, контроль ошибок фискализации.

Мы подключаем Orange Data под вашу СНО, устанавливаем и защищаем ключи подписи, настраиваем фискальные признаки товаров и контроль непробитых чеков, чтобы фискализация в RetailCRM была полной, законной и без ручного контроля каждого заказа.