Receipt.Get

Возвращает чек этой кассы по ID или постраничный список за период, включая чеки, созданные вне интеграции.

Для авторизации передайте Bearer-токен интеграции в HTTP-заголовке. Подробнее — авторизация API.

Входные параметры

Передайте либо непустой id, либо оба параметра периода. Совмещать их нельзя. Для поиска по ID page равен 1; результат сохраняет ту же структуру page, page_size, total, items, где total: 1 и один чек в items. Неизвестный ID возвращает 701001.

Порядок за период — от новых чеков к старым; при одинаковом времени используется устойчивый порядок по ID. Пустая страница возвращает items: []. total — количество чеков за весь период. Новые чеки между запросами могут сдвигать страницы; для последовательной выгрузки используйте закрытый период.

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

Authorization: Bearer <integration-token>
Content-Type: application/json;charset=utf-8

{
    "jsonrpc": "2.0",
    "method": "Receipt.Get",
    "params": {
        "id": "0123456789abcdef0123456789abcdef"
    },
    "id": 3
}

{
    "jsonrpc": "2.0",
    "method": "Receipt.Get",
    "params": {
        "date_from": "2026-11-01 00:00:00",
        "date_to": "2026-11-02 00:00:00",
        "page": 1,
        "page_size": 30
    },
    "id": 3
}

Выходные параметры

Сумма чека указана после скидок в тийинах; признак возврата передаётся отдельно в is_return.

При получении по ID и за период поля receipt_no, fiscal_sign и qr_url всегда содержат ***. Полные реквизиты печатаются на бумажном чеке. ID чека и остальные поля возвращаются без маскирования.

Массив positions возвращается и при поиске по ID, и в списке за период. Он содержит данные на момент оформления чека, независимо от текущих данных товара. Сумма позиции равна цене до вычетов за всё количество за минусом discount и other; price округляется отдельно.

Массив payments содержит сохранённые оплаты чека, включая смешанную оплату несколькими способами. Он возвращается при поиске по ID и за период. Номер банковской карты в ответ не включается.

Пример ответа

{
    "jsonrpc": "2.0",
    "result": {
        "page": 1,
        "page_size": 30,
        "total": 1,
        "items": [
            {
                "id": "0123456789abcdef0123456789abcdef",
                "code": "SALE-001",
                "date_time": "2026-11-01 12:00:00",
                "type": 0,
                "is_return": false,
                "receipt_no": "***",
                "terminal_id": "TEST000000001",
                "fiscal_sign": "***",
                "qr_url": "***",
                "amount": 10000,
                "positions": [
                    {
                        "name": "Тестовый товар",
                        "barcode": "4780000000000",
                        "icps": "00000000000000000",
                        "quantity": 1000,
                        "price": 10000,
                        "discount": 0,
                        "other": 0,
                        "amount": 10000,
                        "vat_value": 0,
                        "package_code": null,
                        "label": ""
                    }
                ],
                "payments": [
                    {
                        "type": 1,
                        "name": "Наличные",
                        "amount": 4000,
                        "card_type": null,
                        "rrn": ""
                    },
                    {
                        "type": 2,
                        "name": "Банковская карта",
                        "amount": 6000,
                        "card_type": 2,
                        "rrn": "123456789012"
                    }
                ]
            }
        ]
    },
    "ok": true,
    "id": 3
}

Повторный вызов не изменяет чеки. Ошибки: общие ошибки; 701003 — некорректный ID, сочетание фильтров, период, page или page_size; 701001 — чек с указанным ID не найден.