---
title: "Список операций"
method: GET
path: "/operations"
tags: ["Operations"]
---

# Список операций

`GET /operations`

Возвращается список операций компании, начиная с последней.

## Query parameters

- `max` integer
- `offset` integer
- `cursor` string

## Response `200`

Список операций.

- object
  - `rows` 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 — Идентификатор исходной (оригинальной) операции.
  - `total` integer
  - `cursor` string — Используйте это значение для следующего запроса

---

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