CASHDESK API:Создание онлайн заказа: различия между версиями
Merkulov (обсуждение | вклад) |
Merkulov (обсуждение | вклад) |
||
Строка 26: | Строка 26: | ||
"externalId": "VQ12345678", \\Номер заказа во внешней системе | "externalId": "VQ12345678", \\Номер заказа во внешней системе | ||
!"deliveryType": "COURIER", \\Тип доставки | !"deliveryType": "COURIER", \\Тип доставки | ||
"COURIER" - в случае, если используется курьерская доставка | * "COURIER" - в случае, если используется курьерская доставка | ||
"SELF" - самовывоз, в этом случае адрес доставки не требуется, место расчетов в чеке берется из ККТ/ТО | * "SELF" - самовывоз, в этом случае адрес доставки не требуется, место расчетов в чеке берется из ККТ/ТО | ||
"SERVICE" - не используется | * "SERVICE" - не используется | ||
!"paid": false, | !"paid": false, |
Версия 16:42, 9 февраля 2022
API (Application Programming Interface или интерфейс программирования приложений) — это совокупность инструментов и функций в виде интерфейса для создания новых приложений, благодаря которому одна программа будет взаимодействовать с другой.
Для работы с API сервиса БИФИТ Касса, пользователю необходимо получить токен доступа. Генерация токена происходит по правилам авторизации OAuth2. С инструкцией авторизации по API можно ознакомиться здесь.
Создание заказа
Подготовьте POST запрос следующего вида:
base URL: https://kassa.bifit.com/cashdesk-api/v1/protected/online_orders
В рамках согласованного процесса, заказы создаются в статусе “Подтвержден” или “Новый”.
- Для заказов, передаваемых курьерам необходимо использовать статус NEW при создании заказа
- Для заказов самовывоза необходимо использовать статус ACCEPTED при создании заказа
Для самовывоза или доставки необходимо передавать "employeeAccess": null
В массив onlineOrder передаются следующие обязательные значения:
"visible": true, \\Видимость онлайн-заказа !"organizationId": "16286094820321052850480", \\В какую организацию создаем заказ !"tradeObjectId": "1628609482057-1613612358", \\В какой торговый объект создаем заказ !"taxSystem": "COMMON", \\СНО заказа "externalId": "VQ12345678", \\Номер заказа во внешней системе !"deliveryType": "COURIER", \\Тип доставки
* "COURIER" - в случае, если используется курьерская доставка
* "SELF" - самовывоз, в этом случае адрес доставки не требуется, место расчетов в чеке берется из ККТ/ТО
* "SERVICE" - не используется
!"paid": false, "employeeAccess": "NULL", "orderTime": 1631094730812, "address": "Адрес", "responsiblePersonLogin": "79295444301", !"totalAmount": 95, !"currentStatusType": "NEW", !"currentStatusTime": 1630936599865