Изменения

Перейти к: навигация, поиск

Интеграция с другими системами

9116 байт добавлено, 11:51, 7 декабря 2022
Финальные статусы в интеграциях
# Клиент создает в своей системе [[Филиалы|филиал]] для указанного агента. После создания филиала нужно перезагрузить 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 часа в случае возможных сбоев.
== Интеграция с подрядчиками ==
=== Описание процесса интеграции ===
Рассматривается интеграция с системами сторонних компаний (агентов), где система MeaSoft выступает клиентом, то есть передает заказы и получает обратно статусы.
Для стабильной работы необходимо наличие у клиента системы MeaSoft версии минимум 518 от 05.12.2014.
 
==== Последовательность финальных статусов ====
 
Параметр <b>Исправлять ошибки последовательности статусов</b> регулирует возможность исправления ошибочно опубликованных подрядчиком финальных статусов.<br>
Если в параметре интеграции указано "Исправлять", то при получении другого статуса, вслед за финальным, дата доставки заказа будет приводится в состояние соответствующее последнему полученному статусу.
=== СДЭК===
Остальные поля служат для более тонкой настройки создания заказов:
* '''Передавать объявленную стоимостьценность'''. Значение по умолчанию '''Да''', вы можете изменить егоэто, выбрав одно из значений:** "Да"<br><span style="padding-left: 5px;">Оценочная стоимость формируется по принципу наибольшего значения. Если укажете '''</span><br><span style="padding-left: 5px;">Учитываются Оценочная стоимость всего заказа, Оценочная стоимость товарных вложений, цена товарных вложений.</span><br>** "Нет''', "<br><span style="padding-left: 5px;">объявленная ценность товарных вложений передаваться не будет</span><br>** "Передавать, если указана"<br><span style="padding-left: 5px;">Учитываются только суммы из полей Оценочная стоимость заказа и Оценочная стоимость товарных вложений, где в приоритете Оценочная стоимость заказа.</span>
* '''Добавлять услугу «Осмотр вложений»'''. Тарифицируемая услуга от СДЭК, поэтому она добавится, только если в настройках указано '''Да''';
* '''Процент за наложенный платеж'''. Используется при получении агентской цены. Калькулятор API CDEK не включает в расчет сумму за наложенный платеж автоматически, но мы добавим указанный вами процент в итоговую сумму;
=== DPD ===
Статусы заказов передаются корректно, только если для <div style="color: #a94442; background-color: #f2dede; border: 1px solid #ebccd1; padding: 3px 10px 10px;"><b>Внимание!</b><br> Для одного аккаунта DPD может быть настроена только одна интеграция. <br>Если вам требуется настроить интеграцию для нескольких филиалов, предварительно создавайте новый аккаунт DPD для каждой интеграции.</div>Статусы заказов передаются корректно, только если для одного аккаунта DPD настроена одна интеграция. <br>При выборе тарифа для отправки заказа приоритет отдается тарифам режима срочности, выбранного в заказе. Для настройки интеграции с платформой DPD укажите следующие параметры:* '''Клиентский номер''' - уникальный клиентский номер в системе DPD.* '''Клиентский ключ''' - ключ для авторизации, полученный у сотрудника DPD.* '''Код пункта самопривоза''' - не обязательный параметр. код пункта самовывоза, куда клиент DPD доставляет заказ для отправки.* '''Номер регулярного заказа''' - номер регулярного заказа DPD. Если вы используете доставку на регулярной основе, уточните этот номер у своего менеджера.* '''Проверка комплектности''' - по умолчанию отсутствует. Есть возможность выбрать одно из значений:
При выборе тарифа для отправки заказа приоритет отдается тарифам режима срочности, выбранного в заказе.<ul><ol><span style="color: blue; margin-right: 10px;">○</span>Отсутствует</ol><ol><span style="color: blue; margin-right: 10px;">○</span>С примеркой</ol><ol><span style="color: blue; margin-right: 10px;">○</span>Простая</ol><ol><span style="color: blue; margin-right: 10px;">○</span>С проверкой работоспособности</ol></ul>
=== TopDelivery ===
<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>
Обратите внимание, что в зависимости от настроек вашего аккаунта в Л-Пост может быть недоступна частичная оплата заказа.
 
=== 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-го параметров (см. таблицу ниже) [[#Тарификация и выбор подрядчика и его тарифа клиентом|Тарификация и выбор подрядчика и его тарифа клиентом]].* настройте [[Виды срочности|режим срочности]] для подрядчика.
Для сквозной тарификации заказов интернет-магазинов доступны следующие варианты:
||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, 90023, AgAABBDzeAQMAAAPeISvM_9LUkxCijQoFXOH5QE, ‘cfceadaa-4874-438a-999b-dbbafe5326ed,11:00,18:00’, 1, 100
|-
|Л-Пост||90024||https://home.courierexe.ru/90024/calculator||3-й параметр — логин, который требуется создать самостоятельно, для входа в <bi>[https://home.courierexe.ru/90024/ ЛК экстраинтеграции Л-Пост]</bi> <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
|}
98
правок

Навигация