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

У цій статті розповідаємо як налаштувати обмін даними з ANT-Logistics

Написано Богдан Починок

Оновлено 1 рік тому

Крок 1. Отримання ключа у KeyCRM

У бічному меню наведіть на піктограму налаштувань та виберіть «Основні». Після цього натисніть «Сгенерувати ключ API» або просто скопіюйте його, якщо він був створений раніше:

Крок 2. Підключення ANT-Logistics

Відкрийте ANT-Logistics у, наведіть «Сервіс» → «Параметри» → «Обмін та Повідомлення»(1).

У полі Тип сервера (2) виберіть KeyCRM і натисніть кнопку Налаштування (3).

У вікні «Додаткові параметри»(4) заповніть поля:

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

Далі натисніть кнопку «Перевірити з'єднання» (5), щоб переконатися, що все налаштовано коректно.

Коли перевірка закінчиться, збережіть зміни, натиснувши на «ОК».

Після цього перейдіть «Сервіс» → «Параметри» → «Облік» і в полі "Тип зіставлення кодів ТТ" встановіть значення - текстовий.

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

Щоб завантажити замовлення в ANT-Logistics, виберіть необхідну дату, натисніть «Імпорт заявок» і підтвердіть дію.

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

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

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

Зверніть увагу! Якщо ви використовуєте кілька адрес для одного покупця, необхідно окремо прописати таку відповідність полів у «Налаштування таблиць».

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

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

адреса (shipping.shippingreceivepoint)
додаткова адреса (Shipping.ShippingSecondaryLine)
місто (Shipping.shippingAddressCity)
область/штат (shipping.shippingaddressregion)
поштовий індекс – (shipping.shippingaddresszip)
країна (shipping.shippingaddresscountry).

Але часто ці поля містять надмірну для імпорту інформацію. Наприклад, у полі Додаткова адреса може вказуватися номер квартири покупця – ця інформація заважатиме геокодуванню адрес в ANT-Logistics.

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

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

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

телефон покупця (buyer.phone);
e-mail покупця (buyer.email);
коментар менеджера (manager comment);
коментар покупця (buyercomment);
загальна вартість (grandTotal).

Теги: муравьиная логистика, мурашина логістика, ant

Чи була наша стаття корисною?