Обмін даними між ANT-Logistics та KeyCRM

KeyCRM – український CRM-сервіс з фокусом на торгівлю товарами. Інтеграція ANT-Logistics з KeyCRM дозволяє автоматизувати повністю весь цикл онлайн торгівлі та доставки товарів. Далі ми покажемо як налаштувати обмін даними між сервісами.

Підключення CRM до ANT-Logistics

Зареєструємося у KeyCRM.  Зайдемо у меню Налаштування – Основні та натиснемо Згенерувати АРІ ключ. Скопіюємо ключ в буфер обміну.

Далі виконаємо налаштування в Мурашиній логістиці: Сервіс – Параметри – Обмін та Повідомлення 1.  У полі Тип сервера 2 виберемо KeyCRM та натиснемо кнопку Налаштування 3. У вікні Додаткові параметри 4 заповнимо поля:

• Ключ доступа – ключ доступа, згенерований у KeyCRM;
• Фільтр: Статуси – фільтр, згідно якого у сервіс передаються заявки тільки з вказаним статусом. Якщо фільтрів статусів декілька, необхідно вказати їх через крапку з комою (наприклад: «НОВИЙ;ПЕРЕДАНО В ДОСТАВКУ»). За необхідності завантажувати всі заявки незалежно від їх статусу, залишаємо поле пустим. Назви статусів вказуються так, як вони зазначені в KeyCRM:

Натиснемо Перевірити з’єднання 5 – висвітиться інформація про успішність дії. Збережемо зміни ОК.

Для інтеграції з CRM у меню Сервіс – Параметри - Облік у полі Тип співставлення кодів ТТ встановлюємо значення: текстовий.

Налаштування відповідностей полів KeyCRM та ANT-Logistics

Для завантаження замовлень у ANT-Logistics виберемо необхідну дату, натиснемо Імпорт заявок та підтвердимо дію ОК. На вибрану дату імпортуються всі замовлення з необхідним статусом (в нашому прикладі – зі статусом ПЕРЕДАНО В ДОСТАВКУ):

Під час імпорту автоматично передаються такі поля з KeyCRM:

• Номер замовлення – в поле Номер заявки;
• Покупець – в поле Назва;
• Адреса доставки (всі поля з адресою) – в поле Адреса*;
• Коментар менеджера та Коментар клієнта – в поле Примітки через крапку з комою (за необхідності їх можна імпортувати в окремі поля – див. опис нижче);
• Загальна вартість – в поле Прибуток;
• Також імпортуються товари, їх кількість та ціни.

Якщо в KeyCRM використовується декілька адрес для одного покупця, то необхідно окремо прописати наступну відповідність полів у Налаштуванні таблиць (Довідник  – Торгові точки – Код стр – Редагування запису – Сторонні CRM – CRM Поле):

В такому випадку для кожного нового замовлення буде створюватися нова торгова точка з кодом, який відповідає номеру замовлення.

*В поле Адреса в ANT-Logistics автоматично імпортуються всі поля, які включає Адреса покупця в KeyCRM:

• Адреса (shipping.shippingreceivepoint)
• Додаткова адреса (Shipping.ShippingSecondaryLine)
• Місто (Shipping.shippingAddressCity)
• Область/Штат (shipping.shippingaddressregion)
• Поштовий індекс – (shipping.shippingaddresszip)
• Країна (shipping.shippingaddresscountry).

Але часто ці поля містять зайву для імпорту інформацію. Наприклад, у поле Додаткова адреса може зазначатися номер квартири покупця – ця інформація буде заважати геокодуванню адрес в ANT-Logistics. В такому випадку вказуємо вручну, які саме поля необхідно імпортувати в поле Адреса в ANT-Logistics – вносимо відповідності полів у Налаштуванні таблиць (Довідник  – Торгові точки – Адреса – Редагування запису – Сторонні CRM – CRM Поле), використовуючи Формули бібліотеки. В нашому випадку вносимо Область/Штат, Місто, Адреса: CONCAT([shipping.shippingaddressregion], " ", [Shipping.shippingAddressCity], " ", [shipping.shippingreceivepoint]):

Також за допомогою відповідностей полів у Довіднику Налаштування таблиць можемо вручну налаштувати імпорт інформації з будь-яких інших полів KeyCRM. Для цього можна використати у ANT-Logistics Поля користувача або будь-які інші поля, що відповідають необхідним вимогам типу даних (строка, дата, телефон тощо).

Приклади найбільш використовуваних полів:

• Телефон покупця (buyer.phone);
• E-mail покупця (buyer.email);
• Коментар менеджера (managercomment);
• Коментар покупця (buyercomment);
• Загальна вартість (grandTotal).

Більше про API KeyCRM можна знайти в KeyCRM OpenAPI documentation.

Якщо Вас зацікавив описаний функціонал – ми готові продемонструвати його роботу, виконати необхідні налаштування та надати доступ до сервісу. Для цього залиште заявку на сайті Мурашина логістика.

Увага! Для зворотного зв'язку користувачів ANT-Logistics запрошуємо залишати коментарі безпосередньо із інтерфейсу сервісу.