Изменения

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

=Виды интеграций= * Заказы:** передача между [[#Интеграция между двумя клиентами системами MeaSoft ==|двумя системами]] MeaSoft — клиент отправляет заказы другому агенту, агент доставляет отправления и передает их статусы, которые загружаются в систему клиента.;** передача заказов в стороннюю систему [[#Интеграция с подрядчиками|подрядчика]] через API и получение статусов доставки;** получение заказов из [[#Интеграция с CMS-системами|CRM- и CMS-систем]] интернет-магазинов и отправка статусов доставки;** [[#Сквозная интеграция|сквозная интеграция]]: получение цен подрядчиков при оформлении заказа;* [[Интеграция с платежными сервисами|платежные сервисы]]:** PimPay — финансирование для интернет-магазинов;** Robokassa — онлайн-оплата заказов и мобильный эквайринг;** Assist — мобильный эквайринг;** ibox — мобильный эквайринг;** Payme — онлайн-оплата заказов и мобильный эквайринг. Работает в Узбекистане;* электронный документооборот — [[Диадок]];* телефония — телефонный сервер [[Интеграция с телефонией|Asterisk]];* планирование маршрутов курьеров — [[Яндекс.Маршрутизация]], [[Максоптра]];* GPS-трекинг автотранспорта — [[Wialon]].

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

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

В этом случае ==Настройка==# Обе компании должны иметь аккаунты в системе MeaSoft ('''Справочники''' > '''Дополнительные модули''') и у обеих компаний должен быть установлен флажок '''Личный кабинет''' в окне «Управление дополнительными модулями».# Агент на вкладке '''Клиенты''' создает карточку клиента в своей системе. На вкладке '''Прочее''' [[Клиенты и партнеры#Прочее|карточки клиента]] указывает логин и пароль для входа в [[личный кабинет]] клиента.# Агент передает клиенту логин и пароль из предыдущего шага и свой [[Личный кабинет курьерской службы#Подключение|код экстра]] в системе MeaSoft.# Клиент создает в своей системе [[Филиалы|филиал]] для указанного агента. После создания филиала нужно настроить 2 подождать 3 минуты для синхронизации данных.# Клиент заходит в [[личный кабинет курьерской службы]] и на вкладке '''Подрядчики''' в таблице находит созданный филиал.# Клиент в строке подрядчика нажимает на кнопку [[Файл: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>  <i>Группа параметров, отвечающая за разделение заказов по потокам с разной авторизацией:</i>* '''Логин для заказов без чека''' и '''Пароль для заказов без чека'''* '''Определять заказы без чека по признаку''' - "Печатать чек - в карточке клиента" или "Спрашивать тип оплаты у получателя - в карточке клиента"В интеграции – наоборотMeasoft существует возможность отправлять заказы, распределяя их 2-м разными клиентами по принципу необходимости чека. Для этого в интеграции Measoft нужно заполнить параметры "Логин для заказов без чека" и "Пароль для заказов без чека"<br>Заказы, которые созданы клиентом '''с настройкой необходимости чека''' будут отправляться с авторизацией указанной в параметрах: <i style="color: #740474;">"Логин"</i> и <i style="color: #740474;">"Пароль"</i><br>Заказы, которым '''чек не требуется''' будут отправляться с авторизацией <i style="color: #740474;">"Логин для заказов без чека"</i> и <i style="color: #740474;">"Пароль для заказов без чека"</i><br>

Далее, клиент указывает остальные настройки при необходимости и нажимает '''Сохранить'''.</div>В результате такой настройки все отправления, у которых клиент установит «Ответственный филиал»укажет филиал агента в качестве ответственного филиала, соответствующий агенту (правильнее всего это будут переданы в систему MeaSoft агента, и статусы будут передаваться обратно. Правильный способ отправки заказов — через [[Манифесты|манифест]], скомплектовав его который нужно скомплектовать и проставив проставить дату отправки), будут переданы в БД агента, и статусы будут передаваться обратно. На передачу данных может уходить до 10 минут в штатном режиме и до 1 часа в случае возможных сбоев.

Для стабильной работы необходимо наличие версии MeaSoft минимум 518 от 05.12.2014 у обеих компаний. Для одного клиента может быть настроена только одна интеграция с агентом. ==Распределение заказов по признаку необходимости чека== Вы может распределять заказы по двум разным клиентам по принципу необходимости чека. Для этого агент создает в своей системе второго клиента для вашей компании, в карточке клиента на вкладке '''Прочее''' указывает логин и пароль, которые передает вам. В настройке интеграции Measoft (пункт 6 инструкции выше) заполните поля '''Логин для заказов без чека''' и '''Пароль для заказов без чека''' и выберите признак, по которому определяется необходимость чека, в поле '''Определять заказы без чека по признаку'''. Заказы, созданные клиентом, которому нужен чек, будут отправляться с авторизацией, указанной в полях '''Логин''' и '''Пароль'''. Заказы, которым чек не требуется, будут отправляться с авторизацией '''Логин для заказов без чека''' и '''Пароль для заказов без чека'''. = Интеграция со сторонними системами =Сторонними системами могут быть:* [[#Интеграция с подрядчиками|системы подрядчиков]], принимающие заказы на доставку;* [[#Интеграция с CMS-системами|CRM- и CMS-системы]] интернет-магазинов, передающие заказы в курьерскую службу. Интеграции со сторонними системами делаются в соответствии с документацией на момент написания, без партнерства с компаниями-поставщиками сервиса. Об изменениях API нас не оповещают, поэтому интеграции по не зависящим от нас причинам могут переставать работать, работать нестабильно или некорректно, вплоть до потери важной информации. Заказы, переданные во внешние системы, нужно обязательно проверять на корректность, пользуясь личным кабинетом партнера. По интеграции уходят только новые заказы, созданные в день настройки интеграции. == Интеграция с CMS-системами == '''Модули распространяются бесплатно, без гарантий со стороны разработчика''', и не являются средством полной автоматизации взаимодействия с курьерской службой. Модули — это помощь разработчикам интернет-магазинов в построении интеграции с курьерскими службами. '''Ответственность за корректность передачи данных лежит на интернет-магазине.''' Сообщайте нам свои пожелания по работе наших модулей. Мы учтем их в новых версиях. {| 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="width: 35%;"|Примечание|-|[[Файл:bitrix.png|center|x44px]]|style="text-align: center;" | [https://marketplace.1c-bitrix.ru/solutions/measoft.courier/ Установить] <!--[https://courierexe.ru/download/api/measoft.courier.zip Скачать] -->|Поддерживает версии 14.5 и выше. [[1C-Битрикс|Инструкция по настройке]].|-|[[Файл:prestashop.png|center|x60px]]|style="text-align: center;"|[https://courierexe.ru/download/api/prestashop.zip Скачать]|Поддерживает версии 1.5.2.0 и выше.|-|[[Файл:OpencartOCStore.png|center|x60px]]|style="text-align: center;"|[https://courierexe.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/download/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|Инструкция по настройке]].<br>[https://opencartforum.com/files/file/2906-avtomatizaciya-otpravki-i-otslezhivanie-dostavok-courierexe-dlya-opencart-15x/ Альтернативный модуль сторонних разработчиков]|-|[[Файл:webasyst-shopscript.png|center|x44px]]|style="text-align: center;"|[https://www.webasyst.ru/store/plugin/shop/measoftcourier/ Установить модуль]<br>[https://www.webasyst.ru/store/plugin/shipping/measoftcourier/ Установить плагин]|Модуль предназначен для отправки заявок в КС, а плагин для расчета стоимости доставки при оформлении заказа.|-<!--|[[Файл:advantshop.png|center|x44px]]|style="text-align: center;"|[https://promo-z.ru/ Сайт компании PROMO]|Компания PROMO разработала этот модуль и настраивает интеграцию MeaSoft с ADVANTSHOP своим клиентам.|- -->|[[Файл:insales.png|center|x80px]]|style="text-align: center;"|Настраивается в [[Личный кабинет клиента|ЛК пользователя]]|[[InSales|Инструкция по настройке]]|-|[[Файл: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|Инструкция по настройке]]<br>Модуль разработан и поддерживается компанией LeadVertex.|-|[[Файл:Retailcrm.png|center|x30px]]|style="text-align: center;"|[https://www.retailcrm.ru/ RetailCRM]|[[RetailCRM|Инструкция по настройке]]|-|[[Файл:1C.jpg|center|x44px]]|style="text-align: center;"|-|[https://infostart.ru/public/692790/ Альтернативный модуль сторонних разработчиков]|-|[[Файл:Joomla2.jpg|center|x60px]]|style="text-align: center;"|[https://courierexe.ru/download/api/com_measoft.zip Скачать]|Работает только с компонентом Virtuemart.|-|[[Файл:Amocrm.png|center|x44px]]|style="text-align: center;"|[https://www.amocrm.ru/extensions/courier2008 Установить]|[[amoCRM|Инструкция по настройке]].|-|rowspan="2"|[[Файл:MoySclad.jpg|center|x30px]]|style="height:50px; text-align: center;"|[https://home.courierexe.ru/moysklad/step1 Настроить интеграцию с MeaSoft]|[[МойСклад|Инструкция по настройке]]|-|style="height:50px; text-align: center;"|[https://itmdev.ru/ms/shipping/ Скачать модуль сторонних разработчиков]|Интеграция МойСклад с курьерскими службами от сторонних разработчиков|-|[[Файл:wordpress.jpg|center|x80px]]|style="text-align: center;"|[https://courierexe.ru/download/api/wordpress.zip Скачать]|[[Wordpress|Инструкция по настройке]]|-|[[Файл:Cscart.png|center|x60px]]|style="text-align: center;"|[https://marketplace.cs-cart.com/measoft-en.html Установить]|Поддерживает версии 4.10 и выше.<br>[[CS-Cart|Инструкция по настройке]]|-|} === Замечания ===# В модулях систем 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. Введенные данные потеряны не будут, карта после этого отобразится корректно.<!--=== Беру ===При интеграции поддерживается:* Обработка координат.-->=== Проверка работоспособности интеграций ===При неполадках интеграции проверьте ее работоспособность. В общем случае для этого достаточно создать заказ и отправить его в курьерскую службу. Если заказ отправлен без ошибок и отображается в ЛК, значит, интеграция настроена. Если отправка не удалась, ошибка может быть в настройках интеграции или в заполнении формы отправки заказа. Текст ошибки можно увидеть через [[Личный кабинет#Отладка|отладку]] в личном кабинете. Чтобы найти свой заказ в запросах, нажмите клавиши CTRL + F и введите в строку поиска номер заказа или ориентируйтесь на время создания заказа.

== Интеграция с подрядчиками (передача заказов) ==Убедитесь, что выполнены все шаги инструкции по настройки интеграции из этого раздела. Ниже представлено описание проверки работоспособности для разных интеграторов. '''RetailCRM''' # Убедитесь, что выполнены все шаги [[RetailCRM#Настройка интеграции|инструкции по настройке интеграции]].# Если используются триггеры, убедитесь, что они настроены согласно [[RetailCRM#Настройка триггеров|инструкции]].=== Отказ от ответственности ===# Создайте заказ, заполните требуемые данные.Интеграции со сторонними системами делаются # Нажмите на кнопку '''Сохранить''' внизу страницы, флажок '''Не отправлять данные в соответствии с документацией на момент написанияслужбу доставки''' должен быть снят. Заказ должен отправиться в курьерскую службу.# Если возникает ошибка, ее текст отображается наверху страницы.:: Если это ошибка заполнения формы, без партнерства с компаниями-поставщиками исправьте внесенные данные и попробуйте отправить заказ снова. Пример ошибки: «Ошибка сервисадоставки „Курьерская служба 2008“: field [receiver phone] has no valid phone number»:: Если это ошибка ответа курьерской службы, сообщите об этом разработчику. Об изменениях API нас Пример ошибки: «Служба доставки прислала ответ в неверном формате». '''МойСклад''' # При сбое интеграции проверьте, не оповещаютизменен ли аккаунт, поэтому под которым создана интеграция:## Логин учетных данных МойСклад, которые использовались при создании интеграции , вставьте в ссылку <nowiki>https://home.courierexe.ru/moysklad/step2?id=</nowiki>'''логин'''. Если при переходе по ссылке отображается этап настройки интеграции, значит аккаунт существует.## Войдите в «МойСклад» под учетной записью, которая использовалась для настройки интеграции, и откройте справочник '''Сотрудники''': меню пользователя > '''Настройки''' > '''Справочники'''> '''Сотрудники'''. Откройте карточку сотрудника, под учетной записью которого вы вошли, и убедитесь, что его роль — администратор.## Если хотя бы один из пунктов не зависящим от нас причинам могут переставать работатьвыполнен, значит, аккаунт, использованный для создания интеграции, изменен.# В личном кабинете клиента курьерской службы в настройках обратной интеграции '''Мой склад''' в поле '''В каком статусе «Мой склад» отправлять заказ на доставку''' уточните статус, работать нестабильно или некорректнопри котором заказ отправляется в курьерскую службу.# Заполните форму заказа, нажмите на кнопку '''Сохранить''', затем смените статус заказа на статус, установленный для отправки в курьерскую службу и снова нажмите на кнопку '''Сохранить'''. Если все верно, вплоть до потери важной заказ будет отправлен в курьерскую службу.# Обновите страницу в браузере и проверьте поле '''Строка для сохранения информации об ошибках''':#* если поле пустое и заказ пришел в личный кабинет, интеграция работает;#* если поле пустое и заказ не пришел в личный кабинет, обратитесь к разработчику;#* если в поле содержится текст ошибки, исправьте ее в форме заказа и попробуйте отправить его снова. '''InSales''' # В личном кабинете клиента курьерской службы в настройках обратной интеграции '''InSales''' проверьте данные в следующих полях:#* '''Статус заказа для автоматической отправки в курьерскую службу''';#* '''Список доставок для отправления заказа в курьерскую службу (финансовойесли отправляется автоматически)''';#* '''Оплачен ли заказ?(если отправляется автоматически) информации'''.# Создайте заказ и в случае ошибки проверьте данные заказа на соответствие этим полям. ЗаказыНапример, переданные во внешние системыв заказе может быть установлен тип доставки, нужно обязательно проверять на корректность, пользуясь личным кабинетом партнеране отмеченный как используемый в настройках в личном кабинете.

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

# Создайте Ошибка при создании заказа отображается в своей системе филиал ('''Справочники''' > '''Межгород''' > '''Филиалы''') для указанного агента. После ввода филиала нужно перезагрузить программу и подождать 3 минуты.# Зайдите в личный кабинет курьерской службы в системе MeaSoft. Чтобы узнать свои учетные данные, выберите '''Справочники''' > '''Дополнительные модули''': [[Файл:Measoft home.png|none|600px]]# В личном кабинете перейдите на закладку '''Интеграции'''. В таблице должен появиться созданный филиал.# Нажмите на кнопку '''Настроить''' напротив филиала, в открывшемся окне выберите нужную интеграцию.# Заполните форму по отображенной инструкции (для каждого интегратора форма и инструкции свои), нажмите '''Сохранить'''левом нижнем углу.

Если устанавливается == Интеграция с подрядчиками ===== Описание процесса интеграции ===Рассматривается интеграция между [[API#Готовые интеграции|CMS- или CRM-системой]] и подрядчиком [[Интеграция с другими системами#Тарификация и выбор подрядчика и его тарифа сторонних компаний (агентов), где система MeaSoft выступает клиентом|из таблицы]], при авторизации в [[Личный кабинет клиента|личном кабинете клиента]] укажите код клиентской службы подрядчика (столбец «Код экстра»)то есть передает заказы и получает обратно статусы.

В результате настройки все отправления, у которых клиент установит '''Ответственный филиал''', соответствующий агенту, будут переданы Компания-пользователь MeaSoft должна иметь аккаунт и личный кабинет в БД агента, и статусы будут передаваться обратносистеме MeaSoft. Подробнее см. раздел [[Личный кабинет курьерской службы#Подключение|«Личный кабинет курьерской службы»]].

Правильнее оформлять отправление как # Создайте в своей системе [[МанифестыФилиалы|манифестфилиал]]для агента. После ввода филиала нужно перезагрузить программу и подождать 3 минуты.# В личном кабинете курьерской службы на вкладке '''Интеграции''' в списке филиалов найдите созданный филиал и в его строке нажмите на кнопку '''Настроить'''.# В открывшемся окне в выпадающем списке выберите нужную интеграцию.# Заполните форму по отображенной инструкции, комплектовать его и проставить дату отправкинажмите '''Сохранить'''.

В результате настройки отправления, у которых клиент укажет филиал агента в качестве ответственного филиала, будут переданы в подрядчику и статусы будут передаваться обратно. Правильный способ отправки таких заказов — через [[Манифесты|манифест]], который нужно скомплектовать и проставить дату отправки. На передачу данных может уходить до 10 минут в штатном режиме и до 1 часа в случае возможных сбоев.

Это обязательные поля. Заказы отправляются в СДЭК при условии правильного корректного заполнения этих данных.

Оставшиеся Остальные поля служат для более тонкой настройки создания заказов:* '''Передавать объявленную стоимостьценность'''. Значение по умолчанию '''Да''', вы можете изменить это, выбрав одно из значений:** "Да"<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 API CDEK не включает в расчет сумму за наложенный платеж автоматически, но мы добавим указанный вами процент в итоговую сумму;* '''Использовать как номер '''. Номер заказа отображается в личном кабинете и отчетах СДЭК. Выберите удобный вариант: '''Шифр''' или '''Штрихкод''';* '''Код курьера'''. Укажите код курьера, который будет указан в поле '''Вручил курьер''' для доставленных заказов.* '''Способ доставки до ПВЗ отправления'''** "Самопривоз в офис СДЭК" - установлено по умолчанию, необходимо заполнить <b>Код пункта приема</b>** "Забор со склада" - в заказе указывается адрес склада с которого курьеры СДЭК забирают отправления. Адрес указывается в карточке ответственного филиала для которого настраивается интеграция со СДЭК вер.2.0** "Забор у отправителя" - в заказе указывается адрес отправителя с которого курьеры СДЭК забирают заказы.*** <i>Адрес из карточки клиента владельца фирмы отправителя</i> - если в ответственном филиале интеграции настроено "Скрывать отправителя"*** <i>Адрес отправителя из карточки заказа</i> - если он не пустой*** <i>Адрес из карточки отдела</i> - если пустой адрес отправителя в заказе*** <i>Адрес из карточки клиента отправившего заказ</i> - если пустой адрес отдела  <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>

[http://courierexe.ru/download/userfunc/SDEK_report_load.xml Загрузка отчета СДЭК] создает входящий АПД по отчету СДЭК [http://courierexe.ru/download/userfunc/SDEK_report_demo.xls такого формата]. Работает начиная с версии 626 от 29.01.2016 и только при передаче заказов в СДЭК с помощью штатной интеграции. Заполняет поле '''Агентская цена''' в карточке корреспонденции на вкладке '''Межгород'''.

Статусы заказов передаются корректноДля настройки интеграции с платформой DPD укажите следующие параметры:* '''Клиентский номер''' - уникальный клиентский номер в системе DPD.* '''Клиентский ключ''' - ключ для авторизации, полученный у сотрудника DPD.* '''Код пункта самопривоза''' - не обязательный параметр. код пункта самовывоза, только если куда клиент DPD доставляет заказ для одного аккаунта отправки.* '''Номер регулярного заказа''' - номер регулярного заказа DPD настроена одна интеграция. Если вам требуется настроить интеграцию для нескольких филиаловвы используете доставку на регулярной основе, предварительно создавайте новый аккаунт DPD для каждой интеграцииуточните этот номер у своего менеджера.* '''Проверка комплектности''' - по умолчанию отсутствует.Есть возможность выбрать одно из значений:

 Для настройки интеграции с платформой TopDelivery укажите:* '''Логин'''* '''Пароль'''* '''Информация о поставщике товара'''. Если указано '''Отправлять''', то при отправке заказа будет предпринята попытка отправить место с габаритами и товарами с указанием данных поставщика: ИНН, наименование, номер телефона. Если данных поставщика нет, информация об ошибке отправки мест будет добавлена в сообщение к заказу. Информация о поставщике повторно не отправляется.* '''Вскрытие отправления до получения оплаты''' - по умолчанию разрешено.<br>Возможность запрета вскрытия отправления добавляется при отправке заказа, если в настройках интеграции разрешен запрет и в заказе стоит отметка "Принято на склад" [[Файлы для загрузки#.D0.9F.D0.B5.D1.87.D0.B0.D1.82.D0.BD.D1.8B.D0.B5_B5 .D1.84.D0.BE.D1.80.D0.BC.D1.8B_8B .D0.B4.D0.BB.D1.8F_8F .D0.BC.D0.B0.D0.BD.D0.B8.D1.84.D0.B5.D1.81.D1.82.D0.BE.D0.B2|Печать наклеек для TopDelivery]]

Интеграция с Почтой России описана в разделе [[%D0%A0%D0%B0%D0%B1%D0%BE%D1%82%D0%B0_B0 %D1%81_81 %D0%9F%D0%BE%D1%87%D1%82%D0%BE%D0%B9_B9 %D0%A0%D0%BE%D1%81%D1%81%D0%B8%D0%B8|Работа с Почтой России]].

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

<b>Настройки интеграции:</b><br>* '''Логин''' - логин от ЛК КСЭ* '''Пароль''' - пароль от ЛК КСЭ* '''Данные отправителя''' -  — данные, которые будут подставляться во все отправления, передаваемые в КСЭ. Если не указать, то будут передаваться данные заказчика (отправителя) из корреспонденции.* '''Является ИМ''' -  — признак отправителя в системе КСЭ. От данного признака зависит главным образом, как отправляются данные в КСЭ. Признак указывается в договоре клиента с КСЭ.* '''Забор''' -  — настройка, в которой можно указать, каким образом отправление передается в КСЭ - КСЭ — КСЭ забирает отправление у клиента или клиент сам привозит отправление в КСЭ.** '''По умолчанию''' — груз будет принят для доставки в офисе (самопривоз в КСЭ) для всех заказов с товарной составляющей, иначе будет послан курьер для забора.** '''До двери''' — будет послан курьер для забора** '''Самопривоз в КСЭ''' — груз будет принят для доставки в офисе

При настройке '''Настройка'''. Для интеграции в CRM- или CMS-системе введите следующие учетные данные:* логин '''Идентификатор клиента''' — ID клиента DOSTAVKA.GURU. ID клиента отображается вверху страницы личного кабинета клиента DOSTAVKA.GURU;* пароль '''Ключ клиента''' — запросите API-ключ интеграции у DOSTAVKA.GURU;* код курьерской службы — 90017. == Тарификация и выбор подрядчика и его тарифа клиентом ==Вы можете настроить подключение своего тарифа к тарифу партнера — любой компании, работающей в системе MeaSoft, а также ряду компаний, с которыми у нас есть интеграции. === Настройка интеграции ===Чтобы настроить подключение к тарифу партнера:# Зарегистрируйтесь в системе подрядчика. Данные аккаунта понадобятся для настройки интеграции.# Откройте '''Справочники''' > '''Статусы''' > '''17 Виды срочности''' и создайте вид срочности, например «СДЭК».# В контекстном меню вида срочности выберите пункт '''Дополнительная информация''' и во второй строке заполните параметры подключения к партнеру через запятую:#* 1-й параметр — код филиала партнера, его можно посмотреть в '''Справочники''' > '''Межгород''' > Регион откуда повезется заказ'''Филиалы'''. Можно в одинарных кавычках указать несколько ответственных филиалов через запятую, тогда режим срочности будет доступен для всех перечисленных филиалов. Для версии системы 2021.0.0.38 и выше вместо кода филиала можно указать знак вопроса (?), это обозначит доступность режима срочности для всех филиалов;#* 2-й параметр — экстра-код партнера в системе MeaSoft. Коды для сторонних компаний приведены в таблице ниже;#* 3-й параметр — имя пользователя в системе партнера. Может отличаться от того, под которым работает интеграция, здесь нужно для расчета цены для клиента. В таблице ниже указано, что вводить для каждого интегратора;#* 4-й параметр — пароль пользователя Доступен выбор из 3-го параметра. В таблице ниже указано, что вводить для каждого интегратора;трех вариантов:#* 5-й параметр — вид срочности партнера. Посмотреть доступные коды видов срочности можно по ссылке в таблице ниже, в калькуляторе в выпадающем списке. Можно в одинарных кавычках указать несколько видов срочности через запятую, тогда система будет стараться выбрать из них первый доступный;<ul>#* 6-й параметр — наценка к цене, передаваемой подрядчиком. В деньгах или в процентах, если стоит знак процента. Например, 10 — наценка 10 рублей, 10% — наценка 10 процентов;#* 7-й параметр — если указать значение '''1''', сквозная тарификация выключена. Параметр используется, если подключение нужно только для передачи заказов по интеграции, а расчет цены не нужен;#* 8-й параметр — если указать значение '''1''', среди указанных режимов срочности партнера выполняется поиск самого дешевого тарифа. Пока работает только для СДЭК.# Нажмите на кнопку '''OK'''. {|class<ol><span style="wikitable"!Интеграция!Код экстра!Виды срочности!Авторизация!Пример строки|-|БОКСБЕРРИ||90001||httpscolor://home.courierexe.ru/90001/calculator||Введите токен в 4-й параметр. 3blue; margin-й можно оставить пустым. Можно оба оставить пустыми для расчета базовых цен.||33, 90001,, j3ejwo2f10b2e47790174b41f4a11111, 2, 50|-|ПИКПОИНТ||90002||httpsright://home.courierexe.ru/90002/calculator||3-й параметр — логин, 4-й — через запятую пароль и договор ИКН. Можно оставить пустыми, но цены будут не все.||33, 90002,us0111, '6rGGuqRsW2qNQ,9990721312', 2, 50|-|rowspan=10px;"2"|СДЭК>○<br/span>По договору (протокол обмена данными 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%|-||Если вы хотите добавить в расчет тарифа процент за наложенный платеж, после пароля добавьте запятую систему Guru и число процента. В настройке режима срочности пароль регион определяется договором с числом процентов заключите в кавычкиDOSTAVKA.||9vkQgWuiZgEj9fGCB8a6Xj3desnJkws,1.5|-|СДЭКGURU)<br/ol>(протокол обмена данными 2.0)||90022||https://home.courierexe.ru/90022/calculator||3-й параметр — ID клиента, 4-й — ключ клиента.<brol>Вы можете перечислить в пароле уточняющие параметры для расчета через запятую: не передавать объявленную ценность, добавлять услугу «Осмотр вложений», процент за наложенный платеж, код пункта приема.<br>Пример пароляspan style="color:EMscd6r9JnFiQ3bLoyjJY6eM78JrJcee,1,1,2,MSK2||10497, 90022, EMscd6r7JnFyQ3bLoyjJY7eM78JrJceI, ‘Mscd6r9JnFiQ3bLoyjJY6eM78JrJcee,1,1,2,MSK2’, 1, 100|blue; margin-|КСЭ||90008||httpsright:10px;">○</span> Москва</home.courierexe.ru/90008/calculator||Введите логин в 3-й параметр, пароль — в 4-й. Пустыми оставить нельзя.||12504, 90008, Рога и копыта, 4CCB11864D06157, '2, 3, 6', 10%|-ol>|ПОЧТА РОССИИ||90010||https://home.courierexe.ru/90010/calculator||Без авторизации||10497, 90010,,, '2, 1', 10 <!--10497, 90010, 89251234567, 'mypassword,u23B0r9AAJ1Fyh4ptMzJ3kjxcslamwdx', '2, 1', 10--ol>|-|rowspan<span style="3"|DPD||rowspan="3"|90011||rowspan="3"|httpscolor://home.courierexe.ru/90011/calculator||Введите клиентский номер в 3blue; margin-й параметр, клиентский ключ в 4-й. Можно оставить пустыми для базовых тарифов.||12504, 90011, 1019003662, '4CCB11864D06157A5934A9119F2A0AAAAAB4CCE8,D117', '3, 6', 10%|-||Если вы доставляете товар в пункт отправления самостоятельно, после пароля добавьте запятую и код ПВЗ, а в настройке режима срочности введите пароль в кавычках.||'4CCB11864D06157A5934A9119F2A0AAAAAB4CCE8,D117'|-|-|colspan="2"|ВНИМАНИЕ! У DPD есть 2 калькулятора, которые считают по-разному при одних и тех же вводных данных. При этом они не разглашают, по какому из расчетов определяют цену. Поэтому по не зависящим от нас причинам расчет по тарифам DPD может как совпасть с итоговым, так и сильно разойтись. Если вас это не устраивает, не используйте сквозную тарификацию с этим подрядчиком.|-|DOSTAVKA.GURU||90017||httpsright://home.courierexe.ru/90017/calculator||3-й параметр — ID партнера в системе DOSTAVKA.guru, 4-й — ключ доступа. Также можно указать признак отключения проверки интервала доставки. В этом случае необходимо указать ключ и 10px;"1" через запятую в кавычках. Можно оставить пустыми. ||10497, 90017, 9999, 'cc03e747a6afbbcbf8be7668acfebee5,1', '1', 100|-|5Post||90020||https:>○<//home.courierexe.ru/90020/calculator||3span> Санкт-й параметр — API-ключ, 4-й — уникальный номер партнера в системе 5post. При необходимости в 4-м параметре можно через запятую указать пороговое значение веса (по умолчанию 3 кг). Пустыми оставить нельзя. Для вашего аккаунта в API 5post должна быть подключена возможность получать ПВЗ с вашими тарифами.||10497, 90020, u23B0r9AAJ1Fyh4ptMzJ3kjxcslamwdx, 1, 100|-|GTD||90021||https:Петербург<//home.courierexe.ru/90021/calculator||3-й параметр — API-ключ, 4-й — пароль от личного кабинета https://home.courierexe.ru/90021. Предварительная авторизация по указанному URL обязательна.||ol>10497, 90021, u23B0r9AAJ1Fyh4654MzJ3kjx1548wdx, pass, 100|-|YandexLogistic||90023||https:<//home.courierexe.ru/90023/calculator||3-й параметр — токен, 4-й — ID пункта отправления и через запятые интервал доставки.<brul>Пример пароля: cfceadaa-4874-438a-999b-dbbafe5326ed,11:00,18:00||10497, 90023, AgAABBDzeAQMAAAPeISvM_9LUkxCijQoFXOH5QE, ‘cfceadaa-4874-438a-999b-dbbafe5326ed,11:00,18:00’, 1, 100|} При выборе клиентом в личном кабинете вида срочности, подключенного таким образом к партнеру, набор доступных ПВЗ будет ограничен выбранным партнером.

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

=== Настройка стоимости доставки Сокращенный список недопустимых символов для получателя ==текстовых полей:<code>['~', '`', '@', '#', '$', '%', '^', '&', '=', '+', '!', '"', '№', ';', ':', '?', '\']</code>

При интеграции с подрядчикамиПолный список недопустимых символов:<code>['~', перечисленными в таблице выше'`', вы можете настроить стоимость и срок доставки'@', отображаемые для получателя:'# Перейдите в личный кабинет по адресу вида https', '$', '%', '^', '&', '=', '+', '!', '"', '№', ';', '://home.courierexe.ru/XXX', '?', '\', '\s', где XXX — экстра-код партнера'*', и авторизуйтесь данными из 3-го и 4-го параметров '(см. таблицу выше).# Откройте пункт основного меню ', '_', '{'Цена доставки для получателя, '}', ' и настройте правила расчета цены и сроков доставки. Подробнее см. раздел ', ',', '\[[Личный кабинет клиента#Цена доставки для получателя|«Цена доставки для получателя»', '\]', '\']. == Интеграция с CMS-системами (получение заказов) ==</code>

# В модулях систем '''PrestaShopСтатусы''' и '''Joomla''' для отправки заказа в курьерскую службу зайдите в карточку заказа. В карточке отображается специальная форма отправки заказа, а если заказ отправлен, она позволяет проверить его статус. [[Файл:Form.png|400 px|Форма отправки заказа|none]]# Оформление заказов до '''ПВЗ''' Запрашиваются интеграцией в модулях '''PrestaShop''' и '''Joomla''' не реализованоавтоматическом режиме. Чтобы оформить такой заказ, в поле передаваемого адреса укажите одно из значений:#* код ПВЗ, который можно посмотреть в ЛК клиента или Изменение статуса на сайте агента (Boxberry, CDEK стороне Guru изменит и т.п.). Обычно это цифровой или цифро-буквенный код;#* наименование ПВЗ, добавив в начале строку "ПВЗ ", например '''ПВЗ На Ленина'''.# Поддерживается передача маркировки [[Маркировка|«Честный ЗНАК»]] из InSales и RetailCRM. Информацию по настройке см. статус заказа в документации [https://www.insales.ru/collection/doc-zprochee/product/prodazha-tovarov-s-markirovkoy-487-fz Insales] и [https://help.retailcrm.ru/Users/MarkingOfGoods RetailCRM].# При проблемах соответствии с отображением карты в модулях очистите кэш браузера: например, для Google Chrome нажмите CTRL+F5. Введенные данные потеряны не будут, карта после этого отобразится корректнокартой статусов.

'''Возвраты'''. Учитываются только при получении заказом статуса '''Частичная доставка'''.-->===5POST === OpenCart 1Параметры для настройки:* '''API-ключ'''* '''Код склада отправителя'''* '''Уникальный номер партнера в системе 5Post'''* '''Максимальный вес для фиксированного тарифа''' - При привышении установленного веса, сумма тарифа изменяется пропорционально.5По умолчанию 3кг.5.1 * '''Код подрядчика в карточке заказа''' - доступно три вида отображения кода подрядчика:<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>

Важно! Перед любыми изменениями настроек рекомендуется сделать резервную копию сайта.Для настройки синхронизации:# Загрузите содержимое папки upload из архива в папку сайта по FTP. При необходимости подтвердите замену файлов.# Зайдите в панель администратора OpenСart. Подробнее см. в [https://docs.ocstore.com/index.php?title=Панель_Администратора документации OpenCart].# В меню панели управления выберите * '''Дополнения''', раздел Тип расчета тарифа'''Модули'''. В открывшемся списке найдите '''КС2008''' и нажмите на кнопку '''Установить'''.# В меню панели управления выберите '''Дополнения''', раздел '''Доставка'''. В открывшемся списке найдите '''Основные настройки интеграции КС2008''' и нажмите на кнопку '''Установить'''. Рядом появится кнопка '''Изменить'''.<ul># Нажмите на кнопку '''Изменить'''. Откроется страница «Основные настройки интеграции КС2008»<ol><span style="color:[[Файлblue; margin-right:OpenCart.png|900px|none]]10px;">○</span> Общий - Установлено по умолчанию</ol><brol>Заполните обязательные поля<span style="color:blue; margin-right: 10px;">○</span> По местам</ol>#* '''Логин''' — логин пользователя, выдается курьерской службой.#* '''Пароль''' — пароль пользователя, выдается курьерской службой.#* '''Код курьерской службы''' — выдается курьерской службой.#* '''Город отправителя'''. После ввода убедитесь, что в названии населенного пункта нет ошибок.<br/ul>При необходимости заполните остальные поля. Нажмите на кнопку '''Сохранить'''.# В меню панели управления выберите '''Дополнения''', раздел '''Доставка'''. В открывшемся списке найдите '''Настройки доставки курьером КС2008''' и нажмите на кнопку '''Установить'''. Рядом появится кнопка '''Изменить'''.# Нажмите на кнопку '''Изменить''' и в поле '''Тариф для расчета стоимости доставки''' выберите нужный тариф. По умолчанию используется первое значение выпадающего списка.

==== OpenCart 2Яндекс.0 и выше =Доставка ===

===== Настройка Для подключения к интеграции =====в вашем договоре с Яндекс.Доставкой должна быть подключена услуга доставки на следующий день. Если у вас эта услуга не подключена, заполните [https://forms.yandex.ru/surveys/10833592.0f3ead3120074ee64cd9dde1df70b27d8d2678d2/ эту форму].

# Скачайте [[API#Готовые интеграции|установочный файл]] для нужной версии OpenCart.# Зайдите в панель администратора OpenСart. Подробнее см. в [https://docs.ocstore.com/index.php?title=Панель_Администратора документации OpenCart].# В панели управления OpenCart выберите '''Установка дополнений''' ('''Установка расширений''') и на странице «Установщик дополнений OCMOD» нажмите на кнопку '''Загрузить'''.# В открывшемся диалоговом окне выберите загруженный файл в формате ZIP и нажмите на кнопку '''Продолжить'''.<br>Когда загрузка будет окончена, индикатор загрузки в поле '''Выполнение''' станет зеленым.<br>'''Примечание'''. Убедитесь, что название файла оканчивается на «ocmod.zip». Названия вида «ocmod(2).zip» и подобные приведут к ошибкам загрузки файла.# В панели управления выберите '''Менеджер дополнений''' ('''Модификаторы''') и в правом верхнем углу страницы нажмите на кнопку '''Обновить'''.# Для OpenCart 2.0 и выше: в панели управления выберите '''Дополнения''' ('''Расширения'''), раздел '''Доставка'''.<br>Для OpenCart 3.0 и выше: в меню панели управления в разделе '''Расширения''' выберите '''Расширения''' и на странице '''Список расширений''' в выпадающем списке выберите '''Доставка'''.<br>В открывшемся списке найдите '''Основные настройки интеграции КС2008''' и нажмите на кнопку '''Установить'''с платформой Яндекс. Рядом станет активна кнопка '''Редактировать'''.# Нажмите на кнопку '''Редактировать'''. Откроется страница «Основные настройки интеграции КС2008».# Заполните обязательные поляДоставка укажите следующие параметры:#* '''ЛогинТокен''' — логин пользователя, выдается курьерской службойможно посмотреть тут https://dostavka.#* '''Пароль''' — пароль пользователя, выдается курьерской службойyandex.ru/account/integration#* '''Код курьерской службыID пункта отправления''' — выдается курьерской службой.#* '''Наценка на доставку (множитель)''' — множитель наценки на стоимости доставки. Если наценки нет, установите 0.#* '''Наценка на доставку (добавочная)''' — конкретная величина наценки на стоимость доставки. Если наценки нет, установите 0.#* '''Ваш город''' — город отправителя. После ввода убедитесь, что необходимо уточнить у вашего менеджера или в названии населенного пункта нет ошибок.<br>При необходимости заполните остальные поля. Нажмите на кнопку '''Сохранить''' в правом верхнем углу.# В разделе '''Доставка''' найдите '''Настройки доставки курьером КС2008''' и нажмите на кнопку '''Установить'''. Рядом станет активна кнопка '''Редактировать'''. # Нажмите на кнопку '''Редактировать''' и в поле '''Тариф для расчета стоимости доставки''' выберите нужный тариф. По умолчанию используется первое значение выпадающего списка.поддержке яндекса

===== Изменение данных Эти параметры обязательные и влияют на отправку заказа =====. Доступы должны быть НЕ тестовые (продовые). Уточните эти данные у вашего менеджера или в поддержке Яндекс.Доставки.

# В административной части сайта откройте заказ и вверху справа нажмите на кнопку [[Файл:OpenCartEdit.png|25 px]].# В режиме редактирования данные заказа представлены на пяти вкладках. Измените данные, для перемещения по вкладкам Для настройки модулей используйте кнопки '''Продолжить''' и '''Назад'''.# На вкладке '''Итоги''' проверьте введенные данные и нажмите на кнопку '''Применить''' для сохранения изменений в каждой строке.# Нажмите на кнопку '''Сохранить'''.

* Ошибка локализации. Чтобы переключить язык сайта на русский, сверьте названия папок локализации в скачанном архиве модуля (\upload\admin\language) и в созданном после установки модуля каталоге. Названия папок должны быть одинаковыми, например ru-ru и en-gb. Если в результате установки появилась папка с другим именем, перенесите ее содержимое в нужную папку.* При возникновении ошибок:*# В панели управления выберите '''Менеджер дополнений''' ('''Модификаторы''') и в правом верхнем углу страницы нажмите на кнопку '''ОбновитьПароль'''- Код пункта отправления.*# Очистите кэш везде — в панели состояния, в дополнительных модулях, в браузере и т.п.*# Проверьте работу модуля.*: Для OpenCart 3.0 и выше с установленным модулем Simple установите [https://courierexe.ru/download/api/liveopencart.modtwigfix30356.ocmod.zip| модификатор] и выполните шаги 1Имеет вот такой формат 4eccdad3-8d97-4fbf-b241-3.3c2a89a8aa79

=== 1C'''Код курьерской службы''' -Битрикс===90023.

# В личном кабинете 1C-Битрикс на вкладке '''Администрирование''' в панели слева выберите '''Marketplace''' > '''Каталог решений''' и на странице «Каталог Маркетплейс» с помощью строки поиска найдите '''Модуль интеграции MEASoft'''.# Щелкните по ссылке «Установить».# Убедитесь, что в строке '''Модуль интеграции MEASoft''' установлен флажок, и нажмите на кнопку '''Загрузить'''. Далее примите лицензионное соглашение и нажмите '''Применить'''.# После окончания загрузки нажмите При создании заказа обратите внимание на кнопку '''Установить'''.# В панели слева выберите '''Магазин''' > '''Настройки''' > '''Службы доставки''', затем на странице «Список служб доставок» раскройте выпадающий список кнопки '''Добавить''' и выберите пункт '''Автоматизированная служба доставки'''. Откроется страница «Новая служба доставки».# На странице «Новая служба доставки» перейдите на вкладку '''Настройки обработчика''' и в выпадающем списке '''Служба доставки''' выберите '''"Курьерская служба" - сервис доставки'''. Нажмите на кнопку '''Применить'''.# Перейдите на вкладку '''Настройки интеграции''': [[Файл:Bitrix Настройки интеграции.png|none|800px]]#: На этой вкладке:#* в разделе '''Настройки доступа''' введите учетные данные личного кабинета в поля '''Логин''', '''Пароль''' и '''Код клиента'''. Запросите эти данные у курьерской службы, с которой настраивается интеграция. Кнопка '''Проверить''' предназначена для проверки введенных учетных данных.#* в разделе '''Основные настройки''':#** в поле '''Оплата картой''' выберите тип оплаты, который будет соответствовать оплате картой (если оплата картой возможна);#** установите флажок '''Использовать артикулы''', если артикулы будут использоваться для привязки номенклатуры к складу курьерской службы;#* в разделе '''Соответствующие поля покупателя''' настройте соответствие полей получателя (ФИО, города, адреса и драдрес — он должен быть понятным.) полям в форме создания заказа;#* для работы с товарами, [[Маркировка|маркированными]] кодом «Честный ЗНАК», в разделе '''Соответствующие поля товаров''' укажите поле Наиболее понятным для хранения кода;#* в разделе '''Статусы отправки заказа''' выберите статусы, при которых заказ Яндекса будет автоматически отправлен в курьерскую службу.# На вкладке '''Ценовая политика доставки''' при необходимости настройте стоимость доставки для покупателя в зависимости от стоимости заказа.# На вкладке '''Ограничения''' при необходимости укажите ограничения работы модуля по географииадрес, типам оплаты и т.п.# По завершении настройки нажмите на кнопку '''Сохранить'''.# В настройках магазина укажите его местоположение для определения города отправителя.#: Если нужно производить расчет для другого города отправителя (например, физически магазин находится в областигде нет дополнительных комментариев, а курьерская служба должна считать доставку, как по городу):#* в разделе '''Рабочий стол''' > '''Настройки''' > '''Настройки продукта''' > '''Настройки модулей''' > '''Курьерская служба''' в поле '''Города-отправители''' добавьте город отправителя;#* в разделе '''Рабочий стол''' > '''Магазин''' > '''Настройки''' > '''Службы доставки''' > Нужная служба > '''Настройки интеграции''' > '''Город отправитель''' укажите добавленный выше городчасти адреса разделены запятыми.

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

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

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

==== Передача наложенного платежа =Л-Пост ===Для настройки интеграции с платформой Л-Пост укажите следующие параметры:*'''Секретный ключ клиента''',*'''Код пункта приема''' - Не обязательный параметр. Заполнять параметр не нужно, если отправления сдаются на центральный склад Л-Пост (Родники, ул.Трудовая, д.10) или забираются со склада партнера силами Л-Пост .<br> В других случаях, в качестве точки приема отправлений могут выступать пункты выдачи заказов Л-Пост и склады Л-Пост.

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

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

Если статус уже установлен, но заказ не отправлен в курьерскую службу (связано с техническими особенностями):# Выберите статус заказа по умолчанию после его создания (например, * '''НовыйЛогин''')- создается самостоятельно, служит для доступа к [https://home.# Перезагрузите страницуcourierexe.# Выберите статус отправки и сохраните ru/90025 ЛК экстраинтегратора], может быть любым, главное запомните его.При отправке заказа появится сообщение об успешной отправке или об ошибке.Статус заказа можно проверить в карточке заказа, в правом верхнем углу.

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

Свойство будет показано всегда'''Приоритет тарифов''' - последовательность тарифов подрядчика, если привязка не выбрана или если выбраны все варианты платежных систем или служб доставкиразделенная пробелами, указывающая доступность и приоритет тарифов в общем случае.<i>Не обязательный параметр</i>

=== InSales ===Пример cf3f645a5afc2e7ae030522711b4464af77dcb2d11997f1ddf5f1de81b003906Для удобства работы до настройки интеграции создайте в InSales следующие пользовательские статусы:* статус для автоматической передачи заказов в курьерскую службу,* статус для обозначения заказа с ошибкой передачи данных.Чтобы настроить статусы, в панели администрирования InSales выберите '''Настройки''' > '''Оформление заказа''' <br> '''Пользовательские статусы''' и создайте статусы, например «Передано в КС» и «Ошибка».

# В личном кабинете InSales откройте '''Приложения''' > '''Центр приложений'''Если есть необходимость ограничить используемые тарифы, с помощью строки поиска найдите модуль «Курьерская служба 2008» и нажмите на кнопку '''Установить'''.# Откроется личный кабинет InSales. На странице «Установка приложения» нажмите на кнопку '''Установить'''.# В списке установленных приложений выберите «Модуль "Курьерская служба 2008"». Откроется страница авторизации личного кабинета клиента курьерской службы. Если вы авторизованы в ЛК курьерской службыукажите те, то сразу откроется страница настроеккоторые можно использовать, см. п. 5.# Введите учетные данные личного кабинета в поля '''Логин''', '''Пароль''' и '''Код курьерской службы'''. Запросите эти данные у курьерской службы, с которой настраивается интеграция.# На странице «Настройка интеграции Insales» выполните настройку интеграции.пароле: <br>Особенности заполнения полей:#* '''Статус заказа для автоматической отправки в курьерскую службу'''. Выберите из выпадающего списка заранее созданный статусПример cf3f645a5afc2e7ae030522711b4464af77dcb2d11997f1ddf5f1de81b003906, при установке которого заказ автоматически отправляется в курьерскую службуMSK317, или значение '''Не отправлять'''.#* '''Отправлять артикулы (для привязки к складу)'''. Если опция включена, артикулы товаров из InSales передаются в MeaSoft. 32 26#* '''Название доставки курьером на странице заказа'''. Укажите название доставки, которое будет отображаться в заказе вместо «Курьерская доставка МЕАСОФТ» при выборе способа доставки. Можно оставить поле пустым, тогда список будет выглядеть следующим образом:[[Файл:Insales Delivery.png|none|800 px]]#* '''Описание доставки курьером на странице заказа'''. Укажите описание вида доставки. Можно оставить поле пустым.#* '''Синхронизировать остатки по складам'''. Если опция включена, данные по складским остаткам из курьерской службы передаются в InSales.#* '''Используется мультисклад?'''. Определяет, используется ли выбор товаров с одного склада или из нескольких. Возможные значения: '''Да''', '''Нет'''. В случае работы с несколькими складами убедитесь, что в настройках InSales ('''Настройки''' > '''Настройки магазина''' <br> '''Мультисклад'''.) указано такое же количество складов, как в системе MeaSoft.#* '''Статус заказа при ошибке передачи в курьерскую службу'''. Выберите из выпадающего списка заранее созданный статус, который будет использоваться для обозначения заказов с ошибкой передачи данных, или укажите значение '''Не отправлять'''.#* '''Производить расчет без адреса?'''. Если выбрано значение '''Нет''', расчет стоимости доставки возможен только после ввода полного адреса получателя.# По заполнении нужных полей нажмите '''Сохранить'''.

В результате Для настройки модулей в InSales в окне создания заказа появляется блок «Модуль поле "Код клиента"Курьерская служба 2008укажите 90025. <br><br><div style="»color:#a94442; background-color: #f2dede; border:1px solid #ebccd1; padding:3px 10px 10px;"><b>Внимание!</b><br> При использовании прямых интеграций и модулей необходимо использовать второй режим срочности [[Файл:Insales Module KS2] <b>Посылка. Алгоритмический тариф</b>.<br>В разных модулях может выбираться из списка или вводиться числом. При выборе другого режима срочности интеграции и модули могут работать не верно либо рассчитывать не все возможные варианты.png|none|300 px]]<br></div>

==Отмена заказов в интеграциях == Настройка типов оплаты ===<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>Отмените корреспонденцию в интеграции (Вкладка "Межгород" в карточке корреспонденции, то передается тип оплаты '''Оплачен''';* тип оплаты '''Банковская карта''' передаетсякнопка "Отменить", если нажатие кнопки "Сохранить" в InSales используется один из следующих типов:** '''Оплата банковской картой''';** '''Банковской картой при получении''';** '''Оплата банковской картой курьеру'''карточке корреспонденции).: Создайте эти типы оплаты При этом статус корреспонденции в InSales: '''Настройки''' интеграции сменится на "Отменяется"<br> '''Оформление заказа''' <br> '''Оплата''';* если название типа оплаты не совпадает с вышеперечисленными, передается тип оплаты '''Наличными'''.В системе MeaSoft в карточке интернет-магазина есть флажок '''Спрашивать тип оплаты у получателя'''. Если он установлен, то независимо от переданного типа оплаты '''Наличными''' или '''Банковская карта''' покупателю будет предложен выбор способа оплаты.

См. раздел «[[RetailCRMФайл:2023-04-03_11-26-09.png |700px]]».<br><br><br>

</li><li>Если заказ <i style=== CS"color:black; background-Cart ===color:#e91e6326;"> не удалось отменить </i> на стороне подрядчика, (например, заказ уже находится в процессе доставки), то статус заказа изменится на "<b>В работе у подрядчика</b>".Модуль поддерживает CS-Cart 4.10 и вышеВ этом случае, изменение заказа возможно только в личном кабинете подрядчика, либо обращением в <i>техподдержку подрядчика</i>.<br><br>

# Скачайте архив модуля установки по [https[Файл://marketplace.cs2023-04-cart.com/measoft03_11-en.html ссылке].# В панели администратора CS52-Cart откройте '''Модули''' > '''Управление модулями''' и на странице «Модули» нажмите на кнопку [[Файл:Cscart добавить20.png|25 px700px]]. Откроется окно «Загрузить и установить модуль».# В этом окне нажмите на кнопку '''Загрузить''', выберите архив с модулем на компьютере и нажмите на кнопку '''Загрузить и установить'''. Модуль «Курьерская служба 2008» появится в списке модулей.# Откройте '''Администрирование''' > '''Доставка и налоги''' > '''Способы доставки''' и нажмите на кнопку [[Файл:Cscart добавить.png|25 px]]. Откроется окно «Новый метод доставки»:#: <br>[[Файл:Cscart настройка.png|900px|none]]#: # В этом окне укажите следующие настройки:#* в поле '''Расчет тарифа''' установите переключатель '''В режиме реального времени''';#* в выпадающем списке '''Перевозчик''' выберите значение '''КС2008''';#* в выпадающем списке '''Служба доставки''' выберите режим срочности по умолчанию;#* заполните остальные поля.# Нажмите на кнопку '''Создать'''. Появляется оповещение о том, что изменения сохранены, и в этом же окне появляются кнопки настройки. Нажмите на кнопку '''Настроить''':#: <br>[[Файл:Cscart курьером.png|800 px|none]]#: # В этом окне укажите следующие настройки:#* введите учетные данные клиента курьерской службы. Запросите эти данные у курьерской службы, с которой настраивается интеграция. На рисунке указаны учетные данные тестового доступа;#* Укажите тип доставки. Возможные значения: '''Курьером до двери''', '''ПВЗ'''.# Нажмите на кнопку '''Сохранить'''.<!--Чтобы проверить работу интеграции, нажмите на кнопку '''Общее''', нажмите '''Рассчитать стоимость доставки''', введите вес отправления и нажмите на кнопку '''Тест'''. При настроенной интеграции отобразится окно с расчетной стоимостью и сроком доставки.--br>

Чтобы создать два способа доставки — '''Курьером до двери''' и '''ПВЗ'''</li><li>Если заказ был <i style="color:black; background-color:#dafbda;"> успешно отменен </i> (в этом случае интеграция сама удалит заказ на стороне подрядчика), повторите шагито по истечении 1-15 минут статус заказа в интеграции сменится на "<b>Отменен</b>".<br>Ответственный филиал корреспонденции будет автоматически переключен на главный ответственный филиал, начиная с па код подрядчика (если он был присвоен) будет удален. 4<br><i style="color:black; background-color:#dafbda">Только после этого можно считать, что корреспонденция полностью отменена в интеграции</i> и можно приступать к ее повторной отправке.<br>

:: <br>[[Файл:Cscart оформить заказ2023-04-03_12-03-35.png|700 px|none700px]]

Чтобы просмотреть полученные заказы<br><br><br></li><li>Внесите исправления в данные корреспонденции. Сохраните ее.</li><li>Для повторной отправки корреспонденции по интеграции (предварительно убедившись, откройте '''Заказы''' что все ошибки исправлены) вновь назначьте для корреспонденции ответственный филиал интеграции </li> '''Полученные заказы'''<li>После повторного назначения в корреспонденции ответственного филиала интеграции ожидайте сообщения об отправке. При повторной отправке этот процесс может занимать до 30 минут. В карточке заказа </li><li>При возникновении ошибки, если она очевидна, вновь исправьте ошибку в корреспонденции и повторите процесс повторной отправки (отмена, исправление ошибок, повторное назначение на ответственный филиал интеграции)</li></ul>Если при получении ошибки от подрядчика нет понимания ее причин, пожалуйста напишите в правом нижнем углу находится блок модуля «Курьерская служба 2008»:нашу техподдержку.

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

Также Чтобы настроить сквозную интеграцию между [[#Интеграция с CMS-системами |CMS- или CRM-системой]] и подрядчиком [[#Тарификация и выбор подрядчика и его тарифа клиентом|из таблицы]]:* Создайте свой Личный кабинет для экстраинтеграции.<br>Для этого, достаточно единоразово войти в этом блоке вы можете проверить статус доставки заказаЛК экстраинтеграции под своим логином и паролем https://home.courierexe.ru/XXX, где XXX — экстра-код партнера.<br><i>Логин</i> и <i>пароль</i>, - это данные из 3-го и 4-го параметров (см. таблицу ниже) [[#Тарификация и выбор подрядчика и его тарифа клиентом|Тарификация и выбор подрядчика и его тарифа клиентом]].* настройте [[Виды срочности|режим срочности]] для подрядчика.

Вы можете настроить соответствие статусов MeaSoft == Тарификация и СS-Cart выбор подрядчика и настроить автоматическую отгрузку заказа при переводе его в определенный статус:тарифа клиентом ==# В панели администратора CS-Cart откройте '''Модули''' > '''Управление модулями''' и на странице «Модули» выберите «Модуль доставки MEASoft». # В окне «Модуль доставки MEASoft» нажмите на кнопку '''Статусы'''.# Чтобы Вы можете настроить автоматическую отгрузку заказаподключение своего тарифа к тарифу партнера — любой компании, работающей в разделе '''Автоматическая отгрузка''' выберите из выпадающего списка статус CS-Cart, при котором заказ будет автоматически отгружаться.# Чтобы сопоставить статусы системе MeaSoft и СS-Cart, в разделе '''Сопоставление статусов заказа''' укажите статусы CS-Cartа также ряду компаний, соответствующие статусам MeaSoft.# Нажмите на кнопку '''Сохранить'''с которыми у нас есть интеграции.

[[Файл:Cscart статусы.png|none|700 px]] ==== Настройка способов оплаты =интеграции ===Чтобы настроить подключение к тарифу партнера:Описание # Зарегистрируйтесь в системе подрядчика. Данные аккаунта понадобятся для настройки способов оплаты сминтеграции. в # Откройте '''Справочники''' > '''Статусы''' > '''17 Виды срочности''' и создайте [[https://www.cs-cart.ru/docs/4.4.x/user_guide/payment_methods/adding_payment.html документации CS-CartСтатусы#Виды срочности|вид срочности]], например «СДЭК».# В контекстном меню вида срочности выберите пункт '''Дополнительная информация''' и во второй строке заполните параметры подключения к партнеру через запятую:Чтобы сопоставить настроенные способы оплаты со способами оплаты MeaSoft#* 1-й параметр — код филиала партнера, откройте его можно посмотреть в '''АдминистрированиеСправочники''' > '''Способы оплатыМежгород''', выберите способ оплаты и в разделе > '''Модуль доставки MEA SoftФилиалы''' выберите соответствующий ему тип оплаты . Можно в одинарных кавычках указать несколько ответственных филиалов через запятую, тогда режим срочности будет доступен для всех перечисленных филиалов. Для версии системы 2021.0.0.38 и выше вместо кода филиала можно указать знак вопроса (?), это обозначит доступность режима срочности для всех филиалов;#* 2-й параметр — экстра-код партнера в системе MeaSoft.Коды для сторонних компаний приведены в таблице ниже;#* 3-й параметр — имя пользователя в системе партнера. Может отличаться от того, под которым работает интеграция, здесь нужно для расчета цены для клиента. В таблице ниже указано, что вводить для каждого интегратора;[[Файл:Cscart способы оплаты#* 4-й параметр — пароль пользователя из 3-го параметра.png|none|700 px]]В таблице ниже указано, что вводить для каждого интегратора;#* 5-й параметр — вид срочности партнера. Посмотреть доступные коды видов срочности можно по ссылке в таблице ниже, в калькуляторе в выпадающем списке. Можно в одинарных кавычках указать несколько видов срочности через запятую, тогда система будет стараться выбрать из них первый доступный;=== amoCRM ===#* 6-й параметр — наценка к цене, передаваемой подрядчиком. В деньгах или в процентах, если стоит знак процента. Например, 10 — наценка 10 рублей, 10 % — наценка 10 процентов; Интеграция реализована через виджет «Курьерская служба 2008»#* 7-й параметр — если указать значение '''1''', сквозная тарификация выключена. Параметр используется, предназначенный если подключение нужно только для передачи заказов из amoCRM по интеграции, а расчет цены не нужен. <br>В этом случае, при визуализации суммы по режиму срочности, отображается внутренний тариф, а подрядчику заказ отправляется другим тарифом, выбранным согласно настройке в MeaSoft 5-м параметре (вид срочности партнера).;#* 8-й параметр — если указать значение '''1''', среди указанных режимов срочности партнера выполняется поиск самого дешевого тарифа. Работает для СДЭК 1.5, Почты России и возврата статусовOmnic# Нажмите на кнопку '''OK'''.

!Поле виджетаИнтеграция!Данные amoCRMКод экстра!Где настраивается сопоставлениеВиды срочности!Авторизация!Пример строки

|'''Имя''', '''Телефон''', '''Компания'''БОКСБЕРРИ||90001||Поля карточки контактаhttps://home.courierexe.ru/90001/calculator||'''Настройки виджета''' 3-й параметр - токен. 4-й - Код пункта приема, по умолчанию 010.<br> '''Настройки интеграции с Курьерская служба 2008'''Можно оба параметра оставить пустыми для расчета базовых цен.||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>• ID сделки;<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''Настройки виджета''' > '''Настройки интеграции с Курьерская служба 2008''', 5, 30%

|'''Город'''|Если вы хотите добавить в расчет тарифа процент за наложенный платеж, '''Адрес''', '''Индекс''', '''Примечание''', '''Дата доставки'''после пароля добавьте запятую и число процента. В настройке режима срочности пароль с числом процентов заключите в кавычки.|| Поля сделки|| '''Настройки виджета''' > '''Настройки интеграции с Курьерская служба 2008'''9vkQgWuiZgEj9fGCB8a6Xj3desnJkws,1.5

|'''Вес''', '''Сумма''', '''Объявленная ценность''', название и количество товараСДЭК<br>(протокол обмена данными 2.0)||90022||Карточка товараhttps://home.courierexe.ru/90022/calculator||• Если товар добавляется вручную или из каталога Курьерской службы 20083-й параметр — ID клиента, сопоставление 4-й — ключ клиента.<br>Вы можете перечислить в пароле уточняющие параметры для расчета через запятую: <br><ul><li>не требуется;передавать объявленную ценность</li><li>добавлять услугу «Осмотр вложений»</li><li>процент за наложенный платеж</li><li>код пункта приема</li><li>процент за безналичный наложенный платеж</li></ul><br>• если товар добавляется из списка amoCRMПример пароля: EMscd6r9JnFiQ3bLoyjJY6eM78JrJcee, настройте сопоставление в '''Настройки виджета''' > '''Настройка товаров'''1,1,2,MSK2,15||10497, 90022, EMscd6r7JnFyQ3bLoyjJY7eM78JrJceI, ‘Mscd6r9JnFiQ3bLoyjJY6eM78JrJcee,1,1,2,MSK2,15’, 1, 100

|'''Количество мест'''КСЭ|| - 90008||Заполняется в виджете вручнуюhttps://home.courierexe.ru/90008/calculator||} ==== Устранение неполадок ==== ===== Данные заказа не подставляются Введите логин в поля виджета =====# В личном кабинете MeaSoft в пункте основного меню '''Настройки''' выберите '''Интеграция'''3-й параметр, перейдите на вкладку '''Настройки интеграции''' и пароль — в таблице «Ваши интеграции» в строке «AmoCRM» нажмите '''Изменить'''4-й.# На странице «Настройка интеграции AmoCRM» нажмите на кнопку '''Сохранить'''Пустыми оставить нельзя.# Укажите аккаунт amoCRM||12504, 90008, в котором наблюдается проблема виджета «Курьерская служба 2008» Рога и нажмите '''Разрешить'копыта, 4CCB11864D06157, '2, 3, 6'. ===Беру===При интеграции поддерживается:* Обработка координат. === МойСклад ===Интеграция предназначена для передачи заказов с товарными вложениями из системы МойСклад в MeaSoft. Обратно в МойСклад будут приходить статусы, стоимость доставки и общая сумма заказа с учетом частичной доставки.10%|-Чтобы настроить интеграцию:# Перейдите по [|ПОЧТА РОССИИ||90010||https://home.courierexe.ru/moysklad90010/step1 ссылке] и введите логин и пароль от учетной записи системы «МойСклад» с правами администратора.<br><br>calculator||Без авторизации||10497, 90010,,, '2, 1''Примечание'''. Запрещено изменять данные этой учетной записи — это приведет к сбою интеграции. В будущем при обращении в техническую поддержку MeaSoft указывайте данные этой учетной записи для получения помощи по вопросам интеграции., 10 <br>Если все же есть необходимость сменить учетные данные!--10497, после сообщите новый пароль от «МойСклад» в техподдержку MeaSoft для внесения изменений в настройки интеграции.<br><br># Укажите логин90010, пароль и код курьерской службы. Запросите эти данные у курьерской службы89251234567, с которой настраивается интеграция.# Нажмите на кнопку 'mypassword,u23B0r9AAJ1Fyh4ptMzJ3kjxcslamwdx', 'Сохранить2, 1'''.<br, 10-->В случае ошибки «Данный пользователь „Мой склад“ уже зарегистрирован.» нажмите на кнопку '''Сбросить'''.# Дождитесь окончания синхронизации справочников. Не закрывайте и не перезагружайте страницу. Процесс может занять продолжительное время (от 10 минут).<br>После синхронизации справочников автоматически произойдет переход на страницу следующего шага.|-# В системе МойСклад создайте дополнительные поля в заказах. Для этого перейдите в '''Продажи''' > '''Заказы покупателей''', в правой части экрана нажмите на кнопку с шестеренкой и в разделе '''Дополнительные поля''' нажмите на кнопку '''+Поле'''. Подробнее см. в [|rowspan="3"|DPD||rowspan="3"|90011||rowspan="3"|https://supporthome.moyskladcourierexe.ru/hc90011/ru/articles/204653178calculator||Введите клиентский номер в 3-%D0%94%D0%BE%D0%BF%D0%BE%D0%BB%D0%BD%D0%B8%D1%82%D0%B5%D0%BB%D1%8C%D0%BD%D1%8B%D0%B5й параметр, клиентский ключ в 4-%D0%BF%D0%BE%D0%BB%D1%8F документации МойСклад]й.# Создайте следующие поля:#* с типом «Строка»:#** '''Город''' — для указания населенного пункта получателя;#** '''Дата доставки''' — для указания даты доставки наряду со временем;#** '''Сумма заказа''' — для получения суммы заказа от курьерской службы;#** '''Стоимость доставки''' — Можно оставить пустыми для получения стоимости доставки от курьерской службы;#** '''Строка для сохранения информации об ошибках''' — для получения текста ошибки;#** '''Количество мест''' — для возможности указания количества мест;#* с типом «Файл»:#** '''Файл''' — необязательное поле для передачи файловбазовых тарифов. Максимальный размер файла — 1 МБ;#* с типом «Флажок»:#** ||12504, 90011, 1019003662, '4CCB11864D06157A5934A9119F2A0AAAAAB4CCE8,D117', 'Необходимость возврата3, 6''' — необязательное поле для передачи признака «необходимость возврата»;, 10%#* с типом «Справочник»:|-#** '''Виды срочности''' — одноименный справочник;#** '''Временные интервалы''' — одноименный справочник;#** '''Способы доставки''' — одноименный справочник;#** '''Тип оплаты''' — одноименный справочник;#** '''Время доставки с''' — справочник '''Часы доставки''';#** '''Время доставки по''' — справочник '''Часы доставки'''.# В ЛК клиента MeaSoft обновите открытую страницу ||Если вы доставляете товар в пункт отправления самостоятельно, после пароля добавьте запятую и настройте статусы отправкикод ПВЗ, соответствие статусов и полейа в настройке режима срочности введите пароль в кавычках. В выпадающем списке значений поля контрагента соответствуют следующим полям раздела '||'4CCB11864D06157A5934A9119F2A0AAAAAB4CCE8,D117'Контрагенты''' в «МойСклад»::::{|class="wikitable"!Поля контрагента в MeaSoft!Настройки МойСклад > Контрагенты

|'''Email''' 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-й параметр — '''Полное наименование'''<br> для ИП API-ключ, 4-й — в формате [ИП '''Фамилия''' '''Имя''' '''Отчество''']<br>для физпароль от личного кабинета 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

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

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

Если нужна доставка по адресу, оставьте поле '''Тип доставки''' пустым. Иначе выберите ПВЗ из списка. Данные из поля '''Комментарий''' передаются в заказ автоматически. Чтобы отправить заказ, присвойте заказу статус для передачи в курьерскую службу. Если после сохранения заказа в статусе для передачи в курьерскую службу статус не изменился, проверьте поле '''Ошибка'''. Заполните поля, указанные в поле '''Ошибка''', очистите поле '''Ошибка''' и сохраните заказ. Чтобы проверить, передан ли заказ в курьерскую службу, зайдите в [[Личный кабинет клиента|личный кабинет клиента]] и на вкладке '''Отслеживание''' проверьте, существует ли отправленный заказ. '''Известные проблемы''' Модуль интеграции не работает на бесплатном тарифе. При установке приложения в «МойСклад» регистрируется <rspoiler text="событие">веб-хук</rspoiler> на изменение заказа, чтобы «МойСклад» передавал изменения в MeaSoft. Так работают все модули служб == Настройка стоимости доставки для «МойСклад». «МойСклад» поддерживает только одно событие для заказа, поэтому, если оно занято другим <rspoiler text="установленным модулем">Или модуль может быть удален или не до конца установлен, а зарегистрированное событие от него осталось</rspoiler>, MeaSoft не сможет его занять, и отправка заказов работать не будет. Если у вас не отправляются заказы и вы уверены, что у вас нет других модулей, использующих это событие, обратитесь к нам в службу поддержки, мы сможем проверить занятость события и при необходимости его освободить. === LeadVertex получателя ===С помощью При интеграции вы можете выгружать заполненные заказы в любую курьерскую службус подрядчиками, работающую перечисленными в MeaSoftтаблице выше, вы можете настроить стоимость и получать измененные статусы по заказам. Модуль интеграции разработан компанией LeadVertex и поддерживается силами технической поддержки LeadVertex. По всем вопросам эффективнее обращаться [https://leadvertex.ru/contact.html сюда]. Заказам, переданным через интеграцию, присваивается уникальный номер в формате <code>номер заказа_ID проекта</code>, где ID проекта — это цифровой идентификатор вашего [https://leadvertex.ru/knowledgebase/11-kak-popolnit-balans-i-sozdat-proekt проекта] в системе LeadVertex. ==== Настройка интеграции ====# В LeadVertex перейдите в '''Настройки''' > '''Почта и курьерки''' > '''Курьерская служба 2008'''. Откроется окно «Настройки модуля „Курьерская служба 2008“».# В поле '''Курьерская служба''' выберите из выпадающего списка курьерскую службу, в которую будете передавать заказы. Если нужной курьерской службы в списке нет, сообщите код курьерской службы в техподдержку LeadVertex, она будет добавлена.# В полях '''Логин''' и '''Пароль''' укажите учетные данные для подключения, выданные курьерской службой.# Настройте остальные поля для передачи информации в MeaSoft. Используйте подсказки системы, они отображаются по нажатию на [[Файл:LV подсказка.png]].<br>Информацию по настройке дополнительных полей заказа см. в [https://leadvertex.ru/knowledgebase/15-kartochka-zakaza-polya-i-skripty-dlya-operatorov базе знаний LeadVertex] <br>Особенности заполнения:#* '''Типы срочности''' — перед выбором значения нажмите на кнопку '''Сохранить изменения'''. После этого в настройке можно выбрать тип срочности для подключаемой курьерской службы.#* '''Типы срочности из доп. поля''' — позволяет отобразить список всех типов срочностисрок доставки, доступных отображаемые для курьерской службы, в окне параметров отправки заказа. Укажите любое свободное дополнительное поле;#* '''Передавать артикулы вложений''' — установите этот флажок, только если используете склад ответственного хранения курьерской службы;#* '''Записать трек-номер внешней курьерской службы в доп. поле''' — позволяет записать код подрядчика в указанное поле.# Настройте соответствие статусов MeaSoft и LeadVertex: [[Файл:LV статусы.png|none|1000 px]]# Нажмите на кнопку '''Сохранить изменения'''. ==== Отправка заказа в MeaSoft ====# Откройте заказ, убедитесь, что в нем заполнены данные получателя.# Нажмите на кнопку справа '''Курьерская служба 2008'''. Откроется окно параметров доставки:[[Файл:LV параметры доставки.png|none|700 px]]# Установите параметры доставки и подтвердите выбор.# В окне заказа нажмите на кнопку '''Сохранить изменения'''.# Перейдите в список заказов, отметьте флажком заказы к отправке, затем внизу страницы нажмите на кнопку '''Выгрузка''' и выберите нужный вариант доставки, например «Курьерская доставка 2008: Доставка до ПВЗ». ===Wordpress=== ====Требования к сайту ==== # CMS WordPress версии 5 или более новая;# WooCommerce версии 3.9 или более новая;# PHP версии 7 или более новая;# сайт должен использовать SSL-сертификат. ====Порядок установки плагина и вывод нового способа доставки в корзину ==== # В панели администратора сайта откройте страницу '''Плагины''' > '''Добавить новый''' и нажмите на кнопку '''Загрузить плагин'''.# В появившейся форме выберите архив с плагином на вашем компьютере и нажмите кнопку '''Установить'''.# После загрузки и установки плагина вы можете его активировать нажав на соответствующую кнопку.# После активации плагина в меню появится ссылка на страницу настроек плагина. Заполните все необходимые поля и нажмите кнопку '''Сохранить изменения'''.# Откройте настройки WooCommerce и переключите на вкладку '''Доставка'''.# Выберите необходимую зону доставки или создайте её.# Нажмите на кнопку '''Добавить метод доставки''' и выберите из списка '''КС2008'''.# После создания заказа в панели администратора в форме изменения заказа справа появится блок модуля '''Отправить в курьерскую службу''' с кнопкой '''Отправить заказ в КС2008''', при нажатии на которую заказ будет отправлен в курьерскую службу. ====Обновление статусов==== Обновление статусов заказов происходит через технологию WP_Cron каждые 30 минут.  Если статус заказа в курьерской службе изменен на '''Доставлен''', то статус заказа в вашем магазине также будет изменен на '''Выполнен'''. ===Проверка работоспособности интеграций=== При неполадках интеграции проверьте ее работоспособность. В общем случае для этого достаточно создать заказ и отправить его в курьерскую службу. Если заказ отправлен без ошибок и отображается в ЛК, значит, интеграция настроена. Если отправка не удалась, ошибка может быть в настройках интеграции или в заполнении формы отправки заказа. Текст ошибки можно увидеть через [[Личный личный кабинет#Отладка|отладку]] в личном кабинете. Чтобы найти свой заказ в запросах, нажмите клавиши CTRL + F и введите в строку поиска номер заказа или ориентируйтесь на время создания заказа. Убедитесь, что выполнены все шаги инструкции по настройки интеграции из этого раздела. Ниже представлено описание проверки работоспособности для разных интеграторов. '''RetailCRM''' # Убедитесь, что выполнены все шаги [[RetailCRM#Настройка интеграции|инструкции по настройке интеграции]].# Если используются триггеры, убедитесь, что они настроены согласно [[RetailCRM#Настройка триггеров|инструкции]].# Создайте заказ, заполните требуемые данные.# Нажмите на кнопку '''Сохранить''' внизу страницы, флажок '''Не отправлять данные в службу доставки''' должен быть снят. Заказ должен отправиться в курьерскую службу.# Если возникает ошибка, ее текст отображается наверху страницы.:: Если это ошибка заполнения формы, исправьте внесенные данные и попробуйте отправить заказ снова. Пример ошибки: «Ошибка сервиса доставки "Курьерская служба 2008": field [receiver phone] has no valid phone number» :: Если это ошибка ответа курьерской службы, сообщите об этом разработчику. Пример ошибки: «Служба доставки прислала ответ в неверном формате». '''МойСклад''' # При сбое интеграции проверьте, не изменен ли аккаунт, под которым создана интеграция:## Логин учетных данных МойСклад, которые использовались при создании интеграции, вставьте в ссылку <nowiki>адресу вида https://home.courierexe.ru/moysklad/step2?id=</nowiki>'''логин'''. Если при переходе по ссылке отображается этап настройки интеграцииXXX, значит аккаунт существует.## Войдите в «МойСклад» под учетной записью, которая использовалась для настройки интеграциигде XXX — экстра-код партнера, и откройте справочник '''Сотрудники''': меню пользователя > '''Настройки''' > '''Справочники'''> '''Сотрудники'''. Откройте карточку сотрудника, под учетной записью которого вы вошли, и убедитесь, что его роль — администратор.## Если хотя бы один авторизуйтесь данными из пунктов не выполнен, значит, аккаунт, использованный для создания интеграции, изменен.# В личном кабинете клиента курьерской службы в настройках обратной интеграции '''Мой склад''' в поле '''В каком статусе "Мой склад" отправлять заказ на доставку''' уточните статус, при котором заказ отправляется в курьерскую службу.# Заполните форму заказа, нажмите на кнопку '''Сохранить''', затем смените статус заказа на статус, установленный для отправки в курьерскую службу и снова нажмите на кнопку '''Сохранить'''. Если все верно, заказ будет отправлен в курьерскую службу.# Обновите страницу в браузере и проверьте поле '''Строка для сохранения информации об ошибках''':#* если поле пустое и заказ пришел в личный кабинет, интеграция работает;#* если поле пустое и заказ не пришел в личный кабинет, обратитесь к разработчику;#* если в поле содержится текст ошибки, исправьте ее в форме заказа и попробуйте отправить его снова. '''InSales''' # В личном кабинете клиента курьерской службы в настройках обратной интеграции '''InSales''' проверьте данные в следующих полях:#* '''Статус заказа для автоматической отправки в курьерскую службу''';#* '''Список доставок для отправления заказа в курьерскую службу (если отправляется автоматически)''';#* '''Оплачен ли заказ? (если отправляется автоматически)'''.# Создайте заказ и в случае ошибки проверьте данные заказа на соответствие этим полям. Например, в заказе может быть установлен тип доставки, не отмеченный как используемый в настройках в личном кабинете. При возникновении ошибок при отправке заказа появляется диалоговое окно с сообщением об ошибке. Исправьте ошибку в форме заказа и попробуйте отправить его снова. '''amoCRM''' Ошибка при создании заказа отображается в левом нижнем углу. == Интеграция с платежными сервисами ==Доступна интеграция со следующими сервисами:* PimPay — финансирование для интернет-магазинов;* Robokassa — онлайн3-оплата заказов го и мобильный эквайринг;* Payme — онлайн4-оплата заказов и мобильный эквайринг. Работает в Узбекистане;* Assist — мобильный эквайринг;* ibox — мобильный эквайринг. Сервисы настраиваются в [[Личный кабинет курьерской службы#Финансы|личном кабинете курьерской службы]]. === PimPay ===Чтобы начать работать с [https://pimpay.ru/ Pimpay]:# Зарегистрируйтесь [http://platform.api.pimpay.ru/site/register в сервисе]. Далее Pimpay активирует вашу учетную запись.# Cгенерируйте ключи шифрования. Это делается на [http://platform.api.pimpay.ru/v2_7/signature/openssl UNIX-подобной системе] или с помощью <rspoiler text="нашей инструкции">Чтобы получить приватный ключ, в командной строке выполните следующие команды:<br><br><code>openssl genrsa -out private.pem 2048</code> <br><br><code>openssl rsa -in private.pem -outform PEM -pubout -out public.pem</code><br><br>В результате вы получите 2 файла: public.pem и private.pem.<br>Содержимое файла public.pem — ваш публичный ключ. Скопируйте его целиком и вставьте в личном кабинете PimPay.<br>Содержимое файла private.pem скопируйте и вставьте в настройках интеграции с PimPay в личном кабинете курьерской службы.</rspoiler>. Если у вас нет специалиста, чтобы сгенерировать ключи, обратитесь за помощью в PimPay.# В личном кабинете курьерской службы в разделе '''Управление ЛК''' > '''Параметры''' > '''Финансы''' заполните настройки Pimpay данными из личного кабинета Pimpay. Сохраните настройки.# Зарегистрируйте каждого клиента, который хочет передавать данные в PimPay, в личном кабинете PimPay.# В MeaSoft в карточке каждого клиента на [[Клиенты и партнеры#Финансы|вкладке '''Финансы''']] выберите платежного посредника '''PimPay'''. При передаче данных привязка клиентов между системами производится по ИНН. В результате MeaSoft передает все заказы вашего клиента, их статусы и созданные [[Акты Передачи Денег и корреспонденции го параметров (АПД)|АПД]] в PimPay. PimPay ничего не передает в ответ. Чтобы платежи в банк по АПД выгружались в адрес PimPay, создайте клиента с названием «PIMPAY» и заполните его реквизиты. === Robokassa === Сервис позволяет принимать онлайн-платежи на странице отслеживания заказа или при [[Мобильное приложение курьера для Android#Robokassa|оплате картой курьеру]]. Чтобы настроить прием платежей через сервис Robokassa:# Зарегистрируйтесь в сервисе [https://partner.robokassa.ru/Reg Robokassa].# В <rspoiler text="настройках личного кабинета курьерской службы">'''Управление ЛК''' > '''Параметры''' > '''Финансы''' > '''Настройки эквайринга'''. Подробнее см. раздел [[Личный кабинет курьерской службы#Финансы|«Финансы»]].</rspoiler> введите идентификатор магазина и пароли из личного кабинета Robokassa.# Установите флажок '''Тестовый режим''' и нажмите на кнопку '''Сохранить'''таблицу выше).# Откройте [[Личный кабинет курьерской службы#Отслеживание заказа по номеру|страницу отслеживания]] любого заказа с наложенным платежом и оплатой картой и убедитесь, что появилась кнопка '''Оплатить картой'''. # Нажмите на кнопку '''Оплатить картой'''. В следующем окне нажмите на кнопку '''Оплатить картой в тестовом режиме'''. Откроется окно оплаты Robokassa.# Если в пунктах 4-5 обнаружены ошибки, проверьте правильность введенных учетных данных Robokassa в личном кабинете курьерской службы.# Если пункты 4-5 пройдены без ошибок, в настройках личного кабинета курьерской службы снимите флажок '''Тестовый режим''' и нажмите на кнопку '''Сохранить'''. В результате курьер может принять оплату картой по QR-коду или получатель может оплатить заказ онлайн на странице отслеживания https://home.courierexe.ru/XX/tracking, где XX — код вашей курьерской службы: [[Файл:Robokassa.png|none|900 px]] При успешной оплате заказ в MeaSoft отмечается как оплаченный. В окне отслеживания в поле '''Наложенный платеж''' статус заказа изменится на '''Заказ оплачен'''. Чек по операции придет на электронную почту, указанную при заказе. === Assist ===Чтобы настроить прием платежей через сервис Assist:# Заключите договор с [https://www.assist.ru/o-podklyuchenii/ Assist] и установите мобильное приложение Assist mPOS.# В [[Мобильное_приложение_курьера_для_Android#Assist|мобильном приложении]] MeaSoft App нажмите на кнопку '''Еще''', выберите пункт '''Настройки''' и в поле '''Параметры эквайринга''' выберите значение '''Assist mPOS'''.# Рядом со значением '''Assist mPOS''' появится кнопка [[Файл:Assist настройки.png|25 px]]. Нажмите на нее, введите <rspoiler text="PIN-код"> В личном кабинете курьерской службы в пункте основного меню '''ТелефоныЦена доставки для получателя''' > [[Личный кабинет курьерской службы#Курьерские устройства|Курьерские устройства]] откройте карточку курьера и скопируйте значение поля '''PIN-код POS-терминала'''.</rspoiler> настройте правила расчета цены и нажмите на кнопку '''Проверить'''.# В окне «Настройки Assist» укажите логин, пароль и ИД магазина согласно вашим учетным данным Assist и нажмите на кнопку '''Сохранить'''. В результате из мобильного приложении MeaSoft при проведении оплаты картой будет совершаться переход в мобильное приложение Assist mPOS. Вы можете выбрать способ проведения оплаты:* картой через терминал;* QR-код для считывания мобильным банковским приложением покупателя (СБП);* наличными. Чек по операции придет на электронную почту, указанную при заказе. === ibox ===Мобильный эквайринг ibox доступен через приложение или <rspoiler text="SDK">SDK — это средства разработки, которые позволяют приложению MeaSoft взаимодействовать с POS-терминалом напрямую.</rspoiler>сроков доставки. Подробнее см. раздел «[[Мобильное приложение курьера для Android#ibox|ibox]]». Для подтверждения успешной транзакции или отмены оплаты MeaSoft получает обратные вызовы (вебхуки) от ibox:* при успешной оплате после установки статуса корреспонденции со слов курьера '''Доставлено''' или '''Частично доставлено''' в MeaSoft на вкладке '''Выдача''' подсвечивается поле '''Тип оплаты''':** зеленым цветом, если оплата картой, есть идентификатор транзакции и сумма транзакции верная;** желтым цветом, если оплата картой, есть идентификатор транзакции, но сумма транзакции не совпадает со значением поля '''Сумма руб''' в карточке корреспонденции;** красным цветом, если оплата картой и нет идентификатора транзакции.*: Если в карточке корреспонденции указан тип оплаты '''Наличными''', то поле будет закрашено красным, если есть идентификатор безналичной транзакции или указана ее сумма. Если их нет, то поле будет зеленым;* при отмене оплаты обратный вызов удаляет идентификатор транзакции, чтобы сделать возможной повторную доставку и оплату заказа картой. Чтобы настроить работу обратных вызовов:# В личном кабинете курьерской службы в разделе '''Управление ЛК''' > '''Параметры''' > '''Финансы''' в разделе '''Настройки эквайринга Ibox''' заполните поля:#* '''ID Личный кабинет клиента в системе ibox''' — номер компании в разделе '''Профиль''' в личном кабинете ibox;#* '''Логин Цена доставки для webhook ibox''' и '''Пароль для webhook ibox''' — придумайте логин и пароль для авторизации запросов ibox в MeaSoft. Логин и пароль могут состоять из цифр и латинских букв, длина не менее 5 символов.# Нажмите на кнопку '''Сохранить'''.# Обратитесь в техподдержку ibox с просьбой подключить вебхуки для MeaSoft и сообщите им придуманные вами логин и пароль. == Диадок == === Начальная настройка === # Обратитесь в [https://kontur.ru/ СКБ Контур] для выпуска [https://ru.wikipedia.org/wiki/%D0%AD%D0%BB%D0%B5%D0%BA%D1%82%D1%80%D0%BE%D0%BD%D0%BD%D0%B0%D1%8F_%D0%BF%D0%BE%D0%B4%D0%BF%D0%B8%D1%81%D1%8C электронной цифровой подписи (ЭЦП)] для использования с ЭДО Диадок. Получите Рутокен с ЭЦП. При его подключении автоматически устанавливается набор ПО для его использования.# Вам становится доступен вход в систему по адресу [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-объект Диадока. Именно для этого нужны права. В дальнейшем она будет использовать уже установленный компонент, и наличия прав не требуется. === Обмен данными с ЭДО === # Выберите в главном меню MeaSoft '''Связь''' > '''Обмен с ЭДО'''. Откроется окно с выпадающим списком фирм, у которых заполнено поле '''Ключ ЭДО'''.# Выберите фирму и нажмите на кнопку '''Обмен'''. В результате произойдет обмен данными между MeaSoft и ЭДО:* синхронизация справочников контрагентов. MeaSoft получит список контрагентов, уже являющихся вашими партнерами в ЭДО, проставит им соответствующие признаки (на вкладке '''Клиенты''' отображается в столбце '''Статус ЭДО'''. Это поле нельзя менять, оно устанавливается автоматически), проверит, кто прислал вам приглашения к партнерству и примет их, разошлет приглашения всем вашим работающим контрагентам, проверит, кто принял приглашение, а кто отказался;* проверит статусы ранее отправленных документов. При подписании документа вашим партнером сообщение получит статус '''Доставлено'''. Если оно отправлено из счетов или АПД, то соответствующий документ получит признак получения подписанного акта. Эту операцию нужно периодически повторять для получения актуальных данных. === Отправка документов === К отправке сейчас доступны счета, АПД и АПК. Отправка работает крайне похоже на e-mail. Документы формируются точно так же, но отправляются не почтой, а в ЭДО, уже подписанными вашей ЭЦП. В системе ЭДО "адресами" отправителя и получателя являются ИНН (по возможности еще КПП, но это не обязательно) компании, поэтому, чтобы все работало, ИНН должен быть заполнен. Так же ЭДО примет документы только в адрес компании, с которой у вас отмечены партнерские отношения, т.е. кто-то из вас отправил приглашение, а другой его принял. Поэтому, для удобства контроля - кому можно таким образом отправлять, а кому - нет, в списках документов добавлено поле "Есть ЭДО". Там галка ставится на основании статуса ЭДО клиента. Можете отсортировать по этому полю, выдели все, где есть галки, и разослать всем документы по ЭДО. === Ошибка отправки документов === Не все письма были отправлены. Описание ошибок: Счёт № N от [дата], [SchetSend][TMessageSupport.Send] Диадок: ##100[Ошибка сервера Диадок]code:400, HTTP error: Invalid data UserContractData: /UniversalTransferDocument/Signers/SignerReference: @Inn is required /UniversalTransferDocument/Signers/SignerReference: SignerDetails not found for boxId, documentTitleType=0 Ошибка возникает, если не настроен подписант УПД в личном кабинете Диадок.  Чтобы исправить ошибку, в системе Диадок откройте '''Настройки''' > '''Реквизиты организации'''. Перейдите на вкладку '''Сотрудники''' и выберите сотрудника, который будет отвечать за подписание документов. В карточке сотрудника перейдите на вкладку '''Данные по сертификатам''' и в группе полей '''Область полномочий''' установите полномочия для входящих и исходящих документов. Нажмите на кнопку '''Сохранить'''. == Телефония == Основная статья: [[Интеграция с телефонией]] == Wialon == GPS-трекинг автотранспорта реализован в интеграции с системой [https://wialon.ru/ Wialon]. Чтобы настроить интеграцию: # Заключите договор с Wialon, настройте трекинг автомобилей и убедитесь, что он доступен в веб-интерфейсе Wialon.# Запросите в Wialon токен для подключения по API и пришлите в нашу службу техподдержки.# Настройка интеграции выполняется силами техподдержки MeaSoft. Мы устанавливаем задание в модуле автоматизации. Оно подключается к Wialon и по ID трекера получает координаты автомобиля и курьера. Эти координаты попадают в трекинг курьеров в MeaSoft.# В [[Автомобили|карточке автомобиля]] для каждого автомобиля, отслеживаемого Wialon, заполните поле '''ID трекера'''. Например: 19825601; 20007236; 20071171.# Выдайте автомобили курьерам. Для этого в списке автомобилей в контекстном меню выберите пункт '''Распечатать наклейку для выдачи''', распечатайте наклейку на автомобиль и на вкладке '''Выдача''' отсканируйте ее для курьера по аналогии с выдачей корреспонденции. Пока автомобиль на руках у курьера, данные с трекера закрепляются за курьером. Чтобы просмотреть данные трекера, в MeaSoft откройте '''Функции''' > '''Трекинг курьеров'''. На карте выберите треки от Wialon или в фильтре слева в выпадающем списке выберите значение '''Трекер в машине'''. Чтобы убедиться в корректности привязки ID трекера к автомобилю, используйте дополнительную возможность MeaSoft, которая формирует отчет по наименованиям и ID объектов, прописанных в Wialon. Обратитесь в техподдержку для установки этой дополнительной возможности».