CDEKIntegrate

Отправка заказов в личный кабинет CDEK
Автор дополнения
Артур Шевченко
Пакетов
13
Закачек
3 297
Обычно отвечает в течение суток
Автор дополнения
Пакетов
13
Закачек
3 297
Обычно отвечает в течение суток
Версия 2.0.4-pl
Дата выпуска 16.06.2026
Загрузки 113
Просмотры 3 013
Компонент для отправки заказов в СДЭК.
ВНИМАНИЕ!!! Системные требования и инструкции по настройке на MODX 3 смотрите в документации.
Документация актуальна для вервии 3.0.0-beta и выше
ВНИМАНИЕ!!! С версии < 2.0.0 НЕЛЬЗЯ. Удалите пакет полностью и установите новую версию.

Требования:
  • Версия PHP >=7.4
  • Версия modx >=2.6 && < 3.0
  • Версия miniShop2 >=3.0.7

Зависимости:
  • ms_CDEK2 >= 2.8.2

Возможности:
  • Отправка заказов в СДЭК
  • Скачивание накладных


Быстрый старт

После установки компонента в зависимости от того как вы отправляете заказы нужно заполнить системную настройку
* `cdekintegrate_shipment_point` — если отвозите заказы на ПВЗ (код имеет формат MSK2279 и узнать его можно на сайте widget.cdek.ru/)
* `cdekintegrate_from_location` — если вызываете курьера. Адрес должен быть в формате Регион, Город, Улица, Дом.

Время отправки заказа из админки может достигать 30 секунд, не стоит паниковать и думать, что админка зависла.

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

Если требуется автоматическое удаление заказов в СДЭК при отмене на сайте
(будет работать только для новых заказов не попавших в обработку СДЭК),
то в системной настройке `cdekintegrate_cancel_status` укажите ID статуса отменённого заказа.

Для автоматического создания и автоматической отмены заказов добавьте в планировщик заданий сервера следующую команду
*/5 * * * * {path/to/php} {path/to/site-root}core/components/cdekintegrate/cron/run.php
{path/to/php} — путь к php на вашем хостинге
{path/to/site-root} — полный путь до корня вашего сайта

При необходимости можете изменить папку для сохранения накладных `cdekintegrate_invoice_path`.

Если на вашем сайте доступна оплата наличными и необходимо, чтобы покупатель оплачивал заказ при получении,
то в системной настройке `cdekintegrate_cash_payment_ids` через запятую укажите ID способов оплаты наличными.
А так же в системной настройке `ms_cdek2_nds_percent` укажите размер НДС, если есть.

2.0.4-pl

  • Логирование переведено на mxLogger (единственный приёмник). Класс Helpers\Logger больше не пишет в файлы (services/custom/logs/*) — делегирует записи сервису mxLogger, а если он не установлен, один раз предупреждает в журнале MODX и молчит.
  • Новые гейты: cdekintegrate_debug (вкл/выкл, включено из коробки) + новая настройка cdekintegrate_log_level (минимальный уровень debug|info|warning|error, по умолчанию error). Консистентно с mxlogger.min_level. Раньше cdekintegrate_debug по умолчанию был выключен.
  • Тэги: базовые cdekintegrate + delivery, этапные api / webhook / http / queue / order. Воронка process_uid обработки вебхука = «cdekintegratewebhook»+md5(uuid).
  • Ранее негейтнутые вызовы $modx->log (ошибки конфигурации API, токена, регистрации вебхука) переведены в логгер с уровнем error/нужным тэгом.
  • Конструктор Logger получил $modx; сигнатура write(array $params) сохранена, добавлены ключи level и tags (поддерживается также ключ message наряду с msg).

2.0.3-pl

  • Добавил передачу комментария из адреса заказа (msOrderAddress.comment) в поле comment запроса на создание заказа в СДЭК. Длина обрезается до 255 символов согласно лимиту API. При пустом комментарии поле в запрос не добавляется.

2.0.2-pl

  • Добавлена синхронизация статусов заказов через webhook СДЭК
  • Добавлены системные настройки для webhook:
    • cdekintegrate_webhook_url - URL обработчика webhook
    • cdekintegrate_webhook_registered - флаг регистрации webhook
    • cdekintegrate_status_mapping - сопоставление статусов СДЭК и miniShop2
  • Добавлена автоматическая регистрация webhook при инициализации компонента
  • Добавлен обработчик webhook для получения уведомлений от СДЭК
  • Добавлены методы API для работы с webhook в СДЭК
  • По умолчанию настроено сопоставление статусов: REMOVED → 4 (отменён), CREATED → 3 (создан)

2.0.1-pl

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

2.0.0-pl

  • Исправил путь к сервису в файле запускаемом по cron.

2.0.0-rc

  • Добавил подключение JS на фронте.

2.0.0-beta1

  • Добавил возможность отправки заказов, которые были созданы до обновления ms_CDEK2 до версии 2.8.2

2.0.0-beta

  • Update API v2.0

1.1.10-beta

  • Add system setting cdekintegrate_recipient_cost

1.1.9-beta

  • Add vendor directory in package

1.1.8-beta

  • Add delivery_recipient_cost to order

1.1.7-beta

  • Add package_size setting

1.1.6-beta

  • Prevent creating order if it already exists

1.1.5-beta

  • Fix inner_cdek_id saving

1.1.4-beta

  • Fix weight sending in order create method

1.1.3-beta

  • Fill PVZ code if set

1.1.2-beta

  • Index does not required for PVZ search

1.1.1-beta

  • Direct downloading if file exists

1.1.0-beta

  • Set API v2.0

1.0.3-beta

  • Fix production request credentials

1.0.2-beta

  • Fix request URLs

1.0.1-beta

  • Add encryption

1.0.0-beta

  • First release

Последние обсуждения в сообществе MODX.pro