Главная / Документация / Модуль для 1С-Битрикс

Модуль для 1С-Битрикс

Версия 0.9 · бесплатно

Модуль связывает интернет-магазин на 1С-Битрикс с FastShipping. Заказ уходит в доставку сам, когда менеджер переводит его в выбранный статус, а в заказ возвращаются статус доставки и ссылка отслеживания для покупателя. Отменили заказ в магазине — он снимается и у нас.

Модуль не трогает корзину, цены и оформление заказа: покупатель не видит никаких изменений. Он работает с уже оформленными заказами в админке.

1. Что понадобится

Редакция с интернет-магазином: «Малый бизнес», «Бизнес» или «Энтерпрайз». В «Старте» и «Стандарте» магазина нет — модуль скажет об этом при установке. Если у вас несколько складов, нужна редакция со складским учётом на несколько складов — «Бизнес» или старше.
PHP 8.2 или новее — это требование самого Битрикса с февраля 2026 года.
Ключ API FastShipping. Его выпускает администратор в панели: «Интеграции» → «Ключи API». Ключ показывается один раз — скопируйте его сразу.
Сайт, открытый из интернета. Статусы доставки приходят на адрес вашего сайта, поэтому он должен быть доступен снаружи и по https.

2. Установка

Скачайте архив модуля: fastshipping-bitrix.zip.
Распакуйте его в папку local/modules/ вашего сайта — внутри появится папка fastshipping.delivery. Если папки local/modules нет, создайте её.
В админке откройте «Marketplace» → «Установленные решения», найдите «FastShipping: доставка» и нажмите «Установить».

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

3. Подключение

Настройки модуля: «Настройки» → «Настройки продукта» → «Настройки модулей» → «FastShipping: доставка». Первая вкладка — «Подключение».

Адрес API оставьте как есть.
В поле «Ключ API» вставьте ключ из панели.
Нажмите «Сохранить и проверить связь». Должно появиться «Связь есть, ключ принят».

После сохранения поле ключа снова пустое, а под ним написано «Ключ сохранён». Так и задумано: ключ не показывается обратно, чтобы не светиться в админке. Пустое поле при следующем сохранении ключ не стирает; чтобы заменить ключ, впишите новый.

4. Сопоставления

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

Когда передавать заказ

Выберите статус «готов ехать» — заказ уйдёт в доставку сам, как только менеджер переведёт его в этот статус. Обычно это статус вроде «Собран» или «Готов к отправке». Можно оставить «не передавать автоматически» — тогда только кнопкой.

Дата и время доставки

Своих полей для даты доставки у Битрикса нет. Если вы спрашиваете у покупателя день и время, выберите свойства заказа, в которых они хранятся. Время понимается в виде «10:00–14:00», «10-14» или «с 10 до 14». Непонятную дату модуль не угадывает: заказ уйдёт без даты, и день назначит диспетчер.

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

Отметьте службы, которые вы возите сами, — обычно «Доставка курьером». Самовывоз и транспортные компании не отмечайте: такие заказы модуль пропускает молча.

Склады

Если склад один — можно не заполнять, заказы уйдут с основного склада FastShipping. Если складов несколько, у каждого укажите код склада FastShipping: он задаётся в панели, «Компания» → «Склады», поле «Код склада в вашей системе».

Заказ, который собирается с нескольких складов (у него несколько отгрузок), уходит отдельной доставкой с каждого склада — под номером отгрузки, например «1024/2». Склад берётся у позиций отгрузки, а пока менеджер его не выбрал — из резерва товара.

Как курьеру брать деньги

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

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

5. Статусы от доставки

Вкладка «Статусы от доставки» — что меняется в заказе, когда меняется доставка.

Проверьте «Адрес сайта, видимый из интернета» и нажмите «Подключить». FastShipping начнёт присылать изменения заказов на ваш сайт. Нажимать нужно один раз — и снова, если модуль переустанавливали или события перестали приходить.
Для каждого состояния доставки выберите статус заказа в Битриксе или «не менять». Обычно «доставлен» → «Выполнен». Статус «готов ехать» здесь выбрать нельзя: заказ отправлялся бы к нам по кругу.
Переключатель «Отменять заказ в Битриксе» — если доставку отменили у нас, заказ отменится и у вас, с причиной.

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

6. Как это работает каждый день

Передача. Менеджер переводит заказ в статус «готов ехать» — заказ уходит сам. Для заказов, которые проскочили этот статус, в карточке заказа есть кнопка «Передать в FastShipping»: она открывает просмотр — получатель, адрес, склад, сумма к получению — и только оттуда заказ передаётся кнопкой «Передать в доставку». Если передать нельзя, там же написано почему.

В карточке заказа появляются ссылка отслеживания — её можно отправить покупателю — и «Статус в FastShipping»: что с доставкой прямо сейчас.

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

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

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

7. Если что-то не так

Когда заказ не удалось передать автоматически, в админке появляется уведомление с причиной и ссылкой на страницу передачи.

Что видите	Что делать
«Ключ API не принят»	Ключ отозван, истёк или скопирован не полностью. Выпустите новый в панели и вставьте в настройках.
«В заказе нет отгрузки со службой доставки, которую вы возите сами»	Отметьте службу на вкладке «Сопоставления» или смените доставку в заказе.
«Способ оплаты … отмечен как „оплачено заранее“, а заказ не оплачен»	Если по нему платят курьеру — поменяйте сопоставление; если на сайте — дождитесь оплаты.
«…склад не сопоставлен» или «…склад не указан»	Укажите код склада FastShipping на вкладке «Сопоставления» или выберите склад у позиций отгрузки в заказе.
«Заказ с нескольких складов оплачен частично»	Кто из курьеров берёт остаток, модуль не угадывает. Примите оплату целиком или передайте части диспетчеру вручную.
«Заказ уже в работе у доставки»	Курьер мог уже выехать — изменения передавайте диспетчеру по телефону.
Статусы перестали приходить	На вкладке «Статусы от доставки» нажмите «Подключить»: подписка включится заново. Пока её нет, заказы подтянет сверка.

8. Удаление

«Marketplace» → «Установленные решения» → «Удалить». Настройки модуля и ключ API стираются — ключ не должен оставаться в базе магазина. Служебные поля заказа остаются: в них данные уже переданных заказов. Подписка на события у нас после удаления отключится сама.

Вопросы

Пишите на support@fast-shipping.ru — укажите номер заказа и текст ошибки или уведомления из админки.