03. Где взять ключ API ОФД.ру и как его добавить
Состояние на 12.09.2026. Сейчас подключён один оператор — ОФД.ру (ofd.ru).
Зачем нужен ключ
По ключу API сервис читает ваши чеки у оператора: находит ошибочные, берёт позиции и суммы, а потом сверяет, что чеки коррекции дошли до оператора. Ключ даёт только чтение — «Сторно» через него ничего не меняет и ничего не пробивает.
Шаг 1. Получить ключ в личном кабинете ОФД.ру
По документации API ОФД (версия 1.64):
- Войдите в личный кабинет клиента на ofd.ru под пользователем, у которого полные права ко всем кассам — только такой пользователь может выпустить ключ.
- Откройте раздел «Настройки» → вкладку «Управление передачей данных».
- В блоке создания заявки запросите доступ к API ОФД. Ключ выдаётся на личный кабинет организации — на пару ИНН и КПП.
- Когда заявка обработана, ключ появляется на вкладке «Ключи доступа к API ОФД»: там видны дата создания, последняя активность, статус и само значение.
- Скопируйте значение ключа.
[требует проверки]: названия разделов личного кабинета приведены по документации оператора и
живьём в текущем интерфейсе ofd.ru нами не перепроверялись — оператор мог переименовать пункты меню.
Если не нашли — ищите в настройках слова «API» и «ключи доступа» или спросите поддержку ОФД.
Полезно знать:
- срок действия ключа — 1 год, потом его нужно выпустить заново;
- доступ можно ограничить конкретным списком касс;
- если ключ куда-то утёк, его блокируют в личном кабинете оператора — и выпускают новый.
Шаг 2. Добавить ключ в «Сторно»
- В кабинете откройте раздел «Ключ ОФД».
- Оператор — ОФД.ру (ofd.ru). Других операторов пока нет; если у вас другой — напишите нам, разберём.
- Вставьте значение в поле «Ключ API». Поле скрытое: значение не видно на экране и не попадёт в скриншот для поддержки.
- Нажмите «Сохранить и проверить».
Скриншот появится позжеЭкран: страница «Ключ ОФД» с формой подключения На снимке: выпадающий список оператора, скрытое поле «Ключ API», кнопка «Сохранить и проверить» и подпись про хранение ключа.
Что происходит дальше:
- сервис делает пробный запрос к оператору и показывает результат проверки;
- при успехе в разделе «Кассы» появляется список ваших ККТ: РНМ, заводской номер, ФН, модель и зарегистрированные системы налогообложения;
- в кабинете остаётся только отпечаток ключа (несколько символов) — само значение сервис не показывает никогда и никому, включая нашу поддержку.
Если проверка не прошла
| Что видно | Что делать |
|---|---|
| Ключ не подошёл, показан ответ оператора | проверьте, что скопировали значение целиком, без пробелов по краям |
| Ключ работает, а касс нет | значит, по этому ИНН у оператора не зарегистрировано ни одной ККТ — проверьте, тот ли это личный кабинет |
| Кассы были и пропали | ключу мог истечь год либо его заблокировали в ЛК оператора — выпустите новый и нажмите «Сохранить и проверить» |
| Нужна повторная проверка | кнопка «Проверить связь ещё раз» на той же странице; проверка идёт в фоне, страница не ждёт ответа ОФД |
Замена ключа
Новый ключ вводится в то же поле и заменяет прежний — старый отпечаток сменится на новый. Замену инициируете вы: сервис сам ключи не перевыпускает и не отзывает.
Дальше — бесплатный скан ошибок: статья 04.