Receipt.Refund

Занесение чека возврата.
Регистрация чека возврата возможна только в режиме онлайн.

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

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

Ограничения, требования и проверки

  • Если установлен Fiscal Drive API версии 8.20 и выше, то чек возврата может быть отклонён на уровне FDA.

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

{
    "auth": "a2Fzc2E6a2FzMTIzNDU2",
    "id": 1,
    "jsonrpc": "2.0",
    "method": "Receipt.Refund",
    "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": 900000
            }
        ],
        "custom_variables": [
            {
                "name": "gratitude",
                "value": "thank you for buying :)"
            }
        ],
        "refund_info": {
            "DateTime": "2022-07-18 14:35:04",
            "FiscalSign": "853234561062",
            "QRCodeURL": "https://ofd.soliq.uz/check?t=UZ210108170541&r=20&c=20220531161950&s=345411154513",
            "ReceiptNo": "187",
            "TerminalID": "VG298343428256"
        }
    }
}

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

Примечание: если поле QRCodeURL передано, остальные поля игнорируются в чеке возврата.

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

Название Тип данных Описание параметра
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=UZ210108170541&r=20&c=20220531161950&s=345411154513",
        "TerminalID": "VG298343428256",
        "ReceiptNo": "187",
        "DateTime": "2022-07-18 14:35:04",
        "FiscalSign": "853234561062"
    },
    "jsonrpc": "2.0"
}