Помощь кассиру
Разделы API

Поля документа

актуальная

Что передаётся в receipt-v4 и какие проверки проходит документ. Формат один для HTTP и TCP.

Пример

JSON
{
  "id": "07b2f33c-0eaf-4353-abbf-794654654654",
  "fiscal": true,
  "cashless": true,
  "operation": "INCOME",
  "printInfo": "Спасибо за покупку",
  "products": [
    {
      "id": "456587988",
      "name": "Молоко",
      "price": 100.00,
      "quantity": 6.1,
      "vat_value": 12.0,
      "st_value": 1.0,
      "calcItemAttributeCode": "0"
    }
  ]
}

Документ

ПолеТипОбяз.Описание
idStringдаGUID заказа. Защищает от дублей, по нему запрашивается статус
operationStringдаINCOME продажа, INCOME_RETURN возврат продажи, EXPENDITURE покупка, EXPENDITURE_RETURN возврат покупки
productsArrayдапозиции чека, минимум одна
fiscalBooleanнетtrue по умолчанию: пробить чек. false: только принять оплату картой, чек не формируется
cashlessBooleanнетбезналичная оплата всей суммы
cash_sumDecimalнетсумма наличными при смешанной оплате
cashless_sumDecimalнетсумма безналично при смешанной оплате
skip_bankBooleanнетtrue: безнал уже оплачен вне кассы, банк не вызывается, см. skip_bank
fd_numberStringдля возвратаномер исходного фискального документа, это fdNumber из ответа, а не ваш id
rrnStringдля возврата на картуRRN исходной оплаты, см. возвраты
printInfoStringнеттекст в конце чека
printObjectнетпечатные поля: кассир, адрес, название. На фискальную часть не влияют
needPrintBooleanнетtrue: вернуть в ответах печатные поля чека

Позиция

ПолеТипОбяз.Описание
idStringдаидентификатор товара в вашей базе
nameStringда, кроме валютынаименование
priceDecimalдацена в сомах, до 4 знаков после точки. При обмене валюты это курс
quantityDecimalдаколичество. При обмене валюты это сумма в валюте
vat_valueDecimalнетставка НДС: 0 или 12
st_valueDecimalнетставка НСП: 0, 1, 2, 3 или 5
calcItemAttributeCodeStringнет"0" товар, "1" услуга
currencyStringнетбуквенный код валюты. Поле превращает позицию в обмен валюты

Ставки должны соответствовать настройкам вашей кассы и применяемой системе налогообложения.

Проверки

Документ отклоняется при приёме, если нарушено одно из правил. Текст ошибки приходит в info или message, расшифровка в разделе ошибки.

Смотрите также