# Страхование грузов: как работает интеграция

Страхователь создаёт заявку на ATI.SU и выбирает страховую. Страховая через API находит заявку, берёт её в работу и прикрепляет полис либо отклоняет. Те же заявки видны в кабинете страховой на ati.su.

| Параметр | Значение |
| --- | --- |
| Базовый адрес | `https://api.ati.su/gw/insurance`, [авторизация](https://ati.su/developers/raw/auth/auth.md) |
| Формат | JSON, поля в `snake_case` |
| Дата и время | ISO 8601 со смещением, московское время: `2026-10-14T10:59:02.73+03:00` |
| Уведомления | Webhook нет. Новые заявки получайте опросом поиска по статусам `Sent` и `Approved` |

## Порядок работы

1. [Найти заявки](https://ati.su/developers/raw/api/insurance/cargo-insurance.md#поиск-заявок-на-страхование-грузов): фильтр по статусу и периоду создания, `take` до 100.
2. [Получить заявку](https://ati.su/developers/raw/api/insurance/cargo-insurance.md#получение-заявки-на-страхование-груза) и [файлы](https://ati.su/developers/raw/api/insurance/cargo-insurance.md#получение-файлов-заявки-на-страхование-груза): груз, маршрут, транспорт, перевозчик, реквизиты, документы.
3. [Взять в работу](https://ati.su/developers/raw/api/insurance/cargo-insurance.md#перевод-заявки-в-обработку). Необязательно, но страхователь увидит, что заявка рассматривается.
4. Завершить: [прикрепить полис](https://ati.su/developers/raw/api/insurance/cargo-insurance.md#прикрепление-полиса-к-заявке-на-страхование-груза) или [отклонить](https://ati.su/developers/raw/api/insurance/cargo-insurance.md#отклонение-заявки-на-страхование-груза) с причиной для страхователя.
5. Если полис прикреплён в кабинете, [подтвердить оплату](https://ati.su/developers/raw/api/insurance/cargo-insurance.md#подтверждение-оплаты-клиентом-по-заявкам-на-страхование-грузов) списком заявок.

Прикрепление полиса само подтверждает оплату клиента и начисляет ему кешбэк. Не подтверждайте оплату раньше полиса: после этого прикрепить полис через API нельзя.

## Статусы и действия

| Статус | Кто ставит | Что может страховая |
| --- | --- | --- |
| `Sent` | ATI.SU при создании заявки | в работу, полис, оплата, отклонить |
| `Approved` | Сотрудник ATI.SU | в работу, полис, оплата, отклонить |
| `InProgress` | Страховая | полис, оплата, отклонить |
| `Insured` | Страховая: полис или оплата | полис и оплата, пока оплата не подтверждена |
| `Deflected` | Страховая | — |
| `Withdrawn` | Страхователь, до оформления | — |
| `Cancelled` | ATI.SU, кешбэк возвращается | — |
| `Request` | Не используется, встречается в старых заявках | — |

Поля `client_payment_date` и `insurer_payment_date` в результатах поиска показывают, когда подтверждена оплата клиента и когда страховая оплатила вознаграждение ATI.SU.
---

## llms.txt

Индекс ключевых страниц документации для LLM и AI-агентов доступен в [основном llms.txt](https://ati.su/developers/llms.txt).