Sign in
Чеки

Информация о чеке

Запрос позволяет получить информацию о текущем состоянии чека по его уникальному идентификатору.

get/receipts/{receipt_id}

Path parameters

receipt_idstring required

Идентификатор чека в ЮKassa.

Example:rt-1da5c87d-0984-50e8-a7f3-8de646dd9ec9

Идентификатор чека.

Response

Запрос успешно обработан

idstring required

Идентификатор чека в ЮKassa.

type'payment' | 'refund' required

Тип чека в онлайн-кассе: приход (payment) или возврат прихода (refund).

payment_idstring

Идентификатор платежа: https://yookassa.ru/developers/api#payment_object, для которого был сформирован чек.

refund_idstring

Идентификатор возврата: https://yookassa.ru/developers/api#refund_object, для которого был сформирован чек. Отсутствует в чеке платежа.

status'pending' | 'succeeded' | 'canceled' required

Статус доставки данных для чека в онлайн-кассу. Возможные значения: pending — данные в обработке; succeeded — чек успешно зарегистрирован; canceled — чек зарегистрировать не удалось; если используете Чеки от ЮKassa: https://yookassa.ru/developers/payment-acceptance/receipts/54fz/yoomoney/basics, обратитесь в техническую поддержку, в остальных случаях сформируйте чек вручную.

fiscal_document_numberstring

Номер фискального документа.

fiscal_storage_numberstring

Номер фискального накопителя в кассовом аппарате.

fiscal_attributestring

Фискальный признак чека. Формируется фискальным накопителем на основе данных, переданных для регистрации чека.

registered_atstring date-time

Дата и время формирования чека в фискальном накопителе. Указывается в формате ISO 8601: https://en.wikipedia.org/wiki/ISO_8601.

fiscal_provider_idstring

Идентификатор чека в онлайн-кассе. Присутствует, если чек удалось зарегистрировать.

internetboolean

Признак проведения платежа в интернете (тег в 54 ФЗ — 1125) — указывает на оплату через интернет. Возможные значения: true — оплата прошла онлайн, через интернет (например, на вашем сайте или в приложении); false — оплата прошла офлайн, при личном взаимодействии (например, в торговой точке или при встрече с курьером). По умолчанию true. Если вы принимаете платежи офлайн, передайте в запросе значение false.

on_behalf_ofstring

Идентификатор магазина, от имени которого нужно отправить чек. Выдается ЮKassa. Присутствует, если вы используете Сплитование платежей: https://yookassa.ru/developers/solutions-for-platforms/split-payments/basics.

tax_system_codeinteger

Система налогообложения магазина (тег в 54 ФЗ — 1055). Для сторонних онлайн-касс: обязательный параметр, если вы используете онлайн-кассу Атол Онлайн, обновленную до ФФД 1.2, или у вас несколько систем налогообложения, в остальных случаях не передается. Перечень возможных значений: https://yookassa.ru/developers/payment-acceptance/receipts/54fz/other-services/parameters-values#tax-systems Для Чеков от ЮKassa: параметр передавать не нужно, ЮKassa его проигнорирует.

timezoneinteger

Номер часовой зоны для адреса, по которому вы принимаете платежи (тег в 54 ФЗ — 1011). Указывается, только если в чеке есть товары, которые подлежат обязательной маркировке (в items.mark_code_info передается параметр gs_1m, short или fur). Перечень возможных значений: для Чеков от ЮKassa: https://yookassa.ru/developers/payment-acceptance/receipts/54fz/yoomoney/parameters-values#timezone; для сторонних онлайн-касс: https://yookassa.ru/developers/payment-acceptance/receipts/54fz/other-services/parameters-values#timezone.

Example response

{
  "id": "rt-1da5c87d-0984-50e8-a7f3-8de646dd9ec9",
  "payment_id": "215d8da0-000f-50be-b000-0003308c89be",
  "refund_id": "215d8da0-000f-50be-b000-0003308c89be",
  "status": "succeeded",
  "fiscal_document_number": "3986",
  "fiscal_storage_number": "9288000100115785",
  "fiscal_attribute": "2617603921",
  "registered_at": "2019-05-13T17:56:00.000+03:00",
  "fiscal_provider_id": "fd9e9404-eaca-4000-8ec9-dc228ead2345",
  "items": [
    {
      "quantity": 1,
      "amount": {
        "value": "1000.00",
        "currency": "RUB"
      },
      "country_of_origin_code": "RU",
      "customs_declaration_number": "10714040/140917/0090376",
      "excise": "20.00",
      "supplier": {
        "phone": "79000000000",
        "inn": "6321341814"
      },
      "measure": "piece",
      "payment_subject_industry_details": [
        {
          "federal_id": "001",
          "document_date": "2020-11-18",
          "value": "123/43"
        }
      ],
      "product_code": "00 00 00 01 00 21 FA 41 00 23 05 41 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 12 00 AB 00",
      "mark_mode": "0",
      "mark_quantity": {
        "numerator": 1,
        "denominator": 100
      }
    }
  ],
  "settlements": [
    {
      "amount": {
        "value": "1000.00",
        "currency": "RUB"
      }
    }
  ],
  "on_behalf_of": "123",
  "receipt_industry_details": [
    {
      "federal_id": "001",
      "document_date": "2020-11-18",
      "value": "123/43"
    }
  ],
  "receipt_operational_details": {
    "created_at": "2020-07-03T11:52:31.827Z"
  }
}

Changes