Что умеет помощник и как им пользоваться
Помощник заполняет форму сам: ищет компании и адреса, читает документы, проверяет формат. Ниже — все его инструменты.
Порядок действий
- Опишите задачу обычными словами в панели справа — например: «сделай поручение на перевозку канатов из Шанхая в Москву в 20-футовом контейнере, плечи море → ж/д → авто».
- При необходимости приложите документы скрепкой.
- Ответьте на уточняющие вопросы: помощник останавливается и ждёт ответа.
- Проверьте правки на вкладке «Правки» и в самой форме.
Помощник заполняет форму сам, а не советует, куда нажать. Правки видно вживую: он переключает шаг, раскрывает раздел, открывает форму записи и набирает значения по одному полю. XML собирает обычный код, а не модель — она только выбирает, какой инструмент вызвать.
Помощник работает не только в поручении: в контрагентах он заводит карточки, в справочниках — записи, в настройках — читает и меняет параметры модели, в биллинге — советует тариф и собирает корзину. Ниже перечислены все его инструменты — просить можно словами, называть инструмент не нужно.
Документы и вложения
| Что умеет | Как это работает |
|---|---|
| Приложенные документы | Что пользователь приложил к поручению: имя файла, распознанный тип и объём. |
| Разобрать документ | Разбирает приложенный документ в сервисе разбора и возвращает готовые данные: тип, суть одной строкой, поля по схеме этого типа, вопросы с уже подставленными по документу ответами и список обязательных данных, которых в документе нет. |
| Перенести документ в поручение | Переносит разобранный документ в поручение. |
| Взять из документа отдельные поля | Берёт из документа только то, что попросили, — работает и с документом неизвестного типа. |
| Что можно взять из документа | Каталог полей, которые сервис умеет извлекать, и список типов документов. |
| Прочитать документ | Страница приложенного документа — на случай уточняющего вопроса, когда нужного поля нет в схеме типа. |
Проверка и XML
| Что умеет | Как это работает |
|---|---|
| Импорт поручения из XML | Переносит приложенный файл обмена ON_POREXPKLT в текущее поручение целиком или выбранными разделами. |
| Проверка по схеме ФНС | Собирает файл обмена и проверяет его официальной XSD: типы, длины и коды реквизитов, которые форма считает заполненными, но ГИС ЭПД отклонит (например «40'HC» вместо четырёхсимвольного кода ISO 6346). |
| Проверка формата: список незаполненных обязательных реквизит | Проверка формата: список незаполненных обязательных реквизитов и предупреждений. |
| Собрать файл обмена ON_POREXPKLT и вернуть имя файла и фрагм | Собрать файл обмена ON_POREXPKLT и вернуть имя файла и фрагмент. |
Поиск компаний, адресов и пунктов
| Что умеет | Как это работает |
|---|---|
| Поиск в справочнике контрагентов | Ищет компанию в справочнике организации — по всем папкам сразу, по названию, сокращению или ИНН. |
| Поиск договора экспедиции | Договоры транспортной экспедиции организации. |
| Организация в ЕГРЮЛ | Реквизиты российской организации или предпринимателя из ЕГРЮЛ/ЕГРИП: наименование, ИНН, КПП, ОГРН, ОКПО, ОКОПФ, юридический адрес, статус. |
| Подсказки по организациям | Список российских организаций по части названия, ФИО предпринимателя или адресу — когда нужно показать пользователю варианты. |
| Иностранная компания | Сведения об иностранной компании из открытых источников: наименование латиницей и на местном языке, налоговый идентификатор, адрес, ссылки на источники. |
| Справка по приложению | Справка о самом сервисе: как оформить поручение, где настраивается нумерация и часовой пояс, как получить собственный ключ доступа к модели, что делать, если помощник отвечает медленно, как заводить контрагентов и пользователей, как устроены тарифы, магазин и счета, публичные ссылки, история правок, что умеет сам помощник. |
| Коды контейнеров ISO 6346 | Справочник кодов размера и типа контейнера (ИСОКонтейн): основные типы контейнерных линий с расшифровкой. |
| Типы кузова и вагона | Подсказки к реквизиту ТипКузов: кузова автомобилей и типы вагонов. |
Форма поручения
| Что умеет | Как это работает |
|---|---|
| Состояние поручения: заполненность, ошибки, партии, данные о | Состояние поручения: заполненность, ошибки, партии, данные открытого шага. |
| Записать значение в поле поручения по пути модели | Записать значение в поле поручения по пути модели. |
| Записать сразу несколько полей одним вызовом | Записать сразу несколько полей одним вызовом. |
| Добавить повторяемый блок в массив: груз, контейнер, услугу, | Добавить повторяемый блок в массив: груз, контейнер, услугу, документ. |
| Удалить элемент массива по индексу | Удалить элемент массива по индексу. |
| База знаний по формату ФНС 5 | База знаний по формату ФНС 5.01: назначение реквизита, правила заполнения, источник данных, условия обязательности, типовые ошибки. |
| Найти ранее оформленные поручения организации по клиенту, гр | Найти ранее оформленные поручения организации по клиенту, грузу, маршруту или контейнеру. |
| Собрать текущее поручение по образцу ранее оформленного | Собрать текущее поручение по образцу ранее оформленного. |
| Задать вопрос пользователю и остановиться до ответа | Задать вопрос пользователю и остановиться до ответа. |
| Открыть у пользователя нужный шаг мастера | Открыть у пользователя нужный шаг мастера. |
| Открыть секцию | Раскрывает у пользователя секцию формы и прокручивает к ней, чтобы было видно, где идёт работа. |
| Закрыть форму | Закрывает открытое окно записи (пункт маршрута, груз, контейнер) и сворачивает раздел. |
| Подставить контрагента из справочника в блок участника поруч | Подставить контрагента из справочника в блок участника поручения. |
| Завести контрагента в справочнике одной командой | Завести контрагента в справочнике одной командой. |
| Завести нового контрагента в справочнике организации | Завести нового контрагента в справочнике организации. |
| Сторона перевозки | Ставит уже известного участника стороной поручения, не вводя реквизиты заново. |
| Проверка идентификатора | Проверяет налоговый идентификатор иностранной компании по правилам её страны: название реквизита, запись и — для Китая, Японии, Кореи, Тайваня и Австралии — контрольный разряд. |
| Адрес с кодом ГАР | Поиск адреса с кодом ГАР и кодом региона — для адресов приёма и выдачи груза и адресов участников. |
| Заполнить адрес в форме | Находит адрес и заполняет им блок формы целиком, поле за полем, на глазах у пользователя: переключает шаг, раскрывает секцию, открывает форму адреса. |
| Подставить контрагента | Переносит найденного контрагента в документ и, если указана группа, сохраняет его в справочник организации для будущих поручений. |
| Добавить партию груза — это отдельный маршрут со своими стор | Добавить партию груза — это отдельный маршрут со своими сторонами и сроками. |
| Маршрут партии | Задать маршрут партии целиком: пункты следования и виды транспорта. |
| Задать плечи перевозки партии по порядку следования | Задать плечи перевозки партии по порядку следования. |
| Станция и код ЕСР | Находит железнодорожную станцию по названию, городу или коду и возвращает код ЕСР, дорогу и населённый пункт. |
| Пункт маршрута | Уточняет пункт маршрута — город, морской порт, аэропорт, терминал: страна с кодом ОКСМ, адрес одной строкой, код UN/LOCODE, координаты. |
| Поиск в клиентских справочниках: адреса, услуги, номенклатур | Поиск в клиентских справочниках: адреса, услуги, номенклатура, контейнеры, подписанты. |
Раздел «Приложение»
| Что умеет | Как это работает |
|---|---|
| Новое поручение | Создаёт новое поручение и сразу открывает его у пользователя. |
| Состав справочника | Из каких полей состоит клиентский справочник. |
| Подключённые компании | Кого организация подключила, кого ещё может подключить и сколько осталось до предела по тарифу. |
| Настройки помощника | На чём работает помощник: своё подключение или общее, включён ли он. |
| Тариф и лимиты | Тариф организации, срок доступа, остаток токенов, докупленные пакеты и что можно докупить. |
| Статья справки | Читает статью справки целиком: инструкцию по сервису, описание реквизита формата или материал о самом формате. |
| Открыть статью справки | Открывает статью справки у пользователя — когда он просит показать инструкцию или когда проще дать прочитать, чем пересказывать. |
| Заполнение открытой формы | Вписать значения в форму, открытую перед пользователем: карточку контрагента, новую компанию, реквизиты организации. |
Раздел «Контрагенты»
| Что умеет | Как это работает |
|---|---|
| Подключение компании | Подключить компанию как арендатора и завести ей администратора. |
Раздел «Справочники»
| Что умеет | Как это работает |
|---|---|
| Запись в справочник | Добавить запись в клиентский справочник организации: адрес площадки, услугу, груз, контейнер, подписанта, страховщика. |
| Правка записи справочника | Изменить запись справочника. |
Раздел «Настройки»
| Что умеет | Как это работает |
|---|---|
| Настройка модели | Изменить параметры подключения к модели: провайдера, адрес API, модель, модель распознавания, температуру, окно контекста, предел действий за запрос. |
| Собственное подключение | Перевести организацию на собственный ключ API или вернуть на общее подключение сервиса. |
| Проверка подключения | Пробный запрос к модели: рабочий ли ключ и отвечает ли адрес API. |
Раздел «Биллинг»
| Что умеет | Как это работает |
|---|---|
| Совет по тарифу и пакетам | Что докупить в первую очередь и что выгоднее — пакет или старший тариф. |
| Корзина в магазине | Собрать корзину и открыть её у пользователя на шаге «Корзина»: тариф (plan, term: month|year) и пакеты (addons: [{code, quantity}]). |
Приложение: тариф, настройки, площадка
| Что умеет | Как это работает |
|---|---|
| Кто пользователь | Пользователь, его организация (название, ИНН, ЭДО), контур и права. |
Договоры и прочее
| Что умеет | Как это работает |
|---|---|
| Поставить договор в основание поручения: наименование, номер | Поставить договор в основание поручения: наименование, номер и дату разом. |
| Завести договор экспедиции | Завести договор экспедиции. |