create_rollback

Операция аннулирования

Входные данные: NewRollbackRequest

Возвращаемые данные: Rollback


Важно: Для совершения данной операции требуется Авторизация в СКО, иначе будет возвращена ошибка AVQFR_SESSION_NOT_AUTHORIZED

Важно: Для совершения данной операции требуется открытая смена, иначе будет возвращена ошибка AVQFR_SHIFT_IS_CLOSED

Важно: Для совершения данной операции смена должна быть открыта менее 24 часов, иначе будет возвращена ошибка AVQFR_SHIFT_IS_PENDING

Важно: данная операция требует того, чтобы аннулируемый документ находился в текущей смене, а так же того, что чек не был аннулирован ранее. В случае, если документ не был найден, будет возвращена ошибка AVQFR_NO_DATA

Важно: Для данного запроса поле currency игнорируется и может быть не передано


Примеры

Успех

Запрос:

{
  "address": "ik.service.token.rollback",
  "headers": {
    "action": "create_rollback",
    "sid": "ed046722-8f66-4709-b087-3af224514802",
    "token": "AVQ11031010703",
    "printer.dummy": ""
  },
  "data": {
    "rollback": {
      "header": {
        "cashier": "Кассир"
      },
      "target_num": 5979
    }
  },
  "type": "send"
}

Ответ:

{
  "type": "send",
  "address": null,
  "reply_address": null,
  "data": {
    "extra": null,
    "header": {
      "cashier": "Кассир",
      "company_name": "ИП Моров А.М.",
      "currency": "BYN",
      "date_time": "2021-09-27T18:26:40.693479+03:00",
      "device_id": 131010703,
      "number": 5980,
      "serial_number": "AVQ11031010703",
      "shift_number": 209,
      "tax_number": 191832203,
      "trade_point_name": null,
      "type_id": "rollback",
      "uid": "BF9CCC355AD0A45307CF108F"
    },
    "target_num": 5979,
    "totals": {
      "cash": "2.01",
      "cashless": "0",
      "other": "0",
      "sum": "2.01"
    }
  },
  "headers": null
}

Ошибка (документ был аннулирован)

Запрос:

{
  "address": "ik.service.token.rollback",
  "headers": {
    "action": "create_rollback",
    "sid": "ed046722-8f66-4709-b087-3af224514802",
    "token": "AVQ11031010703",
    "printer.dummy": ""
  },
  "data": {
    "rollback": {
      "header": {
        "cashier": "Кассир"
      },
      "target_num": 5979
    }
  },
  "type": "send"
}

Ответ:

{
  "type": "error",
  "address": null,
  "reply_address": null,
  "data": {
    "description": "запрашиваемые данные отсутствуют (попытка получить внутренний или отсутствующий документ)",
    "name": "AVQFR_NO_DATA",
    "op_data": null
  },
  "headers": null
}