2651
правка
Изменения
м
При отправке заказа по интеграции с подключенным видом срочности интеграция постарается отправить заказ одним из режимов, введенных в п.6 (по порядку, в порядке приоритетов), а если не получится — вернет ошибку. Также можно для любой компании Вы можете войти в личный кабинет по адресу вида https://home.courierexe.ru/90005 XXX, где в конце XXX — экстра-код партнера, авторизоваться данными из 3-го и 4-го параметров (см. таблицу выше) и воспользоваться калькулятором с тарифами именно вашей компании.
Чтобы настроить интеграцию:==== Настройка интеграции ====
#** в поле '''Статус отправки заказа''' выберите статус, при котором заказ будет отправляться в курьерскую службу;
Для предоплаченных заказов в карточке корреспонденции отображается сумма к оплате 0, при наличии товарных вложений добавляется вложение «Предоплата» с типом вложения '''Предоплата''' и ценой, равной сумме предоплаты, со знаком «минус». Поддерживается только полная предоплата.==== Возможные ошибки ====
'''Примечание'''. Проверить работу модуля можно в форме оформления доставки. При этом должна корректно считаться стоимость доставки. <spoiler text="Если возникает ошибка"># Если не рассчитывается стоимость, возможные причины:
</spoiler>
Чтобы настроить интеграцию:==== Настройка интеграции ====
#* '''Переводить заказ в специальный статус в случае ошибки передачи заказа?'''. Определяет, используется ли специальный статус для обозначения заказов с ошибкой передачи данных. Возможные значения: '''Да''', '''Нет'''.
====Требования к сайту перед установкой плагина:====
#CMS WordPress версии 5, или более новая.
#WooCommerce версии 3.9, или более новая.
#PHP версии 7, или более новая.
#Сайт должен использовать SSL-сертификат
#* '''Отправлять заказы в курьерскую службу автоматически после изменения статуса''';#* '''Статус отправления заказа для автоматической отправки в курьерскую службу (если отправляется автоматически)''';
При успешной оплате заказ Чтобы начать работать с [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'''.
== 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]]
Чтобы продолжитьВ результате MeaSoft передает все заказы вашего клиента, вам нужно сгенерировать ключи шифрования. Это делается на UNIX-подобной системе: их статусы и созданные [[http://platformАкты Передачи Денег и корреспонденции (АПД)|АПД]] в PimPay.api.pimpay.ru/v2_7/signature/openssl http://platform.api.pimpay.ru/v2_7/signature/openssl] или <spoiler text="наша инструкция">Чтобы получить приватный ключ, необходимо запустить командную строкуPimPay ничего не передает в ответ.
В командной строке необходимо выполнить следующие команды: openssl genrsa -out privateЧтобы платежи в банк по АПД выгружались в адрес PimPay, создайте клиента с названием «PIMPAY» и заполните его реквизиты.pem 2048 openssl rsa -in private.pem -outform PEM -pubout -out public.pem
После успешного выполнение команд Вы получить 2 файла: public.pem и private.pemСодержимое файла public.pem - ваш публичный ключ, который необходимо целиком скопировать и вставить в ЛК PimPay.А содержимое файла private.pem необходимо скопировать и вставить в настройках интеграции с PimPay в нашем ЛК.</spoiler>[[Файл:pimpay client.png|thumb|200px|right|рис.2 Выбор платежного посредника]]Если у вас нет специалиста, чтобы сгенерировать ключи, обратитесь в PimPay, они с радостью сделают это за вас!=== ibox ===
ДалееМобильный эквайринг ibox доступен через приложение или <rspoiler text="SDK">SDK — это средства разработки, необходимо прописать настройки для pimpay в панели управления нашего ЛК (смкоторые позволяют приложению MeaSoft взаимодействовать с POS-терминалом напрямую. рис</rspoiler>.1)Подробнее см. В ЛК PimPay нужно посмотреть код компании (у них называется "Код платформы") и токен, ввести их в формураздел [[Мобильное приложение курьера для Android#ibox|«ibox»]].
Для того, чтобы платежи Чтобы настроить работу обратных вызовов:# В личном кабинете курьерской службы в разделе '''Управление ЛК''' > '''Параметры''' > '''Финансы''' в разделе '''Настройки эквайринга Ibox''' заполните поля:#* '''ID клиента в системе ibox''' — номер компании в разделе '''Профиль''' в банк по АПД выгружались личном кабинете ibox;#* '''Логин для webhook ibox''' и '''Пароль для webhook ibox''' — придумайте логин и пароль для авторизации запросов ibox в адрес PimPayMeaSoft. Логин и пароль могут состоять из цифр и латинских букв, нужно создать клиента длина не менее 5 символов.# Нажмите на кнопку '''Сохранить'''.# Обратитесь в техподдержку ibox с точно таким названием ("PIMPAY"), просьбой подключить вебхуки для MeaSoft и сообщите им придуманные вами логин и заполнить его реквизитыпароль.
→Проверка работоспособности интеграций
MeaSoft имеет практически неограниченные возможности по интеграции с другими системами. В этой статье мы рассмотрим виды и способы интеграции.
== Интеграция между 2-мя двумя клиентами MeaSoft ==
Один из клиентов (Клиент) отправляет заказы другому клиенту (Агенту), Агент доставляет отправления и передает их статусы, которые загружаются в систему Клиента.
# '''Клиент''' нажимает на кнопку '''Настроить''' напротив филиала, в открывшемся окне выбирает интегратор «MeaSoft», заполняет поля '''Логин''', '''Пароль''' и '''Код клиента''' учетными данными, полученными в п. 3, и нажимает '''Сохранить'''.
В результате такой настройки все отправления, у которых Клиент установит «Ответственный филиал», соответствующий Агенту (правильнее всего это через [[Отправка корреспонденции|#Создание манифеста|манифест]], скомплектовав его и проставив дату отправки), будут переданы в БД Агента, и статусы будут передаваться обратно. На передачу данных может уходить до 10 минут в штатном режиме и до 1 часа в случае возможных сбоев. <div style="color: #a94442; background-color: #f2dede; border: 1px solid #ebccd1; padding: 3px 10px 10px;">'''Обратите внимание!'''При передаче заказов, у которых плановая дата доставки меньше ближайшей возможной, дата доставки автоматически меняется на самую раннюю возможную.</div>
Для стабильной работы необходимо наличие версии минимум 518 от 05.12.2014 у обеих компаний.
== Тарификация и выбор подрядчика и его тарифа клиентом ==
Вы можете настроить подключение своего тарифа к тарифу партнера. Партнерами могут быть любые — любой компании, работающие работающей в системе 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="23"|ДПДDPD||rowspan="23"|90011||rowspan="23"|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 обязательна.||10497, 90021, u23B0r9AAJ1Fyh4654MzJ3kjx1548wdx, pass, 100
|}
При выборе клиентом в личном кабинете вида срочности, подключенного таким образом к партнеру, набор доступных ПВЗ будет ограничен выбранным партнером.
== Интеграция с клиентами CMS-системами (получение заказов) ==
=== Замечания ===
=== 1C-Битрикс===
# В личном кабинете 1C-Битрикс на вкладке '''Администрирование''' в панели слева выберите '''Marketplace''' > '''Каталог решений''' и на странице «Каталог Маркетплейс» с помощью строки поиска найдите '''Модуль интеграции MEASoft'''.
# Щелкните по ссылке «Установить».
# В панели слева выберите '''Магазин''' > '''Настройки''' > '''Службы доставки''', затем на странице «Список служб доставок» раскройте выпадающий список кнопки '''Добавить''' и выберите пункт '''Автоматизированная служба доставки'''. Откроется страница «Новая служба доставки».
# На странице «Новая служба доставки» перейдите на вкладку '''Настройки обработчика''' и в выпадающем списке '''Служба доставки''' выберите '''"Курьерская служба" - сервис доставки'''. Нажмите на кнопку '''Применить'''.
# Перейдите на вкладку '''Настройки интеграции''': [[Файл:Bitrix Настройки интеграции.png|none|1100px800px]]
#: На этой вкладке:
#* в разделе '''Настройка Настройки доступа''' введите учетные данные личного кабинета в поля '''Логин''', '''Пароль''' и '''Код клиента'''. Запросите эти данные у курьерской службы, с которой настраивается интеграция. Поле Кнопка '''Код клиента ПВЗПроверить''' оставляем пустым (оно заполнится автоматически позднее)предназначена для проверки введенных учетных данных.
#* в разделе '''Основные настройки''':
#** в поле '''Оплата картой''' выберите тип оплаты, который будет соответствовать оплате картой (если оплата картой возможна);
#** установите флажок '''Использовать артикулы''', если артикулы будут использоваться для привязки номенклатуры к складу курьерской службы;
#* в разделе '''Соответствующие поля покупателя''' настройте соответствие полей получателя (ФИО, города, адреса и др.) полям в форме создания заказа;#* для работы с товарами, [[Маркировка|маркированными]] кодом «Честный ЗНАК», в разделе '''Соответствующие поля товаров''' укажите поле для хранения кода;#* в разделе '''Статусы отправки заказа''' выберите статусы, при которых заказ будет автоматически отправлен в курьерскую службу.
# На вкладке '''Ценовая политика доставки''' при необходимости настройте стоимость доставки для покупателя в зависимости от стоимости заказа.
# На вкладке '''Ограничения''' при необходимости укажите ограничения работы модуля по географии, типам оплаты и т.п.
#* в разделе '''Рабочий стол''' > '''Настройки''' > '''Настройки продукта''' > '''Настройки модулей''' > '''Курьерская служба''' в поле '''Города-отправители''' добавьте город отправителя;
#* в разделе '''Рабочий стол''' > '''Магазин''' > '''Настройки''' > '''Службы доставки''' > Нужная служба > '''Настройки интеграции''' > '''Город отправитель''' укажите добавленный выше город.
Проверить работу модуля можно в форме оформления доставки. При этом должна корректно считаться стоимость доставки.
==== Перенос даты доставки ====
Вы можете настроить перенос даты доставки на один день вперед от даты, получаемой от курьерской службы, если заказ оформлен позже определенного часа.
Чтобы настроить перенос даты доставки:
# В личном кабинете 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-Битрикс на вкладке '''Администрирование''' в панели слева выберите '''Настройки''' > '''Настройки продукта''' > '''Настройки модулей''' и на странице «Настройки модуля» в выпадающем списке выберите значение '''Курьерская служба'''.
# Установите флажки в списках ниже для сопоставления типов оплаты наложенного платежа.
# Нажмите на кнопку '''Сохранить'''.
Для предоплаченных заказов в карточке корреспонденции отображается сумма к оплате 0, при наличии товарных вложений добавляется вложение «Предоплата» с типом вложения '''Предоплата''' и ценой, равной сумме предоплаты, со знаком «минус». Поддерживается только полная предоплата.
==== Отправка заказа в курьерскую службу ====
Чтобы отправить заказ в курьерскую службу, зайдите в карточку заказа, укажите настроенное значение в поле '''Статус отправки заказа''' и нажмите на кнопку '''Сохранить'''.
Статус заказа можно проверить в карточке заказа, в правом верхнем углу.
#* некорректно установлен модуль;
#* введены некорректные учетные данные;
#* в курьерской службе не настроен тариф. Обратитесь в курьерскую службу для настройки тарифа. После настройки тарифы можно проверить в личном кабинете, на вкладке '''Калькулятор'''.
# По умолчанию при оформлении заказа должны появиться поля даты и времени желаемой доставки. Если они отсутствуют, то у формы были изменены стили. Также возможно обновление формы в системе Битрикс.[[Файл:Bitrix2.png|centernone|700 px]]# Проверьте правильность привязки свойств. Для этого в разделе '''Рабочий стол''' > '''Магазин''' > '''Настройки''' > '''Свойства заказа''' > '''Список свойств''' найдите свойство, связанное с ошибкой, щелкните по нему правой кнопкой мыши и выберите '''Изменить параметры свойства'''.<br>На вкладке '''Привязка свойства''' настраиваются условия, при которых поле будет показываться клиенту. Если у свойства заказа настроена привязка, то оно будет показываться ТОЛЬКО в том случае, когда покупатель выберет хотя бы один из указанных критериев:[[Файл:Битрикс Связь свойства.png|centernone|500px]]
В этом примере покупатель при оформлении заказа увидит созданное поле для заполнения только в том случае, если на предыдущих шагах он выбрал оплату '''Наличными курьеру''' (при любой службе доставки), или же если захотел расплатиться любым способом, но выбрал в качестве службы доставки '''Воздушный транспорт'''.
Подробнее см. [https://dev.1c-bitrix.ru/learning/course/index.php?COURSE_ID=42&LESSON_ID=3073&LESSON_PATH=3912.4580.4828.3073 документацию 1С-Битрикс].
=== InSales ===
Чтобы настроить статусы, в панели администрирования InSales выберите '''Настройки''' > '''Оформление заказа''' > '''Пользовательские статусы''' и создайте статусы, например «Передано в КС» и «Ошибка».
# В личном кабинете InSales откройте '''Приложения''' > '''Центр приложений''', с помощью строки поиска найдите модуль «Курьерская служба 2008» и нажмите на кнопку '''Установить'''.
# Откроется личный кабинет InSales. На странице «Установка приложения» нажмите на кнопку '''Установить'''.
# В списке установленных приложений выберите «Модуль "Курьерская служба 2008"». Откроется страница авторизации личного кабинета клиента курьерской службы. Если вы авторизованы в ЛК курьерской службы, то сразу откроется страница настроек, см. п. 5.
# Введите учетные данные личного кабинета в поля '''Логин''', '''Пароль''' и '''Код курьерской службы'''. Запросите эти данные у курьерской службы, с которой настраивается интеграция.
# На странице «Настройка интеграции "Insales"» Insales» выполните настройку интеграции.<br>Особенности заполнения полей:#* '''Отправлять заказы в курьерскую службу автоматически после изменения статуса'''. Используется Статус заказа для автоматической передачи заказов с определенным статусом в курьерскую службу. Возможные значения: '''Да''', '''Нет'''.#* '''Статус отправления заказа отправки в курьерскую службу (если отправляется автоматически)'''. Выберите из выпадающего списка заранее созданный статус, который будет использоваться для автоматической передачи заказов при установке которого заказ автоматически отправляется в курьерскую службу.#* '''Отправлять статус заказа в Insales'''. Определяет, отправляется ли статус успешной доставки заказа в InSales. Возможные значения: '''Да''', или значение '''НетНе отправлять'''.
#* '''Отправлять артикулы (для привязки к складу)'''. Если опция включена, артикулы товаров из InSales передаются в MeaSoft.
#* '''Название доставки курьером на странице заказа'''. Укажите название доставки, которое будет отображаться в заказе вместо «Курьерская доставка МЕАСОФТ» при выборе способа доставки. Можно оставить поле пустым, тогда список будет выглядеть следующим образом:[[Файл:Insales Delivery.png|none|800 px]]
#* '''Описание доставки курьером на странице заказа'''. Укажите описание вида доставки. Можно оставить поле пустым.
#* '''Синхронизировать остатки по складам'''. Если опция включена, данные по складским остаткам из курьерской службы передаются в InSales.
#* '''Используется мультисклад?'''. Определяет, используется ли выбор товаров с одного склада или из нескольких. Возможные значения: '''Да''', '''Нет'''. В случае работы с несколькими складами убедитесь, что в настройках InSales ('''Настройки''' > '''Настройки магазина''' > '''Мультисклад'''.) указано такое же количество складов, как в системе MeaSoft.
#* '''Специальный статус на случай ошибки Статус заказа при ошибке передачи заказав курьерскую службу'''. Выберите из выпадающего списка заранее созданный статус, который будет использоваться для обозначения заказов с ошибкой передачи данных, или укажите значение '''Не отправлять'''.#* '''Производить расчет без адреса?'''. Если выбрано значение '''Нет''', расчет стоимости доставки возможен только после ввода полного адреса получателя.
# По заполнении нужных полей нажмите '''Сохранить'''.
В результате в InSales в окне создания заказа появляется блок «Модуль "Курьерская служба 2008"»:
::[[Файл:Insales Module KS.png|none|300 px]]
==== Настройка типов оплаты ====
Тип оплаты заказа определяется следующим образом:
* если заказ оплачен, то передается тип оплаты '''Оплачен''';
* если тип оплаты '''Банковская карта''' передается, если в InSales используется один из следующих типов:** '''Оплата банковской картой''' или ;** '''Оплата банковской Банковской картой курьерупри получении''', то передается тип оплаты ;** '''Банковская картаОплата банковской картой курьеру'''. Указанные : Создайте эти типы оплаты необходимо создать в InSales вручную: '''Настройки''' > '''Оформление заказа''' > '''Оплата''';* иначе если название типа оплаты не совпадает с вышеперечисленными, передается тип оплаты '''Наличными'''.
В системе MeaSoft в карточке интернет-магазина есть флажок '''Спрашивать тип оплаты у получателя'''. Если он установлен, то независимо от переданного типа оплаты '''Наличными''' или '''Банковская карта''' покупателю будет предложен выбор способа оплаты.
#:
# В этом окне укажите следующие настройки:
#* введите учетные данные клиента курьерской службы. Запросите эти данные у курьерской службы, с которой настраивается интеграция. На рисунке указаны учетные данные тестового доступа;
#* Укажите тип доставки. Возможные значения: '''Курьером до двери''', '''ПВЗ'''.
# Нажмите на кнопку '''Сохранить'''.
Также в этом блоке вы можете проверить статус доставки заказа.
'''Примечание'''. Модуль поддерживает CS-Cart 4.10 и выше.
=== amoCRM ===
* Обработка координат.
===Мой СкладМойСклад===
Интеграция предназначена для передачи заказов с товарными вложениями из системы «Мой склад» МойСклад в 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-сертификат. ====Порядок установки плагина и вывод нового способа доставки в корзину:==== #В панели администратора вашего сайта откройте страницу “Плагины - '''Плагины''' > '''Добавить новый” новый''' и нажмите на кнопку “Загрузить плагин”'''Загрузить плагин'''.#В появившейся форме выберите архив с плагином на вашем компьютере и нажмите кнопку “Установить”'''Установить'''.#После загрузки и установки плагина вы можете его активировать нажав на соответствующую кнопку .#После активации плагина в меню появится ссылка на страницу настроек плагина.Заполните все необходимые поля и нажмите кнопку “Сохранить изменения”'''Сохранить изменения'''.#Откройте настройки WooCommerce и переключите на вкладку “Доставка”'''Доставка'''.#Выберите необходимую зону доставки, или создайте её.#Нажмите на кнопку “Добавить '''Добавить метод доставки” доставки''' и выберите из списка “КС2008”'''КС2008'''.#После создания заказа, в панели администратора, в форме изменения заказа, справа появится блок модуля "'''Отправить в курьерскую службу, снизу которого будет кнопка "''' с кнопкой '''Отправить заказ в КС2008"''', при нажатии на которую заказ будет отправлен в курьерскую службу.
====Обновление статусов====
Обновление статусов заказов происходит через технологию WP_Cron каждые 30 минут.
Если статус заказа в курьерской службе будет изменен на “Доставлен”'''Доставлен''', то статус заказа в вашем магазине также будет изменен на “Выполнен”'''Выполнен'''.
===Проверка работоспособности интеграций===
:: Если это ошибка ответа курьерской службы, сообщите об этом разработчику. Пример ошибки: «Служба доставки прислала ответ в неверном формате».
'''Мой складМойСклад'''
# При сбое интеграции проверьте, не изменен ли аккаунт, под которым создана интеграция:
## Логин учетных данных МойСклад, которые использовались при создании интеграции, вставьте в ссылку <nowiki>https://home.courierexe.ru/moysklad/step2?id=</nowiki>'''логин'''. Если при переходе по ссылке отображается этап настройки интеграции, значит аккаунт существует.
## Войдите в «МойСклад» под учетной записью, которая использовалась для настройки интеграции, и откройте справочник '''Сотрудники''': меню пользователя > '''Настройки''' > '''Справочники'''> '''Сотрудники'''. Откройте карточку сотрудника, под учетной записью которого вы вошли, и убедитесь, что его роль — администратор.
## Если хотя бы один из пунктов не выполнен, значит, аккаунт, использованный для создания интеграции, изменен.
# В личном кабинете клиента курьерской службы в настройках обратной интеграции '''Мой склад''' в поле '''В каком статусе "Мой склад" отправлять заказ на доставку''' уточните статус, при котором заказ отправляется в курьерскую службу.
# Заполните форму заказа, нажмите на кнопку '''Сохранить''', затем смените статус заказа на статус, установленный для отправки в курьерскую службу и снова нажмите на кнопку '''Сохранить'''. Если все верно, заказ будет отправлен в курьерскую службу.
# В личном кабинете клиента курьерской службы в настройках обратной интеграции '''InSales''' проверьте данные в следующих полях:
#* '''Список доставок для отправления заказа в курьерскую службу (если отправляется автоматически)''';
#* '''Оплачен ли заказ? (если отправляется автоматически)'''.
Ошибка при создании заказа отображается в левом нижнем углу.
== RBKИнтеграция с платежными сервисами == Доступна интеграция со следующими сервисами:* PimPay — финансирование для интернет-магазинов;* Robokassa — онлайн-оплата заказов;* ibox — мобильный эквайринг. Сервисы настраиваются в [[Личный кабинет курьерской службы#Вкладка «Финансы»|личном кабинете курьерской службы]].money === Robokassa === Чтобы настроить прием платежей через систему «RBK.money»сервис Robokassa:# Перейдите по ссылке Зарегистрируйтесь в сервисе [https://welcomepartner.rbkrobokassa.moneyru/ Reg Robokassa].# В [[Личный кабинет курьерской службы#Вкладка «Финансы»|настройках личного кабинета]] курьерской службы введите идентификатор магазина и пароли из личного кабинета Robokassa.# Установите флажок '''Тестовый режим''' и нажмите на кнопку '''ПодключитьсяСохранить'''. С вами свяжутся сотрудники # Откройте [[Личный кабинет курьерской службы#Отслеживание заказа по номеру|страницу отслеживания]] любого заказа с наложенным платежом и вышлют инструкцию для заключения договора оплатой картой и дальнейшей работыубедитесь, что кнопка '''Оплатить картой''' появилась.# После завершения регистрационных действий введите полученный публичный ключ и идентификатор в В настройках личного кабинета курьерской службыснимите флажок '''Тестовый режим''' и нажмите на кнопку '''Сохранить'''. Подробнее см В результате получатель может оплатить заказ онлайн на странице отслеживания https://home. courierexe.ru/XX/tracking, где XX — код вашей курьерской службы: [[Личный кабинет курьерской службы#Вкладка «Финансы»Файл:Robokassa.png|none|настройки личного кабинета900 px]] При успешной оплате заказ в MeaSoft отмечается как оплаченный. В окне отслеживания в поле '''Наложенный платеж''' статус заказа изменится на '''Заказ оплачен'''. Чек по операции придет на электронную почту, указанную при заказе. === PimPay ===
Для каждого клиентаподтверждения успешной транзакции или отмены оплаты MeaSoft получает обратные вызовы (вебхуки) от ibox:* при успешной оплате после установки статуса корреспонденции со слов курьера '''Доставлено''' или '''Частично доставлено''' в MeaSoft на вкладке '''Выдача''' подсвечивается поле '''Тип оплаты''':** зеленым цветом, который хочет передавать данные если оплата картой, есть идентификатор транзакции и сумма транзакции верная;** желтым цветом, если оплата картой, есть идентификатор транзакции, но сумма транзакции не совпадает со значением поля '''Сумма руб''' в PimPay необходимо зарегистрировать в личном кабинете PimPayкарточке корреспонденции;** красным цветом, если оплата картой и в нашей системе выбрать платежного посредника на вкладке "Финансы" карточки клиента. В процессе передачи данных привязка клиентов между системами производится по ИННнет идентификатора транзакции. Наша система начинает передавать все заказы вашего клиента *: Если в PimPayкарточке корреспонденции указан тип оплаты '''Наличными''', то поле будет закрашено красным, если есть идентификатор безналичной транзакции или указана ее сумма. Если их статусынет, то поле будет зеленым;* при отмене оплаты обратный вызов удаляет идентификатор транзакции, чтобы сделать возможной повторную доставку и созданные [[Акты Передачи Денег и корреспонденции (АПД)|АПД]]. Обратно она ничего не получаетоплату заказа картой.
== Диадок ==
=== Начальная настройка ===
# Обратитесь в [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-ключ приобретается отдельно на каждое ваше юр. юридическое лицо, поэтому его нужно вводить в "'''Фирмы"'''.
# В системе Диадок откройте '''Настройки и оплата''' > '''Сотрудники''' и выберите сотрудника, который будет отвечать за подписание документов. В карточке сотрудника перейдите на вкладку '''Данные по сертификатам''' и в группе полей '''Область полномочий''' установите полномочия для входящих и исходящих документов. Нажмите на кнопку '''Сохранить'''.
# Заполните данные подключения в системе:
## В переменной <mparam code="EDocProvider"/> выберите '''Диадок'''.
## Введите API-ключ в '''Справочники''' > '''Фирмы''' > '''Карточка фирмы''' > '''Ключ ЭДО'''.
## Если в вашем токене несколько сертификатов, в поле <mparam code="EDocLogin"/>укажите отпечаток без пробелов значение отпечатка сертификата, который нужно использовать. Если пусто, программа постарается выбрать сертификат сама по доступности компании, к которой производится подключение. Чтобы просмотреть отпечаток, в меню '''Пуск''' выберите '''Программы''' > '''Крипто-ПРО''' > '''Сертификаты пользователя''' > '''Личное''' > '''Сертификаты'''. Справа выберите нужный сертификат, откройте. Перейдите на вкладку '''Состав''', прокрутите список значений вниз, в самом низу выберите '''Отпечаток'''.
## В поле <mparam code="EDocPass"/>введите пин-код сертификата. Если вы его не меняли, можно пропустить: по умолчанию пин-код рутокена «12345678», и программа сама будет его использовать, если вы ничего не указали. Если он окажется неправильным, Крипто-ПРО спросит у вас верный пин-код при передаче данных. Обратите внимание, что количество попыток ввода пин-кода ограничено.
# После ввода данных подключения выйдите из системы и запустить программу от имени администратора: в контекстном меню ярлыка MeaSoft выберите пункт '''Запуск от имени администратора'''. Чтобы осуществить обмен данными, выберите '''Связь''' > '''Обмен с ЭДО'''. При первом использовании программа установит на компьютер специальный COM-объект Диадока. Именно для этого нужны права. В дальнейшем она будет использовать уже установленный компонент, и наличия прав не требуется.
=== Обмен данными с ЭДО ===
Выберите в главном меню "Связь" -> "Обмен с ЭДО". Откроется окно с выпадающим списком фирм, у которых заполнено поле "Ключ ЭДО". Выберите фирму, и нажмите "Обмен!". Программа выполнит все операции, которые периодически нужно выполнять, чтобы иметь актуальные данные как в нашей системе так и в ЭДО:
*Синхронизирует справочники контрагентов: Получит список контрагентов, уже являющихся вашими партнерами в ЭДО, проставит им соответствующие признаки (На вкладке "Клиенты" появилось новое поле "Статус ЭДО". Это поле нельзя менять, оно устанавливается автоматически), проверит, кто прислал вам приглашения к партнерству и примет их, разошлет приглашения всем вашим работающим контрагентам, проверит, кто принял приглашение, а кто - отказался.
=== Отправка документов ===
К отправке сейчас доступны счета, АПД и АПК. Отправка работает крайне похоже на e-mail. Документы формируются точно так же, но отправляются не почтой, а в ЭДО, уже подписанными вашей ЭЦП. В системе ЭДО "адресами" отправителя и получателя являются ИНН (по возможности еще КПП, но это не обязательно) компании, поэтому, чтобы все работало, ИНН должен быть заполнен. Так же ЭДО примет документы только в адрес компании, с которой у вас отмечены партнерские отношения, т.е. кто-то из вас отправил приглашение, а другой его принял. Поэтому, для удобства контроля - кому можно таким образом отправлять, а кому - нет, в списках документов добавлено поле "Есть ЭДО". Там галка ставится на основании статуса ЭДО клиента. Можете отсортировать по этому полю, выдели все, где есть галки, и разослать всем документы по ЭДО.
== Телефония ==
Основная статья: [[Интеграция с телефонией]]
== GPS-трекинг автотранспорта ==
Для поддержки GPS-трекинга автотранспорта у нас разработана интеграция с коробочной системой Wialon, на которой работают большинство компаний, предоставляющих подобные услуги. Обратитесь в службу технической поддержки для помощи в настройке.
