Настройки модуля¶

Общий вид настроек¶

Аккаунт: логин, версия модуля (Базовая или ПРО) и ссылка «Сменить» — войти под другим аккаунтом. После подтверждения модуль выйдет из текущего аккаунта; вернуться без смены логина — кнопка «Отмена».
Основные разделы: «Службы доставки», «Новые заказы», «Груз и места», «Статусы».
Дополнительные разделы: «Отправка», «Отправители», «Сервисы», «Права», «Плагины», «Подготовка базы», «Обслуживание».
Название и короткое описание выбранного раздела.
Настройки раздела.
Ссылки «Руководство пользователя» и «Написать в поддержку».
Кнопки «Сохранить и закрыть», «Сохранить», «Закрыть».

Значок или красная цифра у пункта меню — в этом разделе что-то не настроено.

Подключение, отключение и изменения в настройке подключения сохраняются сразу — вместе со всеми несохранёнными изменениями формы. Остальные настройки (в том числе звёздочка основной службы) — кнопками «Сохранить» или «Сохранить и закрыть».

Службы доставки¶

Служба со звёздочкой (★) — основная: если среди рассчитанных тарифов нет тарифа по умолчанию подключения, после расчёта модуль выбирает её самый дешёвый тариф (см. Какой тариф модуль выбирает сам). Чтобы сделать основной другую службу, выделите её и нажмите кнопку со звёздочкой. Если отключить все подключения основной службы, звёздочка снимается.

Кнопки над таблицей: «Подключить службу», «Настроить» (или двойной щелчок по строке), «Отключить»; кнопка со стрелками заново загружает подключения через сервис-агрегатор (см. Способы подключения служб), результат нужно сохранить. Организации и ПВЗ отправки меняются в настройке подключения.

Если подключений к службе больше, чем позволяет версия модуля, лишние в список не попадают — модуль сообщит, каких служб это касается.

→ Как работать: Подключение служб доставки

Новые заказы¶

Здесь задаётся, что модуль сам подставит в новый заказ.

Служба доставки в новый заказ не подставляется: расчёт идёт по всем подключённым службам. Строка «Основная служба» показывает службу со звёздочкой из раздела «Службы доставки» — она влияет только на автовыбор тарифа после расчёта, см. Службы доставки.
Отправлять груз — от двери или с пункта отправки. Доставлять груз — до двери или до пункта выдачи.
Оплата — как отмечать «Заказ оплачен»:
- «Заказ оплачен по умолчанию» — «да» в новых заказах; отметку, которую вы уже сохранили в заказе, модуль не меняет;
- «Использовать информацию об оплате» — при каждом открытии «да», если заказ полностью оплачен в 1С, и «нет», если нет. Если сохранённая в заказе отметка отличается, модуль заменит её и сообщит об этом;
- «Устанавливать вручную» — пользователь отмечает сам.
Источник адреса доставки — откуда брать адрес: из заказа, адрес доставки клиента, почтовый или фактический адрес клиента.
Страховать отправления — от этого зависит объявленная (оценочная) стоимость.
Заполнять даты доставки и отправки автоматически — при открытии формы пустая или прошедшая дата отправки становится сегодняшней (после 18:00 — завтрашней), дата доставки — на день позже.
ПРО Время по умолчанию — время отправки и доставки «с … до». Работает, если включено автозаполнение дат.

→ Откуда данные: Адрес доставки, Оплата и наложенный платёж, Даты и время

Груз и места¶

Здесь настраивается, как считать вес и размеры отправления.

Вес мест в заказе указывается в — граммах или килограммах.
ПРО Габариты товаров брать из — из упаковок и номенклатуры или только из номенклатуры (только для УТ, КА и ERP).
ПРО Работа с местами — как раскладывать товары заказа по местам по умолчанию: весь заказ — одно место; каждая позиция заказа — отдельное место; каждая единица товара — отдельное место.
ПРО Обновлять таблицу мест при изменении заказа — чтобы изменения в заказе сразу попадали в места.

Ниже — габариты по умолчанию, отдельно для товара и для места. Габариты товара указываются для одной штуки: 10 шт. по 2 кг — это 20 кг.

Использовать габариты места по умолчанию — каждое место получит габариты из колонки «Место».
Габариты по умолчанию действуют для: «всех товаров» — берутся только значения из настроек, габариты из карточек товаров не учитываются; «товаров с незаполненными габаритами» — габариты берутся из базы, а чего не хватает — из настроек.

В Базовой версии заказ всегда отправляется одним местом.

→ Откуда данные: Габариты: источник и расчёт

Статусы¶

Здесь задаётся, какой статус поставить заказу в 1С, когда служба присылает новый, и какое письмо или SMS отправить клиенту.

При получении нового статуса — «провести заказ» или «не проводить заказ, только записать статус». Второй вариант безопаснее.
ПРО Куда записывать статус заказа — реквизит «Статус» документа, доп. реквизит или доп. сведение.

В таблице для каждого статуса службы можно указать статус 1С, шаблон e-mail и ПРО шаблон SMS. Если статус 1С не указан, заказ не меняется.

→ Как работать: Рассылка СМС и электронных писем при изменении статуса заказа

Отправка¶

Добавлять дату к номеру заказа — выключайте, только если номера заказов в вашей базе никогда не повторяются.
Передавать артикулы товаров — выключите, если службе доставки они не нужны.
Можно выбирать тарифы без расчёта — если стоимость доставки известна заранее. Но тогда ошибки в данных заказа, которые находит расчёт, выяснятся только при отправке.
Использовать служебные услуги и таблица «Служебные услуги» — номенклатура, которой в заказах обозначают доставку (например, «Доставка товара»). Подойдёт только номенклатура с типом «Услуга» (работы тоже подходят). Поддерживается не всеми службами.
Показывать всплывающие оповещения — оповещения могут закрывать кнопки формы.
Обновлять статус заказа при открытии формы модуля — полезно, если данные терялись, база новая или заказы отправляли через личные кабинеты служб. Если выключить, форма открывается заметно быстрее.
ПРО Мультиотправка — «Объединять заказы одного получателя в одну отправку», «Объединять только заказы одной организации», «Объединять только заказы одного клиента». Первый флажок задаёт значение по умолчанию: в форме мультиотправки объединение можно включить или выключить. Два других действуют всегда.

→ Откуда данные: Номер заказа в службе доставки, Служебные услуги

Отправители¶

Здесь можно указать, как организация будет называться в накладных, и её контакты: контактное лицо, телефон, e-mail. Заполняйте, только если они отличаются от данных 1С.

→ Откуда данные: Контакты отправителя

Сторонние сервисы¶

Пункт меню «Сервисы»: Dadata для распознавания адресов и Яндекс.Карты для выбора ПВЗ на карте.

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

Dadata¶

Если используете Dadata для распознавания адресов, зарегистрируйтесь здесь, введите выданные токен и секретный ключ и включите «Распознавать адреса с помощью Dadata». На счёте Dadata должны быть деньги.

Флажок «Автоподбор городов через Dadata при выборе ПВЗ» улучшает поиск городов в форме выбора ПВЗ — включайте его, если используете Dadata.

Яндекс.Карты¶

Ключ Яндекс.Карт нужен, чтобы выбирать ПВЗ на карте. Если ключа ещё нет, зайдите на страницу https://yandex.ru/maps-api/console и подключите два API — «API Геокодера» и «JavaScript API»:

Затем на странице https://yandex.ru/maps-api/console/keys добавьте новый ключ и привяжите к нему продукты «JavaScript API» и «API Геокодера» кнопкой «Привязать продукт». В результате ключ должен выглядеть так:

Права¶

ПРО Здесь можно ограничить доступ пользователей к функциям модуля.

Ограничивать доступ к модулю по правам — включает проверку прав.
Права по умолчанию — для тех, кого нет в таблицах.
Права можно задать пользователю или группе пользователей (вкладки «По пользователям» и «По группам»). Если пользователей много, удобнее через группы.

→ Как это работает: Права пользователей

Плагины¶

ПРО Плагины расширяют возможности модуля. Их можно разработать самостоятельно или купить на сайте api-1c.ru.

Как подключить плагин:

Добавьте обработку в 1С: в УТ, КА и ERP — НСИ и администрирование → Доп. отчёты и обработки; в УНФ — Компания → Администрирование → Доп. отчёты и обработки.
В настройках модуля откройте раздел «Плагины», нажмите «Добавить», выберите обработку и включите флажок «Включён».

Плагины выполняются сверху вниз, порядок можно менять стрелками.

Плагин с публикацией «Режим отладки» в дополнительных отчётах и обработках модуль убирает из таблицы и сообщает, какой плагин и почему: из таблицы он работал бы у всех пользователей. Чтобы подключить такой плагин, установите ему публикацию «Используется» и добавьте его снова.

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

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

Подготовка базы¶

Здесь открывается чек-лист готовности к работе — текущее состояние базы.

→ Подробнее: Подготовка 1С к работе модуля

Обслуживание¶

Группы «Восстановление», «Хранение данных» и «Опасные действия» свёрнуты.

Режим отладки, отправку файла настроек, восстановление и сброс используйте только по просьбе техподдержки.

Обновить кэш (группа «Кэш») — загружает свежие справочники служб: ПВЗ, тарифы и т. п. Нажмите после первой настройки, дальше кэш обновляется сам.
Отправить файл настроек в тех. поддержку (группа «Техподдержка») — отправляет настройки модуля в поддержку.
Режим отладки — данные расчёта и отправки дублируются в техподдержку.
Восстановить утерянные данные (группа «Восстановление») — восстанавливает у отправленных заказов ID, статус, трек-номер и службу доставки, например после переноса базы или сбоя. Модуль спросит, что восстанавливать: «Только отправленные заказы» (быстрее, если ID заказов в базе сохранились) или «Все заказы». Восстановление может идти очень долго — запускайте его в нерабочее время, в отдельном сеансе 1С.
Хранить данные модуля в отдельном регистре сведений (группа «Хранение данных») — данные модуля будут записываться не в типовой регистр «Дополнительные сведения», а в регистр «API1CДополнительныеСведения» такой же структуры. Включайте, только если такой регистр есть в базе. Уже записанные данные не переносятся.
Там же — список реквизитов модуля: какие доп. сведения заказа он использует. Кнопка «Создать и заполнить реквизиты» создаёт недостающие и заполняет пустые поля; нажимать её можно сколько угодно — дублей не будет. Меняйте реквизиты модуля, только если настроен обмен с Битрикс или другой CMS и вы точно знаете, что делаете.
Сбросить настройки (группа «Опасные действия») — возвращает модуль к состоянию «как после установки». Удаляются вход в аккаунт, подключения служб (прямые подключения придётся вводить заново, остальные подключения вернутся после входа — см. Способы подключения служб), соответствия статусов, права и ссылки на реквизиты. Сначала включите «Понимаю, что настройки будут удалены» — тогда кнопка станет доступной. Данные заказов не удаляются. Если форма настроек не открывается, настройки удаляет команда «Удалить настройки модуля Api1C» обработки «Api1C - фоновая работа по расписанию».