Обмін даними між 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 запрошуємо залишати коментарі безпосередньо із інтерфейсу сервісу.
Коментарі
Дописати коментар