Текущая версия на 11:02, 8 ноября 2022

CASHDESK API

API (Application Programming Interface или интерфейс программирования приложений) — это совокупность инструментов и функций в виде интерфейса для создания новых приложений, благодаря которому одна программа будет взаимодействовать с другой.

Для работы с API сервиса БИФИТ Касса, пользователю необходимо получить токен доступа. Генерация токена происходит по правилам авторизации OAuth2. С инструкцией авторизации по API можно ознакомиться здесь.

Нумераторы

TaxSystem - cистема налогообложения (тэг 1055). Если при регистрации устройства в ФНС было выбрано более одного режима налогообложения, то в TaxSystem необходимо указать, к какой системе налогообложения относится данный чек.
COMMON SIMPLIFIED SIMPLIFIED_WITH_EXPENSE COMMON_AGRICULTURAL PATENT	ОСН УСН доход УСН доход - расход ЕСХН ПАТЕНТ

СurrentStatusType - Статусы онлайн-заказов
NEW ACCEPTED DISTRIBUTED ISSUED REFUSED DELETED FINISHED	НОВЫЙ ПОДТВЕРЖДЕН РАСПРЕДЕЛЕН ВЫДАННЫЙ ОТКАЗ УДАЛЕН ЗАВЕРШЕН

Создание маршрутного листа

Запрос	POST
URL: https://kassa.bifit.com/cashdesk-api/v1/protected/route_sheet_document	https://kassa.bifit.com/cashdesk-api/v1/protected/route_sheet_document

Важно!
В HEADERS укажите значение access_token согласно:authorization: Bearer <значение acces_token> .

Request Body

type: raw (JSON)

document:

amount: Сумма заказов маршрутного листа
cashierName: Имя кассира
courierUserId: ID курьера
courierUserName: Логин (номер телефона) курьера
description: Описание
documentDate: Дата создания маршрутного листа в формате UNIX TIME *
documentNumber: Номер маршрутного листа *
firstDeliveryTime: Время первой доставки *
lastDeliveryTime: Время последней доставки *
ordersCount: Количество заказов *
organizationId: ID организации *
priority: Приоритетность маршрутного листа в системе *
responsiblePerson: Ответственный сотрудник
responsibleUserId: ID Ответственного сотрудника *
status: Статус маршрутного листа *
tradeObjectId: ID торгового объекта *

items:

organizationId: ID организации *
tradeObjectId: ID торгового обекта *
taxSystem: Система налогообложения *
externalId: Номер онлайн-заказа *
deliveryType: Тип доставки *
deliveryAmount: Стоимость доставки
deliveryTime: Время доставки в формате UNIX TIME *
paid: Признак оплаты заказа *
orderTime: Время заказа UNIX TIME *
clientId: ID клиента *
address: Адрес доставки *
responsiblePersonLogin: Логин (номер телефона) ответственного сотрудника. После создания заказа логин будет равен логину создателя заказа *
location: GPS координаты курьера
totalAmount: Итоговая стоимость заказа *
comment: Комментарий к заказу
currentStatusType: Текущий статус заказа NEW - новый, только что созданный заказ *
currentStatusTime: Время изменения статуса заказа в формате UNIX TIME *
substatusId: ID пользовательского статуса
shopId: ID интернет витрины
endLockTime: Время окончания блокировки онлайн-заказа курьером
size: Количество позиций в заказе
actualDeliveryTime: Фактическое время доставки
routeSheetDocumentPosition: Позиция заказа в маршрутном листе *
cashierName: Имя кассира
clientName: Имя клиента

 {
  "document": {
    "amount": 0,
    "cashierName": null,
    "courierUserId": null,
    "courierUserName": null,
    "description": null,
    "documentDate": 1646143440371 ,               
    "documentNumber": "114477",              
    "firstDeliveryTime": 1646143440371,     
    "lastDeliveryTime": 1646143440371,   
    "ordersCount": 1,                  
    "organizationId": "<organization_id>",   
    "priority": "LOW",    
    "responsiblePerson": null,
    "responsibleUserId": 93727,     
    "status": "NEW",                 
    "tradeObjectId": "<trade_object_id>"   
  },
  "items": [
    {
      "organizationId": "<organization_id>",                 
      "tradeObjectId": "<trade_object_id>",              
      "taxSystem": "COMMON",             
      "externalId": "11223344",            
      "deliveryType": "COURIER",            
      "deliveryAmount": null,                            
      "deliveryTime": 1646143684830, 
      "paid": false,     
      "orderTime": 1646137566448,  
      "clientId": 195363,    
      "address": "Адрес",     
      "responsiblePersonLogin": "7хххххххххх",          
      "location": null,             
      "totalAmount": 57.00,           
      "comment": null,              
      "currentStatusType": "NEW",           
      "currentStatusTime": 1646135475820,       
      "substatusId": null,           
      "shopId": null,                 
      "endLockTime": null,          
      "size": 1,                    
      "actualDeliveryTime": null,    
      "routeSheetDocumentPosition": 1     
      "cashierName": null,   
      "clientName": null, 
     }
   ]
 }

Важно

Поля обязательные для заполнения помечены *.
При создании маршрутного листа, статус онлайн заказа должен быть: "NEW", "ACCEPTED" или "DISTRIBUTED".

Response
ID созданного маршрутного листа	208

Примечание
После получения ID созданного маршрутного, укажите его в поисковом запросе https://kassa.bifit.com/cashdesk/#/app_cashdesk/online_orders/route_sheet_document/ после знака /.

@@ Строка 1: / Строка 1: @@
-== CASHDESK API==
+= CASHDESK API=
 '''API''' (Application Programming Interface или интерфейс программирования приложений) — это совокупность инструментов и функций в виде интерфейса для создания новых приложений, благодаря которому одна программа будет взаимодействовать с другой.
@@ Строка 5: / Строка 5: @@
 Для работы с API сервиса БИФИТ Касса, пользователю необходимо получить токен доступа. Генерация токена происходит по правилам авторизации OAuth2. С инструкцией авторизации по API можно ознакомиться <b>[https://kassa.bifit.com/wiki/index.php?title=ИНСТРУКЦИИ:Авторизация_при_интеграции_по_API здесь]</b>.
+= Нумераторы =
+{{ProductTable-2
+|title-left='''TaxSystem''' - cистема налогообложения (тэг 1055). Если при регистрации устройства в ФНС было выбрано более одного режима налогообложения, то в '''TaxSystem''' необходимо указать, к какой системе налогообложения относится данный чек.
+|title-right=
+|content-left=
+&nbsp;
+* '''COMMON'''
+* '''SIMPLIFIED'''
+* '''SIMPLIFIED_WITH_EXPENSE'''
+* '''COMMON_AGRICULTURAL'''
+* '''PATENT'''
+|content-right=
+&nbsp;
+* ОСН
+* УСН доход
+* УСН доход - расход
+* ЕСХН
+* ПАТЕНТ
+|}}<br>
+{{ProductTable-2
+|title-left='''СurrentStatusType''' - Статусы онлайн-заказов
+|title-right=
+|content-left=
+&nbsp;
+* '''NEW'''
+* '''ACCEPTED'''
+* '''DISTRIBUTED'''
+* '''ISSUED'''
+* '''REFUSED'''
+* '''DELETED'''
+* '''FINISHED'''
+|content-right=
+&nbsp;
+* НОВЫЙ
+* ПОДТВЕРЖДЕН
+* РАСПРЕДЕЛЕН
+* ВЫДАННЫЙ
+* ОТКАЗ
+* УДАЛЕН
+* ЗАВЕРШЕН
+|}}<br>
 = Создание маршрутного листа=
-Подготовьте POST запрос следующего вида:
+{{ProductTable-2
+|title-left='''Запрос'''
+|title-right='''POST'''
+|content-left= <br>URL: https://kassa.bifit.com/cashdesk-api/v1/protected/route_sheet_document
+|content-right=
+<syntaxhighlight>
+https://kassa.bifit.com/cashdesk-api/v1/protected/route_sheet_document
+</syntaxhighlight>
+|}}<br>
+{{Note|'''''Важно!'''''<br>
+В '''HEADERS''' укажите значение '''access_token''' согласно:'''authorization''': Bearer <значение '''acces_token'''> .|800}}
+{{ProductTable-2
+|title-left= Request Body
+|title-right= type: '''raw''' (JSON)
+|content-left=&nbsp;
+''document'':
+* '''amount''': Сумма заказов маршрутного листа
+* '''cashierName''': Имя кассира
+* '''courierUserId''': ID курьера
+* '''courierUserName''': Логин (номер телефона) курьера
+* '''description''': Описание
+* '''documentDate''': Дата создания маршрутного листа в формате '''UNIX TIME''' '''*'''
+* '''documentNumber''': Номер маршрутного листа '''*'''
+* '''firstDeliveryTime''': Время первой доставки '''*'''
+* '''lastDeliveryTime''': Время последней доставки '''*'''
+* '''ordersCount''': Количество заказов '''*'''
+* '''organizationId''': ID организации '''*'''
+* '''priority''': Приоритетность маршрутного листа в системе '''*'''
+* '''responsiblePerson''': Ответственный сотрудник
+* '''responsibleUserId''': ID Ответственного сотрудника '''*'''
+* '''status''': Статус маршрутного листа '''*'''
+* '''tradeObjectId''': ID торгового объекта '''*'''
+''items'':
+* '''organizationId''': ID организации '''*'''
+* '''tradeObjectId''': ID торгового обекта '''*'''
+* '''taxSystem''': Система налогообложения '''*'''
+* '''externalId''': Номер онлайн-заказа '''*'''
+* '''deliveryType''': Тип доставки '''*'''
+* '''deliveryAmount''': Стоимость доставки
+* '''deliveryTime''': Время доставки в формате '''UNIX TIME''' '''*'''
+* '''paid''': Признак оплаты заказа '''*'''
+* '''orderTime''': Время заказа '''UNIX TIME''' '''*'''
+* '''clientId''': ID клиента '''*'''
+* '''address''': Адрес доставки '''*'''
+* '''responsiblePersonLogin''': Логин (номер телефона) ответственного сотрудника. После создания заказа логин будет равен логину создателя заказа '''*'''
+* '''location''': GPS координаты курьера
+* '''totalAmount''': Итоговая стоимость заказа '''*'''
+* '''comment''': Комментарий к заказу
+* '''currentStatusType''': Текущий статус заказа NEW - новый, только что созданный заказ '''*'''
+* '''currentStatusTime''': Время изменения статуса заказа в формате '''UNIX TIME''' '''*'''
+* '''substatusId''': ID пользовательского статуса
+* '''shopId''': ID интернет витрины
+* '''endLockTime''': Время окончания блокировки онлайн-заказа курьером
+* '''size''': Количество позиций в заказе
+* '''actualDeliveryTime''': Фактическое время доставки
+* '''routeSheetDocumentPosition''': Позиция заказа в маршрутном листе '''*'''
+* '''cashierName''': Имя кассира
+* '''clientName''': Имя клиента
+|content-right=&nbsp;
+<syntaxhighlight lang="JSON">
+ {
+  "document": {
+    "amount": 0,
+    "cashierName": null,
+    "courierUserId": null,
+    "courierUserName": null,
+    "description": null,
+    "documentDate": 1646143440371 ,
+    "documentNumber": "114477",
+    "firstDeliveryTime": 1646143440371,
+    "lastDeliveryTime": 1646143440371,
+    "ordersCount": 1,
+    "organizationId": "<organization_id>",
+    "priority": "LOW",
+    "responsiblePerson": null,
+    "responsibleUserId": 93727,
+    "status": "NEW",
+    "tradeObjectId": "<trade_object_id>"
+  },
+  "items": [
+    {
+      "organizationId": "<organization_id>",
+      "tradeObjectId": "<trade_object_id>",
+      "taxSystem": "COMMON",
+      "externalId": "11223344",
+      "deliveryType": "COURIER",
+      "deliveryAmount": null,
+      "deliveryTime": 1646143684830,
+      "paid": false,
+      "orderTime": 1646137566448,
+      "clientId": 195363,
+      "address": "Адрес",
+      "responsiblePersonLogin": "7хххххххххх",
+      "location": null,
+      "totalAmount": 57.00,
+      "comment": null,
+      "currentStatusType": "NEW",
+      "currentStatusTime": 1646135475820,
+      "substatusId": null,
+      "shopId": null,
+      "endLockTime": null,
+      "size": 1,
+      "actualDeliveryTime": null,
+      "routeSheetDocumentPosition": 1
+      "cashierName": null,
+      "clientName": null,
+     }
+   ]
+ }
+</syntaxhighlight>
+|}}<br>
- base URL: https://kassa.bifit.com/cashdesk-api/v1/protected/route_sheet_document
+{{Note|'''Важно'''
+* Поля обязательные для заполнения помечены '''*'''.
+* При создании маршрутного листа, статус онлайн заказа должен быть: "NEW", "ACCEPTED" или "DISTRIBUTED".
+|700}}
-В '''AUTHORIZATION''' укажите значение access_token согласно:
- Bearer token : token <значение '''acces_token'''>
+{{ProductTable-2
+|title-left='''Response'''
+|title-right=
+|content-left= <br>ID созданного маршрутного листа
+|content-right=
+<syntaxhighlight>
+</syntaxhighlight>
+|}}<br>
-В '''BODY''' запроса укажите данные, согласно структуре описанной в [https://kassa.bifit.com/cashdesk-api/v1/swagger-ui.html#/online_orders/createOnlineOrderUsingPOST SWAGGER].
+{{Note|'''''Примечание'''''<br>
+После получения ID созданного маршрутного, укажите его в поисковом запросе https://kassa.bifit.com/cashdesk/#/app_cashdesk/online_orders/route_sheet_document/  после знака /.|800}}

Создание маршрутного листа: различия между версиями

Текущая версия на 11:02, 8 ноября 2022

CASHDESK API

Нумераторы

Создание маршрутного листа

Навигация

Создание маршрутного листа: различия между версиями

Текущая версия на 11:02, 8 ноября 2022

CASHDESK API

Нумераторы

Создание маршрутного листа

Навигация

Поиск