Интеграция с другими системами — различия между версиями

Материал из Меасофт
Перейти к: навигация, поиск
м (Замечания)
м (Проверка работоспособности интеграций)
(не показана 41 промежуточная версия 3 участников)
Строка 1: Строка 1:
Система "Курьерская служба 2008" имеет практически не ограниченные возможности по интеграции с другими системами. В этой статье мы рассмотрим виды и способы интеграции.
+
MeaSoft имеет практически неограниченные возможности по интеграции с другими системами. В этой статье мы рассмотрим виды и способы интеграции.
  
== Интеграция между 2-мя клиентами системы MeaSoft "Курьерская служба 2008" ==
+
== Интеграция между двумя клиентами MeaSoft ==
  
Один из клиентов (Клиент) отправляет заказы другому клиенту (Агенту), Агент доставляет  
+
Один из клиентов (Клиент) отправляет заказы другому клиенту (Агенту), Агент доставляет отправления и передает их статусы, которые загружаются в систему Клиента.
отправления, и передает их статусы, которые загружаются в систему Клиента.
 
  
Интеграция может быть и двунаправленная, когда одна компания заказывает доставку у второй, а вторая - у первой.
+
Интеграция может быть и двунаправленная, когда одна компания заказывает доставку у второй, а вторая у первой.
  
В этом случае нужно настроить 2 интеграции по данной инструкции, в одной нужно рассматривать одну компанию клиентом, вторую агентом, во второй интеграции – наоборот.
+
В этом случае нужно настроить 2 интеграции: в одной нужно рассматривать одну компанию клиентом, вторую агентом, во второй интеграции – наоборот.
  
Итак, по пунктам:
+
Порядок действий:
 +
# Обе компании должны иметь аккаунты в системе MeaSoft ('''Справочники''' > '''Дополнительные модули''') и у обеих компаний должен быть установлен флажок '''Личный кабинет''' в окне «Управление дополнительными модулями».
 +
# '''Агент''' создает клиента в своей системе на вкладке '''Клиенты'''. На вкладке '''Прочее''' карточки клиента указывает логин и пароль для входа в Личный кабинет.
 +
# '''Агент''' передает клиенту логин, пароль (из предыдущего шага) и свой идентификатор в системе MeaSoft:[[Файл:Measoft id.png|600px|none]][[Файл:Measoft home.png|none|600px]]
 +
# '''Клиент''' создает в своей системе филиал ('''Справочники''' > '''Межгород''' > '''Филиалы''') для указанного агента. После ввода филиала нужно перевойти в программу и подождать 3 минуты.
 +
# '''Клиент''', получив данные из п. 2, заходит в свой Личный кабинет в системе MeaSoft, переходит на вкладку '''Интеграция'''. В таблице должен появиться созданный филиал.
 +
# '''Клиент''' нажимает на кнопку '''Настроить''' напротив филиала, в открывшемся окне выбирает интегратор «MeaSoft», заполняет поля '''Логин''', '''Пароль''' и '''Код клиента''' учетными данными, полученными в п. 3, и нажимает '''Сохранить'''.
  
 +
В результате такой настройки все отправления, у которых Клиент установит «Ответственный филиал», соответствующий Агенту (правильнее всего это через [[Отправка корреспонденции#Создание манифеста|манифест]], скомплектовав его и проставив дату отправки), будут переданы в БД Агента, и статусы будут передаваться обратно. На передачу данных может уходить до 10 минут в штатном режиме и до 1 часа в случае возможных сбоев.
  
1) '''Обе компании''' должны иметь аккаунты в системе MeaSoft («Справочники» – «Дополнительные модули»), и у обеих компаний должна быть установлена галка «Личный кабинет» в указанном выше окне.
+
<div style="color: #a94442; background-color: #f2dede; border: 1px solid #ebccd1; padding: 3px 10px 10px;">
 +
'''Обратите внимание!'''
 +
При передаче заказов, у которых плановая дата доставки меньше ближайшей возможной, дата доставки автоматически меняется на самую раннюю возможную.</div>
  
2) '''Агент''' создает клиента в своей системе (на закладке «Клиенты»). На закладке «Прочее» карточки клиента указывает логин и пароль для входа в Личный кабинет.
+
Для стабильной работы необходимо наличие версии минимум 518 от 05.12.2014 у обеих компаний.
 
 
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 нас не оповещают, поэтому интеграции, по независящим от нас причинам, могут переставать работать, работать нестабильно или некорректно, вплоть до потери важной (финансовой?) информации. Заказы, переданные во внешние системы нужно обязательно проверять на корректность пользуясь личным кабинетом партнера.  
+
Хотим обратить ваше внимание на то, что интеграции со сторонними системами делаются в соответствии с документацией на момент написания, без партнерства с компаниями-поставщиками сервиса. Об изменениях API нас не оповещают, поэтому интеграции по независящим от нас причинам могут переставать работать, работать нестабильно или некорректно, вплоть до потери важной (финансовой?) информации. Заказы, переданные во внешние системы, нужно обязательно проверять на корректность, пользуясь личным кабинетом партнера.  
  
 
=== Общие правила настройки интеграции ===
 
=== Общие правила настройки интеграции ===
Строка 65: Строка 60:
 
При весе отправления больше 30 кг применяется тариф «Магистральный экспресс».
 
При весе отправления больше 30 кг применяется тариф «Магистральный экспресс».
  
Чтобы передать услугу «Примерка», установите флажок '''Принято на склад''' в [[Создание корреспонденции#Вручную|карточке корреспонденции]]. Если услуга не нужна, снимите флажок.
+
Чтобы передать услугу «Примерка», установите флажок '''Принято на склад''' в [[Единица корреспонденции#Создание единицы корреспонденции|карточке корреспонденции]]. Если услуга не нужна, снимите флажок.
  
 
При передаче валюты наложенного платежа код валюты берется из поля '''Валюта''' карточки клиента, от которого передается заказ. Валюта должна совпадать с валютой страны назначения заказа. Если заказ отправляется в другую страну, создайте копию клиента с нужной валютой и оформляйте заказы от него, указывая цены в валюте страны назначения.
 
При передаче валюты наложенного платежа код валюты берется из поля '''Валюта''' карточки клиента, от которого передается заказ. Валюта должна совпадать с валютой страны назначения заказа. Если заказ отправляется в другую страну, создайте копию клиента с нужной валютой и оформляйте заказы от него, указывая цены в валюте страны назначения.
Строка 106: Строка 101:
  
 
== Тарификация и выбор подрядчика и его тарифа клиентом ==
 
== Тарификация и выбор подрядчика и его тарифа клиентом ==
Вы можете настроить подключение своего тарифа к тарифу партнера. Партнерами могут быть любые компании, работающие в системе MeaSoft, а также ряд компаний, с которыми у нас есть интеграции, см. список ниже. Для этого откройте '''Справочники''' > '''Статусы''', выберите '''17 Виды срочности'''. Создайте вид срочности, например «СДЭК». В контекстном меню выберите '''Дополнительная информация''' и во второй строке заполните параметры подключения к партнеру через запятую:
+
Вы можете настроить подключение своего тарифа к тарифу партнера — любой компании, работающей в системе MeaSoft, а также ряду компаний, с которыми у нас есть интеграции, см. список ниже.
* 1-й параметр — код филиала партнера, его можно посмотреть в '''Справочники''' > '''Межгород''' > '''Филиалы''';
+
 
* 2-й параметр — экстра-код партнера в системе MeaSoft. В том числе для сторонних компаний есть коды, см. таблицу ниже;
+
Чтобы настроить подключение к тарифу партнера:
* 3-й параметр — имя пользователя в системе партнера. Может отличаться от того, под которым работает интеграция, здесь нужно для расчета цены для клиента. В таблице ниже указано, что вводить для каждого интегратора;
+
# Зарегистрируйтесь в системе подрядчика. Данные аккаунта понадобятся для настройки интеграции.
* 4-й параметр — пароль пользователя из 3-го параметра. В таблице ниже указано, что вводить для каждого интегратора;
+
# Откройте '''Справочники''' > '''Статусы''' > '''17 Виды срочности''' и создайте вид срочности, например «СДЭК».
* 5-й параметр — вид срочности партнера. Посмотреть доступные коды видов срочности можно по ссылке в таблице ниже, в калькуляторе в выпадающем списке. Можно в одинарных кавычках указать несколько видов срочности через запятую, тогда система будет стараться выбрать из них первый доступный;
+
# В контекстном меню вида срочности  выберите пункт '''Дополнительная информация''' и во второй строке заполните параметры подключения к партнеру через запятую:
* 6-й параметр — наценка к цене, передаваемой подрядчиком. В деньгах или в процентах, если стоит знак процента. Например, 10 — наценка 10 рублей, 10% — наценка 10 процентов.
+
#* 1-й параметр — код филиала партнера, его можно посмотреть в '''Справочники''' > '''Межгород''' > '''Филиалы''';
 +
#* 2-й параметр — экстра-код партнера в системе MeaSoft. В том числе для сторонних компаний есть коды, см. таблицу ниже;
 +
#* 3-й параметр — имя пользователя в системе партнера. Может отличаться от того, под которым работает интеграция, здесь нужно для расчета цены для клиента. В таблице ниже указано, что вводить для каждого интегратора;
 +
#* 4-й параметр — пароль пользователя из 3-го параметра. В таблице ниже указано, что вводить для каждого интегратора;
 +
#* 5-й параметр — вид срочности партнера. Посмотреть доступные коды видов срочности можно по ссылке в таблице ниже, в калькуляторе в выпадающем списке. Можно в одинарных кавычках указать несколько видов срочности через запятую, тогда система будет стараться выбрать из них первый доступный;
 +
#* 6-й параметр — наценка к цене, передаваемой подрядчиком. В деньгах или в процентах, если стоит знак процента. Например, 10 — наценка 10 рублей, 10% — наценка 10 процентов;
 +
#* 7-й параметр — если указать значение '''1''', сквозная тарификация выключена. Параметр используется, если подключение нужно только для передачи заказов по интеграции, а расчет цены не нужен.
 +
# Нажмите на кнопку '''OK'''.
  
 
{|class="wikitable"
 
{|class="wikitable"
Строка 125: Строка 127:
 
|ПИКПОИНТ||90002||https://home.courierexe.ru/90002/calculator||3-й параметр — логин, 4-й — через запятую пароль и договор ИКН. Можно оставить пустыми, но цены будут не все.||33, 90002,us0111, '6rGGuqRsW2qNQ,9990721312', 2, 50
 
|ПИКПОИНТ||90002||https://home.courierexe.ru/90002/calculator||3-й параметр — логин, 4-й — через запятую пароль и договор ИКН. Можно оставить пустыми, но цены будут не все.||33, 90002,us0111, '6rGGuqRsW2qNQ,9990721312', 2, 50
 
|-
 
|-
|CDEK||90005||https://home.courierexe.ru/90005/calculator||Введите код учетной записи в 3-й параметр, секретный код — в 4-й. Можно оба оставить пустыми для расчета базовых цен.||45491, 90005, hfenJwlasiPr4pnFENpaVXSKPIn5Trh7i, 9vkQgWuiZgEj9fGCB8a6Xj3desnJkwsl, 5, 30%
+
|rowspan="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
 
|-
 
|-
 
|КСЭ||90008||https://home.courierexe.ru/90008/calculator||Введите логин в 3-й параметр, пароль — в 4-й. Пустыми оставить нельзя.||12504, 90008, Рога и копыта, 4CCB11864D06157, '2, 3, 6', 10%
 
|КСЭ||90008||https://home.courierexe.ru/90008/calculator||Введите логин в 3-й параметр, пароль — в 4-й. Пустыми оставить нельзя.||12504, 90008, Рога и копыта, 4CCB11864D06157, '2, 3, 6', 10%
Строка 131: Строка 135:
 
|ПОЧТА РОССИИ||90010||https://home.courierexe.ru/90010/calculator||<!--Введите "логин отправки" в 3-й параметр, а в 4-й в одинарных кавычках через запятую пароль отправки и токен. Пустыми оставлять нельзя, т.к. интеграция с Почтой пока не позволяет рассчитывать цены без договора (авторизации).-->Пока поддерживаются только базовые тарифы, без авторизации.||10497, 90010,,, '2, 1', 10 <!--10497, 90010, 89251234567, 'mypassword,u23B0r9AAJ1Fyh4ptMzJ3kjxcslamwdx', '2, 1', 10-->
 
|ПОЧТА РОССИИ||90010||https://home.courierexe.ru/90010/calculator||<!--Введите "логин отправки" в 3-й параметр, а в 4-й в одинарных кавычках через запятую пароль отправки и токен. Пустыми оставлять нельзя, т.к. интеграция с Почтой пока не позволяет рассчитывать цены без договора (авторизации).-->Пока поддерживаются только базовые тарифы, без авторизации.||10497, 90010,,, '2, 1', 10 <!--10497, 90010, 89251234567, 'mypassword,u23B0r9AAJ1Fyh4ptMzJ3kjxcslamwdx', '2, 1', 10-->
 
|-
 
|-
|rowspan="2"|ДПД||rowspan="2"|90011||rowspan="2"|https://home.courierexe.ru/90011/calculator||Введите клиентский номер в 3-й параметр, клиентский ключ в 4-й. Можно оставить пустыми для базовых тарифов.||12504, 90011, 1019003662, '4CCB11864D06157A5934A9119F2A0AAAAAB4CCE8,D117', '3, 6', 10%
+
|rowspan="3"|DPD||rowspan="3"|90011||rowspan="3"|https://home.courierexe.ru/90011/calculator||Введите клиентский номер в 3-й параметр, клиентский ключ в 4-й. Можно оставить пустыми для базовых тарифов.||12504, 90011, 1019003662, '4CCB11864D06157A5934A9119F2A0AAAAAB4CCE8,D117', '3, 6', 10%
 
|-
 
|-
 
||Если вы доставляете товар в пункт отправления самостоятельно, после пароля добавьте запятую и код ПВЗ, а в настройке режима срочности введите пароль в кавычках.||'4CCB11864D06157A5934A9119F2A0AAAAAB4CCE8,D117'
 
||Если вы доставляете товар в пункт отправления самостоятельно, после пароля добавьте запятую и код ПВЗ, а в настройке режима срочности введите пароль в кавычках.||'4CCB11864D06157A5934A9119F2A0AAAAAB4CCE8,D117'
 
|-
 
|-
|ДОСТАВКА ГУРУ||90017||https://home.courierexe.ru/90017/calculator||3-й параметр — ID партнера в системе DOSTAVKA.guru, 4-й — ключ доступа. Можно оставить пустыми.
+
|-
 +
|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
 
||10497, 90017, 9999, cc03e747a6afbbcbf8be7668acfebee5, '1', 100
 
|-
 
|-
|5Пост||90020||https://home.courierexe.ru/90020/calculator||3-й параметр — API-ключ, 4-й — уникальный номер партнера в системе 5post. При необходимости в 4-м параметре можно через запятую указать пороговое значение веса (по умолчанию 3 кг). Пустыми оставить нельзя.||10497, 90020, u23B0r9AAJ1Fyh4ptMzJ3kjxcslamwdx, 1, 100
+
|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/XXX, где XXX — экстра-код партнера, авторизоваться данными из 3-го и 4-го параметров (см. таблицу выше) и воспользоваться калькулятором с тарифами именно вашей компании.
 
 
Также можно для любой компании войти в личный кабинет по адресу вида https://home.courierexe.ru/90005 , где в конце — экстра-код партнера, авторизоваться данными из 3-го и 4-го параметров (см. таблицу выше) и воспользоваться калькулятором с тарифами именно вашей компании.
 
  
== Интеграция с клиентами (получение заказов) ==
+
== Интеграция с CMS-системами (получение заказов) ==
  
 
=== Замечания ===
 
=== Замечания ===
Строка 214: Строка 222:
  
 
=== 1C-Битрикс===
 
=== 1C-Битрикс===
Чтобы настроить интеграцию:
+
 
 +
==== Настройка интеграции ====
 +
 
 
# В личном кабинете 1C-Битрикс на вкладке '''Администрирование''' в панели слева выберите '''Marketplace''' > '''Каталог решений''' и на странице «Каталог Маркетплейс» с помощью строки поиска найдите '''Модуль интеграции MEASoft'''.
 
# В личном кабинете 1C-Битрикс на вкладке '''Администрирование''' в панели слева выберите '''Marketplace''' > '''Каталог решений''' и на странице «Каталог Маркетплейс» с помощью строки поиска найдите '''Модуль интеграции MEASoft'''.
 
# Щелкните по ссылке «Установить».
 
# Щелкните по ссылке «Установить».
Строка 221: Строка 231:
 
# В панели слева выберите '''Магазин''' > '''Настройки''' > '''Службы доставки''', затем на странице «Список служб доставок» раскройте выпадающий список кнопки '''Добавить''' и выберите пункт '''Автоматизированная служба доставки'''. Откроется страница «Новая служба доставки».
 
# В панели слева выберите '''Магазин''' > '''Настройки''' > '''Службы доставки''', затем на странице «Список служб доставок» раскройте выпадающий список кнопки '''Добавить''' и выберите пункт '''Автоматизированная служба доставки'''. Откроется страница «Новая служба доставки».
 
# На странице «Новая служба доставки» перейдите на вкладку '''Настройки обработчика''' и в выпадающем списке '''Служба доставки''' выберите '''"Курьерская служба" - сервис доставки'''. Нажмите на кнопку '''Применить'''.
 
# На странице «Новая служба доставки» перейдите на вкладку '''Настройки обработчика''' и в выпадающем списке '''Служба доставки''' выберите '''"Курьерская служба" - сервис доставки'''. Нажмите на кнопку '''Применить'''.
# Перейдите на вкладку '''Настройки интеграции''': [[Файл:Bitrix Настройки интеграции.png|none|1100px]]
+
# Перейдите на вкладку '''Настройки интеграции''': [[Файл:Bitrix Настройки интеграции.png|none|800px]]
 
#: На этой вкладке:
 
#: На этой вкладке:
#* в разделе '''Настройка доступа''' введите учетные данные личного кабинета в поля '''Логин''', '''Пароль''' и '''Код клиента'''. Запросите эти данные у курьерской службы, с которой настраивается интеграция. Поле '''Код клиента ПВЗ''' оставляем пустым (оно заполнится автоматически позднее).
+
#* в разделе '''Настройки доступа''' введите учетные данные личного кабинета в поля '''Логин''', '''Пароль''' и '''Код клиента'''. Запросите эти данные у курьерской службы, с которой настраивается интеграция. Кнопка '''Проверить''' предназначена для проверки введенных учетных данных.
 
#* в разделе '''Основные настройки''':
 
#* в разделе '''Основные настройки''':
#** в поле '''Статус отправки заказа''' выберите статус, при котором заказ будет отправляться в курьерскую службу;
 
 
#** в поле '''Оплата картой''' выберите тип оплаты, который будет соответствовать оплате картой (если оплата картой возможна);
 
#** в поле '''Оплата картой''' выберите тип оплаты, который будет соответствовать оплате картой (если оплата картой возможна);
 
#** установите флажок '''Использовать артикулы''', если артикулы будут использоваться для привязки номенклатуры к складу курьерской службы;
 
#** установите флажок '''Использовать артикулы''', если артикулы будут использоваться для привязки номенклатуры к складу курьерской службы;
#* в разделе '''Соответствующие поля покупателя''' настройте соответствие полей получателя (ФИО, города, адреса и др.) полям в форме создания заказа.
+
#* в разделе '''Соответствующие поля покупателя''' настройте соответствие полей получателя (ФИО, города, адреса и др.) полям в форме создания заказа;
 +
#* для работы с товарами, [[Маркировка|маркированными]] кодом «Честный ЗНАК», в разделе '''Соответствующие поля товаров''' укажите поле для хранения кода;
 +
#* в разделе '''Статусы отправки заказа''' выберите статусы, при которых заказ будет автоматически отправлен в курьерскую службу.
 
# На вкладке '''Ценовая политика доставки''' при необходимости настройте стоимость доставки для покупателя в зависимости от стоимости заказа.
 
# На вкладке '''Ценовая политика доставки''' при необходимости настройте стоимость доставки для покупателя в зависимости от стоимости заказа.
 
# На вкладке '''Ограничения''' при необходимости укажите ограничения работы модуля по географии, типам оплаты и т.п.
 
# На вкладке '''Ограничения''' при необходимости укажите ограничения работы модуля по географии, типам оплаты и т.п.
Строка 236: Строка 247:
 
#* в разделе '''Рабочий стол''' > '''Настройки''' > '''Настройки продукта''' > '''Настройки модулей''' > '''Курьерская служба''' в поле '''Города-отправители''' добавьте город отправителя;
 
#* в разделе '''Рабочий стол''' > '''Настройки''' > '''Настройки продукта''' > '''Настройки модулей''' > '''Курьерская служба''' в поле '''Города-отправители''' добавьте город отправителя;
 
#* в разделе '''Рабочий стол''' > '''Магазин''' > '''Настройки''' > '''Службы доставки''' > Нужная служба > '''Настройки интеграции''' > '''Город отправитель''' укажите добавленный выше город.
 
#* в разделе '''Рабочий стол''' > '''Магазин''' > '''Настройки''' > '''Службы доставки''' > Нужная служба > '''Настройки интеграции''' > '''Город отправитель''' укажите добавленный выше город.
 +
 +
Проверить работу модуля можно в форме оформления доставки. При этом должна корректно считаться стоимость доставки.
 +
 +
==== Перенос даты доставки ====
 +
 +
Вы можете настроить перенос даты доставки на один день вперед от даты, получаемой от курьерской службы, если заказ оформлен позже определенного часа.
 +
 +
Чтобы настроить перенос даты доставки:
 +
# В личном кабинете 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, при наличии товарных вложений добавляется вложение «Предоплата» с типом вложения '''Предоплата''' и ценой, равной сумме предоплаты, со знаком «минус». Поддерживается только полная предоплата.
 +
 +
==== Отправка заказа в курьерскую службу ====
  
 
Чтобы отправить заказ в курьерскую службу, зайдите в карточку заказа, укажите настроенное значение в поле '''Статус отправки заказа''' и нажмите на кнопку '''Сохранить'''.
 
Чтобы отправить заказ в курьерскую службу, зайдите в карточку заказа, укажите настроенное значение в поле '''Статус отправки заказа''' и нажмите на кнопку '''Сохранить'''.
Строка 248: Строка 287:
 
Статус заказа можно проверить в карточке заказа, в правом верхнем углу.
 
Статус заказа можно проверить в карточке заказа, в правом верхнем углу.
  
Для предоплаченных заказов в карточке корреспонденции отображается сумма к оплате 0, при наличии товарных вложений добавляется вложение «Предоплата» с типом вложения '''Предоплата''' и ценой, равной сумме предоплаты, со знаком «минус». Поддерживается только полная предоплата.
+
==== Возможные ошибки ====
 
 
'''Примечание'''. Проверить работу модуля можно в форме оформления доставки. При этом должна корректно считаться стоимость доставки.
 
  
<spoiler text="Если возникает ошибка">
+
# Если не рассчитывается стоимость, возможные причины:
# Если не рассчитывается стоимость:
 
 
#* некорректно установлен модуль;
 
#* некорректно установлен модуль;
 
#* введены некорректные учетные данные;
 
#* введены некорректные учетные данные;
 
#* в курьерской службе не настроен тариф. Обратитесь в курьерскую службу для настройки тарифа. После настройки тарифы можно проверить в личном кабинете, на вкладке '''Калькулятор'''.
 
#* в курьерской службе не настроен тариф. Обратитесь в курьерскую службу для настройки тарифа. После настройки тарифы можно проверить в личном кабинете, на вкладке '''Калькулятор'''.
# По умолчанию при оформлении заказа должны появиться поля даты и времени желаемой доставки. Если они отсутствуют, то у формы были изменены стили. Также возможно обновление формы в системе Битрикс.[[Файл:Bitrix2.png|center|700 px]]
+
# По умолчанию при оформлении заказа должны появиться поля даты и времени желаемой доставки. Если они отсутствуют, то у формы были изменены стили. Также возможно обновление формы в системе Битрикс.[[Файл:Bitrix2.png|none|700 px]]
# Проверьте правильность привязки свойств. Для этого в разделе '''Рабочий стол''' > '''Магазин''' > '''Настройки''' > '''Свойства заказа''' > '''Список свойств''' найдите свойство, связанное с ошибкой, щелкните по нему правой кнопкой мыши и выберите '''Изменить параметры свойства'''.<br>На вкладке '''Привязка свойства''' настраиваются условия, при которых поле будет показываться клиенту. Если у свойства заказа настроена привязка, то оно будет показываться ТОЛЬКО в том случае, когда покупатель выберет хотя бы один из указанных критериев:[[Файл:Битрикс Связь свойства.png|center|500px]]
+
# Проверьте правильность привязки свойств. Для этого в разделе '''Рабочий стол''' > '''Магазин''' > '''Настройки''' > '''Свойства заказа''' > '''Список свойств''' найдите свойство, связанное с ошибкой, щелкните по нему правой кнопкой мыши и выберите '''Изменить параметры свойства'''.<br>На вкладке '''Привязка свойства''' настраиваются условия, при которых поле будет показываться клиенту. Если у свойства заказа настроена привязка, то оно будет показываться ТОЛЬКО в том случае, когда покупатель выберет хотя бы один из указанных критериев:[[Файл:Битрикс Связь свойства.png|none|500px]]
  
 
В этом примере покупатель при оформлении заказа увидит созданное поле для заполнения только в том случае, если на предыдущих шагах он выбрал оплату '''Наличными курьеру''' (при любой службе доставки), или же если захотел расплатиться любым способом, но выбрал в качестве службы доставки '''Воздушный транспорт'''.
 
В этом примере покупатель при оформлении заказа увидит созданное поле для заполнения только в том случае, если на предыдущих шагах он выбрал оплату '''Наличными курьеру''' (при любой службе доставки), или же если захотел расплатиться любым способом, но выбрал в качестве службы доставки '''Воздушный транспорт'''.
Строка 265: Строка 301:
  
 
Подробнее см. [https://dev.1c-bitrix.ru/learning/course/index.php?COURSE_ID=42&LESSON_ID=3073&LESSON_PATH=3912.4580.4828.3073 документацию 1С-Битрикс].
 
Подробнее см. [https://dev.1c-bitrix.ru/learning/course/index.php?COURSE_ID=42&LESSON_ID=3073&LESSON_PATH=3912.4580.4828.3073 документацию 1С-Битрикс].
</spoiler>
 
  
 
=== InSales ===
 
=== InSales ===
Строка 273: Строка 308:
 
Чтобы настроить статусы, в панели администрирования InSales выберите '''Настройки''' > '''Оформление заказа''' > '''Пользовательские статусы''' и создайте статусы, например «Передано в КС» и «Ошибка».
 
Чтобы настроить статусы, в панели администрирования InSales выберите '''Настройки''' > '''Оформление заказа''' > '''Пользовательские статусы''' и создайте статусы, например «Передано в КС» и «Ошибка».
  
Чтобы настроить интеграцию:
+
==== Настройка интеграции ====
 +
 
 
# В личном кабинете InSales откройте '''Приложения''' > '''Центр приложений''',  с помощью строки поиска найдите модуль «Курьерская служба 2008» и нажмите на кнопку '''Установить'''.
 
# В личном кабинете InSales откройте '''Приложения''' > '''Центр приложений''',  с помощью строки поиска найдите модуль «Курьерская служба 2008» и нажмите на кнопку '''Установить'''.
 
# Откроется личный кабинет InSales. На странице «Установка приложения» нажмите на кнопку '''Установить'''.
 
# Откроется личный кабинет InSales. На странице «Установка приложения» нажмите на кнопку '''Установить'''.
 
# В списке установленных приложений выберите «Модуль "Курьерская служба 2008"». Откроется страница авторизации личного кабинета клиента курьерской службы. Если вы авторизованы в ЛК курьерской службы, то сразу откроется страница настроек, см. п. 5.
 
# В списке установленных приложений выберите «Модуль "Курьерская служба 2008"». Откроется страница авторизации личного кабинета клиента курьерской службы. Если вы авторизованы в ЛК курьерской службы, то сразу откроется страница настроек, см. п. 5.
 
# Введите учетные данные личного кабинета в поля '''Логин''', '''Пароль''' и '''Код курьерской службы'''. Запросите эти данные у курьерской службы, с которой настраивается интеграция.
 
# Введите учетные данные личного кабинета в поля '''Логин''', '''Пароль''' и '''Код курьерской службы'''. Запросите эти данные у курьерской службы, с которой настраивается интеграция.
# На странице «Настройка интеграции "Insales"» выполните настройку интеграции.<br>Особенности заполнения полей:
+
# На странице «Настройка интеграции Insales» выполните настройку интеграции.<br>Особенности заполнения полей:
#* '''Отправлять заказы в курьерскую службу автоматически после изменения статуса'''. Используется для автоматической передачи заказов с определенным статусом в курьерскую службу. Возможные значения: '''Да''', '''Нет'''.
+
#* '''Статус заказа для автоматической отправки в курьерскую службу'''. Выберите из выпадающего списка заранее созданный статус, при установке которого заказ автоматически отправляется в курьерскую службу, или значение '''Не отправлять'''.
#* '''Статус отправления заказа в курьерскую службу (если отправляется автоматически)'''. Выберите из выпадающего списка заранее созданный статус, который будет использоваться для автоматической передачи заказов в курьерскую службу.
 
#* '''Отправлять статус заказа в Insales'''. Определяет, отправляется ли статус успешной доставки заказа в InSales. Возможные значения: '''Да''', '''Нет'''.
 
 
#* '''Отправлять артикулы (для привязки к складу)'''. Если опция включена, артикулы товаров из InSales передаются в MeaSoft.  
 
#* '''Отправлять артикулы (для привязки к складу)'''. Если опция включена, артикулы товаров из InSales передаются в MeaSoft.  
 
#* '''Название доставки курьером на странице заказа'''. Укажите название доставки, которое будет отображаться в заказе вместо «Курьерская доставка МЕАСОФТ» при выборе способа доставки. Можно оставить поле пустым, тогда список будет выглядеть следующим образом:[[Файл:Insales Delivery.png|none|800 px]]
 
#* '''Название доставки курьером на странице заказа'''. Укажите название доставки, которое будет отображаться в заказе вместо «Курьерская доставка МЕАСОФТ» при выборе способа доставки. Можно оставить поле пустым, тогда список будет выглядеть следующим образом:[[Файл:Insales Delivery.png|none|800 px]]
 
#* '''Описание доставки курьером на странице заказа'''. Укажите описание вида доставки. Можно оставить поле пустым.
 
#* '''Описание доставки курьером на странице заказа'''. Укажите описание вида доставки. Можно оставить поле пустым.
#* '''Переводить заказ в специальный статус в случае ошибки передачи заказа?'''. Определяет, используется ли специальный статус для обозначения заказов с ошибкой передачи данных. Возможные значения: '''Да''', '''Нет'''.
 
 
#* '''Синхронизировать остатки по складам'''. Если опция включена, данные по складским остаткам из курьерской службы передаются в InSales.
 
#* '''Синхронизировать остатки по складам'''. Если опция включена, данные по складским остаткам из курьерской службы передаются в InSales.
 
#* '''Используется мультисклад?'''. Определяет, используется ли выбор товаров с одного склада или из нескольких. Возможные значения: '''Да''', '''Нет'''. В случае работы с несколькими складами убедитесь, что в настройках InSales ('''Настройки''' > '''Настройки магазина''' > '''Мультисклад'''.) указано такое же количество складов, как в системе MeaSoft.
 
#* '''Используется мультисклад?'''. Определяет, используется ли выбор товаров с одного склада или из нескольких. Возможные значения: '''Да''', '''Нет'''. В случае работы с несколькими складами убедитесь, что в настройках InSales ('''Настройки''' > '''Настройки магазина''' > '''Мультисклад'''.) указано такое же количество складов, как в системе MeaSoft.
#* '''Специальный статус на случай ошибки передачи заказа'''. Выберите из выпадающего списка заранее созданный статус, который будет использоваться для обозначения заказов с ошибкой передачи данных.
+
#* '''Статус заказа при ошибке передачи в курьерскую службу'''. Выберите из выпадающего списка заранее созданный статус, который будет использоваться для обозначения заказов с ошибкой передачи данных, или укажите значение '''Не отправлять'''.
 +
#* '''Производить расчет без адреса?'''. Если выбрано значение '''Нет''', расчет стоимости доставки возможен только после ввода полного адреса получателя.
 
# По заполнении нужных полей нажмите '''Сохранить'''.
 
# По заполнении нужных полей нажмите '''Сохранить'''.
  
 
В результате в InSales в окне создания заказа появляется блок «Модуль "Курьерская служба 2008"»:
 
В результате в InSales в окне создания заказа появляется блок «Модуль "Курьерская служба 2008"»:
::[[Файл:Insales Module KS.png|none|400 px]]
+
::[[Файл:Insales Module KS.png|none|300 px]]
 +
 
 +
==== Настройка типов оплаты ====
 +
 
 
Тип оплаты заказа определяется следующим образом:
 
Тип оплаты заказа определяется следующим образом:
 
* если заказ оплачен, то передается тип оплаты '''Оплачен''';
 
* если заказ оплачен, то передается тип оплаты '''Оплачен''';
* если тип оплаты '''Оплата банковской картой''' или '''Оплата банковской картой курьеру''', то передается тип оплаты '''Банковская карта'''. Указанные типы оплаты необходимо создать в InSales вручную: '''Настройки''' > '''Оформление заказа''' > '''Оплата''';
+
* тип оплаты '''Банковская карта''' передается, если в InSales используется один из следующих типов:
* иначе передается тип оплаты '''Наличными'''.
+
** '''Оплата банковской картой''';
 +
** '''Банковской картой при получении''';
 +
** '''Оплата банковской картой курьеру'''.
 +
: Создайте эти типы оплаты в InSales: '''Настройки''' > '''Оформление заказа''' > '''Оплата''';
 +
* если название типа оплаты не совпадает с вышеперечисленными, передается тип оплаты '''Наличными'''.
 
В системе MeaSoft в карточке интернет-магазина есть флажок '''Спрашивать тип оплаты у получателя'''. Если он установлен, то независимо от переданного типа оплаты '''Наличными''' или '''Банковская карта''' покупателю будет предложен выбор способа оплаты.
 
В системе MeaSoft в карточке интернет-магазина есть флажок '''Спрашивать тип оплаты у получателя'''. Если он установлен, то независимо от переданного типа оплаты '''Наличными''' или '''Банковская карта''' покупателю будет предложен выбор способа оплаты.
  
Строка 303: Строка 344:
 
=== RetailCRM ===
 
=== RetailCRM ===
  
Чтобы настроить интеграцию:
+
См. раздел «[[RetailCRM]]».
# В 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 ===
  
 
Чтобы настроить интеграцию:
 
Чтобы настроить интеграцию:
  
 
# Скачайте архив модуля установки по [http://courierexe.ru/download/api/ms_courierexe-v1.1.1.zip ссылке].
 
# Скачайте архив модуля установки по [http://courierexe.ru/download/api/ms_courierexe-v1.1.1.zip ссылке].
# В панели администратора cs.cart откройте '''Модули''' > '''Управление модулями''' и на странице «Модули» нажмите на кнопку [[Файл:Cscart добавить.png|25 px]]. Откроется окно «Загрузить и установить модуль».
+
# В панели администратора CS-Cart откройте '''Модули''' > '''Управление модулями''' и на странице «Модули» нажмите на кнопку [[Файл:Cscart добавить.png|25 px]]. Откроется окно «Загрузить и установить модуль».
 
# В этом окне нажмите на кнопку '''Загрузить''', выберите архив с модулем на компьютере и нажмите на кнопку '''Загрузить и установить'''. Модуль «Курьерская служба 2008» появится в списке модулей.
 
# В этом окне нажмите на кнопку '''Загрузить''', выберите архив с модулем на компьютере и нажмите на кнопку '''Загрузить и установить'''. Модуль «Курьерская служба 2008» появится в списке модулей.
 
# Откройте '''Администрирование''' > '''Доставка и налоги''' > '''Способы доставки''' и нажмите на кнопку [[Файл:Cscart добавить.png|25 px]]. Откроется окно «Новый метод доставки»:
 
# Откройте '''Администрирование''' > '''Доставка и налоги''' > '''Способы доставки''' и нажмите на кнопку [[Файл:Cscart добавить.png|25 px]]. Откроется окно «Новый метод доставки»:
Строка 351: Строка 365:
 
#:
 
#:
 
# В этом окне укажите следующие настройки:
 
# В этом окне укажите следующие настройки:
#* введите учетные данные клиента курьерской службы. Запросите эти данные у курьерской службы, с которой настраивается интеграция;
+
#* введите учетные данные клиента курьерской службы. Запросите эти данные у курьерской службы, с которой настраивается интеграция. На рисунке указаны учетные данные тестового доступа;
 
#* Укажите тип доставки. Возможные значения: '''Курьером до двери''', '''ПВЗ'''.
 
#* Укажите тип доставки. Возможные значения: '''Курьером до двери''', '''ПВЗ'''.
 
# Нажмите на кнопку '''Сохранить'''.
 
# Нажмите на кнопку '''Сохранить'''.
Строка 369: Строка 383:
  
 
Также в этом блоке вы можете проверить статус доставки заказа.
 
Также в этом блоке вы можете проверить статус доставки заказа.
 +
 +
'''Примечание'''. Модуль поддерживает CS-Cart 4.10 и выше.
  
 
=== amoCRM ===
 
=== amoCRM ===
Строка 421: Строка 437:
 
* Обработка координат.
 
* Обработка координат.
  
===Мой Склад===
+
===МойСклад===
Интеграция предназначена для передачи заказов с товарными вложимыми из системы "Мой склад" в систему "Курьерская служба 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>, на изменение заказа, чтобы "Мой Склад" нас извещал об изменениях. Так работают все модули служб доставки для МС. Проблема в том, что МС поддерживает только одно подобное событие для заказа, поэтому, если оно занято другим <rspoiler text="установленным модулем">А иногда бывает, что модуль удалили, или не до конца установили, а зарегистрированное событие от него осталось</rspoiler>, в этом случае мы не сможем его занять, и отправка заказов, к сожалению, работать не будет. Если у вас не отправляются заказы, и вы уверены, что у вас нет других модулей, использующих это событие, обратитесь к нам в службу поддержки, мы сможем проверить занятость события и при необходимости его освободить.
+
 
 +
При установке приложения в «Моем Складе» в нем регистрируется <rspoiler text="событие">веб-хук</rspoiler> на изменение заказа, чтобы «Мой Склад» передавал изменения в MeaSoft. Так работают все модули служб доставки для «Моего Склада». «Мой Склад» поддерживает только одно событие для заказа, поэтому, если оно занято другим <rspoiler text="установленным модулем">Или модуль может быть удален или не до конца установлен, а зарегистрированное событие от него осталось</rspoiler>, MeaSoft не сможет его занять, и отправка заказов работать не будет. Если у вас не отправляются заказы и вы уверены, что у вас нет других модулей, использующих это событие, обратитесь к нам в службу поддержки, мы сможем проверить занятость события и при необходимости его освободить.
  
 
===Wordpress===
 
===Wordpress===
====Требования к сайту перед установкой плагина:====
 
#CMS WordPress версии 5, или более новая.
 
#WooCommerce версии 3.9, или более новая.
 
#PHP версии 7, или более новая.
 
#Сайт должен использовать SSL-сертификат
 
  
====Порядок установки плагина и вывод нового способа доставки в корзину:====
+
====Требования к сайту ====
#В панели администратора вашего сайта откройте страницу “Плагины - Добавить новый” и нажмите на кнопку “Загрузить плагин”
+
 
#В появившейся форме выберите архив с плагином на вашем компьютере и нажмите кнопку “Установить”
+
# CMS WordPress версии 5 или более новая;
#После загрузки и установки плагина вы можете его активировать нажав на соответствующую кнопку  
+
# WooCommerce версии 3.9 или более новая;
#После активации плагина в меню появится ссылка на страницу настроек плагина.Заполните все необходимые поля и нажмите кнопку “Сохранить изменения”.
+
# PHP версии 7 или более новая;
#Откройте настройки WooCommerce и переключите на вкладку “Доставка”
+
# сайт должен использовать SSL-сертификат.
#Выберите необходимую зону доставки, или создайте её.
+
 
#Нажмите на кнопку “Добавить метод доставки” и выберите из списка “КС2008”
+
====Порядок установки плагина и вывод нового способа доставки в корзину ====
#После создания заказа, в панели администратора, в форме изменения заказа, справа появится блок модуля "Отправить в курьерскую службу, снизу которого будет кнопка "Отправить заказ в КС2008", при нажатии на которую заказ будет отправлен в курьерскую службу.
+
 
 +
# В панели администратора сайта откройте страницу '''Плагины''' > '''Добавить новый''' и нажмите на кнопку '''Загрузить плагин'''.
 +
# В появившейся форме выберите архив с плагином на вашем компьютере и нажмите кнопку '''Установить'''.
 +
# После загрузки и установки плагина вы можете его активировать нажав на соответствующую кнопку.
 +
# После активации плагина в меню появится ссылка на страницу настроек плагина. Заполните все необходимые поля и нажмите кнопку '''Сохранить изменения'''.
 +
# Откройте настройки WooCommerce и переключите на вкладку '''Доставка'''.
 +
# Выберите необходимую зону доставки или создайте её.
 +
# Нажмите на кнопку '''Добавить метод доставки''' и выберите из списка '''КС2008'''.
 +
# После создания заказа в панели администратора в форме изменения заказа справа появится блок модуля '''Отправить в курьерскую службу''' с кнопкой '''Отправить заказ в КС2008''', при нажатии на которую заказ будет отправлен в курьерскую службу.
  
 
====Обновление статусов====
 
====Обновление статусов====
 +
 
Обновление статусов заказов происходит через технологию WP_Cron каждые 30 минут.  
 
Обновление статусов заказов происходит через технологию WP_Cron каждые 30 минут.  
  
Если статус заказа в курьерской службе будет изменен на “Доставлен”, то статус заказа в вашем магазине также будет изменен на “Выполнен”.
+
Если статус заказа в курьерской службе изменен на '''Доставлен''', то статус заказа в вашем магазине также будет изменен на '''Выполнен'''.
  
 
===Проверка работоспособности интеграций===
 
===Проверка работоспособности интеграций===
Строка 506: Строка 526:
 
'''RetailCRM'''
 
'''RetailCRM'''
  
 +
# Убедитесь, что выполнены все шаги [[RetailCRM#Настройка интеграции|инструкции по настройке интеграции]].
 +
# Если используются триггеры, убедитесь, что они настроены согласно [[RetailCRM#Настройка триггеров|инструкции]].
 
# Создайте заказ, заполните требуемые данные.
 
# Создайте заказ, заполните требуемые данные.
 
# Нажмите на кнопку '''Сохранить''' внизу страницы, флажок '''Не отправлять данные в службу доставки''' должен быть снят. Заказ должен отправиться в курьерскую службу.
 
# Нажмите на кнопку '''Сохранить''' внизу страницы, флажок '''Не отправлять данные в службу доставки''' должен быть снят. Заказ должен отправиться в курьерскую службу.
Строка 512: Строка 534:
 
:: Если это ошибка ответа курьерской службы, сообщите об этом разработчику. Пример ошибки: «Служба доставки прислала ответ в неверном формате».
 
:: Если это ошибка ответа курьерской службы, сообщите об этом разработчику. Пример ошибки: «Служба доставки прислала ответ в неверном формате».
  
'''Мой склад'''
+
'''МойСклад'''
  
 +
# При сбое интеграции проверьте, не изменен ли аккаунт, под которым создана интеграция:
 +
## Логин учетных данных МойСклад, которые использовались при создании интеграции, вставьте в ссылку <nowiki>https://home.courierexe.ru/moysklad/step2?id=</nowiki>'''логин'''. Если при переходе по ссылке отображается этап настройки интеграции, значит аккаунт существует.
 +
## Войдите в «МойСклад» под учетной записью, которая использовалась для настройки интеграции, и откройте справочник '''Сотрудники''': меню пользователя > '''Настройки''' > '''Справочники'''> '''Сотрудники'''. Откройте карточку сотрудника, под учетной записью которого вы вошли, и убедитесь, что его роль — администратор.
 +
## Если хотя бы один из пунктов не выполнен, значит, аккаунт, использованный для создания интеграции, изменен.
 
# В личном кабинете клиента курьерской службы в настройках обратной интеграции '''Мой склад''' в поле '''В каком статусе "Мой склад" отправлять заказ на доставку''' уточните статус, при котором заказ отправляется в курьерскую службу.
 
# В личном кабинете клиента курьерской службы в настройках обратной интеграции '''Мой склад''' в поле '''В каком статусе "Мой склад" отправлять заказ на доставку''' уточните статус, при котором заказ отправляется в курьерскую службу.
 
# Заполните форму заказа, нажмите на кнопку '''Сохранить''', затем смените статус заказа на статус, установленный для отправки в курьерскую службу и снова нажмите на кнопку '''Сохранить'''. Если все верно, заказ будет отправлен в курьерскую службу.
 
# Заполните форму заказа, нажмите на кнопку '''Сохранить''', затем смените статус заказа на статус, установленный для отправки в курьерскую службу и снова нажмите на кнопку '''Сохранить'''. Если все верно, заказ будет отправлен в курьерскую службу.
Строка 524: Строка 550:
  
 
# В личном кабинете клиента курьерской службы в настройках обратной интеграции '''InSales''' проверьте данные в следующих полях:
 
# В личном кабинете клиента курьерской службы в настройках обратной интеграции '''InSales''' проверьте данные в следующих полях:
#* '''Отправлять заказы в курьерскую службу автоматически после изменения статуса''';
+
#* '''Статус заказа для автоматической отправки в курьерскую службу''';
#* '''Статус отправления заказа в курьерскую службу (если отправляется автоматически)''';
 
 
#* '''Список доставок для отправления заказа в курьерскую службу (если отправляется автоматически)''';
 
#* '''Список доставок для отправления заказа в курьерскую службу (если отправляется автоматически)''';
 
#* '''Оплачен ли заказ? (если отправляется автоматически)'''.
 
#* '''Оплачен ли заказ? (если отправляется автоматически)'''.
Строка 536: Строка 561:
 
Ошибка при создании заказа отображается в левом нижнем углу.
 
Ошибка при создании заказа отображается в левом нижнем углу.
  
== RBK.money ==
+
== Интеграция с платежными сервисами ==
Чтобы настроить прием платежей через систему «RBK.money»:
+
 
# Перейдите по ссылке https://welcome.rbk.money/ и нажмите '''Подключиться'''. С вами свяжутся сотрудники и вышлют инструкцию для заключения договора и дальнейшей работы.
+
Доступна интеграция со следующими сервисами:
# После завершения регистрационных действий введите полученный публичный ключ и идентификатор в настройках личного кабинета курьерской службы. Подробнее см. [[Личный кабинет курьерской службы#Вкладка «Финансы»|настройки личного кабинета]].
+
* PimPay — финансирование для интернет-магазинов;
 +
* Robokassa — онлайн-оплата заказов;
 +
* ibox — мобильный эквайринг.
 +
 
 +
Сервисы настраиваются в [[Личный кабинет курьерской службы#Вкладка «Финансы»|личном кабинете курьерской службы]].
 +
 
 +
=== Robokassa ===
 +
 
 +
Чтобы настроить прием платежей через сервис Robokassa:
 +
# Зарегистрируйтесь в сервисе [https://partner.robokassa.ru/Reg Robokassa].
 +
# В [[Личный кабинет курьерской службы#Вкладка «Финансы»|настройках личного кабинета]] курьерской службы введите идентификатор магазина и пароли из личного кабинета Robokassa.
 +
# Установите флажок '''Тестовый режим''' и нажмите на кнопку '''Сохранить'''.
 +
# Откройте [[Личный кабинет курьерской службы#Отслеживание заказа по номеру|страницу отслеживания]] любого заказа с наложенным платежом и оплатой картой и убедитесь, что кнопка '''Оплатить картой''' появилась.
 +
# В настройках личного кабинета курьерской службы снимите флажок '''Тестовый режим''' и нажмите на кнопку '''Сохранить'''.
 +
 
 +
В результате получатель может оплатить заказ онлайн на странице отслеживания https://home.courierexe.ru/XX/tracking, где XX — код вашей курьерской службы:
 +
 
 +
[[Файл:Robokassa.png|none|900 px]]
 +
 
 +
При успешной оплате заказ в MeaSoft отмечается как оплаченный.  
 +
 
 +
В окне отслеживания в поле '''Наложенный платеж''' статус заказа  изменится на '''Заказ оплачен'''. Чек по операции придет на электронную почту, указанную при заказе.
 +
 
 +
=== PimPay ===
  
При успешной оплате заказ в MeaSoft отмечается как оплаченный.
+
Чтобы начать работать с [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]]
 
  
Чтобы продолжить, вам нужно сгенерировать ключи шифрования. Это делается на UNIX-подобной системе: [http://platform.api.pimpay.ru/v2_7/signature/openssl http://platform.api.pimpay.ru/v2_7/signature/openssl] или <spoiler text="наша инструкция">
+
В результате MeaSoft передает все заказы вашего клиента, их статусы и созданные [[Акты Передачи Денег и корреспонденции (АПД)|АПД]] в PimPay. PimPay ничего не передает в ответ.
Чтобы получить приватный ключ, необходимо запустить командную строку.
 
  
В командной строке необходимо выполнить следующие команды:
+
Чтобы платежи в банк по АПД выгружались в адрес PimPay, создайте клиента с названием «PIMPAY» и заполните его реквизиты.
openssl genrsa -out private.pem 2048
 
openssl rsa -in private.pem -outform PEM -pubout -out public.pem
 
  
После успешного выполнение команд Вы получить 2 файла: public.pem и private.pem
+
=== ibox ===
Содержимое файла public.pem - ваш публичный ключ, который необходимо целиком скопировать и вставить в ЛК PimPay.
 
А содержимое файла private.pem необходимо скопировать и вставить в настройках интеграции с PimPay в нашем ЛК.
 
</spoiler>[[Файл:pimpay client.png|thumb|200px|right|рис.2 Выбор платежного посредника]]
 
Если у вас нет специалиста, чтобы сгенерировать ключи, обратитесь в PimPay, они с радостью сделают это за вас!
 
  
Далее, необходимо прописать настройки для pimpay в панели управления нашего ЛК (см. рис.1). В ЛК PimPay нужно посмотреть код компании (у них называется "Код платформы") и токен, ввести их в форму.
+
Мобильный эквайринг ibox доступен через приложение или <rspoiler text="SDK">SDK — это средства разработки, которые позволяют приложению MeaSoft взаимодействовать с POS-терминалом напрямую.</rspoiler>. Подробнее см. раздел [[Мобильное приложение курьера для Android#ibox|«ibox»]].
  
Для каждого клиента, который хочет передавать данные в PimPay необходимо зарегистрировать в личном кабинете PimPay, и в нашей системе выбрать платежного посредника на вкладке "Финансы" карточки клиента. В процессе передачи данных привязка клиентов между системами производится по ИНН. Наша система начинает передавать все заказы вашего клиента в PimPay, их статусы, и созданные [[Акты Передачи Денег и корреспонденции (АПД)|АПД]]. Обратно она ничего не получает.
+
Для подтверждения успешной транзакции или отмены оплаты MeaSoft получает обратные вызовы (вебхуки) от ibox:
 +
* при успешной оплате после установки статуса корреспонденции со слов курьера '''Доставлено''' или '''Частично доставлено''' в MeaSoft на вкладке '''Выдача''' подсвечивается поле '''Тип оплаты''':
 +
** зеленым цветом, если оплата картой, есть идентификатор транзакции и сумма транзакции верная;
 +
** желтым цветом, если оплата картой, есть идентификатор транзакции, но сумма транзакции не совпадает со значением поля '''Сумма руб''' в карточке корреспонденции;
 +
** красным цветом, если оплата картой и нет идентификатора транзакции.
 +
*: Если в карточке корреспонденции указан тип оплаты '''Наличными''', то поле будет закрашено красным, если есть идентификатор безналичной транзакции или указана ее сумма. Если их нет, то поле будет зеленым;
 +
* при отмене оплаты обратный вызов удаляет идентификатор транзакции, чтобы сделать возможной повторную доставку и оплату заказа картой.
  
Для того, чтобы платежи в банк по АПД выгружались в адрес PimPay, нужно создать клиента с точно таким названием ("PIMPAY"), и заполнить его реквизиты.
+
Чтобы настроить работу обратных вызовов:
 +
# В личном кабинете курьерской службы в разделе '''Управление ЛК''' > '''Параметры''' > '''Финансы''' в разделе '''Настройки эквайринга 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 электронной цифровой подписи (ЭЦП)] для использования с ЭДО Диадок. Получите Рутокен с ЭЦП. При его подключении автоматически устанавливается набор ПО для его использования.
 
 
# Свяжитесь с [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://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-ключ приобретается отдельно на каждое ваше юр. лицо, поэтому его нужно вводить в "Фирмы".
+
# Обратитесь в СКБ Контур для выставления счета на пакет отправляемых документов. Пакет можно выбрать здесь: [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="EDocProvider"/> выберите '''Диадок'''.
## Если в вашем токене несколько сертификатов, в поле <mparam code="EDocLogin"/> можно указать отпечаток сертификата, который нужно использовать. Если пусто - программа постарается выбрать сертификат сама по доступности компании, к которой производится подключение. Посмотреть отпечаток: Пуск - Программы - Крипто-ПРО - "Сертификаты пользователя" - "Личное" - "Сертификаты". Справа выберите нужный сертификат, откройте. Перейдите на вкладку "Состав", прокрутите список значений вниз, в самом низу выберите "Отпечаток".
+
## Введите API-ключ в '''Справочники''' > '''Фирмы''' > '''Карточка фирмы''' > '''Ключ ЭДО'''.
## В поле <mparam code="EDocPass"/> введите пин-код сертификата. Если вы его не меняли, можно пропустить: по-умолчанию для рутокена пин - "12345678", и программа сама будет его использовать, если вы ничего не указали. Если он окажется не правильным - Крипто-ПРО спросит у вас верный пин при передаче данных. Обратите внимание, что количество попыток ввода пин-кода ограничено.
+
## Если в вашем токене несколько сертификатов, в поле <mparam code="EDocLogin"/>укажите без пробелов значение отпечатка сертификата, который нужно использовать. Чтобы просмотреть отпечаток, в меню '''Пуск''' выберите '''Программы''' > '''Крипто-ПРО''' > '''Сертификаты пользователя''' > '''Личное''' > '''Сертификаты'''. Справа выберите нужный сертификат, откройте. Перейдите на вкладку '''Состав''', прокрутите список значений вниз, в самом низу выберите '''Отпечаток'''.
# После ввода данных подключения нужно выйти, и запустить программу от имени администратора (права windows, правой кнопкой на ярлык - запустить от администратора), и осуществить обмен данными: "Связь" -> "Обмен с ЭДО". При первом использовании программа установит на компьютер специальный COM-объект Диадока. Именно для этого нужны права. В дальнейшем она будет использовать уже установленный компонент, и наличия прав не требуется.
+
## В поле <mparam code="EDocPass"/>введите пин-код сертификата. Если вы его не меняли, можно пропустить: по умолчанию пин-код рутокена «12345678», и программа сама будет его использовать, если вы ничего не указали. Если он окажется неправильным, Крипто-ПРО спросит у вас верный пин-код при передаче данных. Обратите внимание, что количество попыток ввода пин-кода ограничено.
 +
# После ввода данных подключения выйдите из системы и запустить программу от имени администратора: в контекстном меню ярлыка MeaSoft выберите пункт '''Запуск от имени администратора'''. Чтобы осуществить обмен данными, выберите '''Связь''' > '''Обмен с ЭДО'''. При первом использовании программа установит на компьютер специальный COM-объект Диадока. Именно для этого нужны права. В дальнейшем она будет использовать уже установленный компонент, и наличия прав не требуется.
  
 
=== Обмен данными с ЭДО ===
 
=== Обмен данными с ЭДО ===
 +
 
Выберите в главном меню "Связь" -> "Обмен с ЭДО". Откроется окно с выпадающим списком фирм, у которых заполнено поле "Ключ ЭДО". Выберите фирму, и нажмите "Обмен!". Программа выполнит все операции, которые периодически нужно выполнять, чтобы иметь актуальные данные как в нашей системе так и в ЭДО:
 
Выберите в главном меню "Связь" -> "Обмен с ЭДО". Откроется окно с выпадающим списком фирм, у которых заполнено поле "Ключ ЭДО". Выберите фирму, и нажмите "Обмен!". Программа выполнит все операции, которые периодически нужно выполнять, чтобы иметь актуальные данные как в нашей системе так и в ЭДО:
 
*Синхронизирует справочники контрагентов: Получит список контрагентов, уже являющихся вашими партнерами в ЭДО, проставит им соответствующие признаки (На вкладке "Клиенты" появилось новое поле "Статус ЭДО". Это поле нельзя менять, оно устанавливается автоматически), проверит, кто прислал вам приглашения к партнерству и примет их, разошлет приглашения всем вашим работающим контрагентам, проверит, кто принял приглашение, а кто - отказался.
 
*Синхронизирует справочники контрагентов: Получит список контрагентов, уже являющихся вашими партнерами в ЭДО, проставит им соответствующие признаки (На вкладке "Клиенты" появилось новое поле "Статус ЭДО". Это поле нельзя менять, оно устанавливается автоматически), проверит, кто прислал вам приглашения к партнерству и примет их, разошлет приглашения всем вашим работающим контрагентам, проверит, кто принял приглашение, а кто - отказался.
Строка 586: Строка 643:
  
 
=== Отправка документов ===
 
=== Отправка документов ===
 +
 
К отправке сейчас доступны счета, АПД и АПК. Отправка работает крайне похоже на e-mail. Документы формируются точно так же, но отправляются не почтой, а в ЭДО, уже подписанными вашей ЭЦП. В системе ЭДО "адресами" отправителя и получателя являются ИНН (по возможности еще КПП, но это не обязательно) компании, поэтому, чтобы все работало, ИНН должен быть заполнен. Так же ЭДО примет документы только в адрес компании, с которой у вас отмечены партнерские отношения, т.е. кто-то из вас отправил приглашение, а другой его принял. Поэтому, для удобства контроля - кому можно таким образом отправлять, а кому - нет, в списках документов добавлено поле "Есть ЭДО". Там галка ставится на основании статуса ЭДО клиента. Можете отсортировать по этому полю, выдели все, где есть галки, и разослать всем документы по ЭДО.
 
К отправке сейчас доступны счета, АПД и АПК. Отправка работает крайне похоже на e-mail. Документы формируются точно так же, но отправляются не почтой, а в ЭДО, уже подписанными вашей ЭЦП. В системе ЭДО "адресами" отправителя и получателя являются ИНН (по возможности еще КПП, но это не обязательно) компании, поэтому, чтобы все работало, ИНН должен быть заполнен. Так же ЭДО примет документы только в адрес компании, с которой у вас отмечены партнерские отношения, т.е. кто-то из вас отправил приглашение, а другой его принял. Поэтому, для удобства контроля - кому можно таким образом отправлять, а кому - нет, в списках документов добавлено поле "Есть ЭДО". Там галка ставится на основании статуса ЭДО клиента. Можете отсортировать по этому полю, выдели все, где есть галки, и разослать всем документы по ЭДО.
  
 
== Телефония ==
 
== Телефония ==
 +
 
Основная статья: [[Интеграция с телефонией]]
 
Основная статья: [[Интеграция с телефонией]]
  
 
== GPS-трекинг автотранспорта ==
 
== GPS-трекинг автотранспорта ==
 +
 
Для поддержки GPS-трекинга автотранспорта у нас разработана интеграция с коробочной системой Wialon, на которой работают большинство компаний, предоставляющих подобные услуги. Обратитесь в службу технической поддержки для помощи в настройке.
 
Для поддержки GPS-трекинга автотранспорта у нас разработана интеграция с коробочной системой Wialon, на которой работают большинство компаний, предоставляющих подобные услуги. Обратитесь в службу технической поддержки для помощи в настройке.

Версия 12:53, 5 мая 2021

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

Содержание

Интеграция между двумя клиентами MeaSoft

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

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

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

Порядок действий:

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

В результате такой настройки все отправления, у которых Клиент установит «Ответственный филиал», соответствующий Агенту (правильнее всего это через манифест, скомплектовав его и проставив дату отправки), будут переданы в БД Агента, и статусы будут передаваться обратно. На передачу данных может уходить до 10 минут в штатном режиме и до 1 часа в случае возможных сбоев.

Обратите внимание!

При передаче заказов, у которых плановая дата доставки меньше ближайшей возможной, дата доставки автоматически меняется на самую раннюю возможную.

Для стабильной работы необходимо наличие версии минимум 518 от 05.12.2014 у обеих компаний.

Интеграция с подрядчиками (передача заказов)

Отказ от ответственности

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

Общие правила настройки интеграции

Здесь рассматривается интеграция с системами сторонних компаний (агент), где система MeaSoft (клиент) выступает клиентом, т.е. передает заказы и получает обратно статусы.

Клиент должен иметь аккаунт и личный кабинет в системе MeaSoft. Подробнее см. раздел «Личный кабинет курьерской службы».

  1. Создайте в своей системе филиал (Справочники > Межгород > Филиалы) для указанного агента. После ввода филиала нужно перезагрузить программу и подождать 3 минуты.
  2. Зайдите в личный кабинет курьерской службы в системе MeaSoft. Чтобы узнать свои учетные данные, выберите Справочники > Дополнительные модули:
    Measoft home.png
  3. В личном кабинете перейдите на закладку Интеграции. В таблице должен появиться созданный филиал.
  4. Нажмите на кнопку Настроить напротив филиала, в открывшемся окне выберите интегратор той компании, с которой хотите интегрировать. Далее заполните форму по отображенной инструкции (для каждого интегратора форма и инструкции свои), нажмите Сохранить.

Если устанавливается интеграция между CMS- или CRM-системой и подрядчиком из таблицы, при авторизации в личном кабинете клиента укажите код клиентской службы подрядчика (столбец «Код экстра»).

В результате настройки все отправления, у которых клиент установит Ответственный филиал, соответствующий агенту, будут переданы в БД агента и статусы будут передаваться обратно.

Правильнее оформлять отправление как манифест, комплектовать его и проставить дату отправки.

На передачу данных может уходить до 10 минут в штатном режиме и до 1 часа в случае возможных сбоев.

Для стабильной работы необходимо наличие у клиента системы MeaSoft версии минимум 518 от 05.12.2014.

СДЭК

Отправка в СДЭК осуществляется первым доступным тарифом из списка:

  • «Экономичная посылка»,
  • «Посылочка»,
  • «Экспресс-лайт»,
  • «Магистральный экспресс».

В настройках интеграции MeaSoft может поменять местами тарифы «Экономичная посылка» и «Посылочка». При весе отправления больше 30 кг применяется тариф «Магистральный экспресс».

Чтобы передать услугу «Примерка», установите флажок Принято на склад в карточке корреспонденции. Если услуга не нужна, снимите флажок.

При передаче валюты наложенного платежа код валюты берется из поля Валюта карточки клиента, от которого передается заказ. Валюта должна совпадать с валютой страны назначения заказа. Если заказ отправляется в другую страну, создайте копию клиента с нужной валютой и оформляйте заказы от него, указывая цены в валюте страны назначения.

В общем случае интеграция не поддерживает отправки в другие страны, кроме России.

Загрузка отчета СДЭК Создает входящий АПД по отчету СДЭК такого формата. Работает начиная с версии 626 от 29.01.2016 и только при передаче заказов в СДЭК с помощью штатной интеграции. Заполняет поле Агентская цена в карточке корреспонденции на вкладке Межгород.

TopDelivery

Печать наклеек для TopDelivery

Почта России

Интеграция с Почтой России описана в разделе Работа с Почтой России.

PickPoint

Если PickPoint выделил вам диапазон трекинг-номеров, то необходимо настроить филиал и придерживаться последовательности отправки манифестов. Для настройки филиала для интеграции PickPoint с диапазоном в основном меню выберите Справочники -> Межгород -> Филиалы нажатием правой кнопки мыши на предварительно созданном филиале, в контекстном меню выберите Открыть в открывшейся форме перейдите на вкладку Интеграция и в выпадающем списке Правила назначения кода заказа у подрядчика выберите Из диапазона. Укажите начальный и конечные коды диапазона, префикс при необходимости и нажмите клавишу ОК.

Для отправки манифестов добавьте заказы в манифест, затем, на вкладке Манифесты необходимо добавить требуемые заказы в мешок, а далее выбрать в манифесте ранее настроенный филиал. После чего, в контекстном меню манифеста выбрать пункт Проставить коды у подрядчика. После этого можно указать дату отправки манифеста.

Обратите внимание, что проставить коды с указанной датой отправки манифеста нельзя. Необходимо сначала очистить дату отправки, а затем проставить коды.

Агентская цена данной интеграцией не возвращается, т.к. эти данные отсутствуют в API PickPoint.

КСЭ

Настройки интеграции:

  • Данные отправителя - данные, которые будут подставляться во все отправления, передаваемые в КСЭ. Если не указать, то будут передаваться данные заказчика (отправителя) из корреспонденции.
  • Является ИМ - признак отправителя в системе КСЭ. От данного признака зависит главным образом, как отправляются данные в КСЭ. Признак указывается в договоре клиента с КСЭ.
  • Забор - настройка, в которой можно указать, каким образом отправление передается в КСЭ - КСЭ забирает отправление у клиента или клиент сам привозит отправление в КСЭ.

DOSTAVKA.GURU

При настройке интеграции в CRM- или CMS-системе введите следующие учетные данные:

  • логин — ID клиента DOSTAVKA.GURU. ID клиента отображается вверху страницы личного кабинета клиента DOSTAVKA.GURU;
  • пароль — запросите API-ключ интеграции у DOSTAVKA.GURU;
  • код курьерской службы — 90017.

Тарификация и выбор подрядчика и его тарифа клиентом

Вы можете настроить подключение своего тарифа к тарифу партнера — любой компании, работающей в системе MeaSoft, а также ряду компаний, с которыми у нас есть интеграции, см. список ниже.

Чтобы настроить подключение к тарифу партнера:

  1. Зарегистрируйтесь в системе подрядчика. Данные аккаунта понадобятся для настройки интеграции.
  2. Откройте Справочники > Статусы > 17 Виды срочности и создайте вид срочности, например «СДЭК».
  3. В контекстном меню вида срочности выберите пункт Дополнительная информация и во второй строке заполните параметры подключения к партнеру через запятую:
    • 1-й параметр — код филиала партнера, его можно посмотреть в Справочники > Межгород > Филиалы;
    • 2-й параметр — экстра-код партнера в системе MeaSoft. В том числе для сторонних компаний есть коды, см. таблицу ниже;
    • 3-й параметр — имя пользователя в системе партнера. Может отличаться от того, под которым работает интеграция, здесь нужно для расчета цены для клиента. В таблице ниже указано, что вводить для каждого интегратора;
    • 4-й параметр — пароль пользователя из 3-го параметра. В таблице ниже указано, что вводить для каждого интегратора;
    • 5-й параметр — вид срочности партнера. Посмотреть доступные коды видов срочности можно по ссылке в таблице ниже, в калькуляторе в выпадающем списке. Можно в одинарных кавычках указать несколько видов срочности через запятую, тогда система будет стараться выбрать из них первый доступный;
    • 6-й параметр — наценка к цене, передаваемой подрядчиком. В деньгах или в процентах, если стоит знак процента. Например, 10 — наценка 10 рублей, 10% — наценка 10 процентов;
    • 7-й параметр — если указать значение 1, сквозная тарификация выключена. Параметр используется, если подключение нужно только для передачи заказов по интеграции, а расчет цены не нужен.
  4. Нажмите на кнопку OK.
Интеграция Код экстра Виды срочности Авторизация Пример строки
БОКСБЕРРИ 90001 https://home.courierexe.ru/90001/calculator Введите токен в 4-й параметр. 3-й можно оставить пустым. Можно оба оставить пустыми для расчета базовых цен. 33, 90001,, j3ejwo2f10b2e47790174b41f4a11111, 2, 50
ПИКПОИНТ 90002 https://home.courierexe.ru/90002/calculator 3-й параметр — логин, 4-й — через запятую пароль и договор ИКН. Можно оставить пустыми, но цены будут не все. 33, 90002,us0111, '6rGGuqRsW2qNQ,9990721312', 2, 50
СДЭК 90005 https://home.courierexe.ru/90005/calculator Введите код учетной записи в 3-й параметр, секретный код — в 4-й. Можно оба оставить пустыми для расчета базовых цен. 45491, 90005, hfenJwlasiPr4pnFENpaVXSKPIn5Trh7i, '9vkQgWuiZgEj9fGCB8a6Xj3desnJkwsl,1.5', 5, 30%
Если вы хотите добавить в расчет тарифа процент за наложенный платеж, после пароля добавьте запятую и число процента. В настройке режима срочности пароль с числом процентов заключите в кавычки. 9vkQgWuiZgEj9fGCB8a6Xj3desnJkws,1.5
КСЭ 90008 https://home.courierexe.ru/90008/calculator Введите логин в 3-й параметр, пароль — в 4-й. Пустыми оставить нельзя. 12504, 90008, Рога и копыта, 4CCB11864D06157, '2, 3, 6', 10%
ПОЧТА РОССИИ 90010 https://home.courierexe.ru/90010/calculator Пока поддерживаются только базовые тарифы, без авторизации. 10497, 90010,,, '2, 1', 10
DPD 90011 https://home.courierexe.ru/90011/calculator Введите клиентский номер в 3-й параметр, клиентский ключ в 4-й. Можно оставить пустыми для базовых тарифов. 12504, 90011, 1019003662, '4CCB11864D06157A5934A9119F2A0AAAAAB4CCE8,D117', '3, 6', 10%
Если вы доставляете товар в пункт отправления самостоятельно, после пароля добавьте запятую и код ПВЗ, а в настройке режима срочности введите пароль в кавычках. '4CCB11864D06157A5934A9119F2A0AAAAAB4CCE8,D117'
ВНИМАНИЕ! У DPD есть 2 калькулятора, которые считают по-разному при одних и тех же вводных данных. При этом они не разглашают, по какому из расчетов определяют цену. Поэтому по не зависящим от нас причинам расчет по тарифам DPD может как совпасть с итоговым, так и сильно разойтись. Если вас это не устраивает, не используйте сквозную тарификацию с этим подрядчиком.
DOSTAVKA.GURU 90017 https://home.courierexe.ru/90017/calculator 3-й параметр — ID партнера в системе DOSTAVKA.guru, 4-й — ключ доступа. Можно оставить пустыми. 10497, 90017, 9999, cc03e747a6afbbcbf8be7668acfebee5, '1', 100
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

При выборе клиентом в личном кабинете вида срочности, подключенного таким образом к партнеру, набор доступных ПВЗ будет ограничен выбранным партнером.

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

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

Замечания

  1. В модулях систем PrestaShop и Joomla для отправки заказа в курьерскую службу зайдите в карточку заказа. В карточке отображается специальная форма отправки заказа, а если заказ отправлен, она позволяет проверить его статус.
    Форма отправки заказа
  2. Оформление заказов до ПВЗ в модулях PrestaShop и Joomla не реализовано. Чтобы оформить такой заказ, в поле передаваемого адреса укажите одно из значений:
    • код ПВЗ, который можно посмотреть в ЛК клиента или на сайте агента (Boxberry, CDEK и т.п.). Обычно это цифровой или цифро-буквенный код;
    • наименование ПВЗ, добавив в начале строку "ПВЗ ", например ПВЗ На Ленина.
  3. Поддерживается передача маркировки «Честный ЗНАК» из InSales и RetailCRM. Информацию по настройке см. в документации Insales и RetailCRM.
  4. При проблемах с отображением карты в модулях очистите кэш браузера: например, для Google Chrome нажмите CTRL+F5. Введенные данные потеряны не будут, карта после этого отобразится корректно.

OpenCart

OpenCart 1.5.5.1

Важно! Перед любыми изменениями настроек рекомендуется сделать резервную копию сайта. Для настройки синхронизации:

  1. Загрузите содержимое папки upload из архива в папку сайта по FTP. При необходимости подтвердите замену файлов.
  2. Зайдите в панель администратора OpenСart. Подробнее см. в документации OpenCart.
  3. В меню панели управления выберите Дополнения, раздел Модули. В открывшемся списке найдите КС2008 и нажмите на кнопку Установить.
  4. В меню панели управления выберите Дополнения, раздел Доставка. В открывшемся списке найдите Основные настройки интеграции КС2008 и нажмите на кнопку Установить. Рядом появится кнопка Изменить.
  5. Нажмите на кнопку Изменить. Откроется страница «Основные настройки интеграции КС2008»:
    OpenCart.png

    Заполните обязательные поля:
    • Логин — логин пользователя, выдается курьерской службой.
    • Пароль — пароль пользователя, выдается курьерской службой.
    • Код курьерской службы — выдается курьерской службой.
    • Город отправителя. После ввода убедитесь, что в названии населенного пункта нет ошибок.
      При необходимости заполните остальные поля. Нажмите на кнопку Сохранить.
  6. В меню панели управления выберите Дополнения, раздел Доставка. В открывшемся списке найдите Настройки доставки курьером КС2008 и нажмите на кнопку Установить. Рядом появится кнопка Изменить.
  7. Нажмите на кнопку Изменить и в поле Тариф для расчета стоимости доставки выберите нужный тариф. По умолчанию используется первое значение выпадающего списка.

OpenCart 2.0 и выше

Настройка интеграции
  1. Скачайте установочный файл для нужной версии OpenCart.
  2. Зайдите в панель администратора OpenСart. Подробнее см. в документации OpenCart.
  3. В панели управления OpenCart выберите Установка дополнений (Установка расширений) и на странице «Установщик дополнений OCMOD» нажмите на кнопку Загрузить.
  4. В открывшемся диалоговом окне выберите загруженный файл в формате ZIP и нажмите на кнопку Продолжить.
    Когда загрузка будет окончена, индикатор загрузки в поле Выполнение станет зеленым.
    Примечание. Убедитесь, что название файла оканчивается на «ocmod.zip». Названия вида «ocmod(2).zip» и подобные приведут к ошибкам загрузки файла.
  5. В панели управления выберите Менеджер дополнений (Модификаторы) и в правом верхнем углу страницы нажмите на кнопку Обновить.
  6. Для OpenCart 2.0 и выше: в панели управления выберите Дополнения (Расширения), раздел Доставка.
    Для OpenCart 3.0 и выше: в меню панели управления в разделе Расширения выберите Расширения и на странице Список расширений в выпадающем списке выберите Доставка.
    В открывшемся списке найдите Основные настройки интеграции КС2008 и нажмите на кнопку Установить. Рядом станет активна кнопка Редактировать.
  7. Нажмите на кнопку Редактировать. Откроется страница «Основные настройки интеграции КС2008».
  8. Заполните обязательные поля:
    • Логин — логин пользователя, выдается курьерской службой.
    • Пароль — пароль пользователя, выдается курьерской службой.
    • Код курьерской службы — выдается курьерской службой.
    • Наценка на доставку (множитель) — множитель наценки на стоимости доставки. Если наценки нет, установите 0.
    • Наценка на доставку (добавочная) — конкретная величина наценки на стоимость доставки. Если наценки нет, установите 0.
    • Ваш город — город отправителя. После ввода убедитесь, что в названии населенного пункта нет ошибок.
      При необходимости заполните остальные поля. Нажмите на кнопку Сохранить в правом верхнем углу.
  9. В разделе Доставка найдите Настройки доставки курьером КС2008 и нажмите на кнопку Установить. Рядом станет активна кнопка Редактировать.
  10. Нажмите на кнопку Редактировать и в поле Тариф для расчета стоимости доставки выберите нужный тариф. По умолчанию используется первое значение выпадающего списка.
Изменение данных заказа
  1. В административной части сайта откройте заказ и вверху справа нажмите на кнопку OpenCartEdit.png.
  2. В режиме редактирования данные заказа представлены на пяти вкладках. Измените данные, для перемещения по вкладкам используйте кнопки Продолжить и Назад.
  3. На вкладке Итоги проверьте введенные данные и нажмите на кнопку Применить для сохранения изменений в каждой строке.
  4. Нажмите на кнопку Сохранить.

Возможные ошибки

  • Ошибка локализации. Чтобы переключить язык сайта на русский, сверьте названия папок локализации в скачанном архиве модуля (\upload\admin\language) и в созданном после установки модуля каталоге. Названия папок должны быть одинаковыми, например ru-ru и en-gb. Если в результате установки появилась папка с другим именем, перенесите ее содержимое в нужную папку.
  • При возникновении ошибок:
    1. В панели управления выберите Менеджер дополнений (Модификаторы) и в правом верхнем углу страницы нажмите на кнопку Обновить.
    2. Очистите кэш везде — в панели состояния, в дополнительных модулях, в браузере и т.п.
    3. Проверьте работу модуля.
    Для OpenCart 3.0 и выше с установленным модулем Simple установите модификатор и выполните шаги 1-3.

1C-Битрикс

Настройка интеграции

  1. В личном кабинете 1C-Битрикс на вкладке Администрирование в панели слева выберите Marketplace > Каталог решений и на странице «Каталог Маркетплейс» с помощью строки поиска найдите Модуль интеграции MEASoft.
  2. Щелкните по ссылке «Установить».
  3. Убедитесь, что в строке Модуль интеграции MEASoft установлен флажок, и нажмите на кнопку Загрузить. Далее примите лицензионное соглашение и нажмите Применить.
  4. После окончания загрузки нажмите на кнопку Установить.
  5. В панели слева выберите Магазин > Настройки > Службы доставки, затем на странице «Список служб доставок» раскройте выпадающий список кнопки Добавить и выберите пункт Автоматизированная служба доставки. Откроется страница «Новая служба доставки».
  6. На странице «Новая служба доставки» перейдите на вкладку Настройки обработчика и в выпадающем списке Служба доставки выберите "Курьерская служба" - сервис доставки. Нажмите на кнопку Применить.
  7. Перейдите на вкладку Настройки интеграции:
    Bitrix Настройки интеграции.png
    На этой вкладке:
    • в разделе Настройки доступа введите учетные данные личного кабинета в поля Логин, Пароль и Код клиента. Запросите эти данные у курьерской службы, с которой настраивается интеграция. Кнопка Проверить предназначена для проверки введенных учетных данных.
    • в разделе Основные настройки:
      • в поле Оплата картой выберите тип оплаты, который будет соответствовать оплате картой (если оплата картой возможна);
      • установите флажок Использовать артикулы, если артикулы будут использоваться для привязки номенклатуры к складу курьерской службы;
    • в разделе Соответствующие поля покупателя настройте соответствие полей получателя (ФИО, города, адреса и др.) полям в форме создания заказа;
    • для работы с товарами, маркированными кодом «Честный ЗНАК», в разделе Соответствующие поля товаров укажите поле для хранения кода;
    • в разделе Статусы отправки заказа выберите статусы, при которых заказ будет автоматически отправлен в курьерскую службу.
  8. На вкладке Ценовая политика доставки при необходимости настройте стоимость доставки для покупателя в зависимости от стоимости заказа.
  9. На вкладке Ограничения при необходимости укажите ограничения работы модуля по географии, типам оплаты и т.п.
  10. По завершении настройки нажмите на кнопку Сохранить.
  11. В настройках магазина укажите его местоположение для определения города отправителя.
    Если нужно производить расчет для другого города отправителя (например, физически магазин находится в области, а курьерская служба должна считать доставку, как по городу):
    • в разделе Рабочий стол > Настройки > Настройки продукта > Настройки модулей > Курьерская служба в поле Города-отправители добавьте город отправителя;
    • в разделе Рабочий стол > Магазин > Настройки > Службы доставки > Нужная служба > Настройки интеграции > Город отправитель укажите добавленный выше город.

Проверить работу модуля можно в форме оформления доставки. При этом должна корректно считаться стоимость доставки.

Перенос даты доставки

Вы можете настроить перенос даты доставки на один день вперед от даты, получаемой от курьерской службы, если заказ оформлен позже определенного часа.

Чтобы настроить перенос даты доставки:

  1. В личном кабинете 1C-Битрикс на вкладке Администрирование в панели слева выберите Контент > Структура сайта > Файлы и папки и в окне «Управление структурой» в поле Путь введите /bitrix/modules/measoft.courier/MeasoftEvents.php.
  2. В окне «Просмотр файла "MeasoftEvents.php"» нажмите на кнопку Редактировать > Редактировать как PHP.
  3. В окне «Редактирование файла "MeasoftEvents.php"» найдите строки:
define("measoft_check_fill_deliverydate", "Y");
define("measoft_check_fill_deliverydate_hour", 14);
Если строки закомментированы, удалите символы комментирования («//»).
4. Укажите значения переменных:
  • возможные значения для первой строки: Y — переносить дату доставки, N — не переносить дату доставки;
  • возможные значения для второй строки: целое число от 1 до 24. Если оформить заказ после указанного часа, к дате доставки, получаемой от курьерской службы, прибавляется один день.
5. Нажмите на кнопку Сохранить.

Передача наложенного платежа

  1. В личном кабинете 1C-Битрикс на вкладке Администрирование в панели слева выберите Настройки > Настройки продукта > Настройки модулей и на странице «Настройки модуля» в выпадающем списке выберите значение Курьерская служба.
  2. Установите флажки в списках ниже для сопоставления типов оплаты наложенного платежа.
  3. Нажмите на кнопку Сохранить.

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

Отправка заказа в курьерскую службу

Чтобы отправить заказ в курьерскую службу, зайдите в карточку заказа, укажите настроенное значение в поле Статус отправки заказа и нажмите на кнопку Сохранить.

Примечание. Значения полей Комментарий покупателя к заказу и Комментарий менеджера передаются из 1С-Битрикс в поле Комментарий заказа в системе MeaSoft.

Если статус уже установлен, но заказ не отправлен в курьерскую службу (связано с техническими особенностями):

  1. Выберите статус заказа по умолчанию после его создания (например, Новый).
  2. Перезагрузите страницу.
  3. Выберите статус отправки и сохраните его.

При отправке заказа появится сообщение об успешной отправке или об ошибке. Статус заказа можно проверить в карточке заказа, в правом верхнем углу.

Возможные ошибки

  1. Если не рассчитывается стоимость, возможные причины:
    • некорректно установлен модуль;
    • введены некорректные учетные данные;
    • в курьерской службе не настроен тариф. Обратитесь в курьерскую службу для настройки тарифа. После настройки тарифы можно проверить в личном кабинете, на вкладке Калькулятор.
  2. По умолчанию при оформлении заказа должны появиться поля даты и времени желаемой доставки. Если они отсутствуют, то у формы были изменены стили. Также возможно обновление формы в системе Битрикс.
    Bitrix2.png
  3. Проверьте правильность привязки свойств. Для этого в разделе Рабочий стол > Магазин > Настройки > Свойства заказа > Список свойств найдите свойство, связанное с ошибкой, щелкните по нему правой кнопкой мыши и выберите Изменить параметры свойства.
    На вкладке Привязка свойства настраиваются условия, при которых поле будет показываться клиенту. Если у свойства заказа настроена привязка, то оно будет показываться ТОЛЬКО в том случае, когда покупатель выберет хотя бы один из указанных критериев:
    Битрикс Связь свойства.png

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

Свойство будет показано всегда, если привязка не выбрана или если выбраны все варианты платежных систем или служб доставки.

Подробнее см. документацию 1С-Битрикс.

InSales

Для удобства работы до настройки интеграции создайте в InSales следующие пользовательские статусы:

  • статус для автоматической передачи заказов в курьерскую службу,
  • статус для обозначения заказа с ошибкой передачи данных.

Чтобы настроить статусы, в панели администрирования InSales выберите Настройки > Оформление заказа > Пользовательские статусы и создайте статусы, например «Передано в КС» и «Ошибка».

Настройка интеграции

  1. В личном кабинете InSales откройте Приложения > Центр приложений, с помощью строки поиска найдите модуль «Курьерская служба 2008» и нажмите на кнопку Установить.
  2. Откроется личный кабинет InSales. На странице «Установка приложения» нажмите на кнопку Установить.
  3. В списке установленных приложений выберите «Модуль "Курьерская служба 2008"». Откроется страница авторизации личного кабинета клиента курьерской службы. Если вы авторизованы в ЛК курьерской службы, то сразу откроется страница настроек, см. п. 5.
  4. Введите учетные данные личного кабинета в поля Логин, Пароль и Код курьерской службы. Запросите эти данные у курьерской службы, с которой настраивается интеграция.
  5. На странице «Настройка интеграции Insales» выполните настройку интеграции.
    Особенности заполнения полей:
    • Статус заказа для автоматической отправки в курьерскую службу. Выберите из выпадающего списка заранее созданный статус, при установке которого заказ автоматически отправляется в курьерскую службу, или значение Не отправлять.
    • Отправлять артикулы (для привязки к складу). Если опция включена, артикулы товаров из InSales передаются в MeaSoft.
    • Название доставки курьером на странице заказа. Укажите название доставки, которое будет отображаться в заказе вместо «Курьерская доставка МЕАСОФТ» при выборе способа доставки. Можно оставить поле пустым, тогда список будет выглядеть следующим образом:
      Insales Delivery.png
    • Описание доставки курьером на странице заказа. Укажите описание вида доставки. Можно оставить поле пустым.
    • Синхронизировать остатки по складам. Если опция включена, данные по складским остаткам из курьерской службы передаются в InSales.
    • Используется мультисклад?. Определяет, используется ли выбор товаров с одного склада или из нескольких. Возможные значения: Да, Нет. В случае работы с несколькими складами убедитесь, что в настройках InSales (Настройки > Настройки магазина > Мультисклад.) указано такое же количество складов, как в системе MeaSoft.
    • Статус заказа при ошибке передачи в курьерскую службу. Выберите из выпадающего списка заранее созданный статус, который будет использоваться для обозначения заказов с ошибкой передачи данных, или укажите значение Не отправлять.
    • Производить расчет без адреса?. Если выбрано значение Нет, расчет стоимости доставки возможен только после ввода полного адреса получателя.
  6. По заполнении нужных полей нажмите Сохранить.

В результате в InSales в окне создания заказа появляется блок «Модуль "Курьерская служба 2008"»:

Insales Module KS.png

Настройка типов оплаты

Тип оплаты заказа определяется следующим образом:

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

В системе MeaSoft в карточке интернет-магазина есть флажок Спрашивать тип оплаты у получателя. Если он установлен, то независимо от переданного типа оплаты Наличными или Банковская карта покупателю будет предложен выбор способа оплаты.

Настройки интеграции можно изменить в разделе Автоматизация личного кабинета MeaSoft.

RetailCRM

См. раздел «RetailCRM».

CS-Cart

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

  1. Скачайте архив модуля установки по ссылке.
  2. В панели администратора CS-Cart откройте Модули > Управление модулями и на странице «Модули» нажмите на кнопку Cscart добавить.png. Откроется окно «Загрузить и установить модуль».
  3. В этом окне нажмите на кнопку Загрузить, выберите архив с модулем на компьютере и нажмите на кнопку Загрузить и установить. Модуль «Курьерская служба 2008» появится в списке модулей.
  4. Откройте Администрирование > Доставка и налоги > Способы доставки и нажмите на кнопку Cscart добавить.png. Откроется окно «Новый метод доставки»:

    Cscart настройка.png
  5. В этом окне укажите следующие настройки:
    • в поле Расчет тарифа установите переключатель В режиме реального времени;
    • в выпадающем списке Перевозчик выберите значение КС2008;
    • в выпадающем списке Служба доставки выберите режим срочности по умолчанию;
    • заполните остальные поля.
  6. Нажмите на кнопку Создать. Появляется оповещение о том, что изменения сохранены, и в этом же окне появляются кнопки настройки. Нажмите на кнопку Настроить:

    Cscart курьером.png
  7. В этом окне укажите следующие настройки:
    • введите учетные данные клиента курьерской службы. Запросите эти данные у курьерской службы, с которой настраивается интеграция. На рисунке указаны учетные данные тестового доступа;
    • Укажите тип доставки. Возможные значения: Курьером до двери, ПВЗ.
  8. Нажмите на кнопку Сохранить.

Чтобы проверить работу интеграции, нажмите на кнопку Общее, нажмите Рассчитать стоимость доставки, введите вес отправления и нажмите на кнопку Тест. При настроенной интеграции отобразится окно с расчетной стоимостью и сроком доставки.

Чтобы создать два способа доставки — Курьером до двери и ПВЗ, повторите все шаги, начиная с п. 4.

В результате новые способы доставки будут отображаться в списке Администрирование > Доставка и налоги > Способы доставки и в окне создания заказа:

Cscart оформить заказ.png

Чтобы просмотреть полученные заказы, откройте Заказы > Полученные заказы. В карточке заказа в правом нижнем углу находится блок модуля «Курьерская служба 2008»:

Cscart блок кс.png

Чтобы передать заказ в курьерскую службу, нажмите на ссылку Отгрузить.

Также в этом блоке вы можете проверить статус доставки заказа.

Примечание. Модуль поддерживает CS-Cart 4.10 и выше.

amoCRM

Интеграция реализована через виджет «Курьерская служба 2008», предназначенный для передачи заказов из amoCRM в MeaSoft и возврата статусов.

Чтобы начать отправлять заказы в курьерскую службу, настройте интеграцию с MeaSoft и сопоставьте поля amoCRM и виджета для корректной передачи данных в MeaSoft.

Настройка интеграции

Для удобства работы перед настройкой интеграции добавьте дополнительные поля в сделке: выберите Сделки > Новая сделка и на вкладке Настроить добавьте в любую группу новые поля Стоимость доставки, Стоимость товаров, Закупка.

Amo Settings.png

Чтобы настроить интеграцию с amoCRM:

  1. Этот этап можно делать из личного кабинета MeaSoft ИЛИ из административной части amoCRM:
    • В личном кабинете MeaSoft:
      1. В разделе Автоматизация перейдите на вкладку Обратная интеграция и в таблице «Список всех обратных интеграций» в строке «AmoCRM» нажмите Добавить.
      2. Укажите название интеграции и префикс и нажмите на кнопку Сохранить.
      3. Укажите аккаунт amoCRM, в котором будет установлен виджет «Курьерская служба 2008» и нажмите Разрешить. Виджет установлен.
    • В административной части amoCRM:
      1. В меню выберите Настройки > Интеграции и в строке поиска введите «Курьерская служба 2008».
      2. Щелкните по найденному модулю, нажмите на кнопку Установить. Виджет установлен.
  2. В amoCRM выберите Настройки > Интеграции и в разделе Установленные интеграции откройте «Курьерская служба 2008».
  3. Введите логин, пароль и код курьерской службы. Запросите эти данные у курьерской службы, с которой настраивается интеграция.
  4. Нажмите на кнопку Настройки виджета. В окне «Настройки интеграции с Курьерская служба 2008»:
    1. Установите параметры товаров и доставки.
    2. Установите поля для сохранения данных заказа. Например, в выпадающем списке поля Сохранять стоимость товаров в отдельное поле укажите значение Сохранять в поле: Стоимость товаров.
    3. Укажите, откуда будут добавляться товары к заказу. Если это список в amoCRM, настройте соответствие полей. Списки amoCRM доступны начиная с тарифного плана «Расширенный».
    4. Установите соответствие между статусами в личном кабинете клиента курьерской службы и статусами amoCRM.
    5. Нажмите Сохранить настройки.
  5. В окне ввода учетных данных интеграции нажмите Сохранить.

Сопоставление полей

Поле виджета Данные amoCRM Где настраивается сопоставление
Имя, Телефон Поля карточки контакта -
Номер заказа • Название сделки;
• ID сделки;
• пользовательское поле
Настройки виджета > Настройки интеграции с Курьерская служба 2008
Город, Адрес, Индекс, Примечание, Дата доставки Поля сделки Настройки виджета > Настройки интеграции с Курьерская служба 2008
Вес, Сумма, Объявленная ценность, название и количество товара Карточка товара • Если товар добавляется вручную или из каталога Курьерской службы 2008, сопоставление не требуется;
• если товар добавляется из списка amoCRM, настройте сопоставление в Настройки виджета > Настройка товаров
Количество мест - Заполняется в виджете вручную

Беру

При интеграции поддерживается:

  • Обработка координат.

МойСклад

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

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

  1. В системе МойСклад создайте дополнительные поля в заказах:
    • с типом «Строка»:
      • Город — для указания населенного пункта получателя;
      • Дата доставки — для указания даты доставки наряду со временем;
      • Сумма заказа — для получения суммы заказа от курьерской службы;
      • Стоимость доставки — для получения стоимости доставки от курьерской службы;
      • Строка для сохранения информации об ошибках — для получения текста ошибки;
      • Количество мест — для возможности указания количества мест;
    • с типом «Файл»:
      • Файл — необязательное поле для передачи файлов. Максимальный размер файла — 1 МБ;
    • с типом «Справочник»:
      • Виды срочности — одноименный справочник;
      • Временные интервалы — одноименный справочник;
      • Способы доставки — одноименный справочник;
      • Тип оплаты — одноименный справочник;
      • Время доставки с — справочник Часы доставки;
      • Время доставки по — справочник Часы доставки.
  2. Перейдите по ссылке и введите логин и пароль от учетной записи системы «МойСклад» с правами администратора.

    Примечание. Запрещено изменять данные этой учетной записи — это приведет к сбою интеграции. В будущем при обращении в техническую поддержку MeaSoft указывайте данные этой учетной записи для получения помощи по вопросам интеграции.
    Если все же есть необходимость сменить учетные данные, после сообщите новый пароль от «МойСклад» в техподдержку MeaSoft для внесения изменений в настройки интеграции.

  3. Укажите логин, пароль и код курьерской службы. Запросите эти данные у курьерской службы, с которой настраивается интеграция.
  4. Нажмите на кнопку Сохранить.
    В случае ошибки «Данный пользователь "Мой склад" уже зарегистрирован.» нажмите на кнопку Сбросить.
  5. Дождитесь окончания синхронизации справочников. Не закрывайте и не перезагружайте страницу. Процесс может занять продолжительное время (от 10 минут).
    После синхронизации справочников автоматически произойдет переход на страницу следующего шага.
  6. Настройте статусы отправки, соответствие полей и соответствие статусов.
  7. Сохраните настройки.

Для отправки заказа обязательно должен быть заполнен вес хотя бы одного товара.

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

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

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

Чтобы отправить заказ, присвойте заказу статус для передачи в курьерскую службу. Заказ отправляется в курьерскую службу.

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

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

Известные проблемы

Модуль интеграции не работает на бесплатном тарифе.

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

Wordpress

Требования к сайту

  1. CMS WordPress версии 5 или более новая;
  2. WooCommerce версии 3.9 или более новая;
  3. PHP версии 7 или более новая;
  4. сайт должен использовать SSL-сертификат.

Порядок установки плагина и вывод нового способа доставки в корзину

  1. В панели администратора сайта откройте страницу Плагины > Добавить новый и нажмите на кнопку Загрузить плагин.
  2. В появившейся форме выберите архив с плагином на вашем компьютере и нажмите кнопку Установить.
  3. После загрузки и установки плагина вы можете его активировать нажав на соответствующую кнопку.
  4. После активации плагина в меню появится ссылка на страницу настроек плагина. Заполните все необходимые поля и нажмите кнопку Сохранить изменения.
  5. Откройте настройки WooCommerce и переключите на вкладку Доставка.
  6. Выберите необходимую зону доставки или создайте её.
  7. Нажмите на кнопку Добавить метод доставки и выберите из списка КС2008.
  8. После создания заказа в панели администратора в форме изменения заказа справа появится блок модуля Отправить в курьерскую службу с кнопкой Отправить заказ в КС2008, при нажатии на которую заказ будет отправлен в курьерскую службу.

Обновление статусов

Обновление статусов заказов происходит через технологию WP_Cron каждые 30 минут.

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

Проверка работоспособности интеграций

При неполадках интеграции проверьте ее работоспособность. В общем случае для этого достаточно создать заказ и отправить его в курьерскую службу.

Если заказ отправлен без ошибок и отображается в ЛК, значит, интеграция настроена. Если отправка не удалась, ошибка может быть в настройках интеграции или в заполнении формы отправки заказа.

Текст ошибки можно увидеть через отладку в личном кабинете. Чтобы найти свой заказ в запросах, нажмите клавиши CTRL + F и введите в строку поиска номер заказа или ориентируйтесь на время создания заказа.

Убедитесь, что выполнены все шаги инструкции по настройки интеграции из этого раздела.

Ниже представлено описание проверки работоспособности для разных интеграторов.

RetailCRM

  1. Убедитесь, что выполнены все шаги инструкции по настройке интеграции.
  2. Если используются триггеры, убедитесь, что они настроены согласно инструкции.
  3. Создайте заказ, заполните требуемые данные.
  4. Нажмите на кнопку Сохранить внизу страницы, флажок Не отправлять данные в службу доставки должен быть снят. Заказ должен отправиться в курьерскую службу.
  5. Если возникает ошибка, ее текст отображается наверху страницы.
Если это ошибка заполнения формы, исправьте внесенные данные и попробуйте отправить заказ снова. Пример ошибки: «Ошибка сервиса доставки "Курьерская служба 2008": field [receiver phone] has no valid phone number»
Если это ошибка ответа курьерской службы, сообщите об этом разработчику. Пример ошибки: «Служба доставки прислала ответ в неверном формате».

МойСклад

  1. При сбое интеграции проверьте, не изменен ли аккаунт, под которым создана интеграция:
    1. Логин учетных данных МойСклад, которые использовались при создании интеграции, вставьте в ссылку https://home.courierexe.ru/moysklad/step2?id=логин. Если при переходе по ссылке отображается этап настройки интеграции, значит аккаунт существует.
    2. Войдите в «МойСклад» под учетной записью, которая использовалась для настройки интеграции, и откройте справочник Сотрудники: меню пользователя > Настройки > Справочники> Сотрудники. Откройте карточку сотрудника, под учетной записью которого вы вошли, и убедитесь, что его роль — администратор.
    3. Если хотя бы один из пунктов не выполнен, значит, аккаунт, использованный для создания интеграции, изменен.
  2. В личном кабинете клиента курьерской службы в настройках обратной интеграции Мой склад в поле В каком статусе "Мой склад" отправлять заказ на доставку уточните статус, при котором заказ отправляется в курьерскую службу.
  3. Заполните форму заказа, нажмите на кнопку Сохранить, затем смените статус заказа на статус, установленный для отправки в курьерскую службу и снова нажмите на кнопку Сохранить. Если все верно, заказ будет отправлен в курьерскую службу.
  4. Обновите страницу в браузере и проверьте поле Строка для сохранения информации об ошибках:
    • если поле пустое и заказ пришел в личный кабинет, интеграция работает;
    • если поле пустое и заказ не пришел в личный кабинет, обратитесь к разработчику;
    • если в поле содержится текст ошибки, исправьте ее в форме заказа и попробуйте отправить его снова.

InSales

  1. В личном кабинете клиента курьерской службы в настройках обратной интеграции InSales проверьте данные в следующих полях:
    • Статус заказа для автоматической отправки в курьерскую службу;
    • Список доставок для отправления заказа в курьерскую службу (если отправляется автоматически);
    • Оплачен ли заказ? (если отправляется автоматически).
  2. Создайте заказ и в случае ошибки проверьте данные заказа на соответствие этим полям. Например, в заказе может быть установлен тип доставки, не отмеченный как используемый в настройках в личном кабинете.

При возникновении ошибок при отправке заказа появляется диалоговое окно с сообщением об ошибке. Исправьте ошибку в форме заказа и попробуйте отправить его снова.

amoCRM

Ошибка при создании заказа отображается в левом нижнем углу.

Интеграция с платежными сервисами

Доступна интеграция со следующими сервисами:

  • PimPay — финансирование для интернет-магазинов;
  • Robokassa — онлайн-оплата заказов;
  • ibox — мобильный эквайринг.

Сервисы настраиваются в личном кабинете курьерской службы.

Robokassa

Чтобы настроить прием платежей через сервис Robokassa:

  1. Зарегистрируйтесь в сервисе Robokassa.
  2. В настройках личного кабинета курьерской службы введите идентификатор магазина и пароли из личного кабинета Robokassa.
  3. Установите флажок Тестовый режим и нажмите на кнопку Сохранить.
  4. Откройте страницу отслеживания любого заказа с наложенным платежом и оплатой картой и убедитесь, что кнопка Оплатить картой появилась.
  5. В настройках личного кабинета курьерской службы снимите флажок Тестовый режим и нажмите на кнопку Сохранить.

В результате получатель может оплатить заказ онлайн на странице отслеживания https://home.courierexe.ru/XX/tracking, где XX — код вашей курьерской службы:

Robokassa.png

При успешной оплате заказ в MeaSoft отмечается как оплаченный.

В окне отслеживания в поле Наложенный платеж статус заказа изменится на Заказ оплачен. Чек по операции придет на электронную почту, указанную при заказе.

PimPay

Чтобы начать работать с Pimpay:

  1. Зарегистрируйтесь http://platform.api.pimpay.ru/site/register в сервисе. Далее Pimpay активирует вашу учетную запись.
  2. Cгенерируйте ключи шифрования. Это делается на UNIX-подобной системе или с помощью нашей инструкции
    . Если у вас нет специалиста, чтобы сгенерировать ключи, обратитесь за помощью в PimPay.
  3. В личном кабинете курьерской службы в разделе Управление ЛК > Параметры > Финансы заполните настройки Pimpay данными из личного кабинета Pimpay. Сохраните настройки.
  4. Зарегистрируйте каждого клиента, который хочет передавать данные в PimPay, в личном кабинете PimPay.
  5. В MeaSoft в карточке каждого клиента на вкладке Финансы выберите платежного посредника PimPay.

При передаче данных привязка клиентов между системами производится по ИНН.

В результате MeaSoft передает все заказы вашего клиента, их статусы и созданные АПД в PimPay. PimPay ничего не передает в ответ.

Чтобы платежи в банк по АПД выгружались в адрес PimPay, создайте клиента с названием «PIMPAY» и заполните его реквизиты.

ibox

Мобильный эквайринг ibox доступен через приложение или SDK
. Подробнее см. раздел «ibox».

Для подтверждения успешной транзакции или отмены оплаты MeaSoft получает обратные вызовы (вебхуки) от ibox:

  • при успешной оплате после установки статуса корреспонденции со слов курьера Доставлено или Частично доставлено в MeaSoft на вкладке Выдача подсвечивается поле Тип оплаты:
    • зеленым цветом, если оплата картой, есть идентификатор транзакции и сумма транзакции верная;
    • желтым цветом, если оплата картой, есть идентификатор транзакции, но сумма транзакции не совпадает со значением поля Сумма руб в карточке корреспонденции;
    • красным цветом, если оплата картой и нет идентификатора транзакции.
    Если в карточке корреспонденции указан тип оплаты Наличными, то поле будет закрашено красным, если есть идентификатор безналичной транзакции или указана ее сумма. Если их нет, то поле будет зеленым;
  • при отмене оплаты обратный вызов удаляет идентификатор транзакции, чтобы сделать возможной повторную доставку и оплату заказа картой.

Чтобы настроить работу обратных вызовов:

  1. В личном кабинете курьерской службы в разделе Управление ЛК > Параметры > Финансы в разделе Настройки эквайринга Ibox заполните поля:
    • ID клиента в системе ibox — номер компании в разделе Профиль в личном кабинете ibox;
    • Логин для webhook ibox и Пароль для webhook ibox — придумайте логин и пароль для авторизации запросов ibox в MeaSoft. Логин и пароль могут состоять из цифр и латинских букв, длина не менее 5 символов.
  2. Нажмите на кнопку Сохранить.
  3. Обратитесь в техподдержку ibox с просьбой подключить вебхуки для MeaSoft и сообщите им придуманные вами логин и пароль.

Диадок

Начальная настройка

  1. Обратитесь в СКБ Контур для выпуска электронной цифровой подписи (ЭЦП) для использования с ЭДО Диадок. Получите Рутокен с ЭЦП. При его подключении автоматически устанавливается набор ПО для его использования.
  2. Вам становится доступен вход в систему по адресу https://diadoc.kontur.ru, без пароля, просто по ЭЦП, подключенной к компьютеру. Вы уже можете принимать документы от контрагентов.
  3. Обратитесь в СКБ Контур для выставления счета на пакет отправляемых документов. Пакет можно выбрать здесь: https://www.diadoc.ru/price. Кроме того, для использования с нашей, как и с любой другой системой, нужно включить возможность использования API: сотрудники Контура выставят за это счет - 18 т.р. на год, или 38 т.р. за 5 лет (актуально в 2019 году). После оплаты счета за API они присылают API-ключ вида "API-1b1111ae-1111-1111-b111-111111cc1fd1". API-ключ приобретается отдельно на каждое ваше юридическое лицо, поэтому его нужно вводить в Фирмы.
  4. В системе Диадок откройте Настройки и оплата > Сотрудники и выберите сотрудника, который будет отвечать за подписание документов. В карточке сотрудника перейдите на вкладку Данные по сертификатам и в группе полей Область полномочий установите полномочия для входящих и исходящих документов. Нажмите на кнопку Сохранить.
  5. Заполните данные подключения в системе:
    1. В переменной Провайдер ЭДО
      выберите Диадок.
    2. Введите API-ключ в Справочники > Фирмы > Карточка фирмы > Ключ ЭДО.
    3. Если в вашем токене несколько сертификатов, в поле Логин
      укажите без пробелов значение отпечатка сертификата, который нужно использовать. Чтобы просмотреть отпечаток, в меню Пуск выберите Программы > Крипто-ПРО > Сертификаты пользователя > Личное > Сертификаты. Справа выберите нужный сертификат, откройте. Перейдите на вкладку Состав, прокрутите список значений вниз, в самом низу выберите Отпечаток.
    4. В поле Пароль
      введите пин-код сертификата. Если вы его не меняли, можно пропустить: по умолчанию пин-код рутокена «12345678», и программа сама будет его использовать, если вы ничего не указали. Если он окажется неправильным, Крипто-ПРО спросит у вас верный пин-код при передаче данных. Обратите внимание, что количество попыток ввода пин-кода ограничено.
  6. После ввода данных подключения выйдите из системы и запустить программу от имени администратора: в контекстном меню ярлыка MeaSoft выберите пункт Запуск от имени администратора. Чтобы осуществить обмен данными, выберите Связь > Обмен с ЭДО. При первом использовании программа установит на компьютер специальный COM-объект Диадока. Именно для этого нужны права. В дальнейшем она будет использовать уже установленный компонент, и наличия прав не требуется.

Обмен данными с ЭДО

Выберите в главном меню "Связь" -> "Обмен с ЭДО". Откроется окно с выпадающим списком фирм, у которых заполнено поле "Ключ ЭДО". Выберите фирму, и нажмите "Обмен!". Программа выполнит все операции, которые периодически нужно выполнять, чтобы иметь актуальные данные как в нашей системе так и в ЭДО:

  • Синхронизирует справочники контрагентов: Получит список контрагентов, уже являющихся вашими партнерами в ЭДО, проставит им соответствующие признаки (На вкладке "Клиенты" появилось новое поле "Статус ЭДО". Это поле нельзя менять, оно устанавливается автоматически), проверит, кто прислал вам приглашения к партнерству и примет их, разошлет приглашения всем вашим работающим контрагентам, проверит, кто принял приглашение, а кто - отказался.
  • Проверит статусы ранее отправленных документов. При подписании документа вашим партнером, сообщение получит статус "Доставлено". Если оно отправлено из счетов или АПД, то соответсвующий документ получит признак получения подписанного акта.

Отправка документов

К отправке сейчас доступны счета, АПД и АПК. Отправка работает крайне похоже на e-mail. Документы формируются точно так же, но отправляются не почтой, а в ЭДО, уже подписанными вашей ЭЦП. В системе ЭДО "адресами" отправителя и получателя являются ИНН (по возможности еще КПП, но это не обязательно) компании, поэтому, чтобы все работало, ИНН должен быть заполнен. Так же ЭДО примет документы только в адрес компании, с которой у вас отмечены партнерские отношения, т.е. кто-то из вас отправил приглашение, а другой его принял. Поэтому, для удобства контроля - кому можно таким образом отправлять, а кому - нет, в списках документов добавлено поле "Есть ЭДО". Там галка ставится на основании статуса ЭДО клиента. Можете отсортировать по этому полю, выдели все, где есть галки, и разослать всем документы по ЭДО.

Телефония

Основная статья: Интеграция с телефонией

GPS-трекинг автотранспорта

Для поддержки GPS-трекинга автотранспорта у нас разработана интеграция с коробочной системой Wialon, на которой работают большинство компаний, предоставляющих подобные услуги. Обратитесь в службу технической поддержки для помощи в настройке.