2651
правка
Изменения
м
При отправке заказа по интеграции с подключенным видом срочности интеграция постарается отправить заказ одним из режимов, введенных в п.5 (по порядку, в порядке приоритетов), а если не получится — вернет ошибку. Также можно для любой компании Вы можете войти в личный кабинет по адресу вида https://home.courierexe.ru/90005 XXX, где в конце XXX — экстра-код партнера, авторизоваться данными из 3-го и 4-го параметров (см. таблицу выше) и воспользоваться калькулятором с тарифами именно вашей компании.
#* '''Отправлять заказы в курьерскую службу автоматически после изменения статуса''';#* '''Статус отправления заказа для автоматической отправки в курьерскую службу (если отправляется автоматически)''';
→Проверка работоспособности интеграций
== Тарификация и выбор подрядчика и его тарифа клиентом ==
Вы можете настроить подключение своего тарифа к тарифу партнера. Партнерами могут быть любые — любой компании, работающие работающей в системе MeaSoft, а также ряд ряду компаний, с которыми у нас есть интеграции, см. список ниже. Для этого откройте Чтобы настроить подключение к тарифу партнера:# Зарегистрируйтесь в системе подрядчика. Данные аккаунта понадобятся для настройки интеграции.# Откройте '''Справочники''' > '''Статусы''', выберите > '''17 Виды срочности'''. Создайте и создайте вид срочности, например «СДЭК». # В контекстном меню вида срочности выберите пункт '''Дополнительная информация''' и во второй строке заполните параметры подключения к партнеру через запятую:#* 1-й параметр — код филиала партнера, его можно посмотреть в '''Справочники''' > '''Межгород''' > '''Филиалы''';#* 2-й параметр — экстра-код партнера в системе MeaSoft. В том числе для сторонних компаний есть коды, см. таблицу ниже;#* 3-й параметр — имя пользователя в системе партнера. Может отличаться от того, под которым работает интеграция, здесь нужно для расчета цены для клиента. В таблице ниже указано, что вводить для каждого интегратора;#* 4-й параметр — пароль пользователя из 3-го параметра. В таблице ниже указано, что вводить для каждого интегратора;#* 5-й параметр — вид срочности партнера. Посмотреть доступные коды видов срочности можно по ссылке в таблице ниже, в калькуляторе в выпадающем списке. Можно в одинарных кавычках указать несколько видов срочности через запятую, тогда система будет стараться выбрать из них первый доступный;#* 6-й параметр — наценка к цене, передаваемой подрядчиком. В деньгах или в процентах, если стоит знак процента. Например, 10 — наценка 10 рублей, 10% — наценка 10 процентов;#* 7-й параметр — если указать значение '''1''', сквозная тарификация выключена. Параметр используется, если подключение нужно только для передачи заказов по интеграции, а расчет цены не нужен.# Нажмите на кнопку '''OK'''.
{|class="wikitable"
|ПОЧТА РОССИИ||90010||https://home.courierexe.ru/90010/calculator||<!--Введите "логин отправки" в 3-й параметр, а в 4-й в одинарных кавычках через запятую пароль отправки и токен. Пустыми оставлять нельзя, т.к. интеграция с Почтой пока не позволяет рассчитывать цены без договора (авторизации).-->Пока поддерживаются только базовые тарифы, без авторизации.||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-й — ключ доступа. Можно оставить пустыми.
||10497, 90017, 9999, cc03e747a6afbbcbf8be7668acfebee5, '1', 100
|-
|5Пост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 URL обязательна.||
10497, 90021, u23B0r9AAJ1Fyh4654MzJ3kjx1548wdx, pass, 100
|}
При выборе клиентом в личном кабинете вида срочности, подключенного таким образом к партнеру, набор доступных ПВЗ будет ограничен выбранным партнером.
== Интеграция с CMS-системами (получение заказов) ==
Проверить работу модуля можно в форме оформления доставки. При этом должна корректно считаться стоимость доставки.
==== Настройка передачи Перенос даты доставки ==== Вы можете настроить перенос даты доставки на один день вперед от даты, получаемой от курьерской службы, если заказ оформлен позже определенного часа. Чтобы настроить перенос даты доставки:# В личном кабинете 1C-Битрикс на вкладке '''Администрирование''' в панели слева выберите '''Контент''' > '''Структура сайта''' > '''Файлы и папки''' и в окне «Управление структурой» в поле '''Путь''' введите <code>/bitrix/modules/measoft.courier/MeasoftEvents.php</code>.# В окне «Просмотр файла "MeasoftEvents.php"» нажмите на кнопку '''Редактировать''' > '''Редактировать как PHP'''.# В окне «Редактирование файла "MeasoftEvents.php"» найдите строки: define("measoft_check_fill_deliverydate", "Y"); define("measoft_check_fill_deliverydate_hour", 14);: Если строки закомментированы, удалите символы комментирования («//»).:4. Укажите значения переменных: :* возможные значения для первой строки: '''Y''' — переносить дату доставки, '''N''' — не переносить дату доставки;:* возможные значения для второй строки: целое число от 1 до 24. Если оформить заказ после указанного часа, к дате доставки, получаемой от курьерской службы, прибавляется один день.:5. Нажмите на кнопку '''Сохранить'''. ==== Передача наложенного платежа ====
# В личном кабинете 1C-Битрикс на вкладке '''Администрирование''' в панели слева выберите '''Настройки''' > '''Настройки продукта''' > '''Настройки модулей''' и на странице «Настройки модуля» в выпадающем списке выберите значение '''Курьерская служба'''.
* Обработка координат.
===Мой СкладМойСклад===
Интеграция предназначена для передачи заказов с товарными вложениями из системы «Мой склад» МойСклад в MeaSoft. Обратно в «Мой склад» МойСклад будут приходить статусы, стоимость доставки и общая сумма заказа с учетом частичной доставки.
Чтобы настроить интеграцию:
# В системе «Мой Склад» МойСклад создайте дополнительные поля в заказах:
#* с типом «Строка»:
#** '''Город''' — для указания населенного пункта получателя;
#** '''Время доставки с''' — справочник '''Часы доставки''';
#** '''Время доставки по''' — справочник '''Часы доставки'''.
# Перейдите по [https://home.courierexe.ru/moysklad/step1 ссылке] и введите логин и пароль от учетной записи системы «Мой склад». Затем укажите логин, пароль и код курьерской службы. Запросите эти данные у курьерской службы, «МойСклад» с которой настраивается интеграцияправами администратора.<br><br>'''Примечание'''. После настройки интеграции не рекомендуется менять логин и пароль от системы «Мой Склад». Это Запрещено изменять данные этой учетной записи — это приведет к сбою интеграции. В будущем при обращении в техническую поддержку MeaSoft указывайте данные этой учетной записи для получения помощи по вопросам интеграции.<br>Если все же есть необходимость сменить учетные данные, после сообщите новый пароль от «Мой Склад» «МойСклад» в техподдержку MeaSoft для внесения изменений в настройки интеграции.<br><br># Укажите логин, пароль и код курьерской службы. Запросите эти данные у курьерской службы, с которой настраивается интеграция.
# Нажмите на кнопку '''Сохранить'''.<br>В случае ошибки «Данный пользователь "Мой склад" уже зарегистрирован.» нажмите на кнопку '''Сбросить'''.
# Дождитесь окончания синхронизации справочников. Не закрывайте и не перезагружайте страницу. Процесс может занять продолжительное время (от 10 минут).<br>После синхронизации справочников автоматически произойдет переход на страницу следующего шага.
:: Если это ошибка ответа курьерской службы, сообщите об этом разработчику. Пример ошибки: «Служба доставки прислала ответ в неверном формате».
'''Мой складМойСклад'''
# При сбое интеграции проверьте, не изменен ли аккаунт, под которым создана интеграция:
## Логин учетных данных МойСклад, которые использовались при создании интеграции, вставьте в ссылку <nowiki>https://home.courierexe.ru/moysklad/step2?id=</nowiki>'''логин'''. Если при переходе по ссылке отображается этап настройки интеграции, значит аккаунт существует.
## Войдите в «МойСклад» под учетной записью, которая использовалась для настройки интеграции, и откройте справочник '''Сотрудники''': меню пользователя > '''Настройки''' > '''Справочники'''> '''Сотрудники'''. Откройте карточку сотрудника, под учетной записью которого вы вошли, и убедитесь, что его роль — администратор.
## Если хотя бы один из пунктов не выполнен, значит, аккаунт, использованный для создания интеграции, изменен.
# В личном кабинете клиента курьерской службы в настройках обратной интеграции '''Мой склад''' в поле '''В каком статусе "Мой склад" отправлять заказ на доставку''' уточните статус, при котором заказ отправляется в курьерскую службу.
# Заполните форму заказа, нажмите на кнопку '''Сохранить''', затем смените статус заказа на статус, установленный для отправки в курьерскую службу и снова нажмите на кнопку '''Сохранить'''. Если все верно, заказ будет отправлен в курьерскую службу.
# В личном кабинете клиента курьерской службы в настройках обратной интеграции '''InSales''' проверьте данные в следующих полях:
#* '''Список доставок для отправления заказа в курьерскую службу (если отправляется автоматически)''';
#* '''Оплачен ли заказ? (если отправляется автоматически)'''.
Чтобы платежи в банк по АПД выгружались в адрес PimPay, создайте клиента с названием «PIMPAY» и заполните его реквизиты.
=== ibox ===
Мобильный эквайринг ibox доступен через приложение или <rspoiler text="SDK">SDK — это средства разработки, которые позволяют приложению MeaSoft взаимодействовать с POS-терминалом напрямую.</rspoiler>. Подробнее см. раздел [[Мобильное приложение курьера для Android#ibox|«ibox»]].
Для подтверждения успешной транзакции или отмены оплаты MeaSoft получает обратные вызовы (вебхуки) от ibox:
* при успешной оплате после установки статуса корреспонденции со слов курьера '''Доставлено''' или '''Частично доставлено''' в MeaSoft на вкладке '''Выдача''' подсвечивается поле '''Тип оплаты''':
** зеленым цветом, если оплата картой, есть идентификатор транзакции и сумма транзакции верная;
** желтым цветом, если оплата картой, есть идентификатор транзакции, но сумма транзакции не совпадает со значением поля '''Сумма руб''' в карточке корреспонденции;
** красным цветом, если оплата картой и нет идентификатора транзакции.
*: Если в карточке корреспонденции указан тип оплаты '''Наличными''', то поле будет закрашено красным, если есть идентификатор безналичной транзакции или указана ее сумма. Если их нет, то поле будет зеленым;
* при отмене оплаты обратный вызов удаляет идентификатор транзакции, чтобы сделать возможной повторную доставку и оплату заказа картой.
Чтобы настроить работу обратных вызовов:
# В личном кабинете курьерской службы в разделе '''Управление ЛК''' > '''Параметры''' > '''Финансы''' в разделе '''Настройки эквайринга Ibox''' заполните поля:
#* '''ID клиента в системе ibox''' — номер компании в разделе '''Профиль''' в личном кабинете ibox;
#* '''Логин для webhook ibox''' и '''Пароль для webhook ibox''' — придумайте логин и пароль для авторизации запросов ibox в MeaSoft. Логин и пароль могут состоять из цифр и латинских букв, длина не менее 5 символов.
# Нажмите на кнопку '''Сохранить'''.
# Обратитесь в техподдержку ibox с просьбой подключить вебхуки для MeaSoft и сообщите им придуманные вами логин и пароль.
== Диадок ==
