430
правок
Изменения
→СДЭК
<div style="color: #a94442; background-color: #f2dede; border: 1px solid #ebccd1; padding: 3px 10px 10px;">
При передаче заказов, у которых плановая дата доставки меньше ближайшей возможной, дата доставки автоматически меняется на самую раннюю возможную.</div>
Передача времени ожидания и заполнение информации о возврате не предусмотрено интеграцией.
Для стабильной работы необходимо наличие версии MeaSoft минимум 518 от 05.12.2014 у обеих компаний. Для одного клиента может быть настроена только одна интеграция с агентом.
Параметр <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 для получения логов статуса клиента.
=== СДЭК===
** "Передавать, если указана"<br><span style="padding-left: 5px;">Учитываются только суммы из полей Оценочная стоимость заказа и Оценочная стоимость товарных вложений, где в приоритете Оценочная стоимость заказа.</span>
** "Передавать, по местам, если указана"<br><span style="padding-left: 5px;">Оценочная стоимость заказа распределяется по вложениям. Вложения в свою очередь распределяются по местам.</span>
Оценочная стоимость передается по каждому товару, а не общей суммой. Необходимо указать сумму оценочной стоимости, которая будет соответствовать количеству товаров и проверить отправку заказа.
* '''Добавлять услугу «Осмотр вложений»'''. Тарифицируемая услуга от СДЭК, поэтому она добавится, только если в настройках указано '''Да''';
* '''Процент за наложенный платеж'''. Используется при получении агентской цены. Калькулятор API CDEK не включает в расчет сумму за наложенный платеж автоматически, но мы добавим указанный вами процент в итоговую сумму;
При создании заказа обратите внимание на адрес — он должен быть понятным. Наиболее понятным для Яндекса будет адрес, где нет дополнительных комментариев, а части адреса разделены запятыми. Без заполнения адреса с указанием номера дома курьерская доставка будет не доступна.
В интеграцию не принимаются заказы на юридические лица. Т.е. в поле ФИО должно быть именно ФИО, а не название организации.
!Пример строки
|-
|БОКСБЕРРИ||90001||https://home.courierexe.ru/90001/calculator||3-й параметр - токен. 4-й - Код пункта приема, <br> по умолчанию для старого Боксберри 010.<br> После перехода на Яндекс, требуется выбрать ПВЗ отправления из нового списка, предоставляемого Яндекс.<br> Для уточнения, свяжитесь с техподдержкой Boxberry<br>Можно оба параметра оставить пустыми для расчета базовых цен.||33, 90001, j3ejwo2f10b2e47790174b41f4a11111, 010c1cb5465-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-->
# Перейдите в личный кабинет по адресу вида 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 в мобильном приложении курьера появится соответствующая кнопка.
Чтобы курьер мог открывать ворота через приложение, у него должна быть включена галка '''Водитель''' в карточке сотрудника.
