# ТК «Луч»

ИИ для грузоперевозок по Уралу: расчёт и заявки ТК «Луч» в чате

Грузоперевозки по Уралу: расчёт стоимости, заявки на перевозку, статусы грузов

## Как агент работает с ТК «Луч»

Агент работает с OTR-API транспортной компании «Луч»: читает справочники городов, услуг и упаковок, считает стоимость перевозки на калькуляторе компании, создаёт заявки на грузоперевозку и поднимает по ним статус, суммы к оплате и историю движения по складам. Покрытие такое же, как у самой компании: весь Урал (Челябинская, Свердловская, Тюменская, Курганская и Оренбургская области, Пермский край, Башкортостан, Удмуртия), Татарстан и Самара, ХМАО и ЯНАО, Стрежевой и Казахстан. Точный список пунктов агент каждый раз берёт из справочника компании.

Город в заявке задаётся не строкой, а идентификатором из справочника, и отдалённые районы записаны там в виде «Посёлок (Город)». Поэтому агент сначала находит город в справочнике и только потом считает или оформляет, а для расчёта просит у вас вес, габариты каждого места и объявленную стоимость груза. Размеры он не придумывает: цена перевозки зависит от объёма, и выдуманная коробка даёт выдуманную сумму.

Всё, что тратит деньги, агент сначала показывает целиком: маршрут, грузоместа, услуги, кто и как платит. Заявка уходит в ТК «Луч» только после вашего подтверждения. Заявку на забор день в день компания принимает до 15:00 по Челябинску, и агент предупредит, если время уже прошло и забор перенесётся на завтра.

Подключение держится на паре токенов X-User и X-Token, которые выдаёт разработчик системы, компания ОТР ИТ. Агент подписывает ими каждый запрос к B2B-части, а калькулятору передаёт только идентификатор, без секретного токена. Если какого-то значения в ответе нет, агент говорит об этом прямо, а не показывает пустую таблицу.

## Сценарии интеграции

### Стоимость перевозки за минуту
Агент посчитает перевозку между городами Урала по весу, габаритам и объявленной стоимости, с забором, доставкой до двери и упаковкой.

### Заявка на перевозку
Агент соберёт заявку с отправителем, получателем, грузоместами и услугами, покажет её целиком и отправит в ТК «Луч» после вашего подтверждения.

### Где сейчас груз
Агент поднимет статус и историю перемещения по складам для каждой заявки и пришлёт сводку: что в пути, что прибыло и что ждёт оплаты.

### Заявки за период
Агент выгрузит отправленные заявки за месяц с городами, получателями и статусами и сведёт их в таблицу для сверки с отгрузками.

### Проверка города перед отправкой
Агент сверит город или отдалённый район со справочником ТК «Луч» и подскажет, где забор или доставка обязательны и какие ограничения по весу.

### Черновик поручения для ЭДО
Агент получит XML-черновик поручения экспедитору по заявке, чтобы вы подписали его в своей системе ЭДО без ручного заполнения.

## Как подключить

**Перед подключением**

- Токены X-User и X-Token от ОТР ИТ (запрос на Info@otr-it.ru)
- Ваше подтверждение перед созданием заявки на перевозку

### Напишите в ОТР ИТ на Info@otr-it.ru
Запрос на подключение к API ТК «Луч» пишется в свободной форме. Обычно ОТР ИТ заводит рабочий чат в Telegram с вашими сотрудниками.

### Получите токены X-User и X-Token
Оба токена приходят в рабочий чат и выглядят как UUID. Для тестового стенда и боевого API пара одна и та же.

### Проверьте договор с ТК «Луч»
Заявки из API оформляются на организацию, к которой привязана учётная запись. Уточните у менеджера, кто плательщик и какой способ оплаты по договору.

## Частые вопросы

### Как подключить ТК «Луч»?
Парой токенов X-User и X-Token. Их выдаёт ОТР ИТ по письму в свободной форме на Info@otr-it.ru, обычно через рабочий чат в Telegram. Токены для тестового стенда и боевого API одинаковые.

### Что агент видит в ТК «Луч»?
Справочники городов, услуг и упаковок, расчёт стоимости перевозки, отправленные заявки за период, статус и историю каждой перевозки, суммы к оплате и черновик поручения экспедитору.

### Пишет ли агент в ТК «Луч»?
Да, агент создаёт заявки на грузоперевозку, и каждую он показывает вам и отправляет только после подтверждения. Остальная работа сводится к расчётам и чтению статусов.

### Куда возит ТК «Луч»?
По Уралу и соседним регионам: Челябинская, Свердловская, Тюменская, Курганская, Оренбургская и Самарская области, Пермский край, Башкортостан, Татарстан, Удмуртия, ХМАО, ЯНАО, Стрежевой в Томской области и Казахстан. Точный список городов и отдалённых районов, около 960 пунктов, агент берёт из справочника компании.

[Открыть ТК «Луч»](https://sites.google.com/view/luch-api/otr-api)