Инструкция состоит из нескольких частей:

1. Подключение способа доставки “СДЭК”
2. Добавление способа доставки в интернет-магазин
3. Подключение виджета ПВЗ в виде карты
4. Обновление виджета СДЭК версии 2.0 на 3.0

Подключение способа доставки “СДЭК”

Интеграция возможна только при наличии договора (интернет-магазина или договора на оказание курьерских услуг) и если он имеет статус “Подписан” в системах СДЭК. Поэтому, если у вас нет договора, либо он еще не подписан, свяжитесь с менеджером продаж, либо заключите договор по ссылке: https://www.cdek.ru/ru/zapolnit-anketu

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

После того, как ваш договор будет подписан, вы сможете получить ключи на странице https://lk.cdek.ru/integration/index

Скопируйте полученные ключи и переходите к добавлению способа доставки в интернет-магазин.

Добавление способа доставки в интернет-магазин

Зайдите в панель управления вашего сайта, откройте модуль “Интернет-магазин” и перейдите к способам оплаты и доставки:

Добавьте новый способ и активируйте использование модуля “СДЭК” для расчета стоимости доставки. Затем нажмите на ссылку “Настройки модуля”:

Появится окно с настройками:

1. В поля “Идентификатор аккаунта” и “Пароль” введите ваш идентификатор и пароль соответственно.
2. После ввода данных, необходимо нажать "Проверить связь с сервисом", чтобы проверить правильность вводимых данных и выполнить подключение.
3. В блоке "Склад, с которого будут отправляться заказы:" выберите город и отделение, с которого будут отправляться товары.
4. Инфо-поле заказа, здесь выбираем то поле в которое будет записываться информация об адресе доставки. Вы можете выбрать поле, в которое автоматически будет подставляться информация о выбранном пользователе отделении. Тип данного поля обязательно должен быть textarea.
5. Валюта вашего договора c СДЭК, выберите ту валюту с которой у вас будет работать способ доставки и в которой вы торгуете на сайте.
6. Тип дополнительных услуг, в этом пункте нужно выбрать какие услуги вы оказываете.
7. В сервис “СДЭК” могут отправляться поля, отвечающие за габариты товара: высота, ширина, длина. Их значение будет подставляться из "Типичные габаритные размеры упаковки ".
8. Единица измерения размера у товаров, выберите один из вариантов (мм, см, дм или м).
9. В поле "Вес посылки по умолчанию" - это стандартный вес (значение будет браться, если у товаров в заказе не заполнено поле "Вес".
10. Единица веса на сайте, выберите один из вариантов (граммы или киллограммы).
11. Рассчитывать сумму доставки, настройте в данной опции рассчет суммы доставки первая опция и если активировать вторую, можно прописать сумму заказа при которой доставка будет бесплатной. Пишем тот потолок суммы заказа при которой вы готовы доставлять заказы клиенту бесплатно.
12. Коэффициент стоимости доставки. Стоимость доставки будет умножена на данный коэффициент. Можно этим коофициентом сделать свою наценку на стоимость доставки для конкретного способа доставки.
13. Наценка. Это значение будет добавлено к стоимости каждого отправления.
14. Стоимость доставки по-умолчанию. Данное значение будет подставлено в случае, если не удалось рассчитать стоимость от СДЭК.
15. Регистрировать доставку в СДЭК при смене статуса заказа с Готов на Доставляется. В кабинет СДЭК заказы будут передаваться лишь при соблюдении смены статуса заказа после Оплачен на Готов и Доставляется. Важно помнить, что информаци от клиента должна быть корректной (Имя, Телефон, адрес отделения итд). Если заполнить контакты некорректно или оставить поля пустыми, накладная сформирована не будет.
16. Пункт "Отображать выбор ПВЗ в виде карты" позволяет подключить отображение карты на которой вы можете выбрать отделение для доставки.

Подключение виджета ПВЗ в виде карты

Для подключения виджета ПВЗ СДЭК, вам нужно получить API ключ от Яндекс maps, переходим на страницу: https://developer.tech.yandex.ru/ жмем кнопку Подключить API:

Далее отмечаем пункт - JavaScript API и HTTP Геокодер:

Жмем кнопку "Продолжить".

После вас потребуют заполнить о себе данные (почту, номер телефона, частное или юр лицо итд). В пункте "Цель использования", отметить "Нужен API ключ для конструктора карт".

Заполните все поля и нажмите кнопку "Продолжить". 

После создания ключа вас направит на страницу: https://developer.tech.yandex.ru/services/3 можете скопировать ваш ключ в блоке немного ниже:

Далее скопированный ключ установите в настройках способа доставки СДЭК:

Сохраните изменения.

Последний пункт настройки API ключа в яндекс картах, перейдите в вашем ключе по кнопке Изменить:

Далее в поле "Ограничение по HTTP Referer" укажите два домена, у нас для тестового сайта это:

• freedomen.net
• widget.cdek.ru

вам же первый домен нужно указать именно ваш и сохранить настройки. Далее подождать 15 минут и можно проверять работу ПВЗ виджета на вашем сайте.

Настройка завершена.

Обновление виджета СДЭК версии 2.0 на 3.0

С недавнего времени СДЭК обновили свой виджет с старой версии 2.0 на новую 3.0 прекратив поддержку старого апи, что сломало работу виджета и кнопки "Выбрать адрес" для открытия карты чтобы выбрать отделение для доставки.

Чтобы исправить данную ситуацию, вам необходимо подключиться к вашему PHP FTP. Далее после подключения к PHP серверу вам в корень в папку scripts нужно загрузить файл: cdek_service.php.

$service = new service(/**
 * Вставьте свой аккаунт\идентификатор для интеграции
 * Put your account for integration here
 */ 'cdek-login',

    /**
     * Вставьте свой пароль для интеграции
     * Put your password for integration here
     */ 'cdek-pass');

Перед тем как заливать открыть файл на редактирование, найти строки 7 cdek-login и 11 cdek-pass, в которых заменить стандартный текст на ваши данные, прописать ваши:

• Идентификатор аккаунта
• Пароль

которые у вас прописаны в способе доставки СДЭК, именно их копируем и прописываем в документ cdek_service.php.

Примечание!

Важно! Если вы случайно удалите ваш API ключ, вместе с этим удалится и беслатный тариф для FREE ключа. Для решения вопроса возврата бесплатного тарифа вам придется писать в техподдержку Яндекс с формы.

В запросе достаточно сообщить, что вы по ошибке удалили API ключ и забыли, что тариф удаляется вместе с ним. Пример сообщения в саппорт яндекса: Прошу вернуть бесплатный тариф для моего ключа (пример ключа), Сценарий - JavaScript API и HTTP Геокодер, Нужен API ключ для конструктора карт. И вам поддержка яндекс обязательно поможет с возвратом бесплатного тарифа.

Примечание! Объяснения по пункту 4, В настройке "Поле заказа для вывода подробной информации" нужно указать, заранее созданное в Списке полей заказа ваш-сайт/panel/?a=shop&l=order поле с типом TEXTAREA, в него при выборе точки доставки заказа будет выводиться информация о доставке. Перейдите в управление полями заказа: /panel/?a=shop&l=order и создайте поле textarea после его можно будет выбрать в СДЭК.

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