---
title: "Создание ваучера"
method: POST
path: "/operations/voucher"
tags: ["Operations"]
---

# Создание ваучера

`POST /operations/voucher`

Создание ваучера на проведение операции в UDS. Метод позволяет получить информацию для печати на чеке кода или QR кода ваучера, по которому клиент сможет накопить бонусы за покупку.  

### Маркетинговая политика 

Обязательным условием использования данного функционала является настройка модуля программы лояльности в настройках административной панели UDS Бизнес (https://admin.uds.app/). Вам необходимо указать `Начислять бонусные баллы` в блоке настройки `Способ предоставления скидки` 

### Ошибки 

Статус | Код ошибки | Описание 
------ | ---------- | ----------- 
`400` | invalidChecksum | Способ предоставления скидки не `CHARGE_SCORES` 
`400` | invalidChecksum | Размер начисляемых бонусных баллов равен 0 
`400` | invalidChecksum | Поле `total` меньше или равно` skipLoyaltyTotal`

## Request body

- CreateVoucher
  - `nonce` string, nullable — UID чека.
  - `cashier` object, nullable — Информация о сотруднике.
    - `externalId` string — Внешний идентификатор сотрудника.
    - `name` string, nullable — Имя сотрудника.
  - `receipt` object, required — Информация о чеке.
    - `total` number, required — Сумма счета в денежных единицах.
    - `number` string, nullable — Номер чека.
    - `skipLoyaltyTotal` number, nullable — Часть суммы счета, на которую не начисляется кешбэк (в денежных единицах).

## Response `200`

Ваучер.

- VoucherInfo — Детали ваучера, возвращаемые после создания через POST /operations/voucher. Содержит код для печати на чеке и URL QR-кодов для отображения.
  - `code` string — Числовой код ваучера.
  - `qrCodeText` string — Текст для генерации QR - кода ваучера для дальнейшей печати.
  - `qrCode128` string — Ссылка для генерирования картинки QR кода (size 128), которую можно распечатать.
  - `qrCode256` string — Ссылка для генерирования картинки QR кода (size 256), которую можно распечатать.
  - `expiresIn` string, date-time — Время, когда ваучер сгорит по времени UTC.
  - `points` number — Количество баллов для начисления. Рассчитывается из настроек базового уровня бонусной программы.

---

[API](https://skmtc.dev/uds/apis/uds-api-2.md) · [All operations](https://skmtc.dev/uds/apis/uds-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/uds/uds-api-2/revisions/f4f284d76ad0/schema)