Возвраты

актуальная

Возврат продажи наличными и на карту через банк: что передать и что сделает касса.

Что передать

Возврат это новый документ с новым id:

operation: INCOME_RETURN для продажи, EXPENDITURE_RETURN для покупки;
fd_number: номер фискального документа исходного чека, это fdNumber из ответа, а не ваш id;
products: что возвращаете.

Вернуть можно не больше, чем пробито, частями сколько угодно раз.

JSON

{
  "id": "<новый GUID>",
  "operation": "INCOME_RETURN",
  "fd_number": "7300",
  "cashless": false,
  "products": [ { "id": "1", "name": "Товар", "price": 100.00, "quantity": 1 } ]
}

Возврат на карту

Возврат продажи с безналом касса, как и продажу, проводит через свой банк: сначала возвращает деньги на карту, чек возврата только после успеха. Отказ или отмена в банке означают, что нет ни чека, ни денег.

Вернуть деньги банк может только по конкретной оплате, по её RRN. Поэтому о том, как прошла исходная продажа, говорите вы:

В документе возврата	Что делает касса
`rrn` исходной оплаты	возвращает на карту по этому RRN, затем пробивает чек возврата
`skip_bank: true`, продажа прошла без банка	банк не вызывает, сразу чек возврата
ни того, ни другого	отклоняет при приёме

JSON

{
  "id": "<новый GUID>",
  "operation": "INCOME_RETURN",
  "fd_number": "7300",
  "cashless": true,
  "rrn": "626711866724",
  "products": [ { "id": "sku-1", "name": "Товар", "price": 1.00, "quantity": 1 } ]
}

Где взять RRN

RRN исходной оплаты приходит в поле print.rrn ответа по продаже, если в продаже был needPrint: true. Его же можно взять из вашего журнала.

В ответе по возврату в print.rrn приходит RRN самой операции возврата. У части банков он совпадает с RRN исходной оплаты.

Особые случаи

Требование rrn касается только возврата, который касса действительно ведёт в банк. Если банк кассы возвраты не выполняет, касса сразу пробивает чек, а деньги кассир возвращает в приложении банка, как при возврате с экрана.
Возврат покупки EXPENDITURE_RETURN в банк не ходит, rrn не требует.
fiscal: false вместе с rrn это возврат на карту без чека: только банк, итоговый статус PAID. Нужен, когда чек возврата уже есть, а деньги не вернулись.
Если банк кассы возвраты не выполняет, fiscal: false отклоняется: документу без чека делать нечего.
Оплату по QR через KICB вернуть этим способом нельзя: касса ответит Чек оплачен по QR. Возврат оплаты по QR невозможен.