Заявки портала

GET /api/external/v2/sc/{sc_id}/portal/tickets BASIC

Заявки арендаторов из портала. Доступны на любом тарифе: пределы периода и свежести к ним не применяются. Объём одного ответа ограничивает per_page, а не тариф. Лимиты частоты действуют как у остальных методов.

Отдельного запроса за деталями заявки нет: в каждой строке уже есть тип, параметры, точка, арендатор, автор, доп. поля и условия согласования.

Параметры#

Имя	Тип	Обяз.	По умолчанию	Описание
`sc_id`	string, в пути	да	—	Идентификатор центра
`start_created_date`	date	условно	—	Начало периода по дате создания заявки
`end_created_date`	date	условно	—	Конец того же периода
`start_active_date`	date	условно	—	Начало периода по интервалу действия заявки
`end_active_date`	date	условно	—	Конец того же периода
`ticket_uids`	array of string	условно	—	Номера заявок, до 100 за запрос
`statuses`	array of string	нет	—	Фильтр по статусам
`page`	integer	нет	`1`	Номер страницы
`per_page`	integer	нет	`50`	Размер страницы, от 1 до 100

Как задать выборку#

Нужна ровно одна полная пара периода или список ticket_uids[]. Половина пары без второй даёт 422. Две пары сразу — тоже 422.

created: когда заявку создали.
active: заявки, чей интервал действия пересекается с запрошенным периодом.
ticket_uids: точечная выборка по номерам. UID не из текущего ТЦ игнорируются — в ответ попадают только найденные заявки.

Без statuses[] возвращаются все статусы, включая архивные записи. Сортировка — от новых заявок к старым.

Жёсткого лимита длины периода нет. Для стабильного ответа и удобной пагинации лучше брать окно не длиннее трёх месяцев.

Статусы#

new_request, in_progress, agreed, agreed_with_conditions, revoked, rejected.

Передаются как statuses[]=agreed&statuses[]=rejected.

Ответ#

Поле	Тип	Описание
`ticket_uid`	string	Номер заявки
`title`	string	Заголовок
`status`	string	Статус из словаря выше
`archived`	boolean	Архивная запись
`work_period`	string	Период работ, как задан в заявке
`text`	string	Текст заявки
`created_at`	string	Когда создана, ISO 8601 со смещением зоны центра
`resolution_created_at`	string \| null	Когда вынесено решение
`begin_time`	string \| null	Начало интервала действия, ISO 8601 со смещением зоны центра
`end_time`	string \| null	Конец интервала действия, ISO 8601 со смещением зоны центра
`ticket_type`	object	Бизнес-тип заявки, с возможным вложенным `children`
`has_passes`	boolean	Есть ли связанные пропуска
`parameters`	array	Параметры заявки и выбранные значения
`sell_location`	object \| null	Торговая точка
`arendator`	object \| null	Арендатор
`author`	object \| null	Автор заявки
`custom_fields`	array	Дополнительные поля формы
`agreement_comments`	array	Условия согласования от разных отделов, все, а не последнее

custom_fields не содержат файлов и ссылок на них. У option-полей ответ лежит в selected_options, а не в value.

json

{
  "success": true,
  "data": [
    {
      "ticket_uid": "Z-MRM-12345",
      "title": "Ввоз оборудования",
      "status": "agreed",
      "archived": false,
      "work_period": "day",
      "text": "Доставка оборудования",
      "created_at": "2026-08-27T10:15:00+03:00",
      "resolution_created_at": "2026-08-27T12:00:00+03:00",
      "begin_time": "2026-08-28T08:00:00+03:00",
      "end_time": "2026-08-28T20:00:00+03:00",
      "ticket_type": {
        "id": 12,
        "title": "Ввоз / вывоз",
        "analytics_key": "import",
        "children": {
          "id": 34,
          "title": "Ввоз оборудования",
          "analytics_key": null
        }
      },
      "has_passes": true,
      "parameters": [
        {
          "id": 56,
          "title": "Крупногабаритный груз",
          "analytics_key": null,
          "values": [
            {
              "id": 78,
              "title": "Вход №3",
              "analytics_key": "entrance_3"
            }
          ]
        }
      ],
      "sell_location": {
        "id": "SL-1",
        "name": "Мармелад"
      },
      "arendator": {
        "id": "AR-1",
        "legal_name": "ООО Арендатор",
        "inn": "7700000000"
      },
      "author": {
        "id": "US-1",
        "name": "Иван Иванов",
        "email": "author@example.com",
        "mall_staff": true,
        "phone": "+7 (999) 000-00-00"
      },
      "custom_fields": [
        {
          "id": 90,
          "title": "Способ доставки",
          "field_type": "radiobutton_with_options",
          "value": null,
          "selected_options": [
            {
              "id": 91,
              "value": "Курьер"
            }
          ]
        }
      ],
      "agreement_comments": [
        {
          "id": 8231,
          "body": "Работы только после 22:00",
          "created_at": "2026-08-27T14:10:00+03:00"
        }
      ]
    }
  ],
  "meta": {
    "pagination": {
      "page": 1,
      "per_page": 50,
      "total": 1
    },
    "time_zone": "Europe/Moscow"
  }
}

Связанные пропуска — метод Пропуска портала, ключ стыковки ticket_uid.

Ошибки#

Код	HTTP	Когда
`portal_unavailable`	503	Не ответил портал арендаторов; запрос можно повторить
`validation_error`	422	Нет пары периода и нет `ticket_uids`, две пары сразу, неполный период, неизвестный статус, больше 100 номеров в `ticket_uids`, `per_page` больше 100