Создание маршрутного листа
CASHDESK API
API (Application Programming Interface или интерфейс программирования приложений) — это совокупность инструментов и функций в виде интерфейса для создания новых приложений, благодаря которому одна программа будет взаимодействовать с другой.
Для работы с API сервиса БИФИТ Касса, пользователю необходимо получить токен доступа. Генерация токена происходит по правилам авторизации OAuth2. С инструкцией авторизации по API можно ознакомиться здесь.
Создание маршрутного листа
Подготовьте POST запрос следующего вида:
base URL: https://kassa.bifit.com/cashdesk-api/v1/protected/route_sheet_document
В AUTHORIZATION укажите значение access_token согласно:
Bearer token : token <значение acces_token>
В BODY запроса укажите данные, согласно структуре описанной в SWAGGER.
{
"document": {
"amount": 0,
"cashierName": null,
"courierUserId": null,
"courierUserName": null,
"description": null,
"documentDate": 1646143440371 , //Дата создания маршрутного листа
"documentNumber": "114477", //Номер маршрутного листа
"firstDeliveryTime": 1646143440371, //Время первой доставки
"lastDeliveryTime": 1646143440371, //Время последней доставки
"ordersCount": 1, //Количество заказов
"organizationId": "1579776541385873338810", //ID организации
"priority": "LOW", //Приоритетность маршрутного листа в системе
"responsiblePerson": null,
"responsibleUserId": 93727, //ID Ответственного сотрудника
"status": "NEW", //Статус маршрутного листа
"tradeObjectId": "1579776541389-605245476" //ID торгового объекта
},
"items": [
{
"organizationId": "1579776541385873338810", //ID организации
"tradeObjectId": "1579776541389-605245476", //ID торгового обекта
"taxSystem": "COMMON", //Система налогообложения COMMON - ОСН (см. Таблица систем налогообложения)
"externalId": "11223344", //Номер онлайн-заказа
"deliveryType": "COURIER", //Тип доставки
"deliveryAmount": null, //Стоимость доставки
"deliveryTime": 1646143684830, //Время доставки в формате UNIX TIME
"paid": false, //Признак оплаты заказа
"orderTime": 1646137566448, //Время заказа
"clientId": 195363, //ID клиента
"address": "Г москва", //Адрес доставки
"responsiblePersonLogin": "7хххххххххх", //Логин (номер телефона) ответственного сотрудника. После создания заказа логин будет равен логину создателя заказа
"location": null, //GPS координаты курьера
"totalAmount": 57.00, //Итоговая стоимость заказа
"comment": null, //Комментарий к заказу
"currentStatusType": "NEW", //Текущий статус заказа NEW - новый, только что созданный заказ (см. Таблица статусов заказов)
"currentStatusTime": 1646135475820, //Время изменения статуса заказа в формате UNIX TIME
"substatusId": null, //ID пользовательского статуса
"shopId": null, //ID интернет витрины
"endLockTime": null, //Время окончания блокировки онлайн-заказа курьером
"size": 1, //Количество позиций в заказе
"actualDeliveryTime": null, //Фактическое время доставки
"routeSheetDocumentPosition": 1 //Позиция заказа в маршрутном листе
"cashierName": null, //Имя кассира
"clientName": null, //Имя клиента
}
]
}
Систем налогообложения
| Значение нумератора | Описание |
|---|---|
| COMMON | (ОСН - Общая система налогообложения) |
| SIMPLIFIED | (УСН 6% с дохода) |
| SIMPLIFIED_WITH_EXPENSE | (УСН 15% доход - расход) |
| ENVD | (ЕНВД не используется с 01.01.2020) |
| COMMON_AGRICULTURAL | (ЕСН или ЕСХН) |
| PATENT | (ПАТЕНТНАЯ система налогообложения) |
Статусы заказов
| Значение нумератора | Описание |
|---|---|
| NEW | НОВЫЙ |
| ACCEPTED | ПОДТВЕРЖДЕН |
| DISTRIBUTED | РАСПРЕДЕЛЕН |
| ISSUED | ВЫДАННЫЙ |
| REFUSED | ОТКАЗ |
| DELETED | УДАЛЕН |
| FINISHED | ЗАВЕРШЕН |
Примечание
- При создании заказа, есть несколько видов доставки. Ознакомьтесь с типами доставки:
- "COURIER" - в случае, если используется курьерская доставка
- "SELF" - самовывоз, в этом случае адрес доставки не требуется, место расчетов в чеке берется из ККТ/ТО
- "SERVICE" - не используется
- Каждому созданному заказу присваивается определенный статус. Ознакомьтесь со статусами заказов:
- "ACCEPTED" - статус “Подтвержден”, заказы в данном статусе доступны для отображения всем сотрудникам на МКТ. Используем при создании заказа.
- "DISTRIBUTED" - статус “Распределен”, заказы в данном статусе доступны для отображения на МКТ только тем сотрудникам, на которых эти заказы назначены.
- "REFUSED" - статус “Отменен”, заказ с таким статусом невозможно создать, можно добавить статус с помощью PUT запроса, либо перевести заказ в данный статус из клиентского ПО, отменить заказ можно только в статусах "DISTRIBUTED","ACCEPTED". Статус REFUSED необходимо использовать при отмене заказа в статусах DISTRIBUTED и ACCEPTED.
- "DELETED" - статус “Удален”, заказ с таким статусом невозможно создать, можно добавить статус с помощью PUT запроса, заказ, в статусе “Удален” не будет доступен для работы, удалить можно только заказ в статусе "currentStatusType": "NEW". Статус DELETED необходимо использовать при отмене заказа только в статусе NEW.