Изменения

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

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

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

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

== PimPay ==Чтобы начать работать с [httpsнастроить прием платежей через сервис Robokassa://pimpay.ru/ Pimpay] необходимо сначала зарегистрироваться # Зарегистрируйтесь в их системе по адресу сервисе [httphttps://platformpartner.api.pimpayrobokassa.ru/site/register http://platformReg Robokassa].api.pimpay.ru/site/register# В [[Личный кабинет курьерской службы#Вкладка «Финансы»|настройках личного кабинета]]курьерской службы введите идентификатор магазина и пароли из личного кабинета Robokassa. Далее pimpay активирует Вашу учетную запись# Установите флажок '''Тестовый режим''' и нажмите на кнопку '''Сохранить'''. # Откройте [[Файл:pimpayconfig.png|thumb|200px|rightЛичный кабинет курьерской службы#Отслеживание заказа по номеру|рис.1 Конфигурация PimPayстраницу отслеживания]]любого заказа с наложенным платежом и оплатой картой и убедитесь, что кнопка '''Оплатить картой''' появилась.# В настройках личного кабинета курьерской службы снимите флажок '''Тестовый режим''' и нажмите на кнопку '''Сохранить'''.

Чтобы продолжить, вам нужно сгенерировать ключи шифрования. Это делается В результате получатель может оплатить заказ онлайн на UNIX-подобной системе: [httpстранице отслеживания https://platformhome.api.pimpaycourierexe.ru/v2_7XX/signature/openssl httptracking, где XX — код вашей курьерской службы://platform.api.pimpay.ru/v2_7/signature/openssl] или <spoiler text="наша инструкция">Чтобы получить приватный ключ, необходимо запустить командную строку.

В командной строке необходимо выполнить следующие команды[[Файл: openssl genrsa -out privateRobokassa.pem 2048 openssl rsa -in private.pem -outform PEM -pubout -out public.pempng|none|900 px]]

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

Далее, необходимо прописать настройки для pimpay В окне отслеживания в панели управления нашего ЛК (см. рис.1)поле '''Наложенный платеж''' статус заказа изменится на '''Заказ оплачен'''. В ЛК PimPay нужно посмотреть код компании (у них называется "Код платформы") и токенЧек по операции придет на электронную почту, ввести их в формууказанную при заказе.

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