Receipt.Sale

Занесение чека продажи.

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

Название Тип данных Обязательность Описание
cashier_name string Необязательный ФИО кассира в системе клиента. Если не задан, ставится имя пользователя под котором выполняется запрос
code string Необязательный Номер чека в системе клиента. При занесении чека происходит проверка Кода на уникальность, если чек с таким же кодом ранее был занесен в базу VCR, то чек отклоняется, если же поле не передано(null) или передана пустая строка, то проверка не осуществляется и чек будет добавлен с автоматически сгенерированным кодом. Проверка может быть отключена в настройках VCR - Контроль уникальности по коду чека из внешней системы, при отключеной проверке разрешается добавлять чеки с повторяющимися кодами.
phone string Необязательный Содержит номер телефона. Если чек содержит оплаты через ЭПС и в оплате указан номер, полученный через ЭПС - то значение поля phone в модели Receipt.Sale игнорируется
pos_id string Необязательный Id кассы в системе клиента, если не задан ставится VCR
seller_name string Необязательный Имя продавца в системе клиента (может быть передана пустая строка)
session_code string Необязательный Номер кассовой смены в системе клиента
positions Array of positions Обязательный Позиции номенклатуры - массив объектов positions
payments Array of payments Обязательный Массив позиций оплат. Нельзя добавить более двух объектов с типом оплаты - терминал type=2
custom_variables Array of custom_variables Необязательный Клиентские переменные для печати чека - массив объектов custom_variables

Пример запроса

{
    "id": 1,
    "auth": "a2Fzc2E6a2FzMTIzNDU2",
    "method": "Receipt.Sale",
    "params": {
        "cashier_name": "Administrator",
        "code": "res-000782",
        "phone": "998918935861",
        "pos_id": "1",
        "seller_Name": "Rustam",
        "session_Code": "486",
        "positions": [
            {
                "amount": 900000,
                "articul": "56394857",
                "barcode": "5449000000996",
                "label": "5784397583956248569",
                "code": "64963",
                "color_name": "Красный",
                "country_name": "Узбекистан",
                "department_name": "Напитки",
                "discount": 0,
                "group_name": "Напитки",
                "name": "Coca-cola",
                "producer_name": "Coca Cola co",
                "quantity": 1000,
                "size_name": "1l",
                "type_name": "Товар",
                "unit_name": "шт",
                "vat_value": 1200,
                "icps": "02202002001010036",
                "package_code": "1218868",
                "brand_name": "Pepsi-Cola",
                "commission_inn": "923409418",
                "owner_type": "BuyingAndSelling"
            }
        ],
        "payments": [
            {
                "type": 1,
                "value": 500000
            },
            {
                "type": 2,
                "value": 400000,
                "payment_id": "24b267ad-6122-4e8f-a4e1-787d8706a071",
                "card_type": 2,
                "rrn": "23554523"
            }
        ],
        "custom_variables": [
            {
                "name": "gratitude",
                "value": "thank you for buying :)"
            }
        ]
    },
    "jsonrpc": "2.0"
}

Примечание: в модели positions каждый параметр label должен быть уникальным в рамках одного запроса.


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

Название Тип данных Описание параметра
id string id созданного чека в REGOS: VCR
Amount int Сумма в чеке
QRCodeURL string Cтрока, содержащая URL из QR-кода чека
TerminalID string ID фискального модуля
ReceiptNo string Номер чека в ПОФМ
DateTime string Дата и время чека. Строка формата YYYY-MM-DD HH:MM:SS, где - YYYY - год, MM - месяц, DD - день, HH - часы, MM - минуты, SS - секунды
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"
}