98
правок
Изменения
Финальные статусы в интеграциях
* электронный документооборот — [[Диадок]];
* телефония — телефонный сервер [[Интеграция с телефонией|Asterisk]];
* планирование маршрутов курьеров — [[Яндекс.Маршрутизация]], [[Максоптра]];
* GPS-трекинг автотранспорта — [[Wialon]].
Интеграция может быть двухсторонняя: одна компания заказывает доставку у второй, а вторая — у первой. В этом случае нужно настроить 2 интеграции: в одной нужно рассматривать одну компанию клиентом, вторую — агентом, во второй интеграции — наоборот.
# Обе компании должны иметь аккаунты в системе MeaSoft ('''Справочники''' > '''Дополнительные модули''') и у обеих компаний должен быть установлен флажок '''Личный кабинет''' в окне «Управление дополнительными модулями».
# Агент на вкладке '''Клиенты''' создает карточку клиента в своей системе. На вкладке '''Прочее''' [[Клиенты и партнеры#Прочее|карточки клиента]] указывает логин и пароль для входа в [[личный кабинет]] клиента.
# Агент передает клиенту логин и пароль из предыдущего шага и свой [[Личный кабинет курьерской службы#Подключение|код экстра]] в системе MeaSoft.
# Клиент создает в своей системе [[Филиалы|филиал]] для указанного агента. После создания филиала нужно перезагрузить MeaSoft и подождать 3 минуты.
# Клиент заходит в [[личный кабинет курьерской службы]] и на вкладке '''ИнтеграцииПодрядчики''' в таблице находит созданный филиал.# Клиент в строке подрядчика нажимает на кнопку '''Настроить''' напротив филиала[[Файл:MeaShip_Интеграция.png]], в открывшемся окне выбирает интеграцию «MeaSoft», заполняет поля :<div style="padding-left: 45px; position: relative;">*'''Логин''', '''Пароль''' и '''Код клиента''' учетными данными, полученными в п. 3, указывает остальные настройки *<b>Тип оплаты</b> - позволяет управлять логикой обработки типа оплаты в данных передаваемого по интеграции заказа. Доступные варианты:**Адаптируется в соответствии с данными заказа<br><span style="padding-left: 10px;">При отсутствии наложенного платежа передается <b>No</b>, иначе при необходимости и нажимает '''Сохранить'''.типе оплаты картой <b>CARD</b>, во всех остальных случая <b>CASH</b></span>**Оригинальный<br><span style="padding-left: 10px;">В этом случае, тип оплаты заказа передается без изменений</span><br>
<i>Группа параметров, отвечающая за разделение заказов по потокам с разной авторизацией:</i>
* '''Логин для заказов без чека''' и '''Пароль для заказов без чека'''
* '''Определять заказы без чека по признаку''' - "Печатать чек - в карточке клиента" или "Спрашивать тип оплаты у получателя - в карточке клиента"
В интеграции Measoft существует возможность отправлять заказы, распределяя их 2-м разными клиентами по принципу необходимости чека.
Для этого в интеграции Measoft нужно заполнить параметры "Логин для заказов без чека" и "Пароль для заказов без чека"<br>
Заказы, которые созданы клиентом '''с настройкой необходимости чека''' будут отправляться с авторизацией указанной в параметрах: <i style="color: #740474;">"Логин"</i> и <i style="color: #740474;">"Пароль"</i><br>
Заказы, которым '''чек не требуется''' будут отправляться с авторизацией <i style="color: #740474;">"Логин для заказов без чека"</i> и <i style="color: #740474;">"Пароль для заказов без чека"</i><br>
Далее, клиент указывает остальные настройки при необходимости и нажимает '''Сохранить'''.
</div>
В результате отправления, у которых клиент укажет филиал агента в качестве ответственного филиала, будут переданы в систему MeaSoft агента, и статусы будут передаваться обратно. Правильный способ отправки заказов — через [[Манифесты|манифест]], который нужно скомплектовать и проставить дату отправки. На передачу данных может уходить до 10 минут в штатном режиме и до 1 часа в случае возможных сбоев.
При передаче заказов, у которых плановая дата доставки меньше ближайшей возможной, дата доставки автоматически меняется на самую раннюю возможную.</div>
Для стабильной работы необходимо наличие версии MeaSoft минимум 518 от 05.12.2014 у обеих компаний. Для одного клиента может быть настроена только одна интеграция с агентом. ==Распределение заказов по признаку необходимости чека== Вы может распределять заказы по двум разным клиентам по принципу необходимости чека. Для этого агент создает в своей системе второго клиента для вашей компании, в карточке клиента на вкладке '''Прочее''' указывает логин и пароль, которые передает вам. В настройке интеграции Measoft (пункт 6 инструкции выше) заполните поля '''Логин для заказов без чека''' и '''Пароль для заказов без чека''' и выберите признак, по которому определяется необходимость чека, в поле '''Определять заказы без чека по признаку'''. Заказы, созданные клиентом, которому нужен чек, будут отправляться с авторизацией, указанной в полях '''Логин''' и '''Пароль'''. Заказы, которым чек не требуется, будут отправляться с авторизацией '''Логин для заказов без чека''' и '''Пароль для заказов без чека'''.
= Интеграция со сторонними системами =
== Интеграция с подрядчиками ==
=== Описание процесса интеграции ===
Рассматривается интеграция с системами сторонних компаний (агентов), где система MeaSoft выступает клиентом, то есть передает заказы и получает обратно статусы.
Для стабильной работы необходимо наличие у клиента системы MeaSoft версии минимум 518 от 05.12.2014.
==== Последовательность финальных статусов ====
Параметр <b>Исправлять ошибки последовательности статусов</b> регулирует возможность исправления ошибочно опубликованных подрядчиком финальных статусов.<br>
Если в параметре интеграции указано "Исправлять", то при получении другого статуса, вслед за финальным, дата доставки заказа будет приводится в состояние соответствующее последнему полученному статусу.
=== СДЭК===
* '''Ключ клиента '''
* '''Код пункта приема '''
Это обязательные поля. Заказы отправляются в СДЭК при условии правильного корректного заполнения этих данных.
* '''Добавлять услугу «Осмотр вложений»'''. Тарифицируемая услуга от СДЭК, поэтому она добавится, только если в настройках указано '''Да''';
* '''Процент за наложенный платеж'''. Используется при получении агентской цены. Калькулятор api cdek API CDEK не включает в расчет сумму за наложенный платеж автоматически, но мы добавим указанный вами процент в итоговую сумму;
* '''Использовать как номер'''. Номер заказа отображается в личном кабинете и отчетах СДЭК. Выберите удобный вариант: '''Шифр''' или '''Штрихкод''';
* '''Код курьера'''. Укажите код курьера, который будет указан в поле '''Вручил курьер''' для доставленных заказов.
<div style="color: #a94442; background-color: #f2dede; border: 1px solid #ebccd1; padding: 3px 10px 10px;">
Интеграция СДЭК версии 2.0 не предусматривает автоматическую отправку заказа после получения ошибки. Чтобы отправить заказ повторно после исправления, обратитесь в техподдержку MeaSoft.</div>
При выборе тарифа для отправки заказа приоритет отдается тарифам режима срочности, выбранного в заказе. Если в режиме срочности не настроены тарифы, то тариф выбирается из списка в параметре интеграции '''Приоритет тарифов'''. В этом случае отправка в СДЭК осуществляется первым доступным тарифом из списка.
В общем случае интеграция не поддерживает отправки в другие страны, кроме России.
[http://courierexe.ru/download/userfunc/SDEK_report_load.xml Загрузка отчета СДЭК] создает входящий АПД по отчету СДЭК [http://courierexe.ru/download/userfunc/SDEK_report_demo.xls такого формата]. Работает начиная с версии 626 от 29.01.2016 и только при передаче заказов в СДЭК с помощью штатной интеграции. Заполняет поле '''Агентская цена''' в карточке корреспонденции на вкладке '''Межгород'''.
=== DPD ===
=== TopDelivery ===
Для настройки интеграции с платформой TopDelivery укажите:
* '''Логин'''
* '''Пароль'''
* '''Информация о поставщике товара'''. Если указано '''Отправлять''', то при отправке заказа будет предпринята попытка отправить место с габаритами и товарами с указанием данных поставщика: ИНН, наименование, номер телефона. Если данных поставщика нет, информация об ошибке отправки мест будет добавлена в сообщение к заказу. Информация о поставщике повторно не отправляется.
* '''Вскрытие отправления до получения оплаты''' - по умолчанию разрешено.<br>
Возможность запрета вскрытия отправления добавляется при отправке заказа, если в настройках интеграции разрешен запрет и в заказе стоит отметка "Принято на склад"
[[Файлы для загрузки#.D0.9F.D0.B5.D1.87.D0.B0.D1.82.D0.BD.D1.8B.D0.B5 .D1.84.D0.BE.D1.80.D0.BC.D1.8B .D0.B4.D0.BB.D1.8F .D0.BC.D0.B0.D0.BD.D0.B8.D1.84.D0.B5.D1.81.D1.82.D0.BE.D0.B2|Печать наклеек для TopDelivery]]
=== КСЭ ===
Для обращения к функциям системы необходимо знать своё имя пользователя и пароль в системе КСЭ.<br> Если у вас еще нет доступа, то необходимо обратится к Вашему менеджеру в подразделение клиентского сервиса КСЭ.<br> <b>Настройки интеграции:</b><br>* '''Логин''' - логин от ЛК КСЭ* '''Пароль''' - пароль от ЛК КСЭ
* '''Данные отправителя''' — данные, которые будут подставляться во все отправления, передаваемые в КСЭ. Если не указать, то будут передаваться данные заказчика (отправителя) из корреспонденции.
* '''Является ИМ''' — признак отправителя в системе КСЭ. От данного признака зависит главным образом, как отправляются данные в КСЭ. Признак указывается в договоре клиента с КСЭ.
* '''Забор''' — настройка, в которой можно указать, каким образом отправление передается в КСЭ — КСЭ забирает отправление у клиента или клиент сам привозит отправление в КСЭ.
** '''По умолчанию'' - ' — груз будет принят для доставки в офисе (самопривоз в КСЭ) для всех заказов с товарной составляющей, иначе будет послан курьер для забора.** '''До двери'' - ' — будет послан курьер для забора** '''Самопривоз в КСЭ'' - ' — груз будет принят для доставки в офисе
При выборе тарифа для отправки заказа приоритет отдается тарифам режима срочности, выбранного в заказе.
=== DOSTAVKA.GURU ===
'''Настройка'''. Для интеграции введите следующие учетные данные:* '''Идентификатор клиента''' — ID клиента DOSTAVKA.GURU. ID клиента отображается вверху страницы личного кабинета клиента DOSTAVKA.GURU;* '''Ключ клиента''' — запросите API-ключ интеграции у DOSTAVKA.GURU.* '''Регион откуда повезется заказ''' - Доступен выбор из трех вариантов:<ul><ol><span style="color: blue; margin-right: 10px;">○</span> По договору (В этом случае, мы не сообщаем о регионе отправки заказа в систему Guru и регион определяется в договоре договором с DOSTAVKA.GURU )</ol><ol><span style="color: blue; margin-right: 10px;">○</span> Москва</ol><ol><span style="color: blue; margin-right: 10px;">○</span> Санкт-Петербург</ol></ul> '''Запрещенные символы'''. Перед отправкой номер заказа и имя получателя проверяются на наличие запрещенных символов. Если обнаружены запрещенные символы, заказ не передается отправляется в интеграцию и получает ошибку. Из других текстовых полей запрещенные символы удаляются. Это не приводит к получению ошибки. При проверке имени получателя и других текстовых полей используется сокращенный список запрещенных символов. Сокращенный список недопустимых символов для текстовых полей:<code>['~', '`', '@', '#', '$', '%', '^', '&', '=', '+', '!', '"', '№', ';', ':', '?', '\']</code> Полный список недопустимых символов:<code>['~', '`', '@', '#', '$', '%', '^', '&', '=', '+', '!', '"', '№', ';', ':', '?', '\', '\s', '*', '(', '_', '{', '}', '.', ',', '\[', '\]', '\']</code> Кроме того, для штрихкодов недопустима кириллица. '''Статусы'''. Запрашиваются интеграцией в автоматическом режиме. Изменение статуса на стороне Guru изменит и статус заказа в соответствии с картой статусов. '''Агентская цена'''. Обновляется при получении статусов. Агентская цена Guru публикуется в разрезе стоимости услуг и тарифов, которые суммируются перед обновлением агентской цены в заказе. '''Возвраты'''. Учитываются только при получении заказом статуса '''Частичная доставка'''. === 5POST ===Параметры для настройки:* '''API-ключ'''* '''Код склада отправителя'''* '''Уникальный номер партнера в системе 5Post'''* '''Максимальный вес для фиксированного тарифа''' - При привышении установленного веса, сумма тарифа изменяется пропорционально. По умолчанию 3кг.* '''Код подрядчика в карточке заказа''' - доступно три вида отображения кода подрядчика:<ul><ol><span style="color: blue; margin-right: 10px;">○</span> Оригинальный код 5post - Установлено по умолчанию</ol><ol><span style="color: blue; margin-right: 10px;">○</span> Код для поиска заказа в ЛК 5post</ol><ol><span style="color: blue; margin-right: 10px;">○</span> Код грузоместа</ol></ul>* '''Габариты мест'''<ul><ol><span style="color: blue; margin-right: 10px;">○</span> Группировать - Установлено по интеграции.умолчанию</ol><ol><span style="color: blue; margin-right: 10px;">○</span> Отправлять указанные</ol></ul> * '''Тип расчета тарифа'''<ul><ol><span style="color: blue; margin-right: 10px;">○</span> Общий - Установлено по умолчанию</ol><ol><span style="color: blue; margin-right: 10px;">○</span> По местам</ol></ul>
=== Яндекс.Доставка ===
Для подключения к интеграции в вашем договоре с Яндекс.Доставкой должна быть подключена услуга доставки на следующий день. Если у вас эта услуга не подключена, заполните [https://forms.yandex.ru/surveys/10833592.0f3ead3120074ee64cd9dde1df70b27d8d2678d2/ эту форму].
Для настройки интеграции с платформой Яндекс.Логистика Доставка укажите следующие параметры:
*'''Токен''',
*'''ID пункта отправления''',
При отправке заказа обязательно указываются места с габаритами и массой. Если в заказе указаны места, они добавляются как есть. Если мест в заказе нет, то создается одно фиктивное место, габариты которого формируются на основе габаритов вложений. Вложения не разделяются по местам и попадают в первое сформированное место.
=== Л-Пост ===
Для настройки интеграции с платформой Л-Пост укажите следующие параметры:
*'''Секретный ключ клиента''',
*'''Код пункта приема''' - Не обязательный параметр. Заполнять параметр не нужно, если отправления сдаются на центральный склад Л-Пост (Родники, ул.Трудовая, д.10) или забираются со склада партнера силами Л-Пост .<br> В других случаях, в качестве точки приема отправлений могут выступать пункты выдачи заказов Л-Пост и склады Л-Пост.
При отправке заказа обязательно указываются места с габаритами и массой. Если в заказе указаны места, они добавляются как есть. Если мест в заказе нет, то создается одно фиктивное место. Вложения не разделяются по местам и попадают в первое сформированное место.
Обратите внимание, что в зависимости от настроек вашего аккаунта в Л-Пост может быть недоступна частичная оплата заказа.
=== EcomGate ===
Для настройки интеграции с платформой EcomGate укажите следующие параметры:
*'''Логин''' - создается вами для входа в [https://home.courierexe.ru/90025 личный кабинет экстраинтегратора EcomGate],
*'''Токен''' - токен доступа к api EcomGate type-1, выдается техподдержкой EcomGate
*'''Код пункта приема''' - Не обязательный параметр. Заполнять параметр не нужно, если отправления сдаются на ПВЗ EcomGate, тариф <b>"от склада"</b>
==Сквозная интеграция==
Сквозная интеграция предполагает передачу тарифов подрядчика при создании заказа.
Чтобы настроить сквозную интеграцию между [[#Интеграция с CMS-системами |CMS- или CRM-системой]] и подрядчиком [[#Тарификация и выбор подрядчика и его тарифа клиентом|из таблицы]]:* Создайте свой Личный кабинет для экстраинтеграции.<br>Для этого, достаточно единоразово войти в ЛК экстраинтеграции под своим логином и паролем https://home.courierexe.ru/XXX, где XXX — экстра-код партнера.<br><i>Логин</i> и <i>пароль</i>, - это данные из 3-го и 4-го параметров (см. таблицу ниже) [[#Тарификация и выбор подрядчика и его тарифа клиентом|Тарификация и выбор подрядчика и его тарифа клиентом]].* настройте [[Виды срочности|режим срочности ]] для подрядчика.
Для сквозной тарификации заказов интернет-магазинов доступны следующие варианты:
#* 5-й параметр — вид срочности партнера. Посмотреть доступные коды видов срочности можно по ссылке в таблице ниже, в калькуляторе в выпадающем списке. Можно в одинарных кавычках указать несколько видов срочности через запятую, тогда система будет стараться выбрать из них первый доступный;
#* 6-й параметр — наценка к цене, передаваемой подрядчиком. В деньгах или в процентах, если стоит знак процента. Например, 10 — наценка 10 рублей, 10 % — наценка 10 процентов;
#* 7-й параметр — если указать значение '''1''', сквозная тарификация выключена. Параметр используется, если подключение нужно только для передачи заказов по интеграции, а расчет цены не нужен. <br>В этом случае, при визуализации суммы по режиму срочности, отображается внутренний тариф, а подрядчику заказ отправляется другим тарифом, выбранным согласно настройке в 5-м параметре (вид срочности партнера).;#* 8-й параметр — если указать значение '''1''', среди указанных режимов срочности партнера выполняется поиск самого дешевого тарифа. Пока работает только Работает для СДЭКи Почты России.
# Нажмите на кнопку '''OK'''.
||Если вы хотите добавить в расчет тарифа процент за наложенный платеж, после пароля добавьте запятую и число процента. В настройке режима срочности пароль с числом процентов заключите в кавычки.||9vkQgWuiZgEj9fGCB8a6Xj3desnJkws,1.5
|-
|СДЭК<br>(протокол обмена данными 2.0)||90022||https://home.courierexe.ru/90022/calculator||3-й параметр — ID клиента, 4-й — ключ клиента.<br>Вы можете перечислить в пароле уточняющие параметры для расчета через запятую: <br><ul><li>не передавать объявленную ценность, </li><li>добавлять услугу «Осмотр вложений», </li><li>процент за наложенный платеж, </li><li>код пункта приема.</li><li>процент за безналичный наложенный платеж</li></ul><br>Пример пароля:EMscd6r9JnFiQ3bLoyjJY6eM78JrJcee,1,1,2,MSK2,15||10497, 90022, EMscd6r7JnFyQ3bLoyjJY7eM78JrJceI, ‘Mscd6r9JnFiQ3bLoyjJY6eM78JrJcee,1,1,2,MSK2’MSK2,15’, 1, 100
|-
|КСЭ||90008||https://home.courierexe.ru/90008/calculator||Введите логин в 3-й параметр, пароль — в 4-й. Пустыми оставить нельзя.||12504, 90008, Рога и копыта, 4CCB11864D06157, '2, 3, 6', 10%
||10497, 90017, 9999, 'cc03e747a6afbbcbf8be7668acfebee5,1', '1', 100
|-
|5Post||90020||https://home.courierexe.ru/90020/calculator||3-й параметр — API-ключ, <br>4-й — уникальный номер партнера в системе 5post. <br>При необходимости в 4-м параметре можно через запятую указать параметры:<br><ul><li>пороговое значение веса (по умолчанию 3 кг). Пустыми оставить нельзя</li><li>Использовать штрихкод для отслеживания получателем</li><li>Код подрядчика в карточке заказа</li><li>Габариты мест</li><li>Тип расчета тарифа</li></ul><i>При указании параметров важно соблюдать последовательность. </i><br><i>Для вашего аккаунта в API 5post должна быть подключена возможность получать ПВЗ с вашими тарифами.</i><br>Пример пароля: 2123,7,,,,1||10497, 90020, u23B0r9AAJ1Fyh4ptMzJ3kjxcslamwdx, '2123,7,,,,1', '1,3', 100
|-
|GTD||90021||https://home.courierexe.ru/90021/calculator||3-й параметр — API-ключ, 4-й — пароль от личного кабинета https://home.courierexe.ru/90021. Предварительная авторизация по указанному URL обязательна.||
10497, 90021, u23B0r9AAJ1Fyh4654MzJ3kjx1548wdx, pass, 100
|-
|YandexLogisticЯндекс.Доставка||90023||https://home.courierexe.ru/90023/calculator||3-й параметр — токен, <br> 4-й — ID пункта отправления и через запятые интервал доставки.<br>Пример пароля: cfceadaa-4874-438a-999b-dbbafe5326ed,11:00,18:00||
10497, 90023, AgAABBDzeAQMAAAPeISvM_9LUkxCijQoFXOH5QE, ‘cfceadaa-4874-438a-999b-dbbafe5326ed,11:00,18:00’, 1, 100
|-
|Л-Пост||90024||https://home.courierexe.ru/90024/calculator||3-й параметр — логин, который требуется создать самостоятельно, для входа в <i>[https://home.courierexe.ru/90024/ ЛК экстраинтеграции Л-Пост]</i> <br> 4- пароль, как Секретный ключ клиента<br> Дополнительно, есть возможность перечислить в пароле уточняющие параметры для расчета через запятую: <br><ul><li>Признак использования тестовой среды</li><li>Код пункта приема</li></ul><br>Пример пароля: YGNoaR3cG00JYg67,0,1010||
10497, 90024, LoginTest, ‘YGNoaR3cG00JYg67,0,1010’, 1, 100
|-
|EcomGate||90025||https://home.courierexe.ru/90025/calculator||3-й параметр — логин, который требуется создать самостоятельно, для входа в <i>[https://home.courierexe.ru/90025/ ЛК экстраинтеграции EcomGate]</i> <br> 4- пароль, как Токен клиента<br> Дополнительно, есть возможность перечислить в пароле уточняющие параметры для расчета через запятую: <br><ul><li>Код пункта приема отправлений</li><li>Признак использования тестовой среды</li></ul><br>Пример пароля: g67hjtTYjhgf765432,MCK45||
10497, 90025, LoginTest, ‘g67hjtTYjhgf765432,MCK45’, '6,9,10', 100
|}
