CASHDESK API:Создание онлайн заказа: различия между версиями
Merkulov (обсуждение | вклад) |
Merkulov (обсуждение | вклад) |
||
Строка 20: | Строка 20: | ||
В массив onlineOrder передаются следующие обязательные значения: | В массив onlineOrder передаются следующие обязательные значения: | ||
"visible": true, Видимость онлайн-заказа | "visible": true, \\Видимость онлайн-заказа | ||
!"organizationId": "16286094820321052850480", В какую организацию создаем заказ | !"organizationId": "16286094820321052850480", \\В какую организацию создаем заказ | ||
!"tradeObjectId": "1628609482057-1613612358", В какой торговый объект создаем заказ | !"tradeObjectId": "1628609482057-1613612358", \\В какой торговый объект создаем заказ | ||
!"taxSystem": "COMMON", СНО заказа | !"taxSystem": "COMMON", \\СНО заказа | ||
"externalId": "VQ12345678", | "externalId": "VQ12345678", \\Номер заказа во внешней системе | ||
!"deliveryType": "COURIER", | !"deliveryType": "COURIER", \\Тип доставки | ||
"COURIER" - в случае, если используется курьерская доставк | |||
"SELF" - самовывоз, в этом случае адрес доставки не требуется, место расчетов в чеке берется из ККТ/ТО | |||
"SERVICE" - не используется | |||
!"paid": false, | !"paid": false, | ||
"employeeAccess": "NULL", | "employeeAccess": "NULL", |
Версия 16:40, 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