Модуль доставки CDEK в Odoo

Этот модуль добавляет полноценную интеграцию со службой доставки CDEK.

С его помощью пользователи могут отправлять посылки через CDEK напрямую из Odoo с полной поддержкой API. Модуль автоматически рассчитывает стоимость доставки на основе размеров и веса посылки, поддерживает различные типы доставки и позволяет создавать, отслеживать и отменять отправления прямо из системы.

Согласно стандарта OCA, описание модуля находится в самом модуле, достаточно перейти:
Apps -> CDEK Delivery -> Module Info

 ⚠️ Модуль разработан для Odoo 16.0
Если вам нужна поддержка более новых версий — вы можете связаться с командой XXP или принять участие в разработке и миграции модуля.

  Возможности

• Полная интеграция через API — интеграция со службой доставки CDEK через API
• Автоматический расчет стоимости — стоимость доставки рассчитывается по размерам и весу посылки
• Различные типы доставки
  • дверь-дверь
  • дверь-офис
  • офис-офис
  • терминал
  • постамат
• Жизненный цикл отправления
  • создание отправления
  • отслеживание
  • отмена отправления прямо из Odoo
• Тарифы CDEK
  • поддержка тарифов CDEK
  • e-commerce и стандартная доставка
• Настройки доставки для партнеров
  • выбор типа доставки
  • коды пунктов выдачи
• Дополнительные сервисы CDEK
  • страховка
  • упаковка
  • уведомления
  • и другие услуги при оформлении заказа
• Онлайн-отслеживание
  • отслеживание через систему трекинга CDEK
• Транспортные накладные
  • автоматическая генерация транспортных документов

Если вам необходимы дополнительные функции — свяжитесь с командой XXP или примите участие в разработке модуля.

  Содержание

1. Установка
2. 1. Предварительные требования
3. 1. Установка Python-библиотеки CDEK
4. Настройка 
5. 1. Получение API-ключей CDEK
   2. Настройка перевозчика CDEK
   3. Настройка партнера для доставки CDEK
   4. Настройка упаковки (опционально)
   5. Настройка товара
6. Управление сервисами CDEK
7. Использование
8. Процесс продажи с доставкой CDEK

  Установка

Модуль можно скачать из нашего репозитория на Github

Предварительные требования

Модуль зависит от следующих модулей Odoo:

• delivery (базовый модуль доставки)

Установка Python-библиотеки CDEK

Для работы модуля необходимо установить библиотеку CDEK.

Установка выполняется командой:

pip install cdek

Подробнее о библиотеке можно прочитать здесь:

https://pypi.org/project/cdek/

 Настройка

Получение API-ключей CDEK

1. Зарегистрируйтесь в личном кабинете CDEK
   https://www.cdek.ru/
2. Получите API-учетные данные:
   • Client ID
   • Client Secret
3. Сохраните их — они понадобятся для настройки интеграции.

Настройка перевозчика CDEK

Шаг 1: Переход в настройки доставки

Перейдите:

Inventory → Configuration → Shipping Methods

Найдите перевозчика CDEK Delivery

Шаг 2: Базовая настройка

Откройте форму перевозчика CDEK и проверьте:

• поле Provider установлено в CDEK
• поле Delivery Product установлено в CDEK Delivery

Шаг 3: Настройка CDEK

Перейдите во вкладку CDEK Configuration и заполните параметры.

Ключи API Credentials (Production)

⚠️ Важно:

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

1. Активируйте Production Environment
   с помощью кнопки в правом верхнем углу формы перевозчика
2. Укажите:

• CDEK Client ID — идентификатор клиента
• CDEK Client Secret — секретный ключ

Загрузка тарифов

⚠️ Важно:

Рекомендуется уточнить подходящие тарифы у вашего менеджера CDEK.

1. Нажмите кнопку Load Tariffs рядом с полем Available Tariffs
2. Модуль загрузит все доступные тарифы через API CDEK
3. Выберите нужные тарифы в списке Available Tariffs

Шаг 4: Дополнительные параметры

Type

• E-Commerce (1) — для интернет-магазинов
• Delivery (2) — для стандартной доставки

Print Type

⚠️ Важно:

Эта функция будет доступна в PRO-версии.

Используется для печати документов при обработке заказов.

Типы печати:

• Waybill — печать транспортной накладной
• Barcode — печать штрихкода

Default Delivery Type

Тип доставки по умолчанию:

• Door — отправка со склада/офиса
• Office — отправка из пункта CDEK
• Terminal — отправка из терминала CDEK

Шаг 5: Настройка склада или адреса отправителя

⚠️ Важно:

Заполните все поля указанные в п. "Настройка партнера CDEK" для партера указанного для вашего склада.

Перейдите:

Inventory → Configuration → Warehouses

Выберите склад и откройте связанный адрес партнера.

Настройка партнера для CDEK

Откройте карточку партнера.

Перейдите:

Sales & Purchases → CDEK

Укажите Delivery Type.

Если Delivery Type = Door

Заполните контактные данные:

• City — город
• Street — улица и адрес
• Country — страна
• Zip (optional) — почтовый индекс
• Phone — телефон

Если Delivery Type = Office / Postbox

1. Нажмите Search Office
2. В мастере:

• заполните поля поиска
• нажмите Load / Reload
• выберите пункт Select

Выберите Тариф (Tariff) доставки.

Тип контрагента определяется автоматически:

• Legal Entity — юридическое лицо
• Individual — физическое лицо

  

Настройка упаковки (опционально)

⚠️  Примечание:

Данная настройка является опциональной. При получении тарифа, Odoo предложит вам выбрать запись упаковки, либо создать новую на Wizard. 

Включите упаковки:

Settings → Inventory → Operations → Packages

Настройка упаковок:

Inventory → Configuration → Package Types

1. Выберите существующую запись или создайте новую
2. Укажите:
   • размеры коробки
   • минимальный и максимальный вес
3. Укажите перевозчика (опционально)

Настройка товара (опционально)

⚠️  Примечание:

Данная настройка является опциональной для коррекного расчета стомиости доставки. 

Перейдите:

Sales → Products → Product → Inventory

Установите вес и объем товара.

  Управление сервисами CDEK

⚠️ Примечание:

Большинство сервисов уже преднастроены. Настройка требуется только если CDEK обновил список услуг.

Перейдите:

Products → Products

(не забудьте очистить фильтры)

1. Создайте новый продукт или откройте существующий
2. Установите Product Type = Service
3. Выберите CDEK Reference

При выборе сервиса:

• продукт автоматически становится сервисом
• отключаются продажи и закупки
• код сервиса CDEK записывается в поле Internal Reference

 

  Использование

Процесс продажи с доставкой CDEK

⚠️  Важно:

Убедитесь, что партнер настроен для доставки CDEK.

Создание заказа продажи

1. Перейдите в приложение Sales
2. Нажмите + New
3. Выберите Customer
4. Добавьте товар
5. Нажмите Add Shipping

Получение стоимости доставки

В мастере Add a shipping method:

1. Выберите CDEK Delivery в поле Shipping method
2. Укажите Package Type
3. Добавьте дополнительные сервисы CDEK (опционально)

Значения сервисов:

• Packages — количество (>0)
• Insurance — сумма страховки
• SMS — телефон в формате +7XXXXXXXXXX
• Packaging materials — длина упаковки в метрах

  ​4. Нажмите Get Rate. Стоимость доставки будет рассчитана автоматически.
  5. Нажмите Add, чтобы добавить доставку в заказ.

Расчет стоимости доставки

При расчете учитываются:

• выбранный тариф CDEK
• размеры и вес упаковки
• дополнительные сервисы
• тип доставки (door / office / terminal / postbox)

После подтверждения заказа Odoo создаст операцию доставки.

Регистрация отправления

1. Перейдите в созданную операцию Picking
2. Выполните Validate

Odoo зарегистрирует отправление в системе CDEK.

Перейдите во вкладку Additional Info и проверьте:

• CDEK Order UUID
• Tracking Reference

Отмена отправления

1. Перейдите:

Inventory → Your Delivery Operations

1. Откройте нужную операцию Picking
2. Перейдите во вкладку Additional Info
3. Нажмите Cancel.

 Итого

Спасибо что дочитали/долистали до конца. Протестировать модуль можно на runbot XXP.

У нас готовится к релизу виджет для заполенения адреса партнера на основе виджета CDEK. А также интеграция со службой доставки Yandex. На самом деле, все это уже работает на продкашн.базе у  нашего клиента и требует небольшой доработки для open-source.

Скоро порадуем Odoo коммьюнити новыми релизами. Stay tuned!