Изменения

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

|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 URL обязательна.||

При отправке заказа Вы можете войти в личный кабинет по интеграции с подключенным видом срочности интеграция постарается отправить заказ одним адресу вида 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. Нажмите на кнопку '''Сохранить'''. ==== Передача наложенного платежа ====

==== Как настроить интеграцию Настройка интеграции ====

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

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

==== Как определить тип Настройка типов оплаты ====

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

===Мой СкладМойСклад===

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

# В системе «Мой Склад» МойСклад создайте дополнительные поля в заказах:

# Перейдите по [https://home.courierexe.ru/moysklad/step1 ссылке] и введите логин и пароль от учетной записи системы «Мой склад». Затем укажите логин, пароль и код курьерской службы. Запросите эти данные у курьерской службы, «МойСклад» с которой настраивается интеграцияправами администратора.<br><br>'''Примечание'''. После настройки интеграции не рекомендуется менять логин и пароль от системы «Мой Склад». Это Запрещено изменять данные этой учетной записи — это приведет к сбою интеграции. В будущем при обращении в техническую поддержку MeaSoft указывайте данные этой учетной записи для получения помощи по вопросам интеграции.<br>Если все же есть необходимость сменить учетные данные, после сообщите новый пароль от «Мой Склад» «МойСклад» в техподдержку MeaSoft для внесения изменений в настройки интеграции.<br><br># Укажите логин, пароль и код курьерской службы. Запросите эти данные у курьерской службы, с которой настраивается интеграция.

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

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

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

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

== RBK.money Интеграция с платежными сервисами ==Чтобы настроить прием платежей через систему «RBK.money»:# Перейдите по ссылке https://welcome.rbk.money/ и нажмите '''Подключиться'''. С вами свяжутся сотрудники и вышлют инструкцию для заключения договора и дальнейшей работы.# После завершения регистрационных действий введите полученный публичный ключ и идентификатор в настройках личного кабинета курьерской службы. Подробнее см. [[Личный кабинет курьерской службы#Вкладка «Финансы»|настройки личного кабинета]].

При успешной оплате заказ в MeaSoft отмечается как оплаченныйДоступна интеграция со следующими сервисами:* PimPay — финансирование для интернет-магазинов;* Robokassa — онлайн-оплата заказов;* ibox — мобильный эквайринг.

== 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="наша инструкция">Чтобы получить приватный ключ, необходимо запустить командную строку.== Robokassa ===

Чтобы настроить прием платежей через сервис Robokassa:# Зарегистрируйтесь в сервисе [https://partner.robokassa.ru/Reg Robokassa].# В командной строке необходимо выполнить следующие команды:[[Личный кабинет курьерской службы#Вкладка «Финансы»|настройках личного кабинета]] курьерской службы введите идентификатор магазина и пароли из личного кабинета Robokassa. openssl genrsa -out private# Установите флажок '''Тестовый режим''' и нажмите на кнопку '''Сохранить'''.pem 2048 openssl rsa -in private# Откройте [[Личный кабинет курьерской службы#Отслеживание заказа по номеру|страницу отслеживания]] любого заказа с наложенным платежом и оплатой картой и убедитесь, что кнопка '''Оплатить картой''' появилась.pem -outform PEM -pubout -out public# В настройках личного кабинета курьерской службы снимите флажок '''Тестовый режим''' и нажмите на кнопку '''Сохранить'''.pem

После успешного выполнение команд Вы получить 2 файлаВ результате получатель может оплатить заказ онлайн на странице отслеживания https: public//home.pem и privatecourierexe.pemСодержимое файла public.pem - ваш публичный ключru/XX/tracking, который необходимо целиком скопировать и вставить в ЛК PimPay.А содержимое файла private.pem необходимо скопировать и вставить в настройках интеграции с PimPay в нашем ЛК.</spoiler>[[Файлгде XX — код вашей курьерской службы:pimpay client.png|thumb|200px|right|рис.2 Выбор платежного посредника]]Если у вас нет специалиста, чтобы сгенерировать ключи, обратитесь в PimPay, они с радостью сделают это за вас!

Далее, необходимо прописать настройки для pimpay в панели управления нашего ЛК (см. рис.1). В ЛК PimPay нужно посмотреть код компании (у них называется "Код платформы") и токен, ввести их в форму[[Файл:Robokassa.png|none|900 px]]

Для каждого клиента, который хочет передавать данные При успешной оплате заказ в PimPay необходимо зарегистрировать в личном кабинете PimPay, и в нашей системе выбрать платежного посредника на вкладке "Финансы" карточки клиента. В процессе передачи данных привязка клиентов между системами производится по ИНН. Наша система начинает передавать все заказы вашего клиента в PimPay, их статусы, и созданные [[Акты Передачи Денег и корреспонденции (АПД)|АПД]]. Обратно она ничего не получает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'''. При передаче данных привязка клиентов между системами производится по ИНН. В результате MeaSoft передает все заказы вашего клиента, их статусы и созданные [[Акты Передачи Денег и корреспонденции (АПД)|АПД]] в PimPay. PimPay ничего не передает в ответ. Чтобы платежи в банк по АПД выгружались в адрес PimPay, нужно создать создайте клиента с точно таким названием («PIMPAY» и заполните его реквизиты. === ibox === Мобильный эквайринг ibox доступен через приложение или <rspoiler text="PIMPAYSDK">SDK — это средства разработки, которые позволяют приложению MeaSoft взаимодействовать с POS-терминалом напрямую.</rspoiler>. Подробнее см. раздел [[Мобильное приложение курьера для Android#ibox|«ibox»]]. Для подтверждения успешной транзакции или отмены оплаты MeaSoft получает обратные вызовы (вебхуки)от ibox:* при успешной оплате после установки статуса корреспонденции со слов курьера '''Доставлено''' или '''Частично доставлено''' в MeaSoft на вкладке '''Выдача''' подсвечивается поле '''Тип оплаты''':** зеленым цветом, если оплата картой, есть идентификатор транзакции и заполнить его реквизитысумма транзакции верная;** желтым цветом, если оплата картой, есть идентификатор транзакции, но сумма транзакции не совпадает со значением поля '''Сумма руб''' в карточке корреспонденции;** красным цветом, если оплата картой и нет идентификатора транзакции.*: Если в карточке корреспонденции указан тип оплаты '''Наличными''', то поле будет закрашено красным, если есть идентификатор безналичной транзакции или указана ее сумма. Если их нет, то поле будет зеленым;* при отмене оплаты обратный вызов удаляет идентификатор транзакции, чтобы сделать возможной повторную доставку и оплату заказа картой. Чтобы настроить работу обратных вызовов:# В личном кабинете курьерской службы в разделе '''Управление ЛК''' > '''Параметры''' > '''Финансы''' в разделе '''Настройки эквайринга Ibox''' заполните поля:#* '''ID клиента в системе ibox''' — номер компании в разделе '''Профиль''' в личном кабинете ibox;#* '''Логин для webhook ibox''' и '''Пароль для webhook ibox''' — придумайте логин и пароль для авторизации запросов ibox в MeaSoft. Логин и пароль могут состоять из цифр и латинских букв, длина не менее 5 символов.# Нажмите на кнопку '''Сохранить'''.# Обратитесь в техподдержку ibox с просьбой подключить вебхуки для 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-ключ приобретается отдельно на каждое ваше юр. юридическое лицо, поэтому его нужно вводить в "'''Фирмы"'''.