CASHDESK API:Создание онлайн заказа: различия между версиями

Материал из Касса
Перейти к навигации Перейти к поиску
Строка 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