Онлайн-кассы и ОФД

Список документов по фискальному накопителю

Список документов по фискальному накопителю

Команда API ОФД позволяет получить список фискальных документов ККТ. Его можно отфильтровать по смене, дате и времени.

Метод: GET

Адрес запроса: https://api.sbis.ru/ofd/v1/orgs/<inn>/kkts/<regId>/storages/<storageId>/docs?dateFrom=<dateFrom>&dateTo=<dateTo>&shiftNumber=<shiftNumber>&startId=<startId>&limit=<limit>

Входная информация для ОФД

Параметр

Тип

Описание

Пример

innString, обязательныйИНН организации-владельца ККТ1234567890
regIdString, обязательныйРегистрационный номер ККТ, выданный ФНС123
storageIdString, обязательныйНомер фискального накопителя9999999
dateFromString, обязательныйВремя начала периода запрашиваемых документов2016-10-19T12:20:45
dateToString, обязательныйВремя окончания периода запрашиваемых документов2016-11-19T23:20:45
shiftNumberNumber, обязательныйНомер смены100
startIdNumber, обязательныйНомер фискального документа, от которого идет отсчет фискальных документов в списке100500
limitNumber, обязательныйМаксимальное количество документов в ответе. По умолчанию 10025

Возвращаемое значение

Список фискальных документов ККТ в формате *.json.

Выходная информация от ОФД

Параметр

Тип

Описание

Пример

cashTotalSumNumberИтого наличными200
creditSumNumberИтого постоплатой0
prepaidSumNumberИтого предоплатой0
provisionSumNumberИтого встречным представлением0
dateTimeNumberДата и время1576505580
ecashTotalSumNumberИтого безналичными0
fiscalDocumentFormatVerNumberВерсия формата фискальных данных:
  • 1 — ФФД 1.0,
  • 2 — ФФД 1.05,
  • 3 — ФФД 1.1.
«2»
fiscalDocumentNumberNumberНомер фискального документа (ФД)63
fiscalDriveNumberNumberНомер фискального накопителя9999078900002970
fiscalSignNumberФискальный признак документа (ФПД)3376564144
nameString (Unicode)Наименование товарной позицииТовар
ndsNumberКод налоговой ставки:
  • 1 — НДС 20%,
  • 2 — НДС 10%,
  • 3 — НДС 0%.
«Товар»
ndsSumNumberСумма НДС33
paymentTypeNumberПризнак способа расчета3
priceNumberЦена за единицу товара200
productTypeNumberПризнак предмета расчета15
quantityNumberКоличество1
sumNumberСумма (цена) позиции или товара200
kktRegIdString (Unicode)Регистрационный номер ККТ (РНМ)0000000001010172
nds18NumberИтого НДС33
operationTypeNumberТип операции, например «Кассовый чек»1
operatorString (Unicode)ФИО кассираСмирнов Ю.А.
prepaidSumNumberСумма предоплаты0
provisionSumNumberСумма постоплаты0
rawDataStringПервичные данные чекаAwDVABEEEAA5OTk5MD...
receiptCodeStringКод документа «Кассовый чек». Всегда равен «3»3
receiveDateTimeStringДата и время регистрации кассового чека2019-12-16Т 16:43:31
requestNumberNumberНомер товарной позиции в чеке1
sendDateTimeStringДата и время отправки кассового чека в ОФД2019-12-16Т 16:43:54
shiftNumberNumberНомер кассовой смены15
taxationTypeNumberТип системы налогообложения (СНО):
  • 0 — общая,
  • 1 — упрощенная (доход),
  • 2 — упрощенная (доход минус расход),
  • 3 — ЕНВД,
  • 4 — ЕСХН,
  • 5 — патент.
1
totalSumNumberИтоговая сумма по чеку200
userInnString (Unicode)ИНН организации-владельца ККТ7723721617

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

GET https://api.sbis.ru/ofd/v1/orgs/1234567890/kkts/<123>/storages/9999999/docs?dateFrom=2019-10-19T12:20:45&dateTo=2019-11-19T23:20:45&shiftNumber=15&startId=100500&limit=25
Cookie: sid=0060b537-0060b538-eeba-45ec6eb2c9016168
Content-Length: 0
Host: api.sbis.ru
User-Agent: Python-urllib/3.3
Content-Type: application/json; charset=utf-8

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

{
  "cashTotalSum": "200",
  "creditSum": "0",
  "prepaidSum": "0",
  "provisionSum": "0",
  "dateTime": "1576505580",
  "ecashTotalSum": "0",
  "fiscalDocumentFormatVer": "2",
  "fiscalDocumentNumber": "63",
  "fiscalDriveNumber": "9999078900002970",
  "fiscalSign": "3376564144",
  "items": [
    {
      "name": "3",
      "nds": "1",
      "ndsSum": "33",
      "paymentType": "3",
      "price": "200",
      "productType": "15",
      "quantity": "1",
      "sum": "200"
    }
  ],
  "kktRegId": "0000000001010172",
  "nds18": "33",
  "operationType": "1",
  "operator": "Смирнов Ю.А.",
  "prepaidSum": "0",
  "provisionSum": "0",
  "rawData": "AwDVABEEEAA5OTk5MDc4OTAwMDAygMMADc3MjM3MjE2MTcgIBAEBAA/ ==",
  "receiptCode": "3",
  "receiveDateTime": "2019-12-16Т 16:43:31",
  "requestNumber": "1",
  "sendDateTime": "2019-12-16Т 16:43:54",
  "shiftNumber": "15",
  "taxationType": "1",
  "totalSum": "200",
  "userInn": "7723721617"
}