Нова пошта

Материал добавлен: 24 Сентября 2021

Материал обновлен: 02 Марта 2023

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

Подключение способа доставки “Нова пошта”
Добавление способа доставки в интернет-магазин

Подключение способа доставки “Нова пошта”

Для подключения способа доставки Нова пошта, вам нужно выполнить регистрацию / выпуск API ключа в личном кабинете: https://my.novaposhta.ua/auth#apikeys или в разделе https://new.novaposhta.ua/dashboard/settings/developers

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

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

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

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

В поля “Ключ API” вам нужно ввести ваш ключ, который вы можете получить после регистрации в личном кабинете.
После ввода данных, необходимо нажать "Проверить связь с сервисом", чтобы проверить правильность вводимых данных и выполнить подключение.
В блоке "Склад, с которого будут отправляться заказы:" выберите город и отделение, с которого будут отправляться товары.
В поле "Валюта расчета доставки", в данном поле вам нужно выбрать основную валюту в которой будут производиться расчеты.
В поле "Тип груза", вам нужно определиться какой тип товаров вы будете пересылать (документы, посылки или шины и диски).
В блоке "Поля товара, формирующие его как отдельное "место" в отправке", вам следует выбрать поля с которых будет браться информация для (Длина упаковки, Ширина упаковки и Высота упаковки).
Пункт "Типичные габаритные размеры упаковки" позволяет указать стандартные габариты ваших товаров, если у вас товары имеют один общий габарит длина, ширина и высота, вы его можете в данном пункте настроить и по этим размерам будет производиться расчет стоимости доставки.
В пункте "Вес посылки по-умолчанию", вы можете настроить стандартный вес, он будет применяться лишь в том случае, если вес у товаров не указан и автоматический расчет общего веса заказа не возможен
Блок "Поля товара, необходимые для расчета стоимости доставки", здесь вам стоит снова же выбрать поля с которых будут браться автоматически значения для расчета стоимости доставки в зависимости от типа товаров.
В поле "Оплачивает доставку", вам нужно выбрать кто по-умолчанию оплачивает доставку Отправитель или Получатель.
В поле "Бесплатная" доставка, вы можете настроить сумму заказа, начиная с которой у вас будет формироваться бесплатная доставка.
В поле "Создание экспресс-накладной", вы можете настроить данные кто формирует посылки (выбрать пользователя). Не забудьте указать обязательные поля с которых будет браться информация об имени и фамилии получателя. Важно, накладная формируется только при смене статуса заказа с Готов на Доставляется.

Примечание

Обязательным среди полей заказа является наличие поля, ассоциированного с номером телефона получателя, не упустите данный пункт настройки.
Если у товара в выбранных дополнительных полях не указаны габаритные размеры его упаковки в сантиметрах - подразумевается, что он будет уложен в общую упаковку, габариты которой указаны в поле "Типичные габаритные".

Важно!

Почем нет наложенного платежа в НП? Потому, что прежде всего это способ доставки, Наложенный платеж это способ оплаты. Вам нужно в способах оплаты создать отдельный способ назвав его Наложенный платеж (нова пошта), при оформлении заказа клиент выбирает этот способ оплаты и способ доставки Нова пошта и вопрос будет решен.
Где проверить адрес доставки или отделение, которое выбрал клиент ? Проверить можно в кабинете Новой Почты, все данные адреса, отделения, Ф.И.О и номер телефона клиента, все передается в TTH и отдельно не фиксируется в заказе, чтобы вы это проверили у себя на сайте.
После оформления заказа не формируется TTH, почему ?
- При оформлении заказа от клиента обязательно должна быть корректно дана информация (телефон 380*********, Ф.И.О). Проверьте, чтобы в поле Ф.И.О не было лишней информации, и чтобы поле телефон не было заполнено номером фейком.
- Проверьте ваши товары, поле Вес обязательно должно быть заполнено, если оно пустое, TTH не сформируется.
Как проверить ошибки и разобраться в причине не формирования TTH?
- Основное условие формирования TTH, после оплаты заказа когда у товара статус Оплачен, меняем статус на Готов и после на Доставляется. Если в товаре все поля заполнены, вес указан и клиент все данные корректно заполнил TTH будет создана без ошибок.
- Если вы для удобства пользования интернет-магазином переименовали статусы заказов на удобные вам, сверьте корректно какой статус ранее отвечал за статус Готов и Доставляется, чтобы вы корректно их переключали для формирования TTH и не путали.
- Если TTH все же не создался, на странице управления заказами: /shop/invoices смотрим проблемный заказ который оплачен и для которого в правильном порядке изменялись статусы с Готов на Доставляется.
  - Напротив заказа жмем ссылку "Журнал" и ищем примерно такой текст - Delivery System NPOST returned error: Phone invalid format, эта ошибка нам сообщает, что клиент заполнил поле "Номер телефона" некорректно, нужно редактировать заказ и проверить поле телефон.
  - Ошибка Delivery System NPOST returned error: CityRecipient not selected, сообщает нам о том, что клиент не выбрал город для доставки при формировании заказа, нужно редактировать заказ и исправлять Город.
  - Ошибка Delivery System NPOST returned error: FirstName has invalid characters, сообщает нам о том, что поле Ф.И.О заполнено некорректно. Проверяем заказ, заполнено ли поле и нет ли в нем лишнего текста, должны лишь быть данные Ф.И.О.
  - Ошибка Delivery System NPOST returned error: Weight is invalid, сообщает нам о том, что в рамках товара, который заказал клиент не заполнено поле Вес товара. Проверяйте и исправляйте.
- Если вы все ошибки устранили и соблюдаете порядок переключения статусов заказа для формирования TTH, номер можно проверить в конкретном заказе нажав по ссылке Журнал. При проверке можно найти примерно такую запись: Delivery System NPOST created ttn: 204*********07

Сохраните изменения. Настройка завершена.

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

Нова пошта