К статье
Практический материал

Автоматизация · 9 мин

Как провести Достависта в 1С: пошаговая настройка интеграции

Как провести интеграцию Достависта в 1С: подключение по API, настройка обмена заказами, типовые ошибки, проверка результата и ответы на частые вопросы.

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

Перед началом работ важно понять, какая у вас конфигурация 1С (Управление торговлей, УНФ, Комплексная автоматизация, ERP или самописная), есть ли у вас доступ к API Достависта и кто будет выполнять настройку — штатный специалист или сторонний разработчик. От этого зависит выбор способа подключения и объём работ.

Определите, какая задача стоит: интеграция или учёт расходов

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

Маршрут решения

Как выбрать действие

Нужно, чтобы заказы из 1С сами уходили курьерам ДоставистаНастраивайте API-интеграцию: получайте токен и ставьте модуль обмена или заказывайте доработку
Нужно только отразить оплату услуг доставки в учётеДостаточно документа «Поступление услуг» с контрагентом Достависта — интеграция не требуется
Заказов немного (до нескольких в день)Рассмотрите ручное создание доставок в личном кабинете Достависта — это дешевле разработки

Если заказов мало, полноценная интеграция может не окупиться: разработка и сопровождение обмена стоят денег, а ручное создание заявки в личном кабинете занимает пару минут. Интеграция оправдана при стабильном потоке заказов, когда ручной ввод становится источником ошибок и потерь времени.

Подготовьте доступы и проверьте конфигурацию 1С

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

Со стороны 1С проверьте три вещи. Во-первых, версию платформы и конфигурации: готовые модули обмена обычно рассчитаны на конкретные типовые конфигурации определённых релизов. Во-вторых, возможность доработки: если конфигурация на поддержке без возможности изменения, встраивать модуль придётся через расширение. В-третьих, сетевой доступ: сервер 1С должен иметь возможность выполнять исходящие HTTPS-запросы к API Достависта.

Способы подключения: готовый модуль, доработка или посредник

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

Сравнение вариантов

Готовый модуль

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

Собственная доработка

Полный контроль над логикой обмена, но требует программиста 1С и сопровождения при изменениях API

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

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

Выбор зависит от масштаба: для типовой УТ или УНФ с типовыми процессами обычно хватает готового решения, для нестандартных схем (несколько складов отправления, расчёт стоимости до оформления заказа, частичная доставка) чаще нужна доработка.

Настройте обмен заказами и статусами

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

Порядок действий
  1. 1
    Получите в личном кабинете Достависта токен API и документацию, уточните адреса тестовой и рабочей среды
  2. 2
    Установите модуль обмена или внедрите доработку на копии базы
  3. 3
    Введите токен и параметры подключения в настройках интеграции
  4. 4
    Настройте соответствие полей: какие данные заказа 1С куда передаются в заявку Достависта
  5. 5
    Настройте карту статусов: как статусы доставки отражаются в состояниях заказа в 1С
  6. 6
    Создайте тестовый заказ и проверьте полный цикл: создание, назначение курьера, завершение, получение стоимости
  7. 7
    Переведите обмен в рабочий режим и проконтролируйте первые реальные заказы

Особое внимание уделите карте статусов. Статусная модель Достависта не совпадает один в один со статусами заказа в 1С, поэтому нужно явно определить, что делать с заказом при каждом событии: курьер назначен, заказ забран, доставлен, отменён. Ошибки в этом месте приводят к тому, что менеджеры видят в 1С устаревшую информацию.

Как отразить расходы на Достависта в учёте

Если задача — бухгалтерская, а не интеграционная, всё проще. Создайте контрагента «Достависта» в справочнике контрагентов, затем расходы на доставку отражайте документом «Поступление услуг» (в УТ, ERP, КА) или «Поступление товаров и услуг» с видом «Услуги» (в Бухгалтерии предприятия). Основание — счёт и акт от сервиса, которые формируются по итогам периода.

Если стоимость доставки включается в себестоимость товаров, используйте механизм дополнительных расходов: в УТ и ERP для этого предусмотрен документ «Приобретение услуг и прочих активов» с распределением на товары. Если доставка оплачивается покупателем и выступает отдельной услугой, отражайте её отдельной строкой в реализации. Конкретную схему учёта согласуйте с бухгалтером — она зависит от вашей учётной политики и договора с сервисом.

Проверка результата и типичные ошибки

После запуска интеграции пройдите контрольные точки: заказ создаётся в Достависта с корректным адресом и телефоном, стоимость из API совпадает с ожидаемой, статусы возвращаются в 1С в разумное время, отмена заказа в одной системе корректно обрабатывается в другой. Проверяйте не только «счастливый путь», но и ошибочные ситуации: недостаточно средств на балансе, неверный адрес, отмена после назначения курьера.

Контрольные точки

Как проверить результат

Создание заказа
Норма

Заявка появляется в Достависта с верным адресом, телефоном и весом

Тревожный признак

Заявка не создаётся или уходит с пустыми полями

Статусы
Норма

Статус в 1С меняется вслед за изменениями в Достависта

Тревожный признак

Заказ в 1С «зависает» в одном статусе

Стоимость
Норма

Стоимость из API совпадает со списанием с баланса

Тревожный признак

Суммы расходятся или не приходят вовсе

Ошибки
Норма

Ошибки API логируются и видны ответственному

Тревожный признак

Сбои обмена проходят незамеченными

Типичные ошибки
01
Настройка обмена сразу в рабочей базе без теста — первые реальные заказы уходят с ошибками в адресах и телефонах
02
Отсутствие обработки ошибок API — при недоступности сервиса заказы молча не отправляются, и об этом узнают от клиентов
03
Неправильное соответствие статусов — в 1С заказ выглядит доставленным, хотя курьер его ещё не забрал
04
Игнорирование изменений API — обмен ломается после обновления на стороне сервиса, и никто не отвечает за сопровождение
05
Смешение учёта: расходы на доставку проводятся без привязки к заказам, и себестоимость доставки по клиентам посчитать невозможно

Отдельно назначьте ответственного за мониторинг обмена: журнал ошибок интеграции кто-то должен смотреть регулярно, особенно в первые недели после запуска. Большинство проблем выявляется именно в этот период.

Частые вопросы

Можно ли подключить Достависта к 1С без программиста?

Да, если для вашей конфигурации существует готовый модуль интеграции с мастером настройки — тогда достаточно ввести токен и задать соответствия полей. Если готового решения нет или процессы нестандартные, без разработчика не обойтись: обмен по API требует программной доработки.

Что делать, если моя конфигурация 1С сильно доработана?

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

Как отражать в учёте предоплату Достависта?

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

Что будет, если API Достависта временно недоступен?

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

Оправдана ли интеграция при небольшом числе доставок?

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

Итог

Что важно запомнить

Сначала определите задачу: автоматический обмен заказами или только учёт расходов. Для обмена получите токен API, выберите готовый модуль или доработку, настройте соответствие полей и статусов и протестируйте полный цикл на копии базы. Расходы отражайте через поступление услуг с зачётом аванса. Назначьте ответственного за мониторинг ошибок обмена.