Ошибки обмена
актуальная
Сообщение, причина и что делать. Текст приходит в поле info, на TCP иногда в message.
Связь с кассой
| Сообщение | Канал | Причина | Что делать |
|---|
YaKassa session not Found | HTTP | токен неизвестен: обмен выключен, токен пересоздан или приложение давно не выходило на связь | проверить Обмен по HTTP и токен на кассе |
YaKassa session closed | HTTP | касса молчит больше 2 минут | открыть приложение, дождаться зелёного индикатора |
YaKassa session not working | HTTP | касса не забрала документ за 6 секунд | повторить с тем же id |
Request already working | HTTP | идёт обработка предыдущего запроса | подождать 1–2 секунды, повторить |
Ошибка связи с сервером : … | оба | облачная касса не дозвонилась до сервера | повторить с тем же id, второго чека не будет |
api … не поддерживается | TCP | неверный путь | сверить с таблицей методов |
Порядок запросов
| Сообщение | Канал | Причина | Что делать |
|---|
Request absent. First post request of check | HTTP | запрошен статус документа, который не отправляли | сначала receipt-v4 |
The ID does not match the original request. | HTTP | спрашивают статус не последнего документа | завершать документы по одному |
Документ не найден. Сначала отправьте документ | TCP | неизвестный id, результат вытеснен или приложение перезапущено | проверить чек, прежде чем повторять |
Очередь документов заполнена (8), повторите позже | TCP | 8 документов уже ждут | снизить темп |
Касса не приняла документ в обработку | оба | приложение было свёрнуто дольше 120 секунд | открыть приложение, повторить с тем же id |
Превышено время обработки документа | оба | документ висел в работе 3 минуты | проверить кассу, спрашивать статус с тем же id, затем поиск |
Нет результата в течении 20 секунд | TCP | старый синхронный /gate/receipt не дождался | спросить receipt-status-v4 с тем же id, перейти на v4 |
Документ
| Сообщение | Канал | Причина | Что делать |
|---|
Ошибка в теле запроса | TCP | неверный JSON | проверить сериализацию и UTF-8 |
Отсутствует тело запроса | TCP | POST без тела или без Content-Length | исправить клиент |
Отсуствует id заказа, Отсуствует операция, Отсутствуют продукты | TCP | не заполнены обязательные поля. Опечатки в словах есть и в ответе кассы | проверить документ |
Ошибочная операция | оба | operation не из допустимых | см. поля |
Ошибка налога vat_value, st_value | оба | недопустимая ставка | см. проверки |
Отсутствует название позиции : … | HTTP | у обычной позиции нет name | заполнить name |
Сумма по продуктам … не соответствует переданной сумме … | оба | cash_sum + cashless_sum не равно сумме позиций. На receipt-v4-1 так же отвечает запрос только с cashless_sum | см. смешанная оплата |
Exception : null на receipt-v4-1 | HTTP | передан только cash_sum | передать и cashless_sum, при необходимости 0 |
Недопустимые значения для cash_sum… | оба | суммы отрицательные, на receipt-v4-1 ещё и если не передано ни одной | см. смешанная оплата |
Недопустимые сочетание параметров fiscal==false, cashless=false | оба | запрещённая комбинация | см. проверки |
Недопустимые сочетание параметров fiscal==false, skip_bank=true | оба | документ не сделал бы ничего | см. skip_bank |
Возвраты
| Сообщение | Канал | Причина | Что делать |
|---|
При возврате необходимо поле fd_number | оба | возврат без fd_number | указать fdNumber исходного чека |
Combination of origin fd number and origin fm serial number does not exist. | оба | ответ налоговой: чека с таким номером у этого фискального модуля нет | проверить fd_number, исправить и повторить с тем же id |
Для возврата на карту необходимо поле rrn исходной оплаты. Если продажа прошла без банка - передайте skip_bank=true | оба | возврат по безналу без rrn и skip_bank | см. возвраты |
Возврат на карту без чека невозможен : банк кассы не выполняет возвраты | оба | fiscal: false на кассе, банк которой не делает возвратов | вернуть деньги в приложении банка, чек отдельным документом |
Чек оплачен по QR. Возврат оплаты по QR невозможен | оба | продажа прошла по QR через KICB | вернуть деньги вне кассы |
Смена и банк
| Сообщение | Канал | Причина | Что делать |
|---|
Смена закрыта. Откройте смену, Смена закрыта, Смена устарела | оба | нет открытой смены или она старше суток, автооткрытие выключено | открыть смену, повторить с тем же id |
Не удалось открыть смену, Не удалось переоткрыть смену | оба | автооткрытие включено, но смена не открылась | открыть смену на кассе, повторить |
Нет настроек для оплаты через банк | оба | просили безнал, терминал не настроен | настроить безналичную оплату в YaKassa |
Обмен валюты
| Сообщение | Канал | Причина | Что делать |
|---|
Недопустимые сочетание параметров fiscal==false и обмен валюты | оба | обмен без чека запрещён | убрать fiscal: false |
Валюта XXX отсутствует в справочнике кассы, Неизвестная валюта | оба | код не из справочника | см. обмен валюты |
В одном чеке нельзя смешивать обмен валюты и обычные позиции | оба | часть позиций с currency, часть без | разнести по документам |
Курс валюты … должен быть больше нуля, Сумма в валюте … должна быть больше нуля | оба | ноль или отрицательное значение | исправить |
На балансе недостаточно : USD | оба | не хватает валюты или сомов | пополнить /gate/cash |
Поиск чека
| Сообщение | Канал | Причина | Что делать |
|---|
Чек не найден | HTTP | у кассы kkmID нет такого чека | см. если чек не найден |
ККМ не найдена | HTTP | неверный kkmID | взять kkmID из ответа на документ |
Ошибки серверной фискализации описаны отдельно.