Автоматизация · 9 мин
Как провести Достависта в 1С: пошаговая настройка интеграции
Как провести интеграцию Достависта в 1С: подключение по API, настройка обмена заказами, типовые ошибки, проверка результата и ответы на частые вопросы.
Достависта — сервис срочной курьерской доставки, который компании подключают к учётным системам, чтобы заказы из 1С автоматически уходили курьерам без ручного копирования адресов и телефонов. «Провести Достависта в 1С» обычно означает одну из трёх задач: настроить интеграцию по API, установить готовый модуль обмена или корректно отражать расходы на доставку в учёте. Ниже разобраны все три сценария.
Перед началом работ важно понять, какая у вас конфигурация 1С (Управление торговлей, УНФ, Комплексная автоматизация, ERP или самописная), есть ли у вас доступ к API Достависта и кто будет выполнять настройку — штатный специалист или сторонний разработчик. От этого зависит выбор способа подключения и объём работ.
Определите, какая задача стоит: интеграция или учёт расходов
Под фразой «провести Достависта в 1С» скрываются разные сценарии, и от правильной постановки задачи зависит весь дальнейший план работ. Чаще всего речь идёт об автоматической передаче заказов на доставку из 1С в Достависта и обратном получении статусов. Реже — о бухгалтерском отражении счетов сервиса.
Как выбрать действие
Если заказов мало, полноценная интеграция может не окупиться: разработка и сопровождение обмена стоят денег, а ручное создание заявки в личном кабинете занимает пару минут. Интеграция оправдана при стабильном потоке заказов, когда ручной ввод становится источником ошибок и потерь времени.
Подготовьте доступы и проверьте конфигурацию 1С
Для интеграции по API вам понадобится токен доступа, который выдаётся в личном кабинете Достависта при подключении API. Уточните у сервиса актуальные условия доступа к API и адреса тестовой и рабочей сред — эти параметры могут меняться, и брать их нужно из официальной документации сервиса, а не из старых инструкций.
Со стороны 1С проверьте три вещи. Во-первых, версию платформы и конфигурации: готовые модули обмена обычно рассчитаны на конкретные типовые конфигурации определённых релизов. Во-вторых, возможность доработки: если конфигурация на поддержке без возможности изменения, встраивать модуль придётся через расширение. В-третьих, сетевой доступ: сервер 1С должен иметь возможность выполнять исходящие HTTPS-запросы к API Достависта.
Способы подключения: готовый модуль, доработка или посредник
Существует три практических пути. Первый — готовый модуль интеграции, если он доступен для вашей конфигурации: его устанавливают как внешнюю обработку или расширение, вводят токен и настраивают соответствия. Второй — собственная доработка силами программиста 1С: обмен реализуется через HTTP-запросы к API по документации сервиса. Третий — связка через промежуточные сервисы-агрегаторы доставки, если вы уже работаете с одним из них.
Сравнение вариантов
Быстрый старт и меньше затрат, но функциональность ограничена возможностями модуля и привязкой к конкретным релизам конфигурации
Полный контроль над логикой обмена, но требует программиста 1С и сопровождения при изменениях API
Удобно при работе с несколькими службами доставки сразу, но добавляет посредника и его тарифы
Выбор зависит от масштаба: для типовой УТ или УНФ с типовыми процессами обычно хватает готового решения, для нестандартных схем (несколько складов отправления, расчёт стоимости до оформления заказа, частичная доставка) чаще нужна доработка.
Настройте обмен заказами и статусами
Ядро интеграции — передача заказа из 1С в Достависта и получение обратно статусов и стоимости. Минимальный набор данных, который уходит в сервис: адрес отправления, адрес получателя, контактные телефоны, вес и габариты отправления, сумма объявленной ценности, комментарий для курьера и желаемое время доставки. В ответ 1С должна получить номер заказа в Достависта, стоимость и далее — изменения статуса.
- 1Получите в личном кабинете Достависта токен API и документацию, уточните адреса тестовой и рабочей среды
- 2Установите модуль обмена или внедрите доработку на копии базы
- 3Введите токен и параметры подключения в настройках интеграции
- 4Настройте соответствие полей: какие данные заказа 1С куда передаются в заявку Достависта
- 5Настройте карту статусов: как статусы доставки отражаются в состояниях заказа в 1С
- 6Создайте тестовый заказ и проверьте полный цикл: создание, назначение курьера, завершение, получение стоимости
- 7Переведите обмен в рабочий режим и проконтролируйте первые реальные заказы
Особое внимание уделите карте статусов. Статусная модель Достависта не совпадает один в один со статусами заказа в 1С, поэтому нужно явно определить, что делать с заказом при каждом событии: курьер назначен, заказ забран, доставлен, отменён. Ошибки в этом месте приводят к тому, что менеджеры видят в 1С устаревшую информацию.
Как отразить расходы на Достависта в учёте
Если задача — бухгалтерская, а не интеграционная, всё проще. Создайте контрагента «Достависта» в справочнике контрагентов, затем расходы на доставку отражайте документом «Поступление услуг» (в УТ, ERP, КА) или «Поступление товаров и услуг» с видом «Услуги» (в Бухгалтерии предприятия). Основание — счёт и акт от сервиса, которые формируются по итогам периода.
Если стоимость доставки включается в себестоимость товаров, используйте механизм дополнительных расходов: в УТ и ERP для этого предусмотрен документ «Приобретение услуг и прочих активов» с распределением на товары. Если доставка оплачивается покупателем и выступает отдельной услугой, отражайте её отдельной строкой в реализации. Конкретную схему учёта согласуйте с бухгалтером — она зависит от вашей учётной политики и договора с сервисом.
Проверка результата и типичные ошибки
После запуска интеграции пройдите контрольные точки: заказ создаётся в Достависта с корректным адресом и телефоном, стоимость из API совпадает с ожидаемой, статусы возвращаются в 1С в разумное время, отмена заказа в одной системе корректно обрабатывается в другой. Проверяйте не только «счастливый путь», но и ошибочные ситуации: недостаточно средств на балансе, неверный адрес, отмена после назначения курьера.
Как проверить результат
Заявка появляется в Достависта с верным адресом, телефоном и весом
Заявка не создаётся или уходит с пустыми полями
Статус в 1С меняется вслед за изменениями в Достависта
Заказ в 1С «зависает» в одном статусе
Стоимость из API совпадает со списанием с баланса
Суммы расходятся или не приходят вовсе
Ошибки API логируются и видны ответственному
Сбои обмена проходят незамеченными
Отдельно назначьте ответственного за мониторинг обмена: журнал ошибок интеграции кто-то должен смотреть регулярно, особенно в первые недели после запуска. Большинство проблем выявляется именно в этот период.
Частые вопросы
Можно ли подключить Достависта к 1С без программиста?
Да, если для вашей конфигурации существует готовый модуль интеграции с мастером настройки — тогда достаточно ввести токен и задать соответствия полей. Если готового решения нет или процессы нестандартные, без разработчика не обойтись: обмен по API требует программной доработки.
Что делать, если моя конфигурация 1С сильно доработана?
Готовые модули рассчитаны на типовые конфигурации и в изменённой базе могут работать некорректно. В этом случае безопаснее ставить модуль как расширение конфигурации или заказывать индивидуальную доработку с учётом ваших изменённых объектов. Обязательно тестируйте на копии базы.
Как отражать в учёте предоплату Достависта?
Пополнение баланса сервиса — это выданный аванс, который отражается на счетах расчётов с поставщиками. По мере оказания услуг и получения актов аванс зачитывается. Точные счета и проводки зависят от вашей учётной политики, согласуйте их с бухгалтером.
Что будет, если API Достависта временно недоступен?
При грамотной настройке заказы должны ставиться в очередь на отправку и уходить после восстановления связи, а ошибки — записываться в журнал. Если обработки ошибок нет, заказы просто не отправятся, поэтому требование логирования и повторных попыток нужно включать в техническое задание на интеграцию.
Оправдана ли интеграция при небольшом числе доставок?
Если доставок несколько в день, ручное создание заявок в личном кабинете Достависта обычно дешевле и надёжнее, чем разработка и сопровождение обмена. Интеграция окупается, когда ручной ввод занимает заметное время у менеджеров или порождает ошибки в адресах и телефонах.
Что важно запомнить
Сначала определите задачу: автоматический обмен заказами или только учёт расходов. Для обмена получите токен API, выберите готовый модуль или доработку, настройте соответствие полей и статусов и протестируйте полный цикл на копии базы. Расходы отражайте через поступление услуг с зачётом аванса. Назначьте ответственного за мониторинг ошибок обмена.