Модуль - Новая Почта PRO

Модуль для работы требует стандартный для CS-Cart Русская сборка модуль Города + модуль Города Украины.

Самая полная интеграция CS-Cart с сервисом доставки Новая Почта Украина:

• автоматический расчет стоимости доставки (на основании параметров товаров и способа доставки)
• автосоздание электронных накладных на основании заказов (прямо из админки CS-Cart вы можете создать ЭН и автоматически присвоить заказу ТТН, распечатать документы для отгрузки), поддержка нескольких отгрузок
• работа с обратной доставкой денег
• ассоциации заказ - отгрузки - ТТН
• отслеживание покупателем заказа по номеру ТТН прямо из истории заказов
• отправка номера ТТН вместе с письмом о смене статуса заказа
• полная автоматизация работы с отделениями (автополучение областей, городов, отделений)
• работа с Google Maps - выбор отделения из списка (для выбранного отделения показываем карту) или по карте отделений для выбранного города (требуется ключ Api Google Maps, получить ключ можно быстро и бесплатно по инструкции)
• поддержка работы модуля "Города" (данный модуль обязателен для работы системы) с предложением города по началу ввода названия города
• для начала работы достаточно ввести ключ API Новой Почты (версия API 2.0)
• многое другое (это самая полная интеграция с сервисом)

Инструкция по работе модуля Новая Почта PRO

Что необходимо для старта работ:

1. Получите API ключ Новой Почты в вашем личном кабинете (без этого ключа модуль будет неработоспособен)
2. Получите API ключ API Google Maps https://developers.google.com/maps/documentation/j... (если вы хотите использовать карту при выборе отделений)
3. Убедитесь в том, что у вас установлен и включен модуль "Города", который поставляется вместе с CS-Cart русская сборка (это требуемый модуль для работы Новой Почты, так как без городов модуль теряет смысл)
4. Установите в настройках CS-Cart (Настройки: Общие - Местоположение по умолчанию) актуальный Город по умолчанию и Страна по умолчанию (если не используете поле профиля область в оформлении заказа, то оставьте пустым значение для поля Регион по умолчанию)
5. Установите модуль "Новая Почта Pro" в вашу систему CS-Cart
6. В настройках модуля введите ключи а также желаемый пароль безопасности для CRON обновлений данных
7. Сохраните настройки модуля
8. Перейдите в главном меню админпанели AB: Модули - AB: Нова Пошта - Управление данными
9. Нажмите на кнопку "Обновить устаревшую информацию" - чтобы модуль связался с API и наполнил все необходимые справочники (в этот момент справочник областей для страны Украина будет перезаполнен а также автоматически будут заполнены все города Украины с присвоением области) Дождитесь завершения операции, о чем вам будет показано сообщение.

Внимание!!! Если у вас для настройки стоимости по способам доставки до установки модуля использовались области - то перенастройте пункты назначения и проверьте стоимость этих способов доставки. Это нужно сделать единоразово, в дальнейшем вся информация будет лишь обновляться, первая синхронизация необходима для старта работы.

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

Этап настройки завершен далее последует создание способов доставки для Новой Почты.

Создание нового способа доставки для Новой Почты:

1. Cоздайте новый способ доставки
2. Для нового способа доставки укажите желаемый способ расчета стоимости доставки:"В режиме реального времени" - это подключит механизмы модуля для работы со способом доставки (на этапе настройки способа доставки после его первого сохранения вы сможете отключить рассчет стоимости доставки через API Новой Почты) Выберите: Перевозчик: Нова Пошта; Служба доставки: Нова Пошта. Укажите другие желаемые параметры на первой странице настройки способа доставки (время доставки, иконки службы доставки и др.)
3. Сохраните новый способ доставки

Работаем с настройками вновь созданного способа доставки "Новая Почта"

Переходим во вкладку "Настроить"

1. Вычислять стоимость доставки
2. - включенная галочка - подключает механизм посчета стоимости доставки через API Новой Почты- выключенная галочка - оставляет базовый механизм CS-Cart для расчета стоимости доставки по способу
3. Типы отделений - доступные типы отделений для доставки Новой Почтой (веберите желаемые, Parcel Shop - это название миниотделений при магазинах и ТЦ)
4. Продолжить настройку... материал дополняется....

Работа с Электронными накладными:

Модуль предусматривает возможность автоматизации процесса создания ЭН через API Новой Почты на основе заказов. Для этого сделайте следующее:
1) в редактировании заказа в админпенели нажмите на кнопку "Оформить отгрузку"
2) в открывшемся окне укажите:
- Способ доставки - На отделение Новой Почты
- Перевозчик - Нова Пошта
3) Вы можете также заполнить поле "Номер отслеживания" (фактически это номер ТТН Новой Почты), если не планируете создавать ЭН, а просто даете возможность покупателю отслеживать получение груза по номеру накладной прямо из истории его заказов.
В случае, если вы планируете создание электронной накладной на основе заказа с автоматическим получением номера ТТН по API Новой Почты, то оставьте поле "Номер отслеживания" пустым. На шаге создания электронной накладной (ЭН) система получит этот номер отслеживания автоматически из API (как вы уже поняли, это и будет ТТН, по которому ваш покупатель сможет вести отслеживание)
4) Нажмите на кнопку "Создать"
5) Отгрузка создана (если вы не планируете создавать предварительные электронные накладные в системе Новой Почты, то вы совершили уже все действия, достаточные для работы)
6) Переходим во вкладку "Отгрузки Новой Почтой" (в редактировании заказа) проверяем все данные и нажимаем на "Отправить" (по клику на основание этих данных сформируется электронная накладная)
7) После создания электронной накладной вам будут доступны для печати основные документы Новой Почты (ТТН, формы для маркировки груза)
8) Если у вас возможна отправка заказа несколькими посылками, то вы можете разделять заказ на отдельные отгрузки (см. документацию CS-Cart), модуль Новая Почта PRO внедрен с учетом парадигмы платформы: если будет несколько отгрузок, то все они могут иметь свою ТТН и отслеживаться покупателем через личный кабинет.

Требования к эккаунту в Нова Пошта для полноценного использования расширенных функций, использующих API:

• у вас должен быть ключ от API 2.0 (иногда клиенты вводят ключ от первого апи и получают ошибку)
• если вы хотите, чтобы модуль рассчитывал стоимость доставки автоматически, если вы хотите, чтобы модуль давал возможность создавать электронные накладные на основании заказа, то в вашем эккаунте Новой Пошты должны быть заведены контрагенты и контактные лица (хотя бы один контрагент и одно контактное лицо). Наш модуль подтянет автоматически эти данные по вашему ключу и будет использовать для определения города и отделения по умолчанию (используется для расчета стоимости доставки а также создания электронных накладных)

Возможные проблемы и решения:

1. Не предлагает к выбору город при начале его ввода в поле на странице чекаута - включите модуль Города, проверьте работу модуля Города на предмет подхвата поля
2. Выдает "Ошибка. Город отправитель не найден" - запросите менеджера Новой Пошты добавить вам контрагента и контактное лицо в эккаунт, после этого обновите справочник контрагентов: AB: Модули - AB: Нова Пошта - Управление данными - Обновить контрагентов, в настройках способа доставки выберите контрагента, выберите отделение по умолчанию из предложенных вариантов. Проблема будет решена.
3. При выборе города не отдается список отделений. Скорее всего город создан ручным добавлением (не при сонхронизации модулем с базой Новой Почты - для городов, созданных вручную, отделения не будут выводиться) - также следите, чтобы в базе не было "двойников" (городов с одинаковым названием, также возможно только при ручном дублировании города)

Текущие ограничения модуля:

1. не работает с поштоматами, отделениями в Приват Банке (требуется консультация с опытнами пользователями, готовы выслушать предложения, как ограничивать
2. не работает с типами доставки кроме "Отделение - Отделение" (функционал будет добавлен со следующими релизами модуля)