Система "Курьерская служба 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 агента, и статусы будут передаваться обратно. Правильный способ отправки заказов — через [[Манифесты|манифест]], который нужно скомплектовать и проставить дату отправки. На передачу данных может уходить до 10 минут в штатном режиме и до 1 часа в случае возможных сбоев. <div style="color: #a94442; background-color: #f2dede; border: 1px solid #ebccd1; padding: 3px 10px 10px;">При передаче заказов, у которых плановая дата доставки меньше ближайшей возможной, дата доставки автоматически меняется на самую раннюю возможную.</div> Передача времени ожидания и заполнение информации о возврате не предусмотрено интеграцией. Для стабильной работы необходимо наличие версии MeaSoft минимум 518 от 05.12.2014 у обеих компаний. Для одного клиента может быть настроена только одна интеграция с агентом. ==Распределение заказов по признаку необходимости чека== Вы может распределять заказы по двум разным клиентам по принципу необходимости чека. Для этого агент создает в своей системе второго клиента для вашей компании, в карточке клиента на вкладке '''Прочее''' указывает логин и пароль, которые передает вам. В настройке интеграции Measoft (пункт 6 инструкции выше) заполните поля '''АгентЛогин для заказов без чека''' и '''Пароль для заказов без чека''' и выберите признак, по которому определяется необходимость чека, в поле '''Определять заказы без чека по признаку'''. Заказы, созданные клиентом, которому нужен чек, будут отправляться с авторизацией, указанной в полях ''' передает клиенту Логин''' и '''Пароль'''. Заказы, которым чек не требуется, будут отправляться с авторизацией '''Логин для заказов без чека''' и '''Пароль для заказов без чека'''. = Интеграция со сторонними системами =Сторонними системами могут быть:* [[#Интеграция с подрядчиками|системы подрядчиков]], принимающие заказы на доставку;* [[#Интеграция с CMS-системами|CRM- и CMS-системы]] интернет-магазинов, передающие заказы в курьерскую службу. Интеграции со сторонними системами делаются в соответствии с документацией на момент написания, без партнерства с компаниями-поставщиками сервиса. Об изменениях API нас не оповещают, поэтому интеграции по не зависящим от нас причинам могут переставать работать, работать нестабильно или некорректно, вплоть до потери важной информации. Заказы, переданные во внешние системы, нужно обязательно проверять на корректность, пользуясь личным кабинетом партнера. По интеграции уходят только новые заказы, созданные в день настройки интеграции. == Интеграция с CMS-системами == Для работы с популярными 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|Настраивается]] в ЛК пользователя в системе MeaSoft |-|[[Файл: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|Инструкция]]|-|[[Файл:Measoft idCscart.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|thumb400 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. Введенные данные потеряны не будут, карта после этого отобразится корректно.<!--=== Беру ===При интеграции поддерживается:* Обработка координат.-->=== Проверка работоспособности интеграций ===При неполадках интеграции проверьте ее работоспособность. В общем случае для этого достаточно создать заказ и отправить его в курьерскую службу. Если заказ отправлен без ошибок и отображается в ЛК, значит, интеграция настроена. Если отправка не удалась, ошибка может быть в настройках интеграции или в заполнении формы отправки заказа. Текст ошибки можно увидеть через [[Личный кабинет#Отладка|200pxотладку]] в личном кабинете. Чтобы найти свой заказ в запросах, нажмите клавиши CTRL + F и введите в строку поиска номер заказа или ориентируйтесь на время создания заказа. Убедитесь, что выполнены все шаги инструкции по настройки интеграции из этого раздела. Ниже представлено описание проверки работоспособности для разных интеграторов. '''RetailCRM''' # Убедитесь, что выполнены все шаги [[RetailCRM#Настройка интеграции|rightинструкции по настройке интеграции]].# Если используются триггеры, убедитесь, что они настроены согласно [[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>, при частичной доставке в карточке заказа * '''Передавать штрихкоды мест'''* '''Передавать штрихкод заказа''' -Документацией Боксберри разрешено не передавать штрихкоды, тогда Бокберри сам создает ШК и этикетку можно получить по url который Boxberry возвращает вместе с кодом подрядчика при принятии заказа. На данный момент, интеграция не получает этикетки автоматически. Их нужно скачивать из ЛК Boxberry. ==== Миграция на Яндекс Доставку ====Авторизация и принятие оферты Яндекс.Доставки будет происходитьчерез Личный кабинет Boxberry.<br>* В личном кабинете Boxberry необходимо кликнуть по баннеру со ссылкой на новый ЛК Boxberry.* Кликая на ссылку в банере, клиент последовательно увидит 2 окна:** авторизация (подтверди свой аккаунт)** принятие офертыПосле этого клиенту доступна работа в API и модулях для обновлениягео-справочников. ПВЗ Яндекс будут загружены в течении суток после подтверждения офферты.<br>Если ПВЗ Яндекс не подгрузились в течении суток после подтверждения офферты, то требуется обратиться в техподдержку Measoft для получения логов статуса клиента]].
4) '''Клиент''' создает в своей системе филиал (Справочники – Межгород – Филиалы) для указанного агента. После ввода филиала нужно перевойти в программу и подождать 3 минуты.=== СДЭК===
Компания СДЭК прекращает поддержку API версии 1.5) '''Клиент''', получив данные из пс 01. 3, заходит в свой личный в системе MeaSoft (см01. иллюстрацию)2022. Переходит на закладку «Интеграция». В таблице должен появиться созданный филиал. [[Файл:Measoft homeПо информации от службы поддержки, интеграция не будет резко отключена, но поддержка будет осуществляться только для версии API СДЭК 2.png|thumb|200px|right]]0
6) '''Клиент''' нажимает кнопку «Настроить» напротив филиала, в открывшемся окне выбирает интегратор «MeaSoft», далее – заполняет форму – «Логин», «Пароль», и «Код клиента» данными, полученными в пДля перехода на новую версию создана интеграция СДЭК 2. 3, нажимает «Сохранить»0.
Чтобы настроить интеграцию с платформой СДЭК версии 2.0, заполните следующие поля:
* '''ID клиента'''
* '''Ключ клиента '''
* '''Код пункта приема '''
Это обязательные поля.
В результате такой Остальные поля служат для более тонкой настройкисоздания заказов:* '''Передавать объявленную ценность'''. Значение по умолчанию '''Да''', все отправлениявы можете изменить это, у которых Клиент установит «Ответственный филиал»выбрав одно из значений:** "Да"<br><span style="padding-left: 5px;">Оценочная стоимость формируется по принципу наибольшего значения.</span><br><span style="padding-left: 5px;">Учитываются Оценочная стоимость всего заказа, соответствующий Агенту (правильнее всего это делать оформив [[Манифесты|манифест]]Оценочная стоимость товарных вложений, скомплектовав егоцена товарных вложений.</span><br>** "Нет"<br><span style="padding-left: 5px;">объявленная ценность товарных вложений передаваться не будет</span><br>** "Передавать, если указана"<br><span style="padding-left: 5px;">Учитываются только суммы из полей Оценочная стоимость заказа и проставив дату отправки)Оценочная стоимость товарных вложений, будут переданы где в БД Агентаприоритете Оценочная стоимость заказа.</span>** "Передавать, по местам, если указана"<br><span style="padding-left: 5px;">Оценочная стоимость заказа распределяется по вложениям. Вложения в свою очередь распределяются по местам.</span>Оценочная стоимость передается по каждому товару, а не общей суммой. Необходимо указать сумму оценочной стоимости, которая будет соответствовать количеству товаров и статусы будут передаваться обратнопроверить отправку заказа.* '''Добавлять услугу «Осмотр вложений»'''. Тарифицируемая услуга от СДЭК, поэтому она добавится, только если в настройках указано '''Да''';* '''Процент за наложенный платеж'''. Используется при получении агентской цены. На передачу данных может уходить до 10 минут Калькулятор API CDEK не включает в штатном режимерасчет сумму за наложенный платеж автоматически, но мы добавим указанный вами процент в итоговую сумму;* '''Использовать как номер'''. Номер заказа отображается в личном кабинете и отчетах СДЭК. Выберите удобный вариант: '''Шифр''' или '''Штрихкод''';* '''Код курьера'''. Укажите код курьера, который будет указан в поле '''Вручил курьер''' для доставленных заказов.* '''Способ доставки до 1 часа ПВЗ отправления'''** "Самопривоз в случае возможных сбоевофис СДЭК" - установлено по умолчанию, необходимо заполнить <b>Код пункта приема</b>** "Забор со склада" - в заказе указывается адрес склада с которого курьеры СДЭК забирают отправления. Адрес указывается в карточке ответственного филиала для которого настраивается интеграция со СДЭК вер.2.0** "Забор у отправителя" - в заказе указывается адрес отправителя с которого курьеры СДЭК забирают заказы.*** <i>Адрес из карточки клиента владельца фирмы отправителя</i> - если в ответственном филиале интеграции настроено "Скрывать отправителя"*** <i>Адрес отправителя из карточки заказа</i> - если он не пустой*** <i>Адрес из карточки отдела</i> - если пустой адрес отправителя в заказе*** <i>Адрес из карточки клиента отправившего заказ</i> - если пустой адрес отдела
Для стабильной работы необходимо наличие версии минимум 518 от 05.12.2014 у обеих компаний
<div style== "color: #a94442; background-color: #f2dede; border: 1px solid #ebccd1; padding: 3px 10px 10px;">* Интеграция СДЭК версии 2.0 не предусматривает автоматическую отправку заказа после получения ошибки. Чтобы отправить заказ повторно после исправления, обратитесь в техподдержку MeaSoft.* Интеграция с подрядчиками (передача не предусматривает проверку номеров телефонов передаваемых заказов) ===== Отказ от ответственности ===Хотим обратить Ваше внимание на то, что интеграции со сторонними системами делаются в соответствии с документацией соответствие стране. api СДЭК проверяет номера телефонов на момент написания, соответствие списку стран после отправки заказа. Список стран номера телефонов которых принимаются без партнерства с компаниямиограничений опубликованы в [https://api-поставщиками сервисаdocs. Об изменениях API нас не оповещают, поэтому интеграции, по независящим от нас причинам, могут переставать работать, работать нестабильно или некорректно, вплоть до потери важной (финансовой?) информацииcdek. Заказы, переданные во внешние системы нужно обязательно проверять на корректность пользуясь личным кабинетом партнераru/29923926. html документации СДЭК]</div>
=== Общие правила настройки интеграции ===Здесь рассматривается интеграция с системами сторонних компаний (Агент)При выборе тарифа для отправки заказа приоритет отдается тарифам режима срочности, где система "Курьерская служба 2008" (Клиент) выступает клиентомвыбранного в заказе. Если в режиме срочности не настроены тарифы, тто тариф выбирается из списка в параметре интеграции '''Приоритет тарифов'''.е. передает заказы, и получает обратно статусыВ этом случае отправка в СДЭК осуществляется первым доступным тарифом из списка.
1) Клиент должен иметь аккаунт в системе MeaSoft («Справочники» – «Дополнительные модули»)Доступные для выбора списки тарифов по умолчанию:* «Экономичная посылка», и должна быть установлена галка «Личный кабинет» в указанном окне* «Посылочка»,* «Экспресс-лайт»,* «Магистральный экспресс».
2) Создайте в своей системе филиал (Справочники – Межгород – Филиалы) для указанного АгентаТакже возможно выбрать второй вариант, который поменяет местами тарифы «Экономичная посылка» и «Посылочка». После ввода филиала нужно перевойти в программу и подождать 3 минуты* «Посылочка»,* «Экономичная посылка»,* «Экспресс-лайт»,* «Магистральный экспресс».
3) Зайдите в свой личный в системе MeaSoft (смПри весе отправления больше 30 кг применяется тариф «Магистральный экспресс». иллюстрацию). Перейдите на закладку «Интеграция». В таблице должен появиться созданный филиал. [[Файл:Measoft home.png|thumb|200px|right]]
4) Нажмите кнопку «Настроить» напротив филиалаЧтобы передать услугу «Примерка», установите флажок '''Принято на склад''' в открывшемся окне выбирает интегратор той компании[[Единица корреспонденции#Создание единицы корреспонденции|карточке корреспонденции]]. Если услуга не нужна, с которой хотите интегрировать, далее – заполните форму по отображенной инструкции (для каждого интегратора форма и инструкции свои, нажмите «Сохранить»снимите флажок.
При передаче валюты наложенного платежа код валюты берется из поля '''Валюта''' карточки клиента, от которого передается заказ. Валюта должна совпадать с валютой страны назначения заказа. Если заказ отправляется в другую страну, создайте копию клиента с нужной валютой и оформляйте заказы от него, указывая цены в валюте страны назначения.
В результате такой настройки, все отправления, у которых Клиент установит «Ответственный филиал», соответствующий Агенту (правильнее всего это делать оформив [[Манифесты|манифест]], скомплектовав его, и проставив дату общем случае интеграция не поддерживает отправки), будут переданы в БД Агентадругие страны, и статусы будут передаваться обратно. На передачу данных может уходить до 10 минут в штатном режиме, и до 1 часа в случае возможных сбоевкроме России.
Для стабильной работы необходимо наличие у Клиента системы "Курьерская служба 2008" версии минимум 518 от 05[http://courierexe.12ru/download/userfunc/SDEK_report_load.2014xml Загрузка отчета СДЭК] создает входящий АПД по отчету СДЭК [http://courierexe.ru/download/userfunc/SDEK_report_demo.xls такого формата]. Работает при передаче заказов в СДЭК с помощью штатной интеграции. Заполняет поле '''Агентская цена''' в карточке корреспонденции на вкладке '''Межгород'''.
=== DPD ===
<div style="color: #a94442; background-color: #f2dede; border: 1px solid #ebccd1; padding: 3px 10px 10px;">
<b>Внимание!</b><br>
Для одного аккаунта DPD может быть настроена только одна интеграция.<br>
Если вам требуется настроить интеграцию для нескольких филиалов, предварительно создавайте новый аккаунт DPD для каждой интеграции.
</div>
Статусы заказов передаются корректно, только если для одного аккаунта DPD настроена одна интеграция. <br>
При выборе тарифа для отправки заказа приоритет отдается тарифам режима срочности, выбранного в заказе.
=== СДЭК ===Для настройки интеграции с платформой DPD укажите следующие параметры:* '''Клиентский номер''' - уникальный клиентский номер в системе DPD.* СДЭК '''Клиентский ключ''' - ключ для авторизации, полученный у сотрудника DPD.* '''Код пункта самопривоза''' - не позволяет передать количество занимаемых местобязательный параметр. код пункта самовывоза, куда клиент DPD доставляет заказ для отправки.* Отправка в СДЭК осуществляется первым доступным тарифом '''Номер регулярного заказа''' - номер регулярного заказа DPD. Если вы используете доставку на регулярной основе, уточните этот номер у своего менеджера.* '''Проверка комплектности''' - по умолчанию отсутствует. Есть возможность выбрать одно из списказначений:# Экономичная посылка# Посылка# Экспресс лайт# Магистральный экспресс
В настройках интеграции КС может поменять местами тарифы Экономичная посылка и Посылка.<ul>При весе отправления большем 30 кг отправление осуществляется тарифом Магистральный экспресс.<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>
* Передача '''валюты''' наложенного платежа: Код валюты мы берем из поля "Валюта" карточки клиента, от которого передается заказ. Валюта обязательно должна совпадать с валютой страны назначения заказа. Если отправляется заказ в другую страну - нужно создать копию клиента с нужной валютой, оформлять заказы от него, указывая все цены в валюте страны назначения.* В общем случае интеграция не поддерживает отправки в другие страны, кроме России.* [http://courierexe.ru/download/userfunc/SDEK_report_load.xml Загрузка отчета СДЭК] Создает входящий АПД по отчету СДЭК [http://courierexe.ru/download/userfunc/SDEK_report_demo.xls такого формата]. Работает начиная с версии 626 от 29.01.2016 и только при передаче заказов в СДЭК с помощью штатной интеграции. Заполняет поле '''"Агентская цена"''', в карточке кор-ии, на вкладке '''"Межгород"'''.=== TopDelivery ===
=== Топ деливери ===Для настройки интеграции с платформой 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]]<br>Возможность запрета вскрытия отправления добавляется при отправке заказа, если в настройках интеграции разрешен запрет и в заказе стоит отметка "Принято на склад"
[[Файлы для загрузки#.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]]
=== Почта России ===
Интеграция с Почтой России описана в разделе [[%D0%A0%D0%B0%D0%B1%D0%BE%D1%82%D0%B0_B0 %D1%81_81 %D0%9F%D0%BE%D1%87%D1%82%D0%BE%D0%B9_B9 %D0%A0%D0%BE%D1%81%D1%81%D0%B8%D0%B8|Работа с Почтой России]].
=== PickPoint ===
Если PickPoint выделил вам диапазон трекинг-номеров, то необходимо настроить филиал и придерживаться последовательности отправки [[Манифесты#Отправка|манифестов]].
=== Чтобы настроить филиал для интеграции PickPoint ===с диапазоном, в основном меню выберите '''Справочники''' > '''Межгород''' > '''Филиалы''', откройте карточку [[Филиалы|филиала]] и на вкладке '''Интеграция''' в выпадающем списке '''Правила назначения кода заказа у подрядчика''' выберите '''Из диапазона'''. Укажите начальный и конечные коды диапазона, префикс при необходимости и нажмите клавишу '''ОК'''.
Если '''PickPoint''' выделил вам диапазон трекинг-номеров, то необходимо настроить филиал и придерживаться последовательности Для отправки манифестов.Для настройки филиала для интеграции добавьте заказы в манифест, затем на вкладке '''PickPointМанифесты''' с диапазоном отсканируйте заказы в основном меню мешок и выберите '''Справочники -> Межгород -> Филиалы''' нажатием правой кнопки мыши на предварительно созданном филиале, в карточке манифеста ранее настроенный филиал. После этого в контекстном меню манифеста выберите '''Открыть''' в открывшейся форме перейдите на вкладку '''Интеграция''' и в выпадающем списке '''Правила назначения кода заказа Проставить коды у подрядчика''' выберите '''Из диапазона'''. Укажите начальный и конечные коды диапазона, префикс при необходимости и нажмите клавишу '''ОК'''.
Для отправки манифестов добавьте заказы в манифест, затем, на вкладке '''Манифесты''' необходимо добавить требуемые заказы в мешок, а далее выбрать в манифесте ранее настроенный филиал. После чего, в контекстном меню манифеста выбрать пункт '''Проставить коды у подрядчика'''.
После этого можно указать дату отправки манифеста.
Обратите внимание, что проставить коды с указанной датой отправки манифеста нельзя. Необходимо сначала очистить дату отправки, а затем проставить коды.
Агентская цена данной интеграцией не возвращается, т.к. так как эти данные отсутствуют в API PickPoint.
=== КСЭ ===
Для обращения к функциям системы необходимо знать своё имя пользователя и пароль в системе КСЭ.<br>
Если у вас еще нет доступа, то необходимо обратится к Вашему менеджеру в подразделение клиентского сервиса КСЭ.<br>
<b>Настройки интеграции:</b><br>
* '''Логин''' - логин от ЛК КСЭ
* '''Пароль''' - пароль от ЛК КСЭ
* '''Данные отправителя''' — данные, которые будут подставляться во все отправления, передаваемые в КСЭ. Если не указать, то будут передаваться данные заказчика (отправителя) из корреспонденции.
* '''Является ИМ''' — признак отправителя в системе КСЭ. От данного признака зависит главным образом, как отправляются данные в КСЭ. Признак указывается в договоре клиента с КСЭ.
* '''Забор''' — настройка, в которой можно указать, каким образом отправление передается в КСЭ — КСЭ забирает отправление у клиента или клиент сам привозит отправление в КСЭ.
** '''По умолчанию''' — груз будет принят для доставки в офисе (самопривоз в КСЭ) для всех заказов с товарной составляющей, иначе будет послан курьер для забора.
** '''До двери''' — будет послан курьер для забора
** '''Самопривоз в КСЭ''' — груз будет принят для доставки в офисе
При выборе тарифа для отправки заказа приоритет отдается тарифам режима срочности, выбранного в заказе.
* '''Адрес получателя'''
** '''Как указано в заказе'''
** '''Склад курьерской службы''' в этом случае, адрес получателя указывается, как адрес ответственного филиала, для которого настроена интеграция, а адрес отправителя, как адрес реального отправителя, указанного в карточке заказа (для забора курьером у отправителя и доставки на склад курьерской службы)
При отправке заказов учитывается тип отправления. Если в карточке заказа указан тип [1] "Письмо", то вида груза в CSE устанавливается, как "Документы" [81dd8a13-8235-494f-84fd-9c04c51d50ec], иначе [4aab1fc6-fc2b-473a-8728-58bcd4ff79ba] "Груз".
Настройки интеграции:* '''Данные отправителя''' - данные, которые будут подставляться во все отправления, передаваемые в КСЭ. Если не указать, то будут передаваться данные заказчика (отправителя) из корреспонденции.* '''Является ИМ''' - признак отправителя в системе КСЭ. От данного признака зависит главным образом, как отправляются данные в КСЭ. Признак указывается в договоре клиента с КСЭ.* '''Забор''' - настройка, в которой можно указать, каким образом отправление передается в КСЭ - КСЭ забирает отправление у клиента или клиент сам привозит отправление в КСЭРазные виды груза тарифицируются по разному.
<!--== Тарификация и = DOSTAVKA.GURU === '''Настройка'''. Для интеграции введите следующие учетные данные:* '''Идентификатор клиента''' — ID клиента DOSTAVKA.GURU. ID клиента отображается вверху страницы личного кабинета клиента DOSTAVKA.GURU;* '''Ключ клиента''' — запросите API-ключ интеграции у DOSTAVKA.GURU.* '''Регион откуда повезется заказ''' - Доступен выбор подрядчика из трех вариантов:<ul><ol><span style="color: blue; margin-right: 10px;">○</span> По договору (В этом случае, мы не сообщаем о регионе отправки в систему Guru и его тарифа клиентом регион определяется договором с DOSTAVKA.GURU)</ol><ol><span style="color: blue; margin-right: 10px;">○</span> Москва</ol><ol><span style="color: blue; margin-right: 10px;">○</span> Санкт-Петербург</ol>Вы можете настроить подключение своего тарифа </ul> '''Запрещенные символы'''. Перед отправкой номер заказа и имя получателя проверяются на наличие запрещенных символов. Если обнаружены запрещенные символы, заказ не отправляется в интеграцию и получает ошибку. Из других текстовых полей запрещенные символы удаляются. Это не приводит к тарифу партнераполучению ошибки. При проверке имени получателя и других текстовых полей используется сокращенный список запрещенных символов. Партнерами могут быть любые компании Сокращенный список недопустимых символов для текстовых полей:<code>['~', '`', '@', '#', '$', '%', '^', '&', '=', '+', '!', '"', работающие в системе MeaSoft'№', а так же ряд дополнительных компаний';', с которыми у нас есть интеграции':', '?', '\']</code> Полный список ниже. Для этого откройте недопустимых символов:<code>['~', '`', '@', '#', '$', '%', '^', '&', '=', '+', '!', '"', '№', ';', ':'Справочники, '?', '\' -> , '\s', 'Статусы*', '(', выберите '_', '17 Виды срочности{', '}', '. Создайте вид срочности', ',', '\[', '\]', например "СДЭК"'\']</code> Кроме того, для штрихкодов недопустима кириллица. '''Статусы'''. Запрашиваются интеграцией в автоматическом режиме. Нажмите правой кнопкой Изменение статуса на него - стороне Guru изменит и статус заказа в соответствии с картой статусов. '''Агентская цена'''Дополнительная информация.Обновляется при получении статусов.Агентская цена Guru публикуется в разрезе стоимости услуг и тарифов, которые суммируются перед обновлением агентской цены в заказе. ''', и во Возвраты'''. Учитываются только при получении заказом статуса '''второйЧастичная доставка''' строке заполните параметры подключения к партнеру через запятую.--> === 5POST ===Параметры для настройки:* 1'''API-й Параметр - код филиала партнера. Смотреть в Справочники - Межгород - Филиалыключ'''* '''Код склада отправителя'''* 2-й Параметр - код экстра '''Уникальный номер партнера в системе MeaSoft. В том числе 5Post'''* '''Максимальный вес для сторонних компаний есть кодыфиксированного тарифа''' - При привышении установленного веса, смсумма тарифа изменяется пропорционально. таблицу нижеПо умолчанию 3кг.* 3'''Код подрядчика в карточке заказа''' -й Параметр - имя пользователя в системе партнера. Может отличаться от того, под которым работает интеграция, здесь нужно для расчета цены для клиента. В таблице ниже указано, что вводить для каждого интегратора.доступно три вида отображения кода подрядчика:<ul>* 4<ol><span style="color: blue; margin-й Параметр right: 10px;">○</span> Оригинальный код 5post - пароль к пользователю из 3Установлено по умолчанию</ol><ol><span style="color: blue; margin-го параметра. В таблице ниже указано, что вводить right: 10px;">○</span> Код для каждого интегратора.поиска заказа в ЛК 5post</ol><ol><span style="color: blue; margin-right: 10px;">○</span> Код грузоместа</ol></ul>* 5'''Габариты мест'''<ul><ol><span style="color: blue; margin-й Параметр right: 10px;">○</span> Группировать - вид срочности партнера. Посмотреть доступные коды видов срочности можно Установлено по ссылке в таблице нижеумолчанию<br>При установке этого значения, в калькуляторе в выпадающем спискевсегда передается только одно место с обобщенными габаритами и кодом соответствующим коду заказа. Можно в одинарных кавычках указать несколько видов срочности через запятую</ol><ol><span style="color: blue; margin-right: 10px;">○</span> Отправлять указанные<br>При установке этого значения, каждое место отправляется отдельно, тогда система будет стараться выбрать из них первый доступныйс соответствующими ему габаритами и кодом.</ol></ul> * 6'''Тип расчета тарифа'''<ul><ol><span style="color: blue; margin-й Параметр right: 10px;">○</span> Общий - наценка к цене, передаваемой подрядчиком. В деньгах или в процентах, если стоит знак процента. Например 10 Установлено по умолчанию</ol><ol><span style="color: blue; margin- наценка 10 рублей, 10% - наценка 10 процентовright: 10px;">○</span> По местам</ol></ul>
{|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-й - через запятую Пароль и Договор ИКН. Можно оставить пустыми, но цены будут В интеграции 5post не всепредусмотрена передача оригинальных штрихкодов мест.||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Штрихкоды генерируются по правилам 5post.ru/90008/calculator|-|ПОЧТА РОССИИ||90010||https://home.courierexe.ru/90010/calculator||<!--Введите "логин отправки" в 3-й параметрПредварительно, а в 4-й в одинарных кавычках через запятую пароль отправки и токен. Пустыми оставлять нельзя, т.к. интеграция с Почтой пока не позволяет рассчитывать цены без договора (авторизации).-->Пока поддерживаются только базовые тарифы, без авторизации. Пока расчет работает очень медленно, мы над этим работаем.||10497, 90010,,, '2, 1', 10 <!--10497, 90010, 89251234567, 'mypassword,u23B0r9AAJ1Fyh4ptMzJ3kjxcslamwdx', '2, 1', 10-->|-|ДПД||90011||https://home.courierexe.ru/90011/calculator|-|ДОСТАВКА ГУРУ||90017||https://home.courierexe.ru/90017/calculator||3-й параметр - ID партнера в системе DOSTAVKA.guru, 4-й - Ключ доступа||10497, 900175post предоставляет возможность добавления оригинального штрихкода места, 9999, cc03e747a6afbbcbf8be7668acfebee5, '1', 100|-|5Пост||90020||httpsкоторый должен отвечать следующим правилам://home.courierexe.ru/90020/calculator||3-й параметр - API-ключ, 4-й - Уникальный номер партнера в системе 5post. При необходимости в 4-й параметр можно через запятую указать пороговое значение веса (по-умолчанию 3 кг). Пустыми оставить нельзя.||10497, 90020, u23B0r9AAJ1Fyh4ptMzJ3kjxcslamwdx, 1, 100|}
При выборе клиентом * Штрихкод должен состоять только из символов ASCII в личном кабинете вида срочности, подключенного таким образом к партнеру, '''набор доступных ПВЗ''' будет ограничен выбранным партнеромдиапазоне с 0 по 127 индекса. * Длина штрихкода не должна превышать 34 символа.
'''При отправке''' заказа по интеграции с подключенным видом срочности, интеграция постарается отправить заказ '''одним из режимов''', введенных в п.6 (по порядку, в порядке приоритетов), а если не получится - вернет '''ошибку'''=== Яндекс.Доставка ===
== Интеграция Для подключения к интеграции в вашем договоре с клиентами (получение заказов) ==Яндекс.Доставкой должна быть подключена услуга доставки на следующий день. Если у вас эта услуга не подключена, заполните [https://forms.yandex.ru/surveys/10833592.0f3ead3120074ee64cd9dde1df70b27d8d2678d2/ эту форму].
=== Замечания ===Сначала необходимо проверить, рассчитывается ли стоимость доставки в ЛК Яндекса и можно ли оформить заказ. Если все работает - переходим к настройке интеграции.
[[ФайлДля настройки интеграции с платформой Яндекс.Доставка укажите следующие параметры:*'''Токен''', можно посмотреть тут https:Form//dostavka.yandex.png|100 px|мини|Форма отправки ru/account/integration*'''ID пункта отправления''', необходимо уточнить у вашего менеджера или в поддержке Яндекса* '''Особенности формирования данных''' с вариантами на выбор:** ''нет''** ''Трактовать места, как товары'' - в заказе формируется только одно место в котором размещаются вложения с габаритами и массой переданных мест.** ''Трактовать товары, как места'' - каждый товар добавляется в место соответствующее его габаритам, т.о., сколько в заказе товаров, столько же будет сформировано мест.Эти параметры обязательные и влияют на отправку заказа]]. Доступы должны быть НЕ тестовые (продовые). Уточните эти данные у вашего менеджера или в поддержке Яндекс.Доставки.* '''Настройка списка ПВЗ''' - Позволяет настраивать список получаемых от Яндекс ПВЗ, доступны варианты:** ''Получать все доступные ПВЗ''** ''Отключить постаматы''** ''Отключить все ПВЗ''
# В модулях систем '''PrestaShop''', '''OpenCart''', '''OCStore''', '''Webasyst''', '''InSales''' и '''Joomla''' для отправки заказа в курьерскую службу зайдите в карточку заказа, в которой должна отображаться форма (см. изображение). Форма позволяет отправить заказ, а если заказ отправлен - проверить его статус.
# Оформление заказов до '''ПВЗ''' в модулях не реализовано. Чтобы оформить такой заказ, в поле '''передаваемого адреса''' укажите одно из значений:
#* код ПВЗ, который можно посмотреть в нашем ЛК или на сайте агента (''Boxberry'', ''CDEK'' и т.д.). Обычно это цифровой или цифро-буквенный код;
#* наименование ПВЗ, добавив в начале строку "ПВЗ ", например '''ПВЗ На Ленина'''.
=== OpenCart 1.5.5.1 ===Для настройки модулей используйте:
Важно! Перед любыми изменениями настроек рекомендуется сделать резервную копию сайта.Для настройки синхронизации:# Загрузите содержимое папки upload из архива в папку сайта по FTP. При необходимости подтвердите замену файлов.# Зайдите в панель администратора OpenСart. Подробнее см. в [https://docs.ocstore.com/index.php?title=Панель_Администратора документации OpenCart].# В меню панели управления выберите '''Дополнения''', раздел '''Модули'''. В открывшемся списке найдите '''КС2008''' и нажмите на кнопку '''Установить'''.# В меню панели управления выберите '''Дополнения''', раздел '''Доставка'''. В открывшемся списке найдите '''Основные настройки интеграции КС2008''' и нажмите на кнопку '''Установить'''. Рядом появится кнопка '''Изменить'''.# Нажмите на кнопку '''Изменить'''. Откроется страница «Основные настройки интеграции КС2008»:[[Файл:OpenCart.png|900px|none]]<br>Заполните обязательные поля:#* '''Логин''' — логин пользователя, выдается курьерской службой.#* '''Пароль''' — пароль пользователя, выдается курьерской службой.#* '''Код курьерской службы''' — выдается курьерской службой.#* '''Город отправителя'''. После ввода убедитесь, что в названии населенного пункта нет ошибок.<br>При необходимости заполните остальные поля. Нажмите на кнопку '''Сохранить'''.# В меню панели управления выберите '''Дополнения''', раздел '''Доставка'''. В открывшемся списке найдите '''Настройки доставки курьером КС2008''' и нажмите на кнопку '''Установить'''. Рядом появится кнопка '''Изменить'''.# Нажмите на кнопку '''Изменить''' и в поле '''Тариф для расчета стоимости доставки''' выберите нужный тариф. По умолчанию используется первое значение выпадающего списка- ваш токен.
=== OpenCart 2*'''Пароль''' - Код пункта отправления.0 и выше ===Имеет вот такой формат 4eccdad3-8d97-4fbf-b241-3c2a89a8aa79
Для настройки синхронизации:# Скачайте [[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''' и нажмите на кнопку '''Установить'''. Рядом станет активна кнопка '''Редактировать'''. # Нажмите на кнопку '''Редактировать''' и в поле '''Тариф для расчета стоимости доставки''' выберите нужный тариф. По умолчанию используется первое значение выпадающего списка- 90023.
=== 1C-Битрикс= Настройка забора ====Чтобы настроить интеграцию:# В личном кабинете 1CЗабор в заказе определяется <i>Пароль -Битрикс на вкладке '''Администрирование''' в панели слева выберите '''Marketplace''' Код пункта отправления</i> '''Каталог решений''' и (ID Станции на странице «Каталог Маркетплейс» с помощью строки поиска найдите '''Модуль интеграции MEASoft'''.# Щелкните по ссылке «Установить».# Убедитесьстороне Яндекс), что в строке '''Модуль интеграции MEASoft''' установлен флажок, и нажмите на кнопку '''Загрузить'''. Далее примите лицензионное соглашение и нажмите '''Применить'''.# После окончания загрузки нажмите на кнопку '''Установить'''.# В панели слева выберите '''Магазин''' если <i> '''Настройки''' Пароль</i> '''Службы доставки''', затем на странице «Список служб доставок» раскройте выпадающий список кнопки '''Добавить''' и выберите пункт '''Автоматизированная служба доставки'''. Откроется страница «Новая служба доставки».# На странице «Новая служба доставки» перейдите на вкладку '''Настройки обработчика''' и в выпадающем списке '''Служба доставки''' выберите '''"Курьерская служба" - сервис доставки'''. Нажмите на кнопку '''Применить'''.# Перейдите указывает на вкладку '''Настройки интеграции''': [[Файл:Bitrix Настройки интеграции.png|none|1100px]]#: На этой вкладке:#* в разделе '''Настройка доступа''' введите учетные данные курьерской службы;#* в разделе '''Основные настройки''':#** в поле '''Статус отправки заказа''' выберите статуссклад клиента, при котором заказ с которого курьер Яндекса будет отправляться в курьерскую службу;#** в поле '''Оплата картой''' выберите тип оплаты, который будет соответствовать оплате картой (если оплата картой возможна);#** установите флажок '''Использовать артикулы''', если артикулы будут использоваться для привязки номенклатуры к складу курьерской службы;#* в разделе '''Соответствующие поля покупателя''' настройте соответствие полей получателя (ФИО, городазабирать отправления, адреса и др.) полям в форме создания заказасогласно расписанию календаря отгрузок.<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. Значения полей '''Комментарий покупателя к заказу''' и '''Комментарий менеджера''' передаются из 1С-Битрикс Добавить склад в Избранные адреса, по инструкции в ссылке.* 2. Запланировать отгрузку на этот склад через Календарь отгрузок.* 3. Написать на почту в поле '''Комментарий''' заказа техподдержку Яндекс <span style="color: #0011ff;">next_day_delivery@go.yandex.ru</span> или чат поддержки в системе MeaSoftличном кабинете и запросить у специалиста техподдержки Яндекс ID Станции (склада, который был зарегистрирован, согласно инструкции).
Если статус уже установлен, но заказ не отправлен в курьерскую службу (связано с техническими особенностями):
# Выберите статус заказа по умолчанию после его создания (например, '''Новый''').
# Перезагрузите страницу.
# Выберите статус отправки и сохраните его.
При отправке заказа появится сообщение об успешной отправке или об ошибке.
Статус заказа можно проверить в карточке заказа, в правом верхнем углу.
'''Примечание'''При создании заказа обратите внимание на адрес — он должен быть понятным. Проверить работу модуля можно в форме оформления доставкиНаиболее понятным для Яндекса будет адрес, где нет дополнительных комментариев, а части адреса разделены запятыми. При этом должна корректно считаться стоимость доставкиБез заполнения адреса с указанием номера дома курьерская доставка будет не доступна.
<spoiler text="Если возникает ошибка"># Если В интеграцию не рассчитывается стоимость:#* некорректно установлен модуль;#* введены некорректные учетные данные;#* в курьерской службе не настроен тариф. Обратитесь в курьерскую службу для настройки тарифа. После настройки тарифы можно проверить в личном кабинете, принимаются заказы на вкладке '''Калькулятор'''.# По умолчанию при оформлении заказа должны появиться поля даты и времени желаемой доставки. Если они отсутствуют, то у формы были изменены стили. Также возможно обновление формы в системе Битриксюридические лица.[[Файл:Bitrix2Т.png|center|700 px]]# Проверьте правильность привязки свойстве. Для этого в разделе '''Рабочий стол''' > '''Магазин''' > '''Настройки''' > '''Свойства заказа''' > '''Список свойств''' найдите свойство, связанное с ошибкой, щелкните по нему правой кнопкой мыши и выберите '''Изменить параметры свойства'''.<br>На вкладке '''Привязка свойства''' настраиваются условия, при которых поле будет показываться клиенту. Если у свойства заказа настроена привязкаФИО должно быть именно ФИО, то оно будет показываться ТОЛЬКО в том случае, когда покупатель выберет хотя бы один из указанных критериев:[[Файл:Битрикс Связь свойстваа не название организации.png|center|500px]]
В этом примере покупатель при оформлении Если заключен договор на передачу в Яндекс уже оплаченных товаров и производится попытка отправить запрос на передачу заказа увидит созданное поле для заполнения только в том случае, если с типом оплаты «Наличными» - Яндекс возвращает ошибку «Тариф не найден». Если клиент оплачивает заказ на предыдущих шагах он выбрал оплату '''Наличными курьеру''' (при любой службе доставки)сайте, или же если захотел расплатиться любым способомзатем передает в доставку, но выбрал в качестве службы доставки '''Воздушный транспорт'''необходимо передавать значение «NO».
Свойство будет показано всегдаОтправка заказов происходит автоматически. Если адрес не распознан и заказ не отправлен с первой попытки, если привязка интеграция попытается разобрать адрес доступными ей средствами и снова отправить заказ. Если заказ так и не выбрана или если выбраны все варианты платежных систем или служб доставкиполучилось отправить, проверьте адрес получателя, возможно, в нем допущена ошибка. После исправления адреса заказ отправится автоматически.
Подробнее смПри отправке заказа обязательно указываются места с габаритами и массой. [https://devЕсли в заказе указаны места, они добавляются как есть.1c-bitrixЕсли мест в заказе нет, то создается одно фиктивное место, габариты которого формируются на основе габаритов вложений.ru/learning/course/indexВложения не разделяются по местам и попадают в первое сформированное место.php?COURSE_ID=42&LESSON_ID=3073&LESSON_PATH=3912.4580.4828.3073 документацию 1С-Битрикс].</spoiler>=== Insales ==={|align="right" |-valign="top" |[[Файл:insales1.png|250 px|мини|рис.1 Начало установки]] |[[Файл:insales2.png|250 px|мини|рис.2 Подтверждение установки]] |- |[[Файл:insales3.png|250 px|мини|рис.3 Список приложений]] |[[Файл:insales4.png|250 px|мини|рис.4 Настройка подключения]] |}
# Установить приложение можно [http://www.insales.ru/collection/all/product/kurierskaya-sluzhba-2008 по ссылке] - зеленая кнопка '''"Установить"''' (Рис. 1).# В Личном кабинете появится уведомление для установки приложения '''«Модуль "Курьерская служба 2008"»''' (кнопка '''"Установить"'''). После этого подтвердить установку (Рис. 2).# Настройка приложения. Необходимо зайти Этикетки Яндекса подгружаются в приложения и нажать на название '''«Курьерская служба 2008»''' (Рисприкрепленные файлы. 3). Произойдет переход на страницу Личного Кабинета (homeПри удалении из интеграции заказов, этикетки из прикрепленных файлов не удаляются.courierexe.ru) с возможностью ввода параметров.# Параметры '''Код курьерской службы'''Для того, '''Логин''' чтобы загрузились и '''Пароль''' необходимо запросить у курьерской службыраспечатались новые этикетки, с которой настраивается интеграция, ввести их в поля и сохранить (Рис. 4).# Далее необходимо ввести статус, при присваивании которого в Insales, будет происходить автоматическая передача данных в программу и префикс к заказам.# После установки приложения '''«Модуль "Курьерская служба 2008"»''' - он появится в ЛК (home.courierexe.ru) в списке установленных в разделе '''"Приложения"'''нужно удалить старые из прикрепленных файлов.
'''Замечания'''После настройки модуля или создания новой интеграции ПВЗ появляются на следующий день.
* Тип оплаты заказа определяется следующим образом:** Если заказ оплаченДля смены пароля зайдите в ЛК с токеном и старым id ПВЗ, то передается тип оплаты ''Без оплаты''** Если тип оплаты '''Оплата банковской картой''' или '''Оплата банковской картой курьеру''', то передается тип оплаты ''Банковская карта''. Указанные типы оплаты необходимо создать в InSales вручную.** Иначе передается тип оплаты ''Наличными''** На стороне курьерской службы как в карточке интернет-магазина есть галка "Спрашивать тип оплаты у получателя"модуле. Если она установлена, то независимо от переданного типа оплаты ''НаличнымиВыберите '' или 'Сменить пароль'Банковская карта'', покупателю будет предложен выбор способа оплатыи укажите старые и новые пароли.
=== Л-Пост ===Для настройки интеграции с платформой Л-Пост укажите следующие параметры:*'''НастройкиСекретный ключ клиента''' интеграции можно изменить в разделе ,*'''АвтоматизацияКод пункта приема''' личного кабинета- Не обязательный параметр. Заполнять параметр не нужно, если отправления сдаются на центральный склад Л-Пост (Родники, ул.Трудовая, д.10) или забираются со склада партнера силами Л-Пост .<br> В других случаях, в качестве точки приема отправлений могут выступать пункты выдачи заказов Л-Пост и склады Л-Пост.
=== RetailCRM ===
{|align="right" |-valign="top" |[[Файл:Retail1При отправке заказа обязательно указываются места с габаритами и массой.png|250 px|мини|рисЕсли в заказе указаны места, они добавляются как есть.1 Настройка типа доставки]] |[[Файл:Retail2.png|250 px|мини|рис.2 Выбор типа доставки Если мест в заказе]] |- |[[Файл:Retail3нет, то создается одно фиктивное место.png|250 px|мини|рис.3 Выбор тарифа]] |[[Файл:Retail4.png|250 px|мини|рис.4 Добавление способа оплаты]] |- |[[Файл:Retail5.png|250 px|мини|рисВложения не разделяются по местам и попадают в первое сформированное место.5 Настройка способов оплаты]] |}
# Создайте API-ключ (Настройки, пункт Интеграции, раздел Ключи доступа к API) для доступа модуля к интеграции.
# В настройках API-ключа разрешите все методы (проставить все галочки). Для этого нужно перейти '''Настройки → Интеграция → Маркетплейс''' и верхней части окна выбрать раздел настроек '''Ключи доступа к API'''. <br>API-ключей может быть несколько и в настройках каждого API-ключа необходимо:
#:1) выбрать '''"Доступ ко всем магазинам"''' в разделе '''"Тип доступа"'''.
#:2) проставить '''ВСЕ''' галки в разделе '''"Разрешенные методы API"''', дав тем самым доступ на все методы.
# В разделе Маркетплейс (Настройки, пункт Интеграции) необходимо выбрать модуль "Курьерская служба 2008"
# При нажатии на модуль открывается описание модуля интеграции
# При нажатии на кнопку '''Подключить''' открываются настройки интеграции в ЛК "Курьерская служба 2008"
# Параметры '''Код курьерской службы''', '''Логин''' и '''Пароль''' необходимо запросить у курьерской службы, с которой настраивается интеграция
# В поле '''Аккаунт RetailCRM''' необходимо указать адрес системы, а в поле '''API-ключ''' - ранее созданный API-ключ для модуля
# В системе RetailCRM добавить новый тип доставки в системе через '''Настройки → Справочники → Типы заказов''' и в верхней части окна выбрать раздел настроек '''Типы доставок'''. Кнопкой '''Добавить''' произвести добавление нового типа доставки. Обязательно выбрать интегратора в выпадающем списке '''"Интегрировать с Курьерская служба 2008"''' (рис. 1).
# При создании заказа появится соответствующий '''Способ доставки''' (рис. 2).
# Выберите '''Тариф'''. Он должен подтягиваться из КС. В случае ошибки (рис. 3) обратитесь в курьерскую службу для настройки тарифов. Проверить тарифы можно в ЛК в разделе ''Калькулятор''.
# Для корректной передачи наложенного платежа добавьте '''Способ оплаты''' (рис. 4), который имеет признак '''Наложенного платежа''' в настройках интеграции (рис. 5).
# Для получения печатных форм, аналогичных формам в ЛК Курьерская служба:
#* в заказе нажмите '''Печать''' (вверху) и выберите нужную печатную форму "Курьерская служба";
#* в списке заказов выберите заказы, нажмите '''Действия''' (внизу), '''Распечатать документы''' и выбрать нужную печатную форму "Курьерская служба".
# Если вы хотите отправлять заказы в курьерскую службу по статусам и отменять при изменении типа доставки, можете воспользоваться тригерами. Как их настраивать описано в отдельной статье [[Настройка триггеров для RetailCRM]]
Настройки интеграции можно изменить Обратите внимание, что в личном кабинете зависимости от настроек вашего аккаунта в разделе '''Автоматизация'''Л-Пост может быть недоступна частичная оплата заказа.
===БеруOmnic ===При Для настройки интеграции поддерживаетсяс платформой Omnic укажите следующие параметры:* Обработка координат.
==== Подключение * '''Логин''' - создается самостоятельно, служит для доступа к двум и более курьерским службам или клиентам ====[https://home.courierexe.ru/90025 ЛК экстраинтегратора], может быть любым, главное запомните его.
1. В ЛК * '''Пароль'новой'' курьерской службы зайти по ссылке /retail, чтобы является составным и обязательно должен содержать токен (получается в адресной строке было указано так:службе поддержки омника).
<source lang=php>https://home.courierexe.ru/XXX/retail</source>Так же может содержать
Обратите внимание, что вместо "XXX" у вас должен быть указан экстра код ''новой'ПВЗ отправления''' курьерской службы- код ПВЗ подрядчика, пункт самопривоза.<i>Не обязательный параметр</i>
2. Далее'''Приоритет тарифов''' - последовательность тарифов подрядчика, последовательность подключения аналогична общей последовательностиразделенная пробелами, начиная с пункта 6указывающая доступность и приоритет тарифов в общем случае.<i>Не обязательный параметр</i>
'''Основные принципы работы'''<br> Если омник забирает заказы у вас
* Использование артикулов для привязки к складу системы КС2008 включается в настройках интеграции в ЛК.Пример cf3f645a5afc2e7ae030522711b4464af77dcb2d11997f1ddf5f1de81b003906* Заказ передается в систему КС2008 при его '''''сохранении''''', если не включена галка "''Не отправлять данные в службу доставки''".* Тип оплаты указывается в разделе заказа '''Оплата'''. Для передачи типа оплаты необходимо добавить один из способов оплаты ('''Наличные''' или '''Банковская карта''').* В случае, если заказ был оплачен, тип оплаты можно не указывать.* Количество мест определяется ''упаковками'', которые можно добавить в разделе заказа '''Доставка'''.* Стоимость доставки возвращается в поле '''Себестоимость'''.* Для изменения статусов товаров необходимо настройках интеграции в ЛК включить настройку '''Получать возвраты вложений'''. В этом случае проданный товар получает статус '''Продан''', для него указывается количество проданного товара. Также создается фиктивный товар с таким же наименованием со статусом '''Возврат''', в комментарии которого указывается количество возвращенного.* Код подрядчика (если заказ передается по интеграции) возвращается в поле '''Комментарий менеджера'''.* Курьера и его телефон можно получать в пользовательское поле RetailCRM, указанное в настройке '''Пользовательское поле для получения курьера'''.* Возврат в RetailCRM типа оплаты включается настройкой '''Получать тип оплаты'''. При этом указывается либо стандартный тип оплаты '''Наличными''', либо стандартный тип '''Банковская карта'''.<br>
'''Примечания'''Если вы сами привозите отправления на склад или в ПВЗ омника (самопривоз) пароль будет ТОКЕН, КОД ПУНКТА САМОПРИВОЗА.<br> Пример cf3f645a5afc2e7ae030522711b4464af77dcb2d11997f1ddf5f1de81b003906,MSK317<br>
*Файлы к заказам Если есть необходимость ограничить используемые тарифы, укажите те, которые можно использовать, в системе RetailCRM прикрепить можно. Ограничение 1 МБ на 1 файл.пароле: <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> После добавления нового типа доставки удаление типа доставки в системе RetailCRM будет недоступно, новый тип можно только отключить флажком '''Активность''' внутри настроек выбранного типа доставки.<br>В разных модулях может выбираться из списка или вводиться числом. При выборе другого режима срочности интеграции и модули могут работать не верно либо рассчитывать не все возможные варианты.<br>
</div>
===Мой СкладBTS Узбекистан ===Интеграция предназначена для передачи заказов Для настройки интеграции с товарными вложимыми из системы "Мой склад" в систему "Курьерская служба 2008". В обратную сторону будут приходить статусы, стоимость доставки и общая сумма заказа с учетом частичной доставки. BTS укажите следующие параметры:
* '''Как настроитьТокен API'''- это обязательное поле. Заполните его правильно, и заказы будут отправляться в BTS.Оставшиеся поля служат для более тонкой настройки создания заказов:
# Пройти по ссылке https://home.courierexe.ru/moysklad/step1. Ввести логин и пароль от "Моего склада", а также логин* '''Отправка корреспонденций ''', пароль и код экстраклиента от курьерской службы.# В случае ошибки "Данный пользователь "Мой склад" уже зарегистрирован." необходимо сбросить настройки одноименной кнопкой (появится в случае ошибки).# !ВАЖНО! Подождать пока синхронизируются справочники. Не закрывать и не перезагружать страницу. Данный процесс может занять продолжительное время (от 10 минут).# После синхронизации справочников, автоматически произойдет переход на страницу следующего шага.# !ВАЖНО! до выполнения настроек необходимо перейти в систему МойСклад и создать дополнительные поля в заказах в системе Мой Складпринимать значения:#* строковые:#** "Город" - для указания населенного пункта получателя''Со склада''#** "Дата доставки" - для указания даты доставки наряду со временем#** "Сумма заказа" - для получения суммы заказа от КС#** "Стоимость доставки" - для получения стоимости доставки от КС#** "Строка для сохранения информации об ошибках" - для получения текста ошибки;#** "Количество мест" - для возможности указания количества мест;''С адреса отправителя''#* с типом '''"Справочник"Вызов курьера отправителем''', может принимать значения:#** "Виды срочности" (одноименный справочник),''Нет''#** "Временные интервалы" (одноименный справочник),''Забрать у отправителя''#** "Способы доставки" (одноименный справочник)'''Тестовый режим интеграции''',может принимать значения:#** "Тип оплаты" (одноименный справочник),''Нет''#** "Время доставки с" (справочник ''Включен тестовый режим'Часы доставки'''),#** "Время доставки по" (справочник '''Часы доставкиКод курьера''').# Перейти к шагу 2- Все заказы отмечаются, где настроить статусы отправки, соответствие полей и соответствие статусов.# Сохранить настройки.# !ВАЖНО! Для отправки заказа обязательно должен быть заполнен вес товара (хотя бы одного)как доставленные указанным курьером.
При заполнении информации по заказу поля стоимость доставки, сумма Для отправки заказа:* населенные пункты отправителя и ошибка заполнять получателя должны быть синхронизированы со списком населенных пунктов BTS. Если один из населенных пунктов не нужнобудет синхронизирован, то в карточку заказа будет добавлено сообщение об ошибке:** ''Уточните город получателя'' или ** ''Уточните город отправителя''* заказ должен иметь одно грузоместо. Они заполнятся автоматически после синхронизации с курьерской службойЕсли заказ не имеет грузомест или имеет более одного грузоместа, то он интеграция заблокирует отправку, а в сообщении о доставке карточки заказа опубликуется сообщение: ** ''грузоместо должно и может быть только одно. ''
Поле <div style="Тип доставкиcolor: #a94442; background-color: #f2dede; border: 1px solid #ebccd1; padding: 3px 10px 10px;" - если пустое><b>Внимание!</b><br>* Заказ должен иметь Одно грузоместо.* Для отправки заказа, населенные пункты отправителя и получателя должны быть синхронизированы со списком BTS. * Cинхронизация населенных пунктов, отсутствующих в списке BTS, значит доставка проводится по адресу. Иначе выбираем ПВЗ из списка. запросу в техподдержку</div>
'''Как отправить заказ'''== Отмена заказов в интеграциях ==<div style="color: #a94442; background-color: #f2dede; border: 1px solid #ebccd1; padding: 3px 10px 10px;">Переключите статус заказа на статус для передачи Реализовано в курьерскую службуинтеграциях Почта России, 5Post, Gtd, СДЭК 2. В этот момент "Мой Склад" сообщает нашей системе об этом событии и она забирает заказ0, YandexLogistic, LPost, добавляет его в курьерскую службуOmnic.</div>Если корреспонденция была отправлена в интеграцию, но вы заметили ошибку в данных, либо из интеграции после сохранения заказа в статусе для передачи отправки пришел отчет об ошибке (как например происходит в курьерскую службу статус не изменился необходимо проверить поле "ошибка"интеграции СДЭК версии 2. Необходимо дозаполнить поля указанные в поле "ошибка"0), то корреспонденцию можно отправить по интеграции повторно, очистить поле "ошибка" и сохранить заказпредварительно отменив ее предыдущую отправку. Для этого нужно произвести следующие действия:
'''Как проверить'''Если ошибка очевидна:<br><ul><li>Отмените корреспонденцию в интеграции (Вкладка "Межгород" в карточке корреспонденции, кнопка "Отменить", нажатие кнопки "Сохранить" в карточке корреспонденции). При этом статус корреспонденции в интеграции сменится на "Отменяется"<br><br>
Зайти в Личный кабинет курьерской службы и проверить с помощью вкладки отслеживание существует ли отправленный заказ.
'''Известные проблемы'''
!ВАЖНО! Модуль интеграции не работает на бесплатном тарифе![[Файл:2023-04-03_11-26-09.png |700px]]При установке приложения в "Моем Складе" наша система в нем регистрирует <rspoiler text="событие">т.н. веб-хук</rspoilerbr>, на изменение заказа, чтобы "Мой Склад" нас извещал об изменениях. Так работают все модули служб доставки для МС. Проблема в том, что МС поддерживает только одно подобное событие для заказа, поэтому, если оно занято другим <rspoiler text="установленным модулем"br>А иногда бывает, что модуль удалили, или не до конца установили, а зарегистрированное событие от него осталось</rspoilerbr>, в этом случае мы не сможем его занять, и отправка заказов, к сожалению, работать не будет. Если у вас не отправляются заказы, и вы уверены, что у вас нет других модулей, использующих это событие, обратитесь к нам в службу поддержки, мы сможем проверить занятость события и при необходимости его освободить.
===Wordpress===</li><li>Если заказ <i style====Требования к сайту перед установкой плагина"color:black; background-color:====#CMS WordPress версии 5e91e6326;"> не удалось отменить </i> на стороне подрядчика, (например, или более новаязаказ уже находится в процессе доставки), то статус заказа изменится на "<b>В работе у подрядчика</b>".#WooCommerce версии 3.9В этом случае, или более новая.#PHP версии 7изменение заказа возможно только в личном кабинете подрядчика, или более новаялибо обращением в <i>техподдержку подрядчика</i>.<br>#Сайт должен использовать SSL-сертификат<br>
====Порядок установки плагина и вывод нового способа доставки в корзину:====
#В панели администратора вашего сайта откройте страницу “Плагины - Добавить новый” и нажмите на кнопку “Загрузить плагин”
#В появившейся форме выберите архив с плагином на вашем компьютере и нажмите кнопку “Установить”
#После загрузки и установки плагина вы можете его активировать нажав на соответствующую кнопку
#После активации плагина в меню появится ссылка на страницу настроек плагина.Заполните все необходимые поля и нажмите кнопку “Сохранить изменения”.
#Откройте настройки WooCommerce и переключите на вкладку “Доставка”
#Выберите необходимую зону доставки, или создайте её.
#Нажмите на кнопку “Добавить метод доставки” и выберите из списка “КС2008”
#После создания заказа, в панели администратора, в форме изменения заказа, справа появится блок модуля "Отправить в курьерскую службу, снизу которого будет кнопка "Отправить заказ в КС2008", при нажатии на которую заказ будет отправлен в курьерскую службу.
====Обновление статусов====[[Файл:2023-04-03_11-52-20.png |700px]]Обновление статусов заказов происходит через технологию WP_Cron каждые 30 минут. <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/ и нажмите '''Подключиться'''. С вами свяжутся сотрудники и вышлют инструкцию для заключения договора и дальнейшей работы.
# После завершения регистрационных действий введите полученный публичный ключ и идентификатор в настройках личного кабинета курьерской службы. Подробнее см. [[Личный кабинет курьерской службы#Вкладка «Финансы»|настройки личного кабинета]].
== PimPay ==<br>Чтобы начать работать с [https://pimpay.ru/ Pimpay] необходимо сначала зарегистрироваться в их системе по адресу [http://platform.api.pimpay.ru/site/register http://platform.api.pimpay.ru/site/register]. Далее pimpay активирует Вашу учетную запись. [[Файл:pimpayconfig2023-04-03_12-03-35.png|thumb|200px|right|рис.1 Конфигурация PimPay700px]]
Чтобы продолжить, вам нужно сгенерировать ключи шифрования. Это делается на UNIX-подобной системе: [http:<br><br><br><//platformli><li>Внесите исправления в данные корреспонденции.apiСохраните ее.pimpay.ru</v2_7li><li>Для повторной отправки корреспонденции по интеграции (предварительно убедившись, что все ошибки исправлены) вновь назначьте для корреспонденции ответственный филиал интеграции </signature/openssl http://platformli><li>После повторного назначения в корреспонденции ответственного филиала интеграции ожидайте сообщения об отправке.apiПри повторной отправке этот процесс может занимать до 30 минут.pimpay.ru</v2_7li><li>При возникновении ошибки, если она очевидна, вновь исправьте ошибку в корреспонденции и повторите процесс повторной отправки (отмена, исправление ошибок, повторное назначение на ответственный филиал интеграции)</signatureli></openssl] или <spoiler text="наша инструкция"ul>Чтобы получить приватный ключЕсли при получении ошибки от подрядчика нет понимания ее причин, необходимо запустить командную строкупожалуйста напишите в нашу техподдержку.
В командной строке необходимо выполнить следующие команды: openssl genrsa -out private.pem 2048 openssl rsa -in private.pem -outform PEM -pubout -out public.pem==Сквозная интеграция==
После успешного выполнение команд Вы получить 2 файла: publicСквозная интеграция предполагает передачу тарифов подрядчика при создании заказа.pem и private.pemСодержимое файла public.pem - ваш публичный ключ, который необходимо целиком скопировать и вставить в ЛК PimPay.А содержимое файла private.pem необходимо скопировать и вставить в настройках интеграции с PimPay в нашем ЛК.</spoiler>[[Файл:pimpay client.png|thumb|200px|right|рис.2 Выбор платежного посредника]]Если у вас нет специалиста, чтобы сгенерировать ключи, обратитесь в PimPay, они с радостью сделают это за вас!
ДалееЧтобы настроить сквозную интеграцию между [[#Интеграция с CMS-системами |CMS- или CRM-системой]] и подрядчиком [[#Тарификация и выбор подрядчика и его тарифа клиентом|из таблицы]]:* Создайте свой Личный кабинет для экстраинтеграции.<br>Для этого, необходимо прописать настройки для pimpay достаточно единоразово войти в панели управления нашего ЛК (смэкстраинтеграции под своим логином и паролем https://home. рисcourierexe.1)ru/XXX, где XXX — экстра-код партнера. В ЛК PimPay нужно посмотреть код компании <br><i>Логин</i> и <i>пароль</i>, - это данные из 3-го и 4-го параметров (у них называется "Код платформы"см. таблицу ниже) [[#Тарификация и токен, ввести их в формувыбор подрядчика и его тарифа клиентом|Тарификация и выбор подрядчика и его тарифа клиентом]].* настройте [[Виды срочности|режим срочности]] для подрядчика.
Для каждого клиентасквозной тарификации заказов интернет-магазинов доступны следующие варианты:* курьерская служба, который хочет передавать данные в PimPay необходимо зарегистрировать в личном кабинете PimPayс которой сотрудничает интернет-магазин, и в нашей системе выбрать платежного посредника на вкладке "Финансы" карточки клиента. В процессе передачи данных привязка клиентов между системами производится по ИННнастраивает режим срочности для подрядчика. Наша система начинает передавать все Интернет-магазин оформляет заказы вашего клиента в PimPay, их статусы, и созданные [[Акты Передачи Денег и корреспонденции (АПД)Личный кабинет клиента|АПДличном кабинете клиента]]и выбирает указанный режим срочности;* интернет-магазины могут обратиться напрямую в MeaSoft для настройки сквозной тарификации. Обратно она ничего не получаетВ этом случае нужно предварительно заключить договор на оказание услуг с выбранным подрядчиком, и сквозная тарификация позволит получать его цены.
== Тарификация и выбор подрядчика и его тарифа клиентом ==Вы можете настроить подключение своего тарифа к тарифу партнера — любой компании, работающей в системе MeaSoft, а также ряду компаний, с которыми у нас есть интеграции. === Настройка интеграции ===Чтобы настроить подключение к тарифу партнера:# Зарегистрируйтесь в системе подрядчика. Данные аккаунта понадобятся для настройки интеграции.# Откройте '''Справочники''' > '''Статусы''' > '''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, на которой работают большинство компаний, предоставляющих подобные услуги. Обратитесь в службу технической поддержки для помощи него должна быть включена галка '''Водитель''' в настройкекарточке сотрудника.