Внесение и изъятие
актуальнаяРегистрация наличных в кассе и пополнение баланса валют смены. Только по HTTP.
POST
/gate/cashHTTPПо TCP внесение и изъятие не поддерживаются. Без кассы используйте /gate/cash-v2.
curl -X POST 'https://ofd.yaros.kg:8143/ofd-0.0.1/gate/cash' \
-H 'token: <токен>' -H 'Content-Type: application/json' \
-d '{ "guid": "<GUID>", "operation": "ADD", "amount": 1000.00, "currency": "KGS" }'| Поле | Тип | Обяз. | Описание |
|---|---|---|---|
guid | String | да | GUID операции, обязателен всегда, в том числе для STATE. Защищает от дублей |
operation | String | да | ADD внесение, DEL изъятие, STATE состояние, прописными |
amount | Decimal | для ADD и DEL | сумма в единицах валюты: 1000.00 это 1000 сом |
currency | String | нет | код валюты, по умолчанию KGS |
print | Object | нет | печатные поля: на квитанции печатаются companyName, tin, address, cashier |
Запрос синхронный, ждёт кассу до 30 секунд.
{ "status": "OK", "shiftNumber": "717", "rnKKM": "0000000000000000", "fnKKM": "0000000000000000", "kkmID": "65f1234567890abcdef12345" }STATE проверяет, что касса на связи: ответ такой же, остатка в нём нет. Остаток по валютам виден в cash-v2 и на самой кассе.
Повтор
guid защищает от дублей: повторный запрос с тем же guid не выполнит операцию второй раз, а вернёт сохранённый результат с amount и пометкой … request result alrady exists in DB. При таймауте повторяйте с тем же guid.
Смена и валюта
- Операция должна идти последовательно с закрытием смены: дождитесь ответа, затем закрывайте. Иначе она может не попасть в итоги.
- Этим же запросом валюта попадает на баланс смены, без которого не пройдёт продажа валюты:
ADDс нужнымcurrency.