Система "Курьерская служба 2008" MeaSoft имеет практически не ограниченные неограниченные возможности по интеграции с другими системами. В этой статье мы рассмотрим виды и способы интеграции.
=Виды интеграций= * Заказы:** передача между [[#Интеграция между 2двумя системами MeaSoft|двумя системами]] MeaSoft — клиент отправляет заказы другому агенту, агент доставляет отправления и передает их статусы, которые загружаются в систему клиента.;** передача заказов в стороннюю систему [[#Интеграция с подрядчиками|подрядчика]] через API и получение статусов доставки;** получение заказов из [[#Интеграция с CMS-системами|CRM- и CMS-систем]] интернет-магазинов и отправка статусов доставки;** [[#Сквозная интеграция|сквозная интеграция]]: получение цен подрядчиков при оформлении заказа;* [[Интеграция с платежными сервисами|платежные сервисы]]:** PimPay — финансирование для интернет-магазинов;** Robokassa — онлайн-оплата заказов и мобильный эквайринг;** Assist — мобильный эквайринг;** ibox — мобильный эквайринг;** Payme — онлайн-оплата заказов и мобильный эквайринг. Работает в Узбекистане;* электронный документооборот — [[Диадок]];* телефония — телефонный сервер [[Интеграция с телефонией|Asterisk]];* планирование маршрутов курьеров — [[Яндекс.Маршрутизация]], [[Максоптра]];* GPS-мя клиентами системы MeaSoft "Курьерская служба 2008" ==трекинг автотранспорта — [[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-м разными клиентами по принципу необходимости чека.
1) Для этого в интеграции Measoft нужно заполнить параметры "Логин для заказов без чека" и "Пароль для заказов без чека"<br>Заказы, которые созданы клиентом '''Обе компаниис настройкой необходимости чека''' должны иметь аккаунты будут отправляться с авторизацией указанной в системе MeaSoft («Справочники» – «Дополнительные модули»)параметрах: <i style="color: #740474;">"Логин"</i> и <i style="color: #740474;">"Пароль"</i><br>Заказы, которым '''чек не требуется''' будут отправляться с авторизацией <i style="color: #740474;">"Логин для заказов без чека"</i> и у обеих компаний должна быть установлена галка «Личный кабинет» в указанном выше окне.<i style="color: #740474;">"Пароль для заказов без чека"</i><br>
2) * '''АгентПередавать наименование клиента, как отправителя''' создает - позволяет передавать наименование клиента , как отправителя* '''Разрешить подрядчику изменять данные получателя''' - при разрешении изменять данные получателя, изменения отразятся в своей системе (на закладке «Клиенты»)оригинальном заказе. На закладке «Прочее» карточки клиента указывает логин и пароль В этом случае заказ необходимо пересчитывать, для входа в Личный кабинетактуализации его стоимости.** ''Не разрешать'' - по умолчанию** ''Разрешать''
3) Далее, клиент указывает остальные настройки при необходимости и нажимает '''АгентСохранить''' передает клиенту Логин.</div>В результате отправления, Пароль (из предыдущего шага)у которых клиент укажет филиал агента в качестве ответственного филиала, а так же свой идентификатор будут переданы в системе систему MeaSoft (см. иллюстрацию)агента, и статусы будут передаваться обратно. Правильный способ отправки заказов — через [[Файл:Measoft id.pngМанифесты|thumb|200px|right|рисманифест]], который нужно скомплектовать и проставить дату отправки.На передачу данных может уходить до 10 минут в штатном режиме и до 1 Код экстра-клиента]]часа в случае возможных сбоев.
4) '''Клиент''' создает в своей системе филиал (Справочники – Межгород – Филиалы) для указанного агента. После ввода филиала нужно перевойти в программу и подождать 3 минуты<div style="color: #a94442; background-color: #f2dede; border: 1px solid #ebccd1; padding: 3px 10px 10px;">При передаче заказов, у которых плановая дата доставки меньше ближайшей возможной, дата доставки автоматически меняется на самую раннюю возможную.</div>
5) '''Клиент''', получив данные из пПередача времени ожидания и заполнение информации о возврате не предусмотрено интеграцией. 3, заходит в свой личный в системе MeaSoft (см. иллюстрацию). Переходит на закладку «Интеграция». В таблице должен появиться созданный филиал. [[Файл:Measoft home.png|thumb|200px|right]]
6) '''Клиент''' нажимает кнопку «Настроить» напротив филиала, в открывшемся окне выбирает интегратор «MeaSoft», далее – заполняет форму – «Логин», «Пароль», и «Код клиента» данными, полученными в пДля стабильной работы необходимо наличие версии MeaSoft минимум 518 от 05. 3, нажимает «Сохранить»12.2014 у обеих компаний. Для одного клиента может быть настроена только одна интеграция с агентом.
==Распределение заказов по признаку необходимости чека==
В результате такой настройки, все отправления, у которых Клиент установит «Ответственный филиал», соответствующий Агенту (правильнее всего это делать оформив [[Манифесты|манифест]], скомплектовав егоВы может распределять заказы по двум разным клиентам по принципу необходимости чека. Для этого агент создает в своей системе второго клиента для вашей компании, и проставив дату отправки), будут переданы в БД Агента, карточке клиента на вкладке '''Прочее''' указывает логин и статусы будут передаваться обратно. На передачу данных может уходить до 10 минут в штатном режимепароль, и до 1 часа в случае возможных сбоевкоторые передает вам.
Для стабильной работы необходимо наличие версии минимум 518 от 05В настройке интеграции Measoft (пункт 6 инструкции выше) заполните поля '''Логин для заказов без чека''' и '''Пароль для заказов без чека''' и выберите признак, по которому определяется необходимость чека, в поле '''Определять заказы без чека по признаку'''.12.2014 у обеих компаний
== Интеграция с подрядчиками (передача заказов) ===== Отказ от ответственности ===Хотим обратить Ваше внимание на тоЗаказы, созданные клиентом, что интеграции со сторонними системами делаются в соответствии с документацией на момент написаниякоторому нужен чек, без партнерства будут отправляться с компаниями-поставщиками сервиса. Об изменениях API нас не оповещаютавторизацией, поэтому интеграции, по независящим от нас причинам, могут переставать работать, работать нестабильно или некорректно, вплоть до потери важной (финансовой?) информации. Заказы, переданные во внешние системы нужно обязательно проверять на корректность пользуясь личным кабинетом партнерауказанной в полях '''Логин''' и '''Пароль'''.
=== Общие правила настройки интеграции ===Здесь рассматривается интеграция с системами сторонних компаний (агент)Заказы, где система MeaSoft (клиент) выступает клиентомкоторым чек не требуется, т.е. передает заказы будут отправляться с авторизацией '''Логин для заказов без чека''' и получает обратно статусы'''Пароль для заказов без чека'''.
Клиент должен иметь аккаунт и личный кабинет в системе MeaSoft. Подробнее см. раздел «= Интеграция со сторонними системами =Сторонними системами могут быть:* [[#Интеграция с подрядчиками|системы подрядчиков]], принимающие заказы на доставку;* [[Личный кабинет курьерской службы#Интеграция с CMS-системами|CRM- и CMS-системы]]»интернет-магазинов, передающие заказы в курьерскую службу.
# Создайте Интеграции со сторонними системами делаются в своей системе филиал ('''Справочники''' > '''Межгород''' > '''Филиалы''') для указанного агентасоответствии с документацией на момент написания, без партнерства с компаниями-поставщиками сервиса. После ввода филиала нужно перезагрузить программу и подождать 3 минутыОб изменениях API нас не оповещают, поэтому интеграции по не зависящим от нас причинам могут переставать работать, работать нестабильно или некорректно, вплоть до потери важной информации.# Зайдите в личный кабинет курьерской службы в системе MeaSoft. Чтобы узнать свои учетные данныеЗаказы, переданные во внешние системы, выберите '''Справочники''' > '''Дополнительные модули''': [[Файл:Measoft home.png|none|600px]]# В личном кабинете перейдите нужно обязательно проверять на закладку '''Интеграции'''. В таблице должен появиться созданный филиалкорректность, пользуясь личным кабинетом партнера.# Нажмите на кнопку '''Настроить''' напротив филиалаПо интеграции уходят только новые заказы, созданные в открывшемся окне выберите интегратор той компании, с которой хотите интегрировать. Далее заполните форму по отображенной инструкции (для каждого интегратора форма и инструкции свои), нажмите '''Сохранить'''день настройки интеграции.
Если устанавливается интеграция между [[API#Готовые интеграции|== Интеграция с CMS- или CRM-системой]] и подрядчиком [[Интеграция с другими системами#Тарификация и выбор подрядчика и его тарифа клиентом|из таблицы]], при авторизации в [[Личный кабинет клиента|личном кабинете клиента]] укажите код клиентской службы подрядчика (столбец «Код экстра»).==
В результате настройки все отправления, у которых клиент установит '''Ответственный филиал''', соответствующий агентуДля работы с популярными CMS и CRM-системами разработаны модули интеграции, будут переданы перечисленные в БД агента и статусы будут передаваться обратнотаблице ниже.
Правильнее оформлять отправление как [[Отправка корреспонденции|манифест]]'''Модули распространяются бесплатно, комплектовать его без гарантий со стороны разработчика''', и не являются средством полной автоматизации взаимодействия с курьерской службой. Модули — это помощь разработчикам интернет-магазинов в построении интеграции с курьерскими службами. '''Ответственность за корректность передачи данных лежит на интернет-магазине.'''Модули сторонних разработчиков обслуживаются и разрабатываются сторонними компаниями. Все вопросы по их приобретению и проставить дату отправкиподдержке необходимо задавать им.
Сообщайте нам свои пожелания по работе наших модулей. Мы учтем их в новых версиях. {| 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 Скачать] -->|Поддерживает версии 20.5.0 и выше. Подробнее см. [[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|описание]].|-|[[Файл: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|Инструкция по настройке]]|-|[[Файл:iiko.jpg|center|x80px]]|style="text-align: center;"|Настраивается в [[Личный кабинет клиента|ЛК пользователя]]|[[Iiko|Инструкция по настройке]]|-|[[Файл: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/ Альтернативный модуль сторонних разработчиков (1 версия)] [https://infostart.ru/public/1531484/ Альтернативный модуль сторонних разработчиков (2 версия)]|-|[[Файл: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/measoft Описание на сайте amoCRM]|Подробное описание настроек читайте [[amoCRM|тут]].|-|rowspan="2"|[[Файл:MoySclad.jpg|center|x30px]]|style="height:50px; text-align: center;"||[[МойСклад|Инструкция]]|-|style="height:50px; text-align: center;"|[https://itmdev.ru/ms/shipping/ Скачать модуль сторонних разработчиков]|Интеграция МойСклад с курьерскими службами от сторонних разработчиков|-|[[Файл:wordpress.jpg|center|x80px]]|style="text-align: center;"|[https://courierexe.ru/wordpress/wordpress.php Скачать]|[[Wordpress|Инструкция]]|-|[[Файл:Cscart.png|center|x60px]]|style="text-align: center;"|[https://marketplace.cs-cart.com/measoft-en.html Установить]|Поддерживает версии 4.10 и выше.<br>[[CS-Cart|Инструкция]]|-|[[Файл:webhooks.jpg|center|x100px]]|style="text-align: center;"|Читайте описание [[Webhook|на этой странице]]|Передача информации о статусах и заказах в вашу систему|-|[[Файл:Logo_tilda_black.png|center|x100px]]|style="text-align: center;"|Читайте описание [[Tilda|на этой странице]]|Работает только на платных тарифах|-|} === Замечания ===# В модулях систем 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»:: Если это ошибка ответа курьерской службы, сообщите об этом разработчику. Пример ошибки: «Служба доставки прислала ответ в неверном формате». '''МойСклад''' # При сбое интеграции проверьте, не изменен ли аккаунт, под которым создана интеграция:## Логин учетных данных МойСклад, которые использовались при создании интеграции, вставьте в ссылку <nowiki>https://home.courierexe.ru/moysklad/step2?id=</nowiki>'''логин'''. Если при переходе по ссылке отображается этап настройки интеграции, значит аккаунт существует.## Войдите в «МойСклад» под учетной записью, которая использовалась для настройки интеграции, и откройте справочник '''Сотрудники''': меню пользователя > '''Настройки''' > '''Справочники'''> '''Сотрудники'''. Откройте карточку сотрудника, под учетной записью которого вы вошли, и убедитесь, что его роль — администратор.## Если хотя бы один из пунктов не выполнен, значит, аккаунт, использованный для создания интеграции, изменен.# В личном кабинете клиента курьерской службы в настройках обратной интеграции '''Мой склад''' в поле '''В каком статусе «Мой склад» отправлять заказ на доставку''' уточните статус, при котором заказ отправляется в курьерскую службу.# Заполните форму заказа, нажмите на кнопку '''Сохранить''', затем смените статус заказа на статус, установленный для отправки в курьерскую службу и снова нажмите на кнопку '''Сохранить'''. Если все верно, заказ будет отправлен в курьерскую службу.# Обновите страницу в браузере и проверьте поле '''Строка для сохранения информации об ошибках''':#* если поле пустое и заказ пришел в личный кабинет, интеграция работает;#* если поле пустое и заказ не пришел в личный кабинет, обратитесь к разработчику;#* если в поле содержится текст ошибки, исправьте ее в форме заказа и попробуйте отправить его снова. '''InSales''' # В личном кабинете клиента курьерской службы в настройках обратной интеграции '''InSales''' проверьте данные в следующих полях:#* '''Статус заказа для автоматической отправки в курьерскую службу''';#* '''Список доставок для отправления заказа в курьерскую службу (если отправляется автоматически)''';#* '''Оплачен ли заказ? (если отправляется автоматически)'''.# Создайте заказ и в случае ошибки проверьте данные заказа на соответствие этим полям. Например, в заказе может быть установлен тип доставки, не отмеченный как используемый в настройках в личном кабинете. При возникновении ошибок при отправке заказа появляется диалоговое окно с сообщением об ошибке. Исправьте ошибку в форме заказа и попробуйте отправить его снова. '''amoCRM''' Ошибка при создании заказа отображается в левом нижнем углу. == Интеграция с подрядчиками ===== Описание процесса интеграции ===Рассматривается интеграция с системами сторонних компаний (агентов), где система MeaSoft выступает клиентом, то есть передает заказы и получает обратно статусы. Компания-пользователь MeaSoft должна иметь аккаунт и личный кабинет в системе MeaSoft. Подробнее см. раздел [[Личный кабинет курьерской службы#Подключение|«Личный кабинет курьерской службы»]]. # Создайте в своей системе [[Филиалы|филиал]] для агента. После ввода филиала нужно перезагрузить программу и подождать 3 минуты.# В личном кабинете курьерской службы на вкладке '''Интеграции''' в списке филиалов найдите созданный филиал и в его строке нажмите на кнопку '''Настроить'''.# В открывшемся окне в выпадающем списке выберите нужную интеграцию.# Заполните форму по отображенной инструкции, нажмите '''Сохранить'''. В результате настройки отправления, у которых клиент укажет филиал агента в качестве ответственного филиала, будут переданы в подрядчику и статусы будут передаваться обратно. Правильный способ отправки таких заказов — через [[Манифесты|манифест]], который нужно скомплектовать и проставить дату отправки. На передачу данных может уходить до 10 минут в штатном режиме и до 1 часа в случае возможных сбоев.
Для стабильной работы необходимо наличие у клиента системы MeaSoft версии минимум 518 от 05.12.2014.
=== СДЭК =Последовательность финальных статусов ==== Параметр <b>Исправлять ошибки последовательности статусов</b> регулирует возможность исправления ошибочно опубликованных подрядчиком финальных статусов.<br>Если в параметре интеграции указано "Исправлять", то при получении статуса <b>CANCELED</b>, вслед за финальным, дата доставки заказа будет приводится в состояние соответствующее последнему полученному статусу.
Отправка === Boxberry ===* '''Токен'''* '''Код пункта приема''' по умолчанию 010* '''Не формировать акты автоматически'''* '''Разрешить вскрывать отправления'''** '''Без вскрытия отправления''' - вид выдачи отправления на стороне Boxberry 0 - без вскрытия** '''Со вскрытием отправления''' - вид выдачи отправления на стороне Boxberry 1 - со вскрытием** '''Разрешено вскрытие и частичная доставка''' - вид выдачи отправления на стороне Boxberry зависит от указания частичной доставки в СДЭК осуществляется первым доступным тарифом из спискакарточке заказе:* «Экономичная посылка»** 1 - <i>со вскрытием</i> если частичная доставка не указана*** 2 - <i>частичная доставка</i>,при частичной доставке в карточке заказа* «Посылочка»* '''Разрешено вскрытие и Частичная доставка с примеркой''' вид выдачи отправления на стороне Boxberry от указания частичной доставки в заказе:<br>Дополнительно,в этом случае <i>указывается возможность примерки</i>, если это доступно на ПВЗ получателя* «Экспресс** 1 -лайт»<i>со вскрытием</i>,если частичная доставка не указана* «Магистральный экспресс».** 2 - <i>частичная доставка</i>, при частичной доставке в карточке заказа
В настройках интеграции MeaSoft может поменять местами тарифы «Экономичная посылка» и «Посылочка».
При весе отправления больше 30 кг применяется тариф «Магистральный экспресс».
Чтобы передать услугу «Примерка», установите флажок * '''Передавать штрихкоды мест'''* '''Принято на складПередавать штрихкод заказа''' в [[Создание корреспонденции#Вручную|карточке корреспонденции]]- Документацией Боксберри разрешено не передавать штрихкоды, тогда Бокберри сам создает ШК и этикетку можно получить по url который Boxberry возвращает вместе с кодом подрядчика при принятии заказа. Если услуга На данный момент, интеграция не нужна, снимите флажокполучает этикетки автоматически. Их нужно скачивать из ЛК Boxberry.
При передаче валюты наложенного платежа код валюты берется из поля '''Валюта''' карточки клиента, от которого передается заказ. Валюта должна совпадать с валютой страны назначения заказа. Если заказ отправляется в другую страну, создайте копию клиента с нужной валютой и оформляйте заказы от него, указывая цены в валюте страны назначения.
==== Миграция на Яндекс Доставку ====Авторизация и принятие оферты Яндекс.Доставки будет происходитьчерез Личный кабинет Boxberry.<br>* В общем случае интеграция не поддерживает отправки личном кабинете Boxberry необходимо кликнуть по баннеру со ссылкой на новый ЛК Boxberry.* Кликая на ссылку в другие страныбанере, кроме Россииклиент последовательно увидит 2 окна:** авторизация (подтверди свой аккаунт)** принятие офертыПосле этого клиенту доступна работа в API и модулях для обновлениягео-справочников.
[http://courierexe.ru/download/userfunc/SDEK_report_load.xml Загрузка отчета СДЭК] Создает входящий АПД по отчету СДЭК [http://courierexe.ru/download/userfunc/SDEK_report_demo.xls такого формата]. Работает начиная с версии 626 от 29.01ПВЗ Яндекс будут загружены в течении суток после подтверждения офферты.2016 и только при передаче заказов <br>Если ПВЗ Яндекс не подгрузились в СДЭК с помощью штатной интеграции. Заполняет поле '''Агентская цена''' течении суток после подтверждения офферты, то требуется обратиться в карточке корреспонденции на вкладке '''Межгород'''техподдержку Measoft для получения логов статуса клиента.
=== TopDelivery СДЭК===[[Файлы для загрузки#.D0.9F.D0.B5.D1.87.D0.B0.D1.82.D0.BD.D1.8B.D0.B5_.D1.84.D0.BE.D1.80.D0.BC.D1.8B_.D0.B4.D0.BB.D1.8F_.D0.BC.D0.B0.D0.BD.D0.B8.D1.84.D0.B5.D1.81.D1.82.D0.BE.D0.B2|Печать наклеек для TopDelivery]]
=== Почта России ===Интеграция Компания СДЭК прекращает поддержку API версии 1.5 с Почтой России описана в разделе [[%D0%A0%D0%B0%D0%B1%D0%BE%D1%82%D0%B0_%D1%81_%D0%9F%D0%BE%D1%87%D1%82%D0%BE%D0%B9_%D0%A0%D0%BE%D1%81%D1%81%D0%B8%D0%B8|Работа с Почтой России]]01.01.2022. По информации от службы поддержки, интеграция не будет резко отключена, но поддержка будет осуществляться только для версии API СДЭК 2.0
=== PickPoint ===Для перехода на новую версию создана интеграция СДЭК 2.0.
Если '''PickPoint''' выделил вам диапазон трекинг-номеров, то необходимо Чтобы настроить филиал и придерживаться последовательности отправки манифестовинтеграцию с платформой СДЭК версии 2.0, заполните следующие поля:Для настройки филиала для интеграции * '''PickPointID клиента''' с диапазоном в основном меню выберите * '''Справочники -> Межгород -> ФилиалыКлюч клиента ''' нажатием правой кнопки мыши на предварительно созданном филиале, в контекстном меню выберите * '''Открыть''' в открывшейся форме перейдите на вкладку '''Интеграция''' и в выпадающем списке '''Правила назначения кода заказа у подрядчика''' выберите '''Из диапазона'''. Укажите начальный и конечные коды диапазона, префикс при необходимости и нажмите клавишу '''ОККод пункта приема '''Это обязательные поля.
Для отправки манифестов добавьте заказы Остальные поля служат для более тонкой настройки создания заказов:* '''Передавать объявленную ценность'''. Значение по умолчанию '''Да''', вы можете изменить это, выбрав одно из значений:** "Да"<br><span style="padding-left: 5px;">Оценочная стоимость формируется по принципу наибольшего значения.</span><br><span style="padding-left: 5px;">Учитываются Оценочная стоимость всего заказа, Оценочная стоимость товарных вложений, цена товарных вложений.</span><br>** "Нет"<br><span style="padding-left: 5px;">объявленная ценность товарных вложений передаваться не будет</span><br>** "Передавать, если указана"<br><span style="padding-left: 5px;">Учитываются только суммы из полей Оценочная стоимость заказа и Оценочная стоимость товарных вложений, где в приоритете Оценочная стоимость заказа.</span>** "Передавать, по местам, если указана"<br><span style="padding-left: 5px;">Оценочная стоимость заказа распределяется по вложениям. Вложения в манифестсвою очередь распределяются по местам.</span>Оценочная стоимость передается по каждому товару, затема не общей суммой. Необходимо указать сумму оценочной стоимости, на вкладке которая будет соответствовать количеству товаров и проверить отправку заказа.* '''МанифестыДобавлять услугу «Осмотр вложений»''' необходимо добавить требуемые заказы . Тарифицируемая услуга от СДЭК, поэтому она добавится, только если в настройках указано '''Да''';* '''Процент за наложенный платеж'''. Используется при получении агентской цены. Калькулятор API CDEK не включает в мешокрасчет сумму за наложенный платеж автоматически, а далее выбрать но мы добавим указанный вами процент в итоговую сумму;* '''Использовать как номер'''. Номер заказа отображается в манифесте ранее настроенный филиалличном кабинете и отчетах СДЭК. После чегоВыберите удобный вариант: '''Шифр''' или '''Штрихкод''';* '''Код курьера'''. Укажите код курьера, который будет указан в контекстном меню манифеста выбрать пункт поле '''Проставить коды у подрядчикаВручил курьер'''для доставленных заказов.После этого можно указать дату отправки манифеста* '''Способ доставки до ПВЗ отправления'''** "Самопривоз в офис СДЭК" - установлено по умолчанию, необходимо заполнить <b>Код пункта приема</b>** "Забор со склада" - в заказе указывается адрес склада с которого курьеры СДЭК забирают отправления. Адрес указывается в карточке ответственного филиала для которого настраивается интеграция со СДЭК вер.2.0** "Забор у отправителя" - в заказе указывается адрес отправителя с которого курьеры СДЭК забирают заказы.*** <i>Адрес из карточки клиента владельца фирмы отправителя</i> - если в ответственном филиале интеграции настроено "Скрывать отправителя"*** <i>Адрес отправителя из карточки заказа</i> - если он не пустой*** <i>Адрес из карточки отдела</i> - если пустой адрес отправителя в заказе*** <i>Адрес из карточки клиента отправившего заказ</i> - если пустой адрес отдела
Обратите внимание, что проставить коды с указанной датой отправки манифеста нельзя. Необходимо сначала очистить дату отправки, а затем проставить коды.
Агентская цена данной интеграцией <div style="color: #a94442; background-color: #f2dede; border: 1px solid #ebccd1; padding: 3px 10px 10px;">* Интеграция СДЭК версии 2.0 не возвращаетсяпредусматривает автоматическую отправку заказа после получения ошибки. Чтобы отправить заказ повторно после исправления, тобратитесь в техподдержку MeaSoft.к* Интеграция не предусматривает проверку номеров телефонов передаваемых заказов на соответствие стране. эти данные отсутствуют api СДЭК проверяет номера телефонов на соответствие списку стран после отправки заказа. Список стран номера телефонов которых принимаются без ограничений опубликованы в API PickPoint[https://api-docs.cdek.ru/29923926.html документации СДЭК]</div>
=== КСЭ ===При выборе тарифа для отправки заказа приоритет отдается тарифам режима срочности, выбранного в заказе. Если в режиме срочности не настроены тарифы, то тариф выбирается из списка в параметре интеграции '''Приоритет тарифов'''. В этом случае отправка в СДЭК осуществляется первым доступным тарифом из списка.
Настройки интеграцииДоступные для выбора списки тарифов по умолчанию:* '''Данные отправителя''' - данные«Экономичная посылка», которые будут подставляться во все отправления, передаваемые в КСЭ. Если не указать* «Посылочка», то будут передаваться данные заказчика (отправителя) из корреспонденции.* '''Является ИМ''' «Экспресс- признак отправителя в системе КСЭ. От данного признака зависит главным образомлайт», как отправляются данные в КСЭ. Признак указывается в договоре клиента с КСЭ.* '''Забор''' - настройка, в которой можно указать, каким образом отправление передается в КСЭ - КСЭ забирает отправление у клиента или клиент сам привозит отправление в КСЭ«Магистральный экспресс».
=== DOSTAVKAТакже возможно выбрать второй вариант, который поменяет местами тарифы «Экономичная посылка» и «Посылочка».* «Посылочка»,* «Экономичная посылка»,* «Экспресс-лайт»,* «Магистральный экспресс».GURU ===
При настройке интеграции в CRM- или CMS-системе введите следующие учетные данные:* логин — ID клиента DOSTAVKA.GURU. ID клиента отображается вверху страницы личного кабинета клиента DOSTAVKA.GURU;* пароль — запросите API-ключ интеграции у DOSTAVKA.GURU;* код курьерской службы — 90017весе отправления больше 30 кг применяется тариф «Магистральный экспресс».
== Тарификация и выбор подрядчика и его тарифа клиентом ==Вы можете настроить подключение своего тарифа к тарифу партнера. Партнерами могут быть любые компании, работающие в системе MeaSoft, а также ряд компаний, с которыми у нас есть интеграцииЧтобы передать услугу «Примерка», см. список ниже. Для этого откройте установите флажок '''СправочникиПринято на склад''' > '''Статусы''', выберите '''17 Виды срочности'''. Создайте вид срочности, например «СДЭК». В контекстном меню выберите '''Дополнительная информация''' и во второй строке заполните параметры подключения к партнеру через запятую:* 1-й параметр — код филиала партнера, его можно посмотреть в '''Справочники''' > '''Межгород''' > '''Филиалы''';* 2-й параметр — экстра-код партнера в системе MeaSoft. В том числе для сторонних компаний есть коды, см. таблицу ниже;* 3-й параметр — имя пользователя в системе партнера. Может отличаться от того, под которым работает интеграция, здесь нужно для расчета цены для клиента. В таблице ниже указано, что вводить для каждого интегратора;* 4-й параметр — пароль пользователя из 3-го параметра. В таблице ниже указано, что вводить для каждого интегратора;* 5-й параметр — вид срочности партнера. Посмотреть доступные коды видов срочности можно по ссылке в таблице ниже, в калькуляторе в выпадающем списке[[Единица корреспонденции#Создание единицы корреспонденции|карточке корреспонденции]]. Можно в одинарных кавычках указать несколько видов срочности через запятую, тогда система будет стараться выбрать из них первый доступный;* 6-й параметр — наценка к цене, передаваемой подрядчиком. В деньгах или в процентах, если стоит знак процента. Например, 10 — наценка 10 рублейЕсли услуга не нужна, 10% — наценка 10 процентовснимите флажок.
{|class="wikitable"!Интеграция!Код экстра!Виды срочности!Авторизация!Пример строки|-|БОКСБЕРРИ||90001||https://home.courierexe.ru/90001/calculator||Введите токен в 4-й параметр. 3-й можно оставить пустым. Можно оба оставить пустыми для расчета базовых цен.||33, 90001,, j3ejwo2f10b2e47790174b41f4a11111, 2, 50|-|ПИКПОИНТ||90002||https://home.courierexe.ru/90002/calculator||3-й параметр — логин, 4-й — через запятую пароль и договор ИКН. Можно оставить пустыми, но цены будут не все.||33, 90002,us0111, '6rGGuqRsW2qNQ,9990721312', 2, 50|-|CDEK||90005||https://home.courierexe.ru/90005/calculator||Введите код учетной записи в 3-й параметр, секретный При передаче валюты наложенного платежа код — в 4-й. Можно оба оставить пустыми для расчета базовых цен.||45491, 90005, hfenJwlasiPr4pnFENpaVXSKPIn5Trh7i, 9vkQgWuiZgEj9fGCB8a6Xj3desnJkwsl, 5, 30%|-|КСЭ||90008||https://home.courierexe.ru/90008/calculator||Введите логин в 3-й параметр, пароль — в 4-й. Пустыми оставить нельзя.||12504, 90008, Рога и копыта, 4CCB11864D06157, валюты берется из поля '2, 3, 6', 10%|-|ПОЧТА РОССИИ||90010||https://home.courierexe.ru/90010/calculator||<!--Введите "логин отправки" в 3-й параметр, а в 4-й в одинарных кавычках через запятую пароль отправки и токен. Пустыми оставлять нельзя, т.к. интеграция с Почтой пока не позволяет рассчитывать цены без договора (авторизации).-->Пока поддерживаются только базовые тарифы, без авторизации.||10497, 90010,,, '2, 1Валюта', 10 <!--10497, 90010, 89251234567, 'mypassword,u23B0r9AAJ1Fyh4ptMzJ3kjxcslamwdx', '2, 1'карточки клиента, 10-->|-|rowspan="2"|ДПД||rowspan="2"|90011||rowspan="2"|https://homeот которого передается заказ.courierexeВалюта должна совпадать с валютой страны назначения заказа.ru/90011/calculator||Введите клиентский номер в 3-й параметр, клиентский ключ в 4-й. Можно оставить пустыми для базовых тарифов.||12504, 90011, 1019003662, '4CCB11864D06157A5934A9119F2A0AAAAAB4CCE8,D117', '3, 6', 10%|-||Если вы доставляете товар заказ отправляется в пункт отправления самостоятельнодругую страну, после пароля добавьте запятую создайте копию клиента с нужной валютой и код ПВЗоформляйте заказы от него, а в настройке режима срочности введите пароль в кавычках.||'4CCB11864D06157A5934A9119F2A0AAAAAB4CCE8,D117'|-|ДОСТАВКА ГУРУ||90017||https://home.courierexe.ru/90017/calculator||3-й параметр — ID партнера в системе DOSTAVKA.guru, 4-й — ключ доступа. Можно оставить пустыми.||10497, 90017, 9999, cc03e747a6afbbcbf8be7668acfebee5, '1', 100|-|5Пост||90020||https://home.courierexe.ru/90020/calculator||3-й параметр — API-ключ, 4-й — уникальный номер партнера указывая цены в системе 5postвалюте страны назначения. При необходимости в 4-м параметре можно через запятую указать пороговое значение веса (по умолчанию 3 кг). Пустыми оставить нельзя.||10497, 90020, u23B0r9AAJ1Fyh4ptMzJ3kjxcslamwdx, 1, 100|}
При выборе клиентом В общем случае интеграция не поддерживает отправки в личном кабинете вида срочностидругие страны, подключенного таким образом к партнеру, набор доступных ПВЗ будет ограничен выбранным партнеромкроме России.
При отправке заказа [http://courierexe.ru/download/userfunc/SDEK_report_load.xml Загрузка отчета СДЭК] создает входящий АПД по отчету СДЭК [http://courierexe.ru/download/userfunc/SDEK_report_demo.xls такого формата]. Работает при передаче заказов в СДЭК с помощью штатной интеграции с подключенным видом срочности интеграция постарается отправить заказ одним из режимов, введенных в п.6 (по порядку, Заполняет поле '''Агентская цена''' в порядке приоритетов), а если не получится — вернет ошибкукарточке корреспонденции на вкладке '''Межгород'''.
Также можно для любой компании войти в личный кабинет по адресу вида https=== DPD ===<div style="color: #a94442; background-color: #f2dede; border: 1px solid #ebccd1; padding:3px 10px 10px;"><b>Внимание!<//homeb><br> Для одного аккаунта DPD может быть настроена только одна интеграция.courierexe<br>Если вам требуется настроить интеграцию для нескольких филиалов, предварительно создавайте новый аккаунт DPD для каждой интеграции.ru</90005 div>Статусы заказов передаются корректно, где только если для одного аккаунта DPD настроена одна интеграция. <br>При выборе тарифа для отправки заказа приоритет отдается тарифам режима срочности, выбранного в конце — экстра-код партнера, авторизоваться данными из 3-го и 4-го параметров (см. таблицу выше) и воспользоваться калькулятором с тарифами именно вашей компаниизаказе.
== Интеграция Для настройки интеграции с клиентами (получение заказов) ==платформой DPD укажите следующие параметры:* '''Клиентский номер''' - уникальный клиентский номер в системе DPD.* '''Клиентский ключ''' - ключ для авторизации, полученный у сотрудника DPD.* '''Код пункта самопривоза''' - не обязательный параметр. код пункта самовывоза, куда клиент DPD доставляет заказ для отправки.* '''Номер регулярного заказа''' - номер регулярного заказа DPD. Если вы используете доставку на регулярной основе, уточните этот номер у своего менеджера.* '''Проверка комплектности''' - по умолчанию отсутствует. Есть возможность выбрать одно из значений:
<ul><ol><span style="color: blue; margin-right: 10px;">○</span>Отсутствует</ol><ol><span style="color: blue; margin-right: 10px;">○</span>С примеркой</ol><ol><span style= Замечания =="color: blue; margin-right: 10px;">○</span>Простая</ol><ol><span style="color: blue; margin-right: 10px;">○</span>С проверкой работоспособности</ol></ul>
# В модулях систем '''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].=== TopDelivery ===
=== OpenCart ===Для настройки интеграции с платформой TopDelivery укажите:* '''Логин'''* '''Пароль'''* '''Информация о поставщике товара'''. Если указано '''Отправлять''', то при отправке заказа будет предпринята попытка отправить место с габаритами и товарами с указанием данных поставщика: ИНН, наименование, номер телефона. Если данных поставщика нет, информация об ошибке отправки мест будет добавлена в сообщение к заказу. Информация о поставщике повторно не отправляется.* '''Вскрытие отправления до получения оплаты''' - по умолчанию разрешено.<br>Возможность запрета вскрытия отправления добавляется при отправке заказа, если в настройках интеграции разрешен запрет и в заказе стоит отметка "Принято на склад"
==== OpenCart 1[[Файлы для загрузки#.5D0.59F.1 ====D0.B5.D1.87.D0.B0.D1.82.D0.BD.D1.8B.D0.B5 .D1.84.D0.BE.D1.80.D0.BC.D1.8B .D0.B4.D0.BB.D1.8F .D0.BC.D0.B0.D0.BD.D0.B8.D1.84.D0.B5.D1.81.D1.82.D0.BE.D0.B2|Печать наклеек для TopDelivery]]
Важно! Перед любыми изменениями настроек рекомендуется сделать резервную копию сайта.=== Почта России ===Для настройки синхронизации:# Загрузите содержимое папки upload из архива в папку сайта по FTP. При необходимости подтвердите замену файлов.# Зайдите в панель администратора OpenСart. Подробнее см. Интеграция с Почтой России описана в [https://docs.ocstore.com/index.php?title=Панель_Администратора документации OpenCart].# В меню панели управления выберите '''Дополнения''', раздел '''Модули'''. В открывшемся списке найдите '''КС2008''' и нажмите на кнопку '''Установить'''.# В меню панели управления выберите '''Дополнения''', раздел '''Доставка'''. В открывшемся списке найдите '''Основные настройки интеграции КС2008''' и нажмите на кнопку '''Установить'''. Рядом появится кнопка '''Изменить'''.# Нажмите на кнопку '''Изменить'''. Откроется страница «Основные настройки интеграции КС2008»:разделе [[Файл:OpenCart.png|900px%D0%A0%D0%B0%D0%B1%D0%BE%D1%82%D0%B0 %D1%81 %D0%9F%D0%BE%D1%87%D1%82%D0%BE%D0%B9 %D0%A0%D0%BE%D1%81%D1%81%D0%B8%D0%B8|noneРабота с Почтой России]]<br>Заполните обязательные поля:#* '''Логин''' — логин пользователя, выдается курьерской службой.#* '''Пароль''' — пароль пользователя, выдается курьерской службой.#* '''Код курьерской службы''' — выдается курьерской службой.#* '''Город отправителя'''. После ввода убедитесь, что в названии населенного пункта нет ошибок.<br>При необходимости заполните остальные поля. Нажмите на кнопку '''Сохранить'''.# В меню панели управления выберите '''Дополнения''', раздел '''Доставка'''. В открывшемся списке найдите '''Настройки доставки курьером КС2008''' и нажмите на кнопку '''Установить'''. Рядом появится кнопка '''Изменить'''.# Нажмите на кнопку '''Изменить''' и в поле '''Тариф для расчета стоимости доставки''' выберите нужный тариф. По умолчанию используется первое значение выпадающего списка.
==== OpenCart 2.0 и выше =PickPoint ===Если PickPoint выделил вам диапазон трекинг-номеров, то необходимо настроить филиал и придерживаться последовательности отправки [[Манифесты#Отправка|манифестов]].
===== Настройка Чтобы настроить филиал для интеграции =====PickPoint с диапазоном, в основном меню выберите '''Справочники''' > '''Межгород''' > '''Филиалы''', откройте карточку [[Филиалы|филиала]] и на вкладке '''Интеграция''' в выпадающем списке '''Правила назначения кода заказа у подрядчика''' выберите '''Из диапазона'''. Укажите начальный и конечные коды диапазона, префикс при необходимости и нажмите клавишу '''ОК'''.
# Скачайте [[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».# Заполните обязательные поля:#* '''Логин''' — логин пользователя, выдается курьерской службой.#* '''Пароль''' — пароль пользователя, выдается курьерской службой.#* '''Код курьерской службы''' — выдается курьерской службой.#* '''Наценка на доставку (множитель)''' — множитель наценки на стоимости доставки. Если наценки нет, установите 0.#* '''Наценка на доставку (добавочная)''' — конкретная величина наценки на стоимость доставки. Если наценки нет, установите 0.#* '''Ваш город''' — город отправителя. После ввода убедитесь, что в названии населенного пункта нет ошибок.<br>При необходимости заполните остальные поля. Нажмите на кнопку '''Сохранить''' в правом верхнем углу.# В разделе '''Доставка''' найдите '''Настройки доставки курьером КС2008''' и нажмите на кнопку '''Установить'''. Рядом станет активна кнопка '''Редактировать'''. # Нажмите на кнопку '''Редактировать''' и в поле '''Тариф для расчета стоимости доставки''' выберите нужный тариф. По умолчанию используется первое значение выпадающего списка.
===== Изменение данных заказа =====После этого можно указать дату отправки манифеста.
# В административной части сайта откройте заказ и вверху справа нажмите на кнопку [[Файл:OpenCartEditОбратите внимание, что проставить коды с указанной датой отправки манифеста нельзя.png|25 px]].# В режиме редактирования данные заказа представлены на пяти вкладках. Измените данныеНеобходимо сначала очистить дату отправки, для перемещения по вкладкам используйте кнопки '''Продолжить''' и '''Назад'''.# На вкладке '''Итоги''' проверьте введенные данные и нажмите на кнопку '''Применить''' для сохранения изменений в каждой строке.# Нажмите на кнопку '''Сохранить'''а затем проставить коды.
==== Возможные ошибки ====Агентская цена интеграцией не возвращается, так как эти данные отсутствуют в API PickPoint.
* Ошибка локализации. Чтобы переключить язык сайта на русский, сверьте названия папок локализации в скачанном архиве модуля (\upload\admin\language) и в созданном после установки модуля каталоге. Названия папок должны быть одинаковыми, например ru-ru и en-gb. Если в результате установки появилась папка с другим именем, перенесите ее содержимое в нужную папку.=== КСЭ ===* При возникновении ошибок:*# В панели управления выберите '''Менеджер дополнений''' ('''Модификаторы''') Для обращения к функциям системы необходимо знать своё имя пользователя и пароль в правом верхнем углу страницы нажмите на кнопку '''Обновить'''системе КСЭ.<br> *# Очистите кэш везде — в панели состоянияЕсли у вас еще нет доступа, то необходимо обратится к Вашему менеджеру в дополнительных модулях, в браузере и т.п.*# Проверьте работу модуля.*: Для OpenCart 3.0 и выше с установленным модулем Simple установите [https://courierexe.ru/download/api/liveopencart.modtwigfix30356.ocmod.zip| модификатор] и выполните шаги 1-3подразделение клиентского сервиса КСЭ.<br>
=== 1C-Битрикс===Чтобы настроить интеграцию:# В личном кабинете 1C-Битрикс на вкладке '''Администрирование''' в панели слева выберите '''Marketplace''' <b> '''Каталог решений''' и на странице «Каталог Маркетплейс» с помощью строки поиска найдите '''Модуль Настройки интеграции MEASoft'''.# Щелкните по ссылке «Установить».# Убедитесь, что в строке '''Модуль интеграции MEASoft''' установлен флажок, и нажмите на кнопку '''Загрузить'''. Далее примите лицензионное соглашение и нажмите '''Применить'''.# После окончания загрузки нажмите на кнопку '''Установить'''.# В панели слева выберите '''Магазин''' :</b> '''Настройки''' <br> '''Службы доставки''', затем на странице «Список служб доставок» раскройте выпадающий список кнопки '''Добавить''' и выберите пункт '''Автоматизированная служба доставки'''. Откроется страница «Новая служба доставки».# На странице «Новая служба доставки» перейдите на вкладку * '''Настройки обработчика''' и в выпадающем списке '''Служба доставкиЛогин''' выберите '''"Курьерская служба" - сервис доставки'''. Нажмите на кнопку '''Применить'''.логин от ЛК КСЭ# Перейдите на вкладку * '''Настройки интеграцииПароль''': [[Файл:Bitrix Настройки интеграции.png|none|1100px]]#: На этой вкладке:- пароль от ЛК КСЭ#* в разделе '''Настройка доступаДанные отправителя''' введите учетные — данные личного кабинета , которые будут подставляться во все отправления, передаваемые в поля '''Логин'''КСЭ. Если не указать, '''Пароль''' и '''Код клиента'''. Запросите эти то будут передаваться данные у курьерской службы, с которой настраивается интеграция. Поле '''Код клиента ПВЗ''' оставляем пустым заказчика (оно заполнится автоматически позднееотправителя)из корреспонденции.#* в разделе '''Основные настройкиЯвляется ИМ''':#** — признак отправителя в поле '''Статус отправки заказа''' выберите статуссистеме КСЭ. От данного признака зависит главным образом, при котором заказ будет отправляться как отправляются данные в курьерскую службу;#** КСЭ. Признак указывается в поле '''Оплата картой''' выберите тип оплаты, который будет соответствовать оплате картой (если оплата картой возможна);договоре клиента с КСЭ.#** установите флажок '''Использовать артикулыЗабор''' — настройка, если артикулы будут использоваться для привязки номенклатуры к складу курьерской службы;#* в разделе '''Соответствующие поля покупателя''' настройте соответствие полей получателя (ФИОкоторой можно указать, города, адреса и др.) полям каким образом отправление передается в форме создания заказа.# На вкладке '''Ценовая политика доставки''' при необходимости настройте стоимость доставки для покупателя КСЭ — КСЭ забирает отправление у клиента или клиент сам привозит отправление в зависимости от стоимости заказаКСЭ.# На вкладке '''Ограничения** ''' при необходимости укажите ограничения работы модуля по географии, типам оплаты и т.п.# По завершении настройки нажмите на кнопку умолчанию'''Сохранить'''.# В настройках магазина укажите его местоположение — груз будет принят для определения города отправителя.#: Если нужно производить расчет для другого города отправителя доставки в офисе (например, физически магазин находится самопривоз в областиКСЭ) для всех заказов с товарной составляющей, а курьерская служба должна считать доставку, как по городу):иначе будет послан курьер для забора.#* в разделе * '''Рабочий столДо двери''' > '''Настройки''' > '''Настройки продукта''' > '''Настройки модулей''' > '''Курьерская служба''' в поле '''Города-отправители''' добавьте город отправителя; — будет послан курьер для забора#* в разделе * '''Рабочий столСамопривоз в КСЭ''' > '''Магазин''' > '''Настройки''' > '''Службы — груз будет принят для доставки''' > Нужная служба > '''Настройки интеграции''' > '''Город отправитель''' укажите добавленный выше город.в офисе
Чтобы отправить заказ в курьерскую службу, зайдите в карточку При выборе тарифа для отправки заказаприоритет отдается тарифам режима срочности, укажите настроенное значение выбранного в поле '''Статус отправки заказа''' и нажмите на кнопку '''Сохранить'''заказе.
* '''ПримечаниеАдрес получателя'''. Значения полей ** '''Комментарий покупателя к заказуКак указано в заказе''' и ** '''Комментарий менеджераСклад курьерской службы''' передаются из 1С-Битрикс в поле '''Комментарий''' этом случае, адрес получателя указывается, как адрес ответственного филиала, для которого настроена интеграция, а адрес отправителя, как адрес реального отправителя, указанного в карточке заказа в системе MeaSoft.(для забора курьером у отправителя и доставки на склад курьерской службы)
Если статус уже установлен, но заказ не отправлен в курьерскую службу (связано с техническими особенностями):# Выберите статус заказа по умолчанию после его создания (например, '''Новый''').# Перезагрузите страницу.# Выберите статус отправки и сохраните его.При отправке заказа появится сообщение об успешной отправке или об ошибкезаказов учитывается тип отправления.Статус заказа можно проверить Если в карточке заказауказан тип [1] "Письмо", то вида груза в правом верхнем углуCSE устанавливается, как "Документы" [81dd8a13-8235-494f-84fd-9c04c51d50ec], иначе [4aab1fc6-fc2b-473a-8728-58bcd4ff79ba] "Груз".
Для предоплаченных заказов в карточке корреспонденции отображается сумма к оплате 0, при наличии товарных вложений добавляется вложение «Предоплата» с типом вложения '''Предоплата''' и ценой, равной сумме предоплаты, со знаком «минус». Поддерживается только полная предоплатаРазные виды груза тарифицируются по разному.
'''Примечание'''. Проверить работу модуля можно в форме оформления доставки. При этом должна корректно считаться стоимость доставки<!--=== DOSTAVKA.GURU ===
<spoiler text="Если возникает ошибка"># Если не рассчитывается стоимость:#* некорректно установлен модуль;#* введены некорректные '''Настройка'''. Для интеграции введите следующие учетные данные;:#* в курьерской службе не настроен тариф. Обратитесь в курьерскую службу для настройки тарифа. После настройки тарифы можно проверить в личном кабинете, на вкладке '''КалькуляторИдентификатор клиента'''— ID клиента DOSTAVKA.# По умолчанию при оформлении заказа должны появиться поля даты и времени желаемой доставкиGURU. Если они отсутствуют, то у формы были изменены стилиID клиента отображается вверху страницы личного кабинета клиента DOSTAVKA. Также возможно обновление формы в системе Битрикс.[[Файл:Bitrix2.png|center|700 px]]GURU;# Проверьте правильность привязки свойств. Для этого в разделе * '''Рабочий столКлюч клиента''' > — запросите API-ключ интеграции у DOSTAVKA.GURU.* '''МагазинРегион откуда повезется заказ''' - Доступен выбор из трех вариантов:<ul><ol> '''Настройки''' <span style="color: blue; margin-right: 10px;"> '''Свойства заказа''' ○</span> '''Список свойств''' найдите свойствоПо договору (В этом случае, связанное мы не сообщаем о регионе отправки в систему Guru и регион определяется договором с ошибкой, щелкните по нему правой кнопкой мыши и выберите '''Изменить параметры свойства'''DOSTAVKA.GURU)</ol><ol><span style="color: blue; margin-right: 10px;">○<br/span>На вкладке '''Привязка свойства''' настраиваются условия, при которых поле будет показываться клиенту. Если у свойства заказа настроена привязка, то оно будет показываться ТОЛЬКО в том случае, когда покупатель выберет хотя бы один из указанных критериевМосква</ol><ol><span style="color:[[Файлblue; margin-right:Битрикс Связь свойства.png|center|500px]]10px;">○</span> Санкт-Петербург</ol></ul>
В этом примере покупатель при оформлении заказа увидит созданное поле для заполнения только в том случае, если на предыдущих шагах он выбрал оплату '''Наличными курьеруЗапрещенные символы''' (при любой службе доставки). Перед отправкой номер заказа и имя получателя проверяются на наличие запрещенных символов. Если обнаружены запрещенные символы, или же если захотел расплатиться любым способом, но выбрал заказ не отправляется в качестве службы доставки '''Воздушный транспорт'''интеграцию и получает ошибку. Из других текстовых полей запрещенные символы удаляются. Это не приводит к получению ошибки. При проверке имени получателя и других текстовых полей используется сокращенный список запрещенных символов.
Свойство будет показано всегдаСокращенный список недопустимых символов для текстовых полей:<code>['~', если привязка не выбрана или если выбраны все варианты платежных систем или служб доставки.'`', '@', '#', '$', '%', '^', '&', '=', '+', '!', '"', '№', ';', ':', '?', '\']</code>
Подробнее см. Полный список недопустимых символов:<code>[https'~', '`', '@', '#', '$', '%', '^', '&', '=', '+', '!', '"', '№', ';', '://dev.1c-bitrix.ru/learning/course/index.php', '?COURSE_ID=42&LESSON_ID=3073&LESSON_PATH=3912', '\', '\s', '*', '(', '_', '{', '}', '.4580.4828.3073 документацию 1С-Битрикс', ',', '\[', '\]', '\'].</spoilercode>
=== InSales ===Для удобства работы до настройки интеграции создайте в InSales следующие пользовательские статусы:* статус для автоматической передачи заказов в курьерскую службуКроме того,* статус для обозначения заказа с ошибкой передачи данных.Чтобы настроить статусы, в панели администрирования InSales выберите '''Настройки''' > '''Оформление заказа''' > '''Пользовательские статусы''' и создайте статусы, например «Передано в КС» и «Ошибка»штрихкодов недопустима кириллица.
Чтобы настроить интеграцию:# В личном кабинете InSales откройте '''Приложения''' > '''Центр приложений''', с помощью строки поиска найдите модуль «Курьерская служба 2008» и нажмите на кнопку '''УстановитьСтатусы'''.# Откроется личный кабинет InSales. На странице «Установка приложения» нажмите на кнопку '''Установить'''.# В списке установленных приложений выберите «Модуль "Курьерская служба 2008"». Откроется страница авторизации личного кабинета клиента курьерской службы. Если вы авторизованы Запрашиваются интеграцией в ЛК курьерской службы, то сразу откроется страница настроек, см. павтоматическом режиме. 5.# Введите учетные данные личного кабинета в поля '''Логин''', '''Пароль''' и '''Код курьерской службы'''. Запросите эти данные у курьерской службы, с которой настраивается интеграция.# На странице «Настройка интеграции "Insales"» выполните настройку интеграции.<br>Особенности заполнения полей:#* '''Отправлять заказы в курьерскую службу автоматически после изменения Изменение статуса'''. Используется для автоматической передачи заказов с определенным статусом в курьерскую службу. Возможные значения: '''Да''', '''Нет'''.#* '''Статус отправления заказа в курьерскую службу (если отправляется автоматически)'''. Выберите из выпадающего списка заранее созданный статус, который будет использоваться для автоматической передачи заказов в курьерскую службу.#* '''Отправлять статус заказа в Insales'''. Определяет, отправляется ли статус успешной доставки заказа в InSales. Возможные значения: '''Да''', '''Нет'''.#* '''Отправлять артикулы (для привязки к складу)'''. Если опция включена, артикулы товаров из InSales передаются в MeaSoft. #* '''Название доставки курьером на странице заказа'''. Укажите название доставки, которое будет отображаться в заказе вместо «Курьерская доставка МЕАСОФТ» при выборе способа доставки. Можно оставить поле пустым, тогда список будет выглядеть следующим образом:[[Файл:Insales Delivery.png|none|800 px]]#* '''Описание доставки курьером на странице заказа'''. Укажите описание вида доставки. Можно оставить поле пустым.#* '''Переводить заказ в специальный стороне Guru изменит и статус в случае ошибки передачи заказа?'''. Определяет, используется ли специальный статус для обозначения заказов с ошибкой передачи данных. Возможные значения: '''Да''', '''Нет'''.#* '''Синхронизировать остатки по складам'''. Если опция включена, данные по складским остаткам из курьерской службы передаются в InSales.#* '''Используется мультисклад?'''. Определяет, используется ли выбор товаров с одного склада или из нескольких. Возможные значения: '''Да''', '''Нет'''. В случае работы с несколькими складами убедитесь, что в настройках InSales ('''Настройки''' > '''Настройки магазина''' > '''Мультисклад'''.) указано такое же количество складов, как в системе MeaSoft.#* '''Специальный статус на случай ошибки передачи заказа'''. Выберите из выпадающего списка заранее созданный статус, который будет использоваться для обозначения заказов соответствии с ошибкой передачи данных.# По заполнении нужных полей нажмите '''Сохранить'''картой статусов.
В результате в InSales в окне создания заказа появляется блок «Модуль "Курьерская служба 2008"»:::[[Файл:Insales Module KS.png|none|400 px]]Тип оплаты заказа определяется следующим образом:* если заказ оплачен, то передается тип оплаты '''Оплачен''';* если тип оплаты '''Оплата банковской картой''' или '''Оплата банковской картой курьеру''', то передается тип оплаты '''Банковская картаАгентская цена'''. Указанные типы оплаты необходимо создать в InSales вручную: '''Настройки''' > '''Оформление заказа''' > '''Оплата''';* иначе передается тип оплаты '''Наличными'''Обновляется при получении статусов.В системе MeaSoft Агентская цена Guru публикуется в карточке интернет-магазина есть флажок '''Спрашивать тип оплаты у получателя'''. Если он установленразрезе стоимости услуг и тарифов, то независимо от переданного типа оплаты '''Наличными''' или '''Банковская карта''' покупателю будет предложен выбор способа оплатыкоторые суммируются перед обновлением агентской цены в заказе.
Настройки интеграции можно изменить в разделе '''АвтоматизацияВозвраты''' [[Личный кабинет клиента#Автоматизация|личного кабинета MeaSoft]].Учитываются только при получении заказом статуса '''Частичная доставка'''.-->
=== RetailCRM 5POST ===Параметры для настройки:* '''API-ключ'''* '''Код склада отправителя'''* '''Уникальный номер партнера в системе 5Post'''* '''Максимальный вес для фиксированного тарифа''' - При привышении установленного веса, сумма тарифа изменяется пропорционально. По умолчанию 3кг.* '''Код подрядчика в карточке заказа''' - доступно три вида отображения кода подрядчика:<ul><ol><span style="color: blue; margin-right: 10px;">○</span> Оригинальный код 5post - Установлено по умолчанию</ol><ol><span style="color: blue; margin-right: 10px;">○</span> Код для поиска заказа в ЛК 5post</ol><ol><span style="color: blue; margin-right: 10px;">○</span> Код грузоместа</ol></ul>* '''Габариты мест'''<ul><ol><span style="color: blue; margin-right: 10px;">○</span> Группировать - Установлено по умолчанию<br>При установке этого значения, всегда передается только одно место с обобщенными габаритами и кодом соответствующим коду заказа.</ol><ol><span style="color: blue; margin-right: 10px;">○</span> Отправлять указанные<br>При установке этого значения, каждое место отправляется отдельно, с соответствующими ему габаритами и кодом.</ol></ul>
Чтобы настроить интеграцию:# В RetailСRM cоздайте API-ключ. Для этого откройте '''Администрирование''' > '''Интеграция''' > '''Ключи доступа к API''' и нажмите на кнопку '''Добавить'''. Откроется страница «Новый ключ API». На этой странице:## В поле '''Комментарий''' введите краткое описание интеграции, например «По городу».## В поле * '''Тип доступа''' выберите 'расчета тарифа''Доступ ко всем магазинам'''.## В списке '''Разрешенные методы API''' установите все флажки.<ul>## Нажмите на кнопку '''Сохранить'''.#<ol><span style="color: API-ключей может быть несколько, и для каждого API-ключа необходимо выполнить эти настройки. Подробнее об управлении APIblue; margin-ключами см. [httpsright:10px;">○</span> Общий - Установлено по умолчанию</help.retailcrm.ru/Users/ApiKeys документацию RetailCRM].ol># Настройте интеграцию в [[Личный кабинет клиента#Интеграция|личном кабинете клиента MeaSoft]]<ol><span style="color:## Выберите пункт основного меню '''Автоматизация''', перейдите на вкладку '''Обратная интеграция''' и на странице «Список всех обратных интеграций» в строке RetailCRM нажмите '''Добавить'''. ## В окне «Настройка интеграции "RetailCRM"» укажите название интеграции, домен RetailCRM, созданный выше APIblue; margin-ключ. При необходимости укажите значения других полей.#right: Если нужно, чтобы в RetailCRM отображался статус платежа после доставки заказа, заполните поле '''Получать статус платежа (укажите символьный код статуса платежа)'''. Чтобы увидеть символьный код платежа, в RetailCRM выберите '''Администрирование''' 10px;"> '''Справочники''' ○</span> '''Статусы оплат'''.#: По завершении настройки нажмите '''Сохранить'''.# Настройте интеграцию в RetailCRM:## Откройте '''Администрирование''' местам</ol> '''Справочники''' и на вкладке '''Типы доставок''' нажмите на кнопку '''Добавить'''. Откроется окно «Новая доставка»:[[Файл:Retail1.png|none|700 px|]]## В этом окне заполните обязательные поля и в выпадающем списке '''Интегрировать с''' выберите значение '''"Курьерская служба 2008"''', затем нажмите '''Сохранить'''.## Чтобы настроить корректную передачу наложенного платежа, откройте '''Администрирование''' </ul> '''Интеграция''' и выберите модуль MEASOFT. Затем на странице «Настройки интеграции с Курьерская служба 2008» перейдите на вкладку '''Доставка''' и на панели справа выберите пункт '''Способы оплаты'''. Установите флажки для способов оплаты, которые могут использоваться для передачи наложенного платежа.[[Файл:Retail5.png|none|600 px]]
Чтобы проверить настройки В интеграции:5post не предусмотрена передача оригинальных штрихкодов мест. Штрихкоды генерируются по правилам 5post.# Перейдите в форму создания заказа и убедитесьПредварительно, 5post предоставляет возможность добавления оригинального штрихкода места, что в списке '''Способ доставки''' появилось соответствующее значение:[[Файлкоторый должен отвечать следующим правилам:Retail2.png|none|600 px]]# Нажмите '''Выбрать тариф'''. Тарифы должны передаваться из настроек курьерской службы:[[Файл:Retail3.png|none|600 px]]<br>В случае ошибки обратитесь в курьерскую службу для настройки тарифов. Проверить тарифы можно в ЛК в разделе '''Калькулятор'''.
Чтобы в RetailCRM формировать печатные формы, аналогичные формам в личном кабинете, используйте один * Штрихкод должен состоять только из следующих способов:* символов ASCII в сохраненном заказе на панели действий сверху нажмите '''Печать''' и выберите нужную печатную форму «Курьерская служба»;диапазоне с 0 по 127 индекса. * в списке заказов отметьте заказы флажками, внизу страницы нажмите '''Действия''' > '''Распечатать документы''' и выберите печатную форму «Курьерская служба»Длина штрихкода не должна превышать 34 символа.
Чтобы отправлять заказы в курьерскую службу по статусам и отменять при изменении типа доставки, используйте триггеры. Подробнее о настройке триггеров см. в разделе «[[Настройка триггеров для RetailCRM]]»=== Яндекс.Доставка ===
'''Примечание'''Для подключения к интеграции в вашем договоре с Яндекс. Интеграция привязана к личному кабинету клиента курьерской службыДоставкой должна быть подключена услуга доставки на следующий день. При необходимости работать из другого личного кабинета создайте новую интеграциюЕсли у вас эта услуга не подключена, начиная с пункта настройки в личном кабинетезаполните [https://forms.yandex.ru/surveys/10833592.0f3ead3120074ee64cd9dde1df70b27d8d2678d2/ эту форму].
=== csСначала необходимо проверить, рассчитывается ли стоимость доставки в ЛК Яндекса и можно ли оформить заказ. Если все работает - переходим к настройке интеграции.cart ===
Чтобы настроить интеграциюДля настройки интеграции с платформой Яндекс.Доставка укажите следующие параметры:*'''Токен''', можно посмотреть тут https://dostavka.yandex.ru/account/integration*'''ID пункта отправления''', необходимо уточнить у вашего менеджера или в поддержке Яндекса* '''Особенности формирования данных''' с вариантами на выбор:** ''нет''** ''Трактовать места, как товары'' - в заказе формируется только одно место в котором размещаются вложения с габаритами и массой переданных мест.** ''Трактовать товары, как места'' - каждый товар добавляется в место соответствующее его габаритам, т.о., сколько в заказе товаров, столько же будет сформировано мест.Эти параметры обязательные и влияют на отправку заказа. Доступы должны быть НЕ тестовые (продовые). Уточните эти данные у вашего менеджера или в поддержке Яндекс.Доставки.* '''Настройка списка ПВЗ''' - Позволяет настраивать список получаемых от Яндекс ПВЗ, доступны варианты:** ''Получать все доступные ПВЗ''** ''Отключить постаматы''** ''Отключить все ПВЗ''
# Скачайте архив модуля установки по [http://courierexe.ru/download/api/ms_courierexe-v1.1.1.zip ссылке].
# В панели администратора cs.cart откройте '''Модули''' > '''Управление модулями''' и на странице «Модули» нажмите на кнопку [[Файл:Cscart добавить.png|25 px]]. Откроется окно «Загрузить и установить модуль».
# В этом окне нажмите на кнопку '''Загрузить''', выберите архив с модулем на компьютере и нажмите на кнопку '''Загрузить и установить'''. Модуль «Курьерская служба 2008» появится в списке модулей.
# Откройте '''Администрирование''' > '''Доставка и налоги''' > '''Способы доставки''' и нажмите на кнопку [[Файл:Cscart добавить.png|25 px]]. Откроется окно «Новый метод доставки»:
#:<br>[[Файл:Cscart настройка.png|900px|none]]
#:
# В этом окне укажите следующие настройки:
#* в поле '''Расчет тарифа''' установите переключатель '''В режиме реального времени''';
#* в выпадающем списке '''Перевозчик''' выберите значение '''КС2008''';
#* в выпадающем списке '''Служба доставки''' выберите режим срочности по умолчанию;
#* заполните остальные поля.
# Нажмите на кнопку '''Создать'''. Появляется оповещение о том, что изменения сохранены, и в этом же окне появляются кнопки настройки. Нажмите на кнопку '''Настроить''':
#:<br>[[Файл:Cscart курьером.png|800 px|none]]
#:
# В этом окне укажите следующие настройки:
#* введите учетные данные клиента курьерской службы. Запросите эти данные у курьерской службы, с которой настраивается интеграция;
#* Укажите тип доставки. Возможные значения: '''Курьером до двери''', '''ПВЗ'''.
# Нажмите на кнопку '''Сохранить'''.
Чтобы проверить работу интеграции, нажмите на кнопку '''Общее''', нажмите '''Рассчитать стоимость доставки''', введите вес отправления и нажмите на кнопку '''Тест'''. При настроенной интеграции отобразится окно с расчетной стоимостью и сроком доставки.
Чтобы создать два способа доставки — '''Курьером до двери''' и '''ПВЗ''', повторите все шаги, начиная с п. 4.Для настройки модулей используйте:
В результате новые способы доставки будут отображаться в списке *'''АдминистрированиеЛогин''' > '''Доставка и налоги''' > '''Способы доставки''' и в окне создания заказа:- ваш токен.
::[[Файл:Cscart оформить заказ*'''Пароль''' - Код пункта отправления.png|700 px|none]]Имеет вот такой формат 4eccdad3-8d97-4fbf-b241-3c2a89a8aa79
Чтобы просмотреть полученные заказы, откройте *'''Заказы''' > '''Полученные заказыКод курьерской службы'''- 90023. В карточке заказа в правом нижнем углу находится блок модуля «Курьерская служба 2008»:
::[[Файл:Cscart блок кс==== Настройка забора ====Забор в заказе определяется <i>Пароль - Код пункта отправления</i> (ID Станции на стороне Яндекс), если <i>Пароль</i> указывает на склад клиента, с которого курьер Яндекса будет забирать отправления, согласно расписанию календаря отгрузок.png]]<br>Календарь отгрузок настраивается в личном кабинете Яндекс. <br>Склад отгрузки так же добавляется в личном кабинете Яндекс.<br>
Чтобы передать заказ в курьерскую службу<div style="color: #a94442; background-color: #f2dede; border: 1px solid #ebccd1; padding: 3px 10px 10px;">Настроить забор можно только на стороне Яндекс, нажмите [https://yandex.ru/support2/delivery-profile/ru/other-day/rules#from-warehouses согласно инструкции]. </div><br>Для получения ID Станции отправления, требуется на ссылку '''Отгрузить'''.стороне Яндекс:
Также * 1. Добавить склад в этом блоке вы можете проверить статус доставки заказаИзбранные адреса, по инструкции в ссылке.* 2. Запланировать отгрузку на этот склад через Календарь отгрузок.* 3. Написать на почту в техподдержку Яндекс <span style="color: #0011ff;">next_day_delivery@go.yandex.ru</span> или чат поддержки в личном кабинете и запросить у специалиста техподдержки Яндекс ID Станции (склада, который был зарегистрирован, согласно инструкции).
=== amoCRM ===
Интеграция реализована через виджет «Курьерская служба 2008»При создании заказа обратите внимание на адрес — он должен быть понятным. Наиболее понятным для Яндекса будет адрес, предназначенный для передачи заказов из amoCRM в MeaSoft и возврата статусовгде нет дополнительных комментариев, а части адреса разделены запятыми. Без заполнения адреса с указанием номера дома курьерская доставка будет не доступна.
Чтобы начать отправлять В интеграцию не принимаются заказы на юридические лица. Т.е. в курьерскую службуполе ФИО должно быть именно ФИО, настройте интеграцию с MeaSoft и сопоставьте поля amoCRM и виджета для корректной передачи данных в MeaSoftа не название организации.
==== Настройка интеграции ====Для удобства работы перед настройкой интеграции добавьте дополнительные поля Если заключен договор на передачу в сделке: выберите '''Сделки''' > '''Новая сделка''' Яндекс уже оплаченных товаров и производится попытка отправить запрос на передачу заказа с типом оплаты «Наличными» - Яндекс возвращает ошибку «Тариф не найден». Если клиент оплачивает заказ на вкладке '''Настроить''' добавьте сайте, затем передает в любую группу новые поля '''Стоимость доставки''', '''Стоимость товаров'''доставку, '''Закупка'''необходимо передавать значение «NO».
[[Файл:Amo SettingsОтправка заказов происходит автоматически. Если адрес не распознан и заказ не отправлен с первой попытки, интеграция попытается разобрать адрес доступными ей средствами и снова отправить заказ. Если заказ так и не получилось отправить, проверьте адрес получателя, возможно, в нем допущена ошибка. После исправления адреса заказ отправится автоматически.png|none|500 px]]
Чтобы настроить интеграцию При отправке заказа обязательно указываются места с amoCRM:# Этот этап можно делать из [[Личный кабинет клиента#Интеграция|личного кабинета MeaSoft]] '''ИЛИ''' из административной части amoCRM:#* В личном кабинете MeaSoft:#*# В разделе '''Автоматизация''' перейдите на вкладку '''Обратная интеграция''' габаритами и в таблице «Список всех обратных интеграций» в строке «AmoCRM» нажмите '''Добавить'''массой.#*#Укажите название интеграции и префикс и нажмите на кнопку '''Сохранить'''.#*#Укажите аккаунт amoCRM, в котором будет установлен виджет «Курьерская служба 2008» и нажмите '''Разрешить'''. Виджет установлен.#* В административной части amoCRM:#*# В меню выберите '''Настройки''' > '''Интеграции''' и Если в строке поиска введите «Курьерская служба 2008».#*#Щелкните по найденному модулюзаказе указаны места, нажмите на кнопку '''Установить'''они добавляются как есть. Виджет установлен.# В amoCRM выберите '''Настройки''' > '''Интеграции''' и Если мест в разделе '''Установленные интеграции''' откройте «Курьерская служба 2008».# Введите логинзаказе нет, пароль и код курьерской службы. Запросите эти данные у курьерской службыто создается одно фиктивное место, с которой настраивается интеграция.# Нажмите габариты которого формируются на кнопку '''Настройки виджета'''основе габаритов вложений. В окне «Настройки интеграции с Курьерская служба 2008»:## Установите параметры товаров Вложения не разделяются по местам и доставки.## Установите поля для сохранения данных заказа. Например, в выпадающем списке поля '''Сохранять стоимость товаров в отдельное поле''' укажите значение '''Сохранять попадают в поле: Стоимость товаров'''.## Укажите, откуда будут добавляться товары к заказу. Если это список в amoCRM, настройте соответствие полей. Списки amoCRM доступны начиная с тарифного плана «Расширенный».## Установите соответствие между статусами в личном кабинете клиента курьерской службы и статусами amoCRM.## Нажмите '''Сохранить настройки'''.# В окне ввода учетных данных интеграции нажмите '''Сохранить'''первое сформированное место.
==== Сопоставление полей ===={|class="wikitable"!Поле виджета!Данные amoCRM!Где настраивается сопоставление|-|'''Имя''', '''Телефон'''||Поля карточки контакта||-|-|'''Номер заказа'''||• Название сделки;<br>• ID сделки;<br>• пользовательское поле||'''Настройки виджета''' > '''Настройки После настройки модуля или создания новой интеграции с Курьерская служба 2008'''|-|'''Город''', '''Адрес''', '''Индекс''', '''Примечание''', '''Дата доставки'''|| Поля сделки|| '''Настройки виджета''' > '''Настройки интеграции с Курьерская служба 2008'''|-|'''Вес''', '''Сумма''', '''Объявленная ценность''', название и количество товара||Карточка товара||• Если товар добавляется вручную или из каталога Курьерской службы 2008, сопоставление не требуется;<br>• если товар добавляется из списка amoCRM, настройте сопоставление в '''Настройки виджета''' > '''Настройка товаров'''|-|'''Количество мест'''|| - ||Заполняется в виджете вручную|}ПВЗ появляются на следующий день.
===Беру===При интеграции поддерживается:* Обработка координатДля смены пароля зайдите в ЛК с токеном и старым id ПВЗ, как в модуле. Выберите '''Сменить пароль''' и укажите старые и новые пароли.
===Мой СкладЛ-Пост ===Интеграция предназначена для передачи заказов Для настройки интеграции с товарными вложимыми из системы "Мой платформой Л-Пост укажите следующие параметры:*'''Секретный ключ клиента''',*'''Код пункта приема''' - Не обязательный параметр. Заполнять параметр не нужно, если отправления сдаются на центральный склад" в систему "Курьерская служба 2008"Л-Пост (Родники, ул.Трудовая, д.10) или забираются со склада партнера силами Л-Пост . <br> В обратную сторону будут приходить статусыдругих случаях, стоимость доставки в качестве точки приема отправлений могут выступать пункты выдачи заказов Л-Пост и общая сумма заказа с учетом частичной доставкисклады Л-Пост.
'''Как настроить'''
# Пройти по ссылке https://home.courierexe.ru/moysklad/step1. Ввести логин и пароль от "Моего склада", а также логин, пароль При отправке заказа обязательно указываются места с габаритами и код экстраклиента от курьерской службымассой.# В случае ошибки "Данный пользователь "Мой склад" уже зарегистрирован." необходимо сбросить настройки одноименной кнопкой (появится Если в случае ошибки).# !ВАЖНО! Подождать пока синхронизируются справочники. Не закрывать и не перезагружать страницу. Данный процесс может занять продолжительное время (от 10 минут).# После синхронизации справочниковзаказе указаны места, автоматически произойдет переход на страницу следующего шагаони добавляются как есть.# !ВАЖНО! до выполнения настроек необходимо перейти Если мест в систему МойСклад и создать дополнительные поля в заказах в системе Мой Склад:#* строковые:#** "Город" - для указания населенного пункта получателя#** "Дата доставки" - для указания даты доставки наряду со временем#** "Сумма заказа" - для получения суммы заказа от КС#** "Стоимость доставки" - для получения стоимости доставки от КС#** "Строка для сохранения информации об ошибках" - для получения текста ошибки;#** "Количество мест" - для возможности указания количества мест;#* с типом '''"Файл"''':#** "Файл" - необязательное поле. Создаетсязаказе нет, если хотите передавать файлыто создается одно фиктивное место. Максимальный размер - 1 МБ.#* с типом '''"Справочник"''':#** "Виды срочности" (одноименный справочник),#** "Временные интервалы" (одноименный справочник),#** "Способы доставки" (одноименный справочник),#** "Тип оплаты" (одноименный справочник),#** "Время доставки с" (справочник '''Часы доставки'''),#** "Время доставки Вложения не разделяются по" (справочник '''Часы доставки''').# Перейти к шагу 4, обновить страницу. Вы увидите настройки, где нужно настроить статусы отправки, соответствие полей местам и соответствие статусов.# Сохранить настройки.# !ВАЖНО! Для отправки заказа обязательно должен быть заполнен вес товара (хотя бы одного)попадают в первое сформированное место.
При заполнении информации по заказу поля стоимость доставки, сумма и ошибка заполнять не нужно. Они заполнятся автоматически после синхронизации с курьерской службой.
Поле "Тип доставки" Обратите внимание, что в зависимости от настроек вашего аккаунта в Л- если пустое, значит доставка по адресу. Иначе выбираем ПВЗ из спискаПост может быть недоступна частичная оплата заказа.
Данные из поля "Комментарий" передаются в заказ автоматически.=== Omnic ===Для настройки интеграции с платформой Omnic укажите следующие параметры:
* '''Как отправить заказЛогин'''Переключите статус заказа на статус - создается самостоятельно, служит для передачи в курьерскую службудоступа к [https://home.courierexe. В этот момент "Мой Склад" сообщает нашей системе об этом событии и она забирает заказru/90025 ЛК экстраинтегратора], может быть любым, добавляет главное запомните его в курьерскую службу.Если после сохранения заказа в статусе для передачи в курьерскую службу статус не изменился необходимо проверить поле "ошибка". Необходимо дозаполнить поля указанные в поле "ошибка", очистить поле "ошибка" и сохранить заказ.
* '''Как проверитьПароль'''является составным и обязательно должен содержать токен (получается в службе поддержки омника).
Зайти в Личный кабинет курьерской службы и проверить с помощью вкладки отслеживание существует ли отправленный заказ.Так же может содержать
'''Известные проблемыПВЗ отправления'''- код ПВЗ подрядчика, пункт самопривоза. <i>Не обязательный параметр</i>
!ВАЖНО! Модуль интеграции не работает на бесплатном тарифе!При установке приложения в "Моем Складе" наша система в нем регистрирует <rspoiler text="событие">т.н. веб'''Приоритет тарифов''' -хук</rspoiler>последовательность тарифов подрядчика, на изменение заказаразделенная пробелами, чтобы "Мой Склад" нас извещал об измененияхуказывающая доступность и приоритет тарифов в общем случае. Так работают все модули служб доставки для МС. Проблема в том, что МС поддерживает только одно подобное событие для заказа, поэтому, если оно занято другим <rspoiler text="установленным модулем"i>А иногда бывает, что модуль удалили, или не до конца установили, а зарегистрированное событие от него осталосьНе обязательный параметр</rspoileri>, в этом случае мы не сможем его занять, и отправка заказов, к сожалению, работать не будет. Если у вас не отправляются заказы, и вы уверены, что у вас нет других модулей, использующих это событие, обратитесь к нам в службу поддержки, мы сможем проверить занятость события и при необходимости его освободить.
===Wordpress===<br> ====Требования к сайту перед установкой плагина:====#CMS WordPress версии 5, или более новая.#WooCommerce версии 3.9, или более новая.#PHP версии 7, или более новая.#Сайт должен использовать SSL-сертификатЕсли омник забирает заказы у вас
====Порядок установки плагина и вывод нового способа доставки в корзину:====Пример cf3f645a5afc2e7ae030522711b4464af77dcb2d11997f1ddf5f1de81b003906#В панели администратора вашего сайта откройте страницу “Плагины - Добавить новый” и нажмите на кнопку “Загрузить плагин”#В появившейся форме выберите архив с плагином на вашем компьютере и нажмите кнопку “Установить”#После загрузки и установки плагина вы можете его активировать нажав на соответствующую кнопку #После активации плагина в меню появится ссылка на страницу настроек плагина.Заполните все необходимые поля и нажмите кнопку “Сохранить изменения”.#Откройте настройки WooCommerce и переключите на вкладку “Доставка”#Выберите необходимую зону доставки, или создайте её.#Нажмите на кнопку “Добавить метод доставки” и выберите из списка “КС2008”#После создания заказа, в панели администратора, в форме изменения заказа, справа появится блок модуля "Отправить в курьерскую службу, снизу которого будет кнопка "Отправить заказ в КС2008", при нажатии на которую заказ будет отправлен в курьерскую службу.<br>
====Обновление статусов====Если вы сами привозите отправления на склад или в ПВЗ омника (самопривоз) пароль будет ТОКЕН, КОД ПУНКТА САМОПРИВОЗА.<br> Обновление статусов заказов происходит через технологию WP_Cron каждые 30 минут. Пример cf3f645a5afc2e7ae030522711b4464af77dcb2d11997f1ddf5f1de81b003906,MSK317<br>
Если статус заказа есть необходимость ограничить используемые тарифы, укажите те, которые можно использовать, в курьерской службе будет изменен на “Доставлен”пароле: <br>Пример cf3f645a5afc2e7ae030522711b4464af77dcb2d11997f1ddf5f1de81b003906,MSK317, то статус заказа в вашем магазине также будет изменен на “Выполнен”.,32 26<br>
Для настройки модулей в поле "Код клиента" укажите 90025. <br><br><div style===Проверка работоспособности "color: #a94442; background-color: #f2dede; border: 1px solid #ebccd1; padding: 3px 10px 10px;"><b>Внимание!</b><br> При использовании прямых интеграций===и модулей необходимо использовать второй режим срочности [2] <b>Посылка. Алгоритмический тариф</b>.<br>В разных модулях может выбираться из списка или вводиться числом. При выборе другого режима срочности интеграции и модули могут работать не верно либо рассчитывать не все возможные варианты.<br></div>
При неполадках === BTS Узбекистан ===Для настройки интеграции проверьте ее работоспособность. В общем случае для этого достаточно создать заказ и отправить его в курьерскую службу.с BTS укажите следующие параметры:
Если заказ отправлен без ошибок и отображается в ЛК, значит, интеграция настроена* '''Токен API''' - это обязательное поле. Если отправка не удаласьЗаполните его правильно, ошибка может быть в настройках интеграции или и заказы будут отправляться в заполнении формы отправки заказаBTS.Оставшиеся поля служат для более тонкой настройки создания заказов:
Текст ошибки можно увидеть через [[Личный кабинет#Отладка|отладку]] в личном кабинете. Чтобы найти свой заказ в запросах* '''Отправка корреспонденций ''', нажмите клавиши CTRL + F и введите в строку поиска номер заказа или ориентируйтесь на время создания заказаможет принимать значения:** ''Со склада''** ''С адреса отправителя''* '''Вызов курьера отправителем''', может принимать значения:** ''Нет''** ''Забрать у отправителя''* '''Тестовый режим интеграции''', может принимать значения:** ''Нет''** ''Включен тестовый режим''* '''Код курьера''' - Все заказы отмечаются, как доставленные указанным курьером.
УбедитесьДля отправки заказа:* населенные пункты отправителя и получателя должны быть синхронизированы со списком населенных пунктов BTS. Если один из населенных пунктов не будет синхронизирован, то в карточку заказа будет добавлено сообщение об ошибке:** ''Уточните город получателя'' или ** ''Уточните город отправителя''* заказ должен иметь одно грузоместо. Если заказ не имеет грузомест или имеет более одного грузоместа, что выполнены все шаги инструкции по настройки интеграции из этого разделато он интеграция заблокирует отправку, а в сообщении о доставке карточки заказа опубликуется сообщение: ** ''грузоместо должно и может быть только одно.''
Ниже представлено описание проверки работоспособности для разных интеграторов<div style="color: #a94442; background-color: #f2dede; border: 1px solid #ebccd1; padding: 3px 10px 10px;"><b>Внимание!</b><br>* Заказ должен иметь Одно грузоместо.* Для отправки заказа, населенные пункты отправителя и получателя должны быть синхронизированы со списком BTS. * Cинхронизация населенных пунктов, отсутствующих в списке BTS, проводится по запросу в техподдержку</div>
'''RetailCRM'''== Отмена заказов в интеграциях ==<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>Отмените корреспонденцию в службу доставки''' должен быть снят. Заказ должен отправиться интеграции (Вкладка "Межгород" в курьерскую службу.# Если возникает ошибкакарточке корреспонденции, ее текст отображается наверху страницы.:: Если это ошибка заполнения формыкнопка "Отменить", исправьте внесенные данные и попробуйте отправить заказ снова. Пример ошибки: «Ошибка сервиса доставки нажатие кнопки "Курьерская служба 2008Сохранить": field [receiver phone] has no valid phone number» :: Если это ошибка ответа курьерской службы, сообщите об в карточке корреспонденции). При этом разработчику. Пример ошибки: «Служба доставки прислала ответ статус корреспонденции в неверном формате».интеграции сменится на "Отменяется"<br><br>
'''Мой склад'''
# В личном кабинете клиента курьерской службы в настройках обратной интеграции '''Мой склад''' в поле '''В каком статусе "Мой склад" отправлять заказ на доставку''' уточните статус, при котором заказ отправляется в курьерскую службу.
# Заполните форму заказа, нажмите на кнопку '''Сохранить''', затем смените статус заказа на статус, установленный для отправки в курьерскую службу и снова нажмите на кнопку '''Сохранить'''. Если все верно, заказ будет отправлен в курьерскую службу.
# Обновите страницу в браузере и проверьте поле '''Строка для сохранения информации об ошибках''':
#* если поле пустое и заказ пришел в личный кабинет, интеграция работает;
#* если поле пустое и заказ не пришел в личный кабинет, обратитесь к разработчику;
#* если в поле содержится текст ошибки, исправьте ее в форме заказа и попробуйте отправить его снова.
'''InSales'''[[Файл:2023-04-03_11-26-09.png |700px]]<br><br><br>
# В личном кабинете клиента курьерской службы в настройках обратной интеграции '''InSales''' проверьте данные в следующих полях</li><li>Если заказ <i style="color:#* '''Отправлять заказы в курьерскую службу автоматически после изменения статуса'''black;background-color:#* '''Статус отправления заказа в курьерскую службу (если отправляется автоматически)'''e91e6326;#* '''Список доставок для отправления заказа в курьерскую службу "> не удалось отменить </i> на стороне подрядчика, (если отправляется автоматически)''';#* '''Оплачен ли например, заказ? (если отправляется автоматическиуже находится в процессе доставки)''', то статус заказа изменится на "<b>В работе у подрядчика</b>".# Создайте заказ и в В этом случае ошибки проверьте данные , изменение заказа на соответствие этим полям. Например, возможно только в заказе может быть установлен тип доставкиличном кабинете подрядчика, не отмеченный как используемый в настройках либо обращением в личном кабинете<i>техподдержку подрядчика</i>.<br><br>
При возникновении ошибок при отправке заказа появляется диалоговое окно с сообщением об ошибке. Исправьте ошибку в форме заказа и попробуйте отправить его снова.
'''amoCRM'''[[Файл:2023-04-03_11-52-20.png |700px]]<br><br><br>
Ошибка при создании </li><li>Если заказ был <i style="color:black; background-color:#dafbda;"> успешно отменен </i> (в этом случае интеграция сама удалит заказ на стороне подрядчика), то по истечении 1-15 минут статус заказа отображается в левом нижнем углуинтеграции сменится на "<b>Отменен</b>".<br>Ответственный филиал корреспонденции будет автоматически переключен на главный ответственный филиал, а код подрядчика (если он был присвоен) будет удален.<br><i style="color:black; background-color:#dafbda">Только после этого можно считать, что корреспонденция полностью отменена в интеграции</i> и можно приступать к ее повторной отправке.<br>
== RBK.money ==
Чтобы настроить прием платежей через систему «RBK.money»:
# Перейдите по ссылке https://welcome.rbk.money/ и нажмите '''Подключиться'''. С вами свяжутся сотрудники и вышлют инструкцию для заключения договора и дальнейшей работы.
# После завершения регистрационных действий введите полученный публичный ключ и идентификатор в настройках личного кабинета курьерской службы. Подробнее см. [[Личный кабинет курьерской службы#Вкладка «Финансы»|настройки личного кабинета]].
При успешной оплате заказ в MeaSoft отмечается как оплаченный<br>[[Файл:2023-04-03_12-03-35.png |700px]]
== PimPay ==<br><br><br>Чтобы начать работать с [https:<//pimpayli><li>Внесите исправления в данные корреспонденции. Сохраните ее.ru</ Pimpay] необходимо сначала зарегистрироваться в их системе li><li>Для повторной отправки корреспонденции по адресу [http:интеграции (предварительно убедившись, что все ошибки исправлены) вновь назначьте для корреспонденции ответственный филиал интеграции <//platform.apili><li>После повторного назначения в корреспонденции ответственного филиала интеграции ожидайте сообщения об отправке.pimpayПри повторной отправке этот процесс может занимать до 30 минут.ru</siteli><li>При возникновении ошибки, если она очевидна, вновь исправьте ошибку в корреспонденции и повторите процесс повторной отправки (отмена, исправление ошибок, повторное назначение на ответственный филиал интеграции)</register http:li><//platform.api.pimpay.ru/site/register]. Далее pimpay активирует Вашу учетную запись. [[Файл:pimpayconfig.png|thumb|200px|right|рисul>Если при получении ошибки от подрядчика нет понимания ее причин, пожалуйста напишите в нашу техподдержку.1 Конфигурация PimPay]]
Чтобы продолжить, вам нужно сгенерировать ключи шифрования. Это делается на UNIX-подобной системе: [http://platform.api.pimpay.ru/v2_7/signature/openssl http://platform.api.pimpay.ru/v2_7/signature/openssl] или <spoiler text="наша инструкция">Чтобы получить приватный ключ, необходимо запустить командную строку.=Сквозная интеграция==
В командной строке необходимо выполнить следующие команды: openssl genrsa -out privateСквозная интеграция предполагает передачу тарифов подрядчика при создании заказа.pem 2048 openssl rsa -in private.pem -outform PEM -pubout -out public.pem
После успешного выполнение команд Вы получить 2 файлаЧтобы настроить сквозную интеграцию между [[#Интеграция с CMS-системами |CMS- или CRM-системой]] и подрядчиком [[#Тарификация и выбор подрядчика и его тарифа клиентом|из таблицы]]: public.pem и private.pemСодержимое файла public* Создайте свой Личный кабинет для экстраинтеграции.pem - ваш публичный ключ<br>Для этого, который необходимо целиком скопировать и вставить достаточно единоразово войти в ЛК PimPayэкстраинтеграции под своим логином и паролем https://home.А содержимое файла privatecourierexe.ru/XXX, где XXX — экстра-код партнера.pem необходимо скопировать <br><i>Логин</i> и вставить в настройках интеграции с PimPay в нашем ЛК.<i>пароль</spoileri>, - это данные из 3-го и 4-го параметров (см. таблицу ниже) [[Файл:pimpay client#Тарификация и выбор подрядчика и его тарифа клиентом|Тарификация и выбор подрядчика и его тарифа клиентом]].png* настройте [[Виды срочности|thumb|200px|right|рис.2 Выбор платежного посредникарежим срочности]]Если у вас нет специалиста, чтобы сгенерировать ключи, обратитесь в PimPay, они с радостью сделают это за вас!для подрядчика.
ДалееДля сквозной тарификации заказов интернет-магазинов доступны следующие варианты:* курьерская служба, необходимо прописать настройки с которой сотрудничает интернет-магазин, настраивает режим срочности для pimpay подрядчика. Интернет-магазин оформляет заказы в [[Личный кабинет клиента|личном кабинете клиента]] и выбирает указанный режим срочности;* интернет-магазины могут обратиться напрямую в панели управления нашего ЛК (см. рис.1)MeaSoft для настройки сквозной тарификации. В ЛК PimPay этом случае нужно посмотреть код компании (у них называется "Код платформы") предварительно заключить договор на оказание услуг с выбранным подрядчиком, и токен, ввести их в формусквозная тарификация позволит получать его цены.
Для каждого клиента== Тарификация и выбор подрядчика и его тарифа клиентом ==Вы можете настроить подключение своего тарифа к тарифу партнера — любой компании, который хочет передавать данные работающей в PimPay необходимо зарегистрировать в личном кабинете PimPay, и в нашей системе выбрать платежного посредника на вкладке "Финансы" карточки клиента. В процессе передачи данных привязка клиентов между системами производится по ИНН. Наша система начинает передавать все заказы вашего клиента в PimPayMeaSoft, их статусыа также ряду компаний, и созданные [[Акты Передачи Денег и корреспонденции (АПД)|АПД]]. Обратно она ничего не получаетс которыми у нас есть интеграции.
=== Настройка интеграции ===Чтобы настроить подключение к тарифу партнера:# Зарегистрируйтесь в системе подрядчика. Данные аккаунта понадобятся для настройки интеграции.# Откройте '''Справочники''' > '''Статусы''' > '''17 Виды срочности''' и создайте [[Статусы#Виды срочности|вид срочности]], например «СДЭК».# В контекстном меню вида срочности выберите пункт '''Дополнительная информация''' и во второй строке заполните параметры подключения к партнеру через запятую:#* 1-й параметр — код филиала партнера, его можно посмотреть в '''Справочники''' > '''Межгород''' > '''Филиалы'''. Можно в одинарных кавычках указать несколько ответственных филиалов через запятую, тогда режим срочности будет доступен для всех перечисленных филиалов. Для версии системы 2021.0.0.38 и выше вместо кода филиала можно указать знак вопроса (?), это обозначит доступность режима срочности для всех филиалов;#* 2-й параметр — экстра-код партнера в системе MeaSoft. Коды для сторонних компаний приведены в таблице ниже;#* 3-й параметр — имя пользователя в системе партнера. Может отличаться от того, чтобы платежи под которым работает интеграция, здесь нужно для расчета цены для клиента. В таблице ниже указано, что вводить для каждого интегратора;#* 4-й параметр — пароль пользователя из 3-го параметра. В таблице ниже указано, что вводить для каждого интегратора;#* 5-й параметр — вид срочности партнера. Посмотреть доступные коды видов срочности можно по ссылке в таблице ниже, в калькуляторе в выпадающем списке. Можно в банк по АПД выгружались одинарных кавычках указать несколько видов срочности через запятую, тогда система будет стараться выбрать из них первый доступный;#* 6-й параметр — наценка к цене, передаваемой подрядчиком. В деньгах или в адрес PimPayпроцентах, если стоит знак процента. Например, 10 — наценка 10 рублей, 10 % — наценка 10 процентов;#* 7-й параметр — если указать значение '''1''', сквозная тарификация выключена. Параметр используется, если подключение нужно создать клиента с точно таким названием только для передачи заказов по интеграции, а расчет цены не нужен. <br>В этом случае, при визуализации суммы по режиму срочности, отображается внутренний тариф, а подрядчику заказ отправляется другим тарифом, выбранным согласно настройке в 5-м параметре ("PIMPAY"вид срочности партнера).;#* 8-й параметр — если указать значение '''1''', среди указанных режимов срочности партнера выполняется поиск самого дешевого тарифа. Работает для СДЭК 1.5, Почты России и заполнить его реквизитыOmnic# Нажмите на кнопку '''OK'''.
{|class="wikitable"!Интеграция!Код экстра!Виды срочности!Авторизация!Пример строки|-|БОКСБЕРРИ||90001||https://home.courierexe.ru/90001/calculator||3-й параметр - токен. 4-й - Код пункта приема<br> по умолчанию для старого Боксберри 010.<br> После перехода на Яндекс, требуется выбрать ПВЗ отправления из нового списка, предоставляемого Яндекс.<br> Для уточнения, свяжитесь с техподдержкой Boxberry<br>Можно оба параметра оставить пустыми для расчета базовых цен.||33, 90001, j3ejwo2f10b2e47790174b41f4a11111, c1cb5465-1418-42eb-a74d-204682e18af8, 2, 50|-|ПИКПОИНТ||90002||https://home.courierexe.ru/90002/calculator||3-й параметр — логин, 4-й — через запятую пароль и договор ИКН. Можно оставить пустыми, но цены будут не все.||33, 90002,us0111, '6rGGuqRsW2qNQ,9990721312', 2, 50|-|rowspan= Диадок "2"|СДЭК<br>(протокол обмена данными 1.5, поддержка прекращена с 01.01.2022)||rowspan="2"|90005||rowspan="2"|https://home.courierexe.ru/90005/calculator||Введите код учетной записи в 3-й параметр, секретный код — в 4-й. Можно оба оставить пустыми для расчета базовых цен.||45491, 90005, hfenJwlasiPr4pnFENpaVXSKPIn5Trh7i, '9vkQgWuiZgEj9fGCB8a6Xj3desnJkwsl,1.5', 5, 30%|-||Если вы хотите добавить в расчет тарифа процент за наложенный платеж, после пароля добавьте запятую и число процента. В настройке режима срочности пароль с числом процентов заключите в кавычки.||9vkQgWuiZgEj9fGCB8a6Xj3desnJkws,1.5|-|СДЭК<br>(протокол обмена данными 2.0)||90022||https://home.courierexe.ru/90022/calculator||3-й параметр — ID клиента, 4-й — ключ клиента.<br>Вы можете перечислить в пароле уточняющие параметры для расчета через запятую: <br><ul><li>не передавать объявленную ценность</li><li>добавлять услугу «Осмотр вложений»</li><li>процент за наложенный платеж</li><li>код пункта приема</li><li>процент за безналичный наложенный платеж</li></ul><br>Пример пароля: EMscd6r9JnFiQ3bLoyjJY6eM78JrJcee,1,1,2,MSK2,15||10497, 90022, EMscd6r7JnFyQ3bLoyjJY7eM78JrJceI, ‘Mscd6r9JnFiQ3bLoyjJY6eM78JrJcee,1,1,2,MSK2,15’, 1, 100|-|КСЭ||90008||https://home.courierexe.ru/90008/calculator||Введите логин в 3-й параметр, пароль — в 4-й.<br>Заполнение Логина и Пароля обязательно.<br><br>Вы можете перечислить в пароле уточняющие параметры для расчета через запятую:<br><ul><li>Особенности отправки заказов:<ul><li>0 - Как документ SaveDocument</li><li>1 - Как накладная SaveWaybillOffice</li><li>2 - Определить автоматически</li></ul></li><li>Забор<ul><li>0 - По умолчанию</li><li>1 - До двери</li><li>2 - Самопривоз в КСЭ</li></ul></li></ul><br>Пример пароля:<br>4CCB11864D06157,2,2||12504, 90008, Рога и копыта, '4CCB11864D06157,1,2', '2, 3, 6', 10%|-|ПОЧТА РОССИИ||90010||https://home.courierexe.ru/90010/calculator||Без авторизации||10497, 90010,,, '2, 1', 10 <!--10497, 90010, 89251234567, 'mypassword,u23B0r9AAJ1Fyh4ptMzJ3kjxcslamwdx', '2, 1', 10-->|-|rowspan="3"|DPD||rowspan="3"|90011||rowspan= Начальная настройка "3"|https://home.courierexe.ru/90011/calculator||Введите клиентский номер в 3-й параметр, клиентский ключ в 4-й. Можно оставить пустыми для базовых тарифов.||12504, 90011, 1019003662, '4CCB11864D06157A5934A9119F2A0AAAAAB4CCE8,D117', '3, 6', 10%|-||Если вы доставляете товар в пункт отправления самостоятельно, после пароля добавьте запятую и код ПВЗ, а в настройке режима срочности введите пароль в кавычках.||'4CCB11864D06157A5934A9119F2A0AAAAAB4CCE8,D117'|-|-|colspan="2"|ВНИМАНИЕ! У DPD есть 2 калькулятора, которые считают по-разному при одних и тех же вводных данных. При этом они не разглашают, по какому из расчетов определяют цену. Поэтому по не зависящим от нас причинам расчет по тарифам DPD может как совпасть с итоговым, так и сильно разойтись. Если вас это не устраивает, не используйте сквозную тарификацию с этим подрядчиком.|-<!--|DOSTAVKA.GURU||90017||https://home.courierexe.ru/90017/calculator||3-й параметр — ID партнера в системе DOSTAVKA.guru, 4-й — ключ доступа. Также можно указать признак отключения проверки интервала доставки. В этом случае необходимо указать ключ и "1" через запятую в кавычках. Можно оставить пустыми. ||10497, 90017, 9999, 'cc03e747a6afbbcbf8be7668acfebee5,1', '1', 100|- -->|5Post||90020||https://home.courierexe.ru/90020/calculator||3-й параметр — API-ключ,<br>4-й — уникальный номер партнера в системе 5post.<br>При необходимости в 4-м параметре можно через запятую указать параметры:<br><ul><li>пороговое значение веса (по умолчанию 3 кг).</li><li>Использовать штрихкод для отслеживания получателем</li><li>Код подрядчика в карточке заказа</li><li>Габариты мест</li><li>Тип расчета тарифа</li></ul><i>При указании параметров важно соблюдать последовательность.</i><br><i>Для вашего аккаунта в API 5post должна быть подключена возможность получать ПВЗ с вашими тарифами.</i><br>Пример пароля: 2123,7,,,,1||10497, 90020, u23B0r9AAJ1Fyh4ptMzJ3kjxcslamwdx,'2123,7,,,,1', '1,3', 100|-|GTD||90021||https://home.courierexe.ru/90021/calculator||3-й параметр — API-ключ, 4-й — пароль от личного кабинета https://home.courierexe.ru/90021. Предварительная авторизация по указанному URL обязательна.||10497, 90021, u23B0r9AAJ1Fyh4654MzJ3kjx1548wdx, pass, 100|-|Яндекс.Доставка||90023||https://home.courierexe.ru/90023/calculator||3-й параметр — токен,<br> 4-й — ID пункта отправления в качестве пароля. <br>При необходимости, в пароль можно расширить, передавая через запятые следующие параметры:<br> - <span style="text-decoration: line-through;">Начало интервала доставки</span> (не активно)<br> - <span style="text-decoration: line-through;">Окончание интервала доставки </span> (не активно)<br> - Код курьера, для закрытия корреспонденции<br> - параметр "Особенности формирования данных"<br> '1' - Трактовать места, как товары<br> '2' - Трактовать товары, как места <br> - параметр "Настройка получения ПВЗ"<br> по умолчанию - Получать все ПВЗ<br> '1' - Отключить постаматы<br> '2' - Отключить все ПВЗ<br>Пример пароля: cfceadaa-4874-438a-999b-dbbafe5326ed,,,25,2,1||10497, 90023, AgAABBDzeAQMAAAPeISvM_9LUkxCijQoFXOH5QE, ‘cfceadaa-4874-438a-999b-dbbafe5326ed,,,,1,1’, 1, 100|-|Л-Пост||90024||https://home.courierexe.ru/90024/calculator||3-й параметр — логин, который требуется создать самостоятельно, для входа в <i>[https://home.courierexe.ru/90024/ ЛК экстраинтеграции Л-Пост]</i> <br> 4- пароль, как Секретный ключ клиента<br> Дополнительно, есть возможность перечислить в пароле уточняющие параметры для расчета через запятую: <br><ul><li>Признак использования тестовой среды</li><li>Код пункта приема</li></ul><br>Пример пароля: YGNoaR3cG00JYg67,0,1010||10497, 90024, LoginTest, ‘YGNoaR3cG00JYg67,0,1010’, 1, 100|-|Omnic||90025||https://home.courierexe.ru/90025/calculator||3-й параметр — логин, который требуется создать самостоятельно, для входа в <i>[https://home.courierexe.ru/90025/ ЛК экстраинтеграции Omnic]</i> <br> 4- пароль, как Токен клиента<br> Дополнительно, есть возможность перечислить в пароле уточняющие параметры для расчета через запятую: <br><ul><li>Код пункта приема отправлений</li><li>Признак использования тестовой среды</li><li>Приоритет доступных тарифов через пробелы, - при указании алгоритмического тарифа, приоритет указанный в нем имеет преимущество</li></ul><br>Пример пароля: g67hjtTYjhgf765432,MCK45||10497, 90025, LoginTest, ‘g67hjtTYjhgf765432,MCK45,,21 22’, '3, 2', 100,,1|-|A2-express||90029||https://home.courierexe.ru/90029/calculator||3-й параметр — логин, Идентификатор клиента в A2 состоящий из 4-х цифр <i>[https://home.courierexe.ru/90029/ ЛК экстраинтеграции A2-express]</i> <br> 4-й параметр - пароль, это Ключ клиента в A2-express||10497, 90029, 1000, g67hjtTYjhgf765432hgtTnk5, '1, 2', 100,,1|}
Рассказываем как начать пользоваться с самого начала:При выборе клиентом в личном кабинете вида срочности, подключенного таким образом к партнеру, набор доступных ПВЗ будет ограничен выбранным партнером.
# Свяжитесь с [https://kontur.ru/ СКБ Контур], попросите выпустить [https://ru.wikipedia.org/wiki/%D0%AD%D0%BB%D0%B5%D0%BA%D1%82%D1%80%D0%BE%D0%BD%D0%BD%D0%B0%D1%8F_%D0%BF%D0%BE%D0%B4%D0%BF%D0%B8%D1%81%D1%8C электронную цифровую подпись (ЭЦП)] для использования с ЭДО Диадок. Нам выставили счет на 5250 рублей. Потом нужно прийти в предложенный офис удостоверяющего центра с уставными документами, вам дадут флешку (называется "Рутокен") с ЭЦП. При ее подключении автоматически устанавливается набор ПО для ее использования.# Вам становится доступен вход Вы можете войти в систему личный кабинет по адресу [https://diadoc.kontur.ru вида https://diadochome.konturcourierexe.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"/> можно указать отпечаток сертификата, который нужно использовать. Если пусто - программа постарается выбрать сертификат сама по доступности компанииXXX, к которой производится подключение. Посмотреть отпечаток: Пуск - Программы - Крипто-ПРО - "Сертификаты пользователя" - "Личное" - "Сертификаты". Справа выберите нужный сертификат, откройте. Перейдите на вкладку "Состав", прокрутите список значений вниз, в самом низу выберите "Отпечаток".## В поле <mparam code="EDocPass"/> введите пингде XXX — экстра-код сертификата. Если вы его не менялипартнера, можно пропустить: по-умолчанию для рутокена пин авторизоваться данными из 3- "12345678", го и программа сама будет его использовать, если вы ничего не указали. Если он окажется не правильным 4- Крипто-ПРО спросит у вас верный пин при передаче данныхго параметров (см. Обратите внимание, что количество попыток ввода пин-кода ограничено.# После ввода данных подключения нужно выйти, и запустить программу от имени администратора (права windows, правой кнопкой на ярлык - запустить от администраторатаблицу выше), и осуществить обмен данными: "Связь" -> "Обмен воспользоваться калькулятором с ЭДО". При первом использовании программа установит на компьютер специальный COM-объект Диадока. Именно для этого нужны права. В дальнейшем она будет использовать уже установленный компонент, и наличия прав не требуетсятарифами именно вашей компании.
=== Обмен данными с ЭДО Настройка стоимости доставки для получателя ===Выберите в главном меню "Связь" -> "Обмен При интеграции с ЭДО". Откроется окно с выпадающим списком фирмподрядчиками, у которых заполнено поле "Ключ ЭДО". Выберите фирмуперечисленными в таблице выше, вы можете настроить стоимость и нажмите "Обмен!". Программа выполнит все операциисрок доставки, которые периодически нужно выполнять, чтобы иметь актуальные данные как в нашей системе так и в ЭДОотображаемые для получателя:*Синхронизирует справочники контрагентов# Перейдите в личный кабинет по адресу вида https: Получит список контрагентов//home.courierexe.ru/XXX, уже являющихся вашими партнерами в ЭДОгде XXX — экстра-код партнера, проставит им соответствующие признаки и авторизуйтесь данными из 3-го и 4-го параметров (На вкладке "Клиенты" появилось новое поле "Статус ЭДО"см. Это поле нельзя менять, оно устанавливается автоматическитаблицу выше), проверит, кто прислал вам приглашения к партнерству и примет их, разошлет приглашения всем вашим работающим контрагентам, проверит, кто принял приглашение, а кто - отказался.*Проверит статусы ранее отправленных документов# Откройте пункт основного меню '''Цена доставки для получателя''' и настройте правила расчета цены и сроков доставки. При подписании документа вашим партнером, сообщение получит статус "Доставлено"Подробнее см. Если оно отправлено из счетов или АПД, то соответсвующий документ получит признак получения подписанного актараздел «[[Личный кабинет клиента#Цена доставки для получателя|Цена доставки для получателя]]».
=== Отправка документов =TPS Gate==К отправке сейчас доступны счета, АПД Интеграция с сервисом TPS Gate позволяет открывать шлагбаумы с мобильного приложения курьера на территории Москвы и АПКМосковской области. Отправка работает крайне похоже Это упрощает работу курьеров и уменьшает время на e-mailдоставку каждого адреса. Документы формируются точно так же, но отправляются не почтой, а Для подключения вам необходимо обратиться в ЭДОсервис [https://tpsgate.ru TPS Gate], уже подписанными вашей ЭЦП. В системе ЭДО "адресами" отправителя заключить с ними договор и получателя являются ИНН (по возможности еще КПП, но это не обязательно) компании, поэтому, чтобы все работало, ИНН должен быть заполнен. Так же ЭДО примет документы только в адрес компании, подписать с которой у вас отмечены партнерские отношения, т.е. кто-то из вас отправил приглашение, а другой его принялнами доп. Поэтому, для удобства контроля - кому можно таким образом отправлять, а кому - нет, в списках документов добавлено поле "Есть ЭДО"соглашение о передаче данных [https://courierexe. Там галка ставится на основании статуса ЭДО клиентаru/download/TPS_DOP. Можете отсортировать по этому полю, выдели все, где есть галки, и разослать всем документы по ЭДОdocx Пример].
== Телефония ==Далее необходимо передать нам секретный ключ от сервиса TPS Gate и интеграция будет запущена. Основная статья: [[Интеграция с телефонией]]Если на адресе доставки есть ворота, которые возможно открыть через TPS Gate в мобильном приложении курьера появится соответствующая кнопка.
== GPS-трекинг автотранспорта ==Для поддержки GPS-трекинга автотранспорта Чтобы курьер мог открывать ворота через приложение, у нас разработана интеграция с коробочной системой Wialon, на которой работают большинство компаний, предоставляющих подобные услуги. Обратитесь в службу технической поддержки для помощи него должна быть включена галка '''Водитель''' в настройкекарточке сотрудника.