Изменения

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

Тест

444 байта убрано, 15:27, 16 декабря 2021
м
Нет описания правки
= Интеграция со сторонними системами =
= Отказ от ответственности =
Интеграции со сторонними системами делаются в соответствии с документацией на момент написания, без партнерства с компаниями-поставщиками сервиса. Об изменениях API нас не оповещают, поэтому интеграции по не зависящим от нас причинам могут переставать работать, работать нестабильно или некорректно, вплоть до потери важной информации. Заказы, переданные во внешние системы, нужно обязательно проверять на корректность, пользуясь личным кабинетом партнера. По интеграции уходят только новые заказы, созданные в день настройки интеграции.
Рассматривается интеграция с системами сторонних компаний (агентов), где система MeaSoft выступает клиентом, то есть передает заказы и получает обратно статусы.
 
=== Общие правила настройки интеграции ===
Компания-пользователь MeaSoft должна иметь аккаунт и личный кабинет в системе MeaSoft. Подробнее см. раздел [[Личный кабинет курьерской службы#Подключение|«Личный кабинет курьерской службы»]].
Для стабильной работы необходимо наличие у клиента системы MeaSoft версии минимум 518 от 05.12.2014.
 
==Сквозная интеграция==
Если устанавливается интеграция между [[API#Готовые интеграции|CMS- или CRM-системой]] и подрядчиком [[#Тарификация и выбор подрядчика и его тарифа клиентом|из таблицы]], при авторизации в [[Личный кабинет клиента|личном кабинете клиента]] укажите код клиентской службы подрядчика (столбец «Код экстра»).
=== СДЭК ===
* код курьерской службы — 90017.
== Тарификация и выбор подрядчика и его тарифа клиентом Сквозная интеграция==Вы можете настроить подключение своего тарифа к тарифу партнера — любой компании, работающей в системе MeaSoft, а также ряду компаний, с которыми у нас есть интеграции.
=== Настройка интеграции ===Чтобы настроить подключение к тарифу партнера:# Зарегистрируйтесь в системе Сквозная интеграция предполагает передачу тарифов подрядчика. Данные аккаунта понадобятся для настройки интеграции.# Откройте '''Справочники''' > '''Статусы''' > '''17 Виды срочности''' и создайте вид срочности, например «СДЭК».# В контекстном меню вида срочности выберите пункт '''Дополнительная информация''' и во второй строке заполните параметры подключения к партнеру через запятую:#* 1-й параметр — код филиала партнера, его можно посмотреть в '''Справочники''' > '''Межгород''' > '''Филиалы'''. Можно в одинарных кавычках указать несколько ответственных филиалов через запятую, тогда режим срочности будет доступен для всех перечисленных филиалов. Для версии системы 2021.0.0.38 и выше вместо кода филиала можно указать знак вопроса (?), это обозначит доступность режима срочности для всех филиалов;#* 2-й параметр — экстра-код партнера в системе MeaSoft. Коды для сторонних компаний приведены в таблице ниже;#* 3-й параметр — имя пользователя в системе партнера. Может отличаться от того, под которым работает интеграция, здесь нужно для расчета цены для клиента. В таблице ниже указано, что вводить для каждого интегратора;#* 4-й параметр — пароль пользователя из 3-го параметра. В таблице ниже указано, что вводить для каждого интегратора;#* 5-й параметр — вид срочности партнера. Посмотреть доступные коды видов срочности можно по ссылке в таблице ниже, в калькуляторе в выпадающем списке. Можно в одинарных кавычках указать несколько видов срочности через запятую, тогда система будет стараться выбрать из них первый доступный;#* 6-й параметр — наценка к цене, передаваемой подрядчиком. В деньгах или в процентах, если стоит знак процента. Например, 10 — наценка 10 рублей, 10 % — наценка 10 процентов;#* 7-й параметр — если указать значение '''1''', сквозная тарификация выключена. Параметр используется, если подключение нужно только для передачи заказов по интеграции, а расчет цены не нужен;#* 8-й параметр — если указать значение '''1''', среди указанных режимов срочности партнера выполняется поиск самого дешевого тарифа. Пока работает только для СДЭК.# Нажмите на кнопку '''OK'''при создании заказа.
{|class="wikitable"!Чтобы настроить сквозную тарификацию между [[#Интеграция!Код экстра!Виды срочности!Авторизация!Пример строки|с CMS-|БОКСБЕРРИ||90001||https://home.courierexe.ru/90001/calculator|системами |Введите токен в 4CMS-й параметр. 3или CRM-й можно оставить пустым. Можно оба оставить пустыми для расчета базовых цен.||33, 90001,, j3ejwo2f10b2e47790174b41f4a11111, 2, 50|-|ПИКПОИНТ||90002||https://home.courierexe.ru/90002/calculator||3-й параметр — логин, 4-й — через запятую пароль системой]] и подрядчиком [[#Тарификация и выбор подрядчика и договор ИКН. Можно оставить пустыми, но цены будут не все.его тарифа клиентом||33, 90002,us0111, '6rGGuqRsW2qNQ,9990721312', 2, 50|-|rowspan="2"|СДЭК<br>(протокол обмена данными 1.5)||rowspan="2"|90005||rowspan="2"|httpsиз таблицы]]://home.courierexe.ru/90005/calculator||Введите код учетной записи в 3-й параметр, секретный код — в 4-й. Можно оба оставить пустыми для расчета базовых цен.||45491, 90005, hfenJwlasiPr4pnFENpaVXSKPIn5Trh7i, '9vkQgWuiZgEj9fGCB8a6Xj3desnJkwsl,1.5', 5, 30 %|-||Если вы хотите добавить в расчет тарифа процент за наложенный платеж# Курьерская служба, после пароля добавьте запятую и число процента. В настройке режима срочности пароль с числом процентов заключите в кавычки.||9vkQgWuiZgEj9fGCB8a6Xj3desnJkwsкоторой сотрудничает ИМ,1.5|-|КСЭ||90008||https://home.courierexe.ru/90008/calculator||Введите логин в 3-й параметр, пароль — в 4-й. Пустыми оставить нельзя.||12504, 90008, Рога и копыта, 4CCB11864D06157, '2, 3, 6', 10 %|-|ПОЧТА РОССИИ||90010||https://home.courierexe.ru/90010/calculator||Без авторизации||10497, 90010,,, '2, 1', 10 <!--10497, 90010, 89251234567, 'mypassword, u23B0r9AAJ1Fyh4ptMzJ3kjxcslamwdx', '2, 1', 10-->|-|rowspan="3"|DPD||rowspan="3"|90011||rowspan="3"|https://home.courierexe.ru/90011/calculator||Введите клиентский номер в 3-й параметр, клиентский ключ в 4-й. Можно оставить пустыми настраивает режим срочности для базовых тарифовподрядчика.||12504, 90011, 1019003662, '4CCB11864D06157A5934A9119F2A0AAAAAB4CCE8,D117', '3, 6', 10 %|-||Если вы доставляете товар в пункт отправления самостоятельно, после пароля добавьте запятую и код ПВЗ, а в настройке режима срочности введите пароль # ИМ оформляет заказы в кавычках.||'4CCB11864D06157A5934A9119F2A0AAAAAB4CCE8,D117'|-|-[[Личный кабинет клиента|colspan="2"|ВНИМАНИЕ! У DPD есть 2 калькулятора, которые считают по-разному при одних и тех же вводных данных. При этом они не разглашают, по какому из расчетов определяют цену. Поэтому по не зависящим от нас причинам расчет по тарифам DPD может как совпасть с итоговым, так личном кабинете клиента]] и сильно разойтись. Если вас это не устраивает, не используйте сквозную тарификацию с этим подрядчиком.|-|DOSTAVKAвыбирает указанный режим.GURU||90017||https://home.courierexe.ru/90017/calculator||3-й параметр — ID партнера в системе DOSTAVKA.guru, 4-й — ключ доступа. Также можно указать признак отключения проверки интервала доставки. В этом случае необходимо указать ключ и «1» через запятую в кавычках. Можно оставить пустыми.||10497, 90017, 9999, 'cc03e747a6afbbcbf8be7668acfebee5,1', '1', 100|-|5Post||90020||https://home.courierexe.ru/90020/calculator||3-й параметр — API-ключ, 4-й — уникальный номер партнера в системе 5post. При необходимости в 4-м параметре можно через запятую указать пороговое значение веса (по умолчанию 3 кг). Пустыми оставить нельзя. Для вашего аккаунта в API 5post должна быть подключена возможность получать ПВЗ с вашими тарифами.||10497, 90020, u23B0r9AAJ1Fyh4ptMzJ3kjxcslamwdx, 1, 100|-|GTD||90021||https://home.courierexe.ru/90021/calculator||3-й параметр — API-ключ, 4-й — пароль от личного кабинета https://home.courierexe.ru/90021. Предварительная авторизация по указанному URL обязательна.||10497, 90021, u23B0r9AAJ1Fyh4654MzJ3kjx1548wdx, pass, 100|}
При выборе клиентом в личном кабинете вида срочности, подключенного таким образом к партнеру, набор доступных ПВЗ будет ограничен выбранным партнером. Вы можете войти в личный кабинет по адресу вида https://home.courierexe.ru/XXX, где XXX — экстра-код партнера, авторизоваться данными из 3-го и 4-го параметров (см. таблицу выше) и воспользоваться калькулятором с тарифами именно вашей компании. === Настройка стоимости доставки для получателя ===При интеграции с подрядчиками, перечисленными в таблице выше, вы можете настроить стоимость и срок доставки, отображаемые для получателя:# Перейдите в личный кабинет по адресу вида https://home.courierexe.ru/XXX, где XXX — экстра-код партнера, и авторизуйтесь данными из 3-го и 4-го параметров (см. таблицу выше).# Откройте пункт основного меню '''Цена доставки для получателя''' и настройте правила расчета цены и сроков доставки. Подробнее см. раздел «[[Личный кабинет клиента#Цена доставки для получателя|Цена доставки для получателя]]». == Интеграция с CMS-системами (получение заказов) == == Готовые интеграции == Для работы с популярными CMS и CRM-системами разработаны модули интеграции, перечисленные в таблице ниже.
'''Модули распространяются бесплатно, без гарантий со стороны разработчика''', и не являются средством полной автоматизации взаимодействия с курьерской службой. Модули — это помощь разработчикам интернет-магазинов в построении интеграции с курьерскими службами. '''Ответственность за корректность передачи данных лежит на интернет-магазине.'''
|[[Файл:bitrix.png|center|x44px]]
|style="text-align: center;" | [https://marketplace.1c-bitrix.ru/solutions/measoft.courier/ Установить] <!--[https://courierexe.ru/download/api/measoft.courier.zip Скачать] -->
|Поддерживает версии 14.5 и выше. Подробнее см. [[1C-Битрикс|описаниеИнструкция по настройке]].
|-
|[[Файл:prestashop.png|center|x60px]]
|[[Файл:OpencartOCStore.png|center|x60px]]
|style="text-align: center;"|[https://courierexe.ru/download/api/opencart.zip Скачать для версии 1.5.5.1]<br>[https://courierexe.ru/download/api/measoft_oc2.ocmod.zip Скачать для версии 2.0]<br>[https://courierexe.ru/download/api/measoft_oc2.3.ocmod.zip Скачать для версии 2.3]<br>[https://courierexe.ru/download/api/measoft_ос3.ocmod.zip Скачать для версии 3.0]
|Поддерживает версии с 1.5.5.1.<br>Скачивайте модули для своей версии OpenCart.<br>Подробнее см. [[OpenCart|описаниеИнструкция по настройке]].<br>[https://opencartforum.com/files/file/2906-avtomatizaciya-otpravki-i-otslezhivanie-dostavok-courierexe-dlya-opencart-15x/ Альтернативный модуль сторонних разработчиков]
|-
|[[Файл:webasyst-shopscript.png|center|x44px]]
|[[Файл:Retailcrm.png|center|x30px]]
|style="text-align: center;"|[https://www.retailcrm.ru/ RetailCRM]
|[[RetailCRM|НастраиваетсяИнструкция по настройке]] в ЛК пользователя в системе
|-
|[[Файл:1C.jpg|center|x44px]]
|[[Файл:Amocrm.png|center|x44px]]
|style="text-align: center;"|[https://www.amocrm.ru/extensions/courier2008 Установить]
|Подробнее см. [[amoCRM|описаниеИнструкция по настройке]].
|-
|rowspan="2"|[[Файл:MoySclad.jpg|center|x30px]]
|style="height:50px; text-align: center;"|[https://home.courierexe.ru/moysklad/step1 Настроить интеграцию с MeaSoft]
|[[МойСклад|Инструкцияпо настройке]]
|-
|style="height:50px; text-align: center;"|[https://itmdev.ru/ms/shipping/ Скачать модуль сторонних разработчиков]
|[[Файл:wordpress.jpg|center|x80px]]
|style="text-align: center;"|[https://courierexe.ru/download/api/wordpress.zip Скачать]
|[[Wordpress|Инструкцияпо настройке]]
|-
|[[Файл:Cscart.png|center|x60px]]
|style="text-align: center;"|[https://marketplace.cs-cart.com/measoft-en.html Установить]
|Поддерживает версии 4.10 и выше.<br>[[CS-Cart|Инструкцияпо настройке]]
|-
|}
 
 
'''Обратите внимание!''' В модулях систем PrestaShop и Joomla для отправки заказа в курьерскую службу зайдите в карточку заказа. В карточке отображается специальная форма отправки заказа, а если заказ отправлен, она позволяет проверить его статус:[[Файл:Form.png|400 px|Форма отправки заказа|none]]
 
Для отображения списка пунктов выдачи есть [https://home.courierexe.ru/js/measoft_map.js JavaScript модуль]. Инструкция по использованию — внутри. Посмотреть пример работы можно [https://home.courierexe.ru/pvz_test.html здесь].
 
=== Замечания ===
# В модулях систем PrestaShop и Joomla для отправки заказа в курьерскую службу зайдите в карточку заказа. В карточке отображается специальная форма отправки заказа, а если заказ отправлен, она позволяет проверить его статус:[[Файл:Form.png|400 px|Форма отправки заказа|none]]
# Оформление заказов до '''ПВЗ''' в модулях '''PrestaShop''' и '''Joomla''' не реализовано. Чтобы оформить такой заказ, в поле передаваемого адреса укажите одно из значений:
#* код ПВЗ, который можно посмотреть в ЛК клиента или на сайте агента (Boxberry, CDEK и т. п.). Обычно это цифровой или цифро-буквенный код;
#* наименование ПВЗ, добавив в начале строку "ПВЗ ", например '''ПВЗ На Ленина'''.
# Поддерживается передача маркировки «[[Маркировка|Честный ЗНАК]]» из InSales и RetailCRM. Информацию по настройке см. в документации [https://www.insales.ru/collection/doc-zprochee/product/prodazha-tovarov-s-markirovkoy-487-fz Insales] и [https://help.retailcrm.ru/Users/MarkingOfGoods RetailCRM].
# Для отображения списка пунктов выдачи есть [https://home.courierexe.ru/js/measoft_map.js JavaScript модуль]. Инструкция по использованию — внутри. Посмотреть пример работы можно [https://home.courierexe.ru/pvz_test.html здесь].
# При проблемах с отображением карты в модулях очистите кэш браузера: например, для Google Chrome нажмите CTRL+F5. Введенные данные потеряны не будут, карта после этого отобразится корректно.
 
=== OpenCart ===
[[OpenCart]]
 
=== 1C-Битрикс ===
[[1C-Битрикс]]
 
=== InSales ===
[[InSales]]
 
=== RetailCRM ===
См. раздел «[[RetailCRM]]».
 
=== CS-Cart ===
[[CS-Cart]]
 
=== amoCRM ===
[[amoCRM]]
=== Беру ===
При интеграции поддерживается:
* Обработка координат.
 
=== МойСклад ===
[[МойСклад]]
 
=== LeadVertex ===
[[LeadVertex]]
 
=== Wordpress ===
[[Wordpress]]
=== Проверка работоспособности интеграций ===
Ошибка при создании заказа отображается в левом нижнем углу.
 
== Тарификация и выбор подрядчика и его тарифа клиентом ==
Вы можете настроить подключение своего тарифа к тарифу партнера — любой компании, работающей в системе MeaSoft, а также ряду компаний, с которыми у нас есть интеграции.
 
=== Настройка интеграции ===
Чтобы настроить подключение к тарифу партнера:
# Зарегистрируйтесь в системе подрядчика. Данные аккаунта понадобятся для настройки интеграции.
# Откройте '''Справочники''' > '''Статусы''' > '''17 Виды срочности''' и создайте вид срочности, например «СДЭК».
# В контекстном меню вида срочности выберите пункт '''Дополнительная информация''' и во второй строке заполните параметры подключения к партнеру через запятую:
#* 1-й параметр — код филиала партнера, его можно посмотреть в '''Справочники''' > '''Межгород''' > '''Филиалы'''. Можно в одинарных кавычках указать несколько ответственных филиалов через запятую, тогда режим срочности будет доступен для всех перечисленных филиалов. Для версии системы 2021.0.0.38 и выше вместо кода филиала можно указать знак вопроса (?), это обозначит доступность режима срочности для всех филиалов;
#* 2-й параметр — экстра-код партнера в системе MeaSoft. Коды для сторонних компаний приведены в таблице ниже;
#* 3-й параметр — имя пользователя в системе партнера. Может отличаться от того, под которым работает интеграция, здесь нужно для расчета цены для клиента. В таблице ниже указано, что вводить для каждого интегратора;
#* 4-й параметр — пароль пользователя из 3-го параметра. В таблице ниже указано, что вводить для каждого интегратора;
#* 5-й параметр — вид срочности партнера. Посмотреть доступные коды видов срочности можно по ссылке в таблице ниже, в калькуляторе в выпадающем списке. Можно в одинарных кавычках указать несколько видов срочности через запятую, тогда система будет стараться выбрать из них первый доступный;
#* 6-й параметр — наценка к цене, передаваемой подрядчиком. В деньгах или в процентах, если стоит знак процента. Например, 10 — наценка 10 рублей, 10 % — наценка 10 процентов;
#* 7-й параметр — если указать значение '''1''', сквозная тарификация выключена. Параметр используется, если подключение нужно только для передачи заказов по интеграции, а расчет цены не нужен;
#* 8-й параметр — если указать значение '''1''', среди указанных режимов срочности партнера выполняется поиск самого дешевого тарифа. Пока работает только для СДЭК.
# Нажмите на кнопку '''OK'''.
 
{|class="wikitable"
!Интеграция
!Код экстра
!Виды срочности
!Авторизация
!Пример строки
|-
|БОКСБЕРРИ||90001||https://home.courierexe.ru/90001/calculator||Введите токен в 4-й параметр. 3-й можно оставить пустым. Можно оба оставить пустыми для расчета базовых цен.||33, 90001,, j3ejwo2f10b2e47790174b41f4a11111, 2, 50
|-
|ПИКПОИНТ||90002||https://home.courierexe.ru/90002/calculator||3-й параметр — логин, 4-й — через запятую пароль и договор ИКН. Можно оставить пустыми, но цены будут не все.||33, 90002,us0111, '6rGGuqRsW2qNQ,9990721312', 2, 50
|-
|rowspan="2"|СДЭК<br>(протокол обмена данными 1.5)||rowspan="2"|90005||rowspan="2"|https://home.courierexe.ru/90005/calculator||Введите код учетной записи в 3-й параметр, секретный код — в 4-й. Можно оба оставить пустыми для расчета базовых цен.||45491, 90005, hfenJwlasiPr4pnFENpaVXSKPIn5Trh7i, '9vkQgWuiZgEj9fGCB8a6Xj3desnJkwsl,1.5', 5, 30 %
|-
||Если вы хотите добавить в расчет тарифа процент за наложенный платеж, после пароля добавьте запятую и число процента. В настройке режима срочности пароль с числом процентов заключите в кавычки.||9vkQgWuiZgEj9fGCB8a6Xj3desnJkws,1.5
|-
|КСЭ||90008||https://home.courierexe.ru/90008/calculator||Введите логин в 3-й параметр, пароль — в 4-й. Пустыми оставить нельзя.||12504, 90008, Рога и копыта, 4CCB11864D06157, '2, 3, 6', 10 %
|-
|ПОЧТА РОССИИ||90010||https://home.courierexe.ru/90010/calculator||Без авторизации||10497, 90010,,, '2, 1', 10 <!--10497, 90010, 89251234567, 'mypassword, u23B0r9AAJ1Fyh4ptMzJ3kjxcslamwdx', '2, 1', 10-->
|-
|rowspan="3"|DPD||rowspan="3"|90011||rowspan="3"|https://home.courierexe.ru/90011/calculator||Введите клиентский номер в 3-й параметр, клиентский ключ в 4-й. Можно оставить пустыми для базовых тарифов.||12504, 90011, 1019003662, '4CCB11864D06157A5934A9119F2A0AAAAAB4CCE8,D117', '3, 6', 10 %
|-
||Если вы доставляете товар в пункт отправления самостоятельно, после пароля добавьте запятую и код ПВЗ, а в настройке режима срочности введите пароль в кавычках.||'4CCB11864D06157A5934A9119F2A0AAAAAB4CCE8,D117'
|-
|-
|colspan="2"|ВНИМАНИЕ! У DPD есть 2 калькулятора, которые считают по-разному при одних и тех же вводных данных. При этом они не разглашают, по какому из расчетов определяют цену. Поэтому по не зависящим от нас причинам расчет по тарифам DPD может как совпасть с итоговым, так и сильно разойтись. Если вас это не устраивает, не используйте сквозную тарификацию с этим подрядчиком.
|-
|DOSTAVKA.GURU||90017||https://home.courierexe.ru/90017/calculator||3-й параметр — ID партнера в системе DOSTAVKA.guru, 4-й — ключ доступа. Также можно указать признак отключения проверки интервала доставки. В этом случае необходимо указать ключ и «1» через запятую в кавычках. Можно оставить пустыми.
||10497, 90017, 9999, 'cc03e747a6afbbcbf8be7668acfebee5,1', '1', 100
|-
|5Post||90020||https://home.courierexe.ru/90020/calculator||3-й параметр — API-ключ, 4-й — уникальный номер партнера в системе 5post. При необходимости в 4-м параметре можно через запятую указать пороговое значение веса (по умолчанию 3 кг). Пустыми оставить нельзя. Для вашего аккаунта в API 5post должна быть подключена возможность получать ПВЗ с вашими тарифами.||10497, 90020, u23B0r9AAJ1Fyh4ptMzJ3kjxcslamwdx, 1, 100
|-
|GTD||90021||https://home.courierexe.ru/90021/calculator||3-й параметр — API-ключ, 4-й — пароль от личного кабинета https://home.courierexe.ru/90021. Предварительная авторизация по указанному URL обязательна.||
10497, 90021, u23B0r9AAJ1Fyh4654MzJ3kjx1548wdx, pass, 100
|}
 
При выборе клиентом в личном кабинете вида срочности, подключенного таким образом к партнеру, набор доступных ПВЗ будет ограничен выбранным партнером.
 
Вы можете войти в личный кабинет по адресу вида https://home.courierexe.ru/XXX, где XXX — экстра-код партнера, авторизоваться данными из 3-го и 4-го параметров (см. таблицу выше) и воспользоваться калькулятором с тарифами именно вашей компании.
 
=== Настройка стоимости доставки для получателя ===
При интеграции с подрядчиками, перечисленными в таблице выше, вы можете настроить стоимость и срок доставки, отображаемые для получателя:
# Перейдите в личный кабинет по адресу вида https://home.courierexe.ru/XXX, где XXX — экстра-код партнера, и авторизуйтесь данными из 3-го и 4-го параметров (см. таблицу выше).
# Откройте пункт основного меню '''Цена доставки для получателя''' и настройте правила расчета цены и сроков доставки. Подробнее см. раздел «[[Личный кабинет клиента#Цена доставки для получателя|Цена доставки для получателя]]».
Источник — «https://wiki.courierexe.ru/index.php/Служебная:Сравнение_версий/13244»

Навигация