Регистрация ККТ в ФНС с использованием КЭП

Внимание

Новые ключи временно не выпускаются в связи с обновлением продукта.

Внимание

Данный способ регистрации возможен только при наличии у клиента КЭП.

Чтобы поставить на учет в ФНС новый кассовый аппарат (ККТ):

  1. Получите идентификатор ККТ: GET /cashboxes.

    Если ККТ нет в системе Яндекс ОФД, зарегистрируйте его.

  2. Запросите список регистраций для ККТ, чтобы узнать, был ли запущен процесс регистрации ККТ ранее: GET /cashboxes/{cashbox_id}/registration.

    Если процесс запущен не был, инициируйте новую регистрацию ККТ: POST /cashboxes/{cashbox_id}/registration.

  3. Скачайте заявление на регистрацию ККТ: GET /cashboxes/{cashbox_id}/registration/{registration_id}/declaration.

  4. Предоставьте на подпись клиенту файл с заявлением.

    Требования к подписи заявления
    • Вид: отделенная электронная подпись.
    • Формат файла: pkcs#7.
    • Название файла:
      • sign_base64 — если подпись передается в кодировке base64;
      • sign — если подпись передается в формате xml.
  5. Загрузите файл с отделенной электронной подписью в систему Яндекс ОФД: POST /cashboxes/{cashbox_id}/registration/{registration_id}/declaration/upload_sign. Подписанное заявление будет передано в ФНС автоматически.

  6. Подождите, пока заявление пройдет обработку в ФНС. Процесс обработки заявления можно отслеживать по изменению статуса регистрации. Яндекс ОФД информирует клиента с помощью SMS о каждой смене статуса.

  7. Убедитесь, что регистрация находится в статусе wait_report.

    Сформируйте отчет о регистрации на кассовом аппарате. Отчет автоматически поступит в систему Яндекс ОФД. После его обработки статус регистрации сменится на «wait_report_sign».

  8. Скачайте отчет о завершении регистрации ККТ: GET /cashboxes/{cashbox_id}/registration/{registration_id}/report.

  9. Предоставьте на подпись клиенту файл с отчетом.

    Требования к подписи отчета
    • Вид: отделенная электронная подпись.
    • Формат файла: pkcs#7.
    • Название файла:
      • sign_base64 — если подпись передается в кодировке base64;
      • sign — если подпись передается в формате xml.
  10. Загрузите файл с отделенной электронной подписью в систему Яндекс ОФД: POST /cashboxes/{cashbox_id}/registration/{registration_id}/report/upload_sign. Подписанный отчет будет передан в ФНС автоматически.

  11. Подождите завершения регистрации ККТ в ФНС (статус finished). После этого ККТ можно использовать в работе.

Чтобы узнать статус регистрации, выполните запрос: GET /cashboxes/{cashbox_id}/registration/{registration_id}.

Возможные значения:

  • wait_decl_sign — ожидание подписи заявления на регистрацию;
  • wait_irud — ожидание ответа от ИРУД (Информационный реестр участников документооборота);
  • wait_rnm — ожидание ответа от ФНС о присвоении РНМ;
  • wait_report — ожидание отчета о регистрации, сформированного посредством ККТ;
  • wait_report_sign — ожидание подписи отчета о регистрации;
  • wait_final_response — ожидание финального ответа от ФНС с карточкой ККТ;
  • finished — карточка ККТ получена;
  • error — ошибка. Описание ошибки содержится в параметре error_description.

Если возникла ошибка (статус error), изучите ее причину, исправьте и продолжите процедуру регистрации.