123
правки
Изменения
→Пароль в интеграции с CSE
# Агент на вкладке '''Клиенты''' создает карточку клиента в своей системе. На вкладке '''Прочее''' [[Клиенты и партнеры#Прочее|карточки клиента]] указывает логин и пароль для входа в [[личный кабинет]] клиента.
# Агент передает клиенту логин и пароль из предыдущего шага и свой [[Личный кабинет курьерской службы#Подключение|код экстра]] в системе MeaSoft.
# Клиент создает в своей системе [[Филиалы|филиал]] для указанного агента. После создания филиала нужно перезагрузить MeaSoft и подождать 3 минутыдля синхронизации данных.
# Клиент заходит в [[личный кабинет курьерской службы]] и на вкладке '''Подрядчики''' в таблице находит созданный филиал.
# Клиент в строке подрядчика нажимает на кнопку [[Файл:MeaShip_Интеграция.png]], в открывшемся окне выбирает интеграцию «MeaSoft», заполняет поля:
Заказы, которым '''чек не требуется''' будут отправляться с авторизацией <i style="color: #740474;">"Логин для заказов без чека"</i> и <i style="color: #740474;">"Пароль для заказов без чека"</i><br>
* '''Передавать наименование клиента, как отправителя''' - позволяет передавать наименование клиента, как отправителя
* '''Разрешить подрядчику изменять данные получателя''' - при разрешении изменять данные получателя, изменения отразятся в оригинальном заказе. В этом случае заказ необходимо пересчитывать, для актуализации его стоимости.
** ''Не разрешать'' - по умолчанию
** ''Разрешать''
Далее, клиент указывает остальные настройки при необходимости и нажимает '''Сохранить'''.
== Интеграция с 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 Скачать] -->
|Поддерживает версии 1420.5 .0 и выше. Подробнее см. [[1C-Битрикс|Инструкция по настройкеописание]].
|-
|[[Файл:prestashop.png|center|x60px]]
|style="text-align: center;"|[https://courierexe.ru/download/api/prestashop.zip Скачать]
|Поддерживает версии 1.5.2.0 и выше.Инструкция в архиве
|-
|[[Файл: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_oc3.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]]
|style="text-align: center;"|[https://www.webasyst.ru/store/plugin/shop/measoftcourier/ Установить модуль]<br>[https://www.webasyst.ru/store/plugin/shipping/measoftcourier/ Установить плагин]
|Модуль предназначен для отправки заявок в КС, а плагин для расчета стоимости доставки при оформлении заказа.Инструкции в маркете
|-
<!--|[[Файл:advantshop.png|center|x44px]]
|style="text-align: center;"|Настраивается в [[Личный кабинет клиента|ЛК пользователя]]
|[[InSales|Инструкция по настройке]]
|-
|[[Файл:iiko.jpg|center|x80px]]
|style="text-align: center;"|Настраивается в [[Личный кабинет клиента|ЛК пользователя]]
|[[Iiko|Инструкция по настройке]]
|-
|[[Файл:Leadvertex.png|center|x44px]]
|[[Файл:Retailcrm.png|center|x30px]]
|style="text-align: center;"|[https://www.retailcrm.ru/ RetailCRM]
|[[RetailCRM|Инструкция по настройкеНастраивается]]в ЛК пользователя в системе
|-
|[[Файл:1C.jpg|center|x44px]]
|style="text-align: center;"|-
|[https://infostart.ru/public/692790/ Альтернативный модуль сторонних разработчиков(1 версия)] [https://infostart.ru/public/1531484/ Альтернативный модуль сторонних разработчиков (2 версия)]
|-
|[[Файл:Joomla2.jpg|center|x60px]]
|style="text-align: center;"|[https://courierexe.ru/download/api/com_measoft.zip Скачать]
|Работает только с компонентом Virtuemart.Инструкция в архиве
|-
|[[Файл:Amocrm.png|center|x44px]]
|style="text-align: center;"|[https://www.amocrm.ru/extensions/courier2008 Установитьmeasoft Описание на сайте amoCRM]|Подробное описание настроек читайте [[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/apiwordpress/wordpress.zip php Скачать]|[[Wordpress|Инструкция по настройке]]
|-
|[[Файл:Cscart.png|center|x60px]]
|style="text-align: center;"|[https://marketplace.cs-cart.com/measoft-en.html Установить]
|Поддерживает версии 4.10 и выше.<br>[[CS-Cart|Инструкция по настройке]]|-|[[Файл:webhooks.jpg|center|x100px]]|style="text-align: center;"|Читайте описание [[Webhook|на этой странице]]|Передача информации о статусах и заказах в вашу систему|-|[[Файл:Logo_tilda_black.png|center|x100px]]|style="text-align: center;"|Читайте описание [[Tilda|на этой странице]]|Работает только на платных тарифах
|-
|}
=== Замечания ===
Параметр <b>Исправлять ошибки последовательности статусов</b> регулирует возможность исправления ошибочно опубликованных подрядчиком финальных статусов.<br>
Если в параметре интеграции указано "Исправлять", то при получении статуса <b>CANCELED</b>, вслед за финальным, дата доставки заказа будет приводится в состояние соответствующее последнему полученному статусу.
=== Boxberry ===
* '''Токен'''
* '''Код пункта приема''' по умолчанию 010
* '''Не формировать акты автоматически'''
* '''Разрешить вскрывать отправления'''
** '''Без вскрытия отправления''' - вид выдачи отправления на стороне Boxberry 0 - без вскрытия
** '''Со вскрытием отправления''' - вид выдачи отправления на стороне Boxberry 1 - со вскрытием
** '''Разрешено вскрытие и частичная доставка''' - вид выдачи отправления на стороне Boxberry зависит от указания частичной доставки в карточке заказе:
*** 1 - <i>со вскрытием</i> если частичная доставка не указана
*** 2 - <i>частичная доставка</i>, при частичной доставке в карточке заказа
** '''Разрешено вскрытие и Частичная доставка с примеркой''' вид выдачи отправления на стороне Boxberry от указания частичной доставки в заказе:<br>Дополнительно, в этом случае <i>указывается возможность примерки</i>, если это доступно на ПВЗ получателя
*** 1 - <i>со вскрытием</i>, если частичная доставка не указана
*** 2 - <i>частичная доставка</i>, при частичной доставке в карточке заказа
* '''Передавать штрихкоды мест'''
* '''Передавать штрихкод заказа''' - Документацией Боксберри разрешено не передавать штрихкоды, тогда Бокберри сам создает ШК и этикетку можно получить по url который Boxberry возвращает вместе с кодом подрядчика при принятии заказа. На данный момент, интеграция не получает этикетки автоматически. Их нужно скачивать из ЛК Boxberry.
==== Миграция на Яндекс Доставку ====
Авторизация и принятие оферты Яндекс.Доставки будет происходить
через Личный кабинет Boxberry.<br>
* В личном кабинете Boxberry необходимо кликнуть по баннеру со ссылкой на новый ЛК Boxberry.
* Кликая на ссылку в банере, клиент последовательно увидит 2 окна:
** авторизация (подтверди свой аккаунт)
** принятие оферты
После этого клиенту доступна работа в API и модулях для обновления
гео-справочников.
ПВЗ Яндекс будут загружены в течении суток после подтверждения офферты.<br>
Если ПВЗ Яндекс не подгрузились в течении суток после подтверждения офферты, то требуется обратиться в техподдержку Measoft для получения логов статуса клиента.
=== СДЭК===
При выборе тарифа для отправки заказа приоритет отдается тарифам режима срочности, выбранного в заказе.
* '''Адрес получателя'''
** '''Как указано в заказе'''
** '''Склад курьерской службы''' в этом случае, адрес получателя указывается, как адрес ответственного филиала, для которого настроена интеграция, а адрес отправителя, как адрес реального отправителя, указанного в карточке заказа (для забора курьером у отправителя и доставки на склад курьерской службы)
При отправке заказов учитывается тип отправления. Если в карточке заказа указан тип [1] "Письмо", то вида груза в CSE устанавливается, как "Документы" [81dd8a13-8235-494f-84fd-9c04c51d50ec], иначе [4aab1fc6-fc2b-473a-8728-58bcd4ff79ba] "Груз".
Разные виды груза тарифицируются по разному.
<!--
'''Возвраты'''. Учитываются только при получении заказом статуса '''Частичная доставка'''.
-->
=== 5POST ===
Параметры для настройки:
Для подключения к интеграции в вашем договоре с Яндекс.Доставкой должна быть подключена услуга доставки на следующий день. Если у вас эта услуга не подключена, заполните [https://forms.yandex.ru/surveys/10833592.0f3ead3120074ee64cd9dde1df70b27d8d2678d2/ эту форму].
Сначала необходимо проверить, рассчитывается ли стоимость доставки в ЛК яндекса и можно ли оформить заказ. Если все работает - переходим к настройке интеграции.
Для настройки интеграции с платформой Яндекс.Доставка укажите следующие параметры:
*'''Токен''', можно посмотреть тут https://dostavka.yandex.ru/account/integration
*'''ID пункта отправления''', необходимо уточнить у вашего менеджера или в поддержке яндекса
* '''Особенности формирования данных''' с вариантами на выбор:
** ''нет''
** ''Трактовать места, как товары'' - в заказе формируется только одно место в котором размещаются вложения с габаритами и массой переданных мест.
** ''Трактовать товары, как места'' - каждый товар добавляется в место соответствующее его габаритам, т.о., сколько в заказе товаров, столько же будет сформировано мест.
Эти параметры обязательные и влияют на отправку заказа. Доступы должны быть НЕ тестовые (продовые). Уточните эти данные у вашего менеджера или в поддержке Яндекс.Доставки.
* '''Настройка списка ПВЗ''' - Позволяет настраивать список получаемых от Яндекс ПВЗ, доступны варианты:
** ''Получать все доступные ПВЗ''
** ''Отключить постаматы''
** ''Отключить все ПВЗ''
Для настройки модулей используйте: *'''Логин''' - ваш токен. *'''Пароль''' - Код пункта отправления. Имеет вот такой формат 4eccdad3-8d97-4fbf-b241-3c2a89a8aa79
*'''ЛогинКод курьерской службы''' - ваш токен90023.
* 1. Добавить склад в Избранные адреса, по инструкции в ссылке.
* 2. Запланировать отгрузку на этот склад через Календарь отгрузок.
* 3. Написать на почту в техподдержку Яндекс <span style="color: #0011ff;">next_day_delivery@go.yandex.ru</span> или чат поддержки в личном кабинете и запросить у специалиста техподдержки Яндекс ID Станции (склада, который был зарегистрирован, согласно инструкции).
При создании заказа обратите внимание на адрес — он должен быть понятным. Наиболее понятным для Яндекса будет адрес, где нет дополнительных комментариев, а части адреса разделены запятыми. Без заполнения адреса с указанием номера дома курьерская доставка будет не доступна.
В интеграцию не принимаются заказы на юридические лица. Т.е. в поле ФИО должно быть именно ФИО, а не название организации.
При использовании прямых интеграций и модулей необходимо использовать второй режим срочности [2] <b>Посылка. Алгоритмический тариф</b>.<br>
В разных модулях может выбираться из списка или вводиться числом. При выборе другого режима срочности интеграции и модули могут работать не верно либо рассчитывать не все возможные варианты.<br>
</div>
=== BTS Узбекистан ===
Для настройки интеграции с BTS укажите следующие параметры:
* '''Токен API''' - это обязательное поле. Заполните его правильно, и заказы будут отправляться в BTS.
Оставшиеся поля служат для более тонкой настройки создания заказов:
* '''Отправка корреспонденций ''', может принимать значения:
** ''Со склада''
** ''С адреса отправителя''
* '''Вызов курьера отправителем''', может принимать значения:
** ''Нет''
** ''Забрать у отправителя''
* '''Тестовый режим интеграции''', может принимать значения:
** ''Нет''
** ''Включен тестовый режим''
* '''Код курьера''' - Все заказы отмечаются, как доставленные указанным курьером.
Для отправки заказа:
* населенные пункты отправителя и получателя должны быть синхронизированы со списком населенных пунктов BTS. Если один из населенных пунктов не будет синхронизирован, то в карточку заказа будет добавлено сообщение об ошибке:
** ''Уточните город получателя'' или
** ''Уточните город отправителя''
* заказ должен иметь одно грузоместо. Если заказ не имеет грузомест или имеет более одного грузоместа, то он интеграция заблокирует отправку, а в сообщении о доставке карточки заказа опубликуется сообщение:
** ''грузоместо должно и может быть только одно.''
<div style="color: #a94442; background-color: #f2dede; border: 1px solid #ebccd1; padding: 3px 10px 10px;">
<b>Внимание!</b><br>
* Заказ должен иметь Одно грузоместо.
* Для отправки заказа, населенные пункты отправителя и получателя должны быть синхронизированы со списком BTS.
* Cинхронизация населенных пунктов, отсутствующих в списке BTS, проводится по запросу в техподдержку
</div>
!Пример строки
|-
|БОКСБЕРРИ||90001||https://home.courierexe.ru/90001/calculator||Введите токен в 43-й параметр- токен. 34-й можно оставить пустым- Код пункта приема<br> по умолчанию для старого Боксберри 010.<br> После перехода на Яндекс, требуется выбрать ПВЗ отправления из нового списка, предоставляемого Яндекс. <br> Для уточнения, свяжитесь с техподдержкой Boxberry<br>Можно оба параметра оставить пустыми для расчета базовых цен.||33, 90001,j3ejwo2f10b2e47790174b41f4a11111, j3ejwo2f10b2e47790174b41f4a11111c1cb5465-1418-42eb-a74d-204682e18af8, 2, 50
|-
|ПИКПОИНТ||90002||https://home.courierexe.ru/90002/calculator||3-й параметр — логин, 4-й — через запятую пароль и договор ИКН. Можно оставить пустыми, но цены будут не все.||33, 90002,us0111, '6rGGuqRsW2qNQ,9990721312', 2, 50
|СДЭК<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,15’, 1, 100
|-
|КСЭ||90008||https://home.courierexe.ru/90008/calculator||Введите логин в 3-й параметр, пароль — в 4-й. Пустыми оставить нельзя<br>Заполнение Логина и Пароля обязательно.<br><br>Вы можете перечислить в пароле уточняющие параметры для расчета через запятую:<br><ul><li>Особенности отправки заказов:<ul><li>0 - Как документ SaveDocument</li><li>1 - Как накладная SaveWaybillOffice</li><li>2 - Определить автоматически</li></ul></li><li>Забор<ul><li>0 - По умолчанию</li><li>1 - До двери</li><li>2 - Самопривоз в КСЭ</li></ul></li></ul><br>Пример пароля:<br>4CCB11864D06157,2,2||12504, 90008, Рога и копыта, '4CCB11864D06157,1,2', '2, 3, 6', 10%
|-
|ПОЧТА РОССИИ||90010||https://home.courierexe.ru/90010/calculator||Без авторизации||10497, 90010,,, '2, 1', 10 <!--10497, 90010, 89251234567, 'mypassword,u23B0r9AAJ1Fyh4ptMzJ3kjxcslamwdx', '2, 1', 10-->
10497, 90021, u23B0r9AAJ1Fyh4654MzJ3kjx1548wdx, pass, 100
|-
|Яндекс.Доставка||90023||https://home.courierexe.ru/90023/calculator||3-й параметр — токен,<br> 4-й — ID пункта отправления и в качестве пароля. <br>При необходимости, в пароль можно расширить, передавая через запятые интервал следующие параметры:<br> - <span style="text-decoration: line-through;">Начало интервала доставки.</span> (не активно)<br> - <span style="text-decoration: line-through;">Окончание интервала доставки </span> (не активно)<br> - Код курьера, для закрытия корреспонденции<br> - параметр "Особенности формирования данных"<br> '1' - Трактовать места, как товары<br> '2' - Трактовать товары, как места <br> - параметр "Настройка получения ПВЗ"<br> по умолчанию - Получать все ПВЗ<br> '1' - Отключить постаматы<br> '2' - Отключить все ПВЗ<br>Пример пароля: cfceadaa-4874-438a-999b-dbbafe5326ed,11:00,18:00,25,2,1||10497, 90023, AgAABBDzeAQMAAAPeISvM_9LUkxCijQoFXOH5QE, ‘cfceadaa-4874-438a-999b-dbbafe5326ed,11:00,18:00’,,1,1’, 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||
|Omnic||90025||https://home.courierexe.ru/90025/calculator||3-й параметр — логин, который требуется создать самостоятельно, для входа в <i>[https://home.courierexe.ru/90025/ ЛК экстраинтеграции Omnic]</i> <br> 4- пароль, как Токен клиента<br> Дополнительно, есть возможность перечислить в пароле уточняющие параметры для расчета через запятую: <br><ul><li>Код пункта приема отправлений</li><li>Признак использования тестовой среды</li><li>Приоритет доступных тарифов через пробелы, - при указании алгоритмического тарифа, приоритет указанный в нем имеет преимущество</li></ul><br>Пример пароля: g67hjtTYjhgf765432,MCK45||
10497, 90025, LoginTest, ‘g67hjtTYjhgf765432,MCK45,,21 22’, '3, 2', 100,,1
|-
|A2-express||90029||https://home.courierexe.ru/90029/calculator||3-й параметр — логин, Идентификатор клиента в A2 состоящий из 4-х цифр <i>[https://home.courierexe.ru/90029/ ЛК экстраинтеграции A2-express]</i> <br> 4-й параметр - пароль, это Ключ клиента в A2-express||
10497, 90029, 1000, g67hjtTYjhgf765432hgtTnk5, '1, 2', 100,,1
|}
# Перейдите в личный кабинет по адресу вида https://home.courierexe.ru/XXX, где XXX — экстра-код партнера, и авторизуйтесь данными из 3-го и 4-го параметров (см. таблицу выше).
# Откройте пункт основного меню '''Цена доставки для получателя''' и настройте правила расчета цены и сроков доставки. Подробнее см. раздел «[[Личный кабинет клиента#Цена доставки для получателя|Цена доставки для получателя]]».
== TPS Gate==
Интеграция с сервисом TPS Gate позволяет открывать шлагбаумы с мобильного приложения курьера на территории Москвы и Московской области. Это упрощает работу курьеров и уменьшает время на доставку каждого адреса.
Для подключения вам необходимо обратиться в сервис [https://tpsgate.ru TPS Gate], заключить с ними договор и подписать с нами доп. соглашение о передаче данных [https://courierexe.ru/download/TPS_DOP.docx Пример].
Далее необходимо передать нам секретный ключ от сервиса TPS Gate и интеграция будет запущена.
Если на адресе доставки есть ворота, которые возможно открыть через TPS Gate в мобильном приложении курьера появится соответствующая кнопка.
Чтобы курьер мог открывать ворота через приложение, у него должна быть включена галка '''Водитель''' в карточке сотрудника.
