Интеграцията може да се активира за всеки клиент поотделно, поради което се предават само данните за пратките, принадлежащи на определените клиенти на Deliveo.
Предпоставки
- абонамент за Deliveo API;
- абонамент за използване на Deliveo webhook;
- активен акаунт в Project44;
- права за инсталиране на добавката;
- права за настройка и използване на добавката.
Инсталиране и достъп
Добавката може да бъде инсталирана в Диспечерския портал, в менюто „Добавки“.
След инсталирането добавката е достъпна в менюто „Добавки“ / „Project44 Connect“. Инсталирането и използването могат да се извършват само от потребител, разполагащ с необходимите права.
Собствени менюта на приставката:
- Контролен панел
- Клиенти
- Настройки
Свързване с акаунта в Project44
При свързването на приставката системата създава технически потребител в акаунта в Project44.
За да завършите свързването:
- Отворете управлението на потребителите в Project44.
- Намерете потребителя с името, което се показва на страницата „Настройки“ на Project44 Connect.
- Отворете ролите на потребителя.
- В раздела „Роли“ кликнете върху бутона „Управление на роли“.
- Добавете правото „Управление на пратки“.
- Запазете промените.
На страницата „Настройки“ на Project44 Connect зелен индикатор показва, че връзката е установена успешно.
Настройка на препратения идентификатор на пратката
На страницата „Настройки“ можете да изберете кой идентификатор на пратка Deliveo да препраща към Project44. Възможните идентификатори са:
- DeliveoID
- Референтен номер
- Код за проследяване
За да запазите избраната стойност, кликнете върху бутона „Запазване на настройката за идентификатора“. Настройката променя само идентификатора, препратен към Project44. Вътрешното съпоставяне на събитията в Deliveo и Project44 продължава да се извършва въз основа на DeliveoID.
Настройка на уебхукове
Project44 Connect получава известия за събитията, свързани с пратките, чрез функцията за уебхукове на Deliveo. За да направите настройката:
- Отворете менюто „Настройки / Уебхукове“ в портала за диспечери.
- Изберете съответното събитие.
- Отворете разширените настройки на събитието.
- Копирайте URL адреса на уебхука, който се показва на страницата „Настройки“ на Project44 Connect за съответното събитие.
- Запазете настройката на уебхука.
- Повторете операцията за всяко необходимо събитие.
За следните събития има отделен URL адрес на уебхука:
- Създаване на пратка
- Приемане на пратка
- Трансфер
- Успешна доставка
- Неуспешна доставка
URL адресите на уебхуковете са уникални, затова винаги използвайте адресите, които се показват на страницата „Настройки“ на съответната инсталация на Project44 Connect.
Избор на клиенти
На страницата „Клиенти“ можете да зададете кои данни на клиентите на Deliveo да се прехвърлят към Project44.
За да активирате клиент:
- Отворете менюто „Клиенти“.
- Намерете клиента в списъка.
- Активирайте превключвателя „Активен“ в реда на клиента.
Когато превключвателят е включен, събитията, свързани с пратките на съответния клиент, се препращат. Когато превключвателят е изключен, данните на клиента не се препращат към Project44.
Списъкът с клиенти:
- може да се филтрира по име;
- филтрирането може да се отмени;
- при наличие на повече страници може да се прелиства.
Преди да активирате интеграцията, проверете дали наистина са активни само онези клиенти, чиито данни искате да препращате.
Прехвърлени събития
Project44 Connect преобразува събитията от Deliveo в събития на Project44.
Примери за съпоставяне на събития:
- Създаване на пратка →
SHIPMENT_CREATED - Приемане на пратка →
PICKED_UP - Прехвърляне на пратка →
ARRIVED_AT_STOP - Успешна доставка →
DELIVERED - Неуспешно доставяне → например
DELIVERY_MISSEDилиRETURN_TO_SENDER
Събитието в Project44, свързано с неуспешната доставка, може да зависи от събитието за неуспешна доставка, регистрирано в Deliveo.
Контролен панел
Контролният панел показва заявките за уебхук от последните 30 дни.
Страницата обобщава по тип събитие:
- създадените пратки;
- приеманията на пратки;
- прехвърлянията на пратки;
- успешните доставки;
- опитите за доставка;
- неуспешните доставки.
Подробният списък със събития съдържа следните данни:
- Deliveo ID
- Събитие в Deliveo
- Събитие P44
- Прието
- Дата
Колоната „Прието“ показва дали Project44 е приел изпратеното събитие.
Списъкът:
- може да се филтрира по Deliveo ID;
- може да се прелиства;
- може да се използва за проверка по времева последователност и за откриване на грешки.
Проверка на връзката
След настройката е препоръчително да проверите функционирането с тестова пратка.
- Уверете се, че клиентът, към когото се отнася пратката, е активен на страницата „Клиенти“.
- Създайте или редактирайте пратка, така че да се случи едно от настроените webhook събития.
- Отворете контролния панел на Project44 Connect.
- Намерете пратката по Deliveo ID.
- Проверете събитието в Deliveo и съответното събитие в P44.
- Проверете дали колоната „Прието“ показва успешно приемане.
Прекъсване на връзката
Активната връзка с Project44 може да бъде прекъсната чрез бутона „Премахване на връзката“ на страницата „Настройки“.
Преди да прекъснете връзката, проверете дали вече няма нужда от препращане на събития към Project44.
След прекъсване на връзката е препоръчително да проверите настройките на уебхука, свързани с Project44 Connect, в менюто „Настройки“ → „Уебхукове“ на Deliveo и при необходимост да ги премахнете.
Чести грешки
Събитията не се показват на контролния панел
Проверете:
- дали връзката е активна;
- дали съответният клиент е активен на страницата „Клиенти“;
- дали необходимите уебхукове са настроени;
- дали към съответното събитие е зададен правилният URL адрес на уебхука;
- дали събитието е настъпило през последните 30 дни.
Project44 не приема събитието
Проверете:
- дали техническият потребител на Project44 разполага с права за управление на пратки;
- дали връзката с акаунта в Project44 е активна;
- дали препратеният идентификационен номер на пратката е наличен в пратката;
- какви събития от Deliveo и P44 се показват на контролния панел.
Пратките на даден клиент не се препращат
Отворете страницата „Клиенти“ и проверете дали превключвателят „Активен“ за съответния клиент е включен.
В Project44 се показва грешен идентификатор на пратката
Проверете избрания идентификатор на пратката на страницата „Настройки“.
Възможните стойности са:
- DeliveoID
- Референтен номер
- Код за проследяване
След промяната кликнете върху бутона „Запазване на настройките за идентификатора“.
Предаването на някой от типовете събития не работи
Проверете дали уебхукът за съответното събитие е настроен отделно. За всеки тип събитие трябва да се използва собственият URL адрес, който се показва на страницата на Project44 Connect.