Интеграция с другими системами

Материал из Меасофт
Перейти к: навигация, поиск

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

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

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

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

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

Итак, по пунктам:


1) Обе компании должны иметь аккаунты в системе MeaSoft («Справочники» – «Дополнительные модули»), и у обеих компаний должна быть установлена галка «Личный кабинет» в указанном выше окне.

2) Агент создает клиента в своей системе (на закладке «Клиенты»). На закладке «Прочее» карточки клиента указывает логин и пароль для входа в Личный кабинет.

3) Агент передает клиенту Логин, Пароль (из предыдущего шага), а так же свой идентификатор в системе MeaSoft (см. иллюстрацию).
рис.1 Код экстра-клиента

4) Клиент создает в своей системе филиал (Справочники – Межгород – Филиалы) для указанного агента. После ввода филиала нужно перевойти в программу и подождать 3 минуты.

5) Клиент, получив данные из п. 3, заходит в свой личный в системе MeaSoft (см. иллюстрацию). Переходит на закладку «Интеграция». В таблице должен появиться созданный филиал.
Measoft home.png

6) Клиент нажимает кнопку «Настроить» напротив филиала, в открывшемся окне выбирает интегратор «MeaSoft», далее – заполняет форму – «Логин», «Пароль», и «Код клиента» данными, полученными в п. 3, нажимает «Сохранить».


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

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

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

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

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

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

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

1) Клиент должен иметь аккаунт в системе MeaSoft («Справочники» – «Дополнительные модули»), и должна быть установлена галка «Личный кабинет» в указанном окне.

2) Создайте в своей системе филиал (Справочники – Межгород – Филиалы) для указанного Агента. После ввода филиала нужно перевойти в программу и подождать 3 минуты.

3) Зайдите в свой личный в системе MeaSoft (см. иллюстрацию). Перейдите на закладку «Интеграция». В таблице должен появиться созданный филиал.
Measoft home.png

4) Нажмите кнопку «Настроить» напротив филиала, в открывшемся окне выбирает интегратор той компании, с которой хотите интегрировать, далее – заполните форму по отображенной инструкции (для каждого интегратора форма и инструкции свои, нажмите «Сохранить».


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

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


СДЭК

  • СДЭК не позволяет передать количество занимаемых мест.
  • Отправка в СДЭК осуществляется первым доступным тарифом из списка:
  1. Экономичная посылка
  2. Посылка
  3. Экспресс лайт
  4. Магистральный экспресс

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

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

Топ деливери

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


Почта России

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


PickPoint

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

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

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

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

КСЭ

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

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

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

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

  • 1-й Параметр - код филиала партнера. Смотреть в Справочники - Межгород - Филиалы
  • 2-й Параметр - код экстра партнера в системе MeaSoft. В том числе для сторонних компаний есть коды, см. таблицу ниже.
  • 3-й Параметр - имя пользователя в системе партнера. Может отличаться от того, под которым работает интеграция, здесь нужно для расчета цены для клиента. В таблице ниже указано, что вводить для каждого интегратора.
  • 4-й Параметр - пароль к пользователю из 3-го параметра. В таблице ниже указано, что вводить для каждого интегратора.
  • 5-й Параметр - вид срочности партнера. Посмотреть доступные коды видов срочности можно по ссылке в таблице ниже, в калькуляторе в выпадающем списке. Можно в одинарных кавычках указать несколько видов срочности через запятую, тогда система будет стараться выбрать из них первый доступный.
  • 6-й Параметр - наценка к цене, передаваемой подрядчиком. В деньгах или в процентах, если стоит знак процента. Например 10 - наценка 10 рублей, 10% - наценка 10 процентов
Интеграция Код экстра Посмотреть виды срочности Авторизация Пример строки
БОКСБЕРРИ 90001 https://home.courierexe.ru/90001/calculator Введите токен в 4-й параметр. 3-й можно оставить пустым. Можно оба оставить пустыми для расчета базовых цен. 33, 90001,, j3ejwo2f10b2e47790174b41f4a11111, 2, 50
ПИКПОИНТ 90002 https://home.courierexe.ru/90002/calculator
CDEK 90005 https://home.courierexe.ru/90005/calculator Введите код учетной записи в 3-й параметр, и секретный код - в 4-й. Можно оба оставить пустыми для расчета базовых цен. 45491, 90005, hfenJwlasiPr4pnFENpaVXSKPIn5Trh7i, 9vkQgWuiZgEj9fGCB8a6Xj3desnJkwsl, 5, 30%
КСЭ 90008 https://home.courierexe.ru/90008/calculator
ПОЧТА РОССИИ 90010 https://home.courierexe.ru/90010/calculator Пока не поддерживается
ДПД 90011 https://home.courierexe.ru/90011/calculator
ДОСТАВКА ГУРУ 90017 https://home.courierexe.ru/90017/calculator
5Пост 90020 https://home.courierexe.ru/90020/calculator

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

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

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

Замечания

Форма отправки заказа
  1. В модулях систем PrestaShop, OpenCart, OCStore, Webasyst, InSales и Joomla для отправки заказа в курьерскую службу необходимо зайти в карточку заказа, в которой должна отображаться форма (см. изображение). Форма позволяет отправить заказ, а если заказ отправлен - проверить его статус.
  2. Оформление заказов до ПВЗ в модулях не реализовано. Однако, для того, чтобы оформить такой заказ, необходимо в поле передаваемого адреса указать:
    • либо код ПВЗ, который можно посмотреть в нашем ЛК или на сайте агента (Boxberry, CDEK и т.д.). Обычно это цифровой (цифро-буквенный) код
    • либо указать наименование ПВЗ добавив в начале строку "ПВЗ ", например, ПВЗ На Ленина


OpenCart 1.5.5.1

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

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

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

OpenCart 2.0 и выше

Для настройки синхронизации:

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

Bitrix

рис.1 Настройки интеграции
рис.2 Форма оформления заказа

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

  1. Установить модуль из Маркетплейс.
  2. В административной части сайта зайти в раздел Marketplace → Установленные решения и установить модуль Курьерская служба, нажав на пункт "Установить".
  3. В административной части сайта зайти в раздел Магазин → Настройки → Службы доставки и добавить службу доставки, выбрав пункт "Автоматизированная служба доставки".
  4. На вкладке "Настройки обработчика" в выпадающем списке выбрать "Курьерская служба" - сервис доставки.
  5. На вкладке "Настройки интеграции" (Рис. 1) необходимо:
    • ввести учетные данные курьерской службы
    • выбрать статус, при котором заказ будет отправляться в курьерскую службу
    • выбрать тип оплаты, который будет соответствовать оплате картой (если оплата картой возможна)
    • указать, будут ли использоваться артикулы для привязки номенклатуры к складу курьерской службы
    • настроить соответствие полей получателя (ФИО, города, адреса и др.) полям в форме оформления заказа.
  6. На вкладке "Ценовая политика доставки" можно гибко настроить стоимость доставки для покупателя в зависимости от стоимости заказа.
  7. На вкладке "Ограничения" можно указать ограничения работы модуля по географии, типам оплаты и т.д.
  8. В настройках магазина необходимо указать его местоположение для определения города отправителя. В случае если необходимо производить расчет от другого города отправителя (Например физически магазин находится в области, а курьерская служба должна считать как по городу) нужно:
    • В разделе Рабочий стол - Настройки - Настройки продукта - Настройки модулей - Курьерская служба добавить город отправителя.
    • В разделе Рабочий стол - Магазин - Настройки - Службы доставки - Нужная служба - Настройки интеграции - Город отправтель указать добавленный ранее город.
  1. Для отправки заказа необходимо зайти в карточку заказа и указать ранее настроенный Статус отправки заказа, после чего сохранить его.
  2. Если статус был установлен ранее, но заказ при этом не был отправлен в КС, необходимо (связано с техническими особенностями):
    • выбрать статус, устанавливаемый системой по умолчанию после создания заказа (например, Новый)
    • перезагрузить страницу
    • выбрать статус отправки и сохранить его
  3. При отправке заказа появится сообщение об успешной отправке или об ошибке.
  4. Статус заказа можно проверить в карточке заказа, в правом верхнем углу.


Обратите внимание, что проверить работу модуля можно в форме оформления доставки. При этом, должна корректно считаться стоимость доставки. Если стоимость не рассчитывается, причин может быть несколько:

  • некорректно установлен модуль
  • введены некорректные учетные данные
  • в курьерской службе не настроен тариф

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

Insales

рис.1 Начало установки
рис.2 Подтверждение установки
рис.3 Список приложений
рис.4 Настройка подключения


  1. Установить приложение можно по ссылке - зеленая кнопка "Установить" (Рис. 1).
  2. В Личном кабинете появится уведомление для установки приложения «Модуль "Курьерская служба 2008"» (кнопка "Установить"). После этого подтвердить установку (Рис. 2).
  3. Настройка приложения. Необходимо зайти в приложения и нажать на название «Курьерская служба 2008» (Рис. 3). Произойдет переход на страницу Личного Кабинета (home.courierexe.ru) с возможностью ввода параметров.
  4. Параметры Код курьерской службы, Логин и Пароль необходимо запросить у курьерской службы, с которой настраивается интеграция, ввести их в поля и сохранить (Рис. 4).
  5. Далее необходимо ввести статус, при присваивании которого в Insales, будет происходить автоматическая передача данных в программу и префикс к заказам.
  6. После установки приложения «Модуль "Курьерская служба 2008"» - он появится в ЛК (home.courierexe.ru) в списке установленных в разделе "Приложения".


Замечания

  • Тип оплаты заказа определяется следующим образом:
    • Если заказ оплачен, то передается тип оплаты Без оплаты
    • Если тип оплаты Оплата банковской картой или Оплата банковской картой курьеру, то передается тип оплаты Банковская карта. Указанные типы оплаты необходимо создать в InSales вручную.
    • Иначе передается тип оплаты Наличными
    • На стороне курьерской службы в карточке интернет-магазина есть галка "Спрашивать тип оплаты у получателя". Если она установлена, то независимо от переданного типа оплаты Наличными или Банковская карта, покупателю будет предложен выбор способа оплаты.


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

RetailCRM

рис.1 Настройка типа доставки
рис.2 Выбор типа доставки в заказе
рис.3 Выбор тарифа
рис.4 Добавление способа оплаты
рис.5 Настройка способов оплаты


  1. Необходимо создать API-ключ (Настройки, пункт Интеграции, раздел Ключи доступа к API) для доступа модуля к интеграции
  2. В настройках API-ключа необходимо разрешить все методы (проставить все галочки). Для этого нужно перейти Настройки → Интеграция → Маркетплейс и верхней части окна выбрать раздел настроек Ключи доступа к API.
    API-ключей может быть несколько и в настройках каждого API-ключа необходимо:
    1) выбрать "Доступ ко всем магазинам" в разделе "Тип доступа".
    2) проставить ВСЕ галки в разделе "Разрешенные методы API", дав тем самым доступ на все методы.
  3. В разделе Маркетплейс (Настройки, пункт Интеграции) необходимо выбрать модуль "Курьерская служба 2008"
  4. При нажатии на модуль открывается описание модуля интеграции
  5. При нажатии на кнопку Подключить открываются настройки интеграции в ЛК "Курьерская служба 2008"
  6. Параметры Код курьерской службы, Логин и Пароль необходимо запросить у курьерской службы, с которой настраивается интеграция
  7. В поле Аккаунт RetailCRM необходимо указать адрес системы, а в поле API-ключ - ранее созданный API-ключ для модуля
  8. В системе RetailCRM добавить новый тип доставки в системе через Настройки → Справочники → Типы заказов и в верхней части окна выбрать раздел настроек Типы доставок. Кнопкой Добавить произвести добавление нового типа доставки. Обязательно выбрать интегратора в выпадающем списке "Интегрировать с Курьерская служба 2008" (рис. 1).
  9. При создании заказа появится соответствующий Способ доставки (рис. 2).
  10. Далее, необходимо выбрать Тариф. Он должен подтягиваться из КС. Если при этом происходит Ошибка определения тарифа, значит тарифы в КС не настроены (рис. 3). В случае ошибки необходимо обратиться в курьерскую службу для настройки тарифов. Проверить тарифы можно в ЛК в разделе Калькулятор.
  11. Для корректной передачи наложенного платежа необходимо добавить Способ оплаты (рис. 4), который имеет признак Наложенного платежа в настройках интеграции (рис. 5).
  12. Для получения печатных форм, аналогичных формам в ЛК Курьерская служба, необходимо:
    • в заказе нажать Печать (вверху) и выбрать нужную печатную форму "Курьерская служба"
    • в списке заказов выбрать заказы, нажать Действия (внизу), Распечатать документы и выбрать нужную печатную форму "Курьерская служба"
  13. Если Вы хотите отправлять заказы в курьерскую службу по статусам и отменять при изменении типа доставки можете воспользоваться тригерами. Как их настраивать описано в отдельной статье Настройка триггеров для RetailCRM

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

Беру

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

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

Подключение к двум и более курьерским службам или клиентам

1. В ЛК новой курьерской службы зайти по ссылке /retail, чтобы в адресной строке было указано так:

https://home.courierexe.ru/XXX/retail

Обратите внимание, что вместо "XXX" у вас должен быть указан экстра код новой курьерской службы.

2. Далее, последовательность подключения аналогична общей последовательности, начиная с пункта 6.


Основные принципы работы

  • Использование артикулов для привязки к складу системы КС2008 включается в настройках интеграции в ЛК.
  • Заказ передается в систему КС2008 при его сохранении, если не включена галка "Не отправлять данные в службу доставки".
  • Тип оплаты указывается в разделе заказа Оплата. Для передачи типа оплаты необходимо добавить один из способов оплаты (Наличные или Банковская карта).
  • В случае, если заказ был оплачен, тип оплаты можно не указывать.
  • Количество мест определяется упаковками, которые можно добавить в разделе заказа Доставка.
  • Стоимость доставки возвращается в поле Себестоимость.
  • Для изменения статусов товаров необходимо настройках интеграции в ЛК включить настройку Получать возвраты вложений. В этом случае проданный товар получает статус Продан, для него указывается количество проданного товара. Также создается фиктивный товар с таким же наименованием со статусом Возврат, в комментарии которого указывается количество возвращенного.
  • Код подрядчика (если заказ передается по интеграции) возвращается в поле Комментарий менеджера.
  • Курьера и его телефон можно получать в пользовательское поле RetailCRM, указанное в настройке Пользовательское поле для получения курьера.
  • Возврат в RetailCRM типа оплаты включается настройкой Получать тип оплаты. При этом указывается либо стандартный тип оплаты Наличными, либо стандартный тип Банковская карта.


Примечания

  • Файлы к заказам в системе RetailCRM прикрепить можно. Ограничение 1 МБ на 1 файл.


ВНИМАНИЕ!
После добавления нового типа доставки, удаление типа доставки в системе RetailCRM будет уже не доступно, новый тип можно только отключить галкой "Активность" внутри настроек выбранного типа доставки.

Мой Склад

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

Как настроить

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

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

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

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

Как проверить

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

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

!ВАЖНО! Модуль интеграции не работает на бесплатном тарифе!

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


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 минут.

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

PimPay

Чтобы начать работать с Pimpay необходимо сначала зарегистрироваться в их системе по адресу http://platform.api.pimpay.ru/site/register. Далее pimpay активирует Вашу учетную запись.
рис.1 Конфигурация PimPay

Чтобы продолжить, вам нужно сгенерировать ключи шифрования. Это делается на UNIX-подобной системе: http://platform.api.pimpay.ru/v2_7/signature/openssl или наша инструкция

рис.2 Выбор платежного посредника

Если у вас нет специалиста, чтобы сгенерировать ключи, обратитесь в PimPay, они с радостью сделают это за вас!

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

Для каждого клиента, который хочет передавать данные в PimPay необходимо зарегистрировать в личном кабинете PimPay, и в нашей системе выбрать платежного посредника на вкладке "Финансы" карточки клиента. В процессе передачи данных привязка клиентов между системами производится по ИНН. Наша система начинает передавать все заказы вашего клиента в PimPay, их статусы, и созданные АПД. Обратно она ничего не получает.

Для того, чтобы платежи в банк по АПД выгружались в адрес PimPay, нужно создать клиента с точно таким названием ("PIMPAY"), и заполнить его реквизиты.

Диадок

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

Рассказываем как начать пользоваться с самого начала:

  1. Свяжитесь с СКБ Контур, попросите выпустить электронную цифровую подпись (ЭЦП) для использования с ЭДО Диадок. Нам выставили счет на 5250 рублей. Потом нужно прийти в предложенный офис удостоверяющего центра с уставными документами, вам дадут флешку (называется "Рутокен") с ЭЦП. При ее подключении автоматически устанавливается набор ПО для ее использования.
  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. Заполняем данные подключения в системе:
    1. В переменной Провайдер ЭДО
      выбираем "Диадок".
    2. API-ключ нужно внести в "Справочники" -> "Фирмы" -> Карточка фирмы -> "Ключ ЭДО".
    3. Если в вашем токене несколько сертификатов, в поле Логин
      можно указать отпечаток сертификата, который нужно использовать. Если пусто - программа постарается выбрать сертификат сама по доступности компании, к которой производится подключение. Посмотреть отпечаток: Пуск - Программы - Крипто-ПРО - "Сертификаты пользователя" - "Личное" - "Сертификаты". Справа выберите нужный сертификат, откройте. Перейдите на вкладку "Состав", прокрутите список значений вниз, в самом низу выберите "Отпечаток".
    4. В поле Пароль
      введите пин-код сертификата. Если вы его не меняли, можно пропустить: по-умолчанию для рутокена пин - "12345678", и программа сама будет его использовать, если вы ничего не указали. Если он окажется не правильным - Крипто-ПРО спросит у вас верный пин при передаче данных. Обратите внимание, что количество попыток ввода пин-кода ограничено.
  5. После ввода данных подключения нужно выйти, и запустить программу от имени администратора (права windows, правой кнопкой на ярлык - запустить от администратора), и осуществить обмен данными: "Связь" -> "Обмен с ЭДО". При первом использовании программа установит на компьютер специальный COM-объект Диадока. Именно для этого нужны права. В дальнейшем она будет использовать уже установленный компонент, и наличия прав не требуется.

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

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

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

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

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

Телефония

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

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

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