Внешние курьеры

Справочник служб доставки, которым кабинет передаёт заказы: для каждой службы хранится тип интеграции, токен доступа и список торговых точек, работающих с этой службой.

Где находится

Внешние сервисы → Внешние курьеры

Список служб

12345

1. Название — как служба названа в кабинете.
2. Тип — тип интеграции, выбранный при создании (Yandex, Uzum, Millennium и другие из справочника типов).
3. Статус — флажок активности. Снятие флажка сразу отправляет запись на сохранение и выключает службу, форму открывать не нужно.
4. Меню строки — пункт Изменить открывает запись в той же форме, что и создание.
5. Создать — открывает форму новой службы.

Фильтры: на странице нет ни фильтров, ни поиска — список показывает все службы сети, число в заголовке равно количеству строк.

Создание службы

6789101112

6. Название — имя службы в кабинете, обязательное.
7. Тип — тип интеграции из справочника типов внешних курьеров, обязательный. Именно он определяет, по какому протоколу передаётся заказ.
8. TOKEN — ключ доступа, выданный службой доставки, обязательный.
9. Торговые точки — точки, которые работают с этой службой; выбирается одна или несколько, поле обязательное.
10. Статус — активность службы. При создании включён по умолчанию.
11. Отмена — закрывает форму без сохранения.
12. Сохранить — создаёт службу и связывает её с выбранными точками.

Как создать службу

1. Нажмите 5 — Создать.
2. Введите 6 — Название.
3. Выберите 7 — Тип.
4. Вставьте 8 — TOKEN, полученный у службы доставки.
5. Отметьте 9 — Торговые точки, которым будет доступна служба.
6. При необходимости снимите 10 — Статус, чтобы служба сохранилась выключенной.
7. Нажмите 12 — Сохранить.

Проверки перед сохранением

Бэкенд проверяет payload и на первой же ошибке возвращает сообщение, не сохраняя запись:

Проверка	Когда срабатывает
Название заполнено	поле пустое
Тип выбран	тип внешнего курьера не выбран
TOKEN заполнен	поле пустое
Торговые точки — непустой список	не выбрана ни одна точка

Запись и её связи с торговыми точками пишутся в одной транзакции: если на каком-то шаге произошла ошибка, не сохраняется ничего.

Редактирование и удаление

Запись открывается пунктом Изменить в меню строки 4 — форма та же, что при создании, с заполненными значениями. При сохранении изменений обновляются только Название, TOKEN и Статус: Тип задаётся один раз при создании и запросом на изменение не переписывается.

Кнопки удаления в разделе нет: службу, которая больше не нужна, выключают флажком 3 — Статус в списке или 10 — Статус в форме.

примечание

При сохранении изменений прежние связи службы с точками удаляются и записываются заново по содержимому поля 9 — Торговые точки. Поэтому перед сохранением проверьте, что в поле остались все нужные точки, а не только вновь добавленная.