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

Получить фискальный документ по идентификатору

Получить фискальный документ по идентификатору

Команда API ОФД позволяет получить фискальный документ по его идентификатору. Документ можно запросить в формате *.json или *.pdf.

Метод: GET

Адрес запроса: https://api.sbis.ru/ofd/v1/orgs/<inn>/kkts/<regId>/storages/<storageId>/docs/<docNum>?docDate=<docDate>&format=<format>

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

Параметр

Тип

Описание

Пример

innString, обязательныйИНН организации-владельца ККТ1234567890
regIdString, обязательныйРегистрационный номер ККТ123456
storageIdString, обязательныйРегистрационный номер ФН9999999
docNumString, обязательныйНомер запрашиваемого фискального документа123
docDateString, обязательныйДата запрашиваемого документа2018-11-23T12:10:04
formatString, обязательный Формат выдачи документа:
  • «json» — в виде *.json,
  • «pdf» — в виде *.pdf
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/123456/storages/9999999/docs/123?docDate=2018-11-23T12:10:04&format=json
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"
}