Изменения

Система "Курьерская служба 2008" MeaSoft имеет практически не ограниченные неограниченные возможности по интеграции с другими системами. В этой статье мы рассмотрим виды и способы интеграции.

== Интеграция между 2-мя двумя клиентами системы MeaSoft "Курьерская служба 2008" ==

Один из клиентов (Клиент) отправляет заказы другому клиенту (Агенту), Агент доставляет отправления, и передает их статусы, которые загружаются в систему Клиента.

Интеграция может быть и двунаправленная, когда одна компания заказывает доставку у второй, а вторая - — у первой.

В этом случае нужно настроить 2 интеграции по данной инструкции, : в одной нужно рассматривать одну компанию – клиентом, вторую – — агентом, во второй интеграции – наоборот.

ИтакПорядок действий:# Обе компании должны иметь аккаунты в системе MeaSoft ('''Справочники''' > '''Дополнительные модули''') и у обеих компаний должен быть установлен флажок '''Личный кабинет''' в окне «Управление дополнительными модулями».# '''Агент''' создает клиента в своей системе на вкладке '''Клиенты'''. На вкладке '''Прочее''' карточки клиента указывает логин и пароль для входа в Личный кабинет.# '''Агент''' передает клиенту логин, по пунктампароль (из предыдущего шага) и свой идентификатор в системе MeaSoft:[[Файл:Measoft id.png|600px|none]][[Файл:Measoft home.png|none|600px]]# '''Клиент''' создает в своей системе филиал ('''Справочники''' > '''Межгород''' > '''Филиалы''') для указанного агента. После ввода филиала нужно перевойти в программу и подождать 3 минуты.# '''Клиент''', получив данные из п. 2, заходит в свой Личный кабинет в системе MeaSoft, переходит на вкладку '''Интеграция'''. В таблице должен появиться созданный филиал.# '''Клиент''' нажимает на кнопку '''Настроить''' напротив филиала, в открывшемся окне выбирает интегратор «MeaSoft», заполняет поля '''Логин''', '''Пароль''' и '''Код клиента''' учетными данными, полученными в п. 3, и нажимает '''Сохранить'''.

1) <div style="color: #a94442; background-color: #f2dede; border: 1px solid #ebccd1; padding: 3px 10px 10px;">'''Обе компанииОбратите внимание!''' должны иметь аккаунты в системе MeaSoft («Справочники» – «Дополнительные модули»)При передаче заказов, и у обеих компаний должна быть установлена галка «Личный кабинет» в указанном выше окнекоторых плановая дата доставки меньше ближайшей возможной, дата доставки автоматически меняется на самую раннюю возможную.</div>

2) '''Агент''' создает клиента в своей системе (на закладке «Клиенты»). На закладке «Прочее» карточки клиента указывает логин и пароль для входа в Личный кабинет. 3) '''Агент''' передает клиенту Логин, Пароль (из предыдущего шага), а так же свой идентификатор в системе MeaSoft (см. иллюстрацию). [[Файл:Measoft id.png|thumb|200px|right|рис.1 Код экстра-клиента]] 4) '''Клиент''' создает в своей системе филиал (Справочники – Межгород – Филиалы) для указанного агента. После ввода филиала нужно перевойти в программу и подождать 3 минуты. 5) '''Клиент''', получив данные из п. 3, заходит в свой личный в системе MeaSoft (см. иллюстрацию). Переходит на закладку «Интеграция». В таблице должен появиться созданный филиал. [[Файл:Measoft home.png|thumb|200px|right]] 6) '''Клиент''' нажимает кнопку «Настроить» напротив филиала, в открывшемся окне выбирает интегратор «MeaSoft», далее – заполняет форму – «Логин», «Пароль», и «Код клиента» данными, полученными в п. 3, нажимает «Сохранить».  В результате такой настройки, все отправления, у которых Клиент установит «Ответственный филиал», соответствующий Агенту (правильнее всего это делать оформив [[Манифесты|манифест]], скомплектовав его, и проставив дату отправки), будут переданы в БД Агента, и статусы будут передаваться обратно. На передачу данных может уходить до 10 минут в штатном режиме, и до 1 часа в случае возможных сбоев. Для стабильной работы необходимо наличие версии минимум 518 от 05.12.2014 у обеих компаний.

Хотим обратить Ваше ваше внимание на то, что интеграции со сторонними системами делаются в соответствии с документацией на момент написания, без партнерства с компаниями-поставщиками сервиса. Об изменениях API нас не оповещают, поэтому интеграции, по независящим от нас причинам, могут переставать работать, работать нестабильно или некорректно, вплоть до потери важной (финансовой?) информации. Заказы, переданные во внешние системы , нужно обязательно проверять на корректность , пользуясь личным кабинетом партнера.

Чтобы передать услугу «Примерка», установите флажок '''Принято на склад''' в [[Единица корреспонденции#Создание единицы корреспонденции#Вручную|карточке корреспонденции]]. Если услуга не нужна, снимите флажок.

Вы можете настроить подключение своего тарифа к тарифу партнера. Партнерами могут быть любые — любой компании, работающие работающей в системе MeaSoft, а также ряд ряду компаний, с которыми у нас есть интеграции, см. список ниже. Для этого откройте  Чтобы настроить подключение к тарифу партнера:# Зарегистрируйтесь в системе подрядчика. Данные аккаунта понадобятся для настройки интеграции.# Откройте '''Справочники''' > '''Статусы''', выберите > '''17 Виды срочности'''. Создайте и создайте вид срочности, например «СДЭК». # В контекстном меню вида срочности выберите пункт '''Дополнительная информация''' и во второй строке заполните параметры подключения к партнеру через запятую:#* 1-й параметр — код филиала партнера, его можно посмотреть в '''Справочники''' > '''Межгород''' > '''Филиалы''';#* 2-й параметр — экстра-код партнера в системе MeaSoft. В том числе для сторонних компаний есть коды, см. таблицу ниже;#* 3-й параметр — имя пользователя в системе партнера. Может отличаться от того, под которым работает интеграция, здесь нужно для расчета цены для клиента. В таблице ниже указано, что вводить для каждого интегратора;#* 4-й параметр — пароль пользователя из 3-го параметра. В таблице ниже указано, что вводить для каждого интегратора;#* 5-й параметр — вид срочности партнера. Посмотреть доступные коды видов срочности можно по ссылке в таблице ниже, в калькуляторе в выпадающем списке. Можно в одинарных кавычках указать несколько видов срочности через запятую, тогда система будет стараться выбрать из них первый доступный;#* 6-й параметр — наценка к цене, передаваемой подрядчиком. В деньгах или в процентах, если стоит знак процента. Например, 10 — наценка 10 рублей, 10% — наценка 10 процентов;#* 7-й параметр — если указать значение '''1''', сквозная тарификация выключена. Параметр используется, если подключение нужно только для передачи заказов по интеграции, а расчет цены не нужен.# Нажмите на кнопку '''OK'''.

|CDEKrowspan="2"|СДЭК||rowspan="2"|90005||rowspan="2"|https://home.courierexe.ru/90005/calculator||Введите код учетной записи в 3-й параметр, секретный код — в 4-й. Можно оба оставить пустыми для расчета базовых цен.||45491, 90005, hfenJwlasiPr4pnFENpaVXSKPIn5Trh7i, '9vkQgWuiZgEj9fGCB8a6Xj3desnJkwsl,1.5', 5, 30%|-||Если вы хотите добавить в расчет тарифа процент за наложенный платеж, после пароля добавьте запятую и число процента. В настройке режима срочности пароль с числом процентов заключите в кавычки.||9vkQgWuiZgEj9fGCB8a6Xj3desnJkws,1.5

|rowspan="23"|ДПДDPD||rowspan="23"|90011||rowspan="23"|https://home.courierexe.ru/90011/calculator||Введите клиентский номер в 3-й параметр, клиентский ключ в 4-й. Можно оставить пустыми для базовых тарифов.||12504, 90011, 1019003662, '4CCB11864D06157A5934A9119F2A0AAAAAB4CCE8,D117', '3, 6', 10%

|ДОСТАВКА ГУРУ-|colspan="2"|ВНИМАНИЕ! У DPD есть 2 калькулятора, которые считают по-разному при одних и тех же вводных данных. При этом они не разглашают, по какому из расчетов определяют цену. Поэтому по не зависящим от нас причинам расчет по тарифам DPD может как совпасть с итоговым, так и сильно разойтись. Если вас это не устраивает, не используйте сквозную тарификацию с этим подрядчиком.|-|DOSTAVKA.GURU||90017||https://home.courierexe.ru/90017/calculator||3-й параметр — ID партнера в системе DOSTAVKA.guru, 4-й — ключ доступа. Можно оставить пустыми.

|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

При отправке заказа по интеграции с подключенным видом срочности интеграция постарается отправить заказ одним из режимов, введенных в п.6 (по порядку, в порядке приоритетов), а если не получится — вернет ошибку. Также можно для любой компании Вы можете войти в личный кабинет по адресу вида https://home.courierexe.ru/90005 XXX, где в конце XXX — экстра-код партнера, авторизоваться данными из 3-го и 4-го параметров (см. таблицу выше) и воспользоваться калькулятором с тарифами именно вашей компании.

== Интеграция с клиентами CMS-системами (получение заказов) ==

Чтобы настроить интеграцию:==== Настройка интеграции ==== 

# Перейдите на вкладку '''Настройки интеграции''': [[Файл:Bitrix Настройки интеграции.png|none|1100px800px]]

#* в разделе '''Настройка Настройки доступа''' введите учетные данные личного кабинета в поля '''Логин''', '''Пароль''' и '''Код клиента'''. Запросите эти данные у курьерской службы, с которой настраивается интеграция. Поле Кнопка '''Код клиента ПВЗПроверить''' оставляем пустым (оно заполнится автоматически позднее)предназначена для проверки введенных учетных данных.

#* в разделе '''Соответствующие поля покупателя''' настройте соответствие полей получателя (ФИО, города, адреса и др.) полям в форме создания заказа;#* для работы с товарами, [[Маркировка|маркированными]] кодом «Честный ЗНАК», в разделе '''Соответствующие поля товаров''' укажите поле для хранения кода;#* в разделе '''Статусы отправки заказа''' выберите статусы, при которых заказ будет автоматически отправлен в курьерскую службу.

Для предоплаченных заказов в карточке корреспонденции отображается сумма к оплате 0, при наличии товарных вложений добавляется вложение «Предоплата» с типом вложения '''Предоплата''' и ценой, равной сумме предоплаты, со знаком «минус». Поддерживается только полная предоплата. '''Примечание'''. Проверить работу модуля можно в форме оформления доставки. При этом должна корректно считаться стоимость доставки.==== Возможные ошибки ====

<spoiler text="Если возникает ошибка"># Если не рассчитывается стоимость, возможные причины:

# По умолчанию при оформлении заказа должны появиться поля даты и времени желаемой доставки. Если они отсутствуют, то у формы были изменены стили. Также возможно обновление формы в системе Битрикс.[[Файл:Bitrix2.png|centernone|700 px]]# Проверьте правильность привязки свойств. Для этого в разделе '''Рабочий стол''' > '''Магазин''' > '''Настройки''' > '''Свойства заказа''' > '''Список свойств''' найдите свойство, связанное с ошибкой, щелкните по нему правой кнопкой мыши и выберите '''Изменить параметры свойства'''.<br>На вкладке '''Привязка свойства''' настраиваются условия, при которых поле будет показываться клиенту. Если у свойства заказа настроена привязка, то оно будет показываться ТОЛЬКО в том случае, когда покупатель выберет хотя бы один из указанных критериев:[[Файл:Битрикс Связь свойства.png|centernone|500px]]

Чтобы настроить интеграцию:==== Настройка интеграции ==== 

# На странице «Настройка интеграции "Insales"» Insales» выполните настройку интеграции.<br>Особенности заполнения полей:#* '''Отправлять заказы в курьерскую службу автоматически после изменения статуса'''. Используется Статус заказа для автоматической передачи заказов с определенным статусом в курьерскую службу. Возможные значения: '''Да''', '''Нет'''.#* '''Статус отправления заказа отправки в курьерскую службу (если отправляется автоматически)'''. Выберите из выпадающего списка заранее созданный статус, который будет использоваться для автоматической передачи заказов при установке которого заказ автоматически отправляется в курьерскую службу.#* '''Отправлять статус заказа в Insales'''. Определяет, отправляется ли статус успешной доставки заказа в InSales. Возможные значения: '''Да''', или значение '''НетНе отправлять'''.

#* '''Специальный статус на случай ошибки Статус заказа при ошибке передачи заказав курьерскую службу'''. Выберите из выпадающего списка заранее созданный статус, который будет использоваться для обозначения заказов с ошибкой передачи данных, или укажите значение '''Не отправлять'''.#* '''Производить расчет без адреса?'''. Если выбрано значение '''Нет''', расчет стоимости доставки возможен только после ввода полного адреса получателя.

::[[Файл:Insales Module KS.png|none|400 300 px]] ==== Настройка типов оплаты ==== 

* если тип оплаты '''Банковская карта''' передается, если в InSales используется один из следующих типов:** '''Оплата банковской картой''' или ;** '''Оплата банковской Банковской картой курьерупри получении''', то передается тип оплаты ;** '''Банковская картаОплата банковской картой курьеру'''. Указанные : Создайте эти типы оплаты необходимо создать в InSales вручную: '''Настройки''' > '''Оформление заказа''' > '''Оплата''';* иначе если название типа оплаты не совпадает с вышеперечисленными, передается тип оплаты '''Наличными'''.

Чтобы настроить интеграцию:# В RetailСRM cоздайте API-ключСм. Для этого откройте '''Администрирование''' > '''Интеграция''' > '''Ключи доступа к API''' и нажмите на кнопку '''Добавить'''. Откроется страница «Новый ключ API». На этой странице:## В поле '''Комментарий''' введите краткое описание интеграции, например «По городу».## В поле '''Тип доступа''' выберите '''Доступ ко всем магазинам'''.## В списке '''Разрешенные методы API''' установите все флажки.## Нажмите на кнопку '''Сохранить'''.#: API-ключей может быть несколько, и для каждого API-ключа необходимо выполнить эти настройки. Подробнее об управлении API-ключами см. [https://help.retailcrm.ru/Users/ApiKeys документацию RetailCRM].# Настройте интеграцию в [[Личный кабинет клиента#Интеграция|личном кабинете клиента MeaSoft]]:## Выберите пункт основного меню '''Автоматизация''', перейдите на вкладку '''Обратная интеграция''' и на странице «Список всех обратных интеграций» в строке RetailCRM нажмите '''Добавить'''. ## В окне «Настройка интеграции "RetailCRM"» укажите название интеграции, домен RetailCRM, созданный выше API-ключ. При необходимости укажите значения других полей.#: Если нужно, чтобы в RetailCRM отображался статус платежа после доставки заказа, заполните поле '''Получать статус платежа (укажите символьный код статуса платежа)'''. Чтобы увидеть символьный код платежа, в RetailCRM выберите '''Администрирование''' > '''Справочники''' > '''Статусы оплат'''.#: По завершении настройки нажмите '''Сохранить'''.# Настройте интеграцию в RetailCRM:## Откройте '''Администрирование''' > '''Справочники''' и на вкладке '''Типы доставок''' нажмите на кнопку '''Добавить'''. Откроется окно «Новая доставка»:[[Файл:Retail1.png|none|700 px|]]## В этом окне заполните обязательные поля и в выпадающем списке '''Интегрировать с''' выберите значение '''"Курьерская служба 2008"''', затем нажмите '''Сохранить'''.## Чтобы настроить корректную передачу наложенного платежа, откройте '''Администрирование''' > '''Интеграция''' и выберите модуль MEASOFT. Затем на странице «Настройки интеграции с Курьерская служба 2008» перейдите на вкладку '''Доставка''' и на панели справа выберите пункт '''Способы оплаты'''. Установите флажки для способов оплаты, которые могут использоваться для передачи наложенного платежа.[[Файл:Retail5.png|none|600 px]] Чтобы проверить настройки интеграции:# Перейдите в форму создания заказа и убедитесь, что в списке '''Способ доставки''' появилось соответствующее значение:[[Файл:Retail2.png|none|600 px]]# Нажмите '''Выбрать тариф'''. Тарифы должны передаваться из настроек курьерской службы:[[Файл:Retail3.png|none|600 px]]<br>В случае ошибки обратитесь в курьерскую службу для настройки тарифов. Проверить тарифы можно в ЛК в разделе '''Калькулятор'''. Чтобы в RetailCRM формировать печатные формы, аналогичные формам в личном кабинете, используйте один из следующих способов:* в сохраненном заказе на панели действий сверху нажмите '''Печать''' и выберите нужную печатную форму «Курьерская служба»;* в списке заказов отметьте заказы флажками, внизу страницы нажмите '''Действия''' > '''Распечатать документы''' и выберите печатную форму «Курьерская служба». Чтобы отправлять заказы в курьерскую службу по статусам и отменять при изменении типа доставки, используйте триггеры. Подробнее о настройке триггеров см. в разделе раздел «[[Настройка триггеров для RetailCRM]]». '''Примечание'''. Интеграция привязана к личному кабинету клиента курьерской службы. При необходимости работать из другого личного кабинета создайте новую интеграцию, начиная с пункта настройки в личном кабинете.

=== cs.cart CS-Cart ===

# В панели администратора cs.cart CS-Cart откройте '''Модули''' > '''Управление модулями''' и на странице «Модули» нажмите на кнопку [[Файл:Cscart добавить.png|25 px]]. Откроется окно «Загрузить и установить модуль».

#* введите учетные данные клиента курьерской службы. Запросите эти данные у курьерской службы, с которой настраивается интеграция. На рисунке указаны учетные данные тестового доступа;

===Мой СкладМойСклад=== Интеграция предназначена для передачи заказов с товарными вложимыми вложениями из системы "Мой склад" МойСклад в систему "Курьерская служба 2008"MeaSoft. В обратную сторону Обратно в МойСклад будут приходить статусы, стоимость доставки и общая сумма заказа с учетом частичной доставки.

Чтобы настроить интеграцию:# В системе МойСклад создайте дополнительные поля в заказах:#* с типом «Строка»:#** '''Город''' — для указания населенного пункта получателя;#** '''Дата доставки''' — для указания даты доставки наряду со временем;#** '''Сумма заказа''' — для получения суммы заказа от курьерской службы;#** '''Стоимость доставки''' — для получения стоимости доставки от курьерской службы;#** '''Строка для сохранения информации об ошибках''' — для получения текста ошибки;#** '''Количество мест''' — для возможности указания количества мест;#* с типом «Файл»:#** '''Файл''' — необязательное поле для передачи файлов. Максимальный размер файла — 1 МБ;#* с типом «Справочник»:#** '''Виды срочности''' — одноименный справочник;#** '''Временные интервалы''' — одноименный справочник;#** '''Способы доставки''' — одноименный справочник;#** '''Тип оплаты''' — одноименный справочник;#** '''Время доставки с''' — справочник '''Часы доставки''';#** '''Время доставки по''' — справочник '''Часы доставки'''.# Перейдите по [https://home.courierexe.ru/moysklad/step1 ссылке] и введите логин и пароль от учетной записи системы «МойСклад» с правами администратора.<br><br>'''Примечание'''Как настроить. Запрещено изменять данные этой учетной записи — это приведет к сбою интеграции. В будущем при обращении в техническую поддержку MeaSoft указывайте данные этой учетной записи для получения помощи по вопросам интеграции.<br>Если все же есть необходимость сменить учетные данные, после сообщите новый пароль от «МойСклад» в техподдержку MeaSoft для внесения изменений в настройки интеграции.<br><br># Укажите логин, пароль и код курьерской службы. Запросите эти данные у курьерской службы, с которой настраивается интеграция.# Нажмите на кнопку '''Сохранить'''.<br>В случае ошибки «Данный пользователь "Мой склад" уже зарегистрирован.» нажмите на кнопку '''Сбросить'''.# Дождитесь окончания синхронизации справочников. Не закрывайте и не перезагружайте страницу. Процесс может занять продолжительное время (от 10 минут).<br>После синхронизации справочников автоматически произойдет переход на страницу следующего шага.# Настройте статусы отправки, соответствие полей и соответствие статусов.# Сохраните настройки.

# Пройти по ссылке https://home.courierexe.ru/moysklad/step1. Ввести логин и пароль от "Моего склада", а также логин, пароль и код экстраклиента от курьерской службы.# В случае ошибки "Данный пользователь "Мой склад" уже зарегистрирован." необходимо сбросить настройки одноименной кнопкой (появится в случае ошибки).# !ВАЖНО! Подождать пока синхронизируются справочники. Не закрывать и не перезагружать страницу. Данный процесс может занять продолжительное время (от 10 минут).# После синхронизации справочников, автоматически произойдет переход на страницу следующего шага.# !ВАЖНО! до выполнения настроек необходимо перейти в систему МойСклад и создать дополнительные поля в заказах в системе Мой Склад:#* строковые:#** "Город" - для указания населенного пункта получателя#** "Дата доставки" - для указания даты доставки наряду со временем#** "Сумма заказа" - для получения суммы заказа от КС#** "Стоимость доставки" - для получения стоимости доставки от КС#** "Строка для сохранения информации об ошибках" - для получения текста ошибки;#** "Количество мест" - для возможности указания количества мест;#* с типом '''"Файл"''':#** "Файл" - необязательное поле. Создается, если хотите передавать файлы. Максимальный размер - 1 МБ.#* с типом '''"Справочник"''':#** "Виды срочности" (одноименный справочник),#** "Временные интервалы" (одноименный справочник),#** "Способы доставки" (одноименный справочник),#** "Тип оплаты" (одноименный справочник),#** "Время доставки с" (справочник '''Часы доставки'''),#** "Время доставки по" (справочник '''Часы доставки''').# Перейти к шагу 4, обновить страницу. Вы увидите настройки, где нужно настроить статусы отправки, соответствие полей и соответствие статусов.# Сохранить настройки.# !ВАЖНО! Для отправки заказа обязательно должен быть заполнен вес товара (хотя бы одного)товара.

При заполнении информации по заказу поля стоимость '''Cтоимость доставки''', сумма '''Сумма''' и ошибка '''Ошибка''' заполнять не нужно. Они заполнятся автоматически после синхронизации с курьерской службой.

Поле "Тип доставки" - если пустое, значит Если нужна доставка по адресу, оставьте поле '''Тип доставки''' пустым. Иначе выбираем выберите ПВЗ из списка.

Данные из поля "'''Комментарий" ''' передаются в заказ автоматически.

'''Как Чтобы отправить заказ'''Переключите статус заказа на , присвойте заказу статус для передачи в курьерскую службу. В этот момент "Мой Склад" сообщает нашей системе об этом событии и она забирает заказ, добавляет его в курьерскую службу.Если после сохранения заказа в статусе для передачи Заказ отправляется в курьерскую службу статус не изменился необходимо проверить поле "ошибка". Необходимо дозаполнить поля указанные в поле "ошибка", очистить поле "ошибка" и сохранить заказ.

Если после сохранения заказа в статусе для передачи в курьерскую службу статус не изменился, проверьте поле '''Как проверитьОшибка'''. Заполните поля, указанные в поле '''Ошибка''', очистите поле '''Ошибка''' и сохраните заказ.

Зайти Чтобы проверить, передан ли заказ в курьерскую службу, зайдите в Личный кабинет курьерской службы и проверить проверьте с помощью вкладки отслеживание '''Отслеживание''', существует ли отправленный заказ.

!ВАЖНО! Модуль интеграции не работает на бесплатном тарифе!. При установке приложения в "Моем Складе" наша система «Моем Складе» в нем регистрирует регистрируется <rspoiler text="событие">т.н. веб-хук</rspoiler>, на изменение заказа, чтобы "Мой Склад" нас извещал об изменениях«Мой Склад» передавал изменения в MeaSoft. Так работают все модули служб доставки для МС«Моего Склада». Проблема в том, что МС «Мой Склад» поддерживает только одно подобное событие для заказа, поэтому, если оно занято другим <rspoiler text="установленным модулем">А иногда бывает, что Или модуль удалили, может быть удален или не до конца установилиустановлен, а зарегистрированное событие от него осталось</rspoiler>, в этом случае мы MeaSoft не сможем сможет его занять, и отправка заказов, к сожалению, работать не будет. Если у вас не отправляются заказы, и вы уверены, что у вас нет других модулей, использующих это событие, обратитесь к нам в службу поддержки, мы сможем проверить занятость события и при необходимости его освободить.

====Требования к сайту ==== # CMS WordPress версии 5 или более новая;# WooCommerce версии 3.9 или более новая;# PHP версии 7 или более новая;# сайт должен использовать SSL-сертификат. ====Порядок установки плагина и вывод нового способа доставки в корзину:==== #В панели администратора вашего сайта откройте страницу “Плагины - '''Плагины''' > '''Добавить новый” новый''' и нажмите на кнопку “Загрузить плагин”'''Загрузить плагин'''.#В появившейся форме выберите архив с плагином на вашем компьютере и нажмите кнопку “Установить”'''Установить'''.#После загрузки и установки плагина вы можете его активировать нажав на соответствующую кнопку .#После активации плагина в меню появится ссылка на страницу настроек плагина.Заполните все необходимые поля и нажмите кнопку “Сохранить изменения”'''Сохранить изменения'''.#Откройте настройки WooCommerce и переключите на вкладку “Доставка”'''Доставка'''.#Выберите необходимую зону доставки, или создайте её.#Нажмите на кнопку “Добавить '''Добавить метод доставки” доставки''' и выберите из списка “КС2008”'''КС2008'''.#После создания заказа, в панели администратора, в форме изменения заказа, справа появится блок модуля "'''Отправить в курьерскую службу, снизу которого будет кнопка "''' с кнопкой '''Отправить заказ в КС2008"''', при нажатии на которую заказ будет отправлен в курьерскую службу.

Если статус заказа в курьерской службе будет изменен на “Доставлен”'''Доставлен''', то статус заказа в вашем магазине также будет изменен на “Выполнен”'''Выполнен'''.

'''Мой складМойСклад'''

#* '''Отправлять заказы в курьерскую службу автоматически после изменения статуса''';#* '''Статус отправления заказа для автоматической отправки в курьерскую службу (если отправляется автоматически)''';

== 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 ===

При успешной оплате заказ Чтобы начать работать с [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

ДалееМобильный эквайринг ibox доступен через приложение или <rspoiler text="SDK">SDK — это средства разработки, необходимо прописать настройки для pimpay в панели управления нашего ЛК (смкоторые позволяют приложению MeaSoft взаимодействовать с POS-терминалом напрямую. рис</rspoiler>.1)Подробнее см. В ЛК PimPay нужно посмотреть код компании (у них называется "Код платформы") и токен, ввести их в формураздел [[Мобильное приложение курьера для Android#ibox|«ibox»]].

Для каждого клиентаподтверждения успешной транзакции или отмены оплаты MeaSoft получает обратные вызовы (вебхуки) от ibox:* при успешной оплате после установки статуса корреспонденции со слов курьера '''Доставлено''' или '''Частично доставлено''' в MeaSoft на вкладке '''Выдача''' подсвечивается поле '''Тип оплаты''':** зеленым цветом, который хочет передавать данные если оплата картой, есть идентификатор транзакции и сумма транзакции верная;** желтым цветом, если оплата картой, есть идентификатор транзакции, но сумма транзакции не совпадает со значением поля '''Сумма руб''' в PimPay необходимо зарегистрировать в личном кабинете PimPayкарточке корреспонденции;** красным цветом, если оплата картой и в нашей системе выбрать платежного посредника на вкладке "Финансы" карточки клиента. В процессе передачи данных привязка клиентов между системами производится по ИННнет идентификатора транзакции. Наша система начинает передавать все заказы вашего клиента *: Если в PimPayкарточке корреспонденции указан тип оплаты '''Наличными''', то поле будет закрашено красным, если есть идентификатор безналичной транзакции или указана ее сумма. Если их статусынет, то поле будет зеленым;* при отмене оплаты обратный вызов удаляет идентификатор транзакции, чтобы сделать возможной повторную доставку и созданные [[Акты Передачи Денег и корреспонденции (АПД)|АПД]]. Обратно она ничего не получаетоплату заказа картой.

Для того, чтобы платежи Чтобы настроить работу обратных вызовов:# В личном кабинете курьерской службы в разделе '''Управление ЛК''' > '''Параметры''' > '''Финансы''' в разделе '''Настройки эквайринга Ibox''' заполните поля:#* '''ID клиента в системе ibox''' — номер компании в разделе '''Профиль''' в банк по АПД выгружались личном кабинете ibox;#* '''Логин для webhook ibox''' и '''Пароль для webhook ibox''' — придумайте логин и пароль для авторизации запросов ibox в адрес PimPayMeaSoft. Логин и пароль могут состоять из цифр и латинских букв, нужно создать клиента длина не менее 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://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"код рутокена «12345678», и программа сама будет его использовать, если вы ничего не указали. Если он окажется не правильным - неправильным, Крипто-ПРО спросит у вас верный пин -код при передаче данных. Обратите внимание, что количество попыток ввода пин-кода ограничено.# После ввода данных подключения нужно выйти, выйдите из системы и запустить программу от имени администратора (права windows, правой кнопкой на ярлык - запустить : в контекстном меню ярлыка MeaSoft выберите пункт '''Запуск от имени администратора), и '''. Чтобы осуществить обмен данными: ", выберите '''Связь" -''' > "'''Обмен с ЭДО"'''. При первом использовании программа установит на компьютер специальный COM-объект Диадока. Именно для этого нужны права. В дальнейшем она будет использовать уже установленный компонент, и наличия прав не требуется.