Система "Курьерская служба 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-системами == '''Модули распространяются бесплатно, без гарантий со стороны разработчика''', и не являются средством полной автоматизации взаимодействия с курьерской службой. Модули — это помощь разработчикам интернет-магазинов в построении интеграции с курьерскими службами. '''Ответственность за корректность передачи данных лежит на интернет-магазине.''' Сообщайте нам свои пожелания по работе наших модулей. Мы учтем их в новых версиях. {| class="wikitable" align="center" style="width: 80%; margin: auto; background-color:#ffffff; border: 1px solid #999999;" cellpadding="10" cellspacing="0"!style="width: 35%;"|Система управления контентом (из предыдущего шагаCMS)!style="width: 15%;"|Ссылка!style="width: 35%;"|Примечание|-|[[Файл:bitrix.png|center|x44px]]|style="text-align: center;" | [https://marketplace.1c-bitrix.ru/solutions/measoft.courier/ Установить] <!--[https://courierexe.ru/download/api/measoft.courier.zip Скачать] -->|Поддерживает версии 14.5 и выше. [[1C-Битрикс|Инструкция по настройке]].|-|[[Файл:prestashop.png|center|x60px]]|style="text-align: center;"|[https://courierexe.ru/download/api/prestashop.zip Скачать]|Поддерживает версии 1.5.2.0 и выше.|-|[[Файл:OpencartOCStore.png|center|x60px]]|style="text-align: center;"|[https://courierexe.ru/download/api/opencart.zip Скачать для версии 1.5.5.1]<br>[https://courierexe.ru/download/api/measoft_oc2.ocmod.zip Скачать для версии 2.0]<br>[https://courierexe.ru/download/api/measoft_oc2.3.ocmod.zip Скачать для версии 2.3]<br>[https://courierexe.ru/download/api/measoft_oc3.ocmod.zip Скачать для версии 3.0]|Поддерживает версии с 1.5.5.1.<br>Скачивайте модули для своей версии OpenCart.<br>[[OpenCart|Инструкция по настройке]].<br>[https://opencartforum.com/files/file/2906-avtomatizaciya-otpravki-i-otslezhivanie-dostavok-courierexe-dlya-opencart-15x/ Альтернативный модуль сторонних разработчиков]|-|[[Файл:webasyst-shopscript.png|center|x44px]]|style="text-align: center;"|[https://www.webasyst.ru/store/plugin/shop/measoftcourier/ Установить модуль]<br>[https://www.webasyst.ru/store/plugin/shipping/measoftcourier/ Установить плагин]|Модуль предназначен для отправки заявок в КС, а так же свой идентификатор плагин для расчета стоимости доставки при оформлении заказа.|-<!--|[[Файл:advantshop.png|center|x44px]]|style="text-align: center;"|[https://promo-z.ru/ Сайт компании PROMO]|Компания PROMO разработала этот модуль и настраивает интеграцию MeaSoft с ADVANTSHOP своим клиентам.|- -->|[[Файл:insales.png|center|x80px]]|style="text-align: center;"|Настраивается в [[Личный кабинет клиента|ЛК пользователя]]|[[InSales|Инструкция по настройке]]|-|[[Файл:Leadvertex.png|center|x44px]]|style="text-align: center;"|[https://blog.leadvertex.ru/news/2110-integraciya-s-kurerkami-na-platforme-measoft Настраивается] в системе ЛК [https://Leadvertex.ru Leadvertex]|[[LeadVertex|Инструкция по настройке]]<br>Модуль разработан и поддерживается компанией LeadVertex.|-|[[Файл:Retailcrm.png|center|x30px]]|style="text-align: center;"|[https://www.retailcrm.ru/ RetailCRM]|[[RetailCRM|Инструкция по настройке]]|-|[[Файл:1C.jpg|center|x44px]]|style="text-align: center;"|-|[https://infostart.ru/public/692790/ Альтернативный модуль сторонних разработчиков]|-|[[Файл:Joomla2.jpg|center|x60px]]|style="text-align: center;"|[https://courierexe.ru/download/api/com_measoft.zip Скачать]|Работает только с компонентом Virtuemart.|-|[[Файл:Amocrm.png|center|x44px]]|style="text-align: center;"|[https://www.amocrm.ru/extensions/courier2008 Установить]|[[amoCRM|Инструкция по настройке]].|-|rowspan="2"|[[Файл:MoySclad.jpg|center|x30px]]|style="height:50px; text-align: center;"|[https://home.courierexe.ru/moysklad/step1 Настроить интеграцию с MeaSoft (см]|[[МойСклад|Инструкция по настройке]]|-|style="height:50px; text-align: center;"|[https://itmdev.ru/ms/shipping/ Скачать модуль сторонних разработчиков]|Интеграция МойСклад с курьерскими службами от сторонних разработчиков|-|[[Файл:wordpress.jpg|center|x80px]]|style="text-align: center;"|[https://courierexe. иллюстрацию)ru/download/api/wordpress. zip Скачать]|[[Wordpress|Инструкция по настройке]]|-|[[Файл:Measoft idCscart.png|thumbcenter|x60px]]|200pxstyle="text-align: center;"|right[https://marketplace.cs-cart.com/measoft-en.html Установить]|рисПоддерживает версии 4.10 и выше.1 Код экстра<br>[[CS-Cart|Инструкция по настройке]]|-|} === Замечания ===# В модулях систем PrestaShop и Joomla для отправки заказа в курьерскую службу зайдите в карточку заказа. В карточке отображается специальная форма отправки заказа, а если заказ отправлен, она позволяет проверить его статус:[[Файл:Form.png|400 px|Форма отправки заказа|none]]# Оформление заказов до '''ПВЗ''' в модулях '''PrestaShop''' и '''Joomla''' не реализовано. Чтобы оформить такой заказ, в поле передаваемого адреса укажите одно из значений:#* код ПВЗ, который можно посмотреть в ЛК клиентаили на сайте агента (Boxberry, CDEK и т. п.). Обычно это цифровой или цифро-буквенный код;#* наименование ПВЗ, добавив в начале строку "ПВЗ ", например '''ПВЗ На Ленина'''.# Поддерживается передача маркировки «[[Маркировка|Честный ЗНАК]]» из InSales и RetailCRM. Информацию по настройке см. в документации [https://www.insales.ru/collection/doc-zprochee/product/prodazha-tovarov-s-markirovkoy-487-fz Insales] и [https://help.retailcrm.ru/Users/MarkingOfGoods RetailCRM].# Для отображения списка пунктов выдачи есть [https://home.courierexe.ru/js/measoft_map.js JavaScript модуль]. Инструкция по использованию — внутри. Посмотреть пример работы можно [https://home.courierexe.ru/pvz_test.html здесь].# При проблемах с отображением карты в модулях очистите кэш браузера: например, для Google Chrome нажмите CTRL+F5. Введенные данные потеряны не будут, карта после этого отобразится корректно.<!--=== Беру ===При интеграции поддерживается:* Обработка координат.-->=== Проверка работоспособности интеграций ===При неполадках интеграции проверьте ее работоспособность. В общем случае для этого достаточно создать заказ и отправить его в курьерскую службу. Если заказ отправлен без ошибок и отображается в ЛК, значит, интеграция настроена. Если отправка не удалась, ошибка может быть в настройках интеграции или в заполнении формы отправки заказа. Текст ошибки можно увидеть через [[Личный кабинет#Отладка|отладку]] в личном кабинете. Чтобы найти свой заказ в запросах, нажмите клавиши CTRL + F и введите в строку поиска номер заказа или ориентируйтесь на время создания заказа. Убедитесь, что выполнены все шаги инструкции по настройки интеграции из этого раздела. Ниже представлено описание проверки работоспособности для разных интеграторов. '''RetailCRM''' # Убедитесь, что выполнены все шаги [[RetailCRM#Настройка интеграции|инструкции по настройке интеграции]].# Если используются триггеры, убедитесь, что они настроены согласно [[RetailCRM#Настройка триггеров|инструкции]].# Создайте заказ, заполните требуемые данные.# Нажмите на кнопку '''Сохранить''' внизу страницы, флажок '''Не отправлять данные в службу доставки''' должен быть снят. Заказ должен отправиться в курьерскую службу.# Если возникает ошибка, ее текст отображается наверху страницы.:: Если это ошибка заполнения формы, исправьте внесенные данные и попробуйте отправить заказ снова. Пример ошибки: «Ошибка сервиса доставки „Курьерская служба 2008“: field [receiver phone] has no valid phone number»:: Если это ошибка ответа курьерской службы, сообщите об этом разработчику. Пример ошибки: «Служба доставки прислала ответ в неверном формате».
4) '''КлиентМойСклад''' создает в своей системе филиал (Справочники – Межгород – Филиалы) для указанного агента. После ввода филиала нужно перевойти в программу и подождать 3 минуты.
5) # При сбое интеграции проверьте, не изменен ли аккаунт, под которым создана интеграция:## Логин учетных данных МойСклад, которые использовались при создании интеграции, вставьте в ссылку <nowiki>https://home.courierexe.ru/moysklad/step2?id=</nowiki>'''логин'''. Если при переходе по ссылке отображается этап настройки интеграции, значит аккаунт существует.## Войдите в «МойСклад» под учетной записью, которая использовалась для настройки интеграции, и откройте справочник '''Сотрудники''': меню пользователя > '''Настройки''' > '''Справочники''Клиент'> '''Сотрудники'''. Откройте карточку сотрудника, под учетной записью которого вы вошли, и убедитесь, получив данные что его роль — администратор.## Если хотя бы один из ппунктов не выполнен, значит, аккаунт, использованный для создания интеграции, изменен. 3# В личном кабинете клиента курьерской службы в настройках обратной интеграции '''Мой склад''' в поле '''В каком статусе «Мой склад» отправлять заказ на доставку''' уточните статус, заходит при котором заказ отправляется в свой личный курьерскую службу.# Заполните форму заказа, нажмите на кнопку '''Сохранить''', затем смените статус заказа на статус, установленный для отправки в системе MeaSoft (см. иллюстрацию). Переходит курьерскую службу и снова нажмите на закладку «Интеграция»кнопку '''Сохранить'''. В таблице должен появиться созданный филиалЕсли все верно, заказ будет отправлен в курьерскую службу. [[Файл# Обновите страницу в браузере и проверьте поле '''Строка для сохранения информации об ошибках''':Measoft home#* если поле пустое и заказ пришел в личный кабинет, интеграция работает;#* если поле пустое и заказ не пришел в личный кабинет, обратитесь к разработчику;#* если в поле содержится текст ошибки, исправьте ее в форме заказа и попробуйте отправить его снова.png|thumb|200px|right]]
6) '''КлиентInSales''' нажимает кнопку «Настроить» напротив филиала, в открывшемся окне выбирает интегратор «MeaSoft», далее – заполняет форму – «Логин», «Пароль», и «Код клиента» данными, полученными в п. 3, нажимает «Сохранить».
# В личном кабинете клиента курьерской службы в настройках обратной интеграции '''InSales''' проверьте данные в следующих полях:
#* '''Статус заказа для автоматической отправки в курьерскую службу''';
#* '''Список доставок для отправления заказа в курьерскую службу (если отправляется автоматически)''';
#* '''Оплачен ли заказ? (если отправляется автоматически)'''.
# Создайте заказ и в случае ошибки проверьте данные заказа на соответствие этим полям. Например, в заказе может быть установлен тип доставки, не отмеченный как используемый в настройках в личном кабинете.
В результате такой настройки, все отправления, у которых Клиент установит «Ответственный филиал», соответствующий Агенту (правильнее всего это делать оформив [[Манифесты|манифест]], скомплектовав его, и проставив дату отправки), будут переданы в БД Агента, и статусы будут передаваться обратноПри возникновении ошибок при отправке заказа появляется диалоговое окно с сообщением об ошибке. На передачу данных может уходить до 10 минут Исправьте ошибку в штатном режиме, форме заказа и до 1 часа в случае возможных сбоевпопробуйте отправить его снова.
Для стабильной работы необходимо наличие версии минимум 518 от 05.12.2014 у обеих компаний'''amoCRM'''
== Интеграция с подрядчиками (передача заказов) ===== Отказ от ответственности ===Хотим обратить Ваше внимание на то, что интеграции со сторонними системами делаются Ошибка при создании заказа отображается в соответствии с документацией на момент написания, без партнерства с компаниями-поставщиками сервиса. Об изменениях API нас не оповещают, поэтому интеграции, по независящим от нас причинам, могут переставать работать, работать нестабильно или некорректно, вплоть до потери важной (финансовой?) информации. Заказы, переданные во внешние системы нужно обязательно проверять на корректность пользуясь личным кабинетом партнералевом нижнем углу.
==Интеграция с подрядчиками = Общие правила настройки ==== Описание процесса интеграции ===Здесь рассматривается Рассматривается интеграция с системами сторонних компаний (Агентагентов), где система "Курьерская служба 2008" (Клиент) MeaSoft выступает клиентом, т.е. то есть передает заказы, и получает обратно статусы.
1) Клиент должен Компания-пользователь MeaSoft должна иметь аккаунт и личный кабинет в системе MeaSoft («Справочники» – «Дополнительные модули»), и должна быть установлена галка . Подробнее см. раздел [[Личный кабинет курьерской службы#Подключение|«Личный кабинет» в указанном окнекабинет курьерской службы»]].
2) # Создайте в своей системе [[Филиалы|филиал (Справочники – Межгород – Филиалы) ]] для указанного Агентаагента. После ввода филиала нужно перевойти в перезагрузить программу и подождать 3 минуты.# В личном кабинете курьерской службы на вкладке '''Интеграции''' в списке филиалов найдите созданный филиал и в его строке нажмите на кнопку '''Настроить'''.# В открывшемся окне в выпадающем списке выберите нужную интеграцию.# Заполните форму по отображенной инструкции, нажмите '''Сохранить'''.
3) Зайдите В результате настройки отправления, у которых клиент укажет филиал агента в свой личный качестве ответственного филиала, будут переданы в системе MeaSoft (см. иллюстрацию). Перейдите на закладку «Интеграция». В таблице должен появиться созданный филиалподрядчику и статусы будут передаваться обратно. Правильный способ отправки таких заказов — через [[Файл:Measoft home.png|thumb|200pxМанифесты|rightманифест]], который нужно скомплектовать и проставить дату отправки. На передачу данных может уходить до 10 минут в штатном режиме и до 1 часа в случае возможных сбоев.
4) Нажмите кнопку «Настроить» напротив филиала, в открывшемся окне выбирает интегратор той компании, с которой хотите интегрировать, далее – заполните форму по отображенной инструкции (для каждого интегратора форма и инструкции свои, нажмите «Сохранить»Для стабильной работы необходимо наличие у клиента системы MeaSoft версии минимум 518 от 05.12.2014.
==== Последовательность финальных статусов ====
В результате такой настройки, все отправления, у которых Клиент установит «Ответственный филиал», соответствующий Агенту (правильнее всего это делать оформив [[Манифесты|манифест]], скомплектовав егоПараметр <b>Исправлять ошибки последовательности статусов</b> регулирует возможность исправления ошибочно опубликованных подрядчиком финальных статусов.<br>Если в параметре интеграции указано "Исправлять", и проставив дату отправки)то при получении статуса <b>CANCELED</b>, будут переданы в БД Агента, и статусы будут передаваться обратно. На передачу данных может уходить до 10 минут в штатном режимевслед за финальным, и до 1 часа дата доставки заказа будет приводится в случае возможных сбоевсостояние соответствующее последнему полученному статусу.
Для стабильной работы необходимо наличие у Клиента системы "Курьерская служба 2008" версии минимум 518 от 05.12.2014.=== СДЭК===
Компания СДЭК прекращает поддержку API версии 1.5 с 01.01.2022. По информации от службы поддержки, интеграция не будет резко отключена, но поддержка будет осуществляться только для версии API СДЭК 2.0
=== Для перехода на новую версию создана интеграция СДЭК ===* СДЭК не позволяет передать количество занимаемых мест2.0.* Отправка в СДЭК осуществляется первым доступным тарифом из списка:# Экономичная посылка# Посылка# Экспресс лайт# Магистральный экспресс
В настройках интеграции КС может поменять местами тарифы Экономичная посылка и ПосылкаЧтобы настроить интеграцию с платформой СДЭК версии 2.0, заполните следующие поля:При весе отправления большем 30 кг отправление осуществляется тарифом Магистральный экспресс* '''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>* [http* "Передавать, по местам, если указана"<br><span style="padding-left://courierexe5px;">Оценочная стоимость заказа распределяется по вложениям.ru/download/userfunc/SDEK_report_load.xml Загрузка отчета СДЭК] Создает входящий АПД Вложения в свою очередь распределяются по отчету СДЭК [http://courierexeместам.ru</download/userfunc/SDEK_report_demospan>* '''Добавлять услугу «Осмотр вложений»'''.xls такого формата]Тарифицируемая услуга от СДЭК, поэтому она добавится, только если в настройках указано '''Да''';* '''Процент за наложенный платеж'''. Работает начиная с версии 626 от 29Используется при получении агентской цены.01Калькулятор API CDEK не включает в расчет сумму за наложенный платеж автоматически, но мы добавим указанный вами процент в итоговую сумму;* '''Использовать как номер'''.2016 Номер заказа отображается в личном кабинете и только при передаче заказов в отчетах СДЭК с помощью штатной интеграции. Заполняет поле Выберите удобный вариант: '''Шифр''' или '''Штрихкод''';* '''"Агентская цена"Код курьера'''. Укажите код курьера, который будет указан в карточке кор-ии, на вкладке поле '''Вручил курьер''' для доставленных заказов.* '''"Межгород"Способ доставки до ПВЗ отправления'''** "Самопривоз в офис СДЭК" - установлено по умолчанию, необходимо заполнить <b>Код пункта приема</b>** "Забор со склада" - в заказе указывается адрес склада с которого курьеры СДЭК забирают отправления. Адрес указывается в карточке ответственного филиала для которого настраивается интеграция со СДЭК вер.2.0** "Забор у отправителя" - в заказе указывается адрес отправителя с которого курьеры СДЭК забирают заказы.*** <i>Адрес из карточки клиента владельца фирмы отправителя</i> - если в ответственном филиале интеграции настроено "Скрывать отправителя"*** <i>Адрес отправителя из карточки заказа</i> - если он не пустой*** <i>Адрес из карточки отдела</i> - если пустой адрес отправителя в заказе*** <i>Адрес из карточки клиента отправившего заказ</i> - если пустой адрес отдела
=== Топ деливери ===
[[Файлы для загрузки#.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]]
<div style="color: #a94442; background-color: #f2dede; border: 1px solid #ebccd1; padding: 3px 10px 10px;">
* Интеграция СДЭК версии 2.0 не предусматривает автоматическую отправку заказа после получения ошибки. Чтобы отправить заказ повторно после исправления, обратитесь в техподдержку MeaSoft.
* Интеграция не предусматривает проверку номеров телефонов передаваемых заказов на соответствие стране. api СДЭК проверяет номера телефонов на соответствие списку стран после отправки заказа. Список стран номера телефонов которых принимаются без ограничений опубликованы в [https://api-docs.cdek.ru/29923926.html документации СДЭК]
</div>
=== Почта России ===При выборе тарифа для отправки заказа приоритет отдается тарифам режима срочности, выбранного в заказе. Если в режиме срочности не настроены тарифы, то тариф выбирается из списка в параметре интеграции '''Приоритет тарифов'''. В этом случае отправка в СДЭК осуществляется первым доступным тарифом из списка. Доступные для выбора списки тарифов по умолчанию:Интеграция с Почтой России описана в разделе [[%D0%A0%D0%B0%D0%B1%D0%BE%D1%82%D0%B0_%D1%81_%D0%9F%D0%BE%D1%87%D1%82%D0%BE%D0%B9_%D0%A0%D0%BE%D1%81%D1%81%D0%B8%D0%B8|Работа с Почтой России]]* «Экономичная посылка»,* «Посылочка»,* «Экспресс-лайт»,* «Магистральный экспресс».
Также возможно выбрать второй вариант, который поменяет местами тарифы «Экономичная посылка» и «Посылочка».
* «Посылочка»,
* «Экономичная посылка»,
* «Экспресс-лайт»,
* «Магистральный экспресс».
=== PickPoint ===При весе отправления больше 30 кг применяется тариф «Магистральный экспресс».
Если '''PickPoint''' выделил вам диапазон трекинг-номеровЧтобы передать услугу «Примерка», то необходимо настроить филиал и придерживаться последовательности отправки манифестов.Для настройки филиала для интеграции '''PickPoint''' с диапазоном в основном меню выберите '''Справочники -> Межгород -> Филиалы''' нажатием правой кнопки мыши на предварительно созданном филиале, в контекстном меню выберите '''Открытьустановите флажок ''' в открывшейся форме перейдите Принято на вкладку склад'''Интеграция''' и в выпадающем списке '''Правила назначения кода заказа у подрядчика''' выберите '''Из диапазона'''[[Единица корреспонденции#Создание единицы корреспонденции|карточке корреспонденции]]. Укажите начальный и конечные коды диапазонаЕсли услуга не нужна, префикс при необходимости и нажмите клавишу '''ОК'''снимите флажок.
Для отправки манифестов добавьте заказы в манифест, затем, на вкладке При передаче валюты наложенного платежа код валюты берется из поля '''МанифестыВалюта''' необходимо добавить требуемые заказы карточки клиента, от которого передается заказ. Валюта должна совпадать с валютой страны назначения заказа. Если заказ отправляется в мешокдругую страну, а далее выбрать в манифесте ранее настроенный филиал. После чегосоздайте копию клиента с нужной валютой и оформляйте заказы от него, указывая цены в контекстном меню манифеста выбрать пункт '''Проставить коды у подрядчика'''.После этого можно указать дату отправки манифеставалюте страны назначения.
Обратите внимание, что проставить коды с указанной датой отправки манифеста нельзя. Необходимо сначала очистить дату В общем случае интеграция не поддерживает отправкив другие страны, а затем проставить кодыкроме России.
[http://courierexe.ru/download/userfunc/SDEK_report_load.xml Загрузка отчета СДЭК] создает входящий АПД по отчету СДЭК [http://courierexe.ru/download/userfunc/SDEK_report_demo.xls такого формата]. Работает при передаче заказов в СДЭК с помощью штатной интеграции. Заполняет поле '''Агентская цена данной интеграцией не возвращается, т.к. эти данные отсутствуют ''' в API PickPointкарточке корреспонденции на вкладке '''Межгород'''.
=== КСЭ 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>Вы можете настроить подключение своего тарифа к тарифу партнера. Для этого откройте '''Справочники''' -<ol> '''Статусы''', выберите '''17 Виды срочности'''. Создайте вид срочности, например <span style="СДЭК". Нажмите правой кнопкой на него color: blue; margin- '''Дополнительная информация...''', и во '''второй''' строке заполните параметры подключения к партнеру через запятуюright:10px;">○</span>Отсутствует</ol>* 1<ol><span style="color: blue; margin-й Параметр - код филиала партнера. Смотреть в Справочники - Межгород - Филиалыright: 10px;">○</span>С примеркой</ol>* 2<ol><span style="color: blue; margin-й Параметр - код экстра партнера в системе MeaSoft. В том числе для сторонних компаний есть коды, см. таблицу ниже.right: 10px;">○</span>Простая</ol>* 3<ol><span style="color: blue; margin-й Параметр - имя пользователя в системе партнера. Может отличаться от того, под которым работает интеграция, здесь нужно для расчета цены для клиента. В таблице ниже указано, что вводить для каждого интегратора.right: 10px;">○</span>С проверкой работоспособности</ol>* 4-й Параметр - пароль к пользователю из 3-го параметра. В таблице ниже указано, что вводить для каждого интегратора.* 5-й Параметр - вид срочности партнера. Посмотреть доступные коды видов срочности можно по ссылке в таблице ниже, в калькуляторе в выпадающем списке. Можно в одинарных кавычках указать несколько видов срочности через запятую, тогда система будет стараться выбрать из них первый доступный.* 6-й Параметр - наценка к цене, передаваемой подрядчиком. В деньгах или в процентах, если стоит знак процента. Например 10 - наценка 10 рублей, 10% - наценка 10 процентов</ul>
{|class="wikitable"!Интеграция!Код экстра!Посмотреть виды срочности!Авторизация!Пример строки|-|БОКСБЕРРИ||90001||https://home.courierexe.ru/90001/calculator||Введите токен в 4-й параметр. 3-й можно оставить пустым. Можно оба оставить пустыми для расчета базовых цен.||33, 90001,, j3ejwo2f10b2e47790174b41f4a11111, 2, 50|-|ПИКПОИНТ||90002||https://home.courierexe.ru/90002/calculator|-|CDEK||90005||https://home.courierexe.ru/90005/calculator||Введите код учетной записи в 3-й параметр, и секретный код - в 4-й. Можно оба оставить пустыми для расчета базовых цен.||45491, 90005, hfenJwlasiPr4pnFENpaVXSKPIn5Trh7i, 9vkQgWuiZgEj9fGCB8a6Xj3desnJkwsl, 5, 30%|-|КСЭ||90008||https://home.courierexe.ru/90008/calculator|-|ПОЧТА РОССИИ||90010||https://home.courierexe.ru/90010/calculator||<!--Введите "логин отправки" в 3-й параметр, а в 4-й в одинарных кавычках через запятую пароль отправки и токен. Пустыми оставлять нельзя, т.к. интеграция с Почтой пока не позволяет рассчитывать цены без договора (авторизации).-->Пока не поддерживается||<!--10497, 90010, 89251234567, 'mypassword,u23B0r9AAJ1Fyh4ptMzJ3kjxcslamwdx', '2, 1', 10-->|-|ДПД||90011||https://home.courierexe.ru/90011/calculator|-|ДОСТАВКА ГУРУ||90017||https://home.courierexe.ru/90017/calculator|-|5Пост||90020||https://home.courierexe.ru/90020/calculator||3-й параметр - API-ключ, 4-й - Уникальный номер партнера в системе 5post. При необходимости в 4-й параметр можно через запятую указать пороговое значение веса (по-умолчанию 3 кг). Пустыми оставить нельзя.||10497, 90020, u23B0r9AAJ1Fyh4ptMzJ3kjxcslamwdx, '8001, 3', '1', 100|}== TopDelivery ===
При выборе клиентом Для настройки интеграции с платформой TopDelivery укажите:* '''Логин'''* '''Пароль'''* '''Информация о поставщике товара'''. Если указано '''Отправлять''', то при отправке заказа будет предпринята попытка отправить место с габаритами и товарами с указанием данных поставщика: ИНН, наименование, номер телефона. Если данных поставщика нет, информация об ошибке отправки мест будет добавлена в личном кабинете вида срочности, подключенного таким образом сообщение к партнеру, заказу. Информация о поставщике повторно не отправляется.* '''набор доступных ПВЗВскрытие отправления до получения оплаты''' будет ограничен выбранным партнером- по умолчанию разрешено.<br>Возможность запрета вскрытия отправления добавляется при отправке заказа, если в настройках интеграции разрешен запрет и в заказе стоит отметка "Принято на склад"
'''При отправке''' заказа по интеграции с подключенным видом срочности, интеграция постарается отправить заказ '''одним из режимов''', введенных в п[[Файлы для загрузки#.6 (по порядку, в порядке приоритетов), а если не получится - вернет '''ошибку'''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 %D1%81 %D0%9F%D0%BE%D1%87%D1%82%D0%BE%D0%B9 %D0%A0%D0%BE%D1%81%D1%81%D0%B8%D0%B8|Работа с Почтой России]].
=== Замечания PickPoint ===Если PickPoint выделил вам диапазон трекинг-номеров, то необходимо настроить филиал и придерживаться последовательности отправки [[Манифесты#Отправка|манифестов]].
Чтобы настроить филиал для интеграции PickPoint с диапазоном, в основном меню выберите '''Справочники''' > '''Межгород''' > '''Филиалы''', откройте карточку [[Файл:Form.png|100 px|миниФилиалы|Форма отправки заказафилиала]]и на вкладке '''Интеграция''' в выпадающем списке '''Правила назначения кода заказа у подрядчика''' выберите '''Из диапазона'''. Укажите начальный и конечные коды диапазона, префикс при необходимости и нажмите клавишу '''ОК'''.
# В модулях систем '''PrestaShop''', '''OpenCart''', '''OCStore''', '''Webasyst''', '''InSales''' и '''Joomla''' для Для отправки заказа манифестов добавьте заказы в курьерскую службу необходимо зайти в карточку заказаманифест, в которой должна отображаться форма (см. изображение). Форма позволяет отправить заказ, а если заказ отправлен - проверить его статус.# Оформление заказов до затем на вкладке '''ПВЗМанифесты''' отсканируйте заказы в модулях не реализованомешок и выберите в карточке манифеста ранее настроенный филиал. Однако, для того, чтобы оформить такой заказ, необходимо в поле '''передаваемого адреса''' указать:#* либо код ПВЗ, который можно посмотреть После этого в нашем ЛК или на сайте агента (''Boxberryконтекстном меню манифеста выберите '', 'Проставить коды у подрядчика'CDEK'' и т.д.). Обычно это цифровой (цифро-буквенный) код#* либо указать наименование ПВЗ добавив в начале строку "ПВЗ ", например, '''ПВЗ На Ленина'''
После этого можно указать дату отправки манифеста.
=== OpenCart 1Обратите внимание, что проставить коды с указанной датой отправки манифеста нельзя.5Необходимо сначала очистить дату отправки, а затем проставить коды.5.1 ===[[Файл:OpenCart.png|600px|right|мини|Шаг 5 Настройки интеграции]]
Важно! Перед любыми изменениями настроек рекомендуется сделать резервную копию сайта.Для настройки синхронизации:# Загрузите содержимое папки upload из архива в папку сайта по FTP. При необходимости подтвердите замену файлов.# Зайдите в панель администратора OpenСart. Подробнее см. в [https://docs.ocstore.com/index.php?title=Панель_Администратора документации OpenCart].# В меню панели управления выберите '''Дополнения''', раздел '''Модули'''. В открывшемся списке найдите '''КС2008''' и нажмите на кнопку '''Установить'''.# В меню панели управления выберите '''Дополнения''', раздел '''Доставка'''. В открывшемся списке найдите '''Основные настройки интеграции КС2008''' и нажмите на кнопку '''Установить'''. Рядом появится кнопка '''Изменить'''.# Нажмите на кнопку '''Изменить'''. Откроется страница «Основные настройки интеграции КС2008»:<br>Заполните обязательные поля:#* '''Логин''' — логин пользователя, выдается курьерской службой.#* '''Пароль''' — пароль пользователя, выдается курьерской службой.#* '''Код курьерской службы''' — выдается курьерской службой.#* '''Город отправителя'''. После ввода убедитесь, что в названии населенного пункта нет ошибок.<br>При необходимости заполните остальные поля. Нажмите на кнопку '''Сохранить'''.# В меню панели управления выберите '''Дополнения'''Агентская цена интеграцией не возвращается, раздел '''Доставка'''. В открывшемся списке найдите '''Настройки доставки курьером КС2008''' и нажмите на кнопку '''Установить'''. Рядом появится кнопка '''Изменить'''.# Нажмите на кнопку '''Изменить''' и так как эти данные отсутствуют в поле '''Тариф для расчета стоимости доставки''' выберите нужный тариф. По умолчанию используется первое значение выпадающего спискаAPI PickPoint.
=== OpenCart 2.0 и выше КСЭ ===Для обращения к функциям системы необходимо знать своё имя пользователя и пароль в системе КСЭ.<br> Если у вас еще нет доступа, то необходимо обратится к Вашему менеджеру в подразделение клиентского сервиса КСЭ.<br>
Для настройки синхронизации:# Скачайте [[API#Готовые интеграции|установочный файл]] для нужной версии OpenCart.# Зайдите в панель администратора OpenСart. Подробнее см. в [https://docs.ocstore.com/index.php?title=Панель_Администратора документации OpenCart].# В панели управления OpenCart выберите '''Установка дополнений''' ('''Установка расширений''') и на странице «Установщик дополнений OCMOD» нажмите на кнопку '''Загрузить'''.# В открывшемся диалоговом окне выберите загруженный файл в формате ZIP и нажмите на кнопку '''Продолжить'''.<brb>Когда загрузка будет окончена, индикатор загрузки в поле '''Выполнение''' станет зеленым.<br>'''Примечание'''. Убедитесь, что название файла оканчивается на «ocmod.zip». Названия вида «ocmod(2).zip» и подобные приведут к ошибкам загрузки файла.# (Для версии Opencart ниже 3.0) В панели управления выберите '''Менеджер дополнений''' ('''Менеджер расширений''') и в правом верхнем углу страницы нажмите на кнопку '''Обновить'''.# Для OpenCart 2.0 и вышеНастройки интеграции: в панели управления выберите '''Дополнения''' ('''Расширения'''), раздел '''Доставка'''.<br/b>Для OpenCart 3.0 и выше: в меню панели управления в разделе '''Расширения''' выберите '''Расширения''' и на странице '''Список расширений''' в выпадающем списке выберите '''Доставка'''.<br>В открывшемся списке найдите '''Основные настройки интеграции КС2008''' и нажмите на кнопку '''Установить'''. Рядом станет активна кнопка '''Редактировать'''.# Нажмите на кнопку '''Редактировать'''. Откроется страница «Основные настройки интеграции КС2008».# Заполните обязательные поля:#* '''Логин''' — - логин пользователя, выдается курьерской службой.от ЛК КСЭ#* '''Пароль''' — - пароль пользователя, выдается курьерской службой.от ЛК КСЭ#* '''Код курьерской службыДанные отправителя''' — выдается курьерской службой.#* '''Наценка на доставку (множитель)''' — множитель наценки на стоимости доставки — данные, которые будут подставляться во все отправления, передаваемые в КСЭ. Если наценки нетне указать, установите 0.#* '''Наценка на доставку то будут передаваться данные заказчика (добавочнаяотправителя)''' — конкретная величина наценки на стоимость доставки. Если наценки нет, установите 0из корреспонденции.#* '''Ваш городЯвляется ИМ''' — город — признак отправителяв системе КСЭ. После ввода убедитесьОт данного признака зависит главным образом, что как отправляются данные в названии населенного пункта нет ошибокКСЭ.<br>При необходимости заполните остальные поляПризнак указывается в договоре клиента с КСЭ. Нажмите на кнопку * '''СохранитьЗабор''' — настройка, в правом верхнем углукоторой можно указать, каким образом отправление передается в КСЭ — КСЭ забирает отправление у клиента или клиент сам привозит отправление в КСЭ.# В разделе ** '''ДоставкаПо умолчанию''' найдите '''Настройки — груз будет принят для доставки курьером КС2008''' и нажмите на кнопку '''Установить'''в офисе (самопривоз в КСЭ) для всех заказов с товарной составляющей, иначе будет послан курьер для забора. Рядом станет активна кнопка ** '''РедактироватьДо двери'''. — будет послан курьер для забора# Нажмите на кнопку ** '''Редактировать''' и Самопривоз в поле КСЭ'''Тариф — груз будет принят для расчета стоимости доставки''' выберите нужный тариф. По умолчанию используется первое значение выпадающего списка.в офисе
=== Bitrix ==={|align="right" |-valign="top" |[[Файл:Bitrix1При выборе тарифа для отправки заказа приоритет отдается тарифам режима срочности, выбранного в заказе.png|250 px|мини|рис.1 Настройки интеграции]] |[[Файл:Bitrix2.png|250 px|мини|рис.2 Форма оформления заказа]] |}
Обратите внимание, что по умолчанию в форме оформления заказа должны появиться поля указания даты и времени желаемой доставки.<!--Если они отсутствуют, то у формы были изменены стили. Также возможно обновление формы в системе Bitrix=== DOSTAVKA.GURU ===
# Установить модуль из Маркетплейс.# В административной части сайта зайти в раздел '''Marketplace → Установленные решения''' и установить модуль '''Курьерская служба''', нажав на пункт '''"Установить"Настройка'''.Для интеграции введите следующие учетные данные:# В административной части сайта зайти в раздел * '''Магазин → Настройки → Службы доставки''' и добавить службу доставки, выбрав пункт '''"Автоматизированная служба доставки"Идентификатор клиента'''— ID клиента DOSTAVKA.GURU. ID клиента отображается вверху страницы личного кабинета клиента DOSTAVKA.GURU;# На вкладке '''"Настройки обработчика"* ''' в выпадающем списке выбрать Ключ клиента'''"Курьерская служба" — запросите API- сервис доставки'''ключ интеграции у DOSTAVKA.GURU.# На вкладке * '''"Настройки интеграции"Регион откуда повезется заказ''' (Рис. 1) необходимо- Доступен выбор из трех вариантов:#* ввести учетные данные курьерской службы<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>['~', '`', '@', '#', '$', '%', '^', '&', '=', '+', '!', '"', '№', ';', ':', '?', '\']</code>
Полный список недопустимых символов:<code>['~', '`', '@', '#', '$', '%', '^', '&', '=', '+', 'Обратите внимание!', '"', что проверить работу модуля можно в форме оформления доставки. При этом'№', должна корректно считаться стоимость доставки.Если стоимость не рассчитывается';', причин может быть несколько':', '?', '\', '\s', '* некорректно установлен модуль* введены некорректные учетные данные* в курьерской службе не настроен тарифВ случае некорректного тарифа необходимо обратиться в курьерскую службу для настройки тарифа', '(', '_', '{', '}', '. После настройки в КС тарифы можно проверить в ЛК', ', на вкладке ', '\['Калькулятор, '\]', '.\']</code>
=== 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 Настройка подключения]] |}
'''Статусы'''. Запрашиваются интеграцией в автоматическом режиме. Изменение статуса на стороне Guru изменит и статус заказа в соответствии с картой статусов.
# Установить приложение можно [http://www.insales.ru/collection/all/product/kurierskaya-sluzhba-2008 по ссылке] - зеленая кнопка '''"Установить"Агентская цена''' (Рис. 1).# В Личном кабинете появится уведомление для установки приложения '''«Модуль "Курьерская служба 2008"»''' (кнопка '''"Установить"''')Обновляется при получении статусов. После этого подтвердить установку (Рис. 2).# Настройка приложения. Необходимо зайти в приложения и нажать на название '''«Курьерская служба 2008»''' (Рис. 3). Произойдет переход на страницу Личного Кабинета (home.courierexe.ru) с возможностью ввода параметров.# Параметры '''Код курьерской службы''', '''Логин''' и '''Пароль''' необходимо запросить у курьерской службы, с которой настраивается интеграция, ввести их Агентская цена Guru публикуется в поля разрезе стоимости услуг и сохранить (Рис. 4).# Далее необходимо ввести статустарифов, при присваивании которого которые суммируются перед обновлением агентской цены в Insales, будет происходить автоматическая передача данных в программу и префикс к заказам.# После установки приложения '''«Модуль "Курьерская служба 2008"»''' - он появится в ЛК (home.courierexe.ru) в списке установленных в разделе '''"Приложения"'''заказе.
'''Возвраты'''. Учитываются только при получении заказом статуса '''Частичная доставка'''.
-->
=== 5POST ===
Параметры для настройки:
* '''API-ключ'''
* '''Код склада отправителя'''
* '''Уникальный номер партнера в системе 5Post'''
* '''Максимальный вес для фиксированного тарифа''' - При привышении установленного веса, сумма тарифа изменяется пропорционально. По умолчанию 3кг.
* '''Код подрядчика в карточке заказа''' - доступно три вида отображения кода подрядчика:
<ul>
<ol><span style="color: blue; margin-right: 10px;">○</span> Оригинальный код 5post - Установлено по умолчанию</ol>
<ol><span style="color: blue; margin-right: 10px;">○</span> Код для поиска заказа в ЛК 5post</ol>
<ol><span style="color: blue; margin-right: 10px;">○</span> Код грузоместа</ol>
</ul>
* '''Габариты мест'''
<ul>
<ol><span style="color: blue; margin-right: 10px;">○</span> Группировать - Установлено по умолчанию<br>
При установке этого значения, всегда передается только одно место с обобщенными габаритами и кодом соответствующим коду заказа.
</ol>
<ol><span style="color: blue; margin-right: 10px;">○</span> Отправлять указанные<br>
При установке этого значения, каждое место отправляется отдельно, с соответствующими ему габаритами и кодом.
</ol>
</ul>
* '''ЗамечанияТип расчета тарифа'''<ul><ol><span style="color: blue; margin-right: 10px;">○</span> Общий - Установлено по умолчанию</ol><ol><span style="color: blue; margin-right: 10px;">○</span> По местам</ol></ul>
* Тип оплаты заказа определяется следующим образом:** Если заказ оплачен, то передается тип оплаты ''Без оплаты''** Если тип оплаты '''Оплата банковской картой''' или '''Оплата банковской картой курьеру''', то передается тип оплаты ''Банковская карта''. Указанные типы оплаты необходимо создать в InSales вручную.** Иначе передается тип оплаты ''Наличными''** На стороне курьерской службы в карточке интернет-магазина есть галка "Спрашивать тип оплаты у получателя". Если она установлена, то независимо от переданного типа оплаты ''Наличными'' или ''Банковская карта'', покупателю будет предложен выбор способа оплаты=== Яндекс.Доставка ===
Для подключения к интеграции в вашем договоре с Яндекс.Доставкой должна быть подключена услуга доставки на следующий день. Если у вас эта услуга не подключена, заполните [https://forms.yandex.ru/surveys/10833592.0f3ead3120074ee64cd9dde1df70b27d8d2678d2/ эту форму].
Для настройки интеграции с платформой Яндекс.Доставка укажите следующие параметры:
*'''Токен''', можно посмотреть тут https://dostavka.yandex.ru/account/integration
*'''ID пункта отправления''', необходимо уточнить у вашего менеджера или в поддержке яндекса
'''Настройки''' интеграции можно изменить Эти параметры обязательные и влияют на отправку заказа. Доступы должны быть НЕ тестовые (продовые). Уточните эти данные у вашего менеджера или в разделе '''Автоматизация''' личного кабинетаподдержке Яндекс.Доставки.
=== 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 Настройка способов оплаты]] |}
'''Пароль''' - Код пункта отправления. Имеет вот такой формат 4eccdad3-8d97-4fbf-b241-3c2a89a8aa79
# Необходимо создать API-ключ (Настройки, пункт Интеграции, раздел Ключи доступа к API) для доступа модуля к интеграции# В настройках API-ключа необходимо разрешить все методы (проставить все галочки). Для этого нужно перейти '''Настройки → Интеграция → Маркетплейс''' и верхней части окна выбрать раздел настроек '''Ключи доступа к API'''. <br>API-ключей может быть несколько и в настройках каждого API-ключа необходимо:#:1) выбрать '''"Доступ ко всем магазинам"''' в разделе '''"Тип доступа"'''.#:2) проставить '''ВСЕ''' галки в разделе '''"Разрешенные методы API"''', дав тем самым доступ на все методы.# В разделе Маркетплейс (Настройки, пункт Интеграции) необходимо выбрать модуль "Курьерская служба 2008"# При нажатии на модуль открывается описание модуля интеграции# При нажатии на кнопку '''Подключить''' открываются настройки интеграции в ЛК "Курьерская служба 2008"# Параметры '''Код курьерской службы''', '''Логин''' и '''Пароль''' необходимо запросить у курьерской службы, с которой настраивается интеграция# В поле '''Аккаунт RetailCRM''' необходимо указать адрес системы, а в поле '''API-ключ''' - ранее созданный API-ключ для модуля# В системе RetailCRM добавить новый тип доставки в системе через '''Настройки → Справочники → Типы заказов''' и в верхней части окна выбрать раздел настроек '''Типы доставок'''. Кнопкой Добавить произвести добавление нового типа доставки. Обязательно выбрать интегратора в выпадающем списке '''"Интегрировать с Курьерская служба 2008"''' (рис. 1).# При создании заказа появится соответствующий '''Способ доставки''' (рис. 2).# Далее, необходимо выбрать '''Тариф'''. Он должен подтягиваться из КС. Если при этом происходит '''Ошибка определения тарифа''', значит тарифы в КС не настроены (рис. 3). В случае ошибки необходимо обратиться в курьерскую службу для настройки тарифов. Проверить тарифы можно в ЛК в разделе ''Калькулятор''.# Для корректной передачи наложенного платежа необходимо добавить '''Способ оплаты''' (рис. 4), который имеет признак '''Наложенного платежа''' в настройках интеграции (рис. 5).# Для получения печатных форм, аналогичных формам в ЛК Курьерская служба, необходимо:#* в заказе нажать Печать (вверху) и выбрать нужную печатную форму "Курьерская служба"#* в списке заказов выбрать заказы, нажать Действия (внизу), Распечатать документы и выбрать нужную печатную форму "Курьерская служба"# Если Вы хотите отправлять заказы в курьерскую службу по статусам и отменять при изменении типа доставки можете воспользоваться тригерами90023. Как их настраивать описано в отдельной статье [[Настройка триггеров для RetailCRM]]
'''Настройки''' интеграции можно изменить в разделе '''Автоматизация''' личного кабинета.
===Беру===При интеграции поддерживается:* Обработка координатсоздании заказа обратите внимание на адрес — он должен быть понятным. Наиболее понятным для Яндекса будет адрес, где нет дополнительных комментариев, а части адреса разделены запятыми.
==== Подключение к двум и более курьерским службам или клиентам ====В интеграцию не принимаются заказы на юридические лица. Т.е. в поле ФИО должно быть именно ФИО, а не название организации.
1Отправка заказов происходит автоматически. В ЛК ''новой'' курьерской службы зайти по ссылке /retailЕсли адрес не распознан и заказ не отправлен с первой попытки, интеграция попытается разобрать адрес доступными ей средствами и снова отправить заказ. Если заказ так и не получилось отправить, проверьте адрес получателя, возможно, чтобы в адресной строке было указано так:нем допущена ошибка. После исправления адреса заказ отправится автоматически.
<source lang=php>https://homeПри отправке заказа обязательно указываются места с габаритами и массой.courierexeЕсли в заказе указаны места, они добавляются как есть. Если мест в заказе нет, то создается одно фиктивное место, габариты которого формируются на основе габаритов вложений. Вложения не разделяются по местам и попадают в первое сформированное место.ru/XXX/retail</source>
Обратите внимание, что вместо "XXX" у вас должен быть указан экстра код ''После настройки модуля или создания новой'' курьерской службыинтеграции ПВЗ появляются на следующий день.
2=== Л-Пост ===Для настройки интеграции с платформой Л-Пост укажите следующие параметры:*'''Секретный ключ клиента''',*'''Код пункта приема''' - Не обязательный параметр. Заполнять параметр не нужно, если отправления сдаются на центральный склад Л-Пост (Родники, ул. ДалееТрудовая, последовательность подключения аналогична общей последовательностид.10) или забираются со склада партнера силами Л-Пост .<br> В других случаях, начиная с пункта 6в качестве точки приема отправлений могут выступать пункты выдачи заказов Л-Пост и склады Л-Пост.
'''Основные принципы работы'''При отправке заказа обязательно указываются места с габаритами и массой. Если в заказе указаны места, они добавляются как есть. Если мест в заказе нет, то создается одно фиктивное место. Вложения не разделяются по местам и попадают в первое сформированное место.
* Использование артикулов для привязки к складу системы КС2008 включается в настройках интеграции в ЛК.
* Заказ передается в систему КС2008 при его '''''сохранении''''', если не включена галка "''Не отправлять данные в службу доставки''".
* Тип оплаты указывается в разделе заказа '''Оплата'''. Для передачи типа оплаты необходимо добавить один из способов оплаты ('''Наличные''' или '''Банковская карта''').
* В случае, если заказ был оплачен, тип оплаты можно не указывать.
* Количество мест определяется ''упаковками'', которые можно добавить в разделе заказа '''Доставка'''.
* Стоимость доставки возвращается в поле '''Себестоимость'''.
* Для изменения статусов товаров необходимо настройках интеграции в ЛК включить настройку '''Получать возвраты вложений'''. В этом случае проданный товар получает статус '''Продан''', для него указывается количество проданного товара. Также создается фиктивный товар с таким же наименованием со статусом '''Возврат''', в комментарии которого указывается количество возвращенного.
* Код подрядчика (если заказ передается по интеграции) возвращается в поле '''Комментарий менеджера'''.
* Курьера и его телефон можно получать в пользовательское поле RetailCRM, указанное в настройке '''Пользовательское поле для получения курьера'''.
* Возврат в RetailCRM типа оплаты включается настройкой '''Получать тип оплаты'''. При этом указывается либо стандартный тип оплаты '''Наличными''', либо стандартный тип '''Банковская карта'''.
Обратите внимание, что в зависимости от настроек вашего аккаунта в Л-Пост может быть недоступна частичная оплата заказа.
'''Примечания'''=== Omnic ===Для настройки интеграции с платформой Omnic укажите следующие параметры:
*Файлы '''Логин''' - создается самостоятельно, служит для доступа к заказам в системе RetailCRM прикрепить можно[https://home. Ограничение 1 МБ на 1 файлcourierexe.ru/90025 ЛК экстраинтегратора], может быть любым, главное запомните его.
* '''Пароль''' является составным и обязательно должен содержать токен (получается в службе поддержки омника).
<div style="color: #a94442; background-color: #f2dede; border: 1px solid #ebccd1; padding: 3px 10px 10px;">'''ВНИМАНИЕ!'''<br /> После добавления нового типа доставки, удаление типа доставки в системе RetailCRM будет уже не доступно, новый тип можно только отключить галкой '''"Активность"''' внутри настроек выбранного типа доставки.</div>Так же может содержать
===Мой Склад===Интеграция предназначена для передачи заказов с товарными вложимыми из системы "Мой склад" в систему "Курьерская служба 2008". В обратную сторону будут приходить статусы'''ПВЗ отправления''' - код ПВЗ подрядчика, стоимость доставки и общая сумма заказа с учетом частичной доставкипункт самопривоза. <i>Не обязательный параметр</i>
'''Как настроитьПриоритет тарифов'''- последовательность тарифов подрядчика, разделенная пробелами, указывающая доступность и приоритет тарифов в общем случае. <i>Не обязательный параметр</i>
# Пройти по ссылке https://home.courierexe.ru/moysklad/step1. Ввести логин и пароль от "Моего склада", а также логин, пароль и код экстраклиента от курьерской службы.<br> # В случае ошибки "Данный пользователь "Мой склад" уже зарегистрирован." необходимо сбросить настройки одноименной кнопкой (появится в случае ошибки).# !ВАЖНО! Подождать пока синхронизируются справочники. Не закрывать и не перезагружать страницу. Данный процесс может занять продолжительное время (от 10 минут).# После синхронизации справочников, автоматически произойдет переход на страницу следующего шага.# !ВАЖНО! до выполнения настроек необходимо перейти в систему МойСклад и создать дополнительные поля в заказах в системе Мой Склад:#* строковые:#** "Город" - для указания населенного пункта получателя#** "Дата доставки" - для указания даты доставки наряду со временем#** "Сумма заказа" - для получения суммы заказа от КС#** "Стоимость доставки" - для получения стоимости доставки от КС#** "Строка для сохранения информации об ошибках" - для получения текста ошибки;#** "Количество мест" - для возможности указания количества мест;#* с типом '''"Справочник"''':#** "Виды срочности" (одноименный справочник),#** "Временные интервалы" (одноименный справочник),#** "Способы доставки" (одноименный справочник),#** "Тип оплаты" (одноименный справочник),#** "Время доставки с" (справочник '''Часы доставки'''),#** "Время доставки по" (справочник '''Часы доставки''').# Перейти к шагу 2, где настроить статусы отправки, соответствие полей и соответствие статусов.# Сохранить настройки.# !ВАЖНО! Для отправки заказа обязательно должен быть заполнен вес товара (хотя бы одного).Если омник забирает заказы у вас
При заполнении информации по заказу поля стоимость доставки, сумма и ошибка заполнять не нужно. Они заполнятся автоматически после синхронизации с курьерской службой. Пример cf3f645a5afc2e7ae030522711b4464af77dcb2d11997f1ddf5f1de81b003906<br>
Поле "Тип доставки" - если пустоеЕсли вы сами привозите отправления на склад или в ПВЗ омника (самопривоз) пароль будет ТОКЕН, значит доставка по адресу. Иначе выбираем ПВЗ из спискаКОД ПУНКТА САМОПРИВОЗА. <br> Пример cf3f645a5afc2e7ae030522711b4464af77dcb2d11997f1ddf5f1de81b003906,MSK317<br>
'''Как отправить заказ'''Переключите статус заказа на статус для передачи в курьерскую службу. В этот момент "Мой Склад" сообщает нашей системе об этом событии и она забирает заказЕсли есть необходимость ограничить используемые тарифы, укажите те, которые можно использовать, добавляет его в курьерскую службу.пароле: <br>Если после сохранения заказа в статусе для передачи в курьерскую службу статус не изменился необходимо проверить поле "ошибка". Необходимо дозаполнить поля указанные в поле "ошибка"Пример cf3f645a5afc2e7ae030522711b4464af77dcb2d11997f1ddf5f1de81b003906,MSK317,, очистить поле "ошибка" и сохранить заказ. 32 26<br>
'''Как проверить'''Для настройки модулей в поле "Код клиента" укажите 90025. <br><br><div style="color: #a94442; background-color: #f2dede; border: 1px solid #ebccd1; padding: 3px 10px 10px;"><b>Внимание!</b><br> При использовании прямых интеграций и модулей необходимо использовать второй режим срочности [2] <b>Посылка. Алгоритмический тариф</b>.<br>В разных модулях может выбираться из списка или вводиться числом. При выборе другого режима срочности интеграции и модули могут работать не верно либо рассчитывать не все возможные варианты.<br></div>
Зайти == Отмена заказов в Личный кабинет курьерской службы и проверить с помощью вкладки отслеживание существует ли отправленный заказинтеграциях ==<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>
!ВАЖНО! Модуль интеграции не работает на бесплатном тарифе!
При установке приложения в "Моем Складе" наша система в нем регистрирует <rspoiler text="событие">т.н. веб-хук</rspoiler>, на изменение заказа, чтобы "Мой Склад" нас извещал об изменениях. Так работают все модули служб доставки для МС. Проблема в том, что МС поддерживает только одно подобное событие для заказа, поэтому, если оно занято другим <rspoiler text="установленным модулем">А иногда бывает, что модуль удалили, или не до конца установили, а зарегистрированное событие от него осталось</rspoiler>, в этом случае мы не сможем его занять, и отправка заказов, к сожалению, работать не будет. Если у вас не отправляются заказы, и вы уверены, что у вас нет других модулей, использующих это событие, обратитесь к нам в службу поддержки, мы сможем проверить занятость события и при необходимости его освободить.
===Wordpress=======Требования к сайту перед установкой плагина[[Файл:====#CMS WordPress версии 5, или более новая.#WooCommerce версии 3.9, или более новая.#PHP версии 7, или более новая2023-04-03_11-26-09.png |700px]]#Сайт должен использовать SSL-сертификат<br><br><br>
</li><li>Если заказ <i style====Порядок установки плагина и вывод нового способа доставки в корзину"color:====#В панели администратора вашего сайта откройте страницу “Плагины black; background- Добавить новый” и нажмите на кнопку “Загрузить плагин”color:#В появившейся форме выберите архив с плагином e91e6326;"> не удалось отменить </i> на вашем компьютере и нажмите кнопку “Установить”#После загрузки и установки плагина вы можете его активировать нажав на соответствующую кнопку #После активации плагина стороне подрядчика, (например, заказ уже находится в меню появится ссылка на страницу настроек плагина.Заполните все необходимые поля и нажмите кнопку “Сохранить изменения”.#Откройте настройки WooCommerce и переключите на вкладку “Доставка”#Выберите необходимую зону процессе доставки), или создайте еёто статус заказа изменится на "<b>В работе у подрядчика</b>".#Нажмите на кнопку “Добавить метод доставки” и выберите из списка “КС2008”#После создания заказа, в панели администратораВ этом случае, в форме изменения изменение заказа, справа появится блок модуля "Отправить возможно только в курьерскую службуличном кабинете подрядчика, снизу которого будет кнопка "Отправить заказ либо обращением в КС2008", при нажатии на которую заказ будет отправлен в курьерскую службу<i>техподдержку подрядчика</i>.<br><br>
====Обновление статусов====
Обновление статусов заказов происходит через технологию WP_Cron каждые 30 минут.
Если статус заказа в курьерской службе будет изменен на “Доставлен”, то статус заказа в вашем магазине также будет изменен на “Выполнен”[[Файл:2023-04-03_11-52-20.png |700px]]<br><br><br>
</li><li>Если заказ был <i style== PimPay ==Чтобы начать работать с [https"color:black; background-color:#dafbda;"> успешно отменен <//pimpay.ru/ Pimpay] необходимо сначала зарегистрироваться i> (в их системе этом случае интеграция сама удалит заказ на стороне подрядчика), то по адресу [http:/истечении 1-15 минут статус заказа в интеграции сменится на "<b>Отменен</platformb>".api<br>Ответственный филиал корреспонденции будет автоматически переключен на главный ответственный филиал, а код подрядчика (если он был присвоен) будет удален.pimpay.ru/site/register http<br><i style="color:black; background-color:#dafbda">Только после этого можно считать, что корреспонденция полностью отменена в интеграции<//platform.api.pimpay.ru/site/register]. Далее pimpay активирует Вашу учетную запись. [[Файл:pimpayconfig.png|thumb|200px|right|рисi> и можно приступать к ее повторной отправке.1 Конфигурация PimPay]]<br>
Чтобы продолжить, вам нужно сгенерировать ключи шифрования. Это делается на UNIX-подобной системе: [http://platform.api.pimpay.ru/v2_7/signature/openssl http://platform.api.pimpay.ru/v2_7/signature/openssl] или <spoiler text="наша инструкция">
Чтобы получить приватный ключ, необходимо запустить командную строку.
В командной строке необходимо выполнить следующие команды<br>[[Файл: openssl genrsa -out private.pem 2048 openssl rsa 2023-in private.pem 04-outform PEM 03_12-pubout 03-out public35.pempng |700px]]
После успешного выполнение команд Вы получить 2 файла: public<br><br><br></li><li>Внесите исправления в данные корреспонденции.pem и privateСохраните ее.pem</li>Содержимое файла public.pem - ваш публичный ключ<li>Для повторной отправки корреспонденции по интеграции (предварительно убедившись, который необходимо целиком скопировать и вставить что все ошибки исправлены) вновь назначьте для корреспонденции ответственный филиал интеграции </li><li>После повторного назначения в ЛК PimPayкорреспонденции ответственного филиала интеграции ожидайте сообщения об отправке.При повторной отправке этот процесс может занимать до 30 минут.</li>А содержимое файла private.pem необходимо скопировать <li>При возникновении ошибки, если она очевидна, вновь исправьте ошибку в корреспонденции и вставить в настройках повторите процесс повторной отправки (отмена, исправление ошибок, повторное назначение на ответственный филиал интеграции с PimPay в нашем ЛК.)</li></spoilerul>[[Файл:pimpay client.png|thumb|200px|right|рис.2 Выбор платежного посредника]]Если у вас при получении ошибки от подрядчика нет специалистапонимания ее причин, чтобы сгенерировать ключи, обратитесь пожалуйста напишите в PimPay, они с радостью сделают это за вас!нашу техподдержку.
Далее, необходимо прописать настройки для pimpay в панели управления нашего ЛК (см. рис.1). В ЛК PimPay нужно посмотреть код компании (у них называется "Код платформы") и токен, ввести их в форму.==Сквозная интеграция==
Для каждого клиента, который хочет передавать данные в PimPay необходимо зарегистрировать в личном кабинете PimPay, и в нашей системе выбрать платежного посредника на вкладке "Финансы" карточки клиента. В процессе передачи данных привязка клиентов между системами производится по ИНН. Наша система начинает передавать все заказы вашего клиента в PimPay, их статусы, и созданные [[Акты Передачи Денег и корреспонденции (АПД)|АПД]]. Обратно она ничего не получаетСквозная интеграция предполагает передачу тарифов подрядчика при создании заказа.
Чтобы настроить сквозную интеграцию между [[#Интеграция с CMS-системами |CMS- или CRM-системой]] и подрядчиком [[#Тарификация и выбор подрядчика и его тарифа клиентом|из таблицы]]:* Создайте свой Личный кабинет для экстраинтеграции.<br>Для тогоэтого, чтобы платежи достаточно единоразово войти в банк по АПД выгружались в адрес PimPayЛК экстраинтеграции под своим логином и паролем https://home.courierexe.ru/XXX, где XXX — экстра-код партнера.<br><i>Логин</i> и <i>пароль</i>, нужно создать клиента с точно таким названием - это данные из 3-го и 4-го параметров ("PIMPAY"см. таблицу ниже), [[#Тарификация и выбор подрядчика и его тарифа клиентом|Тарификация и выбор подрядчика и заполнить его реквизитытарифа клиентом]].* настройте [[Виды срочности|режим срочности]] для подрядчика.
== Диадок ==Для сквозной тарификации заказов интернет-магазинов доступны следующие варианты:=== Начальная настройка ===* курьерская служба, с которой сотрудничает интернет-магазин, настраивает режим срочности для подрядчика. Интернет-магазин оформляет заказы в [[Личный кабинет клиента|личном кабинете клиента]] и выбирает указанный режим срочности;* интернет-магазины могут обратиться напрямую в MeaSoft для настройки сквозной тарификации. В этом случае нужно предварительно заключить договор на оказание услуг с выбранным подрядчиком, и сквозная тарификация позволит получать его цены.
Рассказываем как начать пользоваться == Тарификация и выбор подрядчика и его тарифа клиентом ==Вы можете настроить подключение своего тарифа к тарифу партнера — любой компании, работающей в системе MeaSoft, а также ряду компаний, с самого начала:которыми у нас есть интеграции.
=== Настройка интеграции ===Чтобы настроить подключение к тарифу партнера:# Свяжитесь с [https://kontur.ru/ СКБ Контур], попросите выпустить [https://ru.wikipedia.org/wiki/%D0%AD%D0%BB%D0%B5%D0%BA%D1%82%D1%80%D0%BE%D0%BD%D0%BD%D0%B0%D1%8F_%D0%BF%D0%BE%D0%B4%D0%BF%D0%B8%D1%81%D1%8C электронную цифровую подпись (ЭЦП)] для использования с ЭДО Диадок. Нам выставили счет на 5250 рублей. Потом нужно прийти Зарегистрируйтесь в предложенный офис удостоверяющего центра с уставными документами, вам дадут флешку (называется "Рутокен") с ЭЦПсистеме подрядчика. При ее подключении автоматически устанавливается набор ПО Данные аккаунта понадобятся для ее использованиянастройки интеграции.# Вам становится доступен вход в систему по адресу Откройте '''Справочники''' > '''Статусы''' > '''17 Виды срочности''' и создайте [[https://diadoc.kontur.ru https://diadoc.kontur.ruСтатусы#Виды срочности|вид срочности]], без пароля, просто по ЭЦП, подключенной к компьютеру. Вы уже можете принимать документы от контрагентовнапример «СДЭК».# Обратитесь в СКБ Контур для выставления счета на пакет отправляемых документов. Пакет можно выбрать здесь: [https://www.diadoc.ru/price https://www.diadoc.ru/price]. Кроме того, для использования с нашей, как В контекстном меню вида срочности выберите пункт '''Дополнительная информация''' и с любой другой системой, нужно включить возможность использования APIво второй строке заполните параметры подключения к партнеру через запятую: сотрудники Контура выставят за это счет #* 1- 18 т.р. на годй параметр — код филиала партнера, или 38 т.р. за 5 лет (актуально его можно посмотреть в 2019 году). После '''оплаты счетаСправочники''' > '''Межгород'' за API они присылают '> ''API-ключ'Филиалы''' вида "API-1b1111ae-1111-1111-b111-111111cc1fd1". API-ключ приобретается отдельно на каждое ваше юрМожно в одинарных кавычках указать несколько ответственных филиалов через запятую, тогда режим срочности будет доступен для всех перечисленных филиалов. Для версии системы 2021.0.0. лицо38 и выше вместо кода филиала можно указать знак вопроса (?), поэтому его нужно вводить это обозначит доступность режима срочности для всех филиалов;#* 2-й параметр — экстра-код партнера в "Фирмы"системе MeaSoft.Коды для сторонних компаний приведены в таблице ниже;# Заполняем данные подключения * 3-й параметр — имя пользователя в системе: ## партнера. Может отличаться от того, под которым работает интеграция, здесь нужно для расчета цены для клиента. В переменной <mparam code="EDocProvider"/> выбираем "Диадок".таблице ниже указано, что вводить для каждого интегратора;## API* 4-ключ нужно внести в "Справочники" -> "Фирмы" -> Карточка фирмы й параметр — пароль пользователя из 3-> "Ключ ЭДО"го параметра.В таблице ниже указано, что вводить для каждого интегратора;## Если * 5-й параметр — вид срочности партнера. Посмотреть доступные коды видов срочности можно по ссылке в вашем токене несколько сертификатовтаблице ниже, в поле <mparam code="EDocLogin"/> можно калькуляторе в выпадающем списке. Можно в одинарных кавычках указать отпечаток сертификатанесколько видов срочности через запятую, который нужно использовать. Если пусто тогда система будет стараться выбрать из них первый доступный;#* 6- программа постарается выбрать сертификат сама по доступности компаниий параметр — наценка к цене, к которой производится подключениепередаваемой подрядчиком. Посмотреть отпечаток: Пуск - Программы - Крипто-ПРО - "Сертификаты пользователя" - "Личное" - "Сертификаты". Справа выберите нужный сертификатВ деньгах или в процентах, откройтеесли стоит знак процента. Перейдите на вкладку "Состав"Например, прокрутите список значений вниз10 — наценка 10 рублей, в самом низу выберите "Отпечаток".10 % — наценка 10 процентов;## В поле <mparam code="EDocPass"/> введите пин* 7-код сертификатай параметр — если указать значение '''1''', сквозная тарификация выключена. Если вы его не менялиПараметр используется, можно пропустить: если подключение нужно только для передачи заказов по-умолчанию для рутокена пин - "12345678", и программа сама будет его использоватьинтеграции, если вы ничего а расчет цены не указалинужен. Если он окажется не правильным - Крипто-ПРО спросит у вас верный пин <br>В этом случае, при передаче данных. Обратите вниманиевизуализации суммы по режиму срочности, отображается внутренний тариф, а подрядчику заказ отправляется другим тарифом, что количество попыток ввода пинвыбранным согласно настройке в 5-кода ограниченом параметре (вид срочности партнера).;# После ввода данных подключения нужно выйти, и запустить программу от имени администратора (права windows, правой кнопкой на ярлык * 8- запустить от администратора)й параметр — если указать значение '''1''', и осуществить обмен данными: "Связь" -> "Обмен с ЭДО". При первом использовании программа установит на компьютер специальный COM-объект Диадокасреди указанных режимов срочности партнера выполняется поиск самого дешевого тарифа. Именно Работает для этого нужны праваСДЭК 1. В дальнейшем она будет использовать уже установленный компонент5, Почты России и наличия прав не требуетсяOmnic# Нажмите на кнопку '''OK'''.
{|class="wikitable"!Интеграция!Код экстра!Виды срочности!Авторизация!Пример строки|-|БОКСБЕРРИ||90001||https://home.courierexe.ru/90001/calculator||3-й параметр - токен. 4-й - Код пункта приема, по умолчанию 010.<br>Можно оба параметра оставить пустыми для расчета базовых цен.||33, 90001, j3ejwo2f10b2e47790174b41f4a11111, 010, 2, 50|-|ПИКПОИНТ||90002||https://home.courierexe.ru/90002/calculator||3-й параметр — логин, 4-й — через запятую пароль и договор ИКН. Можно оставить пустыми, но цены будут не все.||33, 90002,us0111, '6rGGuqRsW2qNQ,9990721312', 2, 50|-|rowspan== Обмен "2"|СДЭК<br>(протокол обмена данными 1.5, поддержка прекращена с ЭДО =01.01.2022)||rowspan="2"|90005||rowspan="2"|https://home.courierexe.ru/90005/calculator||Введите код учетной записи в 3-й параметр, секретный код — в 4-й. Можно оба оставить пустыми для расчета базовых цен.||45491, 90005, hfenJwlasiPr4pnFENpaVXSKPIn5Trh7i, '9vkQgWuiZgEj9fGCB8a6Xj3desnJkwsl,1.5', 5, 30%|-||Если вы хотите добавить в расчет тарифа процент за наложенный платеж, после пароля добавьте запятую и число процента. В настройке режима срочности пароль с числом процентов заключите в кавычки.||9vkQgWuiZgEj9fGCB8a6Xj3desnJkws,1.5|-|СДЭК<br>(протокол обмена данными 2.0)||90022||https://home.courierexe.ru/90022/calculator||3-й параметр — ID клиента, 4-й — ключ клиента.<br>Вы можете перечислить в пароле уточняющие параметры для расчета через запятую: <br><ul><li>не передавать объявленную ценность</li><li>добавлять услугу «Осмотр вложений»</li><li>процент за наложенный платеж</li><li>код пункта приема</li><li>процент за безналичный наложенный платеж</li></ul><br>Пример пароля: EMscd6r9JnFiQ3bLoyjJY6eM78JrJcee,1,1,2,MSK2,15||10497, 90022, EMscd6r7JnFyQ3bLoyjJY7eM78JrJceI, ‘Mscd6r9JnFiQ3bLoyjJY6eM78JrJcee,1,1,2,MSK2,15’, 1, 100|-Выберите |КСЭ||90008||https://home.courierexe.ru/90008/calculator||Введите логин в 3-й параметр, пароль — в главном меню 4-й. Пустыми оставить нельзя.||12504, 90008, Рога и копыта, 4CCB11864D06157, '2, 3, 6', 10%|-|ПОЧТА РОССИИ||90010||https://home.courierexe.ru/90010/calculator||Без авторизации||10497, 90010,,, '2, 1', 10 <!--10497, 90010, 89251234567, 'mypassword,u23B0r9AAJ1Fyh4ptMzJ3kjxcslamwdx', '2, 1', 10-->|-|rowspan="3"|DPD||rowspan="Связь3" -> |90011||rowspan="Обмен с ЭДО3"|https://home.courierexe. Откроется окно с выпадающим списком фирмru/90011/calculator||Введите клиентский номер в 3-й параметр, у которых заполнено поле "Ключ ЭДО"клиентский ключ в 4-й. Можно оставить пустыми для базовых тарифов. Выберите фирму||12504, 90011, 1019003662, '4CCB11864D06157A5934A9119F2A0AAAAAB4CCE8,D117', '3, 6', 10%|-||Если вы доставляете товар в пункт отправления самостоятельно, после пароля добавьте запятую и нажмите код ПВЗ, а в настройке режима срочности введите пароль в кавычках.||'4CCB11864D06157A5934A9119F2A0AAAAAB4CCE8,D117'|-|-|colspan="2"Обмен|ВНИМАНИЕ!". Программа выполнит все операцииУ DPD есть 2 калькулятора, которые периодически нужно выполнятьсчитают по-разному при одних и тех же вводных данных. При этом они не разглашают, чтобы иметь актуальные данные по какому из расчетов определяют цену. Поэтому по не зависящим от нас причинам расчет по тарифам DPD может как совпасть с итоговым, так и сильно разойтись. Если вас это не устраивает, не используйте сквозную тарификацию с этим подрядчиком.|-<!--|DOSTAVKA.GURU||90017||https://home.courierexe.ru/90017/calculator||3-й параметр — ID партнера в нашей системе так DOSTAVKA.guru, 4-й — ключ доступа. Также можно указать признак отключения проверки интервала доставки. В этом случае необходимо указать ключ и "1" через запятую в ЭДО:кавычках. Можно оставить пустыми. ||10497, 90017, 9999, 'cc03e747a6afbbcbf8be7668acfebee5,1', '1', 100|- -->*Синхронизирует справочники контрагентов|5Post||90020||https: Получит список контрагентов//home.courierexe.ru/90020/calculator||3-й параметр — API-ключ, уже являющихся <br>4-й — уникальный номер партнера в системе 5post.<br>При необходимости в 4-м параметре можно через запятую указать параметры:<br><ul><li>пороговое значение веса (по умолчанию 3 кг).</li><li>Использовать штрихкод для отслеживания получателем</li><li>Код подрядчика в карточке заказа</li><li>Габариты мест</li><li>Тип расчета тарифа</li></ul><i>При указании параметров важно соблюдать последовательность.</i><br><i>Для вашего аккаунта в API 5post должна быть подключена возможность получать ПВЗ с вашими партнерами в ЭДОтарифами.</i><br>Пример пароля: 2123,7,,,,1||10497, 90020, u23B0r9AAJ1Fyh4ptMzJ3kjxcslamwdx,'2123,7,,,,1', '1,3', 100|-|GTD||90021||https://home.courierexe.ru/90021/calculator||3-й параметр — API-ключ, проставит им соответствующие признаки (На вкладке "Клиенты" появилось новое поле "Статус ЭДО"4-й — пароль от личного кабинета https://home.courierexe.ru/90021. Предварительная авторизация по указанному URL обязательна. Это поле нельзя менять||10497, 90021, u23B0r9AAJ1Fyh4654MzJ3kjx1548wdx, оно устанавливается автоматически)pass, проверит100|-|Яндекс.Доставка||90023||https://home.courierexe.ru/90023/calculator||3-й параметр — токен, кто прислал вам приглашения к партнерству <br> 4-й — ID пункта отправления и примет ихчерез запятые интервал доставки.<br>Пример пароля: cfceadaa-4874-438a-999b-dbbafe5326ed,11:00,18:00||10497, 90023, AgAABBDzeAQMAAAPeISvM_9LUkxCijQoFXOH5QE, ‘cfceadaa-4874-438a-999b-dbbafe5326ed, разошлет приглашения всем вашим работающим контрагентам11:00, проверит18:00’, кто принял приглашение1, а кто 100|-|Л-Пост||90024||https://home.courierexe.ru/90024/calculator||3- отказалсяй параметр — логин, который требуется создать самостоятельно, для входа в <i>[https://home.courierexe.ru/90024/ ЛК экстраинтеграции Л-Пост]</i> <br> 4- пароль, как Секретный ключ клиента<br> Дополнительно, есть возможность перечислить в пароле уточняющие параметры для расчета через запятую: <br><ul><li>Признак использования тестовой среды</li><li>Код пункта приема</li></ul><br>Пример пароля: YGNoaR3cG00JYg67,0,1010||10497, 90024, LoginTest, ‘YGNoaR3cG00JYg67,0,1010’, 1, 100|-*Проверит статусы ранее отправленных документов|Omnic||90025||https://home.courierexe. При подписании документа вашим партнеромru/90025/calculator||3-й параметр — логин, который требуется создать самостоятельно, сообщение получит статус "Доставлено"для входа в <i>[https://home.courierexe. Если оно отправлено из счетов или АПДru/90025/ ЛК экстраинтеграции Omnic]</i> <br> 4- пароль, как Токен клиента<br> Дополнительно, есть возможность перечислить в пароле уточняющие параметры для расчета через запятую: <br><ul><li>Код пункта приема отправлений</li><li>Признак использования тестовой среды</li><li>Приоритет доступных тарифов через пробелы, - при указании алгоритмического тарифа, приоритет указанный в нем имеет преимущество</li></ul><br>Пример пароля: g67hjtTYjhgf765432,MCK45||10497, 90025, LoginTest, ‘g67hjtTYjhgf765432,MCK45,,21 22’, '3, 2', 100,, то соответсвующий документ получит признак получения подписанного акта.1|}
=== Отправка документов ===К отправке сейчас доступны счета, АПД и АПК. Отправка работает крайне похоже на e-mail. Документы формируются точно так же, но отправляются не почтой, а При выборе клиентом в ЭДОличном кабинете вида срочности, уже подписанными вашей ЭЦП. В системе ЭДО "адресами" отправителя и получателя являются ИНН (по возможности еще КПП, но это не обязательно) компании, поэтому, чтобы все работало, ИНН должен быть заполнен. Так же ЭДО примет документы только в адрес компании, с которой у вас отмечены партнерские отношения, т.е. кто-то из вас отправил приглашение, а другой его принял. Поэтому, для удобства контроля - кому можно подключенного таким образом отправлять, а кому - нет, в списках документов добавлено поле "Есть ЭДО". Там галка ставится на основании статуса ЭДО клиента. Можете отсортировать по этому полю, выдели все, где есть галкик партнеру, и разослать всем документы по ЭДОнабор доступных ПВЗ будет ограничен выбранным партнером.
== Телефония ==Основная статьяВы можете войти в личный кабинет по адресу вида https: [[Интеграция //home.courierexe.ru/XXX, где XXX — экстра-код партнера, авторизоваться данными из 3-го и 4-го параметров (см. таблицу выше) и воспользоваться калькулятором с телефонией]]тарифами именно вашей компании.
== GPS трекинг автотранспорта = Настройка стоимости доставки для получателя ===Для поддержки GPS трекинга автотранспорта у нас разработана интеграция При интеграции с коробочной системой Wialonподрядчиками, перечисленными в таблице выше, вы можете настроить стоимость и срок доставки, отображаемые для получателя:# Перейдите в личный кабинет по адресу вида https://home.courierexe.ru/XXX, на которой работают большинство компанийгде XXX — экстра-код партнера, предоставляющих подобные услугии авторизуйтесь данными из 3-го и 4-го параметров (см. таблицу выше).# Откройте пункт основного меню '''Цена доставки для получателя''' и настройте правила расчета цены и сроков доставки. Обратитесь в службу технической поддержки Подробнее см. раздел «[[Личный кабинет клиента#Цена доставки для получателя|Цена доставки для помощи в настройкеполучателя]]».
