Получить список перерегистраций по компании или ККТ

Возвращает список перерегистраций в ФНС, которые выполнялись для заданной компании или ККТ.

Формат запросаФормат запроса

GET https://api.ofd.yandex.net/{v1}/{object_name}/{object_id}/fiscal_corrections
 ? [reason=<enum>]
 & [status=<enum>]

• v1

  Номер версии API ОФД.

• object_name

  Объект, по которому выполняется запрос о перерегистрации ККТ. Возможные значения:

  • companies — компания;
  • cashboxes — ККТ.

• object_id

  Идентификатор объекта, по которому выполняется запрос о перерегистрациях.

• reason

  Причина перерегистрации. Можно указать несколько значений в рамках одного запроса. Возможные значения:

  • reason_ofd — смена ОФД;
  • reason_fn — смена ФНС;
  • reason_address — смена адреса;
  • reason_to_automated — переход ККТ в автоматический режим;
  • reason_to_offline — переход ККТ в автономный (оффлайн) режим;
  • reason_to_online — переход ККТ в обычный (онлайн) режим;
  • reason_user — смена пользователя ККТ;
  • reason_other — другая причина.

• status

  Статус перерегистрации. Можно указать несколько значений в рамках одного запроса. Возможные значения:

  • new — новая перерегистрация, над ней не выполнялось никаких действий;
  • proceeding — выполняется инициализация по созданию новой отправки;
  • wait_sign — ожидается подписание документов по перерегистрации;
  • wait_fns — ожидание ответа от ФНС на отправленные документы;
  • finished — перерегистрация успешно завершена;
  • error — перерегистрация завершена с ошибкой;
  • cancelled — перерегистрация отменена (удалена) пользователем.

Заголовок запросаЗаголовок запроса

Заголовки запроса должны содержать ключи (см. раздел Доступ к API):

Общий формат ответа приведен ниже. В реальном ответе порядок следования элементов может отличаться, а некоторые элементы могут отсутствовать. Также в ответе могут находиться служебные параметры, которые не описаны в документе.

Формат ответаФормат ответа

[
  {
    "cashbox_id": {number},
    "error_reason_doc_id": {number},
    "error_message": "{string}",
    "dialogue": {
         "error_message": "{string}",
         "error_code": {number},
         "error_reason_doc_id": {number},
         "signer": {
            "name": {
               "first": "{string}",
               "middle": "{string}",
               "last": "{string}"
            },
            "position": "{string}",
            "address": "{string}",
            "email": "{string}",
            "phone": "{string}"
         },
         "irud_client": "{string}",
         "reasons": {
            "reason_ofd": {boolean},
            "reason_fn": {boolean},
            "reason_address": {boolean},
            "reason_to_automated": {boolean},
            "reason_to_offline": {boolean},
            "reason_to_online": {boolean},
            "reason_user": {boolean},
            "reason_other": {boolean}
         },
         "kkt_card_pdf_doc_id": {boolean},
         "id": {number},
         "cloud_sign_id": {number},
         "error_description": "{string}",
         "need_pin_code": {boolean},
         "status": "{string}",
         "sign_id": {number}
        },
    "status": "{string}",
    "correction_doc": {
       "datetime": "string",
       "doc_number": {number},
       "fiscal_sign": {number}
    },
    "id": {number},
    "reasons": {
       "reason_ofd": {boolean},
       "reason_fn": {boolean},
       "reason_address": {boolean},
       "reason_to_automated": {boolean},
       "reason_to_offline": {boolean},
       "reason_to_online": {boolean},
       "reason_user": {boolean},
       "reason_other": {boolean}
    },
    "cashbox": {
       "company_id": {number},
       "retail_point_id": {number},
       "model_id": {number},
       "sn": "{string}",
       "fiscal_drive_model_id": {number},
       "fiscal_drive_sn": "{string}",
       "terminal_sn": "{string}",
       "is_autonomous_only": {boolean},
       "is_excise": {boolean},
       "is_bank_payment_agent": {boolean},
       "is_lottery": {boolean},
       "is_conduct_of_gambling": {boolean},
       "is_service_only": {boolean},
       "is_payment_agent": {boolean},
       "id": {number},
       "rn": "{string}",
       "rn_status": "{string}",
       "payment_status": "{string}",
       "version_text": "{string}",
       "usage_status": "{string}",
       "client_id": {number},
       "promo_status": "{string}",
       "paid_at": "{string}",
       "alias": "{string}"
    },
    "сlosed_fn": {
       "datetime": "string",
       "doc_number": {number},
       "fiscal_sign": {number}
    },
    "installed_fn": {
      "datetime": "string",
      "doc_number": {number},
      "fiscal_sign": {number}
    }
  }
]

• cashbox_id

  Идентификатор ККТ, по которому идет перерегистрация.

• error_reason_doc_id

  Идентификатор документа от ФНС с сообщением об отказе (ошибке).

• error_message

  Текст сообщения об ошибке.

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

  Код	Сообщение	Описание
  1	IRUD error	Ошибка ИРУД (ошибка проверка подписей или ошибка регистрации пользователей в ИРУД).
  2	Rejected to accept declaration	Заявление на регистрацию кассы не принято ЭДО (система электронного документооборота).
  3	Rejected to register	Заявление на регистрацию отклонено отделением ФНС.
  4	Rejected to accept	Документ не принят ЭДО.
  5	Wrong report	В ЭДО передан некорректный тип документа.
  6	Wrong fiscal sign error	У отчета о регистрации указан невалидный фискальный признак.

• dialogue

  Информация о регистрации /перерегистрации ККТ на момент запроса.

  • error_message

    Текст сообщения об ошибке.

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

    Код	Сообщение	Описание
    1	IRUD error	Ошибка ИРУД (ошибка проверка подписей или ошибка регистрации пользователей в ИРУД).
    2	Rejected to accept declaration	Заявление на регистрацию кассы не принято ЭДО (система электронного документооборота).
    3	Rejected to register	Заявление на регистрацию отклонено отделением ФНС.
    4	Rejected to accept	Документ не принят ЭДО.
    5	Wrong report	В ЭДО передан некорректный тип документа.
    6	Wrong fiscal sign error	У отчета о регистрации указан невалидный фискальный признак.