Модуль интеграции между 1С и службами доставки посредством работы через API служб и сервисов. Устанавливается как внешняя обработка (Api1C.epf) без изменений базы.

Создаёт:

Доп. сведения к документам с префиксом (Api1C)
Две обработки: работа с заказом и фоновая

Фоновая обработка обновляет статусы заказов каждые 1800 сек.

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

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

Откройте Настройки → Пользователи и права → Пользователи, выберите нужного пользователя и перейдите во вкладку Права доступа.

Если в списке групп уже есть Открытие внешних отчётов и обработок, изменений не требуется.

Если нет — нажмите Включить в группу → Открытие внешних отчётов и обработок, затем сохраните все формы.

Классификаторы адресов

Для корректной работы адресов «от» и «до двери» требуется подключение классификаторов (ФИАС, ГАР). Возможны три способа:

Рекомендуемый способ — онлайн-классификатор 1С. Подключите интернет-поддержку (через франчайзи). В разделе НСИ и администрирование → Интернет-поддержка и сервисы → Классификаторы установите флажок Подбирать адреса через Интернет.
Локальный классификатор. Скачайте базу ФИАС с https://its.1c.ru/download/fias2 и загрузите в 1С.
Распознавание через Dadata. Подходит, если адреса приходят с сайта и не требуют ручного выбора. Подключение выполняется по API Dadata.

Габариты

Модуль поддерживает три способа определения габаритов:

Через упаковки 1С (рекомендуется) — задайте размеры в упаковках товаров.
Через номенклатуру — если нет упаковок, модуль вычисляет недостающие размеры по объёму или площади.
Фиксированные габариты — единые значения для всех отправлений задаются в настройках модуля.

Настройки базы

Проверьте, что включено:

использование дополнительных обработок и отчётов;
использование доп. свойств и реквизитов;
работа со складами и доставкой (если предусмотрено конфигурацией).

Адреса складов в 1С

В каждом складе, участвующем в отгрузке, должен быть указан корректный адрес. Откройте карточку склада и введите адрес через форму 1С с типом Муниципальный или Административно-территориальный. Не используйте тип Произвольный.

Номер заказа

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

Защита от опасных действий

Отключите системную защиту, мешающую фоновым заданиям (обновление статусов и кэша).

Откройте файл conf.cfg в папке платформы 1С (обычно C:\Program Files (x86)\1cv8\conf)

и добавьте строку:

DisableUnsafeActionProtection=*;

Можно отключить выборочно, указав имя базы, например:

DisableUnsafeActionProtection=test_.*;stage_.*;

Тонкий клиент и удалённое подключение

Для корректной работы требуется соединение с серверами api-1c.ru и api.apiship.ru.

Тонкий клиент / RemoteApp: доступ должен быть разрешён на сервере приложений.
Толстый клиент: доступ нужен с каждого рабочего места.

Данные, необходимые для работы со службами доставки

Для работы со службой доставки должен быть заключён договор. Модуль рассчитывает тарифы и отправляет заказы только по службам, данные которых указаны в настройках.

Для «Деловых линий» есть дополнительное требование – зарегистрируйтесь на https://dev.dellin.ru/registration/ и укажите ключ в настройках модуля.

Добавление в информационную базу и настройки модуля

Пользователь должен иметь права на внешние обработки, как это было описано выше.

Чтобы установить модуль:

откройте файл Api1C.epf в 1С (через Файл → Открыть)
или перетащите его в окно программы

⚠️ Не создавайте вручную элемент в “Дополнительных отчётах и обработках” — всё нужное создаётся автоматически при первом открытии.

После запуска откроется форма авторизации.

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

Открытие формы настроек модуля

После установки форма доступна в разделе НСИ и администрирование → Печатные формы, отчёты и обработки → Дополнительные обработки.

Для УНФ и Розницы — Компания или Настройки.

Администратор также может открыть настройки через команду «Выполнить» в обработке

Api1C — фоновая работа по расписанию и выдать быстрый доступ пользователям. Форма доступна только пользователям с соответствующими правами.

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

Создайте или заполните реквизиты, участвующие в обмене с сайтом и службами доставки. Если интеграции с сайтом нет — просто нажмите «Создать и заполнить реквизиты».

ВНИМАНИЕ! Изменяйте значения в этих полях ТОЛЬКО, если есть настроенный обмен с БИТРИКС или другой CMS, и если понимаете, что делаете.

После нажатия данная закладка должна иметь примерно следующий вид:

Кнопку можно нажимать повторно — новые поля добавятся, старые не задвоятся.

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

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

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

Автозаполнение дат — при открытии формы устанавливается текущая дата отправки и доставки.
Не добавлять дату к номеру — отключайте только если номера заказов в базе уникальны.
Группировать мультизаявки — определяет поведение при мультизаявках. Подробнее – в разделе Мультизаявки.
Обновлять статус при открытии формы — удобно, если данные терялись, база новая или заказы отправлялись через личные кабинеты.
Не отправлять артикулы — если в службе доставки не требуется.
Не учитывать организацию в группировке — объединяет заказы разных юрлиц.
Можно выбирать тарифы без расчёта — если стоимость известна заранее.
Тип отправки / доставки — значения по умолчанию.
Страховка отключена — влияет на оценочную стоимость.
Оплата:
- «Заказ оплачен по умолчанию» — всегда “Да”.
- «Использовать информацию об оплате» — берёт статус из 1С.
- «Устанавливать вручную» — пользователь сам указывает.
Источник адреса доставки — выбирается из клиента, заказа или иного реквизита.
Время отправки/доставки — доступно в версии ПРО при включённом авто-заполнении дат.

Габариты и места

Эта вкладка определяет, как рассчитываются размеры и вес.

Габариты по умолчанию:
- «для всех товаров» — используются только заданные здесь значения;
- «для товаров без габаритов» — берёт из базы, остальное — отсюда.
Работа с местами:
- один заказ = одно место;
- по каждой позиции — отдельное место;
- по каждой единице — отдельное место. Настройка влияет только на автоматическое распределение — изменить можно вручную.
Обновлять таблицу мест при изменении документа — чтобы правки в заказе отражались в модуле.

Подробно расчёт габаритов описан в разделе «Расчёт габаритов».

ВНИМАНИЕ! Работа с местами поддерживается только модулем версии ПРО. В версии Базовая один заказ всегда отправляется как одно место.

Статусы заказа

Позволяет задать соответствие статусов 1С и служб доставки. Также можно включить рассылку email и SMS при смене статуса.

При получении нового статуса:
- «Проводить заказ» или «Только записывать» — второй вариант безопаснее.
Тип реквизита статуса:
- типовой статус 1С, доп.сведение или доп.реквизит.
Таблица статусов задаёт сопоставления и шаблоны писем/SMS. Пустая ячейка — действие не выполняется.

Настройка 1С для отправки электронной почты и СМС, а также создание шаблонов с использованием данных модуля подробно описаны в разделе Рассылка СМС и электронных писем при изменении статуса заказа

Настройки для организаций

Позволяет указать отображаемые в накладных наименования, телефоны и e-mail. Если поле не заполнено, используется краткое название из карточки организации.

Служебные услуги

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

⚠️ Поддерживается не всеми службами.

Например, если на данной закладке выбрать номенклатуру «Доставка товара», то при отправке заказа в службу доставки будет проверяться наличие данной номенклатуры в таблице «Товары» данного заказа. Если эта номенклатура будет обнаружена в заказе, её сумма будет вычтена из суммы товаров к отправке, а в накладной эта сумма будет фигурировать в поле «Стоимость доставки».

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

ВНИМАНИЕ! Обязательно проверяйте введённые на этой странице коды и ключи. Часто при копировании в них могут попадать пробелы и другие символы. Нажмите на кнопку «Показать» справа от поля и проверьте правильность.

Закладка Dadata

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

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

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

Чтобы выбирать ПВЗ на карте, введите API-ключ с developer.tech.yandex.ru (сервис “JavaScript API и HTTP Геокодер”).

Плагины

(Доступно в версии ПРО)

Плагины расширяют функциональность модуля. Их можно:

разработать самостоятельно;
купить на сайте api-1c.ru.

Подключение плагина:

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

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

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

Права

В модуле версии «ПРО» можно ограничить доступ к функциям модуля.:

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

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

Вкладка содержит функции для диагностики и техподдержки.

⚠️ Использовать только по указанию службы поддержки.

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

Прочие настройки

Если в формах «Отправка заказа» или «Выбор ПВЗ» возникают ошибки безопасности, добавьте в доверенные сайты браузера Internet Explorer:

about:security_1cv8c.exe
about:security_1cv8.exe
https://api-maps.yandex.ru

Подключение служб доставки

Откройте вкладку Службы в настройках модуля.
Нажмите Добавить → выберите нужную службу.

Версия ПРО: можно добавить до 3 подключений одной службы (разные кабинеты/договоры).

Базовая версия: только одно подключение.

Выбор соответствия службе в 1С

В открывшемся окне выберите службы доставки из 1С, соответствующие подключаемой службе. Автоматические совпадения можно скорректировать вручную. Если таблица пустая — соответствие можно задать позже. Эти данные нужны, чтобы модуль автоматически определял нужную службу при работе с заказом.

Выбор организаций

(Только версия ПРО)

Позволяет назначить разные кабинеты службы доставки разным организациям 1С.

Рекомендуется делать первое подключение без организаций (используется по умолчанию).
Второе и третье — с указанием организаций.

Пример:

ООО «Первая» и ООО «Вторая» → кабинет «Курьер»; ИП «Третий» и ООО «Отдельная» → кабинет «ПВЗ». Модуль сам выберет нужный кабинет при отправке.

Ввод параметров подключения к службе

После выбора организаций нажмите Авторизация. Введите данные (логин, пароль, токен и пр.) из договора или личного кабинета службы. Затем — Проверить подключение. При ошибке проверьте данные и интернет-доступ.

Дополнительные параметры службы

Некоторые службы (например, «Энергия») требуют ввод доп. параметров.

Также здесь можно задать наценку на тариф (только ПРО).

Выбор ПВЗ отправки

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

Алгоритм подстановки:

Если у склада указано соответствие ПВЗ — берётся оно.
Иначе — общий ПВЗ из настроек.

Подробнее о работе с формой выбора ПВЗ – см. здесь.

Для версии модуля ПРО доступен выбор основного ПВЗ и отдельных ПВЗ для разных складов.

Контакты отправителя

На следующем шаге укажите контактные данные организации (телефон, e-mail, ФИО). Эти данные будут отображаться в накладных служб доставки. Работает также, как описанные выше общие контакты, но только для данного подключения.

Настройки дополнительных услуг по умолчанию

(Версия ПРО)

Можно задать типовые услуги (примерка, уведомление и т.п.), которые автоматически подставляются при создании новых заказов данной службы. Позже их можно изменить вручную в форме заказа.

Затем нужно нажать кнопку «Завершить и сохранить». Данные будут сохранены в настройках модуля, данная форма закроется и откроется форма общих настроек модуля.

Работа с заказами

В данном разделе — инструкция для пользователей, которые осуществляют обработку заказов.

Для работы модуля в системе должен быть заведён один из поддерживаемых документов.

Модуль вызывается:

из списка документов → Заполнение → (Api-1C) Доставка;
из формы документа → Заполнение → (Api-1C) Доставка.

Также доступны команды:

(Api-1C) Обновить статусы заказов
(Api-1C) Групповая работа с заказами
⚠️ Команда «Очистить реквизиты доставки» удаляет все доп. сведения, созданные модулем. Используйте только при полном понимании последствий, чтобы не нарушить работу обменов (например, с Битриксом).

ВНИМАНИЕ! В зависимости от версии конфигурации, настроек формы и размера экрана, подменю «Заполнить» может иметь только иконку

, без надписи, или же находиться в подменю «Ещё».

Массовая отправка

Позволяет одновременно обрабатывать несколько заказов. Выберите нужные заказы в списке и откройте (Api-1C) Доставка. Слева появится список заказов.

⚠️ Каждое действие применяется ко всем заказам. Например, нажатие «Рассчитать» рассчитает тарифы сразу для всех, а «Отправить» — отправит все заказы. Редактировать отдельный заказ в этом режиме нельзя — для этого откройте его отдельно.

Используйте массовую отправку для однотипных заказов (одинаковые точки, даты, тип доставки).

При большом объёме доставок это значительно ускоряет работу.

Основные реквизиты формы модуля

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

После отправки заполняются:

ID заказа;
статус;
дата отправки;
трек-номер (может появиться позже).

Щёлкните по статусу, чтобы просмотреть подробности заказа.

Служба, тариф, стоимость — заполняются после расчёта. Можно заранее выбрать нужную службу.

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

Получатель

Данные подставляются автоматически:

Контакт из документа (если есть);
Контакт по умолчанию клиента;
Первый контакт клиента;
Данные клиента.

Три режима автозаполнения:

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

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

Адрес отправки

Если тип отправки — «от двери», берётся адрес склада из заказа. Если в заказе группа складов — адрес берётся у первого заполненного склада. Этот адрес используется для расчёта тарифа.

Адрес доставки

Может быть подставлен автоматически.

Если заказ пришёл с сайта (Битрикс или CMS) и в нём есть ПВЗ в формате <Адрес>#S<номер> или <Адрес> # <номер> — модуль распознает ПВЗ, подставит адрес, номер и службу. При ошибке пользователь вводит адрес вручную. Например, «Магнитогорск, ул. ТРУДА, д. 27 # 1633»

Для авто-подстановки используйте меню справа от поля адреса:

Адрес из заказа
Адрес доставки клиента
Фактический адрес
Почтовый адрес

⚠️ Адрес должен быть оформлен по ФИАС (ГАР). Если используется произвольный ввод — включите Дадата или введите поля вручную и подтвердите корректность.

Для зарубежных адресов предусмотрено ручное заполнение регионов и городов (1С и Dadata не определяют иностранные адреса). После ввода нажмите «Подтверждаю корректность адреса».

ВНИМАНИЕ! Отправка заказа за пределы РФ возможна, но не гарантируется. Также пользователь должен самостоятельно проследить за корректностью ввода всех данных адреса.

Выбор ПВЗ

Работает при типе доставки «До ПВЗ». Введите город — появится список доступных пунктов. Регистр неважен («москва» = «Москва»).

Если подключена Dadata, автоподбор будет быстрее и точнее.

Если Дадата не подключена, используется ФИАС или онлайн-классификатор 1С. Если город не найден, загрузите классификатор (см. здесь).

Можно искать ПВЗ:

по названию улицы (через поиск);
на карте (если подключён API Яндекс.Карт);
вручную, введя город полностью и нажав Enter.

Кэш обновляется каждые 6 часов. Если нужен новый список (например, открылся новый ПВЗ), очистите кэш в настройках.

Параметры оплаты

Поля:

Заказ уже оплачен
Без страховки
Клиент платит за доставку

Подсказка под формой показывает итоговую сумму наложенного платежа.

Например:

Стоимость заказа — 1000 ₽
Стоимость доставки для клиента — 333 ₽
Тариф службы — 150 ₽

Варианты:

Клиент платит всё → доставка берёт 1000 + 333 ₽, отправителю возвращают 1183 ₽.
Отправитель платит всё → клиент 0, отправитель 150 ₽.
Заказ оплачен, доставка платная → клиент платит 333 ₽.
Заказ с бесплатной доставкой → клиент платит 1000 ₽, отправитель 150 ₽.

Расчёт тарифа и отправка

Нажмите «Рассчитать». Будет выбран самый дешёвый тариф (при наличии службы по умолчанию — её тариф).

После расчёта станет доступна кнопка «Отправить заказ». Отправка передаёт данные заказа в службу доставки.

Дополнительные реквизиты формы модуля

Скрытая вкладка с параметрами, заполняемыми вручную при необходимости.

Отправить служебные данные в техподдержку — включает логирование запросов.
Комментарий менеджера — передаётся в службу доставки.
Дата отправки и доставки — можно задать вручную. Если система выдаёт ошибку «deliveryDate должна быть ≥ текущей дате», нажмите «Актуализировать даты».

Дополнительные услуги и параметры

Это опции служб доставки: примерка, проверка товара, частичная выдача и т.п. Указывайте до расчёта тарифа — они влияют на цену. Если не используются — лучше отключить, чтобы ускорить работу модуля.

Работа с местами

(только версия ПРО)

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

Добавить, удалить, объединить места;
Перетаскивать товары между местами;
Редактировать размеры и вес.

Места без товаров не отправляются. Ctrl + перетаскивание — добавляет товар в два места (если делите поставку).

Рекомендуется использовать упаковки с целыми единицами — дробные количества и объёмы искажают расчёт габаритов.

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

Отправитель

Вкладка содержит данные отправителя. Подставляются из организации в заказе или из настроек модуля. Можно указать вручную или выбрать пользователя 1С.

Дополнительно

Укажите данные документа получателя (паспорт и др.), если требует конкретная служба.

Тех. поддержка

Раздел для связи с поддержкой модуля.

⚠️ Используйте только по указанию специалистов.

Отправлять служебные данные — ведёт лог запросов.
Отправить доп. данные — используется, если ошибка блокирует логирование.
Выгрузить данные заказа — формирует копию заказа для анализа.

Мультизаявка и вызов курьера

Позволяет объединять заказы для одной службы в одну заявку (поддерживаются «Деловые линии», «Почта России», «СДЭК» и др.).

Левая часть — список мультизаявок (создание, удаление, отправка).
Правая — заказы внутри выбранной заявки.

Редактировать:

Слева — массово (меняет реквизиты всех заказов сразу).
Справа — отдельно для конкретного заказа.

Флаг «Группировать похожие заказы» объединяет заказы с одинаковыми получателями и адресами в один.

Ограничения “Деловых линий”:

Одинаковый адрес и дата отправки;
Тип — только «от двери»;
В ЛК отображаются как обычные заказы.

Алгоритм:

Создайте мультизаявку;
Добавьте заказы;
Проверьте реквизиты;
Нажмите «Редактировать» → «Рассчитать»;
Если тарифы рассчитаны — «Отправить».

Печатные формы и подтверждение заказов

Выделите заказы и выполните команду (Api-1C) Печать, акты, подтверждения. В форму попадут только отправленные заказы.

Слева — список заказов, справа — печатные формы выбранного. Если формы уже получены, они доступны для просмотра и печати. Если нет — нажмите «Получить формы».

Форма списка заказов

Форма списка нужна для просмотра, фильтрации и управления заказами, связанными с доставкой. В ней можно настроить отображение статусов, трек-номеров и других данных, получаемых от служб доставки.

Включение формы и команд

Чтобы команды модуля появились в списке заказов:

В списке документов (например, Заказы клиентов) откройте меню Ещё → Настроить список → Команды.
Включите команды:
- (Api-1C) Доставка — открывает форму модуля для выбранного заказа;
- (Api-1C) Обновить статусы заказов — обновляет статусы всех выделенных заказов;
- (Api-1C) Групповая работа с заказами — для массовой отправки.
При необходимости добавьте их на панель команд (удобно для ежедневной работы).

Чтобы форма показывала все нужные данные:

В списке заказов выберите Ещё → Настроить список → Состав колонок.
Добавьте поля, созданные модулем (обычно начинаются с префикса (Api-1C)):
- ID заказа
- Служба доставки
- Трек-номер
- Статус доставки
- Дата отправки
При необходимости переместите их выше, чтобы были видны сразу.

Частичная отправка

Частичную отправку можно выполнить стандартными средствами 1С.

На основании Заказа клиента создайте нужное количество документов Реализация товаров и услуг (РТУ).
В каждом измените состав номенклатуры и другие данные по необходимости.
Отправьте каждый документ РТУ через модуль отдельно.

Работа с РТУ через модуль полностью аналогична работе с Заказом клиента. Такой способ подходит, если клиент получает заказ частями или поставка делится на несколько отправлений.

Использование данных модуля в других механизмах

Модуль сохраняет все данные заказа в дополнительных сведениях, связанных с самим заказом, с префиксом (Api1C).

Вы можете использовать эти данные в своих механизмах — как для чтения, так и для записи. Например:

если хотите, чтобы модуль использовал вес, рассчитанный внешней системой (например, сайтом), создайте обработку, записывающую этот вес в доп.сведения модуля;
тогда при открытии формы модуля будет использовано ваше значение вместо расчёта по алгоритму модуля.

⚠️ Осторожно: любое изменение данных модуля может повлиять на его работу.

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

Модуль позволяет уведомлять клиентов при смене статуса заказа. Настройки выполняются в 1С и в модуле.

Базовая версия — только e-mail.
ПРО-версия — e-mail и СМС.

Общие обязательные рекомендации

Из-за ограничений 1С используйте только новый шаблон:

Создайте шаблон → не задавайте назначение (или выберите Общий).
Добавьте параметр Заказ клиента (в УНФ – Заказ покупателя).
Разверните ветку и выберите поля с префиксом (Api1C).
После заполнения установите назначение Заказ клиента → Записать и закрыть.

Электронные письма

Настройте учётную запись e-mail:
- УТ/КА/ERP — НСИ и администрирование → Органайзер;
- УНФ — Компания → Администрирование → Почта и SMS.
Создайте шаблон, используя данные модуля в теме и тексте.
В настройках статусов выберите шаблон (или создайте новый).

При получении статуса модуль автоматически отправит письмо по шаблону.

Отправка СМС

Настройте учётную запись SMS:
- УТ/КА/ERP — Органайзер → Настройка SMS;
- УНФ — Администрирование → Почта и SMS.
Создайте шаблон (без темы), при необходимости включите транслит для экономии.

Пример СМС, созданного по шаблону выше:

Обмен данными с CMS Bitrix или другими модулями для сайта

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

Схема настроек такая:

Для корректной работы:

В настройках обмена включите передачу доп.сведений.
Совместите поля сайта и модуля (префикс (Api1C)).
При загрузке заказа с сайта модуль автоматически подставит адрес, ПВЗ и контактные данные.

⚠️ При нестандартном обмене укажите в настройках имена полей сайта, соответствующие данным доставки.

Описания алгоритмов

Номер заказа

Если в настройках модуля включено добавление даты к номеру, модуль формирует уникальный номер Номер + Дата. Функцию можно отключить, если номера в базе уже уникальны.

Заполнение контактных данных получателя

Телефон получателя

Если нужно к телефону добавить какую-то доп.информацию (например, добавочный номер), то эту информацию нужно внести в «Комментарий менеджера»:

Дополнительная информация контактного лица

Если в карточке контактного лица контрагента указана какая-то информация в поле «Дополнительная информация», то она будет перенесена в поле «Комментарий менеджера»:

Источник и расчёт габаритов

Источники габаритов для конфигураций «Управление торговлей», «Комплексная автоматизация» и «ERP» показан на схеме ниже:

Для конфигурации «Управление нашей фирмой»:

Если габариты не найдены ни в базе, ни в настройках, отправка завершится ошибкой. Возможные подходы:

Одинаковые грузы — включите «Габариты по умолчанию для всех товаров» и задайте их в настройках. База может быть без габаритов.
Частично типовые грузы — включите «Габариты по умолчанию для товаров с незаполненными габаритами». Задайте реальные размеры только для нетиповых товаров.
Контроль габаритов — ту же настройку, но без значений по умолчанию. При отсутствии габаритов модуль выдаст ошибку, обеспечивая контроль заполнения.

Алгоритм расчёта:

Модуль использует метод «кучи» — компактную компоновку товаров без чрезмерного увеличения одного измерения.

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

Преимущества:

исключает «поезда» из длинных товаров (например, 10 пар лыж не дают длину 18 м);
уменьшает пустоты при смешанных размерах, снижая итоговые габариты и стоимость доставки;
при разных по размеру товарах (монитор, клавиатура, мышь) даёт компактный «куб», близкий к размеру наибольшего предмета.

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

Алгоритм заполнения службы доставки показан на схеме ниже:

Ответы на вопросы и решение проблем

У нас в базе уже есть дополнительные сведения и/или дополнительные реквизиты, привязанные к заказу клиента. Может ли модуль использовать информацию из них, вместо своих доп.сведений?

Модуль может частично использовать уже существующие доп.сведения — их можно указать в настройках модуля. Для остальных данных требуется собственная реализация: нужно настроить копирование значений из ваших доп.сведений в доп.сведения модуля.

Код запроса в техподдержку – где его взять?

Если техническая поддержка запросила у Вас код запроса в тех.поддержку, то Вам нужно перед выполнением действия, для которого запросили код, установить флажок «Отправить данные в тех.поддержку», а затем выполнить нужное действие (например, Расчёт тарифа или Отправку заказа). Код запроса появится в сообщениях:

В сообщениях может быть очень много разных служебных данных, из-за чего код можно не найти сразу. В этом случае просто сообщите службе поддержки, что Вы выполнили нужное действие.

ВНИМАНИЕ! Не нужно нажимать ни на какие другие кнопки и ссылки на этой странице, если вас об этом явно не попросила служба тех. поддержки.

Как отправить данные заказа в тех. поддержку

Процедуру выполняйте только по запросу поддержки. Откройте заказ → раздел «Доп. реквизиты и услуги» → вкладка «Техподдержка» → нажмите «Выгрузить данные заказа». В окне сохранения выберите папку и нажмите «Сохранить».

Полученный файл отправьте на e-mail службы поддержки.

Как отправить настройки в тех. поддержку

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

Как получить логи запросов в ApiShip и в службы доставки

При запросе от поддержки пользователю нужно самостоятельно выгрузить логи запросов и ответов, так как доступ к ним есть только у него. Для этого нужно зайти в личный кабинет ApiShip по адресу https://a.apiship.ru/#/orders/list. В списке заказов выбрать нужный и нажать на него:

На открывшейся странице нажать на кнопку «Журнал»:

В журнале может быть несколько записей. Выберите нужную и нажмите на неё. Если не знаете, какая запись требуется, то выполните описанные дальше действия для каждой из записей в журнале.

При нажатии на строку журнала, появится всплывающее окно. В нём нужно нажать на кнопку «Скачать», и сохранить полученный файл:

Где взять идентификатор заказа (ИД заказа, ID заказа)?

ИД заказа существует только для отправленного заказа. Для заказа, который ещё не был отправлен, ИД заказа получить НЕвозможно. В отправленном заказе он находится вверху в зелёной области справа:

ВНИМАНИЕ! Если ИД заказа запрашивает техническая поддержка, то отправлять его нужно только в текстовом варианте (не в виде скриншота). В выделенном на картинке поле его нужно скопировать и отправить как текст.

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

Это означает, что в новой версии модуля изменились настройки и требуется их подтверждение. Проверьте их, нажмите «Сохранить настройки» — после этого вместо формы отправки окно настроек больше появляться не будет.

При отправке выходит сообщение «Необходимо заполнить Контактное лицо (ФИО)», хотя контакт заполнен, что делать?

1. Убедитесь, что в карточке организации заполнены полное и юридическое наименование.
2. В настройках модуля на вкладке «Настройки организаций» проверьте: обе колонки заполнены корректно или таблица полностью пустая. Не заполняйте вкладку без необходимости — используйте её только при понимании назначения.

При отправке заказа выдаётся сообщение «Необходимо заполнить Код страны»

Для этого может быть две причины:

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

Адрес доставки заполнен произвольным образом. О том, какие адреса могут использоваться в модуле и как упростить работу с ними, подробнее читайте в соответствующем разделе.

Проблемы с расчётом тарифа для «Почты России» до ПВЗ

Попробуйте выбрать не доставку до ПВЗ, а доставку до двери. Затем указать адрес отделения как адрес доставки. А после расчёта тарифа выбрать тариф, который НЕ подразумевает курьерскую доставку. То есть, например «Курьер онлайн» или «ЕМС».

Руководство пользователя модуля доставки «API-1С»

Какие конфигурации поддерживаются

Документы, с которыми работает модуль

Архитектура решения

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

Классификаторы адресов

Габариты

Настройки базы

Адреса складов в 1С

Номер заказа

Защита от опасных действий

Тонкий клиент и удалённое подключение

Данные, необходимые для работы со службами доставки

Добавление в информационную базу и настройки модуля

Открытие формы настроек модуля

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

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

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

Габариты и места

Статусы заказа

Настройки для организаций

Служебные услуги

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

Закладка Dadata

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

Плагины

Права

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

Прочие настройки

Подключение служб доставки

Выбор соответствия службе в 1С

Выбор организаций

Ввод параметров подключения к службе

Дополнительные параметры службы

Выбор ПВЗ отправки

Контакты отправителя

Настройки дополнительных услуг по умолчанию

Работа с заказами

Массовая отправка

Основные реквизиты формы модуля

Получатель

Адрес отправки

Адрес доставки

Выбор ПВЗ

Параметры оплаты

Расчёт тарифа и отправка

Дополнительные реквизиты формы модуля

Дополнительные услуги и параметры

Работа с местами

Отправитель

Дополнительно

Тех. поддержка

Мультизаявка и вызов курьера

Печатные формы и подтверждение заказов

Форма списка заказов

Частичная отправка

Использование данных модуля в других механизмах

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

Общие обязательные рекомендации

Электронные письма

Отправка СМС

Обмен данными с CMS Bitrix или другими модулями для сайта

Описания алгоритмов

Номер заказа

Заполнение контактных данных получателя

Телефон получателя

Дополнительная информация контактного лица

Источник и расчёт габаритов

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

Ответы на вопросы и решение проблем

Код запроса в техподдержку – где его взять?

Как отправить данные заказа в тех. поддержку

Как отправить настройки в тех. поддержку

Как получить логи запросов в ApiShip и в службы доставки

Где взять идентификатор заказа (ИД заказа, ID заказа)?

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

При отправке выходит сообщение «Необходимо заполнить Контактное лицо (ФИО)», хотя контакт заполнен, что делать?

При отправке заказа выдаётся сообщение «Необходимо заполнить Код страны»

Проблемы с расчётом тарифа для «Почты России» до ПВЗ

Связаться с отделом продаж