Список чеков по регистрационному номеру кассы

Список чеков по регистрационному номеру кассы

Команда запрашивает список кассовых чеков по регистрационному номеру кассы (РНМ) за указанный период. Запрос должен содержать идентификатор группы «groupId» и точки продаж «salespoint».

Дата начала и окончания периода в запросе должны совпадать с датами в запросе списка ККТ группы.

Метод: GET

Адрес запроса: https://api.sbis.ru/rent/v1/groups//salespoints//kkts//docs?dateFrom=&dateTo=&shiftNumber=&startId=&limit=

Параметры запроса

Параметр

Тип, формат

Описание

Параметры пути
groupId*StringИдентификатор группы
salespoint*StringИдентификатор точки продаж
kkt*StringРегистрационный номер кассы
Параметры строки
dateFrom*String
YYYY-MM-DDThh:mm:ss
Начало периода, за который запрашиваются данные
dateToString
YYYY-MM-DDThh:mm:ss
Окончание периода, за который запрашиваются данные. Разница между dateFrom и dateTo не должна превышать 31 день
shiftNumberNumberНомер смены. Если не указан, берутся все смены
startId**NumberНомер чека, после которого идет отсчет документов в списке. Если не указан, документы включаются в результат с первого по порядку. За один запрос можно получить только 1000 документов. Если чеков больше, то сделайте первый запрос, запомните номер последнего полученного чека и повторите запрос, указав его в качестве startId
limitNumberКоличество чеков, которое необходимо вернуть. По умолчанию — 100. За один запрос можно получить только 1000 документов.

* — обязательный параметр.

** — условно-обязательный параметр.

Схема ответа

В ответе возвращается список фискальных документов по ККТ в формате JSON.

Поле

Тип, формат

Описание

cashTotalSumNumberИтого наличными
code NumberВид фискального документа. Возможные значения
ecashTotalSumNumberИтого безналичными
prepaidSumNumberИтого предоплатой
creditSumNumberИтого постоплатой
provisionSumNumberИтого встречными предоставлениями
DepthNumberКоличество позиций в чеке
dateTimeNumberДата и время документа
fiscalDocumentNumberNumberНомер фискального документа (ФД)
itemsArray[Object]Предметы расчета
fiscalDriveNumberStringНомер фискального накопителя
kktRegIdStringРегистрационный номер ККТ (РНМ)
operationTypeNumberПризнак расчета. Возможные значения
shiftNumberNumberНомер кассовой смены
tax10SumNumberСумма НДС 10%
tax18SumNumberТег может содержать сумму НДС 18% или НДС 20%
totalSumNumberИтоговая сумма по чеку

Формат объекта «items» (Предметы расчета).

Поле

Тип, формат

Описание

quantity NumberКоличество
name StringНаименование товара
sumNumberСтоимость предмета расчета с учетом скидок и наценок
price NumberЦена за единицу
nds18NumberСумма НДС позиции в чеке со ставкой 18% или 20%
nds10 NumberНДС итога чека со ставкой 10%
productCode StringКод товара для ФФД 1.05 и 1.1
productCodeNew Array[Object]Код товара для ФФД 1.2
unitStringЕдиница измерения предмета расчета
providerData Array[Object]Данные поставщика
providerInn StringИНН поставщика

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

GET https://api.sbis.ru/rent/v1/groups/27fc71ed1ae3441dac59a2b2a0862613/salespoints/71010566/kkts/3234585995058734/docs?dateFrom=2022-05-13T08:50:40&dateTo=2022-05-18T08:50:50&shiftNumber=107&startId=1590&limit=10
Cookie: sid=0060b537-0060b538-eeba-45ec6eb2c9016168
Content-Type: application/json; charset=utf-8

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

{
  "cashTotalSum": null,
  "code": "2",
  "creditSum": "0",
  "dateTime": "1576505580",
  "Depth": null,
  "ecashTotalSum": null,
  "fiscalDocumentNumber": "7034",
  "fiscalDriveNumber": "9999078900002970",
  "kktRegId": "0000593776058164",
  "operationType": "0",
  "prepaidSum": "0",
  "provisionSum": "0",
  "shiftNumber": "99",
  "tax10Sum": null,
  "tax18Sum": null,
  "totalSum": null
}

Пример с типом операции «кассовый чек».

{
  "cashTotalSum": "0",
  "code": "3",
  "creditSum": "0",
  "dateTime": "1578656700",
  "Depth": "3",
  "ecashTotalSum": "0",
  "fiscalDocumentNumber": "7035",
  "fiscalDriveNumber": "9289000100380529",
  "items": {
        "name": "TrendVision TV-103 видеорегистратор",
        "nds": "1",
        "ndsSum": "81616",
        "price": "489700",
        "productCode": "AAAENVPocexUcm",
        "providerData": {
                     "providerPhone": "+70090010010"
                        }
         "providerInn": "789658962314",
         "quantity": "1",
         "sum": "489700",
         "unit": "шт"
            } 
  "kktRegId": "0000593776058164",
  "operationType": "1",
  "prepaidSum": "0",
  "provisionSum": "0",
  "shiftNumber": "1260",
  "tax10Sum": "0",
  "tax18Sum": "816.16",
  "totalSum": "4897"
}
Нашли неточность? Выделите текст с ошибкой и нажмите ctrl + enter.