Create BillListItemPack

Матеріал з expertsolution
Версія від 07:46, 25 липня 2022, створена Brusko.h (обговорення | внесок) (Створена сторінка: =='''Створення рахунку, і додавання вмісту рахунку на декілька позицій, в тому числі управління складом позиції'''== Розділ містить методи, необхідні для створення рахунку і управлінням його вмістом <br> {| cellspacing="3" cellpadding="0" style="width:100%; clear:both; margin:0.5em auto; backgr...)
(різн.) ← Попередня версія | Поточна версія (різн.) | Новіша версія → (різн.)
Перейти до навігації Перейти до пошуку

Створення рахунку, і додавання вмісту рахунку на декілька позицій, в тому числі управління складом позиції

Розділ містить методи, необхідні для створення рахунку і управлінням його вмістом


Опис Створення рахунку.
Метод POST
URL /POSExternal/Create_BillListItemPack



Request Headers
KEY VALUE
Content-Type application/json
AccessToken



Body raw (json) 
 {
    "SystemCode": "123",
    "BillType": 1,
    //  "FirstDate": null,
    //  "LastDate": null,
    //  "UserName": null,
    //  "CompanyName": "TestCompany",
    //   "Class": "3", //string[20] доп.поле идентификации устройства
    //  "Description": "",
    //   "Locked": false,
    //  "NumType": 0,
    //   "GuestCount": 0,
    //   "CostOfDelivery": 0,
    "Items": [
        {
            "OperType": 1,
            "TarifItemID": 14467, //ИД позиции из Get_TarifItem 3209125
            "BillItemID": 1,
            "ParentID": null,
            "Quantity": 3,
            "Price": null,
            "ModifierID": null
        },
        {
            "OperType": 1,
            "TarifItemID": 14467, //ИД позиции из Get_TarifItem 3209087
            "BillItemID": 2,
            "ParentID": null,
            "Quantity": 1,
            "Price": null,
            "ModifierID": null
        }
    ]
 }



Типи даних Body
* Параметр Тип Опис
*
 		SystemCode String [32] Код системи
*
 		BillType Int Тип рахунку:

1 – звичайний рахунок;
4 – рахунок бронювання (за замовчуванням для готельної системи);
8 – рахунок доставки

*
 		FirstDate Datetime Дата початку надання послуг, допустиме значення NULL
*
 		LastDate Datetime Дата закінчення надання послуг, допустиме значення NUL
*
 		UserName String[64] Користувач що створив рахунок, допустиме значення NULL
PlaceCode String[32] Код місця надання послуги(обов'язковий параметр для рахунків бронювання), допустиме значення NULL для інших
*
 		EventID String[32] ID заходу для рахунків бронювання, допустиме значення NULL для інших
*
 		EventName String[32] Назва заходу для рахунків бронювання, допустиме значення NULL для інших
*
 		CompanyCode String[32] Код компанії, допустиме значення NULL
*
 		CompanyName String[32] Компанія, допустиме значення NULL
*
 		Class String[20] Клас
Model String[20] Модель пристрою
OSDevice String[20] ОС пристрою
Description Bool Опис рахунку, допустиме значення NULL
Locked String[20] Блокувати рахунок
NumType Int Вид рахунку
GuestCount Int Кількість гостей
idTemp Int Тимчасовий ID
CostOfDelivery Decimal Вартість доставки **
Total Decimal Загалом по рахунку ***
Deposite Decimal Сума створеня рахунку передоплати****
EMail String email
PhoneNumber String Номер телефону
Discounts Discounts[] Масив дисконтів. Елементи масиву структури з такими полями:
     | CardCode String Код картки
     | DiscountType Int Тип знижки:

1 картка,
2 за группою карток,
3 у відсотках,
4 у грошах,
5 акційний купон

     | OwnerID Int ID персони (якщо застосовується картка)
     | OwnerCode String Kод персони (якщо застосовується картка)
     | BraceletCode String Kод браслету (якщо застосовується картка)
     | PersonDiscountID Int ID картки (якщо застосовується картка)
     | Discount Decimal Дисконт
     | DiscountGroup Int Група дисконту
     | IsLoyalty Int Якщо застосовується лояльність - 1, інакше - 0
Items Items[] Масив позицій комплексного блюда. Елементи масиву структури з такими полями:
     | OperType Int Код операції:

1 – додавання нової позиції в рахунок,
2 – зміна раніше внесеної позиції в рахунку,
3 – видалення позиції з рахунку

     | BillItemID Int ID позиції. Якщо OperType=1, новий запис буде оновленно відповідно до цього параметру, згенерованому застосунком
     | TarifItemID Int ID номенклатури що дoдається (актуально лише за додавання позиції і заміни комплексу)
     | ModifierID Int ID модифікатора стану
     | ParentID Int ID базової позиції рахунку, якщо номенклатура що додається є модифікатором. Якшо ні, то NULL
     | Quantity Decimal Kількість номенклатури що додається або змінюється. Не аналізується за операції видалення
     | IsManualPrice Int Чи встановлюється ручна ціна. Якщо 1 то застосовується ціна з Price
     | Price Decimal Ціна номенклатури. Не аналізується для операції видалення
     | PickUp Int Ознака блюда «З собою» (1-так, 0-ні)
     | Comment String Коментар до позиції
     | Print Bool Замовити і роздрукувати позицію
     | Seat Int Номер клієнта
     | SectionID Int ID відділу
     | Pos Int Порядок виносу
     | TimeOut Int Через скільки хвилин винос
     | ComplexID Int ID групи комплексу
     | SubItemID Int ID тарифної позиції за замовчуванням
     | CmxPrice Decimal Нова ціна позиції комплексу (для кіоску)
     | UseCmxPrice Int 1- використовувати ціну 0 – не використовувати (для кіоску)
     | TarifItemCode2 String Код зведення тарифної позиції*
     | PrintTaskCode Int Код для друку задачі на принтер( замовлення/повторення замовлення/відміна замовлення)
     | Total Decimal Сума позиції. Якщо = 0 то тотал вираховується через ціну і кількість. Якщо > 0 приводиться до цієї суми через знижку
     | ExciseStamps String[] Масив акцизних марок
Payment Payment [] Оплата рахунку. Включає в себе поля як в функції BillPaymentExt (Наприклад: «Payment»:{«PaymentID»:3133,»Summ»:20} ). Необов'язковий параметр.
* - позначення обов’язкового параметру
*TarifItemCode2 вказується для випадків коли TarifItemID невідомий або має більшу перевагу для використання
**Необов'язковий параметр.Якщо він буде переданий, в рахунок буде доданий товар з налаштування з кількістю 1 і з ручною ціною, вказаний в CostOfDelivery

і дорівнює значенню в полі вартість доставки

***Необов'язковий параметр. Якщо він буде переданий, до рахунку буде застосовано Total
****Необов'язковий параметр. Створить рахунок передоплати. Якщо в налаштуваннях вказаний код оплати, рахунок буде закрито
Додатковий опис вихідних параметрів



Response (json) 
{
    "Error": "",
    "Success": true,
    "BillID": 19903,
    "BillNumber": 16097,
    "BillTotal": 1400.00,
    "NumType": null,
    "Items": [
        {
            "BillItemID": 25936,
            "AppBillItemID": 1,
            "ParentID": 0,
            "Error": null
        },
        {
            "BillItemID": 25937,
            "AppBillItemID": 2,
            "ParentID": 0,
            "Error": null
        }
    ],
    "Discounts": [],
    "AllItems": [
        {
            "BillItemID": 25936,
            "Total": 1050.00,
            "ParentID": null,
            "TarifitemID": 14467,
            "Name": "Ананас",
            "ShortName": "Ананас",
            "Amount": 3.000,
            "Price": 350.00,
            "BillItemTempID": 1,
            "ModifierID": 0,
            "Status": 0,
            "ComplexID": null,
            "ItemType": "        ",
            "SubItemID": null,
            "SectionID": 12747,
            "ExciseStamps": null
        },
        {
            "BillItemID": 25937,
            "Total": 350.00,
            "ParentID": null,
            "TarifitemID": 14467,
            "Name": "Ананас",
            "ShortName": "Ананас",
            "Amount": 1.000,
            "Price": 350.00,
            "BillItemTempID": 2,
            "ModifierID": 0,
            "Status": 0,
            "ComplexID": null,
            "ItemType": "        ",
            "SubItemID": null,
            "SectionID": 12747,
            "ExciseStamps": null
        }
    ],
    "GUID": "8E7C8545-F81E-4CC8-AF7D-B23CD4B5D066"
}



Типи даних Response
* Параметр Тип Опис
Error String [] Опис помилки, що виникла
Success Bool Успіх виконання запиту
Files Files [] Перелік файлів для Bluetooth принтера при ReturnResult = true
     | File String Файл для друку
* Позначення обов’язкового параметру
Додатковий опис вхідних параметрів
Отримано з http://wiki.expertsolution.com.ua/index.php?title=Create_BillListItemPack&oldid=1865