СДЭК — полная интеграция

Оперативная поддержка — быстро отвечаем и помогаем! Предлагайте новые функции и настройки — добавим их по вашим пожеланиям.

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

Возможности

Доставка курьером, в ПВЗ и постаматы.

Выбор тарифов по названиям: включение и отключение галочками.

Отдельные настройки для России, Армении, Беларуси, Казахстана и Кыргызстана.

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

Географические ограничения, фильтры ПВЗ и условия бесплатной доставки.

Создание отправлений, наложенный платёж и обновление данных через API СДЭК.

Оформление СДЭК прямо из заказа

Для кнопок в карточке заказа установите отдельно дополнительный плагин Shop-Script «СДЭК ПРО — оформление из заказа» (cdekpro). Он работает совместно с этим плагином доставки версии 0.5.0 и выше. Для расчёта стоимости доставки на витрине дополнение не требуется.

Откройте заказ, в котором выбран способ доставки этого плагина. Рядом с действиями заказа появится кнопка «Оформить в СДЭК» .

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

После успешного создания отправления рядом автоматически появляется кнопка «Этикетка А6» . Основная кнопка показывает номер накладной, когда его вернул СДЭК. Повторное нажатие проверяет уже оформленную заявку и не создаёт дубликат.

Нажмите «Этикетка А6» , чтобы открыть PDF со штрихкодом в новой вкладке. Готовую этикетку можно скачать или распечатать в формате А6 (105 × 148 мм). Если СДЭК ещё готовит документ, плагин показывает ожидание и повторяет проверку.

До создания отправления кнопка этикетки скрыта. PDF формируется средствами API СДЭК для существующего отправления. Открытие этикетки не создаёт новую доставку.

Оплата и наложенный платёж

При ручном оформлении неоплаченного заказа передаётся наложенный платёж с учётом скидок и доставки. Если заказ отмечен оплаченным в Shop-Script, наложенный платёж равен нулю. Проверка существующей накладной не меняет ранее переданные суммы. Автоматическое создание отправлений и ограничение «только после оплаты» управляются отдельно в настройках.

Пошаговая настройка

Установка. Установите плагин через «Инсталлер». В Shop-Script откройте «Настройки → Доставка → Добавить способ доставки» и выберите плагин «СДЭК — полная интеграция».

Подключение API. Получите Account и Secret в личном кабинете СДЭК, в разделе интеграции. Выберите «Рабочий API» для реальных отправлений или «Тестовый API» для тестовых ключей. Введите «Идентификатор API (Account)» и «Секретный ключ API», нажмите сохранение ключей и проверьте соединение. Тестовые и рабочие ключи не взаимозаменяемы. При последующих сохранениях пустое поле секрета сохраняет прежний ключ.

Откуда отправлять. Укажите страну и город отправления, при необходимости — код города из справочника СДЭК. В поле «Передача отправления» выберите «Со склада СДЭК» или «От двери». Код города и код ПВЗ — разные значения: например, 44 — код Москвы, а не пункт приёма.

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

Страны и способы доставки. В «Страны доставки» включите нужные направления: Россию, Армению, Беларусь, Казахстан и Кыргызстан. В «Варианты доставки» отметьте курьера, ПВЗ и/или постамат. Если для страны включены отдельные правила, настройте её варианты и тарифы; при выключенных отдельных правилах используются общие настройки.

Тарифы. Отметьте тарифы по названиям для используемых направлений «склад → дверь», «склад → склад», «склад → постамат», «дверь → дверь», «дверь → склад» и «дверь → постамат». В «Выбор тарифов» укажите первый доступный, самый дешёвый, дешёвый и быстрый либо все. При выборе первого доступного учитывайте порядок приоритета. Доступность конкретного тарифа проверяет СДЭК по вашему договору.

Вес и упаковка. Проверьте вес товаров и значения по умолчанию: вес задаётся в килограммах, длина, ширина и высота — в сантиметрах. При необходимости заполните размеры упаковок по весу. Режим «Каждая единица товара — отдельное место» включайте, если каждой позиции заданы корректные вес и размеры.

Ограничения и стоимость. При необходимости задайте ограничения по сумме, весу, габаритам и географии; фильтры ПВЗ с оплатой наличными, картой или примерочной; наценку, страховку, округление. Отдельно укажите порог бесплатной доставки для курьера, ПВЗ и постаматов. Пустой порог отключает бесплатную доставку. Ставки проверяйте по своему договору.

Сроки. Настройте дни комплектации, дни отгрузки, час переноса и часовой пояс склада. Во вкладке оформления включите показ срока доставки и трекинга, если они нужны покупателю.

Автоматизация. Во вкладке интеграции «Создавать и обновлять заявки» включает автоматическую работу с отправлениями; «Автоматически создавать только после оплаты» ограничивает автоматическое создание оплаченными заказами. «Отменять заявку при отмене заказа» включайте, только если нужна передача отмен в СДЭК. Ручная кнопка оформления работает отдельно от ограничения автоматического создания после оплаты.

Кнопки и печать. Для оформления из карточки заказа установите дополнение «СДЭК ПРО — оформление из заказа» (cdekpro). После создания отправления используйте «Этикетка А6». Настройки «Печатная квитанция», «Печатные штрихкоды» и формат штрихкодов управляют стандартными печатными формами; отдельная кнопка «Этикетка А6» всегда запрашивает А6.

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

Обновление статусов. Настройте на хостинге штатную периодическую задачу Shop-Script php cli.php shop shipping , указав путь к установке и подходящему PHP. Расписание определяет частоту обновления справочников и статусов.

Если доставка или кнопка не появляется

Проверьте включение способа доставки, витрину, способы оплаты, ключи и выбранный сервер API.

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

Для кнопок установите и включите cdekpro; в заказе должен быть выбран способ доставки grocdek, а у сотрудника должны быть права на работу с заказом.

Если показано «В заказе не сохранён тариф СДЭК», откройте редактирование заказа и пересчитайте доставку, затем сохраните корректный вариант.

Кнопка «Этикетка А6» появляется только после создания отправления. Если документ ещё готовится или API вернул ошибку, дождитесь обработки либо повторите открытие после устранения причины.

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

Совместимость

PHP 7.4 и выше, расширения cURL и mbstring, актуальные Webasyst и Shop-Script. Проверены оформление заказа 2.0 и интерфейсы Webasyst 1.3 и 2.0. Дробные количества, дополнительные единицы измерения и канбан отдельно не тестировались.