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

Зарегистрировать чек

Зарегистрировать чек

Команда отправляет кассовый чек на регистрацию в ОФД. В запросе передайте X-SBISAccessToken и обязательные параметры.

Метод: POST

Адрес запроса: https://api.sbis.ru/retail/sale/create

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

Параметр

Тип

Описание

Пример

companyIDString, обязательныйИдентификатор точки продаж123
kktRegNumberNumber, обязательныйРегистрационный номер ККТ0003456798763214
cashierFIOString, обязательныйФИО кассираИванов И. И.
operationTypeString, обязательныйТип операции:
  • 1 — «приход»
  • 2 — «возврат прихода»
2
cashSumString, обязательныйСумма наличными100
bankSumString, обязательныйСумма безналичнымиУказывается в запросе
internetSumString, обязательныйСумма интернет-оплатыУказывается в запросе
accountSumString, обязательныйСумма оплаты на расчетный счетУказывается в запросе
postpaySumString, обязательныйСумма постоплаты (кредит)Указывается в запросе
prepaySumString, обязательныйСумма предоплаты (аванс)Указывается в запросе
vatNoneString, обязательныйСумма «Без НДС»Указывается в запросе
vatSum0String, обязательныйСумма «НДС 0%»Указывается в запросе
vatSum10String, обязательныйСумма «НДС 10%»Указывается в запросе
vatSum20String, обязательныйСумма «НДС 20%»Указывается в запросе
allowRetailPayedNumber, обязательныйОтгрузка/списание «в минус». Если при продаже товар уйдет в минус, ККТ перестанет регистрировать чеки с этим товаром0 — запрещено,
1 — разрешено
vatSum110String, обязательныйСумма «НДС 110%»100
vatSum120String, обязательныйСумма «НДС 120%»100
nameNomenclatureList, обязательныйСписок предметов продажиинтернет-товар
barcodeNomenclatureString, необязательныйШтрихкод товарной позиции123456
priceNomenclatureString, обязательныйЦена товарной позиции100
quantityNomenclatureString, обязательныйКоличество1
measureNomenclatureString, обязательныйЕдиница измерения:
  • шт — штука
  • кг — килограмм
  • л — литр
шт
kindNomenclatureString, обязательныйТип номенклатуры:
  • т — товар
  • у — услуга
т
totalPriceNomenclatureString, обязательныйСумма предмета расчета100
taxRateNomenclatureString, обязательныйСтавка НДС номенклатуры10
totalVatString, обязательныйИтого НДС100
customerFIOString, обязательныйФИО покупателяУказывается в запросе
customerEmailString, обязательныйEmail покупателяУказывается в запросе
customerPhoneString, обязательныйТелефон покупателяУказывается в запросе
customerINNString, обязательныйИНН покупателяУказывается в запросе
customerExtIdString, необязательныйИдентификатор покупателя во внешней системеУказывается в запросе
taxSystemString, обязательныйТип системы налогообложения (СНО)
  • 1 — общая
  • 2 — упрощенная (доход)
  • 4 — упрощенная (доход - расход)
  • 16 — ЕСХН
  • 32 — патент
1
sendEmailString, условно-обязательныйАдрес эл. почты покупателя для отправки чека. Может быть указан либо телефон, либо emailtest@test.ru
sendPhoneString, условно-обязательныйТелефон покупателя для отправки чека. Может быть указан либо телефон, либо emailУказывается в запросе
propNameString, обязательныйНаименование доп. реквизитаУказывается в запросе
propVaString, обязательныйЗначение доп. реквизитаУказывается в запросе
commentString, обязательныйКомментарий к чеку, в ОФД не передаетсяТестовый чек
payMethodString, обязательныйПризнак способа расчета:
  • 1 — предоплата 100%
  • 2 — предоплата
  • 3 — аванс
  • 4 — полный расчет
  • 5 — частичный расчет и кредит
  • 6 — передача в кредит
  • 7 — оплата кредита
4
externalIdString, необязательныйУникальный идентификатор платежа4b3d1874-b47c-11ea

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

POST https://api.sbis.ru/retail/sale/create
X-SBISAccessToken: 
"IXRnMUREP2g1fi93XjYqYVRVbUdZPCxuUFpwLEVDKlspSH5MZTNweDVnJDw2d0kmUzo6RztDN2RXaiVVbFgyQTIwMjAtMDYtMDQgMDk6Mzg6MTYuODA2MzM4"
{
   "companyID": "132",
   "kktRegNumber": "0003456798763214",
   "cashierFIO": "Иванов",
   "operationType": "1",
   "cashSum": "100",
   "bankSum": null,
   "internetSum": null,
   "accountSum": null,
   "postpaySum": null,
   "prepaySum": null,
   "vatNone": null,
   "vatSum0": null,
   "vatSum10": null,
   "vatSum20": null,
   "vatSum110": null,
   "vatSum120": "100",
   "allowRetailPayed": "1",
   "nomenclatures": [
      {
         "nameNomenclature": "Интернет товар",
         "barcodeNomenclature": "123456",
         "priceNomenclature": "100",
         "quantityNomenclature": "1",
         "measureNomenclature": "ШТ",
         "kindNomenclature": "Т",
         "totalPriceNomenclature": "100",
         "taxRateNomenclature": "10",
         "totalVat": "100"
      }
   ],
   "customerFIO": null,
   "customerEmail": null,
   "customerPhone": null,
   "customerINN": null,
   "customerExtId": null,
   "taxSystem": "1",
   "sendEmail": "test@test.ru",
   "propName": null,
   "propVal": null,
   "comment": "тестовый чек",
   "payMethod": "4"
}

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

{
"Result":"{\”payId\”:  \”0f63b8d4-4190-4dd9-90e2-8347afde4674\"}
}