Изменения

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

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

6941 байт добавлено, 12:53, 5 мая 2021
м
Проверка работоспособности интеграций
== Тарификация и выбор подрядчика и его тарифа клиентом ==
Вы можете настроить подключение своего тарифа к тарифу партнера. Партнерами могут быть любые — любой компании, работающие работающей в системе 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
|}
При выборе клиентом в личном кабинете вида срочности, подключенного таким образом к партнеру, набор доступных ПВЗ будет ограничен выбранным партнером.
При отправке заказа Вы можете войти в личный кабинет по интеграции с подключенным видом срочности интеграция постарается отправить заказ одним адресу вида https://home.courierexe.ru/XXX, где XXX — экстра-код партнера, авторизоваться данными из режимов, введенных в п3-го и 4-го параметров (см.5 (по порядку, в порядке приоритетовтаблицу выше), а если не получится — вернет ошибкуи воспользоваться калькулятором с тарифами именно вашей компании.
Также можно для любой компании войти в личный кабинет по адресу вида https://home.courierexe.ru/90005 , где в конце — экстра-код партнера, авторизоваться данными из 3-го и 4-го параметров (см. таблицу выше) и воспользоваться калькулятором с тарифами именно вашей компании. == Интеграция с клиентами 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>После синхронизации справочников автоматически произойдет переход на страницу следующего шага.
===Wordpress===
====Требования к сайту перед установкой плагина:====
#CMS WordPress версии 5, или более новая.
#WooCommerce версии 3.9, или более новая.
#PHP версии 7, или более новая.
#Сайт должен использовать SSL-сертификат
====Требования к сайту ==== # CMS WordPress версии 5 или более новая;# WooCommerce версии 3.9 или более новая;# PHP версии 7 или более новая;# сайт должен использовать SSL-сертификат. ====Порядок установки плагина и вывод нового способа доставки в корзину:==== #В панели администратора вашего сайта откройте страницу “Плагины - '''Плагины''' > '''Добавить новый” новый''' и нажмите на кнопку “Загрузить плагин”'''Загрузить плагин'''.#В появившейся форме выберите архив с плагином на вашем компьютере и нажмите кнопку “Установить”'''Установить'''.#После загрузки и установки плагина вы можете его активировать нажав на соответствующую кнопку .#После активации плагина в меню появится ссылка на страницу настроек плагина.Заполните все необходимые поля и нажмите кнопку “Сохранить изменения”'''Сохранить изменения'''.#Откройте настройки WooCommerce и переключите на вкладку “Доставка”'''Доставка'''.#Выберите необходимую зону доставки, или создайте её.#Нажмите на кнопку “Добавить '''Добавить метод доставки” доставки''' и выберите из списка “КС2008”'''КС2008'''.#После создания заказа, в панели администратора, в форме изменения заказа, справа появится блок модуля "'''Отправить в курьерскую службу, снизу которого будет кнопка "''' с кнопкой '''Отправить заказ в КС2008"''', при нажатии на которую заказ будет отправлен в курьерскую службу.
====Обновление статусов====
 
Обновление статусов заказов происходит через технологию WP_Cron каждые 30 минут.
Если статус заказа в курьерской службе будет изменен на “Доставлен”'''Доставлен''', то статус заказа в вашем магазине также будет изменен на “Выполнен”'''Выполнен'''.
===Проверка работоспособности интеграций===
:: Если это ошибка ответа курьерской службы, сообщите об этом разработчику. Пример ошибки: «Служба доставки прислала ответ в неверном формате».
'''Мой складМойСклад'''
# При сбое интеграции проверьте, не изменен ли аккаунт, под которым создана интеграция:
## Логин учетных данных МойСклад, которые использовались при создании интеграции, вставьте в ссылку <nowiki>https://home.courierexe.ru/moysklad/step2?id=</nowiki>'''логин'''. Если при переходе по ссылке отображается этап настройки интеграции, значит аккаунт существует.
## Войдите в «МойСклад» под учетной записью, которая использовалась для настройки интеграции, и откройте справочник '''Сотрудники''': меню пользователя > '''Настройки''' > '''Справочники'''> '''Сотрудники'''. Откройте карточку сотрудника, под учетной записью которого вы вошли, и убедитесь, что его роль — администратор.
## Если хотя бы один из пунктов не выполнен, значит, аккаунт, использованный для создания интеграции, изменен.
# В личном кабинете клиента курьерской службы в настройках обратной интеграции '''Мой склад''' в поле '''В каком статусе "Мой склад" отправлять заказ на доставку''' уточните статус, при котором заказ отправляется в курьерскую службу.
# Заполните форму заказа, нажмите на кнопку '''Сохранить''', затем смените статус заказа на статус, установленный для отправки в курьерскую службу и снова нажмите на кнопку '''Сохранить'''. Если все верно, заказ будет отправлен в курьерскую службу.
# В личном кабинете клиента курьерской службы в настройках обратной интеграции '''InSales''' проверьте данные в следующих полях:
#* '''Отправлять заказы в курьерскую службу автоматически после изменения статуса''';#* '''Статус отправления заказа для автоматической отправки в курьерскую службу (если отправляется автоматически)''';
#* '''Список доставок для отправления заказа в курьерскую службу (если отправляется автоматически)''';
#* '''Оплачен ли заказ? (если отправляется автоматически)'''.
Ошибка при создании заказа отображается в левом нижнем углу.
== Интеграция с платежными сервисами == Доступна интеграция со следующими сервисами:* PimPay — финансирование для интернет-магазинов;* Robokassa — онлайн-оплата заказов;* ibox — мобильный эквайринг. Сервисы настраиваются в [[Личный кабинет курьерской службы#Вкладка «Финансы»|личном кабинете курьерской службы]]. === Robokassa ===
Чтобы настроить прием платежей через сервис Robokassa:
[[Файл:Robokassa.png|none|900 px]]
При успешной оплате заказ в MeaSoft отмечается как оплаченный.
== PimPay ==Чтобы начать работать с [https://pimpayВ окне отслеживания в поле '''Наложенный платеж''' статус заказа изменится на '''Заказ оплачен'''.ru/ Pimpay] необходимо сначала зарегистрироваться в их системе Чек по адресу [http://platform.api.pimpay.ru/site/register http://platform.api.pimpay.ru/site/register]. Далее pimpay активирует Вашу учетную запись. [[Файл:pimpayconfig.png|thumb|200px|right|рисоперации придет на электронную почту, указанную при заказе.1 Конфигурация PimPay]]
Чтобы продолжить, вам нужно сгенерировать ключи шифрования. Это делается на UNIX-подобной системе: [http://platform.api.pimpay.ru/v2_7/signature/openssl http://platform.api.pimpay.ru/v2_7/signature/openssl] или <spoiler text="наша инструкция">Чтобы получить приватный ключ, необходимо запустить командную строку.== PimPay ===
В Чтобы начать работать с [https://pimpay.ru/ Pimpay]:# Зарегистрируйтесь [http://platform.api.pimpay.ru/site/register http://platform.api.pimpay.ru/site/register в сервисе]. Далее Pimpay активирует вашу учетную запись.# Cгенерируйте ключи шифрования. Это делается на [http://platform.api.pimpay.ru/v2_7/signature/openssl UNIX-подобной системе] или с помощью <rspoiler text="нашей инструкции">Чтобы получить приватный ключ, в командной строке необходимо выполнить выполните следующие команды: <br><br><code>openssl genrsa -out private.pem 2048 </code> <br><br><code>openssl rsa -in private.pem -outform PEM -pubout -out public.pem</code><br><br>В результате вы получите 2 файла: public.pem и private.pem.<br>Содержимое файла public.pem — ваш публичный ключ. Скопируйте его целиком и вставьте в личном кабинете PimPay.<br>Содержимое файла private.pem скопируйте и вставьте в настройках интеграции с PimPay в личном кабинете курьерской службы.</rspoiler>. Если у вас нет специалиста, чтобы сгенерировать ключи, обратитесь за помощью в PimPay.# В личном кабинете курьерской службы в разделе '''Управление ЛК''' > '''Параметры''' > '''Финансы''' заполните настройки Pimpay данными из личного кабинета Pimpay. Сохраните настройки.# Зарегистрируйте каждого клиента, который хочет передавать данные в PimPay, в личном кабинете PimPay.# В MeaSoft в карточке каждого клиента на [[Клиенты и партнеры#Финансы |вкладке '''Финансы''']] выберите платежного посредника '''PimPay'''.
После успешного выполнение команд Вы получить 2 файла: publicПри передаче данных привязка клиентов между системами производится по ИНН.pem и private.pemСодержимое файла public.pem - ваш публичный ключ, который необходимо целиком скопировать и вставить в ЛК PimPay.А содержимое файла private.pem необходимо скопировать и вставить в настройках интеграции с PimPay в нашем ЛК.</spoiler>[[Файл:pimpay client.png|thumb|200px|right|рис.2 Выбор платежного посредника]]Если у вас нет специалиста, чтобы сгенерировать ключи, обратитесь в PimPay, они с радостью сделают это за вас!
ДалееВ результате MeaSoft передает все заказы вашего клиента, необходимо прописать настройки для pimpay в панели управления нашего ЛК их статусы и созданные [[Акты Передачи Денег и корреспонденции (см. рис.1АПД)|АПД]] в PimPay. В ЛК PimPay нужно посмотреть код компании (у них называется "Код платформы") и токен, ввести их ничего не передает в формуответ.
Для каждого клиента, который хочет передавать данные Чтобы платежи в PimPay необходимо зарегистрировать банк по АПД выгружались в личном кабинете адрес PimPay, и в нашей системе выбрать платежного посредника на вкладке "Финансы" карточки клиента. В процессе передачи данных привязка клиентов между системами производится по ИНН. Наша система начинает передавать все заказы вашего создайте клиента в PimPay, их статусы, и созданные [[Акты Передачи Денег с названием «PIMPAY» и корреспонденции (АПД)|АПД]]. Обратно она ничего не получаетзаполните его реквизиты.
=== ibox === Мобильный эквайринг ibox доступен через приложение или <rspoiler text="SDK">SDK — это средства разработки, которые позволяют приложению MeaSoft взаимодействовать с POS-терминалом напрямую.</rspoiler>. Подробнее см. раздел [[Мобильное приложение курьера для Android#ibox|«ibox»]]. Для тогоподтверждения успешной транзакции или отмены оплаты MeaSoft получает обратные вызовы (вебхуки) от ibox:* при успешной оплате после установки статуса корреспонденции со слов курьера '''Доставлено''' или '''Частично доставлено''' в MeaSoft на вкладке '''Выдача''' подсвечивается поле '''Тип оплаты''':** зеленым цветом, если оплата картой, есть идентификатор транзакции и сумма транзакции верная;** желтым цветом, если оплата картой, есть идентификатор транзакции, но сумма транзакции не совпадает со значением поля '''Сумма руб''' в карточке корреспонденции;** красным цветом, если оплата картой и нет идентификатора транзакции.*: Если в карточке корреспонденции указан тип оплаты '''Наличными''', то поле будет закрашено красным, если есть идентификатор безналичной транзакции или указана ее сумма. Если их нет, то поле будет зеленым;* при отмене оплаты обратный вызов удаляет идентификатор транзакции, чтобы платежи сделать возможной повторную доставку и оплату заказа картой. Чтобы настроить работу обратных вызовов:# В личном кабинете курьерской службы в разделе '''Управление ЛК''' > '''Параметры''' > '''Финансы''' в разделе '''Настройки эквайринга Ibox''' заполните поля:#* '''ID клиента в системе ibox''' — номер компании в банк по АПД выгружались разделе '''Профиль''' в адрес PimPayличном кабинете ibox;#* '''Логин для webhook ibox''' и '''Пароль для webhook ibox''' — придумайте логин и пароль для авторизации запросов ibox в MeaSoft. Логин и пароль могут состоять из цифр и латинских букв, нужно создать клиента длина не менее 5 символов.# Нажмите на кнопку '''Сохранить'''.# Обратитесь в техподдержку ibox с точно таким названием ("PIMPAY"), просьбой подключить вебхуки для MeaSoft и сообщите им придуманные вами логин и заполнить его реквизитыпароль.
== Диадок ==
 
=== Начальная настройка ===
# Обратитесь в [https://kontur.ru/ СКБ Контур] для выпуска [https://ru.wikipedia.org/wiki/%D0%AD%D0%BB%D0%B5%D0%BA%D1%82%D1%80%D0%BE%D0%BD%D0%BD%D0%B0%D1%8F_%D0%BF%D0%BE%D0%B4%D0%BF%D0%B8%D1%81%D1%8C электронной цифровой подписи (ЭЦП)] для использования с ЭДО Диадок. Нам выставили счет на 5250 рублей. Потом нужно прийти в предложенный офис удостоверяющего центра с уставными документами, вам дадут флешку (называется "Получите Рутокен") с ЭЦП. При ее его подключении автоматически устанавливается набор ПО для ее его использования.
# Вам становится доступен вход в систему по адресу [https://diadoc.kontur.ru https://diadoc.kontur.ru], без пароля, просто по ЭЦП, подключенной к компьютеру. Вы уже можете принимать документы от контрагентов.
# Обратитесь в СКБ Контур для выставления счета на пакет отправляемых документов. Пакет можно выбрать здесь: [https://www.diadoc.ru/price https://www.diadoc.ru/price]. Кроме того, для использования с нашей, как и с любой другой системой, нужно включить возможность использования API: сотрудники Контура выставят за это счет - 18 т.р. на год, или 38 т.р. за 5 лет (актуально в 2019 году). После '''оплаты счета''' за API они присылают '''API-ключ''' вида "API-1b1111ae-1111-1111-b111-111111cc1fd1". API-ключ приобретается отдельно на каждое ваше юр. юридическое лицо, поэтому его нужно вводить в "'''Фирмы"'''.
# В системе Диадок откройте '''Настройки и оплата''' > '''Сотрудники''' и выберите сотрудника, который будет отвечать за подписание документов. В карточке сотрудника перейдите на вкладку '''Данные по сертификатам''' и в группе полей '''Область полномочий''' установите полномочия для входящих и исходящих документов. Нажмите на кнопку '''Сохранить'''.
# Заполните данные подключения в системе:
=== Обмен данными с ЭДО ===
 
Выберите в главном меню "Связь" -> "Обмен с ЭДО". Откроется окно с выпадающим списком фирм, у которых заполнено поле "Ключ ЭДО". Выберите фирму, и нажмите "Обмен!". Программа выполнит все операции, которые периодически нужно выполнять, чтобы иметь актуальные данные как в нашей системе так и в ЭДО:
*Синхронизирует справочники контрагентов: Получит список контрагентов, уже являющихся вашими партнерами в ЭДО, проставит им соответствующие признаки (На вкладке "Клиенты" появилось новое поле "Статус ЭДО". Это поле нельзя менять, оно устанавливается автоматически), проверит, кто прислал вам приглашения к партнерству и примет их, разошлет приглашения всем вашим работающим контрагентам, проверит, кто принял приглашение, а кто - отказался.
=== Отправка документов ===
 
К отправке сейчас доступны счета, АПД и АПК. Отправка работает крайне похоже на e-mail. Документы формируются точно так же, но отправляются не почтой, а в ЭДО, уже подписанными вашей ЭЦП. В системе ЭДО "адресами" отправителя и получателя являются ИНН (по возможности еще КПП, но это не обязательно) компании, поэтому, чтобы все работало, ИНН должен быть заполнен. Так же ЭДО примет документы только в адрес компании, с которой у вас отмечены партнерские отношения, т.е. кто-то из вас отправил приглашение, а другой его принял. Поэтому, для удобства контроля - кому можно таким образом отправлять, а кому - нет, в списках документов добавлено поле "Есть ЭДО". Там галка ставится на основании статуса ЭДО клиента. Можете отсортировать по этому полю, выдели все, где есть галки, и разослать всем документы по ЭДО.
== Телефония ==
 
Основная статья: [[Интеграция с телефонией]]
== GPS-трекинг автотранспорта ==
 
Для поддержки GPS-трекинга автотранспорта у нас разработана интеграция с коробочной системой Wialon, на которой работают большинство компаний, предоставляющих подобные услуги. Обратитесь в службу технической поддержки для помощи в настройке.

Навигация