Интеграция укрпочта и RetailCRM

Поддержка модуля:


Почта    support@integro.cc

Telegram  Support | Integro

Телефон  +38 (044) 390-71-13

Модуль интеграции Укрпочта — RetailCRM

Возможности интеграции


Шаг 1. Подготовка систем

1. Создать в CRM API-ключ. При создании ключа ему необходимо предоставить права на методы «Разрешенные методы API», которые указаны ниже.

Доставки Интеграция Справочники

При создании ключа необходимо выбрать в настройках «Тип доступа» те магазины, в которые будет происходить передача заказов, и с которыми будет обмен информации по заказам. API-ключ вы можете сгенерировать для одного, нескольких или всех магазинов. Также рекомендуем добавить комментарий, например «Укрпочта».

2. Если у вас нет договора с Укрпочтой необходимо:

2.1 Необходимо обратится в Укрпочту и подписать договор с возможностью использовать API «Для внутренних отправлений».

2.2 После подписания договора запросить у персонального менеджера параметры для подключения модуля (Production Bearer eCom, Production Bearer StatusTracking, Prod_counterparty Token).

3. Если у вас есть договор с Укрпочтой необходимо:

3.1 Обратится к персональному менеджеру Укрпочты и уточнить есть ли возможность по вашему заключенному договору использовать API «Для внутренних отправлений».

3.2 Запросить параметры для подключения модуля (Production Bearer eCom, Production Bearer StatusTracking, Prod_counterparty Token).

Шаг 2. Подключение систем

Чтобы подключить и активировать модуль, сделайте следующее:

1. В CRM перейдите в раздел Администрирование > Интеграция > Маркетплейс. Выберите модуль «Укрпочта». При нажатии на модуль откроется PopUp окно с описанием модуля. В открывшемся окне нажмите кнопку «Перейти в личный кабинет».

2. Нажав на кнопку, вы попадете на вкладку модуля «Подключение». На данной вкладке необходимо заполнить данные для подключения, которые вы создали на первом шаге (URL адрес и API-ключ магазина в CRM), а также данные Укрпочты (Production Bearer eCom, Production Bearer StatusTracking, Prod_counterparty Token) и ваш ЕДРПОУ(для юр. лиц) или ИПН (для ФЛП и физ. лиц).

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

4. После заполнения всех данных нажимаете кнопку «Подключить». Если данные заполнены верно, будет перенаправлено в маркетплейс. В результате для каждого кабинета будет создано отдельное подключение, которые можно увидеть по адресу Администрирование > Интеграция > Маркетплейс

Важно, обратите внимание!

Каждый подключенный кабинет оплачивается отдельно.


Шаг 3. Настройка модуля Укрпочта

1. Если верся вашей CRM 8:

При регистрации модуля доставки, CRM сама создаст тип доставки в справочниках, проинтегрированный с модулем.

2. Если верся вашей CRM 7 и ниже:

2.1. Необходимо добавить тип доставки для каждого созданного кабинета Укрпочта или отредактировать существующую доставку в разделе Администрирование > Справочники > Типы доставок.


2.2. Затем в созданном типе доставки, в поле «Интегрировать с», необходимо указать интеграцию с соответствующим кабинетом Укрпочта физического или юридического лица. После сохранения, указанное поле более не редактируется.


Обратите внимание, что для каждого подключенного кабинета Укрпочта необходимо создать отдельный тип доставки.

Настройки модуля находятся в личном кабинете на вкладке «Настройка» по адресу Администрирование > Интеграция > Маркетплейс Найдите модуль доставки «Укрпочта» и перейдите в настройки модуля по кнопке «Перейти в личный кабинет». Для каждого подключенного физического, юридического лица и ФЛП конфигурацию необходимо проводить отдельно.

Вкладка «Значения по умолчанию»

На вкладке «Значения по умолчанию» можно установить по некоторым полям доставки из заказа значения, которые будут отображаться по умолчанию в заказе (при выборе типа доставки Укрпочта).

Плательщик

Укажите, кто оплачивает доставку: получатель или отправитель.

Нулевая объявленная стоимость по умолчанию

В случае, если стоимость доставки равна нулю.

По умолчанию не синхронизировать со службой доставки

Опция «Не синхронизировать со службой доставки» позволяет не передавать информацию по заказу в «Укрпочта». Если опция активирована, все обязательные поля при оформлении доставки становятся необязательными. Данный функционал полезен в тех случаях, когда товары в заказе сначала изготавливаются или комплектуются, и только после этого заказ передается в службу доставки. К этой опции открыт доступ также в триггерах.

ФИО отправителя

Укажите ФИО отправителя

Номер телефона отправителя

Укажите номер телефона отправителя

Плательщик комиссии за наложенный платеж

Укажите, кто оплачивает комиссию за наложенный платеж - отправитель или получатель.

Технология доставки

Выберите один из четырех вариантов способа доставки: Отделение-Отделение, Отделение-Адрес, Адрес-Отделение, Адрес-Адрес.

Тип клиента

Укажите тип клиента: физическое лицо, юридическое лицо, или физическое лицо - предприниматель.

Название компании получателя

Данное поле следует оставить пустым

Номер ЕДРПОУ или ИПН получателя

Данное поле следует оставить пустым

№ банк-счета IBAN, 29 символов

Номер банковского счета IBAN, на который будет возвращен наложенный платеж

ФИО получателя

Данное поле следует оставить пустым

Номер телефона получателя

Данное поле следует оставить пустым

СМС уведомление

Отправка СМС-сообщения на номер получателя при доставке посылки на отделение. Если активировать эту опцию, к стоимости заказа будет добавлено 3 грн.

Описание груза

Укажите подходящее описание вашего груза.

Вкладка «Статусы»

Установка соответствия получаемых от Укрпочты статусов для передачи в CRM.
На вкладке «Статусы» доступно две колонки, в которых возможно проставить соответствие статусов Укрпочты и CRM.
В колонке «Статус код Укрпочта» указывается статус посылки, который будет отображаться в карточке заказа после создания ТТН.
В колонке «Статус в CRM» указывается статус заказа, который будет проставляться автоматически в зависимости от актуального статуса посылки, отправленной клиенту.

«Вкладка «Способы оплаты»

На вкладке способы оплаты необходимо указать какие оплаты можно использовать для типа доставки Укрпочта. Галочка в колонке «Наложенным платежом» означает, что с этим способом оплаты можно отправлять заказ наложенным платежом.

Важно, обратите внимание!

Чтобы указанные в настройках модуля типы оплат стали доступны в карточке заказа, обязательно необходимо перейти в соответствующий тип доставки, интегрированный с модулем Администрирование > Справочники > Типы доставок и нажать кнопку «Сохранить».

Вкладка «Склады»

Для корректной работы модуля в каждом складе необходимо указать все данные по адресу. Настройки склада задаются в пункте меню Администрирование > Магазины > Склады.

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

Работа с типом доставки Укрпочта в карточке заказа

Опция «Не синхронизировать со службой доставки» позволяет не передавать информацию по заказу в «Укрпочта ». Если опция активирована, все обязательные поля при оформлении доставки становятся необязательными. Данный функционал полезен в тех случаях, когда товары в заказе сначала изготавливаются или комплектуются, и только после этого заказ передается в службу доставки, либо на этапе тестирования. К этой опции открыт доступ также в триггерах.

Важно, обратите внимание!

Заказ не отправится в службу доставки, если он находится в группе статусов «Отмена».


Заполните все обязательные поля:

Если получать посылку будет клиент, оформивший заказ, поля «ФИО получателя» и «Номер телефона получателя» следует оставить пустыми.

Работа с Укрпочта в карточке заказа (для физического лица)

В новом заказе необходимо выбрать тип доставки Укрпочта, заполнить пустые поля в блоках «Склад», «Габариты и вес» и все обязательные поля блока «Доставка», после чего выбрать тариф, нажав соответствующую кнопку.

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

Чтобы запустить процесс создания ТТН, необходимо деактивировать галочку «Не синхронизировать со службой доставки» и нажать на кнопку «Сохранить», после чего начнется фоновый процесс синхронизации со службой доставки Укрпочта.

В момент сохранения заказа система и Укрпочта обмениваются данными. Как только процесс создания ТТН завершится, номер станет доступным в карточке заказа в поле «Номер отправления». Через время в карточке заказа станет доступным поле «Статус доставки», которое позволяет отслеживать актуальное состояние вашего отправления. В карточке заказа в разделе «Печать» станет доступна к просмотру или печати маркировка.

Важно, обратите внимание!
  1. Если ТТН была создана в карточке заказа и в нее нужно внести изменения, то необходимо нажать кнопку «Отменить доставку» затем нажать кнопку «Оформить заново» и после повторить процесс создания ТТН уже с новыми данными по доставке.

  2. После печати документов нельзя изменить данные по доставке или удалить их!

Работа с Укрпочта в карточке заказа (для юридического лица и физического лица - предпринимателя)

Для оформления доставки для юридического лица или физического лица - предпринимателя, необходимо дополнительно выбрать тип контрагента и указать ЕДРПОУ (для юр. лица) или ИПН (для физического лица - предпринимателя) в соответствующих полях.

Создание ТТН для корпоративных клиентов в карточке заказа

При подключенном аккаунте юридического лица Укрпочта дает возможность создать ТТН на юридические лица.

Для этого необходимо в карточке заказа:
  1. 1. В поле «Тип клиента» выбрать опцию «Корпоративный клиент».

  2. 2. После этого появится возможность выбрать существующего корпоративного клиента или создать нового.

  3. 3. В блок «ЮРИДИЧЕСКИЕ И БАНКОВСКИЕ РЕКВИЗИТЫ» необходимо выбрать существующую компанию клиента или создать новую.
  4. Важно, чтобы корректно создалась ТТН для этого в компании, которая будет указана в заказе обязательно должны быть заполнены следующие реквизиты:
    • - Название компании;
    • - ИПН / ІНН или ОКПО / ЄДРПОУ;
    • - Тип контрагента (Юридическое лицо / ФЛП).
Важно, обратите внимание!

ТТН, сформированные в CRM не будут отображаться в личном кабинете Укрпочты согласно требованиям службы доставки.
Если технология доставки Адрес-Адрес или Отделение-Адрес, то обязательно указывать почтовый индекс. Иначе ТТН не будет создана.





Введите адрес вашего портала RetailCRM.
Введить API-ключ для интеграции.
Настройка подключения к службе доставки Ukrposhta

Контакты для связи
Для связи с вами.
Для связи с вами.
Для связи с вами.

Поля отмеченные «*» — обязательные для заполнения.