Создание онлайн заказа по API

CASHDESK API

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

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

Нумераторы

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

CalculationMethod - признак способа расчета (тэг 1214).

PREPAY_FULL PREPAY_PARTIAL AVANS FULL_PAY PARTIAL_SETTLEMENT_AND_CREDIT TRANSFER_ON_CREDIT CREDIT_PAYMENT

Полная предварительная оплата до момента передачи предмета расчёта Частичная предварительная оплата до момента передачи предмета расчёта Аванс Полная оплата, в том числе с учётом аванса (предварительной оплаты) в момент передачи предмета расчёта Частичная оплата предмета расчёта в момент его передачи с последующей оплатой в кредит Передача предмета расчёта без его оплаты в момент его передачи с последующей оплатой в кредит Оплата предмета расчёта после его передачи с оплатой в кредит (оплата кредита)

vat - ставка НДС (тэг 1199).
WITHOUT_VAT VAT_0 VAT_10 VAT_20 VAT_110 VAT_120	Без НДС НДС 0% НДС 10% НДС 20% НДС 10/110 НДС 20/120

PaymentSubject - признак предмета расчета (тэг 1212).

PRODUCT EXCISABLE_PRODUCT JOB SERVICE GAMBLING_RATE GAMBLING_WIN LOTTERY_TICKET LOTTERY_WIN PROVISION_RID PAYMENT AGENCY COMPOUND_SUBJECT OTHER_SUBJECT PROPERTY_LAW NON_OPERATING_INCOME INSURANCE_CONTRIBUTIONS TRADE_FEE RESORT_FEE PLEDGE CONSUMPTION CONTRIBUTIONS_MPI_SE CONTRIBUTIONS_MPI CONTRIBUTIONS_CHI_SE CONTRIBUTIONS_CHI CONTRIBUTIONS_MSI CASINO_PAYMENT MONEY_PAYMENT ATNM ATM TNM TM

Товар Подакцизный товар Работа Услуга Ставка азартной игры Выигрыш азартной игры Лотерейный билет Выигрыш лотереи Предоставление РИД Платеж Агентское вознаграждение Составной предмет расчета Иной предмет расчета Имущественное право Внереализованный доход Страховые взносы Торговый сбор Курортный сбор Залог Расход Взносы на ОПС ИП Взносы на ОПС Взносы на ОМС ИП Взносы на ОМС Взносы на ОСС Платеж казино Выплата Подакцизный маркируемый товар без КМ Подакцизный маркируемый товар c КМ Маркируемый товар без КМ Маркируемый товар с КМ

address - телефон или электронный адрес покупателя (тэг 1008).
Телефон передаётся в формате "7ХХХХХХХХХХ"

Создание заказа

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

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

Request HEADERS	HEADERS
передача access_token отключение компрессии	Authorization: "Bearer <значение access_token>" Accept-Encoding: "deflate"

Request Body

type: raw (JSON)

onlineOrder: visible: Признак видимости заказа created: Время создания в формате UNIX TIME changed: Время создания в формате UNIX TIME organizationId: ID организации tradeObjectId: ID торгового объекта taxSystem: Система налогообложения externalId: Номер заказа в информационной системе интегратора deliveryType: Тип доставки COURIER - Курьером (либо SELF - Самовывоз) deliveryAmount: Стоимость услуги доставки deliveryTime: Время доставки в формате UNIX TIME paid: Признак оплаты заказа orderTime: clientId: ID клиента address: Адрес доставки responsiblePersonLogin: Логин (номер телефона) ответственного сотрудника. После создания заказа логин будет равен логину создателя заказа discount: Величина скидки на заказ discountType: Тип скидки на заказ location: GPS координаты курьера totalAmount: Итоговая стоимость заказа comment: Комментарий к заказу currentStatusType: Текущий статус заказа currentStatusTime: Время изменения статуса заказа в формате UNIX TIME substatusId: ID пользовательского статуса shopId: ID интернет витрины endLockTime: routeSheetDocumentId: ID Маршрутного листа routeSheetDocumentPosition:Номер позиции заказа в маршрутном листе routeSheetDocumentNumber: size: actualDeliveryTime: cashierName: Имя кассира clientName: Имя клиента onlineOrderItems: nomenclatureId: ID номенклатурной позиции из справочника номенклатур description: Наименование товарной позиции price: Цена товарной позиции vatValue: Величина ставки НДС quantity: Кол-во discount: % скидки calculationMethod: Признак способа расчёта paymentSubject: Признак предмета расчёта contractorAddress: Адрес поставщика (при реализации агентских товаров и услуг) contractorInn: ИНН поставщика (при реализации агентских товаров и услуг) contractorName: Наименование организации поставщика (при реализации агентских товаров и услуг) contractorPhone: Телефон поставщика (при реализации агентских товаров и услуг) organizationPhone: Телефон contractorActivityType: Вид деятельности поставщика markType: Тип маркировки codeForOfd: Код маркировки (КМ) barcode: Штрих код позиции (EAN-8, EAN-13) vendorCode: Артикул производителя unitCode: Код единицы измерения по ОКЕИ editable: Признак редактируемости позиции в приложении total: nomenclatureId: description: price: vatValue: quantity: discount: calculationMethod: paymentSubject: contractorAddress: contractorInn: contractorName: contractorPhone: organizationPhone: contractorActivityType: markType: codeForOfd: barcode: vendorCode: unitCode: editable: total: nomenclatureId: description: price: vatValue: quantity: discount: calculationMethod: paymentSubject: contractorAddress: contractorInn: contractorName: contractorPhone: organizationPhone: contractorActivityType: markType: codeForOfd: barcode: vendorCode: unitCode: editable: total: properties: Свойства fullSettlement: Курьеру разрешено принимать полную оплату prepayment: Курьеру запрещено принимать предоплату credit: Курьеру запрещено передавать заказ в кредит client: organizationId: ID организации address: Адрес доставки phone: Номер телефона клиента lastName: Фамилия клиента firstName: Имя клиента клиента patronymic: Отчество клиента клиента email: Электронная почта клиента, сюда будет отправлен чек comment: Комментарий organizationId: cashierInfos:

{ "onlineOrder": { "visible": true, "created": 1644828163053, "changed": 1644828163053, "organizationId": "<organization_id>", "tradeObjectId": "<trade_object_id>", "taxSystem": "COMMON", "externalId": "BFt-002", "deliveryType": "COURIER", "deliveryAmount": null, "deliveryTime": null, "paid": false, "orderTime": 1644828134297, "clientId": 124329, "address": "Адрес", "responsiblePersonLogin": "7xxxxxxxxxx", "discount": 0.00, "discountType": 0, "location": null, "totalAmount": 14500.00, "comment": null, "currentStatusType": "NEW", "currentStatusTime": 1644828159791, "substatusId": null, "shopId": null, "endLockTime": null, "routeSheetDocumentId": null, "routeSheetDocumentPosition": null, "routeSheetDocumentNumber": null, "size": null, "actualDeliveryTime": null, "cashierName": null, "clientName": null }, "onlineOrderItems": [ { "nomenclatureId": 22090265, "description": "Букет белых роз", "price": 3000, "vatValue": 20, "quantity": 1, "discount": 0, "calculationMethod": null, "paymentSubject": "PRODUCT", "contractorAddress": null, "contractorInn": null, "contractorName": null, "contractorPhone": null, "organizationPhone": null, "contractorActivityType": null, "markType": "UNKNOWN", "codeForOfd": null, "barcode": null, "vendorCode": null, "unitCode": 796, "editable": true, "total": null }, { "nomenclatureId": 22090204, "description": "Букет роз, 40 шт", "price": 7000, "vatValue": 20, "quantity": 1, "discount": 0, "calculationMethod": null, "paymentSubject": "PRODUCT", "contractorAddress": null, "contractorInn": null, "contractorName": null, "contractorPhone": null, "organizationPhone": null, "contractorActivityType": null, "markType": "UNKNOWN", "codeForOfd": null, "barcode": null, "vendorCode": null, "unitCode": 796, "editable": true, "total": null }, { "nomenclatureId": 22090243, "description": "Букет розовых и белых роз, 15 штук", "price": 4500, "vatValue": 20, "quantity": 1, "discount": 0, "calculationMethod": null, "paymentSubject": "PRODUCT", "contractorAddress": null, "contractorInn": null, "contractorName": null, "contractorPhone": null, "organizationPhone": null, "contractorActivityType": null, "markType": "UNKNOWN", "codeForOfd": null, "barcode": null, "vendorCode": null, "unitCode": 796, "editable": true, "total": null } ], "properties": { "fullSettlement": true, "prepayment": false, "credit": false }, "client": { "organizationId": "<organization_id>", "address": "Адрес", "phone": "79999999999", "lastName": "Иванов", "firstName": "Иван", "patronymic": "Иванович", "email": "", "comment": null, }, "organizationId": null, "cashierInfos": null }

Response
ID созданного онлайн заказа	406707

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