Инструкция: как подключить интеграцию Avito и СДЭК

Что нужно для подключения

• У вас должен быть договор интернет-магазина (ИМ) со СДЭК, чтобы заключить договор свяжитесь с нами в разделе контакты или заполните форму.
• Товары продаются через Avito, и вы используете доставку силами продавца.
• Настройка выполняется в личных кабинетах Avito и СДЭК.

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

1. Войдите в личный кабинет Avito.
2. Перейдите в раздел «Профиль и настройки» → «Интеграция и API».
3. Выберите подраздел «Собственная разработка» и нажмите «Получить ключи».
4. Вы получите два значения: Client_id и Client_secret. Скопируйте их — они понадобятся на следующем шаге.

Шаг 2. Добавьте магазин в личном кабинете СДЭК

1. Войдите в личный кабинет СДЭК.
2. Перейдите в раздел «Интеграция», выберите режим DBS и вкладку Avito.
3. Нажмите кнопку «Добавить магазин».
4. В открывшейся форме вставьте скопированные Client_id и Client_secret.
5. Подтвердите согласие на передачу данных и нажмите «Проверить Client_secret».

Шаг 3. Дождитесь проверки токена
Проверка может занять от нескольких минут до нескольких часов. Если прошло более 24 часов, а проверка не завершена — обратитесь в поддержку СДЭК (см. контакты в конце).
В случае ошибки проверьте правильность введённого ключа. Если ошибка повторяется:

• Удалите старый ключ в Avito и создайте новый (повторите Шаг 1).
• Введите новые данные в СДЭК и снова нажмите «Проверить Client_secret».
• Если проблема не решена, обратитесь в поддержку.

Шаг 4. Настройте магазин
Когда проверка токена пройдёт успешно, станет доступна форма настроек. Внимательно заполните все обязательные поля.
Основные данные

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

Секция «Тарифы»
Выберите услуги СДЭК, которые будут использоваться при создании накладных. Рекомендуется отмечать как можно больше вариантов, включая DBS и Экспресс — это уменьшит количество ошибок при подборе доставки. Дополнительно можно задать приоритет выбора:

• «Дешёвые, но медленные» — выбирается самая низкая стоимость.
• «Быстрые, но дорогие» — выбирается самый короткий срок доставки.

Дополнительный сбор
Услуга объявленной стоимости обязательна для интернет-магазинов и не отключается. Стоимость товара автоматически подтягивается из карточки Avito.
Секция «Товары»
Обязательна к заполнению! Так как в объявлениях Avito не передаются размеры товара, здесь нужно указать габариты и вес по умолчанию (длина, ширина, высота, вес). Эти значения будут использоваться для расчёта стоимости доставки, если реальные габариты товара неизвестны. Укажите наиболее типичные для ваших товаров параметры.
Уведомления
Сейчас работает только рассылка об ошибках на почту. При желании можно указать e-mail для получения таких писем.
После заполнения всех секций нажмите «Сохранить». Настройки применятся в течение 5 минут.
Шаг 5. Настройте склад и данные отправителя
Даже если Avito не управляет вашими складами, в СДЭК нужно указать один склад — его данные попадут в накладную.

1. В разделе настроек интеграции перейдите в блок настройки склада.
2. Включите переключатель «Включить синхронизацию».
3. Укажите город, в котором находится склад.
4. Заполните обязательные поля в секции «Данные в накладной»: ФИО, телефон и e-mail отправителя. Эта информация будет печататься в накладной.
5. Нажмите «Сохранить».

Шаг 6. Настройте доставку в Avito
В личном кабинете Avito для выбранных товаров или профиля пропишите способ доставки:

• Тип доставки: «Силами продавца».
• В пункте выдачи выберите «Пункты выдачи СДЭК» (ПВЗ). Курьерская доставка через эту интеграцию пока недоступна.

Шаг 7. Активируйте магазин
После заполнения всех настроек магазина и склада нажмите кнопку «Активировать» в личном кабинете СДЭК.
Важно! С момента активации должно пройти не менее 30 минут, прежде чем вы начнёте обрабатывать заказы. Это техническая особенность API Avito. Если начать работу с заказами раньше, накладные по ним могут не создаться.
Шаг 8. Работа с заказами

1. Новые заказы из Avito проверяются каждые 15 минут. При поступлении заказа система автоматически создаёт накладную СДЭК (при наличии всех данных).
2. Созданная накладная появится в вашем личном кабинете СДЭК. Её можно распечатать и передать отправление в доставку.
3. После передачи груза статус заказа в Avito сменится на «Доставляется», а трек-номер отправится покупателю.
4. При вручении в ПВЗ менеджер попросит у получателя код СДЭК или документ. После вручения заказ получит статус «Доставлен» (или «Отменён» при отказе).

Что можно редактировать в накладной
Вы можете изменить большинство полей накладной в ЛК СДЭК, кроме поля «№ отправления ИМ». Если добавляете товары в грузовые места, помните, что новые позиции не будут связаны с заказами Avito. При перераспределении товаров по упаковкам сохраняйте артикулы и количество, иначе автоматизация может нарушиться.
Важные предупреждения

• Не удаляйте интеграцию и не отзывайте токен, если есть активные накладные. Это приведёт к удалению всех связанных данных, а отправления в пути будут возвращены вам за полную стоимость доставки.
• Габариты по умолчанию в секции «Товары» — критично для расчёта стоимости. Если они не заполнены, накладные могут создаваться с ошибками или не создаваться вовсе.
• Дополнительный сбор за объявленную стоимость включён всегда. Итоговая цена доставки будет включать этот сбор автоматически.