Доставка

Интеграция MNG Kargo (DHL eCommerce)

MNG Kargo вошёл в DHL Group и работает под названием «DHL eCommerce». Договор и номер клиента остаются прежними; изменились название бренда и API. В панели Fenikya перевозчик указан как «DHL eCommerce» — не ищите строку «MNG Kargo».

Что делает интеграция MNG Kargo (DHL eCommerce)?

Создание отправленияШаги заказа и штрихкода выполняются цепочкой в фоне — вы нажимаете одну кнопку.
трек-номерТрек-номер, полученный на шаге штрихкода, автоматически записывается в заказ.
Определение кодов провинции/районаAPI требует коды, а не названия городов — Fenikya определяет их по адресу автоматически.
Оплата при полученииПоддерживаются отправления с наложенным платежом.

Что нужно до начала?

Подготовьте заранее — это ускорит настройку:

  • Договор с MNG Kargo (DHL eCommerce): номер клиента и пароль
  • Приложение, созданное на портале разработчиков MNG: Client Id и Client Secret
  • Указанный адрес отправителя

Как настроить?

Если возникнут трудности при настройке, напишите в нашу поддержку.

  1. Создайте аккаунт разработчика на apizone.mngkargo.com.tr. Регистрация бесплатна и не требует данных компании или налоговых реквизитов.
  2. Создайте приложение на портале — Client Id и Client Secret сгенерируются автоматически.
  3. Подпишите приложение на нужные продукты (некоторые планы бесплатны и не требуют одобрения).
  4. В панели Fenikya откройте «Настройки» → «Доставка» и выберите в списке DHL eCommerce.
  5. Заполните четыре поля: Client Id, Client Secret, номер клиента и пароль клиента.
  6. Проверьте подключение. Fenikya отдельно проверяет ключи портала и данные клиента и сообщит, что именно неверно.

Кому подойдёт эта интеграция?

Для продавцов внутри страны с договором MNG Kargo / DHL eCommerce. Если вы отправляете за границу, вам нужна не эта страница, а интеграция DHL Express — это разные службы с разными API.

Частые проблемы

Не могу найти в панели строку «MNG Kargo»Из-за смены бренда перевозчик указан в списке как «DHL eCommerce». Это та же компания, ваш договор действует.
Ошибка «Invalid client id or secret»Эта ошибка не связана с номером клиента — она указывает на Client Id/Secret приложения на портале. Убедитесь, что вы не перепутали значения местами.
Ошибка «Not registered to plan»На самом деле это хорошая новость: ключи верны. Значит, вы не подписали приложение на нужный продукт на портале.
Ключи верны, но отправление не создаётсяНе приняты номер клиента или пароль. Они отличаются от ключей портала и берутся из договора с MNG; пароль онлайн-отделения может не подойти вместо пароля API.
Не получается скачать этикетку (PDF со штрихкодом)Отдельного метода для скачивания этикетки в API нет — значения штрихкода приходят в ответе на создание отправления. Этикетку можно распечатать в панели отделения MNG.
С тестовыми данными рабочее отправление не создаётсяТестовая и рабочая среды работают по разным адресам, и их ключи не взаимозаменяемы.
Частые вопросы

Часто задаваемые вопросы

MNG Kargo стал DHL?
MNG Kargo вошёл в DHL Group и работает под названием DHL eCommerce. Сайт mngkargo.com.tr тоже работает под этим брендом. Ваш договор и номер клиента остаются в силе.
DHL eCommerce и DHL Express — одно и то же?
Нет. DHL eCommerce перевозит ваши отправления внутри страны на инфраструктуре MNG, а DHL Express — международная служба с совершенно другим API. Если вы отправляете за границу, смотрите интеграцию DHL Express.
Получать ли данные API у менеджера?
Только часть. Client Id и Client Secret вы создаёте сами на портале разработчиков MNG, а номер клиента и пароль — из договора. Для интеграции нужны все четыре.
Нужно ли быть клиентом MNG, чтобы зарегистрироваться на портале разработчиков?
Нет. Регистрация на портале бесплатна и не требует данных компании. Но чтобы создавать отправления, нужны номер клиента и пароль из договора с MNG.

Попробуйте интеграцию MNG Kargo (DHL eCommerce) в Fenikya

Откройте магазин, подключите интеграцию и начните продавать.