Подключение ОФД.ру по API
Чеки — главный источник данных: из них берутся выручка и продажи по позициям, а по ним и техкартам считается себестоимость. BEAN FINANCE забирает чеки из ОФД.ру автоматически, загружать файлы не нужно.
Сейчас поддерживается только ОФД.ру. Если у вас другой оператор фискальных данных, пропустите этот шаг в мастере и напишите нам.
Где взять ключ API
- Войдите в личный кабинет ОФД.ру.
- Откройте «Настройки» → «Управление передачей данных» → «Ключи доступа к API ОФД».
- Создайте ключ и скопируйте его. Ключ действует год — потом его нужно будет выпустить заново и вписать в BEAN FINANCE.
Как подключить
Подключить ОФД может администратор — в мастере «Начало работы» или в разделе «Настройки».
- Откройте «Настройки» → блок «ОФД.ру — автозагрузка чеков по API».
- Укажите «ИНН» организации или ИП, на которых зарегистрирована касса.
- «Рег. номер кассы (РНМ)» — регистрационный номер кассы. Если касс несколько, перечислите номера через запятую. Если оставить поле пустым, загрузятся все кассы, доступные по ключу.
- Вставьте «Ключ API». Чтобы не менять уже сохранённый ключ, оставьте поле пустым.
- Отметьте «Синхронизировать каждый час» и нажмите «Сохранить».
В мастере есть кнопка «Проверить ключ»: она покажет список касс, которые видны по ключу.
Как работает синхронизация
- Каждый час (в 10 минут) догружаются новые чеки — начиная с предыдущего дня от последнего загруженного.
- Ночью перепроверяется последняя неделя: так подтягиваются поздние и исправленные чеки.
- Повторная загрузка заменяет чеки за тот же период, поэтому дублей не бывает.
- Если синхронизация трижды подряд не прошла или новых чеков нет больше суток, администраторам с привязанным Telegram придёт сообщение от бота (не чаще раза в 6 часов).
Где смотреть статус
Раздел «Эквайринг» → карточка «Чеки ОФД · автосинхронизация по API»: сколько строк чеков в учёте, за какой период, время и результат последней синхронизации.
Администратор или управляющий может нажать «Синхронизировать сейчас», не дожидаясь следующего часа.
Если что-то не так
| Признак | Что проверить |
|---|---|
| «ключ API не задан» | Впишите ключ в «Настройках» |
| «автосинхронизация выключена» | Включите «Синхронизировать каждый час» |
| Последняя синхронизация с ошибкой | Не истёк ли ключ, верны ли ИНН и РНМ |
| Чеков нет больше суток | Работает ли касса и передаёт ли она чеки в ОФД |
Файлы с чеками вручную загружать не нужно: сервис их не принимает — только реестр эквайринга.