Инструкция по настройке интеграции между магазином на Avito и СДЭК по DBS

СДЭК добавил новую возможность — теперь продавцы на Avito могут подключить прямую интеграцию по модели DBS. Это помогает упростить оформление доставки и быстрее передавать заказы в работу.

В этой инструкции покажем, как настроить интеграцию между Avito и СДЭК. Следуя пошаговым рекомендациям, вы сможете подключить сервис в личном кабинете и начать автоматически создавать накладные для заказов с Avito.

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

Обратите внимание, для генерации ключей и корректной работы интеграции в Avito необходимо настроить тариф.

Основные особенности интеграции:

• Автоматическое создание накладных СДЭК для заказов на Avito без необходимости ручного переноса данных
• Передача трек-номера СДЭК в Avito

Принцип работы интеграции

После подключения интеграции система каждые 15 минут проверяет наличие новых заказов на Avito.

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

Установка и настройка

Для работы интеграции не нужно устанавливать дополнительное ПО — вся настройка выполняется через личный кабинет СДЭК.

Перейдите в раздел настроек интеграции, выберите режим DBS и вкладку Avito. После этого нажмите кнопку «Добавить магазин».

После этого нужно сгенерировать токен Avito и добавить его в настройки интеграции. 

Генерация токена Avito

Чтобы создать токен, в личном кабинете Avito перейдите в раздел «Профиль и настройки», затем откройте вкладку «Интеграция и API».

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

После того как кнопка «Получить ключи» будет нажата появится пара сгенерированных Client_id и Client_secret.

Необходимо скопировать сгенерированные Client_secret и Client ID и вставить их в настройки интеграции.

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

Сколько занимает проверка токена?

Проверка токена может занять от нескольких минут до нескольких часов — это зависит от нагрузки на сервис интеграции.

Если статус проверки не изменился в течение 24 часов, обратитесь в техническую поддержку СДЭК.

Ошибка проверки токена и обновить токен

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

Для этого:

• зайдите в личный кабинет Avito;
• удалите текущий ключ;
• создайте новые Client_id и Client_secret;
• перейдите в личный кабинет юридического лица СДЭК;
• вставьте новые Client_id и Client_secret в настройки интеграции;
• нажмите кнопку «Проверить Client_secret»;
• после проверки ключа появится магазин со статусом “Отключен”;
• нажмите кнопку Активировать”.

Если проблема не решается, обратитесь в техническую поддержку СДЭК

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

Настройка интеграции

Настройка интеграции доступна после передачи токена доступа Avito в личном кабинете СДЭК. 

Важно! Если удалить интеграцию, отозвать токен доступа в личном кабинете Avito или заменить токен в личном кабинете СДЭК на некорректный, все данные по интеграции будут удалены. Это касается и уже созданных накладных.

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

Данные о магазине

Основные настройки задаются в разделе настроек магазина.

Секция данных о магазине

Данные из поля названия будут использоваться в качестве продавца в накладной.

По умолчанию интеграция автоматически переводит новые заказы в статус «Заказ подтвержден».

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

Секция тарифов

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

Важно: рекомендуем выбрать максимальное количество тарифов, включая DBS и «Экспресс». Это поможет снизить количество заказов, по которым накладная не сможет быть создана автоматически.

Нельзя отключить Дополнительный сбор за объявленную стоимость

Эта услуга является обязательной для интернет-магазинов, поэтому отключить ее нельзя.

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

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

Секция товаров

Обратите внимание: этот раздел обязателен для заполнения.

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

Секция уведомлений

Обратите внимание: этот раздел заполнять необязательно.

Здесь можно настроить уведомления по интеграции:

• об ошибках — сообщение будет приходить каждый раз, когда при создании накладной возникла ошибка;
• о заказах — система будет отправлять список обработанных заказов и созданных по ним накладных;
• о новостях — уведомления будут приходить при появлении новых функций или изменениях в работе интеграции.

Сейчас работает только отправка уведомлений об ошибках на электронную почту.

Примечание: после нажатия кнопки «Сохранить» новые настройки магазина применятся в течение 5 минут.

Настройка способов доставки в ЛК Avito

Способы доставки настраиваются в личном кабинете Avito. В настройках способа доставки выберите вариант «Силами продавца».

Далее выберите вариант «Пункт выдачи». Обратите внимание: сейчас интеграция поддерживает доставку только в ПВЗ СДЭК.

Данные о складе

Хотя в Avito нет отдельной настройки складов, склад нужно добавить в личном кабинете юридического лица СДЭК — данные из этой настройки используются при создании накладных.

Название склада интеграция создает автоматически.

Основная секция

В этом разделе можно:

• включить или отключить интеграцию склада;
• указать город, в котором находится склад.

Чтобы склад начал работать в интеграции, включите переключатель «Включить синхронизацию».

Примечание: сейчас вызвать курьера на склад через эту интеграцию нельзя.

Обратите внимание: если склад не активирован в личном кабинете СДЭК, заказы из Avito загружаться не будут.

Секция данных в накладной

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

Обязательно заполните поля:

• ФИО;
• телефон;
• email.

Примечание: после нажатия кнопки «Сохранить» настройки склада применятся в течение 5 минут.

Активация магазина

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

Важно: кнопка активации станет доступна только после полной настройки магазина и склада.

Обратите внимание: после активации магазина должно пройти не менее 30 минут, прежде чем интеграция начнет работать корректно. Это связано с особенностями API Avito.

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

Деактивация магазина

Чтобы отключить интеграцию магазина, нажмите кнопку «Деактивировать».

Магазин деактивируется в течение 5 минут.

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

Работа с накладными

Как формируются габариты грузового места

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

Вес грузового места считается как сумма веса всех товаров, которые входят в это грузовое место.

Габариты рассчитываются автоматически:

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

Пример расчета

В грузовом месте два товара:

• первый товар: 120 × 18 × 6 см, вес 2 кг, количество — 1 шт.;
• второй товар: 120 × 1 × 6 см, вес 0,5 кг, количество — 2 шт.;
• коэффициент упаковки — 5%.

Расчет веса:

2 + 0,5 × 2 = 3 кг

Расчет объема:

• первый товар: 120 × 18 × 6 = 12 960 см³;
• второй товар: 120 × 1 × 6 = 720 см³;
• итоговый объем: 12 960 + 720 × 2 = 14 310 см³;
• объем с учетом упаковки: 14 310 × 1,05 = 15 025,5 см³.

Длина грузового места — 120 см.
Ширина — 6 см.
Высота: 15 025,5 / (120 × 6) = 20,84 см, округляется до 21 см.

Итоговые параметры грузового места: 120 × 6 × 21 см, вес 3 кг.

Созданная накладная отобразиться в Личном кабинете СДЭК и будет доступна для редактирования.

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

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

При создании накладной интеграция выбирает один из тарифов, указанных в настройках.

Как это работает:

• система рассчитывает стоимость и сроки доставки по всем выбранным тарифам;
• если ни один тариф недоступен, накладная не создается, а на почту отправляется уведомление;
• если доступен только один тариф, накладная создается по нему;
• если доступно несколько тарифов, система выбирает подходящий вариант по заданной настройке.

Если выбрано «Дешёвые, но медленные», будет использован тариф с наименьшей стоимостью.

Если выбрано «Быстрые, но дорогие», будет выбран тариф с самым коротким сроком доставки.

Редактирование накладной

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

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

Важно: если вы меняете распределение товаров по упаковкам — создаете новую упаковку или объединяете несколько в одну, — обязательно сохраняйте артикулы и количество товаров. Иначе автоматизация по этому заказу может работать некорректно.

Примечание: если добавить в грузовые места новые товары вручную, они не будут связаны с заказами Avito и не будут участвовать в интеграции.

После передачи груза в СДЭК статус связанных сборочных заданий в Avito автоматически изменится на «Доставляются».

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

Вручение накладной

При выдаче заказа сотрудник ПВЗ может попросить покупателя подтвердить получение через CDEK ID или показать документ.

После этого информация о результате доставки передается в Avito. Если заказ вручен, он перейдет в статус «Доставлен». Если вручение не состоялось — в статус «Отменен».