---
title: "Операция возврата"
method: POST
path: "/operations/{id}/refund"
tags: ["Operations"]
---

# Операция возврата

`POST /operations/{id}/refund`

Возврат операции по ее идентификатору. Если указан параметр `partialAmount`, то возврат будет частичным, иначе - полным

## Request body

- object
  - `partialAmount` number, nullable — Сумма возврата.

## Response `200`

Refunded operation

- Operation — Завершённая транзакция в программе лояльности (покупка, возврат или вознаграждение). Содержит детали транзакции, информацию о клиенте, сотруднике и движении баллов.
  - `id` integer — ID операции в базе UDS .
  - `dateCreated` string, date-time — Дата операции.
  - `action` 'PURCHASE', required — Тип операции.
  - `state` 'NORMAL' | 'CANCELED' | 'REVERSAL' — Статус операции.
  - `customer` object — Информация о клиенте.
    - `id` integer — ID клиента в компании
    - `displayName` string — Имя и фамилия клиента.
    - `uid` string, nullable — Идентификатор клиента в UDS (UID).
    - `membershipTier` MembershipTier — Конфигурация уровня (статуса) в программе лояльности. Определяет ставку скидки/кешбэка и условия автоматического повышения по сумме покупок или количеству рекомендаций.
      - `uid` string — Идентификатор статуса.
      - `name` string, required — Название статуса.
      - `rate` number, required — Коэффициент статуса.
      - `maxScoresDiscount` number, nullable — Процент счета, который можно оплатить бонусными баллами.
      - `conditions` object — Условия для автоматического назначения статуса.
        - `totalCashSpent` object, nullable — Повысить статус, когда сумма покупок достигнет данного значения.
          - `target` number — Сумма покупок.
        - `effectiveInvitedCount` object, nullable — Повысить уровень, когда клиент достигнет значения `effectiveInvitedCount`.
          - `target` integer — Количество эффективных рекомендаций.
  - `cashier` object, nullable — Информация о сотруднике.
    - `id` integer — ID сотрудника в UDS.
    - `displayName` string — Имя сотрудника.
  - `branch` object, nullable — Информация о филиале.
    - `id` integer — ID филиала в UDS.
    - `displayName` string — Название филиала.
  - `points` number — Количество бонусных баллов, которое будет списано с клиента после завершения операции. Отрицательное значение говорит о списании, а положительное - о начислении бонусных баллов.
  - `certificatePoints` number, nullable — Количество списываемых баллов сертификата.
  - `receiptNumber` string, nullable — Номер чека.
  - `origin` object, nullable — Для сторнирующей операции - ссылка на оригинальную операцию.
    - `id` integer — Идентификатор исходной (оригинальной) операции.

---

[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)