Интеграция системы управления предприятием с внешними службами доставки становится стандартом для современного ритейла и оптовой торговли. Достависта — это один из популярных сервисов курьерской логистики, который позволяет автоматизировать процесс передачи заказов от момента оформления до вручения клиенту. Правильная настройка обмена данными между 1С:Предприятие и API курьерской службы экономит часы рутинной работы менеджеров.

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

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

Предварительная настройка справочников и параметров

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

В первую очередь проверьте карточки контрагентов и адреса доставки. Система Достависта требует точного формата адресных строк, включая индекс, город, улицу, дом и помещение. Рекомендуется использовать механизм адресного классификатора, встроенного в платформу , чтобы минимизировать риск опечаток.

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

  • 📍 Проверьте полноту заполнения полей"Город","Улица" и"Дом" в карточках клиентов.
  • 💳 Убедитесь, что в справочнике"Виды оплат" настроены соответствия для методов расчета курьером.
  • 📦 Создайте отдельный склад или место хранения для товаров, отгружаемых через сторонние службы доставки.
  • 🔑 Получите API-ключи в личном кабинете сервиса для авторизации запросов.
⚠️ Внимание: Не используйте тестовые API-ключи на рабочей базе данных после завершения отладки. Это может привести к смешиванию тестовых и реальных заказов, что вызовет путаницу в учете и финансовые потери.
📊 Какой способ интеграции вы планируете использовать?
Прямой обмен через HTTP-сервисы
Обмен через файл (XML/JSON)
Использование готовой обработки от партнера
Ручной ввод заказов на сайте доставщика

Техническая реализация обмена данными

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

Наиболее современным и надежным вариантом является использование HTTP-соединений. Этот метод позволяет отправлять заявки и получать статусы в режиме реального времени без участия пользователя. Для реализации потребуется написать или использовать готовую обработку, которая будет формировать JSON-запросы.

Альтернативный вариант — файловый обмен. В этом случае система выгружает пакет заказов в определенный каталог в формате XML или JSON, а внешний скрипт или стороннее ПО забирает эти файлы и отправляет их на сервер Достависта. Этот метод менее оперативен, но проще в отладке при отсутствии прямого доступа к интернету из контура 1С.

При настройке соединения важно правильно указать адрес шлюза и методы аутентификации. Обычно это делается в разделе настроек внешних подключений или через специализированную обработку интеграции.

СтруктураЗапроса = Новый Структура;

СтруктураЗапроса.Вставить("api_key","ВАШ_КЛЮЧ");

СтруктураЗапроса.Вставить("order_id", Документ.УникальныйИдентификатор);

// Формирование тела запроса для отправки

Нюансы работы с HTTPS сертификатами

Если ваш сервер 1С находится в закрытом контуре, убедитесь, что корневые сертификаты удостоверяющих центров установлены на сервере. Отсутствие доверенных сертификатов приведет к ошибке SSL/TLS при попытке соединения с API курьерской службы.

Создание и отправка заказа курьеру

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

В форму отправки должны попасть все существенные условия: габариты груза, вес, объявленная ценность и комментарии для курьера. Особое внимание уделите полю"Комментарий", так как именно эту информацию водитель увидит в мобильном приложении.

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

Этот номер необходимо сохранить в документе 1С для последующего отслеживания. Обычно для этого используется дополнительное реквизит или ссылка на внешний ресурс.

  • 🚚 Укажите точный вес и габариты посылки, чтобы избежать доплаты на месте.
  • 📝 Добавьте комментарий о необходимости звонка клиенту за 30 минут до прибытия.
  • 🕒 Выберите желаемый временной интервал доставки из доступных слотов.
  • 💰 Проверьте сумму к оплате, если курьер должен принять деньги от клиента.

☑️ Контрольный список перед отправкой

Выполнено: 0 / 1

Отслеживание статусов и обновление документов

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

Система должна периодически опрашивать сервер Достависта или принимать PUSH-уведомления об изменении состояния заказа. Статусы могут варьироваться от"Назначен курьер" до"Вручен" или"Возврат".

При получении статуса"Вручен" документ реализации в 1С может быть автоматически переведен в состояние"Закрыт", а задолженность клиента погашена. Это обеспечивает актуальность данных в оперативном учете.

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

Статус в 1С Статус в Достависта Действие системы
К оформлению Новый Ожидание отправки
В пути Курьер назначен Блокировка редактирования адреса
Доставлен Выполнен Закрытие документа реализации
Возврат Отменен / Возврат Создание задачи менеджеру
⚠️ Внимание: Интерфейсы и названия статусов в API сервисов доставки могут меняться без предварительного уведомления. Регулярно сверяйте справочник статусов в вашей конфигурации с актуальной документацией провайдера.
💡

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

Обработка возвратов и исключительных ситуаций

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

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

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

Логика обработки исключений должна быть прописана четко: кто принимает решение о повторной доставке, а кто оформляет возврат на склад. Автоматизация этого процесса снижает риск человеческой ошибки.

  • 🔄 Настройте автоматическое создание заказа на повторную доставку при статусе"Клиент просит перенести".
  • 📉 Учитывайте комиссию за неудачную попытку доставки при расчете себестоимости возврата.
  • 📞 Сохраняйте историю звонков и комментариев курьера в карточке заказа для анализа качества сервиса.
💡

Автоматическое создание документов возврата на основе статуса из API Достависта исключает риск потери товара и расхождения в складском учете.

Финансовый учет и сверка взаиморасчетов

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

Услуги Достависта обычно тарифицируются по факту успешной доставки или попытки. Данные о стоимости каждой поездки должны поступать в 1С для формирования акта оказанных услуг.

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

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

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

⚠️ Внимание: Комиссия за обработку наложенного платежа (Cash on Delivery) часто отличается от базового тарифа доставки. Убедитесь, что ваша система учитывает этот дополнительный процент при расчете итоговой суммы услуги.
Как учитывать НДС в услугах доставки

Если ваш контрагент работает с НДС, убедитесь, что в документах поступления услуг правильно указан процент налога. Ошибка в ставке НДС приведет к некорректному формированию книги покупок и проблемам при сдаче отчетности.

Часто задаваемые вопросы (FAQ)

Что делать, если заказ не отправляется в Достависта и выдает ошибку?

В первую очередь проверьте лог ошибок обмена. Чаще всего проблема кроется в неверном формате адреса (отсутствие индекса или дома) или истекшем сроке действия API-ключа. Также убедитесь, что у пользователя есть права на проведение внешних подключений.

Можно ли изменить адрес доставки после того, как заказ уже у курьера?

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

Как отражать комиссию сервиса в 1С?

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

Поддерживает ли интеграция работу с несколькими складами?

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

Нужно ли устанавливать дополнительное ПО на сервер 1С?

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