Все методы
Полный список методов и таблица: какая операция есть в каком способе подключения.
Что где доступно
| Операция | v4, HTTP | v4, TCP | V2 | Intent |
|---|---|---|---|---|
| Продажа, возврат | receipt-v4 | /gate/receipt-v4 | receipt-v2 | документ |
| Покупка, возврат покупки | receipt-v4 | /gate/receipt-v4 | receipt-v2 | нет |
| Оплата картой через банк | да | да | нет | да |
| Смешанная оплата | receipt-v4-1 | /gate/receipt-v4 | нет | документ |
| Смена | /gate/shift | документ в receipt-v4 | /gate/shift-v2 | документ SHIFT |
| Внесение и изъятие | /gate/cash | нет | /gate/cash-v2 | нет |
| Обмен валюты | да | да | да | нет |
| Оплата картой без чека | документ fiscal: false | он же или /payment | нет | документ fiscal: false |
| Поиск пробитого чека | receipt-find-v4 | нет | receipt-find-v4 | нет |
| Проверка связи с кассой | check-token | любой запрос | нет | нет |
Способы можно совмещать. HTTP и TCP работают на одной кассе одновременно, порядок описан на странице про очередь и лимиты.
Методы сервера
Путь указан от базы контура, см. адреса.
| Метод | Путь | Токен | Что делает |
|---|---|---|---|
| POST | /gate/receipt-v4 | обмена | принять документ |
| POST | /gate/receipt-v4-1 | обмена | принять документ со смешанной оплатой |
| POST | /gate/receipt-status-v4 | обмена | результат документа |
| POST | /gate/receipt-find-v4 | не нужен | найти пробитые чеки |
| GET | /gate/check-token | обмена | на связи ли касса |
| POST | /gate/shift | обмена | смена через кассу |
| POST | /gate/cash | обмена | внесение и изъятие через кассу |
| POST | /gate/get-token | не нужен | получить токен V2 |
| POST | /gate/receipt-v2 | V2 | чек без кассы |
| POST | /gate/shift-v2 | V2 | смена без кассы |
| POST | /gate/cash-v2 | V2 | внесение, изъятие, остаток без кассы |
| GET | /gate/get-balance/{kkmID} | не нужен | лицевой счёт кассы |
| GET | /gate/get-html-receipt/{id} | не нужен | копия чека, адрес приходит в link |
| GET | /gate/get-html-shift/{id} | не нужен | копия Z-отчёта, адрес приходит в link |
| GET | /gate/get-html-shift-open/{id} | не нужен | копия открытия смены, адрес приходит в link |
| GET | /gate/ping | не нужен | сервер отвечает OK |
| POST | /gate/receipt | обмена | старый синхронный чек |
Методы кассы
Адрес http://<IP кассы>:<порт>, токен не нужен.
| Метод | Путь | Что делает |
|---|---|---|
| POST | /gate/receipt-v4 | принять документ, чек или операцию со сменой |
| POST | /gate/receipt-status-v4 | результат документа |
| GET | /payment | запустить оплату картой без чека |
| GET | /status | результат оплаты картой |
| POST | /gate/receipt | старый синхронный чек |
Пути на кассе сравниваются точно: /gate/receipt-v4/ со слэшем на конце или в другом регистре даст 404.
Запрос в вашу программу
| Метод | Путь | Что делает |
|---|---|---|
| POST | /yakassa/check | касса сообщает о пробитом чеке |