Изменения

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

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

19 907 байт убрано, 9 февраль
Настройка
MeaSoft имеет практически неограниченные возможности по интеграции с другими системами. В этой статье мы рассмотрим виды и способы интеграции.
=Виды интеграций= * Заказы:** передача между [[#Интеграция между двумя клиентами системами MeaSoft ==|двумя системами]] MeaSoft — клиент отправляет заказы другому агенту, агент доставляет отправления и передает их статусы, которые загружаются в систему клиента.;** передача заказов в стороннюю систему [[#Интеграция с подрядчиками|подрядчика]] через API и получение статусов доставки;** получение заказов из [[#Интеграция с CMS-системами|CRM- и CMS-систем]] интернет-магазинов и отправка статусов доставки;** [[#Сквозная интеграция|сквозная интеграция]]: получение цен подрядчиков при оформлении заказа;* [[Интеграция с платежными сервисами|платежные сервисы]]:** PimPay — финансирование для интернет-магазинов;** Robokassa — онлайн-оплата заказов и мобильный эквайринг;** Assist — мобильный эквайринг;** ibox — мобильный эквайринг;** Payme — онлайн-оплата заказов и мобильный эквайринг. Работает в Узбекистане;* электронный документооборот — [[Диадок]];* телефония — телефонный сервер [[Интеграция с телефонией|Asterisk]];* планирование маршрутов курьеров — [[Яндекс.Маршрутизация]], [[Максоптра]];* GPS-трекинг автотранспорта — [[Wialon]].
Один из клиентов (= Интеграция между двумя системами MeaSoft =Клиент) отправляет заказы другому клиенту (Агенту)агенту, Агент агент доставляет отправления и передает их статусы, которые загружаются в систему Клиентаклиента.
Интеграция может быть и двунаправленная, когда двухсторонняя: одна компания заказывает доставку у второй, а вторая — вторая — у первой. В этом случае нужно настроить 2 интеграции: в одной нужно рассматривать одну компанию клиентом, вторую — агентом, во второй интеграции — наоборот.
В этом случае нужно настроить 2 интеграции: в одной нужно рассматривать одну компанию клиентом, вторую — агентом, во второй интеграции – наоборот. Порядок действий:==Настройка==
# Обе компании должны иметь аккаунты в системе MeaSoft ('''Справочники''' > '''Дополнительные модули''') и у обеих компаний должен быть установлен флажок '''Личный кабинет''' в окне «Управление дополнительными модулями».
# Агент на вкладке '''АгентКлиенты''' создает карточку клиента в своей системе на вкладке '''Клиенты'''. На вкладке '''Прочее''' [[Клиенты и партнеры#Прочее|карточки клиента ]] указывает логин и пароль для входа в Личный [[личный кабинет]] клиента.# '''Агент''' передает клиенту логин, и пароль (из предыдущего шага) и свой идентификатор в системе MeaSoft:[[Файл:Measoft id.pngЛичный кабинет курьерской службы#Подключение|600px|noneкод экстра]][[Файл:Measoft homeв системе MeaSoft.png|none|600px]]# '''Клиент''' создает в своей системе [[Филиалы|филиал ('''Справочники''' > '''Межгород''' > '''Филиалы''') ]] для указанного агента. После ввода создания филиала нужно перевойти в программу и подождать 3 минутыдля синхронизации данных.# '''Клиент''', получив данные из п. 2, заходит в свой Личный [[личный кабинет в системе MeaSoft, переходит курьерской службы]] и на вкладку вкладке '''ИнтеграцияПодрядчики'''. В в таблице должен появиться находит созданный филиал.# '''Клиент''' в строке подрядчика нажимает на кнопку '''Настроить''' напротив филиала[[Файл:MeaShip_Интеграция.png]], в открывшемся окне выбирает интегратор интеграцию «MeaSoft», заполняет поля :<div style="padding-left: 45px; position: relative;">*'''Логин''', '''Пароль''' и '''Код клиента''' учетными данными, полученными в п. 3, и нажимает '''Сохранить'''*<b>Тип оплаты</b> - позволяет управлять логикой обработки типа оплаты в данных передаваемого по интеграции заказа.Доступные варианты:**Адаптируется в соответствии с данными заказа<br><span style="padding-left: 10px;">При отсутствии наложенного платежа передается <b>No</b>, иначе при типе оплаты картой <b>CARD</b>, во всех остальных случая <b>CASH</b></span>**Оригинальный<br><span style="padding-left: 10px;">В этом случае, тип оплаты заказа передается без изменений</span><br>
В результате такой настройки все отправления, у которых Клиент установит «Ответственный филиал», соответствующий Агенту (правильнее всего это через [[Отправка корреспонденции#Создание манифеста|манифест]], скомплектовав его и проставив дату отправки), будут переданы в БД Агента, и статусы будут передаваться обратно. На передачу данных может уходить до 10 минут в штатном режиме и до 1 часа в случае возможных сбоев.
<div style="colori>Группа параметров, отвечающая за разделение заказов по потокам с разной авторизацией: #a94442; background-color: #f2dede; border: 1px solid #ebccd1; padding: 3px 10px 10px;"</i>* '''Логин для заказов без чека'''и 'Обратите внимание!''Пароль для заказов без чека'''При передаче заказов, * '''Определять заказы без чека по признаку''' - "Печатать чек - в карточке клиента" или "Спрашивать тип оплаты у которых плановая дата доставки меньше ближайшей возможнойполучателя - в карточке клиента"В интеграции Measoft существует возможность отправлять заказы, дата доставки автоматически меняется на самую раннюю возможнуюраспределяя их 2-м разными клиентами по принципу необходимости чека.</div>
Для стабильной работы необходимо наличие версии минимум 518 от 05.12.2014 у обеих компаний.этого в интеграции Measoft нужно заполнить параметры "Логин для заказов без чека" и "Пароль для заказов без чека"<br>Заказы, которые созданы клиентом '''с настройкой необходимости чека''' будут отправляться с авторизацией указанной в параметрах: <i style="color: #740474;">"Логин"</i> и <i style="color: #740474;">"Пароль"</i><br>Заказы, которым '''чек не требуется''' будут отправляться с авторизацией <i style="color: #740474;">"Логин для заказов без чека"</i> и <i style="color: #740474;">"Пароль для заказов без чека"</i><br>
== Интеграция с подрядчиками (передача заказов) ==
=== Отказ от ответственности ===
Хотим обратить ваше внимание на то, что интеграции со сторонними системами делаются в соответствии с документацией на момент написания, без партнерства с компаниями-поставщиками сервиса. Об изменениях API нас не оповещают, поэтому интеграции по независящим от нас причинам могут переставать работать, работать нестабильно или некорректно, вплоть до потери важной (финансовой?) информации. Заказы, переданные во внешние системы, нужно обязательно проверять на корректность, пользуясь личным кабинетом партнера.
=== Общие правила Далее, клиент указывает остальные настройки интеграции ===при необходимости и нажимает '''Сохранить'''.</div>Здесь рассматривается интеграция с системами сторонних компаний (агент)В результате отправления, у которых клиент укажет филиал агента в качестве ответственного филиала, где система будут переданы в систему MeaSoft (клиент) выступает клиентомагента, ти статусы будут передаваться обратно.еПравильный способ отправки заказов — через [[Манифесты|манифест]], который нужно скомплектовать и проставить дату отправки. передает заказы На передачу данных может уходить до 10 минут в штатном режиме и получает обратно статусыдо 1 часа в случае возможных сбоев.
Клиент должен иметь аккаунт и личный кабинет в системе MeaSoft. Подробнее см. раздел «[[Личный кабинет курьерской службы]]»<div style="color: #a94442; background-color: #f2dede; border: 1px solid #ebccd1; padding: 3px 10px 10px;">При передаче заказов, у которых плановая дата доставки меньше ближайшей возможной, дата доставки автоматически меняется на самую раннюю возможную.</div>
# Создайте в своей системе филиал ('''Справочники''' > '''Межгород''' > '''Филиалы''') для указанного агента. После ввода филиала нужно перезагрузить программу и подождать 3 минуты.# Зайдите в личный кабинет курьерской службы в системе Для стабильной работы необходимо наличие версии MeaSoftминимум 518 от 05. Чтобы узнать свои учетные данные, выберите '''Справочники''' > '''Дополнительные модули''': [[Файл:Measoft home.png|none|600px]]# В личном кабинете перейдите на закладку '''Интеграции'''12. В таблице должен появиться созданный филиал2014 у обеих компаний.# Нажмите на кнопку '''Настроить''' напротив филиала, в открывшемся окне выберите интегратор той компании, Для одного клиента может быть настроена только одна интеграция с которой хотите интегрировать. Далее заполните форму по отображенной инструкции (для каждого интегратора форма и инструкции свои), нажмите '''Сохранить'''агентом.
Если устанавливается интеграция между [[API#Готовые интеграции|CMS- или CRM-системой]] и подрядчиком [[Интеграция с другими системами#Тарификация и выбор подрядчика и его тарифа клиентом|из таблицы]], при авторизации в [[Личный кабинет клиента|личном кабинете клиента]] укажите код клиентской службы подрядчика (столбец «Код экстра»). В результате настройки все отправления, у которых клиент установит '''Ответственный филиал''', соответствующий агенту, будут переданы в БД агента и статусы будут передаваться обратно. Правильнее оформлять отправление как [[Отправка корреспонденции|манифест]], комплектовать его и проставить дату отправки. На передачу данных может уходить до 10 минут в штатном режиме и до 1 часа в случае возможных сбоев. Для стабильной работы необходимо наличие у клиента системы MeaSoft версии минимум 518 от 05.12.2014. ==Распределение заказов по признаку необходимости чека= СДЭК === Отправка в СДЭК осуществляется первым доступным тарифом из списка:* «Экономичная посылка»,* «Посылочка»,* «Экспресс-лайт»,* «Магистральный экспресс».
В настройках интеграции MeaSoft Вы может поменять местами тарифы «Экономичная посылка» распределять заказы по двум разным клиентам по принципу необходимости чека. Для этого агент создает в своей системе второго клиента для вашей компании, в карточке клиента на вкладке '''Прочее''' указывает логин и «Посылочка».При весе отправления больше 30 кг применяется тариф «Магистральный экспресс»пароль, которые передает вам.
Чтобы передать услугу «Примерка»В настройке интеграции Measoft (пункт 6 инструкции выше) заполните поля '''Логин для заказов без чека''' и '''Пароль для заказов без чека''' и выберите признак, по которому определяется необходимость чека, установите флажок в поле '''Принято на складОпределять заказы без чека по признаку''' в [[Единица корреспонденции#Создание единицы корреспонденции|карточке корреспонденции]]. Если услуга не нужна, снимите флажок.
При передаче валюты наложенного платежа код валюты берется из поля Заказы, созданные клиентом, которому нужен чек, будут отправляться с авторизацией, указанной в полях '''ВалютаЛогин''' карточки клиента, от которого передается заказ. Валюта должна совпадать с валютой страны назначения заказа. Если заказ отправляется в другую страну, создайте копию клиента с нужной валютой и оформляйте заказы от него, указывая цены в валюте страны назначения'''Пароль'''.
В общем случае интеграция Заказы, которым чек не поддерживает отправки в другие странытребуется, кроме Россиибудут отправляться с авторизацией '''Логин для заказов без чека''' и '''Пароль для заказов без чека'''.
= Интеграция со сторонними системами =Сторонними системами могут быть:* [[http://courierexe.ru/download/userfunc/SDEK_report_load.xml Загрузка отчета СДЭК#Интеграция с подрядчиками|системы подрядчиков]] Создает входящий АПД по отчету СДЭК , принимающие заказы на доставку;* [[http://courierexe.ru/download/userfunc/SDEK_report_demo.xls такого формата]. Работает начиная #Интеграция с версии 626 от 29.01.2016 CMS-системами|CRM- и только при передаче заказов CMS-системы]] интернет-магазинов, передающие заказы в СДЭК с помощью штатной интеграции. Заполняет поле '''Агентская цена''' в карточке корреспонденции на вкладке '''Межгород'''курьерскую службу.
=== TopDelivery ===[[Файлы для загрузки#Интеграции со сторонними системами делаются в соответствии с документацией на момент написания, без партнерства с компаниями-поставщиками сервиса.D0Об изменениях API нас не оповещают, поэтому интеграции по не зависящим от нас причинам могут переставать работать, работать нестабильно или некорректно, вплоть до потери важной информации.9FЗаказы, переданные во внешние системы, нужно обязательно проверять на корректность, пользуясь личным кабинетом партнера.D0По интеграции уходят только новые заказы, созданные в день настройки интеграции.B5.D1.87.D0.B0.D1.82.D0.BD.D1.8B.D0.B5_.D1.84.D0.BE.D1.80.D0.BC.D1.8B_.D0.B4.D0.BB.D1.8F_.D0.BC.D0.B0.D0.BD.D0.B8.D1.84.D0.B5.D1.81.D1.82.D0.BE.D0.B2|Печать наклеек для TopDelivery]]
=== Почта России Интеграция с CMS-системами ===Интеграция с Почтой России описана в разделе [[%D0%A0%D0%B0%D0%B1%D0%BE%D1%82%D0%B0_%D1%81_%D0%9F%D0%BE%D1%87%D1%82%D0%BE%D0%B9_%D0%A0%D0%BE%D1%81%D1%81%D0%B8%D0%B8|Работа с Почтой России]].
=== PickPoint ==='''Модули распространяются бесплатно, без гарантий со стороны разработчика''', и не являются средством полной автоматизации взаимодействия с курьерской службой. Модули — это помощь разработчикам интернет-магазинов в построении интеграции с курьерскими службами. '''Ответственность за корректность передачи данных лежит на интернет-магазине.'''
Если '''PickPoint''' выделил вам диапазон трекинг-номеров, то необходимо настроить филиал и придерживаться последовательности отправки манифестовСообщайте нам свои пожелания по работе наших модулей.Для настройки филиала для интеграции '''PickPoint''' с диапазоном Мы учтем их в основном меню выберите '''Справочники -> Межгород -> Филиалы''' нажатием правой кнопки мыши на предварительно созданном филиале, в контекстном меню выберите '''Открыть''' в открывшейся форме перейдите на вкладку '''Интеграция''' и в выпадающем списке '''Правила назначения кода заказа у подрядчика''' выберите '''Из диапазона'''. Укажите начальный и конечные коды диапазона, префикс при необходимости и нажмите клавишу '''ОК'''новых версиях.
Для отправки манифестов добавьте заказы в манифест, затем, на вкладке '''Манифесты''' необходимо добавить требуемые заказы в мешок, а далее выбрать в манифесте ранее настроенный филиал. После чего, в контекстном меню манифеста выбрать пункт '''Проставить коды у подрядчика'''.После этого можно указать дату отправки манифеста. Обратите внимание, что проставить коды с указанной датой отправки манифеста нельзя. Необходимо сначала очистить дату отправки, а затем проставить коды. Агентская цена данной интеграцией не возвращается, т.к. эти данные отсутствуют в API PickPoint. {| class="wikitable" align="center" style= КСЭ "width: 80%; margin: auto; background-color:#ffffff; border: 1px solid #999999;" cellpadding="10" cellspacing="0"!styleНастройки интеграции"width:* '''Данные отправителя''' - данные, которые будут подставляться во все отправления, передаваемые в КСЭ. Если не указать, то будут передаваться данные заказчика 35%;"|Система управления контентом (отправителяCMS) из корреспонденции.* '''Является ИМ''' - признак отправителя в системе КСЭ. От данного признака зависит главным образом, как отправляются данные в КСЭ. Признак указывается в договоре клиента с КСЭ.* '''Забор''' - настройка, в которой можно указать, каким образом отправление передается в КСЭ - КСЭ забирает отправление у клиента или клиент сам привозит отправление в КСЭ.!style="width: 15%;"|Ссылка!style=== DOSTAVKA.GURU ==="width: 35%;"|Примечание|-При настройке интеграции в CRM- или CMS-системе введите следующие учетные данные|[[Файл:* логин — ID клиента DOSTAVKAbitrix.GURU. ID клиента отображается вверху страницы личного кабинета клиента DOSTAVKA.GURU;png|center|x44px]]* пароль — запросите API|style="text-ключ интеграции у DOSTAVKA.GURUalign: center;* код курьерской службы — 90017" | [https://marketplace== Тарификация и выбор подрядчика и его тарифа клиентом ==Вы можете настроить подключение своего тарифа к тарифу партнера — любой компании, работающей в системе MeaSoft, а также ряду компаний, с которыми у нас есть интеграции, см1c-bitrix. список нижеru/solutions/measoftЧтобы настроить подключение к тарифу партнераcourier/ Установить] <!--[https:# Зарегистрируйтесь в системе подрядчика//courierexe. Данные аккаунта понадобятся для настройки интеграцииru/download/api/measoft.# Откройте '''Справочники''' > '''Статусы''' > '''17 Виды срочности''' и создайте вид срочности, например «СДЭК»courier.# В контекстном меню вида срочности выберите пункт '''Дополнительная информация''' и во второй строке заполните параметры подключения к партнеру через запятую:#* 1zip Скачать] --й параметр — код филиала партнера, его можно посмотреть в '''Справочники''' > '''Межгород''' > '''Филиалы'''. Можно в одинарных кавычках указать несколько ответственных филиалов через запятую, тогда режим срочности будет доступен для всех перечисленных филиалов, или знак вопроса '''?''' что будет означать, - доступно для любого ответственного филиала;#* 2-й параметр — экстра-код партнера в системе MeaSoft|Поддерживает версии 14. В том числе для сторонних компаний есть коды, см5 и выше. таблицу ниже;#* 3[[1C-й параметр — имя пользователя в системе партнераБитрикс|Инструкция по настройке]]. Может отличаться от того, под которым работает интеграция, здесь нужно для расчета цены для клиента. В таблице ниже указано, что вводить для каждого интегратора;#* 4|-й параметр — пароль пользователя из 3-го параметра|[[Файл:prestashop. В таблице ниже указано, что вводить для каждого интегратора;png|center|x60px]]#* 5|style="text-й параметр — вид срочности партнера. Посмотреть доступные коды видов срочности можно по ссылке в таблице ниже, в калькуляторе в выпадающем списке. Можно в одинарных кавычках указать несколько видов срочности через запятую, тогда система будет стараться выбрать из них первый доступныйalign: center;#* 6-й параметр — наценка к цене, передаваемой подрядчиком"|[https://courierexe. В деньгах или в процентах, если стоит знак процентаru/download/api/prestashop. Например, 10 — наценка 10 рублей, 10% — наценка 10 процентов;zip Скачать]#* 7-й параметр — если указать значение '''|Поддерживает версии 1''', сквозная тарификация выключена. Параметр используется, если подключение нужно только для передачи заказов по интеграции, а расчет цены не нужен5.2.# Нажмите на кнопку '''OK'''0 и выше{|class="wikitable"!Интеграция!Код экстра!Виды срочности!Авторизация!Пример строки
|-
|БОКСБЕРРИ[[Файл:OpencartOCStore.png|center|90001x60px]]|style="text-align: center;"|[https://homecourierexe.ru/download/api/opencart.zip Скачать для версии 1.5.5.1]<br>[https://courierexe.ru/download/api/measoft_oc2.ocmod.zip Скачать для версии 2.0]<br>[https://courierexe.ru/90001download/calculator||Введите токен в 4-й параметрapi/measoft_oc2.3.ocmod.zip Скачать для версии 2. 3-й можно оставить пустым]<br>[https://courierexe.ru/download/api/measoft_oc3.ocmod. Можно оба оставить пустыми zip Скачать для расчета базовых ценверсии 3.0]|Поддерживает версии с 1.5.5.1.<br>Скачивайте модули для своей версии OpenCart.<br>[[OpenCart|33, 90001,, j3ejwo2f10b2e47790174b41f4a11111, 2, 50Инструкция по настройке]].<br>[https://opencartforum.com/files/file/2906-avtomatizaciya-otpravki-i-otslezhivanie-dostavok-courierexe-dlya-opencart-15x/ Альтернативный модуль сторонних разработчиков]
|-
|ПИКПОИНТ[[Файл:webasyst-shopscript.png|center|90002x44px]]|style="text-align: center;"|[https://homewww.courierexewebasyst.ru/90002store/plugin/shop/measoftcourier/ Установить модуль]<br>[https://calculator||3-й параметр — логин, 4-й — через запятую пароль и договор ИКНwww. Можно оставить пустыми, но цены будут не всеwebasyst.ru/store/plugin/shipping/measoftcourier/ Установить плагин]||33Модуль предназначен для отправки заявок в КС, 90002,us0111, '6rGGuqRsW2qNQ,9990721312', 2, 50а плагин для расчета стоимости доставки при оформлении заказа.
|-
<!--|rowspan="2"[[Файл:advantshop.png|СДЭКcenter|x44px]]|rowspanstyle="2"|90005||rowspan="2text-align: center;"|[https://home.courierexepromo-z.ru/90005/calculatorСайт компании PROMO]|Компания PROMO разработала этот модуль и настраивает интеграцию MeaSoft с ADVANTSHOP своим клиентам.|Введите код учетной записи в 3-й параметр, секретный код — в 4-й. Можно оба оставить пустыми для расчета базовых цен->|[[Файл:insales.png|center|x80px]]|style="text-align: center;"|Настраивается в [[Личный кабинет клиента|ЛК пользователя]]|[[InSales|45491, 90005, hfenJwlasiPr4pnFENpaVXSKPIn5Trh7i, '9vkQgWuiZgEj9fGCB8a6Xj3desnJkwsl,1.5', 5, 30%Инструкция по настройке]]
|-
|[[Файл:Leadvertex.png|Если вы хотите добавить в расчет тарифа процент за наложенный платеж, после пароля добавьте запятую и число процентаcenter|x44px]]|style="text-align: center;"|[https://blog.leadvertex. В настройке режима срочности пароль с числом процентов заключите ru/news/2110-integraciya-s-kurerkami-na-platforme-measoft Настраивается] в кавычкиЛК [https://Leadvertex.ru Leadvertex]|[[LeadVertex|9vkQgWuiZgEj9fGCB8a6Xj3desnJkws,1Инструкция по настройке]]<br>Модуль разработан и поддерживается компанией LeadVertex.5
|-
|КСЭ[[Файл:Retailcrm.png|center|90008x30px]]|style="text-align: center;"|[https://homewww.courierexeretailcrm.ru/90008/calculator||Введите логин в 3-й параметр, пароль — в 4-й. Пустыми оставить нельзя.RetailCRM]|[[RetailCRM|12504, 90008, Рога и копыта, 4CCB11864D06157, '2, 3, 6', 10%Инструкция по настройке]]
|-
|ПОЧТА РОССИИ[[Файл:1C.jpg|center|x44px]]|90010style="text-align: center;"|-|[https://home.courierexeinfostart.ru/90010public/692790/calculator||<!--Введите "логин отправки" в 3-й параметр, а в 4-й в одинарных кавычках через запятую пароль отправки и токен. Пустыми оставлять нельзя, т.к. интеграция с Почтой пока не позволяет рассчитывать цены без договора (авторизации).-->Пока поддерживаются только базовые тарифы, без авторизации.||10497, 90010,,, '2, 1', 10 <!--10497, 90010, 89251234567, 'mypassword,u23B0r9AAJ1Fyh4ptMzJ3kjxcslamwdx', '2, 1', 10-->Альтернативный модуль сторонних разработчиков]
|-
|rowspan="3"[[Файл:Joomla2.jpg|DPDcenter|x60px]]|rowspanstyle="3"|90011||rowspan="3text-align: center;"|[https://home.courierexe.ru/90011download/api/calculatorcom_measoft.zip Скачать]||Введите клиентский номер в 3-й параметр, клиентский ключ в 4-йРаботает только с компонентом Virtuemart. Можно оставить пустыми для базовых тарифов.||12504, 90011, 1019003662, '4CCB11864D06157A5934A9119F2A0AAAAAB4CCE8,D117', '3, 6', 10%
|-
|[[Файл:Amocrm.png|center|x44px]]|style="text-align: center;"|Если вы доставляете товар в пункт отправления самостоятельно, после пароля добавьте запятую и код ПВЗ, а в настройке режима срочности введите пароль в кавычках[https://www.amocrm.ru/extensions/courier2008 Установить]|[[amoCRM|'4CCB11864D06157A5934A9119F2A0AAAAAB4CCE8,D117'Инструкция по настройке]].
|-
|rowspan="2"|[[Файл:MoySclad.jpg|center|x30px]]
|style="height:50px; text-align: center;"|[https://home.courierexe.ru/moysklad/step1 Настроить интеграцию с MeaSoft]
|[[МойСклад|Инструкция по настройке]]
|-
|colspanstyle="2height:50px; text-align: center;"|ВНИМАНИЕ! У DPD есть 2 калькулятора, которые считают по-разному при одних и тех же вводных данных[https://itmdev. При этом они не разглашают, по какому из расчетов определяют цену. Поэтому по не зависящим ru/ms/shipping/ Скачать модуль сторонних разработчиков]|Интеграция МойСклад с курьерскими службами от нас причинам расчет по тарифам DPD может как совпасть с итоговым, так и сильно разойтись. Если вас это не устраивает, не используйте сквозную тарификацию с этим подрядчиком.сторонних разработчиков
|-
|DOSTAVKA[[Файл:wordpress.GURUjpg|center|90017x80px]]|style="text-align: center;"|[https://home.courierexe.ru/90017download/api/calculator||3-й параметр — ID партнера в системе DOSTAVKA.guru, 4-й — ключ доступа. Можно оставить пустымиwordpress.zip Скачать]|[[Wordpress|10497, 90017, 9999, cc03e747a6afbbcbf8be7668acfebee5, '1', 100Инструкция по настройке]]
|-
|5Post[[Файл:Cscart.png|center|90020x60px]]|style="text-align: center;"|[https://homemarketplace.courierexecs-cart.rucom/90020/calculator||3-й параметр — API-ключ, 4measoft-й — уникальный номер партнера в системе 5posten. При необходимости в html Установить]|Поддерживает версии 4-м параметре можно через запятую указать пороговое значение веса (по умолчанию 3 кг). Пустыми оставить нельзя. Для вашего аккаунта в API 5post должна быть подключена возможность получать ПВЗ с вашими тарифами10 и выше.<br>[[CS-Cart||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-системами (получение заказов) ==
=== Замечания ===
 # В модулях систем '''PrestaShop''' и '''Joomla''' для отправки заказа в курьерскую службу зайдите в карточку заказа. В карточке отображается специальная форма отправки заказа, а если заказ отправлен, она позволяет проверить его статус. :[[Файл:Form.png|400 px|Форма отправки заказа|none]]
# Оформление заказов до '''ПВЗ''' в модулях '''PrestaShop''' и '''Joomla''' не реализовано. Чтобы оформить такой заказ, в поле передаваемого адреса укажите одно из значений:
#* код ПВЗ, который можно посмотреть в ЛК клиента или на сайте агента (Boxberry, CDEK и ти т.п п.). Обычно это цифровой или цифро-буквенный код;
#* наименование ПВЗ, добавив в начале строку "ПВЗ ", например '''ПВЗ На Ленина'''.
# Поддерживается передача маркировки «[[Маркировка|«Честный ЗНАК»Честный ЗНАК]] » из InSales и RetailCRM. Информацию по настройке см. в документации [https://www.insales.ru/collection/doc-zprochee/product/prodazha-tovarov-s-markirovkoy-487-fz Insales] и [https://help.retailcrm.ru/Users/MarkingOfGoods RetailCRM].# Для отображения списка пунктов выдачи есть [https://home.courierexe.ru/js/measoft_map.js JavaScript модуль]. Инструкция по использованию — внутри. Посмотреть пример работы можно [https://home.courierexe.ru/pvz_test.html здесь].
# При проблемах с отображением карты в модулях очистите кэш браузера: например, для Google Chrome нажмите CTRL+F5. Введенные данные потеряны не будут, карта после этого отобразится корректно.
<!--
=== Беру ===
При интеграции поддерживается:
* Обработка координат.
-->
=== Проверка работоспособности интеграций ===
При неполадках интеграции проверьте ее работоспособность. В общем случае для этого достаточно создать заказ и отправить его в курьерскую службу.
=== OpenCart ===Если заказ отправлен без ошибок и отображается в ЛК, значит, интеграция настроена. Если отправка не удалась, ошибка может быть в настройках интеграции или в заполнении формы отправки заказа.
==== OpenCart 1Текст ошибки можно увидеть через [[Личный кабинет#Отладка|отладку]] в личном кабинете.5Чтобы найти свой заказ в запросах, нажмите клавиши CTRL + F и введите в строку поиска номер заказа или ориентируйтесь на время создания заказа.5.1 ====
Важно! Перед любыми изменениями настроек рекомендуется сделать резервную копию сайта.Для настройки синхронизации:# Загрузите содержимое папки upload из архива в папку сайта Убедитесь, что выполнены все шаги инструкции по FTP. При необходимости подтвердите замену файлов.# Зайдите в панель администратора OpenСart. Подробнее см. в [https://docs.ocstore.com/index.php?title=Панель_Администратора документации OpenCart].# В меню панели управления выберите '''Дополнения''', раздел '''Модули'''. В открывшемся списке найдите '''КС2008''' и нажмите на кнопку '''Установить'''.# В меню панели управления выберите '''Дополнения''', раздел '''Доставка'''. В открывшемся списке найдите '''Основные настройки интеграции КС2008''' и нажмите на кнопку '''Установить'''. Рядом появится кнопка '''Изменить'''.# Нажмите на кнопку '''Изменить'''. Откроется страница «Основные настройки интеграции КС2008»:[[Файл:OpenCart.png|900px|none]]<br>Заполните обязательные поля:#* '''Логин''' — логин пользователя, выдается курьерской службой.#* '''Пароль''' — пароль пользователя, выдается курьерской службой.#* '''Код курьерской службы''' — выдается курьерской службой.#* '''Город отправителя'''. После ввода убедитесь, что в названии населенного пункта нет ошибок.<br>При необходимости заполните остальные поля. Нажмите на кнопку '''Сохранить'''.# В меню панели управления выберите '''Дополнения''', раздел '''Доставка'''. В открывшемся списке найдите '''Настройки доставки курьером КС2008''' и нажмите на кнопку '''Установить'''. Рядом появится кнопка '''Изменить'''.# Нажмите на кнопку '''Изменить''' и в поле '''Тариф для расчета стоимости доставки''' выберите нужный тариф. По умолчанию используется первое значение выпадающего спискаиз этого раздела.
==== OpenCart 2Ниже представлено описание проверки работоспособности для разных интеграторов.0 и выше ====
===== Настройка интеграции ====='''RetailCRM'''
# Скачайте Убедитесь, что выполнены все шаги [[APIRetailCRM#Готовые Настройка интеграции|установочный файлинструкции по настройке интеграции]] для нужной версии OpenCart.# Зайдите в панель администратора OpenСart. Подробнее см. в [https://docs.ocstore.com/index.php?title=Панель_Администратора документации OpenCart].# В панели управления OpenCart выберите '''Установка дополнений''' ('''Установка расширений''') и на странице «Установщик дополнений OCMOD» нажмите на кнопку '''Загрузить'''.# В открывшемся диалоговом окне выберите загруженный файл в формате ZIP и нажмите на кнопку '''Продолжить'''.<br>Когда загрузка будет оконченаЕсли используются триггеры, индикатор загрузки в поле '''Выполнение''' станет зеленым.<br>'''Примечание'''. Убедитесьубедитесь, что название файла оканчивается на «ocmod.zip». Названия вида «ocmod(2).zip» и подобные приведут к ошибкам загрузки файла.они настроены согласно [[RetailCRM# В панели управления выберите '''Менеджер дополнений''' ('''Модификаторы''') и в правом верхнем углу страницы нажмите на кнопку '''Обновить'''Настройка триггеров|инструкции]].# Для OpenCart 2.0 и выше: в панели управления выберите '''Дополнения''' ('''Расширения''')Создайте заказ, раздел '''Доставка'''.<br>Для OpenCart 3.0 и выше: в меню панели управления в разделе '''Расширения''' выберите '''Расширения''' и на странице '''Список расширений''' в выпадающем списке выберите '''Доставка'''.<br>В открывшемся списке найдите '''Основные настройки интеграции КС2008''' и нажмите на кнопку '''Установить'''. Рядом станет активна кнопка '''Редактировать'''заполните требуемые данные.# Нажмите на кнопку '''РедактироватьСохранить'''. Откроется страница «Основные настройки интеграции КС2008».# Заполните обязательные поля:#* '''Логин''' — логин пользователявнизу страницы, выдается курьерской службой.#* флажок '''ПарольНе отправлять данные в службу доставки''' — пароль пользователя, выдается курьерской службойдолжен быть снят.#* '''Код курьерской службы''' — выдается курьерской службойЗаказ должен отправиться в курьерскую службу.#* '''Наценка на доставку (множитель)''' — множитель наценки на стоимости доставки. Если наценки нетвозникает ошибка, установите 0ее текст отображается наверху страницы.#* '''Наценка на доставку (добавочная)''' — конкретная величина наценки на стоимость доставки. :: Если наценки нетэто ошибка заполнения формы, установите 0исправьте внесенные данные и попробуйте отправить заказ снова.Пример ошибки: «Ошибка сервиса доставки „Курьерская служба 2008“: field [receiver phone] has no valid phone number»#* '''Ваш город''' — город отправителя. После ввода убедитесь:: Если это ошибка ответа курьерской службы, что в названии населенного пункта нет ошибоксообщите об этом разработчику.<br>При необходимости заполните остальные поля. Нажмите на кнопку '''Сохранить''' в правом верхнем углу.# В разделе '''Доставка''' найдите '''Настройки Пример ошибки: «Служба доставки курьером КС2008''' и нажмите на кнопку '''Установить'''. Рядом станет активна кнопка '''Редактировать'''. # Нажмите на кнопку '''Редактировать''' и прислала ответ в поле '''Тариф для расчета стоимости доставки''' выберите нужный тариф. По умолчанию используется первое значение выпадающего списканеверном формате».
===== Изменение данных заказа ====='''МойСклад'''
# В административной части сайта При сбое интеграции проверьте, не изменен ли аккаунт, под которым создана интеграция:## Логин учетных данных МойСклад, которые использовались при создании интеграции, вставьте в ссылку <nowiki>https://home.courierexe.ru/moysklad/step2?id=</nowiki>'''логин'''. Если при переходе по ссылке отображается этап настройки интеграции, значит аккаунт существует.## Войдите в «МойСклад» под учетной записью, которая использовалась для настройки интеграции, и откройте заказ и вверху справа нажмите на кнопку [[Файлсправочник '''Сотрудники''':OpenCartEditменю пользователя > '''Настройки''' > '''Справочники'''> '''Сотрудники'''.png|25 px]]Откройте карточку сотрудника, под учетной записью которого вы вошли, и убедитесь, что его роль — администратор.# В режиме редактирования данные заказа представлены на пяти вкладках. Измените данные# Если хотя бы один из пунктов не выполнен, значит, аккаунт, использованный для перемещения по вкладкам используйте кнопки создания интеграции, изменен.# В личном кабинете клиента курьерской службы в настройках обратной интеграции '''ПродолжитьМой склад''' и в поле '''НазадВ каком статусе «Мой склад» отправлять заказ на доставку'''уточните статус, при котором заказ отправляется в курьерскую службу.# На вкладке Заполните форму заказа, нажмите на кнопку '''ИтогиСохранить''' проверьте введенные данные , затем смените статус заказа на статус, установленный для отправки в курьерскую службу и снова нажмите на кнопку '''ПрименитьСохранить''' для сохранения изменений . Если все верно, заказ будет отправлен в каждой строкекурьерскую службу.# Нажмите на кнопку Обновите страницу в браузере и проверьте поле '''СохранитьСтрока для сохранения информации об ошибках''':#* если поле пустое и заказ пришел в личный кабинет, интеграция работает;#* если поле пустое и заказ не пришел в личный кабинет, обратитесь к разработчику;#* если в поле содержится текст ошибки, исправьте ее в форме заказа и попробуйте отправить его снова.
==== Возможные ошибки ===='''InSales'''
* Ошибка локализации. Чтобы переключить язык сайта на русский, сверьте названия папок локализации # В личном кабинете клиента курьерской службы в скачанном архиве модуля (\upload\admin\language) и настройках обратной интеграции '''InSales''' проверьте данные в созданном после установки модуля каталоге. Названия папок должны быть одинаковыми, например ru-ru и en-gb. Если в результате установки появилась папка с другим именем, перенесите ее содержимое в нужную папку.* При возникновении ошибокследующих полях:#*# В панели управления выберите '''Менеджер дополненийСтатус заказа для автоматической отправки в курьерскую службу''' (;#* '''МодификаторыСписок доставок для отправления заказа в курьерскую службу (если отправляется автоматически)''') и в правом верхнем углу страницы нажмите на кнопку ;#* '''ОбновитьОплачен ли заказ? (если отправляется автоматически)'''.*# Очистите кэш везде — Создайте заказ и в панели состоянияслучае ошибки проверьте данные заказа на соответствие этим полям. Например, в дополнительных модуляхзаказе может быть установлен тип доставки, не отмеченный как используемый в настройках в браузере и т.п.*# Проверьте работу модуля.*: Для OpenCart 3.0 и выше с установленным модулем Simple установите [https://courierexe.ru/download/api/liveopencart.modtwigfix30356.ocmod.zip| модификатор] и выполните шаги 1-3личном кабинете.
=== 1C-Битрикс===При возникновении ошибок при отправке заказа появляется диалоговое окно с сообщением об ошибке. Исправьте ошибку в форме заказа и попробуйте отправить его снова.
==== Настройка интеграции ===='''amoCRM'''
# В личном кабинете 1C-Битрикс на вкладке '''Администрирование''' в панели слева выберите '''Marketplace''' > '''Каталог решений''' и на странице «Каталог Маркетплейс» с помощью строки поиска найдите '''Модуль интеграции MEASoft'''.# Щелкните по ссылке «Установить».# Убедитесь, что в строке '''Модуль интеграции MEASoft''' установлен флажок, и нажмите на кнопку '''Загрузить'''. Далее примите лицензионное соглашение и нажмите '''Применить'''.# После окончания загрузки нажмите на кнопку '''Установить'''.# В панели слева выберите '''Магазин''' > '''Настройки''' > '''Службы доставки''', затем на странице «Список служб доставок» раскройте выпадающий список кнопки '''Добавить''' и выберите пункт '''Автоматизированная служба доставки'''. Откроется страница «Новая служба доставки».# На странице «Новая служба доставки» перейдите на вкладку '''Настройки обработчика''' и в выпадающем списке '''Служба доставки''' выберите '''"Курьерская служба" - сервис доставки'''. Нажмите на кнопку '''Применить'''.# Перейдите на вкладку '''Настройки интеграции''': [[Файл:Bitrix Настройки интеграции.png|none|800px]]#: На этой вкладке:#* в разделе '''Настройки доступа''' введите учетные данные личного кабинета в поля '''Логин''', '''Пароль''' и '''Код клиента'''. Запросите эти данные у курьерской службы, с которой настраивается интеграция. Кнопка '''Проверить''' предназначена для проверки введенных учетных данных.#* в разделе '''Основные настройки''':#** в поле '''Оплата картой''' выберите тип оплаты, который будет соответствовать оплате картой (если оплата картой возможна);#** установите флажок '''Использовать артикулы''', если артикулы будут использоваться для привязки номенклатуры к складу курьерской службы;#* в разделе '''Соответствующие поля покупателя''' настройте соответствие полей получателя (ФИО, города, адреса и др.) полям в форме создания заказа;#* для работы с товарами, [[Маркировка|маркированными]] кодом «Честный ЗНАК», в разделе '''Соответствующие поля товаров''' укажите поле для хранения кода;#* в разделе '''Статусы отправки заказа''' выберите статусы, при которых заказ будет автоматически отправлен в курьерскую службу.# На вкладке '''Ценовая политика доставки''' Ошибка при необходимости настройте стоимость доставки для покупателя в зависимости от стоимости создании заказа.# На вкладке '''Ограничения''' при необходимости укажите ограничения работы модуля по географии, типам оплаты и т.п.# По завершении настройки нажмите на кнопку '''Сохранить'''.# В настройках магазина укажите его местоположение для определения города отправителя.#: Если нужно производить расчет для другого города отправителя (например, физически магазин находится в области, а курьерская служба должна считать доставку, как по городу):#* в разделе '''Рабочий стол''' > '''Настройки''' > '''Настройки продукта''' > '''Настройки модулей''' > '''Курьерская служба''' в поле '''Города-отправители''' добавьте город отправителя;#* отображается в разделе '''Рабочий стол''' > '''Магазин''' > '''Настройки''' > '''Службы доставки''' > Нужная служба > '''Настройки интеграции''' > '''Город отправитель''' укажите добавленный выше городлевом нижнем углу.
Проверить работу модуля можно в форме оформления доставки. При этом должна корректно считаться стоимость доставки== Интеграция с подрядчиками ===== Описание процесса интеграции ===Рассматривается интеграция с системами сторонних компаний (агентов), где система MeaSoft выступает клиентом, то есть передает заказы и получает обратно статусы.
==== Перенос даты доставки ====Компания-пользователь MeaSoft должна иметь аккаунт и личный кабинет в системе MeaSoft. Подробнее см. раздел [[Личный кабинет курьерской службы#Подключение|«Личный кабинет курьерской службы»]].
Вы можете настроить перенос даты доставки на один день вперед от даты, получаемой от # Создайте в своей системе [[Филиалы|филиал]] для агента. После ввода филиала нужно перезагрузить программу и подождать 3 минуты.# В личном кабинете курьерской службына вкладке '''Интеграции''' в списке филиалов найдите созданный филиал и в его строке нажмите на кнопку '''Настроить'''.# В открывшемся окне в выпадающем списке выберите нужную интеграцию.# Заполните форму по отображенной инструкции, если заказ оформлен позже определенного часанажмите '''Сохранить'''.
Чтобы настроить перенос даты доставки:# В личном кабинете 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''' — не переносить дату доставки;:* возможные значения для второй строки: целое число от На передачу данных может уходить до 10 минут в штатном режиме и до 1 до 24. Если оформить заказ после указанного часа, к дате доставки, получаемой от курьерской службы, прибавляется один день.:5. Нажмите на кнопку '''Сохранить'''в случае возможных сбоев.
==== Передача наложенного платежа ====Для стабильной работы необходимо наличие у клиента системы MeaSoft версии минимум 518 от 05.12.2014.
# В личном кабинете 1C-Битрикс на вкладке '''Администрирование''' в панели слева выберите '''Настройки''' > '''Настройки продукта''' > '''Настройки модулей''' и на странице «Настройки модуля» в выпадающем списке выберите значение '''Курьерская служба'''.# Установите флажки в списках ниже для сопоставления типов оплаты наложенного платежа.# Нажмите на кнопку '''Сохранить'''.==== Последовательность финальных статусов ====
Для предоплаченных заказов Параметр <b>Исправлять ошибки последовательности статусов</b> регулирует возможность исправления ошибочно опубликованных подрядчиком финальных статусов.<br>Если в карточке корреспонденции отображается сумма к оплате 0параметре интеграции указано "Исправлять", то при наличии товарных вложений добавляется вложение «Предоплата» с типом вложения '''Предоплата''' и ценойполучении статуса <b>CANCELED</b>, равной сумме предоплатывслед за финальным, со знаком «минус». Поддерживается только полная предоплатадата доставки заказа будет приводится в состояние соответствующее последнему полученному статусу.
==== Отправка заказа в курьерскую службу =СДЭК===
Чтобы отправить заказ в курьерскую службуКомпания СДЭК прекращает поддержку API версии 1.5 с 01.01.2022. По информации от службы поддержки, зайдите в карточку заказаинтеграция не будет резко отключена, укажите настроенное значение в поле '''Статус отправки заказа''' и нажмите на кнопку '''Сохранить'''но поддержка будет осуществляться только для версии API СДЭК 2.0
'''Примечание'''Для перехода на новую версию создана интеграция СДЭК 2. Значения полей '''Комментарий покупателя к заказу''' и '''Комментарий менеджера''' передаются из 1С-Битрикс в поле '''Комментарий''' заказа в системе MeaSoft0.
Если статус уже установленЧтобы настроить интеграцию с платформой СДЭК версии 2.0, но заказ не отправлен в курьерскую службу (связано с техническими особенностями)заполните следующие поля:# Выберите статус заказа по умолчанию после его создания (например, * '''НовыйID клиента''').# Перезагрузите страницу.* '''Ключ клиента '''# Выберите статус отправки и сохраните его.* '''Код пункта приема '''При отправке заказа появится сообщение об успешной отправке или об ошибке.Статус заказа можно проверить в карточке заказа, в правом верхнем углуЭто обязательные поля.
Остальные поля служат для более тонкой настройки создания заказов:* '''Передавать объявленную ценность'''. Значение по умолчанию '''Да''', вы можете изменить это, выбрав одно из значений:** "Да"<br><span style="padding-left: 5px;">Оценочная стоимость формируется по принципу наибольшего значения.</span><br><span style="padding-left: 5px;">Учитываются Оценочная стоимость всего заказа, Оценочная стоимость товарных вложений, цена товарных вложений.</span><br>** "Нет"<br><span style="padding-left: 5px;">объявленная ценность товарных вложений передаваться не будет</span><br>** "Передавать, если указана"<br><span style= Возможные ошибки ==="padding-left: 5px;">Учитываются только суммы из полей Оценочная стоимость заказа и Оценочная стоимость товарных вложений, где в приоритете Оценочная стоимость заказа.</span>** "Передавать, по местам, если указана"<br><span style="padding-left: 5px;">Оценочная стоимость заказа распределяется по вложениям. Вложения в свою очередь распределяются по местам.</span>* '''Добавлять услугу «Осмотр вложений»'''. Тарифицируемая услуга от СДЭК, поэтому она добавится, только если в настройках указано '''Да''';* '''Процент за наложенный платеж'''. Используется при получении агентской цены. Калькулятор API CDEK не включает в расчет сумму за наложенный платеж автоматически, но мы добавим указанный вами процент в итоговую сумму;* '''Использовать как номер'''. Номер заказа отображается в личном кабинете и отчетах СДЭК. Выберите удобный вариант: '''Шифр''' или '''Штрихкод''';* '''Код курьера'''. Укажите код курьера, который будет указан в поле '''Вручил курьер''' для доставленных заказов.* '''Способ доставки до ПВЗ отправления'''** "Самопривоз в офис СДЭК" - установлено по умолчанию, необходимо заполнить <b>Код пункта приема</b>** "Забор со склада" - в заказе указывается адрес склада с которого курьеры СДЭК забирают отправления. Адрес указывается в карточке ответственного филиала для которого настраивается интеграция со СДЭК вер.2.0** "Забор у отправителя" - в заказе указывается адрес отправителя с которого курьеры СДЭК забирают заказы.*** <i>Адрес из карточки клиента владельца фирмы отправителя</i> - если в ответственном филиале интеграции настроено "Скрывать отправителя"*** <i>Адрес отправителя из карточки заказа</i> - если он не пустой*** <i>Адрес из карточки отдела</i> - если пустой адрес отправителя в заказе*** <i>Адрес из карточки клиента отправившего заказ</i> - если пустой адрес отдела
# Если не рассчитывается стоимость, возможные причины:
#* некорректно установлен модуль;
#* введены некорректные учетные данные;
#* в курьерской службе не настроен тариф. Обратитесь в курьерскую службу для настройки тарифа. После настройки тарифы можно проверить в личном кабинете, на вкладке '''Калькулятор'''.
# По умолчанию при оформлении заказа должны появиться поля даты и времени желаемой доставки. Если они отсутствуют, то у формы были изменены стили. Также возможно обновление формы в системе Битрикс.[[Файл:Bitrix2.png|none|700 px]]
# Проверьте правильность привязки свойств. Для этого в разделе '''Рабочий стол''' > '''Магазин''' > '''Настройки''' > '''Свойства заказа''' > '''Список свойств''' найдите свойство, связанное с ошибкой, щелкните по нему правой кнопкой мыши и выберите '''Изменить параметры свойства'''.<br>На вкладке '''Привязка свойства''' настраиваются условия, при которых поле будет показываться клиенту. Если у свойства заказа настроена привязка, то оно будет показываться ТОЛЬКО в том случае, когда покупатель выберет хотя бы один из указанных критериев:[[Файл:Битрикс Связь свойства.png|none|500px]]
В этом примере покупатель при оформлении <div style="color: #a94442; background-color: #f2dede; border: 1px solid #ebccd1; padding: 3px 10px 10px;">* Интеграция СДЭК версии 2.0 не предусматривает автоматическую отправку заказа увидит созданное поле для заполнения только после получения ошибки. Чтобы отправить заказ повторно после исправления, обратитесь в том случае, если техподдержку MeaSoft.* Интеграция не предусматривает проверку номеров телефонов передаваемых заказов на соответствие стране. api СДЭК проверяет номера телефонов на предыдущих шагах он выбрал оплату '''Наличными курьеру''' (при любой службе доставки), или же если захотел расплатиться любым способом, но выбрал соответствие списку стран после отправки заказа. Список стран номера телефонов которых принимаются без ограничений опубликованы в качестве службы доставки '''Воздушный транспорт'''[https://api-docs.cdek.ru/29923926.html документации СДЭК]</div>
Свойство будет показано всегдаПри выборе тарифа для отправки заказа приоритет отдается тарифам режима срочности, если привязка выбранного в заказе. Если в режиме срочности не выбрана или если выбраны все варианты платежных систем или служб доставкинастроены тарифы, то тариф выбирается из списка в параметре интеграции '''Приоритет тарифов'''. В этом случае отправка в СДЭК осуществляется первым доступным тарифом из списка.
Подробнее см. [httpsДоступные для выбора списки тарифов по умолчанию://dev.1c* «Экономичная посылка»,* «Посылочка»,* «Экспресс-bitrix.ru/learning/course/index.php?COURSE_ID=42&LESSON_ID=3073&LESSON_PATH=3912.4580.4828.3073 документацию 1С-Битрикс]лайт»,* «Магистральный экспресс».
=== InSales ===Также возможно выбрать второй вариант, который поменяет местами тарифы «Экономичная посылка» и «Посылочка».Для удобства работы до настройки интеграции создайте в InSales следующие пользовательские статусы:* «Посылочка»,* статус для автоматической передачи заказов в курьерскую службу«Экономичная посылка»,* статус для обозначения заказа с ошибкой передачи данных.«Экспресс-лайт»,Чтобы настроить статусы, в панели администрирования InSales выберите '''Настройки''' > '''Оформление заказа''' > '''Пользовательские статусы''' и создайте статусы, например «Передано в КС» и «Ошибка»* «Магистральный экспресс».
==== Настройка интеграции ====При весе отправления больше 30 кг применяется тариф «Магистральный экспресс».
# В личном кабинете InSales откройте '''Приложения''' > '''Центр приложений''', с помощью строки поиска найдите модуль «Курьерская служба 2008» и нажмите на кнопку '''Установить'''.# Откроется личный кабинет InSales. На странице «Установка приложения» нажмите на кнопку '''Установить'''.# В списке установленных приложений выберите «Модуль "Курьерская служба 2008"». Откроется страница авторизации личного кабинета клиента курьерской службы. Если вы авторизованы в ЛК курьерской службы, то сразу откроется страница настроек, см. п. 5.# Введите учетные данные личного кабинета в поля '''Логин''', '''Пароль''' и '''Код курьерской службы'''. Запросите эти данные у курьерской службы, с которой настраивается интеграция.# На странице «Настройка интеграции Insales» выполните настройку интеграции.<br>Особенности заполнения полей:#* '''Статус заказа для автоматической отправки в курьерскую службу'''. Выберите из выпадающего списка заранее созданный статус, при установке которого заказ автоматически отправляется в курьерскую службу, или значение '''Не отправлять'''.#* '''Отправлять артикулы (для привязки к складу)'''. Если опция включенаЧтобы передать услугу «Примерка», артикулы товаров из InSales передаются в MeaSoft. #* установите флажок '''Название доставки курьером Принято на странице заказасклад'''. Укажите название доставки, которое будет отображаться в заказе вместо «Курьерская доставка МЕАСОФТ» при выборе способа доставки. Можно оставить поле пустым, тогда список будет выглядеть следующим образом:[[Файл:Insales Delivery.png|noneЕдиница корреспонденции#Создание единицы корреспонденции|800 pxкарточке корреспонденции]]#* '''Описание доставки курьером на странице заказа'''. Укажите описание вида доставки. Можно оставить поле пустым.#* '''Синхронизировать остатки по складам'''. Если опция включена, данные по складским остаткам из курьерской службы передаются в InSales.#* '''Используется мультисклад?'''. Определяет, используется ли выбор товаров с одного склада или из нескольких. Возможные значения: '''Да''', '''Нет'''. В случае работы с несколькими складами убедитесь, что в настройках InSales ('''Настройки''' > '''Настройки магазина''' > '''Мультисклад'''.) указано такое же количество складов, как в системе MeaSoft.#* '''Статус заказа при ошибке передачи в курьерскую службу'''. Выберите из выпадающего списка заранее созданный статус, который будет использоваться для обозначения заказов с ошибкой передачи данных, или укажите значение '''Не отправлять'''.#* '''Производить расчет без адреса?'''. Если выбрано значение '''Нет'''услуга не нужна, расчет стоимости доставки возможен только после ввода полного адреса получателя.# По заполнении нужных полей нажмите '''Сохранить'''снимите флажок.
В результате При передаче валюты наложенного платежа код валюты берется из поля '''Валюта''' карточки клиента, от которого передается заказ. Валюта должна совпадать с валютой страны назначения заказа. Если заказ отправляется в InSales другую страну, создайте копию клиента с нужной валютой и оформляйте заказы от него, указывая цены в окне создания заказа появляется блок «Модуль "Курьерская служба 2008"»:::[[Файл:Insales Module KSвалюте страны назначения.png|none|300 px]]
==== Настройка типов оплаты ====В общем случае интеграция не поддерживает отправки в другие страны, кроме России.
Тип оплаты заказа определяется следующим образом[http:* если заказ оплачен, то передается тип оплаты '''Оплачен''';* тип оплаты '''Банковская карта''' передается, если в InSales используется один из следующих типов//courierexe.ru/download/userfunc/SDEK_report_load.xml Загрузка отчета СДЭК] создает входящий АПД по отчету СДЭК [http:** '''Оплата банковской картой''';** '''Банковской картой //courierexe.ru/download/userfunc/SDEK_report_demo.xls такого формата]. Работает при получении''';** '''Оплата банковской картой курьеру'''.: Создайте эти типы оплаты передаче заказов в InSales: '''Настройки''' > '''Оформление заказа''' > '''Оплата''';* если название типа оплаты не совпадает СДЭК с вышеперечисленными, передается тип оплаты помощью штатной интеграции. Заполняет поле '''НаличнымиАгентская цена'''.В системе MeaSoft в карточке интернет-магазина есть флажок '''Спрашивать тип оплаты у получателя'''. Если он установлен, то независимо от переданного типа оплаты '''Наличными''' или корреспонденции на вкладке '''Банковская картаМежгород''' покупателю будет предложен выбор способа оплаты.
Настройки === DPD ===<div style="color: #a94442; background-color: #f2dede; border: 1px solid #ebccd1; padding: 3px 10px 10px;"><b>Внимание!</b><br> Для одного аккаунта DPD может быть настроена только одна интеграция.<br>Если вам требуется настроить интеграцию для нескольких филиалов, предварительно создавайте новый аккаунт DPD для каждой интеграции можно изменить .</div>Статусы заказов передаются корректно, только если для одного аккаунта DPD настроена одна интеграция. <br>При выборе тарифа для отправки заказа приоритет отдается тарифам режима срочности, выбранного в разделе '''Автоматизация''' [[Личный кабинет клиента#Автоматизация|личного кабинета MeaSoft]]заказе.
=== RetailCRM ===Для настройки интеграции с платформой DPD укажите следующие параметры:* '''Клиентский номер''' - уникальный клиентский номер в системе DPD.* '''Клиентский ключ''' - ключ для авторизации, полученный у сотрудника DPD.* '''Код пункта самопривоза''' - не обязательный параметр. код пункта самовывоза, куда клиент DPD доставляет заказ для отправки.* '''Номер регулярного заказа''' - номер регулярного заказа DPD. Если вы используете доставку на регулярной основе, уточните этот номер у своего менеджера.* '''Проверка комплектности''' - по умолчанию отсутствует. Есть возможность выбрать одно из значений:
См. раздел «[[RetailCRM]]».<ul><ol><span style="color: blue; margin-right: 10px;">○</span>Отсутствует</ol><ol><span style="color: blue; margin-right: 10px;">○</span>С примеркой</ol><ol><span style="color: blue; margin-right: 10px;">○</span>Простая</ol><ol><span style="color: blue; margin-right: 10px;">○</span>С проверкой работоспособности</ol></ul>
=== CS-Cart TopDelivery ===
Чтобы настроить интеграциюДля настройки интеграции с платформой TopDelivery укажите:* '''Логин'''* '''Пароль'''* '''Информация о поставщике товара'''. Если указано '''Отправлять''', то при отправке заказа будет предпринята попытка отправить место с габаритами и товарами с указанием данных поставщика: ИНН, наименование, номер телефона. Если данных поставщика нет, информация об ошибке отправки мест будет добавлена в сообщение к заказу. Информация о поставщике повторно не отправляется.* '''Вскрытие отправления до получения оплаты''' - по умолчанию разрешено.<br>Возможность запрета вскрытия отправления добавляется при отправке заказа, если в настройках интеграции разрешен запрет и в заказе стоит отметка "Принято на склад"
[[Файлы для загрузки# Скачайте архив модуля установки по [http://courierexe.ru/download/api/ms_courierexe-v1D0.9F.D0.B5.D1.87.D0.B0.D1.82.D0.BD.D1.8B.D0.B5 .D1.84.D0.BE.D1.80.D0.BC.D1.8B .D0.B4.D0.1BB.1D1.zip ссылке]8F .# В панели администратора CS-Cart откройте '''Модули''' > '''Управление модулями''' и на странице «Модули» нажмите на кнопку [[Файл:Cscart добавитьD0.png|25 px]]BC. Откроется окно «Загрузить и установить модуль»D0.# В этом окне нажмите на кнопку '''Загрузить''', выберите архив с модулем на компьютере и нажмите на кнопку '''Загрузить и установить'''B0. Модуль «Курьерская служба 2008» появится в списке модулейD0.# Откройте '''Администрирование''' > '''Доставка и налоги''' > '''Способы доставки''' и нажмите на кнопку [[Файл:Cscart добавитьBD.png|25 px]]D0. Откроется окно «Новый метод доставки»:#:<br>[[Файл:Cscart настройкаB8.png|900px|none]]#:# В этом окне укажите следующие настройки:#* в поле '''Расчет тарифа''' установите переключатель '''В режиме реального времени''';#* в выпадающем списке '''Перевозчик''' выберите значение '''КС2008''';#* в выпадающем списке '''Служба доставки''' выберите режим срочности по умолчанию;#* заполните остальные поляD1.# Нажмите на кнопку '''Создать'''84. Появляется оповещение о том, что изменения сохранены, и в этом же окне появляются кнопки настройкиD0. Нажмите на кнопку '''Настроить''':#:<br>[[Файл:Cscart курьеромB5.png|800 px|none]]#:# В этом окне укажите следующие настройки:#* введите учетные данные клиента курьерской службыD1. Запросите эти данные у курьерской службы, с которой настраивается интеграция81. На рисунке указаны учетные данные тестового доступа;#* Укажите тип доставкиD1. Возможные значения: '''Курьером до двери''', '''ПВЗ'''82.# Нажмите на кнопку '''Сохранить'''D0.Чтобы проверить работу интеграции, нажмите на кнопку '''Общее''', нажмите '''Рассчитать стоимость доставки''', введите вес отправления и нажмите на кнопку '''Тест'''BE. При настроенной интеграции отобразится окно с расчетной стоимостью и сроком доставкиD0.B2|Печать наклеек для TopDelivery]]
Чтобы создать два способа доставки — '''Курьером до двери''' и '''ПВЗ''', повторите все шаги, начиная === Почта России ===Интеграция с п. 4Почтой России описана в разделе [[%D0%A0%D0%B0%D0%B1%D0%BE%D1%82%D0%B0 %D1%81 %D0%9F%D0%BE%D1%87%D1%82%D0%BE%D0%B9 %D0%A0%D0%BE%D1%81%D1%81%D0%B8%D0%B8|Работа с Почтой России]].
В результате новые способы доставки будут отображаться в списке '''Администрирование''' > '''Доставка === PickPoint ===Если PickPoint выделил вам диапазон трекинг-номеров, то необходимо настроить филиал и налоги''' > '''Способы доставки''' и в окне создания заказа:придерживаться последовательности отправки [[Манифесты#Отправка|манифестов]].
::Чтобы настроить филиал для интеграции PickPoint с диапазоном, в основном меню выберите '''Справочники''' > '''Межгород''' > '''Филиалы''', откройте карточку [[Файл:Cscart оформить заказ.png|700 pxФилиалы|noneфилиала]]и на вкладке '''Интеграция''' в выпадающем списке '''Правила назначения кода заказа у подрядчика''' выберите '''Из диапазона'''. Укажите начальный и конечные коды диапазона, префикс при необходимости и нажмите клавишу '''ОК'''.
Чтобы просмотреть полученные Для отправки манифестов добавьте заказыв манифест, откройте затем на вкладке '''ЗаказыМанифесты''' > отсканируйте заказы в мешок и выберите в карточке манифеста ранее настроенный филиал. После этого в контекстном меню манифеста выберите '''Полученные заказыПроставить коды у подрядчика'''. В карточке заказа в правом нижнем углу находится блок модуля «Курьерская служба 2008»:
::[[Файл:Cscart блок ксПосле этого можно указать дату отправки манифеста.png]]
Чтобы передать заказ в курьерскую службуОбратите внимание, нажмите на ссылку '''Отгрузить'''что проставить коды с указанной датой отправки манифеста нельзя. Необходимо сначала очистить дату отправки, а затем проставить коды.
Также Агентская цена интеграцией не возвращается, так как эти данные отсутствуют в этом блоке вы можете проверить статус доставки заказаAPI PickPoint.
'''Примечание'''=== КСЭ ===Для обращения к функциям системы необходимо знать своё имя пользователя и пароль в системе КСЭ. Модуль поддерживает CS-Cart 4.10 и выше<br> Если у вас еще нет доступа, то необходимо обратится к Вашему менеджеру в подразделение клиентского сервиса КСЭ.<br>
=== amoCRM ===<b>Настройки интеграции:</b><br>* '''Логин''' - логин от ЛК КСЭ* '''Пароль''' - пароль от ЛК КСЭ* '''Данные отправителя''' — данные, которые будут подставляться во все отправления, передаваемые в КСЭ. Если не указать, то будут передаваться данные заказчика (отправителя) из корреспонденции.* '''Является ИМ''' — признак отправителя в системе КСЭ. От данного признака зависит главным образом, как отправляются данные в КСЭ. Признак указывается в договоре клиента с КСЭ.* '''Забор''' — настройка, в которой можно указать, каким образом отправление передается в КСЭ — КСЭ забирает отправление у клиента или клиент сам привозит отправление в КСЭ.** '''По умолчанию''' — груз будет принят для доставки в офисе (самопривоз в КСЭ) для всех заказов с товарной составляющей, иначе будет послан курьер для забора.** '''До двери''' — будет послан курьер для забора** '''Самопривоз в КСЭ''' — груз будет принят для доставки в офисе
Интеграция реализована через виджет «Курьерская служба 2008»При выборе тарифа для отправки заказа приоритет отдается тарифам режима срочности, предназначенный для передачи заказов из amoCRM выбранного в MeaSoft и возврата статусовзаказе.
Чтобы начать отправлять заказы в курьерскую службу, настройте интеграцию с MeaSoft и сопоставьте поля amoCRM и виджета для корректной передачи данных в MeaSoft.<!--==== Настройка интеграции ====Для удобства работы перед настройкой интеграции добавьте дополнительные поля в сделке: выберите '''Сделки''' > '''Новая сделка''' и на вкладке '''Настроить''' добавьте в любую группу новые поля '''Стоимость доставки''', '''Стоимость товаров''', '''Закупка'''. [[Файл:Amo Settings.png|none|500 px]] Чтобы настроить интеграцию с amoCRM:# Этот этап можно делать из [[Личный кабинет клиента#Интеграция|личного кабинета MeaSoft]] '''ИЛИ''' из административной части amoCRM:#* В личном кабинете MeaSoft:#*# В разделе '''Автоматизация''' перейдите на вкладку '''Обратная интеграция''' и в таблице «Список всех обратных интеграций» в строке «AmoCRM» нажмите '''Добавить'''.#*#Укажите название интеграции и префикс и нажмите на кнопку '''Сохранить'''.#*#Укажите аккаунт amoCRM, в котором будет установлен виджет «Курьерская служба 2008» и нажмите '''Разрешить'''. Виджет установлен.#* В административной части amoCRM:#*# В меню выберите '''Настройки''' > '''Интеграции''' и в строке поиска введите «Курьерская служба 2008».#*#Щелкните по найденному модулю, нажмите на кнопку '''Установить'''. Виджет установлен.# В amoCRM выберите '''Настройки''' > '''Интеграции''' и в разделе '''Установленные интеграции''' откройте «Курьерская служба 2008».# Введите логин, пароль и код курьерской службы. Запросите эти данные у курьерской службы, с которой настраивается интеграция.# Нажмите на кнопку '''Настройки виджета'''. В окне «Настройки интеграции с Курьерская служба 2008»:## Установите параметры товаров и доставки.## Установите поля для сохранения данных заказа. Например, в выпадающем списке поля '''Сохранять стоимость товаров в отдельное поле''' укажите значение '''Сохранять в поле: Стоимость товаров'''.## Укажите, откуда будут добавляться товары к заказу. Если это список в amoCRM, настройте соответствие полей. Списки amoCRM доступны начиная с тарифного плана «Расширенный».## Установите соответствие между статусами в личном кабинете клиента курьерской службы и статусами amoCRM.## Нажмите '''Сохранить настройки'''.# В окне ввода учетных данных интеграции нажмите '''Сохранить'''DOSTAVKAGURU ==== Сопоставление полей ===={|class="wikitable"!Поле виджета!Данные amoCRM!Где настраивается сопоставление|-|'''Имя''', '''Телефон'''||Поля карточки контакта||-|-|'''Номер заказа'''||• Название сделки;<br>• ID сделки;<br>• пользовательское поле||'''Настройки виджета''' > '''Настройки интеграции с Курьерская служба 2008'''|-|'''Город''', '''Адрес''', '''Индекс''', '''Примечание''', '''Дата доставки'''|| Поля сделки|| '''Настройки виджета''' > '''Настройки интеграции с Курьерская служба 2008'''|-|'''Вес''', '''Сумма''', '''Объявленная ценность''', название и количество товара||Карточка товара||• Если товар добавляется вручную или из каталога Курьерской службы 2008, сопоставление не требуется;<br>• если товар добавляется из списка amoCRM, настройте сопоставление в '''Настройки виджета''' > '''Настройка товаров'''|-|'''Количество мест'''|| - ||Заполняется в виджете вручную|}
'''Настройка'''. Для интеграции введите следующие учетные данные:* '''Идентификатор клиента''' — ID клиента DOSTAVKA.GURU. ID клиента отображается вверху страницы личного кабинета клиента DOSTAVKA.GURU;* '''Ключ клиента''' — запросите API-ключ интеграции у DOSTAVKA.GURU.* '''Регион откуда повезется заказ''' - Доступен выбор из трех вариантов:<ul><ol><span style="color: blue; margin-right: 10px;">○</span> По договору (В этом случае, мы не сообщаем о регионе отправки в систему Guru и регион определяется договором с DOSTAVKA.GURU)</ol><ol><span style="color: blue; margin-right: 10px;">○</span> Москва</ol><ol><span style=Беру===При интеграции поддерживается"color: blue; margin-right:10px;">○</span> Санкт-Петербург</ol>* Обработка координат.</ul>
===МойСклад==='''Запрещенные символы'''. Перед отправкой номер заказа и имя получателя проверяются на наличие запрещенных символов. Если обнаружены запрещенные символы, заказ не отправляется в интеграцию и получает ошибку. Из других текстовых полей запрещенные символы удаляются. Это не приводит к получению ошибки. При проверке имени получателя и других текстовых полей используется сокращенный список запрещенных символов.
Интеграция предназначена Сокращенный список недопустимых символов для передачи заказов с товарными вложениями из системы МойСклад в MeaSoft. Обратно в МойСклад будут приходить статусытекстовых полей:<code>['~', стоимость доставки и общая сумма заказа с учетом частичной доставки. '`', '@', '#', '$', '%', '^', '&', '=', '+', '!', '"', '№', ';', ':', '?', '\']</code>
Чтобы настроить интеграциюПолный список недопустимых символов:# В системе МойСклад создайте дополнительные поля в заказах:#* с типом «Строка»:#** <code>['~', 'Город`', '@' — для указания населенного пункта получателя;#** '''Дата доставки, ''' — для указания даты доставки наряду со временем;#** ', '$'Сумма заказа, '%', ' — для получения суммы заказа от курьерской службы;#** ^', '&'Стоимость доставки, '=', ' — для получения стоимости доставки от курьерской службы;#** +', '!'Строка для сохранения информации об ошибках, '"', ' — для получения текста ошибки;#** ', ''Количество мест''' — для возможности указания количества мест;#* с типом «Файл»:#** '''Файл', '' — необязательное поле для передачи файлов. Максимальный размер файла — 1 МБ;#* с типом «Справочник»:#** ', '?'Виды срочности, '\', ' — одноименный справочник;#** '\s', 'Временные интервалы''' — одноименный справочник;#** ', '('Способы доставки, '_', ' — одноименный справочник;#** {', '}'Тип оплаты, '.', ' — одноименный справочник;#** ,', '\['Время доставки с''' — справочник '''Часы доставки'', ';#** '''Время доставки по''' — справочник '''Часы доставки'''.# Перейдите по [https://home.courierexe.ru/moysklad/step1 ссылке\] и введите логин и пароль от учетной записи системы «МойСклад» с правами администратора.<br><br>'''Примечание'''. Запрещено изменять данные этой учетной записи — это приведет к сбою интеграции. В будущем при обращении в техническую поддержку MeaSoft указывайте данные этой учетной записи для получения помощи по вопросам интеграции.<br>Если все же есть необходимость сменить учетные данные, после сообщите новый пароль от «МойСклад» в техподдержку MeaSoft для внесения изменений в настройки интеграции.<br><br># Укажите логин, пароль и код курьерской службы. Запросите эти данные у курьерской службы, с которой настраивается интеграция.# Нажмите на кнопку '\''Сохранить'''.]<br/code>В случае ошибки «Данный пользователь "Мой склад" уже зарегистрирован.» нажмите на кнопку '''Сбросить'''.# Дождитесь окончания синхронизации справочников. Не закрывайте и не перезагружайте страницу. Процесс может занять продолжительное время (от 10 минут).<br>После синхронизации справочников автоматически произойдет переход на страницу следующего шага.# Настройте статусы отправки, соответствие полей и соответствие статусов.# Сохраните настройки.
Для отправки заказа обязательно должен быть заполнен вес хотя бы одного товараКроме того, для штрихкодов недопустима кириллица.
При заполнении информации по заказу поля '''Cтоимость доставки''', '''СуммаСтатусы''' . Запрашиваются интеграцией в автоматическом режиме. Изменение статуса на стороне Guru изменит и '''Ошибка''' заполнять не нужно. Они заполнятся автоматически после синхронизации статус заказа в соответствии с курьерской службойкартой статусов.
Если нужна доставка по адресу, оставьте поле '''Тип доставкиАгентская цена''' пустым. Иначе выберите ПВЗ из спискаОбновляется при получении статусов. Агентская цена Guru публикуется в разрезе стоимости услуг и тарифов, которые суммируются перед обновлением агентской цены в заказе.
Данные из поля '''КомментарийВозвраты''' передаются . Учитываются только при получении заказом статуса '''Частичная доставка'''.-->=== 5POST ===Параметры для настройки:* '''API-ключ'''* '''Код склада отправителя'''* '''Уникальный номер партнера в заказ автоматическисистеме 5Post'''* '''Максимальный вес для фиксированного тарифа''' - При привышении установленного веса, сумма тарифа изменяется пропорционально. По умолчанию 3кг.* '''Код подрядчика в карточке заказа''' - доступно три вида отображения кода подрядчика:<ul><ol><span style="color: blue; margin-right: 10px;">○</span> Оригинальный код 5post - Установлено по умолчанию</ol><ol><span style="color: blue; margin-right: 10px;">○</span> Код для поиска заказа в ЛК 5post</ol><ol><span style="color: blue; margin-right: 10px;">○</span> Код грузоместа</ol></ul>* '''Габариты мест'''<ul><ol><span style="color: blue; margin-right: 10px;">○</span> Группировать - Установлено по умолчанию<br>При установке этого значения, всегда передается только одно место с обобщенными габаритами и кодом соответствующим коду заказа.</ol><ol><span style="color: blue; margin-right: 10px;">○</span> Отправлять указанные<br>При установке этого значения, каждое место отправляется отдельно, с соответствующими ему габаритами и кодом.</ol></ul>
Чтобы отправить заказ, присвойте заказу статус для передачи в курьерскую службу. Заказ отправляется в курьерскую службу.* '''Тип расчета тарифа'''<ul><ol><span style="color: blue; margin-right: 10px;">○</span> Общий - Установлено по умолчанию</ol><ol><span style="color: blue; margin-right: 10px;">○</span> По местам</ol></ul>
Если после сохранения заказа в статусе для передачи в курьерскую службу статус не изменился, проверьте поле '''Ошибка'''. Заполните поля, указанные в поле '''Ошибка''', очистите поле '''Ошибка''' и сохраните заказ=== Яндекс. Доставка ===
Чтобы проверить, передан ли заказ в курьерскую службу, зайдите Для подключения к интеграции в Личный кабинет курьерской службы и проверьте вашем договоре с помощью вкладки '''Отслеживание'''Яндекс.Доставкой должна быть подключена услуга доставки на следующий день. Если у вас эта услуга не подключена, существует ли отправленный заказзаполните [https://forms.yandex.ru/surveys/10833592.0f3ead3120074ee64cd9dde1df70b27d8d2678d2/ эту форму].
Для настройки интеграции с платформой Яндекс.Доставка укажите следующие параметры:*'''Известные проблемыТокен''', можно посмотреть тут https://dostavka.yandex.ru/account/integration*'''ID пункта отправления''', необходимо уточнить у вашего менеджера или в поддержке яндекса
Модуль интеграции не работает Эти параметры обязательные и влияют на бесплатном тарифеотправку заказа. Доступы должны быть НЕ тестовые (продовые). Уточните эти данные у вашего менеджера или в поддержке Яндекс.Доставки.
При установке приложения в «Моем Складе» в нем регистрируется <rspoiler text="событие">веб-хук</rspoiler> на изменение заказа, чтобы «Мой Склад» передавал изменения в MeaSoft. Так работают все модули служб доставки для «Моего Склада». «Мой Склад» поддерживает только одно событие для заказа, поэтому, если оно занято другим <rspoiler text="установленным модулем">Или модуль может быть удален или не до конца установлен, а зарегистрированное событие от него осталось</rspoiler>, MeaSoft не сможет его занять, и отправка заказов работать не будет. Если у вас не отправляются заказы и вы уверены, что у вас нет других Для настройки модулей, использующих это событие, обратитесь к нам в службу поддержки, мы сможем проверить занятость события и при необходимости его освободить.используйте
===Wordpress==='''Логин''' - ваш токен.
====Требования к сайту ===='''Пароль''' - Код пункта отправления. Имеет вот такой формат 4eccdad3-8d97-4fbf-b241-3c2a89a8aa79
# CMS WordPress версии 5 или более новая;# WooCommerce версии 3.9 или более новая;# PHP версии 7 или более новая;# сайт должен использовать SSL'''Код курьерской службы''' -сертификат90023.
====Порядок установки плагина и вывод нового способа доставки в корзину ====
# В панели администратора сайта откройте страницу '''Плагины''' > '''Добавить новый''' и нажмите При создании заказа обратите внимание на кнопку '''Загрузить плагин'''адрес — он должен быть понятным.# В появившейся форме выберите архив с плагином на вашем компьютере и нажмите кнопку '''Установить'''.# После загрузки и установки плагина вы можете его активировать нажав на соответствующую кнопку.# После активации плагина в меню появится ссылка на страницу настроек плагина. Заполните все необходимые поля и нажмите кнопку '''Сохранить изменения'''.# Откройте настройки WooCommerce и переключите на вкладку '''Доставка'''.# Выберите необходимую зону доставки или создайте её.# Нажмите на кнопку '''Добавить метод доставки''' и выберите из списка '''КС2008'''.# После создания заказа в панели администратора в форме изменения заказа справа появится блок модуля '''Отправить в курьерскую службу''' с кнопкой '''Отправить заказ в КС2008'''Наиболее понятным для Яндекса будет адрес, где нет дополнительных комментариев, при нажатии на которую заказ будет отправлен в курьерскую службуа части адреса разделены запятыми.
====Обновление статусов====В интеграцию не принимаются заказы на юридические лица. Т.е. в поле ФИО должно быть именно ФИО, а не название организации.
Обновление статусов Отправка заказов происходит через технологию WP_Cron каждые 30 минутавтоматически. Если адрес не распознан и заказ не отправлен с первой попытки, интеграция попытается разобрать адрес доступными ей средствами и снова отправить заказ. Если заказ так и не получилось отправить, проверьте адрес получателя, возможно, в нем допущена ошибка. После исправления адреса заказ отправится автоматически.
При отправке заказа обязательно указываются места с габаритами и массой. Если статус заказа в курьерской службе изменен на '''Доставлен'''заказе указаны места, они добавляются как есть. Если мест в заказе нет, то статус заказа создается одно фиктивное место, габариты которого формируются на основе габаритов вложений. Вложения не разделяются по местам и попадают в вашем магазине также будет изменен на '''Выполнен'''первое сформированное место.
===Проверка работоспособности интеграций===После настройки модуля или создания новой интеграции ПВЗ появляются на следующий день.
При неполадках === Л-Пост ===Для настройки интеграции проверьте ее работоспособностьс платформой Л-Пост укажите следующие параметры:*'''Секретный ключ клиента''',*'''Код пункта приема''' - Не обязательный параметр. Заполнять параметр не нужно, если отправления сдаются на центральный склад Л-Пост (Родники, ул.Трудовая, д.10) или забираются со склада партнера силами Л-Пост .<br> В общем случае для этого достаточно создать заказ других случаях, в качестве точки приема отправлений могут выступать пункты выдачи заказов Л-Пост и отправить его в курьерскую службусклады Л-Пост.
Если заказ отправлен без ошибок и отображается в ЛК, значит, интеграция настроена. Если отправка не удалась, ошибка может быть в настройках интеграции или в заполнении формы отправки заказа.
Текст ошибки можно увидеть через [[Личный кабинет#Отладка|отладку]] При отправке заказа обязательно указываются места с габаритами и массой. Если в личном кабинетезаказе указаны места, они добавляются как есть. Чтобы найти свой заказ Если мест в запросахзаказе нет, нажмите клавиши CTRL + F то создается одно фиктивное место. Вложения не разделяются по местам и введите попадают в строку поиска номер заказа или ориентируйтесь на время создания заказапервое сформированное место.
Убедитесь, что выполнены все шаги инструкции по настройки интеграции из этого раздела.
 
Ниже представлено описание проверки работоспособности для разных интеграторов.
 
'''RetailCRM'''
 
# Убедитесь, что выполнены все шаги [[RetailCRM#Настройка интеграции|инструкции по настройке интеграции]].
# Если используются триггеры, убедитесь, что они настроены согласно [[RetailCRM#Настройка триггеров|инструкции]].
# Создайте заказ, заполните требуемые данные.
# Нажмите на кнопку '''Сохранить''' внизу страницы, флажок '''Не отправлять данные в службу доставки''' должен быть снят. Заказ должен отправиться в курьерскую службу.
# Если возникает ошибка, ее текст отображается наверху страницы.
:: Если это ошибка заполнения формы, исправьте внесенные данные и попробуйте отправить заказ снова. Пример ошибки: «Ошибка сервиса доставки "Курьерская служба 2008": field [receiver phone] has no valid phone number»
:: Если это ошибка ответа курьерской службы, сообщите об этом разработчику. Пример ошибки: «Служба доставки прислала ответ в неверном формате».
 
'''МойСклад'''
 
# При сбое интеграции проверьте, не изменен ли аккаунт, под которым создана интеграция:
## Логин учетных данных МойСклад, которые использовались при создании интеграции, вставьте в ссылку <nowiki>https://home.courierexe.ru/moysklad/step2?id=</nowiki>'''логин'''. Если при переходе по ссылке отображается этап настройки интеграции, значит аккаунт существует.
## Войдите в «МойСклад» под учетной записью, которая использовалась для настройки интеграции, и откройте справочник '''Сотрудники''': меню пользователя > '''Настройки''' > '''Справочники'''> '''Сотрудники'''. Откройте карточку сотрудника, под учетной записью которого вы вошли, и убедитесь, что его роль — администратор.
## Если хотя бы один из пунктов не выполнен, значит, аккаунт, использованный для создания интеграции, изменен.
# В личном кабинете клиента курьерской службы в настройках обратной интеграции '''Мой склад''' в поле '''В каком статусе "Мой склад" отправлять заказ на доставку''' уточните статус, при котором заказ отправляется в курьерскую службу.
# Заполните форму заказа, нажмите на кнопку '''Сохранить''', затем смените статус заказа на статус, установленный для отправки в курьерскую службу и снова нажмите на кнопку '''Сохранить'''. Если все верно, заказ будет отправлен в курьерскую службу.
# Обновите страницу в браузере и проверьте поле '''Строка для сохранения информации об ошибках''':
#* если поле пустое и заказ пришел в личный кабинет, интеграция работает;
#* если поле пустое и заказ не пришел в личный кабинет, обратитесь к разработчику;
#* если в поле содержится текст ошибки, исправьте ее в форме заказа и попробуйте отправить его снова.
'''InSales'''Обратите внимание, что в зависимости от настроек вашего аккаунта в Л-Пост может быть недоступна частичная оплата заказа.
# В личном кабинете клиента курьерской службы в настройках обратной === Omnic ===Для настройки интеграции '''InSales''' проверьте данные в следующих поляхс платформой Omnic укажите следующие параметры:#* '''Статус заказа для автоматической отправки в курьерскую службу''';#* '''Список доставок для отправления заказа в курьерскую службу (если отправляется автоматически)''';#* '''Оплачен ли заказ? (если отправляется автоматически)'''.# Создайте заказ и в случае ошибки проверьте данные заказа на соответствие этим полям. Например, в заказе может быть установлен тип доставки, не отмеченный как используемый в настройках в личном кабинете.
При возникновении ошибок при отправке заказа появляется диалоговое окно с сообщением об ошибке* '''Логин''' - создается самостоятельно, служит для доступа к [https://home. Исправьте ошибку в форме заказа и попробуйте отправить courierexe.ru/90025 ЛК экстраинтегратора], может быть любым, главное запомните его снова.
* '''amoCRMПароль'''является составным и обязательно должен содержать токен (получается в службе поддержки омника).
Ошибка при создании заказа отображается в левом нижнем углу.Так же может содержать
== Интеграция с платежными сервисами =='''ПВЗ отправления''' - код ПВЗ подрядчика, пункт самопривоза. <i>Не обязательный параметр</i>
Доступна интеграция со следующими сервисами:* PimPay — финансирование для интернет'''Приоритет тарифов''' -магазинов;* Robokassa — онлайн-оплата заказов;* ibox — мобильный эквайрингпоследовательность тарифов подрядчика, разделенная пробелами, указывающая доступность и приоритет тарифов в общем случае.<i>Не обязательный параметр</i>
Сервисы настраиваются в [[Личный кабинет курьерской службы#Вкладка «Финансы»|личном кабинете курьерской службы]].<br> Если омник забирает заказы у вас
=== Robokassa ===Пример cf3f645a5afc2e7ae030522711b4464af77dcb2d11997f1ddf5f1de81b003906<br>
Чтобы настроить прием платежей через сервис Robokassa:# Зарегистрируйтесь Если вы сами привозите отправления на склад или в сервисе [https://partner.robokassa.ru/Reg Robokassa]ПВЗ омника (самопривоз) пароль будет ТОКЕН, КОД ПУНКТА САМОПРИВОЗА.<br> # В [[Личный кабинет курьерской службы#Вкладка «Финансы»|настройках личного кабинета]] курьерской службы введите идентификатор магазина и пароли из личного кабинета Robokassa.# Установите флажок '''Тестовый режим''' и нажмите на кнопку '''Сохранить'''.# Откройте [[Личный кабинет курьерской службы#Отслеживание заказа по номеру|страницу отслеживания]] любого заказа с наложенным платежом и оплатой картой и убедитесьПример cf3f645a5afc2e7ae030522711b4464af77dcb2d11997f1ddf5f1de81b003906, что кнопка '''Оплатить картой''' появилась.MSK317# В настройках личного кабинета курьерской службы снимите флажок '''Тестовый режим''' и нажмите на кнопку '''Сохранить'''.<br>
В результате получатель может оплатить заказ онлайн на странице отслеживания httpsЕсли есть необходимость ограничить используемые тарифы, укажите те, которые можно использовать, в пароле://home.courierexe.ru/XX/tracking<br>Пример cf3f645a5afc2e7ae030522711b4464af77dcb2d11997f1ddf5f1de81b003906,MSK317, где XX — код вашей курьерской службы:,32 26<br>
Для настройки модулей в поле "Код клиента" укажите 90025. <br><br><div style="color: #a94442; background-color: #f2dede; border: 1px solid #ebccd1; padding: 3px 10px 10px;"><b>Внимание!</b><br> При использовании прямых интеграций и модулей необходимо использовать второй режим срочности [[Файл:Robokassa2] <b>Посылка. Алгоритмический тариф</b>.<br>В разных модулях может выбираться из списка или вводиться числом. При выборе другого режима срочности интеграции и модули могут работать не верно либо рассчитывать не все возможные варианты.png|none|900 px]]<br></div>
При успешной оплате заказ == Отмена заказов в MeaSoft отмечается интеграциях ==<div style="color: #a94442; background-color: #f2dede; border: 1px solid #ebccd1; padding: 3px 10px 10px;">Реализовано в интеграциях Почта России, 5Post, Gtd, СДЭК 2.0, YandexLogistic, LPost, Omnic.</div>Если корреспонденция была отправлена в интеграцию, но вы заметили ошибку в данных, либо из интеграции после отправки пришел отчет об ошибке (как оплаченныйнапример происходит в интеграции СДЭК версии 2.0), то корреспонденцию можно отправить по интеграции повторно, предварительно отменив ее предыдущую отправку. Для этого нужно произвести следующие действия:
В окне отслеживания Если ошибка очевидна:<br><ul><li>Отмените корреспонденцию в поле '''Наложенный платеж''' интеграции (Вкладка "Межгород" в карточке корреспонденции, кнопка "Отменить", нажатие кнопки "Сохранить" в карточке корреспонденции). При этом статус заказа изменится корреспонденции в интеграции сменится на '''Заказ оплачен'''. Чек по операции придет на электронную почту, указанную при заказе."Отменяется"<br><br>
=== PimPay ===
Чтобы начать работать с [https://pimpay.ru/ Pimpay]:
# Зарегистрируйтесь [http://platform.api.pimpay.ru/site/register http://platform.api.pimpay.ru/site/register в сервисе]. Далее Pimpay активирует вашу учетную запись.
# Cгенерируйте ключи шифрования. Это делается на [http://platform.api.pimpay.ru/v2_7/signature/openssl UNIX-подобной системе] или с помощью <rspoiler text="нашей инструкции">Чтобы получить приватный ключ, в командной строке выполните следующие команды:<br><br><code>openssl genrsa -out private.pem 2048</code> <br><br><code>openssl rsa -in private.pem -outform PEM -pubout -out public.pem</code><br><br>В результате вы получите 2 файла: public.pem и private.pem.<br>Содержимое файла public.pem — ваш публичный ключ. Скопируйте его целиком и вставьте в личном кабинете PimPay.<br>Содержимое файла private.pem скопируйте и вставьте в настройках интеграции с PimPay в личном кабинете курьерской службы.</rspoiler>. Если у вас нет специалиста, чтобы сгенерировать ключи, обратитесь за помощью в PimPay.
# В личном кабинете курьерской службы в разделе '''Управление ЛК''' > '''Параметры''' > '''Финансы''' заполните настройки Pimpay данными из личного кабинета Pimpay. Сохраните настройки.
# Зарегистрируйте каждого клиента, который хочет передавать данные в PimPay, в личном кабинете PimPay.
# В MeaSoft в карточке каждого клиента на [[Клиенты и партнеры#Финансы |вкладке '''Финансы''']] выберите платежного посредника '''PimPay'''.
При передаче данных привязка клиентов между системами производится по ИНН[[Файл:2023-04-03_11-26-09.png |700px]]<br><br><br>
В результате MeaSoft передает все заказы вашего клиента</li><li>Если заказ <i style="color:black; background-color:#e91e6326;"> не удалось отменить </i> на стороне подрядчика, их статусы и созданные [[Акты Передачи Денег и корреспонденции (АПДнапример, заказ уже находится в процессе доставки)|АПД]] , то статус заказа изменится на "<b>В работе у подрядчика</b>".В этом случае, изменение заказа возможно только в PimPay. PimPay ничего не передает личном кабинете подрядчика, либо обращением в ответ<i>техподдержку подрядчика</i>.<br><br>
Чтобы платежи в банк по АПД выгружались в адрес PimPay, создайте клиента с названием «PIMPAY» и заполните его реквизиты.
=== ibox ===[[Файл:2023-04-03_11-52-20.png |700px]]<br><br><br>
Мобильный эквайринг ibox доступен через приложение или <rspoiler text/li><li>Если заказ был <i style="SDKcolor:black; background-color:#dafbda;">SDK — это средства разработкиуспешно отменен </i> (в этом случае интеграция сама удалит заказ на стороне подрядчика), которые позволяют приложению MeaSoft взаимодействовать с POSто по истечении 1-терминалом напрямую.15 минут статус заказа в интеграции сменится на "<b>Отменен</rspoilerb>". Подробнее см<br>Ответственный филиал корреспонденции будет автоматически переключен на главный ответственный филиал, а код подрядчика (если он был присвоен) будет удален. раздел [[Мобильное приложение курьера для Android<br><i style="color:black; background-color:#ibox|«ibox»]]dafbda">Только после этого можно считать, что корреспонденция полностью отменена в интеграции</i> и можно приступать к ее повторной отправке.<br>
Для подтверждения успешной транзакции или отмены оплаты MeaSoft получает обратные вызовы (вебхуки) от ibox:
* при успешной оплате после установки статуса корреспонденции со слов курьера '''Доставлено''' или '''Частично доставлено''' в MeaSoft на вкладке '''Выдача''' подсвечивается поле '''Тип оплаты''':
** зеленым цветом, если оплата картой, есть идентификатор транзакции и сумма транзакции верная;
** желтым цветом, если оплата картой, есть идентификатор транзакции, но сумма транзакции не совпадает со значением поля '''Сумма руб''' в карточке корреспонденции;
** красным цветом, если оплата картой и нет идентификатора транзакции.
*: Если в карточке корреспонденции указан тип оплаты '''Наличными''', то поле будет закрашено красным, если есть идентификатор безналичной транзакции или указана ее сумма. Если их нет, то поле будет зеленым;
* при отмене оплаты обратный вызов удаляет идентификатор транзакции, чтобы сделать возможной повторную доставку и оплату заказа картой.
Чтобы настроить работу обратных вызовов:<br># В личном кабинете курьерской службы в разделе '''Управление ЛК''' > '''Параметры''' > '''Финансы''' в разделе '''Настройки эквайринга Ibox''' заполните поля[[Файл:#* '''ID клиента в системе ibox''' — номер компании в разделе '''Профиль''' в личном кабинете ibox;#* '''Логин для webhook ibox''' и '''Пароль для webhook ibox''' — придумайте логин и пароль для авторизации запросов ibox в MeaSoft. Логин и пароль могут состоять из цифр и латинских букв, длина не менее 5 символов.# Нажмите на кнопку '''Сохранить'''.# Обратитесь в техподдержку ibox с просьбой подключить вебхуки для MeaSoft и сообщите им придуманные вами логин и пароль2023-04-03_12-03-35.png |700px]]
== Диадок ==<br><br><br></li><li>Внесите исправления в данные корреспонденции. Сохраните ее.</li><li>Для повторной отправки корреспонденции по интеграции (предварительно убедившись, что все ошибки исправлены) вновь назначьте для корреспонденции ответственный филиал интеграции </li><li>После повторного назначения в корреспонденции ответственного филиала интеграции ожидайте сообщения об отправке. При повторной отправке этот процесс может занимать до 30 минут.</li><li>При возникновении ошибки, если она очевидна, вновь исправьте ошибку в корреспонденции и повторите процесс повторной отправки (отмена, исправление ошибок, повторное назначение на ответственный филиал интеграции)</li></ul>Если при получении ошибки от подрядчика нет понимания ее причин, пожалуйста напишите в нашу техподдержку.
=== Начальная настройка =Сквозная интеграция==
# Обратитесь в [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://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-ключ приобретается отдельно на каждое ваше юридическое лицо, поэтому его нужно вводить в '''Фирмы'''.# В системе Диадок откройте '''Настройки и оплата''' > '''Сотрудники''' и выберите сотрудника, который будет отвечать за подписание документов. В карточке сотрудника перейдите на вкладку '''Данные по сертификатам''' и в группе полей '''Область полномочий''' установите полномочия для входящих и исходящих документов. Нажмите на кнопку '''Сохранить'''.# Заполните данные подключения в системе: ## В переменной <mparam code="EDocProvider"/> выберите '''Диадок'''.## Введите API-ключ в '''Справочники''' > '''Фирмы''' > '''Карточка фирмы''' > '''Ключ ЭДО'''.## Если в вашем токене несколько сертификатов, в поле <mparam code="EDocLogin"/>укажите без пробелов значение отпечатка сертификата, который нужно использовать. Чтобы просмотреть отпечаток, в меню '''Пуск''' выберите '''Программы''' > '''Крипто-ПРО''' > '''Сертификаты пользователя''' > '''Личное''' > '''Сертификаты'''. Справа выберите нужный сертификат, откройте. Перейдите на вкладку '''Состав''', прокрутите список значений вниз, в самом низу выберите '''Отпечаток'''.## В поле <mparam code="EDocPass"/>введите пин-код сертификата. Если вы его не меняли, можно пропустить: по умолчанию пин-код рутокена «12345678», и программа сама будет его использовать, если вы ничего не указали. Если он окажется неправильным, Крипто-ПРО спросит у вас верный пин-код Сквозная интеграция предполагает передачу тарифов подрядчика при передаче данных. Обратите внимание, что количество попыток ввода пин-кода ограничено.# После ввода данных подключения выйдите из системы и запустить программу от имени администратора: в контекстном меню ярлыка MeaSoft выберите пункт '''Запуск от имени администратора'''. Чтобы осуществить обмен данными, выберите '''Связь''' > '''Обмен с ЭДО'''. При первом использовании программа установит на компьютер специальный COM-объект Диадока. Именно для этого нужны права. В дальнейшем она будет использовать уже установленный компонент, и наличия прав не требуетсясоздании заказа.
=== Обмен данными Чтобы настроить сквозную интеграцию между [[#Интеграция с ЭДО ===CMS-системами |CMS- или CRM-системой]] и подрядчиком [[#Тарификация и выбор подрядчика и его тарифа клиентом|из таблицы]]:* Создайте свой Личный кабинет для экстраинтеграции.<br>Для этого, достаточно единоразово войти в ЛК экстраинтеграции под своим логином и паролем https://home.courierexe.ru/XXX, где XXX — экстра-код партнера.<br><i>Логин</i> и <i>пароль</i>, - это данные из 3-го и 4-го параметров (см. таблицу ниже) [[#Тарификация и выбор подрядчика и его тарифа клиентом|Тарификация и выбор подрядчика и его тарифа клиентом]].* настройте [[Виды срочности|режим срочности]] для подрядчика.
Выберите в главном меню "Связь" Для сквозной тарификации заказов интернет-> "Обмен магазинов доступны следующие варианты:* курьерская служба, с ЭДО". Откроется окно с выпадающим списком фирмкоторой сотрудничает интернет-магазин, у которых заполнено поле "Ключ ЭДО"настраивает режим срочности для подрядчика. Выберите фирму, и нажмите "Обмен!". Программа выполнит все операции, которые периодически нужно выполнять, чтобы иметь актуальные данные как Интернет-магазин оформляет заказы в нашей системе так [[Личный кабинет клиента|личном кабинете клиента]] и в ЭДО:выбирает указанный режим срочности;*Синхронизирует справочники контрагентов: Получит список контрагентов, уже являющихся вашими партнерами интернет-магазины могут обратиться напрямую в ЭДО, проставит им соответствующие признаки (На вкладке "Клиенты" появилось новое поле "Статус ЭДО"MeaSoft для настройки сквозной тарификации. Это поле нельзя менятьВ этом случае нужно предварительно заключить договор на оказание услуг с выбранным подрядчиком, оно устанавливается автоматически), проверит, кто прислал вам приглашения к партнерству и примет их, разошлет приглашения всем вашим работающим контрагентам, проверит, кто принял приглашение, а кто - отказался.*Проверит статусы ранее отправленных документов. При подписании документа вашим партнером, сообщение получит статус "Доставлено". Если оно отправлено из счетов или АПД, то соответсвующий документ получит признак получения подписанного актасквозная тарификация позволит получать его цены.
=== Отправка документов =Тарификация и выбор подрядчика и его тарифа клиентом ==Вы можете настроить подключение своего тарифа к тарифу партнера — любой компании, работающей в системе MeaSoft, а также ряду компаний, с которыми у нас есть интеграции.
К отправке сейчас доступны счета=== Настройка интеграции ===Чтобы настроить подключение к тарифу партнера:# Зарегистрируйтесь в системе подрядчика. Данные аккаунта понадобятся для настройки интеграции.# Откройте '''Справочники''' > '''Статусы''' > '''17 Виды срочности''' и создайте [[Статусы#Виды срочности|вид срочности]], АПД например «СДЭК».# В контекстном меню вида срочности выберите пункт '''Дополнительная информация''' и АПК. Отправка работает крайне похоже на eво второй строке заполните параметры подключения к партнеру через запятую:#* 1-mailй параметр — код филиала партнера, его можно посмотреть в '''Справочники''' > '''Межгород''' > '''Филиалы'''. Документы формируются точно так же, но отправляются не почтой, а Можно в ЭДОодинарных кавычках указать несколько ответственных филиалов через запятую, уже подписанными вашей ЭЦПтогда режим срочности будет доступен для всех перечисленных филиалов. Для версии системы 2021.0.0. В системе ЭДО "адресами" отправителя 38 и получателя являются ИНН выше вместо кода филиала можно указать знак вопроса (по возможности еще КПП?), но это не обязательно) компании, поэтому, чтобы все работало, ИНН должен быть заполненобозначит доступность режима срочности для всех филиалов;#* 2-й параметр — экстра-код партнера в системе MeaSoft. Так же ЭДО примет документы только Коды для сторонних компаний приведены в таблице ниже;#* 3-й параметр — имя пользователя в адрес компаниисистеме партнера. Может отличаться от того, с которой у вас отмечены партнерские отношенияпод которым работает интеграция, тздесь нужно для расчета цены для клиента.е. ктоВ таблице ниже указано, что вводить для каждого интегратора;#* 4-то й параметр — пароль пользователя из вас отправил приглашение, а другой его принял3-го параметра. ПоэтомуВ таблице ниже указано, что вводить для удобства контроля каждого интегратора;#* 5- кому й параметр — вид срочности партнера. Посмотреть доступные коды видов срочности можно таким образом отправлятьпо ссылке в таблице ниже, а кому в калькуляторе в выпадающем списке. Можно в одинарных кавычках указать несколько видов срочности через запятую, тогда система будет стараться выбрать из них первый доступный;#* 6- нетй параметр — наценка к цене, передаваемой подрядчиком. В деньгах или в списках документов добавлено поле "Есть ЭДО"процентах, если стоит знак процента. Например, 10 — наценка 10 рублей, 10 % — наценка 10 процентов;#* 7-й параметр — если указать значение '''1''', сквозная тарификация выключена. Там галка ставится на основании статуса ЭДО клиентаПараметр используется, если подключение нужно только для передачи заказов по интеграции, а расчет цены не нужен. Можете отсортировать <br>В этом случае, при визуализации суммы по этому полюрежиму срочности, выдели всеотображается внутренний тариф, где есть галкиа подрядчику заказ отправляется другим тарифом, выбранным согласно настройке в 5-м параметре (вид срочности партнера).;#* 8-й параметр — если указать значение '''1''', среди указанных режимов срочности партнера выполняется поиск самого дешевого тарифа. Работает для СДЭК 1.5, Почты России и разослать всем документы по ЭДОOmnic# Нажмите на кнопку '''OK'''.
{|class="wikitable"!Интеграция!Код экстра!Виды срочности!Авторизация!Пример строки|-|БОКСБЕРРИ||90001||https://home.courierexe.ru/90001/calculator||3-й параметр - токен. 4-й - Код пункта приема, по умолчанию 010.<br>Можно оба параметра оставить пустыми для расчета базовых цен.||33, 90001, j3ejwo2f10b2e47790174b41f4a11111, 010, 2, 50|-|ПИКПОИНТ||90002||https://home.courierexe.ru/90002/calculator||3-й параметр — логин, 4-й — через запятую пароль и договор ИКН. Можно оставить пустыми, но цены будут не все.||33, 90002,us0111, '6rGGuqRsW2qNQ,9990721312', 2, 50|-|rowspan= Телефония "2"|СДЭК<br>(протокол обмена данными 1.5, поддержка прекращена с 01.01.2022)||rowspan="2"|90005||rowspan="2"|https://home.courierexe.ru/90005/calculator||Введите код учетной записи в 3-й параметр, секретный код — в 4-й. Можно оба оставить пустыми для расчета базовых цен.||45491, 90005, hfenJwlasiPr4pnFENpaVXSKPIn5Trh7i, '9vkQgWuiZgEj9fGCB8a6Xj3desnJkwsl,1.5', 5, 30%|-||Если вы хотите добавить в расчет тарифа процент за наложенный платеж, после пароля добавьте запятую и число процента. В настройке режима срочности пароль с числом процентов заключите в кавычки.||9vkQgWuiZgEj9fGCB8a6Xj3desnJkws,1.5|-|СДЭК<br>(протокол обмена данными 2.0)||90022||https://home.courierexe.ru/90022/calculator||3-й параметр — ID клиента, 4-й — ключ клиента.<br>Вы можете перечислить в пароле уточняющие параметры для расчета через запятую: <br><ul><li>не передавать объявленную ценность</li><li>добавлять услугу «Осмотр вложений»</li><li>процент за наложенный платеж</li><li>код пункта приема</li><li>процент за безналичный наложенный платеж</li></ul><br>Пример пароля: EMscd6r9JnFiQ3bLoyjJY6eM78JrJcee,1,1,2,MSK2,15||10497, 90022, EMscd6r7JnFyQ3bLoyjJY7eM78JrJceI, ‘Mscd6r9JnFiQ3bLoyjJY6eM78JrJcee,1,1,2,MSK2,15’, 1, 100|-|КСЭ||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 <!--10497, 90010, 89251234567, 'mypassword,u23B0r9AAJ1Fyh4ptMzJ3kjxcslamwdx', '2, 1', 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'|-|-|colspan="2"|ВНИМАНИЕ! У DPD есть 2 калькулятора, которые считают по-разному при одних и тех же вводных данных. При этом они не разглашают, по какому из расчетов определяют цену. Поэтому по не зависящим от нас причинам расчет по тарифам DPD может как совпасть с итоговым, так и сильно разойтись. Если вас это не устраивает, не используйте сквозную тарификацию с этим подрядчиком.|-<!--|DOSTAVKA.GURU||90017||https://home.courierexe.ru/90017/calculator||3-й параметр — ID партнера в системе DOSTAVKA.guru, 4-й — ключ доступа. Также можно указать признак отключения проверки интервала доставки. В этом случае необходимо указать ключ и "1" через запятую в кавычках. Можно оставить пустыми. ||10497, 90017, 9999, 'cc03e747a6afbbcbf8be7668acfebee5,1', '1', 100|- -->|5Post||90020||https://home.courierexe.ru/90020/calculator||3-й параметр — API-ключ,<br>4-й — уникальный номер партнера в системе 5post.<br>При необходимости в 4-м параметре можно через запятую указать параметры:<br><ul><li>пороговое значение веса (по умолчанию 3 кг).</li><li>Использовать штрихкод для отслеживания получателем</li><li>Код подрядчика в карточке заказа</li><li>Габариты мест</li><li>Тип расчета тарифа</li></ul><i>При указании параметров важно соблюдать последовательность.</i><br><i>Для вашего аккаунта в API 5post должна быть подключена возможность получать ПВЗ с вашими тарифами.</i><br>Пример пароля: 2123,7,,,,1||10497, 90020, u23B0r9AAJ1Fyh4ptMzJ3kjxcslamwdx,'2123,7,,,,1', '1,3', 100|-|GTD||90021||https://home.courierexe.ru/90021/calculator||3-й параметр — API-ключ, 4-й — пароль от личного кабинета https://home.courierexe.ru/90021. Предварительная авторизация по указанному URL обязательна.||10497, 90021, u23B0r9AAJ1Fyh4654MzJ3kjx1548wdx, pass, 100|-|Яндекс.Доставка||90023||https://home.courierexe.ru/90023/calculator||3-й параметр — токен,<br> 4-й — ID пункта отправления и через запятые интервал доставки.<br>Пример пароля: cfceadaa-4874-438a-999b-dbbafe5326ed,11:00,18:00||10497, 90023, AgAABBDzeAQMAAAPeISvM_9LUkxCijQoFXOH5QE, ‘cfceadaa-4874-438a-999b-dbbafe5326ed,11:00,18:00’, 1, 100|-|Л-Пост||90024||https://home.courierexe.ru/90024/calculator||3-й параметр — логин, который требуется создать самостоятельно, для входа в <i>[https://home.courierexe.ru/90024/ ЛК экстраинтеграции Л-Пост]</i> <br> 4- пароль, как Секретный ключ клиента<br> Дополнительно, есть возможность перечислить в пароле уточняющие параметры для расчета через запятую: <br><ul><li>Признак использования тестовой среды</li><li>Код пункта приема</li></ul><br>Пример пароля: YGNoaR3cG00JYg67,0,1010||10497, 90024, LoginTest, ‘YGNoaR3cG00JYg67,0,1010’, 1, 100|-|Omnic||90025||https://home.courierexe.ru/90025/calculator||3-й параметр — логин, который требуется создать самостоятельно, для входа в <i>[https://home.courierexe.ru/90025/ ЛК экстраинтеграции Omnic]</i> <br> 4- пароль, как Токен клиента<br> Дополнительно, есть возможность перечислить в пароле уточняющие параметры для расчета через запятую: <br><ul><li>Код пункта приема отправлений</li><li>Признак использования тестовой среды</li><li>Приоритет доступных тарифов через пробелы, - при указании алгоритмического тарифа, приоритет указанный в нем имеет преимущество</li></ul><br>Пример пароля: g67hjtTYjhgf765432,MCK45||10497, 90025, LoginTest, ‘g67hjtTYjhgf765432,MCK45,,21 22’, '3, 2', 100,,1|}
Основная статья: [[Интеграция с телефонией]]При выборе клиентом в личном кабинете вида срочности, подключенного таким образом к партнеру, набор доступных ПВЗ будет ограничен выбранным партнером.
== GPSВы можете войти в личный кабинет по адресу вида https://home.courierexe.ru/XXX, где XXX — экстра-трекинг автотранспорта ==код партнера, авторизоваться данными из 3-го и 4-го параметров (см. таблицу выше) и воспользоваться калькулятором с тарифами именно вашей компании.
Для поддержки GPS-трекинга автотранспорта у нас разработана интеграция === Настройка стоимости доставки для получателя ===При интеграции с коробочной системой Wialonподрядчиками, перечисленными в таблице выше, вы можете настроить стоимость и срок доставки, отображаемые для получателя:# Перейдите в личный кабинет по адресу вида https://home.courierexe.ru/XXX, на которой работают большинство компанийгде XXX — экстра-код партнера, предоставляющих подобные услугии авторизуйтесь данными из 3-го и 4-го параметров (см. таблицу выше).# Откройте пункт основного меню '''Цена доставки для получателя''' и настройте правила расчета цены и сроков доставки. Обратитесь в службу технической поддержки Подробнее см. раздел «[[Личный кабинет клиента#Цена доставки для получателя|Цена доставки для помощи в настройкеполучателя]]».
15
правок

Навигация