Создание маршрутного листа
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": "<organization_id>", //ID организации*
"priority": "LOW", //Приоритетность маршрутного листа в системе*
"responsiblePerson": null,
"responsibleUserId": 93727, //ID Ответственного сотрудника*
"status": "NEW", //Статус маршрутного листа*
"tradeObjectId": "<trade_object_id>" //ID торгового объекта*
},
"items": [
{
"organizationId": "<organization_id>", //ID организации*
"tradeObjectId": "<trade_object_id>", //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.