Receipt.Sale

Регистрация чека продажи.

Входные параметры

Название	Тип данных	Обязательность	Описание
cashier_name	string	Необязательный	ФИО кассира в системе клиента. Если не задано, используется имя пользователя VCR
code	string	Необязательный	Номер чека во внешней системе. При включённой настройке контроля уникальности VCR проверяет, что чек с таким кодом ранее не был зарегистрирован
phone	string	Необязательный	Телефон покупателя. Если чек содержит оплату через `Payment.Create` и платёжная система вернула телефон, используется телефон из платежа
pos_id	string	Необязательный	Id кассы во внешней системе. Если не задан, используется значение VCR
seller_name	string	Необязательный	Имя продавца во внешней системе
session_code	string	Необязательный	Номер кассовой смены во внешней системе
positions	Array of positions	Обязательный	Позиции чека. Количество позиций не должно превышать 150
payments	Array of payments	Обязательный	Оплаты чека
custom_variables	Array of custom_variables	Необязательный	Клиентские переменные для печати чека

Если оплата была создана методом Payment.Create, передайте локальный id платежа в payments[].payment_id.

Для QR-платежей перед регистрацией чека нужно дождаться, что Payment.Get вернул status = 3.

Оплата UzQR регистрируется как карточная безналичная оплата; идентификатор оплаты UzQR используется как RRN.

Ограничения по оплатам:

в одном чеке можно использовать только один платёж, созданный через Payment.Create;
такой платёж можно использовать только в чеке продажи;
нельзя использовать платёж, который уже был привязан к другому чеку;
в одном чеке можно передать не более одного объекта оплаты с type = 2.

Пример запроса - продажа с оплатой, созданной через Payment.Create

{
    "id": 1,
    "auth": "a2Fzc2E6a2FzMTIzNDU2",
    "method": "Receipt.Sale",
    "params": {
        "cashier_name": "Administrator",
        "code": "res-000782",
        "phone": "998901234567",
        "pos_id": "1",
        "seller_name": "Rustam",
        "session_code": "486",
        "positions": [
            {
                "amount": 900000,
                "barcode": "5449000000996",
                "discount": 0,
                "name": "Coca-cola",
                "quantity": 1000,
                "vat_value": 1200,
                "icps": "02202002001010036",
                "package_code": "1218868",
                "owner_type": "BuyingAndSelling"
            }
        ],
        "payments": [
            {
                "type": 2,
                "payment_id": "24b267ad-6122-4e8f-a4e1-787d8706a071"
            }
        ]
    },
    "jsonrpc": "2.0"
}

Пример запроса - продажа с наличной оплатой

{
    "id": 1,
    "auth": "a2Fzc2E6a2FzMTIzNDU2",
    "method": "Receipt.Sale",
    "params": {
        "positions": [
            {
                "amount": 900000,
                "barcode": "5449000000996",
                "discount": 0,
                "name": "Coca-cola",
                "quantity": 1000,
                "vat_value": 1200,
                "icps": "02202002001010036",
                "package_code": "1218868",
                "owner_type": "BuyingAndSelling"
            }
        ],
        "payments": [
            {
                "type": 1,
                "value": 900000
            }
        ]
    },
    "jsonrpc": "2.0"
}

Выходные параметры

Название	Тип данных	Описание
Id	string	id созданного чека в REGOS: VCR
Amount	int	Сумма чека
QRCodeURL	string	URL из QR-кода фискального чека
TerminalID	string	ID фискального модуля
ReceiptNo	string	Номер чека
DateTime	string	Дата и время чека
FiscalSign	string	Фискальный признак

Пример ответа

{
    "id": 1,
    "ok": true,
    "result": {
        "Id": "59683513-a845-5ce3-bf75-4f35f7a7d846",
        "Amount": 900000,
        "QRCodeURL": "https://ofd.soliq.uz/check?t=VG369473163905&r=583&c=20230526142642&s=848035748636",
        "TerminalID": "VG369473163905",
        "ReceiptNo": "759",
        "DateTime": "2023-05-26T20:45:23.55Z",
        "FiscalSign": "848035748636"
    },
    "jsonrpc": "2.0"
}