Получить список ККТ

Внимание

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

Возвращает список KKT.

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

GET https://api.ofd.yandex.net/{v1}/cashboxes
 ? [sn=<string>]
 & [fiscal_drive_sn=<string>]
 & [rn=<string>]
 & [company_inncompany_inn=<string>]
 & [company_kpp=<string>]
 & [company_ogrn=<string>]
 & [company_id=<number>]
 & [retail_point_id=<number>]
 & [model_id=<number>]
 & [fiscal_drive_model_id=<number>]
 & [rn_status=<string>]
 & [limit=<integer>]
 & [offset=<integer>]
-  `missing` — статус неизвестен;
-  `waiting` — ожидает подтверждения;
-  `confirmed` — подтвержден чеком;
-  `duplicate` — является дублем. Перевод в данный статус выполняется сотрудником технической поддержки Яндекс ОФД по запросу клиента.
  • v1
    Номер версии API ОФД.
  • sn
    Серийный (заводской) номер ККТ.
  • fiscal_drive_sn
    Серийный (заводской) номер ФН.
  • rn
    Регистрационный номер ККТ. Выдается ФНС при регистрации кассы.
  • company_inn
    ИНН компании.
  • company_kpp
    КПП компании.
  • company_ogrn
    ОГРН компании.
  • company_id
    Идентификатор компании системе Яндекс ОФД.
  • retail_point_id
    Идентификатор точки продаж в системе Яндекс ОФД.
  • model_id
    Идентификатор модели ККТ.
  • fiscal_drive_model_id
    Идентификатор модели ФН.
  • rn_status

    Текущий статус регистрационного номера ККТ в системе Яндекс ОФД. Возможные значения:

    • missing — статус неизвестен;
    • waiting — ожидает подтверждения;
    • confirmed — подтвержден чеком;
    • duplicate — является дублем. Перевод в данный статус выполняется сотрудником технической поддержки Яндекс ОФД по запросу клиента.
  • limit
    Максимальное количество объектов, возвращаемое в ответе.
  • offset
    Смещение от начала списка объектов.

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

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

Заголовок Значение
X-Yandex-Key <аутентификационный ключ>
X-OFD-Key <авторизационный ключ>

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

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

[
  {
    "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}"
  }
]
  • company_id
    Идентификатор компании системе Яндекс ОФД.
  • retail_point_id
    Идентификатор точки продаж в системе Яндекс ОФД.
  • model_id
    Идентификатор модели ККТ.
  • sn
    Серийный (заводской) номер ККТ.
  • fiscal_drive_model_id
    Идентификатор модели ФН.
  • fiscal_drive_sn
    Серийный (заводской) номер ФН.
  • terminal_sn
    Серийный (заводской) номер автоматического устройства для расчетов (если ККТ является частью данного устройства).
  • is_autonomous_only
    Применяется в составе автоматического устройства для расчетов.
  • is_excise
    Используется при продаже подакцизных товаров.
  • is_bank_payment_agent
    Используется при осуществлении деятельности банковского платежного агента (субагента).
  • is_lottery
    Используется при приеме денежных средств при реализации лотерейных билетов, электронных лотерейных билетов, приеме лотерейных ставок и выплате денежных средств в виде выиграша при осуществлении деятельности по организации и проведению лотерей.
  • is_conduct_of_gambling
    Используется при приеме ставок и выплате денежных средств в виде выигрыша при осуществлении деятельности по организации и проведению азартных игр.
  • is_service_only
    Используется только при оказании услуг (в случае регистрации автоматизированной системы для бланков строгой отчетности).
  • is_payment_agent
    Используется при осуществлении деятельности платежного агента (субагента).
  • id
    Идентификатор ККТ в системе Яндекс ОФД.
  • rn
    Регистрационный номер ККТ. Выдается ФНС при регистрации кассы.
  • rn_status

    Текущий статус регистрационного номера ККТ в системе Яндекс ОФД. Возможные значения:

    • missing — статус неизвестен;
    • waiting — ожидает подтверждения;
    • confirmed — подтвержден чеком;
    • duplicate — является дублем. Перевод в данный статус выполняется сотрудником технической поддержки Яндекс ОФД по запросу клиента.
  • rn_status

    Текущий статус регистрационного номера ККТ в системе Яндекс ОФД. Возможные значения:

    • missing — статус неизвестен;
    • waiting — ожидает подтверждения;
    • confirmed — подтвержден чеком;
    • duplicate — является дублем. Перевод в данный статус выполняется сотрудником технической поддержки Яндекс ОФД по запросу клиента.
  • payment_status

    Статус оплаты ККТ. Возможные значения:

    • paid — оплачен;
    • unpaid — неоплачен.
  • version_text
    Служебный параметр. Используется для обратной совместимости.
  • usage_status
    Статус использования ККТ.
    • new — новый;
    • used — в работе.
  • client_id
    Идентификатор клиента, зарегистрировавшего компанию в системе Яндекс ОФД.
  • promo_status
    Статус промопериода для ККТ. Во время промопериода ККТ работает в штатном режиме.
    • before_promo — промопериод не активирован.
    • promo — для ККТ действует промопериод.
    • after_promo — промопериод завершен.
  • paid_at
    Дата оплаты ККТ.
  • alias
    Название ККТ, которое будет отображаться в Личном кабинете. Если параметр не задан, в Личном кабинете отображаются последние четыре цифры серийного номера KKT (sn).

Коды ответа

Список кодов, которые поддерживаются в API ОФД см. в разделе Коды ответов и ошибки.

Пример запроса

Метод и адрес:

GET https://api.ofd.yandex.net/v1/cashboxes

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

x-yandex-key: 74f...e8ca
x-ofd-key: eka...b17eae

Пример запроса в формате cURL
curl -X GET \
  https://api.ofd.yandex.net/v1/cashboxes \
  -H 'x-ofd-key: eka...b17eae' \
  -H 'x-yandex-key: 74f...e8ca' \
  -d '{
  "company_id": 587,
  "sn": "00000000381007926490",
  "fiscal_drive_sn": "8710000100875130"
}'

Ответ:

[
  {
        "is_payment_agent": false,
        "rn_status": "missing",
        "promo_status": "before_promo",
        "is_autonomous_only": false,
        "fiscal_drive_model_id": null,
        "company_id": 587,
        "version_text": null,
        "is_conduct_of_gambling": false,
        "is_bank_payment_agent": false,
        "is_service_only": false,
        "usage_status": "new",
        "sn": "00000000381007926499",
        "fiscal_drive_sn": "8710000100875131",
        "payment_status": "unpaid",
        "terminal_sn": null,
        "retail_point_id": null,
        "is_lottery": false,
        "id": 902,
        "rn": null,
        "model_id": null,
        "alias": null,
        "client_id": 88,
        "paid_at": null,
        "is_excise": false
  }
]