Подключение ANT-Logistics

В этой статье рассказываем как настроить обмен данными с ANT-Logistics

Автор Владислав Пономарь

Обновлено 7 месяцев назад

Шаг 1. Получение ключа в KeyCRM

В боковом меню наведите на значок настроек и выберите «Основные». После чего нажмите «Сгенерировать API ключ» или просто скопируйте его, если он был создан ранее:

Шаг 2. Подключения 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);
комментарий менеджера (managercomment);
комментарий покупателя (buyercomment);
общая стоимость (grandTotal).

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

Оцените эту статью