Страхование грузов: как работает интеграция
Страхователь создаёт заявку на ATI.SU и выбирает страховую. Страховая через API находит заявку, берёт её в работу и прикрепляет полис либо отклоняет. Те же заявки видны в кабинете страховой на ati.su.
| Параметр | Значение |
|---|---|
| Базовый адрес | https://api.ati.su/gw/insurance, авторизация |
| Формат | JSON, поля в snake_case |
| Дата и время | ISO 8601 со смещением, московское время: 2026-10-14T10:59:02.73+03:00 |
| Уведомления | Webhook нет. Новые заявки получайте опросом поиска по статусам Sent и Approved |
Порядок работы
- Найти заявки: фильтр по статусу и периоду создания,
takeдо 100. - Получить заявку и файлы: груз, маршрут, транспорт, перевозчик, реквизиты, документы.
- Взять в работу. Необязательно, но страхователь увидит, что заявка рассматривается.
- Завершить: прикрепить полис или отклонить с причиной для страхователя.
- Если полис прикреплён в кабинете, подтвердить оплату списком заявок.
Прикрепление полиса само подтверждает оплату клиента и начисляет ему кешбэк. Не подтверждайте оплату раньше полиса: после этого прикрепить полис через API нельзя.
Статусы и действия
| Статус | Кто ставит | Что может страховая |
|---|---|---|
Sent | ATI.SU при создании заявки | в работу, полис, оплата, отклонить |
Approved | Сотрудник ATI.SU | в работу, полис, оплата, отклонить |
InProgress | Страховая | полис, оплата, отклонить |
Insured | Страховая: полис или оплата | полис и оплата, пока оплата не подтверждена |
Deflected | Страховая | — |
Withdrawn | Страхователь, до оформления | — |
Cancelled | ATI.SU, кешбэк возвращается | — |
Request | Не используется, встречается в старых заявках | — |
Поля client_payment_date и insurer_payment_date в результатах поиска показывают, когда подтверждена оплата клиента и когда страховая оплатила вознаграждение ATI.SU.