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

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

• — Подключить 3 кабинета Укрпочты (физическое лицо, юридическое лицо, физическое лицо - предприниматель);
• — Рассчитывать предварительную стоимость доставки;
• — Оформлять заявку на доставку;
• — Удалять заявку на доставку;
• — Производить печать наклеек из интерфейса системы;
• — Отображать в системе актуальные статусы доставок и задавать соответствия статуса доставки статусу заказа;
• — Возможность оформить заявку на доставку на другого получателя, который будет отличаться от клиента в заказе.

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

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

Доставки

• Редактирование (delivery_write)

Интеграция

• Получение (integration_read)
• Редактирование (integration_write)

Справочники

• Получение (reference_read)

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

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

2.1 Обратиться в Укрпочту к Павленко Дмитро +38 050-100-65-49, e-mail: pavlenko-ds@ukrposhta.ua и подписать договор.

2.2 После подписания договора, обратитесь в нашу техническую поддержку, контакты которой указаны в разделе «Поддержка» и запросите ключи (Production Bearer eCom, Production Bearer StatusTracking, Prod_counterparty Token) со скидкой 20% на подключение модуля Укрпочта.

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

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

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

Шаг 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» указывается статус заказа, который будет проставляться автоматически в зависимости от актуального статуса посылки, отправленной клиенту.

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

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

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

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

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

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

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

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

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

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

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

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

• «Склад отгрузки»;
• «Дата отгрузки»;
• «Вес»;
• «Габариты»;
• «Терминал отгрузки»;
• «Плательщик»;
• «Тариф» (отделение Укрпочты);
• «Плательщик комиссии за наложенный платеж»;
• «Технология доставки»;
• «Тип клиента»;
• «Название компании» (если получатель ИП или ФЛП);
• «ЕДРПОУ(юр-лица) или ИПН(ФЛП) получателя» (если получатель ФЛП);
• «№ банк-счета IBAN, 29 символов» (если расчет производится на банковский счет);
• «ФИО получателя»;
• «Номер телефона получателя»;
• «Описание груза»;
• Адрес доставки: «Регион», «Город», «Метро», «Улица», «Дом», «Квартира».

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

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

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

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

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

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

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

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

   

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

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

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

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

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

Для этого необходимо в карточке заказа:

1. 1. В поле «Тип клиента» выбрать опцию «Корпоративный клиент».

   

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

   

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

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

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