Настройка подписок

Метод возвращает конфигурацию таблицы, строки текущей страницы, счётчики и пагинацию.

Параметры запроса

• page (integer, опционально) — номер страницы, начиная с 1;
• per_page (integer, опционально) — от 1 до 100, по умолчанию 20;
• query (string, опционально) — поиск по ФИО, названию компании или телефону клиента; строка от 3 до 100 символов, для телефонного запроса нужно минимум 3 цифры;
• status[] (string[], опционально) — active, charging, past_due, canceled;
• application_id[] (integer[], опционально) — приложения текущего проекта;
• date_from (date, опционально) — дата создания подписки от этой границы;
• date_to (date, опционально) — дата создания подписки до этой границы;
• sort_by (string, опционально) — created_at, current_period_end, last_payment_at или amount;
• sort_dir (string, опционально) — asc или desc.

Если в query есть буквы, каждое слово ищется в фамилии, имени, отчестве или названии компании. Запрос без букв считается телефонным: формат номера не важен, но после нормализации должно остаться не меньше трёх цифр.

Ответ

{
    "columns": [
        {
            "id": 210,
            "table_id": 25,
            "order": 0,
            "key": "id",
            "text": "№"
        }
    ],
    "subscriptions": [
        {
            "id": {
                "icon": null,
                "value": 981,
                "url": "https://app.gigma.ru/subscriptions/list-subscriptions/981"
            },
            "created_at": "2026-08-18T10:15:00.000000Z",
            "counterparty": {
                "icon": "https://api.gigma.ru/storage/uploads/default.svg",
                "value": "Иванов Иван",
                "link": "https://app.gigma.ru/counterparty/list-counterparty/3312"
            },
            "phone": "79990000000",
            "nomenclature": {
                "icon": "https://api.gigma.ru/storage/uploads/default.svg",
                "value": "Доступ Pro, год",
                "link": "https://app.gigma.ru/nomenclatures/list-nomenclatures/5120"
            },
            "application": {
                "icon": "https://api.gigma.ru/storage/uploads/default.svg",
                "value": "Сайт",
                "link": "https://app.gigma.ru/ecommerce/list-ecommerce/12"
            },
            "amount": "9900.00 RUB",
            "current_period_end": "2027-08-18T10:15:00.000000Z",
            "status": "active"
        }
    ],
    "counters": {
        "total": 171,
        "active": 128,
        "past_due": 2,
        "canceled": 37
    },
    "pagination": {
        "total": 171,
        "per_page": 20,
        "current_page": 1,
        "last_page": 9,
        "from": 1,
        "to": 20
    }
}

subscriptions — не сырой объект подписки, а строки для таблицы. У ячейки id переход хранится в url; у клиента, тарифа и приложения — в link. Значение icon для этих связанных ячеек — абсолютный URL, включая стандартную иконку, если собственного изображения нет.

Счётчики учитывают проект, филиал, поиск, приложение и даты, но считаются до применения status[]. Поэтому они показывают распределение даже при выбранном статусном фильтре. Отдельного поля charging в counters нет: такие подписки входят только в total.

Даты административного контура сериализуются в формате Laravel с микросекундами, например 2026-08-18T10:15:00.000000Z. Это отличается от клиентских ответов с форматом 2026-08-18T10:15:00+00:00.

Ошибки

• 401 — Bearer сотрудника отсутствует или не распознан;
• 403 — нет ни одного из прав view-orders, create-orders, edit-orders;
• 422 — параметры фильтра или сортировки не прошли проверку.

Метод возвращает подписку, клиента, приложение, тариф и связанные заказы. Используйте его для разбора конкретного списания, а не пытайтесь восстановить карточку из строки таблицы.

Ответ

{
    "subscription": {
        "id": 981,
        "status": "active",
        "plan_slug": "nomenclature-5120",
        "amount": "9900.00",
        "currency": "RUB",
        "billing_period_months": 12,
        "current_period_start": "2026-08-18T10:15:00.000000Z",
        "current_period_end": "2027-08-18T10:15:00.000000Z",
        "last_payment_at": "2026-08-18T10:15:05.000000Z",
        "last_payment_error": null,
        "next_charge_at": "2027-08-16T10:15:00.000000Z",
        "canceled_at": null,
        "created_at": "2026-08-18T10:15:00.000000Z",
        "updated_at": "2026-08-18T10:15:05.000000Z",
        "counterparty": {
            "id": 3312,
            "name": "Иванов Иван",
            "phone_1": "79990000000",
            "phone_2": null
        },
        "application": {
            "id": 12,
            "name": "Сайт"
        },
        "nomenclature": {
            "id": 5120,
            "name": "Доступ Pro, год"
        },
        "orders": [
            {
                "id": 7741,
                "name": "Подписка Доступ Pro, год",
                "created_at": "2026-08-18T10:15:00.000000Z",
                "price": "9900.00",
                "final_price": "9900.00",
                "status": {
                    "id": 22,
                    "name": "Оплачен"
                },
                "application": {
                    "id": 12,
                    "name": "Сайт"
                },
                "branch": {
                    "id": 1,
                    "name": "Основной"
                }
            }
        ]
    }
}

next_charge_at означает «не раньше этого времени». Список orders объединяет первый заказ и заказы продлений без дублей. В карточке нет идентификаторов платежей провайдера, ключей идемпотентности и данных сохранённого способа оплаты.

Ошибки

• 401 — Bearer сотрудника отсутствует или не распознан;
• 403 — недостаточно прав;
• 404 — подписка не существует либо находится в другом проекте или недоступном сотруднику филиале.

Лента объясняет, когда и почему подписка переходила между состояниями. События идут от новых к старым.

Параметры запроса

• page_size (integer, опционально) — от 1 до 100, по умолчанию 25;
• page_token (string, опционально) — токен следующей страницы из предыдущего ответа.

Ответ

{
    "status_events": [
        {
            "name": "subscriptions/981/status-events/4471",
            "id": 4471,
            "event_type": "payment_failed",
            "from_status": "charging",
            "to_status": "past_due",
            "initiator": {
                "type": "system",
                "id": null
            },
            "origin": "scheduler",
            "created_at": "2026-08-18T09:00:00.000000Z"
        }
    ],
    "next_page_token": ""
}

Пустой next_page_token означает, что следующей страницы нет.

Ошибки

• 401 — Bearer сотрудника отсутствует или не распознан;
• 403 — недостаточно прав;
• 404 — подписка не находится в доступном сотруднику контуре;
• 422 — неверный page_size или page_token.

Метод возвращает одно событие из ленты подписки.

Ответ

{
    "name": "subscriptions/981/status-events/4471",
    "id": 4471,
    "event_type": "payment_failed",
    "from_status": "charging",
    "to_status": "past_due",
    "initiator": {
        "type": "system",
        "id": null
    },
    "origin": "scheduler",
    "created_at": "2026-08-18T09:00:00.000000Z"
}

Ошибки

• 401 — Bearer сотрудника отсутствует или не распознан;
• 403 — недостаточно прав;
• 404 — подписка недоступна либо событие не принадлежит этой подписке.