Изменения

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

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

13 594 байта убрано, 9 февраль
Настройка
Система "Курьерская служба 2008" MeaSoft имеет практически не ограниченные неограниченные возможности по интеграции с другими системами. В этой статье мы рассмотрим виды и способы интеграции.
=Виды интеграций= * Заказы:** передача между [[#Интеграция между 2двумя системами MeaSoft|двумя системами]] MeaSoft — клиент отправляет заказы другому агенту, агент доставляет отправления и передает их статусы, которые загружаются в систему клиента.;** передача заказов в стороннюю систему [[#Интеграция с подрядчиками|подрядчика]] через API и получение статусов доставки;** получение заказов из [[#Интеграция с CMS-системами|CRM- и CMS-систем]] интернет-магазинов и отправка статусов доставки;** [[#Сквозная интеграция|сквозная интеграция]]: получение цен подрядчиков при оформлении заказа;* [[Интеграция с платежными сервисами|платежные сервисы]]:** PimPay — финансирование для интернет-магазинов;** Robokassa — онлайн-оплата заказов и мобильный эквайринг;** Assist — мобильный эквайринг;** ibox — мобильный эквайринг;** Payme — онлайн-оплата заказов и мобильный эквайринг. Работает в Узбекистане;* электронный документооборот — [[Диадок]];* телефония — телефонный сервер [[Интеграция с телефонией|Asterisk]];* планирование маршрутов курьеров — [[Яндекс.Маршрутизация]], [[Максоптра]];* GPS-мя клиентами системы MeaSoft "Курьерская служба 2008" ==трекинг автотранспорта — [[Wialon]].
Один из клиентов (= Интеграция между двумя системами MeaSoft =Клиент) отправляет заказы другому клиенту (Агенту)агенту, Агент агент доставляет отправления, и передает их статусы, которые загружаются в систему Клиентаклиента.
Интеграция может быть и двунаправленная, когда двухсторонняя: одна компания заказывает доставку у второй, а вторая - вторая — у первой. В этом случае нужно настроить 2 интеграции: в одной нужно рассматривать одну компанию клиентом, вторую — агентом, во второй интеграции — наоборот.
В этом случае ==Настройка==# Обе компании должны иметь аккаунты в системе MeaSoft ('''Справочники''' > '''Дополнительные модули''') и у обеих компаний должен быть установлен флажок '''Личный кабинет''' в окне «Управление дополнительными модулями».# Агент на вкладке '''Клиенты''' создает карточку клиента в своей системе. На вкладке '''Прочее''' [[Клиенты и партнеры#Прочее|карточки клиента]] указывает логин и пароль для входа в [[личный кабинет]] клиента.# Агент передает клиенту логин и пароль из предыдущего шага и свой [[Личный кабинет курьерской службы#Подключение|код экстра]] в системе MeaSoft.# Клиент создает в своей системе [[Филиалы|филиал]] для указанного агента. После создания филиала нужно настроить 2 интеграции по данной инструкцииподождать 3 минуты для синхронизации данных.# Клиент заходит в [[личный кабинет курьерской службы]] и на вкладке '''Подрядчики''' в таблице находит созданный филиал.# Клиент в строке подрядчика нажимает на кнопку [[Файл:MeaShip_Интеграция.png]], в одной нужно рассматривать одну компанию – клиентомоткрывшемся окне выбирает интеграцию «MeaSoft», заполняет поля:<div style="padding-left: 45px; position: relative;">*'''Логин''', '''Пароль''' и '''Код клиента''' учетными данными, вторую – агентомполученными в п. 3, во второй *<b>Тип оплаты</b> - позволяет управлять логикой обработки типа оплаты в данных передаваемого по интеграции – наоборотзаказа.Доступные варианты:**Адаптируется в соответствии с данными заказа<br><span style="padding-left: 10px;">При отсутствии наложенного платежа передается <b>No</b>, иначе при типе оплаты картой <b>CARD</b>, во всех остальных случая <b>CASH</b></span>**Оригинальный<br><span style="padding-left: 10px;">В этом случае, тип оплаты заказа передается без изменений</span><br>
Итак, по пунктам:
<i>Группа параметров, отвечающая за разделение заказов по потокам с разной авторизацией:</i>
* '''Логин для заказов без чека''' и '''Пароль для заказов без чека'''
* '''Определять заказы без чека по признаку''' - "Печатать чек - в карточке клиента" или "Спрашивать тип оплаты у получателя - в карточке клиента"
В интеграции Measoft существует возможность отправлять заказы, распределяя их 2-м разными клиентами по принципу необходимости чека.
1) Для этого в интеграции Measoft нужно заполнить параметры "Логин для заказов без чека" и "Пароль для заказов без чека"<br>Заказы, которые созданы клиентом '''Обе компаниис настройкой необходимости чека''' должны иметь аккаунты будут отправляться с авторизацией указанной в системе MeaSoft («Справочники» – «Дополнительные модули»)параметрах: <i style="color: #740474;">"Логин"</i> и <i style="color: #740474;">"Пароль"</i><br>Заказы, которым '''чек не требуется''' будут отправляться с авторизацией <i style="color: #740474;">"Логин для заказов без чека"</i> и у обеих компаний должна быть установлена галка «Личный кабинет» в указанном выше окне.<i style="color: #740474;">"Пароль для заказов без чека"</i><br>
2) '''Агент''' создает клиента в своей системе (на закладке «Клиенты»). На закладке «Прочее» карточки клиента указывает логин и пароль для входа в Личный кабинет.
3) Далее, клиент указывает остальные настройки при необходимости и нажимает '''АгентСохранить''' передает клиенту Логин.</div>В результате отправления, Пароль (из предыдущего шага)у которых клиент укажет филиал агента в качестве ответственного филиала, а так же свой идентификатор будут переданы в системе систему MeaSoft (см. иллюстрацию)агента, и статусы будут передаваться обратно. Правильный способ отправки заказов — через [[Файл:Measoft id.pngМанифесты|thumb|200px|right|рисманифест]], который нужно скомплектовать и проставить дату отправки.На передачу данных может уходить до 10 минут в штатном режиме и до 1 Код экстра-клиента]]часа в случае возможных сбоев.
4) '''Клиент''' создает в своей системе филиал (Справочники – Межгород – Филиалы) для указанного агента. После ввода филиала нужно перевойти в программу и подождать 3 минуты<div style="color: #a94442; background-color: #f2dede; border: 1px solid #ebccd1; padding: 3px 10px 10px;">При передаче заказов, у которых плановая дата доставки меньше ближайшей возможной, дата доставки автоматически меняется на самую раннюю возможную.</div>
5) '''Клиент''', получив данные из п. 3, заходит в свой личный в системе Для стабильной работы необходимо наличие версии MeaSoft (см. иллюстрацию)минимум 518 от 05. Переходит на закладку «Интеграция»12. В таблице должен появиться созданный филиал2014 у обеих компаний. [[Файл:Measoft homeДля одного клиента может быть настроена только одна интеграция с агентом.png|thumb|200px|right]]
6) '''Клиент''' нажимает кнопку «Настроить» напротив филиала, в открывшемся окне выбирает интегратор «MeaSoft», далее – заполняет форму – «Логин», «Пароль», и «Код клиента» данными, полученными в п. 3, нажимает «Сохранить».==Распределение заказов по признаку необходимости чека==
Вы может распределять заказы по двум разным клиентам по принципу необходимости чека. Для этого агент создает в своей системе второго клиента для вашей компании, в карточке клиента на вкладке '''Прочее''' указывает логин и пароль, которые передает вам.
В результате такой настройки, все отправления, у которых Клиент установит «Ответственный филиал», соответствующий Агенту настройке интеграции Measoft (правильнее всего это делать оформив [[Манифесты|манифест]], скомплектовав его, пункт 6 инструкции выше) заполните поля '''Логин для заказов без чека''' и '''Пароль для заказов без чека''' и проставив дату отправки), будут переданы в БД Агентавыберите признак, и статусы будут передаваться обратно. На передачу данных может уходить до 10 минут в штатном режимепо которому определяется необходимость чека, и до 1 часа в случае возможных сбоевполе '''Определять заказы без чека по признаку'''.
Для стабильной работы необходимо наличие версии минимум 518 от 05Заказы, созданные клиентом, которому нужен чек, будут отправляться с авторизацией, указанной в полях '''Логин''' и '''Пароль'''.12.2014 у обеих компаний
== Интеграция Заказы, которым чек не требуется, будут отправляться с подрядчиками (передача авторизацией '''Логин для заказов без чека''' и '''Пароль для заказов) ===== Отказ от ответственности ===Хотим обратить Ваше внимание на то, что интеграции со сторонними системами делаются в соответствии с документацией на момент написания, без партнерства с компаниями-поставщиками сервиса. Об изменениях API нас не оповещают, поэтому интеграции, по независящим от нас причинам, могут переставать работать, работать нестабильно или некорректно, вплоть до потери важной (финансовой?) информации. Заказы, переданные во внешние системы нужно обязательно проверять на корректность пользуясь личным кабинетом партнерачека'''.
=Интеграция со сторонними системами == Общие правила настройки интеграции ===Здесь рассматривается интеграция Сторонними системами могут быть:* [[#Интеграция с подрядчиками|системы подрядчиков]], принимающие заказы на доставку;* [[#Интеграция с CMS-системами сторонних компаний (агент)|CRM- и CMS-системы]] интернет-магазинов, где система MeaSoft (клиент) выступает клиентом, т.е. передает передающие заказы и получает обратно статусыв курьерскую службу.
Клиент должен иметь аккаунт и личный кабинет Интеграции со сторонними системами делаются в системе MeaSoftсоответствии с документацией на момент написания, без партнерства с компаниями-поставщиками сервиса. Подробнее смОб изменениях API нас не оповещают, поэтому интеграции по не зависящим от нас причинам могут переставать работать, работать нестабильно или некорректно, вплоть до потери важной информации. раздел «[[Личный кабинет курьерской службы]]»Заказы, переданные во внешние системы, нужно обязательно проверять на корректность, пользуясь личным кабинетом партнера. По интеграции уходят только новые заказы, созданные в день настройки интеграции.
# Создайте в своей системе филиал ('''Справочники''' > '''Межгород''' > '''Филиалы''') для указанного агента. После ввода филиала нужно перезагрузить программу и подождать 3 минуты.# Зайдите в личный кабинет курьерской службы в системе MeaSoft. Чтобы узнать свои учетные данные, выберите '''Справочники''' > '''Дополнительные модули''': [[Файл:Measoft home.png|none|600px]]# В личном кабинете перейдите на закладку '''Интеграции'''. В таблице должен появиться созданный филиал.# Нажмите на кнопку '''Настроить''' напротив филиала, в открывшемся окне выберите интегратор той компании, == Интеграция с которой хотите интегрировать. Далее заполните форму по отображенной инструкции (для каждого интегратора форма и инструкции свои), нажмите '''Сохранить'''.CMS-системами ==
Если устанавливается интеграция между [[API#Готовые интеграции|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 Скачать] -->|Поддерживает версии 14.5 и выше. [[1C-Битрикс|Инструкция по настройке]].|-|[[Файл:prestashop.png|center|x60px]]|style="text-align: center;"|[https://courierexe.ru/download/api/prestashop.zip Скачать]|Поддерживает версии 1.5.2.0 и выше.|-|[[Отправка корреспонденцииФайл:OpencartOCStore.png|манифестcenter|x60px]]|style="text-align: center;"|[https://courierexe.ru/download/api/opencart.zip Скачать для версии 1.5.5.1]<br>[https://courierexe.ru/download/api/measoft_oc2.ocmod.zip Скачать для версии 2.0]<br>[https://courierexe.ru/download/api/measoft_oc2.3.ocmod.zip Скачать для версии 2.3]<br>[https://courierexe.ru/download/api/measoft_oc3.ocmod.zip Скачать для версии 3.0]|Поддерживает версии с 1.5.5.1.<br>Скачивайте модули для своей версии OpenCart.<br>[[OpenCart|Инструкция по настройке]].<br>[https://opencartforum.com/files/file/2906-avtomatizaciya-otpravki-i-otslezhivanie-dostavok-courierexe-dlya-opencart-15x/ Альтернативный модуль сторонних разработчиков]|-|[[Файл:webasyst-shopscript.png|center|x44px]]|style="text-align: center;"|[https://www.webasyst.ru/store/plugin/shop/measoftcourier/ Установить модуль]<br>[https://www.webasyst.ru/store/plugin/shipping/measoftcourier/ Установить плагин]|Модуль предназначен для отправки заявок в КС, комплектовать его а плагин для расчета стоимости доставки при оформлении заказа.|-<!--|[[Файл:advantshop.png|center|x44px]]|style="text-align: center;"|[https://promo-z.ru/ Сайт компании PROMO]|Компания PROMO разработала этот модуль и проставить дату отправкинастраивает интеграцию MeaSoft с ADVANTSHOP своим клиентам.|- -->|[[Файл:insales.png|center|x80px]]|style="text-align: center;"|Настраивается в [[Личный кабинет клиента|ЛК пользователя]]|[[InSales|Инструкция по настройке]]|-|[[Файл:Leadvertex.png|center|x44px]]|style="text-align: center;"|[https://blog.leadvertex.ru/news/2110-integraciya-s-kurerkami-na-platforme-measoft Настраивается] в ЛК [https://Leadvertex.ru Leadvertex]|[[LeadVertex|Инструкция по настройке]]<br>Модуль разработан и поддерживается компанией LeadVertex.|-|[[Файл:Retailcrm.png|center|x30px]]|style="text-align: center;"|[https://www.retailcrm.ru/ RetailCRM]|[[RetailCRM|Инструкция по настройке]]|-|[[Файл:1C.jpg|center|x44px]]|style="text-align: center;"|-|[https://infostart.ru/public/692790/ Альтернативный модуль сторонних разработчиков]|-|[[Файл:Joomla2.jpg|center|x60px]]|style="text-align: center;"|[https://courierexe.ru/download/api/com_measoft.zip Скачать]|Работает только с компонентом Virtuemart.|-|[[Файл:Amocrm.png|center|x44px]]|style="text-align: center;"|[https://www.amocrm.ru/extensions/courier2008 Установить]|[[amoCRM|Инструкция по настройке]].|-|rowspan="2"|[[Файл:MoySclad.jpg|center|x30px]]|style="height:50px; text-align: center;"|[https://home.courierexe.ru/moysklad/step1 Настроить интеграцию с MeaSoft]|[[МойСклад|Инструкция по настройке]]|-|style="height:50px; text-align: center;"|[https://itmdev.ru/ms/shipping/ Скачать модуль сторонних разработчиков]|Интеграция МойСклад с курьерскими службами от сторонних разработчиков|-|[[Файл:wordpress.jpg|center|x80px]]|style="text-align: center;"|[https://courierexe.ru/download/api/wordpress.zip Скачать]|[[Wordpress|Инструкция по настройке]]|-|[[Файл:Cscart.png|center|x60px]]|style="text-align: center;"|[https://marketplace.cs-cart.com/measoft-en.html Установить]|Поддерживает версии 4.10 и выше.<br>[[CS-Cart|Инструкция по настройке]]|-|}
=== Замечания ===# В модулях систем PrestaShop и Joomla для отправки заказа в курьерскую службу зайдите в карточку заказа. В карточке отображается специальная форма отправки заказа, а если заказ отправлен, она позволяет проверить его статус:[[Файл:Form.png|400 px|Форма отправки заказа|none]]# Оформление заказов до '''ПВЗ''' в модулях '''PrestaShop''' и '''Joomla''' не реализовано. Чтобы оформить такой заказ, в поле передаваемого адреса укажите одно из значений:#* код ПВЗ, который можно посмотреть в ЛК клиента или на сайте агента (Boxberry, CDEK и т. п.). Обычно это цифровой или цифро-буквенный код;#* наименование ПВЗ, добавив в начале строку "ПВЗ ", например '''ПВЗ На передачу данных может уходить до 10 минут Ленина'''.# Поддерживается передача маркировки «[[Маркировка|Честный ЗНАК]]» из InSales и RetailCRM. Информацию по настройке см. в штатном режиме документации [https://www.insales.ru/collection/doc-zprochee/product/prodazha-tovarov-s-markirovkoy-487-fz Insales] и до 1 часа [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. Введенные данные потеряны не будут, карта после этого отобразится корректно.<!--=== Беру ===При интеграции поддерживается:* Обработка координат.-->=== Проверка работоспособности интеграций ===При неполадках интеграции проверьте ее работоспособность. В общем случае возможных сбоевдля этого достаточно создать заказ и отправить его в курьерскую службу.
Для стабильной работы необходимо наличие у клиента системы MeaSoft версии минимум 518 от 05Если заказ отправлен без ошибок и отображается в ЛК, значит, интеграция настроена.12.2014Если отправка не удалась, ошибка может быть в настройках интеграции или в заполнении формы отправки заказа.
=== СДЭК ===Текст ошибки можно увидеть через [[Личный кабинет#Отладка|отладку]] в личном кабинете. Чтобы найти свой заказ в запросах, нажмите клавиши CTRL + F и введите в строку поиска номер заказа или ориентируйтесь на время создания заказа.
Отправка в СДЭК осуществляется первым доступным тарифом Убедитесь, что выполнены все шаги инструкции по настройки интеграции из списка:* «Экономичная посылка»,* «Посылочка»,* «Экспресс-лайт»,* «Магистральный экспресс»этого раздела.
В настройках интеграции MeaSoft может поменять местами тарифы «Экономичная посылка» и «Посылочка».При весе отправления больше 30 кг применяется тариф «Магистральный экспресс»Ниже представлено описание проверки работоспособности для разных интеграторов.
Чтобы передать услугу «Примерка», установите флажок '''Принято на складRetailCRM''' в [[Создание корреспонденции#Вручную|карточке корреспонденции]]. Если услуга не нужна, снимите флажок.
При передаче валюты наложенного платежа код валюты берется из поля # Убедитесь, что выполнены все шаги [[RetailCRM#Настройка интеграции|инструкции по настройке интеграции]].# Если используются триггеры, убедитесь, что они настроены согласно [[RetailCRM#Настройка триггеров|инструкции]].# Создайте заказ, заполните требуемые данные.# Нажмите на кнопку '''ВалютаСохранить''' карточки клиентавнизу страницы, от которого передается заказфлажок '''Не отправлять данные в службу доставки''' должен быть снят. Заказ должен отправиться в курьерскую службу. Валюта должна совпадать с валютой страны назначения заказа# Если возникает ошибка, ее текст отображается наверху страницы. :: Если заказ отправляется в другую странуэто ошибка заполнения формы, создайте копию клиента с нужной валютой исправьте внесенные данные и оформляйте заказы от негопопробуйте отправить заказ снова. Пример ошибки: «Ошибка сервиса доставки „Курьерская служба 2008“: field [receiver phone] has no valid phone number»:: Если это ошибка ответа курьерской службы, указывая цены сообщите об этом разработчику. Пример ошибки: «Служба доставки прислала ответ в валюте страны назначенияневерном формате».
В общем случае интеграция не поддерживает отправки в другие страны, кроме России.'''МойСклад'''
[http# При сбое интеграции проверьте, не изменен ли аккаунт, под которым создана интеграция:## Логин учетных данных МойСклад, которые использовались при создании интеграции, вставьте в ссылку <nowiki>https://home.courierexe.ru/downloadmoysklad/userfuncstep2?id=</SDEK_report_loadnowiki>'''логин'''.xml Загрузка отчета СДЭК] Создает входящий АПД Если при переходе по отчету СДЭК [httpссылке отображается этап настройки интеграции, значит аккаунт существует.## Войдите в «МойСклад» под учетной записью, которая использовалась для настройки интеграции, и откройте справочник '''Сотрудники'''://courierexeменю пользователя > '''Настройки''' > '''Справочники'''> '''Сотрудники'''.ru/download/userfunc/SDEK_report_demoОткройте карточку сотрудника, под учетной записью которого вы вошли, и убедитесь, что его роль — администратор.xls такого формата]. Работает начиная с версии 626 от 29.01## Если хотя бы один из пунктов не выполнен, значит, аккаунт, использованный для создания интеграции, изменен.2016 и только при передаче заказов # В личном кабинете клиента курьерской службы в СДЭК с помощью штатной настройках обратной интеграции. Заполняет '''Мой склад''' в поле '''Агентская ценаВ каком статусе «Мой склад» отправлять заказ на доставку''' уточните статус, при котором заказ отправляется в карточке корреспонденции курьерскую службу.# Заполните форму заказа, нажмите на вкладке кнопку '''Сохранить''', затем смените статус заказа на статус, установленный для отправки в курьерскую службу и снова нажмите на кнопку ''Межгород'Сохранить'''. Если все верно, заказ будет отправлен в курьерскую службу.# Обновите страницу в браузере и проверьте поле '''Строка для сохранения информации об ошибках''':#* если поле пустое и заказ пришел в личный кабинет, интеграция работает;#* если поле пустое и заказ не пришел в личный кабинет, обратитесь к разработчику;#* если в поле содержится текст ошибки, исправьте ее в форме заказа и попробуйте отправить его снова.
=== 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]]'''InSales'''
=== Почта России ===# В личном кабинете клиента курьерской службы в настройках обратной интеграции '''InSales''' проверьте данные в следующих полях:#* '''Статус заказа для автоматической отправки в курьерскую службу''';#* '''Список доставок для отправления заказа в курьерскую службу (если отправляется автоматически)''';Интеграция с Почтой России описана #* '''Оплачен ли заказ? (если отправляется автоматически)'''.# Создайте заказ и в случае ошибки проверьте данные заказа на соответствие этим полям. Например, в заказе может быть установлен тип доставки, не отмеченный как используемый в настройках в разделе [[%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 ===При возникновении ошибок при отправке заказа появляется диалоговое окно с сообщением об ошибке. Исправьте ошибку в форме заказа и попробуйте отправить его снова.
Если '''PickPointamoCRM''' выделил вам диапазон трекинг-номеров, то необходимо настроить филиал и придерживаться последовательности отправки манифестов.Для настройки филиала для интеграции '''PickPoint''' с диапазоном в основном меню выберите '''Справочники -> Межгород -> Филиалы''' нажатием правой кнопки мыши на предварительно созданном филиале, в контекстном меню выберите '''Открыть''' в открывшейся форме перейдите на вкладку '''Интеграция''' и в выпадающем списке '''Правила назначения кода заказа у подрядчика''' выберите '''Из диапазона'''. Укажите начальный и конечные коды диапазона, префикс при необходимости и нажмите клавишу '''ОК'''.
Для отправки манифестов добавьте заказы Ошибка при создании заказа отображается в манифест, затем, на вкладке '''Манифесты''' необходимо добавить требуемые заказы в мешок, а далее выбрать в манифесте ранее настроенный филиал. После чего, в контекстном меню манифеста выбрать пункт '''Проставить коды у подрядчика'''.После этого можно указать дату отправки манифесталевом нижнем углу.
Обратите внимание== Интеграция с подрядчиками ===== Описание процесса интеграции ===Рассматривается интеграция с системами сторонних компаний (агентов), что проставить коды с указанной датой отправки манифеста нельзя. Необходимо сначала очистить дату отправкигде система MeaSoft выступает клиентом, а затем проставить кодыто есть передает заказы и получает обратно статусы.
Агентская цена данной интеграцией не возвращается, тКомпания-пользователь MeaSoft должна иметь аккаунт и личный кабинет в системе MeaSoft.кПодробнее см. эти данные отсутствуют в API PickPointраздел [[Личный кабинет курьерской службы#Подключение|«Личный кабинет курьерской службы»]].
=== КСЭ ===# Создайте в своей системе [[Филиалы|филиал]] для агента. После ввода филиала нужно перезагрузить программу и подождать 3 минуты.# В личном кабинете курьерской службы на вкладке '''Интеграции''' в списке филиалов найдите созданный филиал и в его строке нажмите на кнопку '''Настроить'''.# В открывшемся окне в выпадающем списке выберите нужную интеграцию.# Заполните форму по отображенной инструкции, нажмите '''Сохранить'''.
Настройки интеграции:* '''Данные отправителя''' - данные, которые будут подставляться во все В результате настройки отправления, передаваемые у которых клиент укажет филиал агента в КСЭ. Если не указатькачестве ответственного филиала, то будут переданы в подрядчику и статусы будут передаваться данные заказчика (отправителя) из корреспонденции.* '''Является ИМ''' - признак отправителя в системе КСЭобратно. От данного признака зависит главным образомПравильный способ отправки таких заказов — через [[Манифесты|манифест]], как отправляются данные в КСЭ. Признак указывается в договоре клиента с КСЭкоторый нужно скомплектовать и проставить дату отправки.* '''Забор''' - настройка, в которой можно указать, каким образом отправление передается На передачу данных может уходить до 10 минут в КСЭ - КСЭ забирает отправление у клиента или клиент сам привозит отправление штатном режиме и до 1 часа в КСЭслучае возможных сбоев.
=== DOSTAVKAДля стабильной работы необходимо наличие у клиента системы MeaSoft версии минимум 518 от 05.12.2014.GURU ===
При настройке интеграции в CRM- или CMS-системе введите следующие учетные данные:* логин — ID клиента DOSTAVKA.GURU. ID клиента отображается вверху страницы личного кабинета клиента DOSTAVKA.GURU;* пароль — запросите API-ключ интеграции у DOSTAVKA.GURU;* код курьерской службы — 90017.==== Последовательность финальных статусов ====
== Тарификация и выбор подрядчика и его тарифа клиентом ==Вы можете настроить подключение своего тарифа к тарифу партнера. Партнерами могут быть любые компании, работающие в системе MeaSoft, а также ряд компаний, с которыми у нас есть интеграции, см. список ниже. Для этого откройте '''Справочники''' Параметр <b>Исправлять ошибки последовательности статусов</b> '''Статусы''', выберите '''17 Виды срочности'''регулирует возможность исправления ошибочно опубликованных подрядчиком финальных статусов. Создайте вид срочности, например «СДЭК». В контекстном меню выберите '''Дополнительная информация''' и во второй строке заполните параметры подключения к партнеру через запятую:* 1-й параметр — код филиала партнера, его можно посмотреть в '''Справочники''' > '''Межгород''' <br> '''Филиалы''';* 2-й параметр — экстра-код партнера Если в системе MeaSoft. В том числе для сторонних компаний есть коды, см. таблицу ниже;* 3-й параметр — имя пользователя в системе партнера. Может отличаться от того, под которым работает интеграция, здесь нужно для расчета цены для клиента. В таблице ниже параметре интеграции указано"Исправлять", что вводить для каждого интегратора;* 4-й параметр — пароль пользователя из 3-го параметра. В таблице ниже указаното при получении статуса <b>CANCELED</b>, что вводить для каждого интегратора;* 5-й параметр — вид срочности партнера. Посмотреть доступные коды видов срочности можно по ссылке в таблице нижевслед за финальным, в калькуляторе в выпадающем списке. Можно в одинарных кавычках указать несколько видов срочности через запятую, тогда система дата доставки заказа будет стараться выбрать из них первый доступный;* 6-й параметр — наценка к цене, передаваемой подрядчиком. В деньгах или приводится в процентах, если стоит знак процента. Например, 10 — наценка 10 рублей, 10% — наценка 10 процентовсостояние соответствующее последнему полученному статусу.
{|class="wikitable"!Интеграция!Код экстра!Виды срочности!Авторизация!Пример строки|-|БОКСБЕРРИ||90001||https://home.courierexe.ru/90001/calculator||Введите токен в 4-й параметр. 3-й можно оставить пустым. Можно оба оставить пустыми для расчета базовых цен.||33, 90001,, j3ejwo2f10b2e47790174b41f4a11111, 2, 50|-|ПИКПОИНТ||90002||https://home.courierexe.ru/90002/calculator||3-й параметр — логин, 4-й — через запятую пароль и договор ИКН. Можно оставить пустыми, но цены будут не все.||33, 90002,us0111, '6rGGuqRsW2qNQ,9990721312', 2, 50|-|CDEK||90005||https://home.courierexe.ru/90005/calculator||Введите код учетной записи в 3-й параметр, секретный код — в 4-й. Можно оба оставить пустыми для расчета базовых цен.||45491, 90005, hfenJwlasiPr4pnFENpaVXSKPIn5Trh7i, 9vkQgWuiZgEj9fGCB8a6Xj3desnJkwsl, 5, 30%|-|КСЭ||90008||https://home.courierexe.ru/90008/calculator||Введите логин в 3-й параметр, пароль — в 4-й. Пустыми оставить нельзя.||12504, 90008, Рога и копыта, 4CCB11864D06157, '2, 3, 6', 10%|-|ПОЧТА РОССИИ||90010||https://home.courierexe.ru/90010/calculator||<!--Введите "логин отправки" в 3-й параметр, а в 4-й в одинарных кавычках через запятую пароль отправки и токен. Пустыми оставлять нельзя, т.к. интеграция с Почтой пока не позволяет рассчитывать цены без договора (авторизации).-->Пока поддерживаются только базовые тарифы, без авторизации.||10497, 90010,,, '2, 1', 10 <!--10497, 90010, 89251234567, 'mypassword,u23B0r9AAJ1Fyh4ptMzJ3kjxcslamwdx', '2, 1', 10-->|-|rowspan="2"|ДПД||rowspan="2"|90011||rowspanСДЭК==="2"|https://home.courierexe.ru/90011/calculator||Введите клиентский номер в 3-й параметр, клиентский ключ в 4-й. Можно оставить пустыми для базовых тарифов.||12504, 90011, 1019003662, '4CCB11864D06157A5934A9119F2A0AAAAAB4CCE8,D117', '3, 6', 10%|-||Если вы доставляете товар в пункт отправления самостоятельно, после пароля добавьте запятую и код ПВЗ, а в настройке режима срочности введите пароль в кавычках.||'4CCB11864D06157A5934A9119F2A0AAAAAB4CCE8,D117'|-|ДОСТАВКА ГУРУ||90017||https://home.courierexe.ru/90017/calculator||3-й параметр — ID партнера в системе DOSTAVKA.guru, 4-й — ключ доступа. Можно оставить пустыми.||10497, 90017, 9999, cc03e747a6afbbcbf8be7668acfebee5, '1', 100|-|5Пост||90020||https://home.courierexe.ru/90020/calculator||3-й параметр — API-ключ, 4-й — уникальный номер партнера в системе 5post. При необходимости в 4-м параметре можно через запятую указать пороговое значение веса (по умолчанию 3 кг). Пустыми оставить нельзя.||10497, 90020, u23B0r9AAJ1Fyh4ptMzJ3kjxcslamwdx, 1, 100|}
При выборе клиентом в личном кабинете вида срочностиКомпания СДЭК прекращает поддержку API версии 1.5 с 01.01.2022. По информации от службы поддержки, подключенного таким образом к партнеруинтеграция не будет резко отключена, набор доступных ПВЗ но поддержка будет ограничен выбранным партнеромосуществляться только для версии API СДЭК 2.0
При отправке заказа по интеграции с подключенным видом срочности Для перехода на новую версию создана интеграция постарается отправить заказ одним из режимов, введенных в пСДЭК 2.6 (по порядку, в порядке приоритетов), а если не получится — вернет ошибку0.
Также можно для любой компании войти в личный кабинет по адресу вида https://home.courierexeЧтобы настроить интеграцию с платформой СДЭК версии 2.ru/90005 0, где в конце — экстра-код партнера, авторизоваться данными из 3-го и 4-го параметров (см. таблицу выше) и воспользоваться калькулятором с тарифами именно вашей компаниизаполните следующие поля:* '''ID клиента'''* '''Ключ клиента '''* '''Код пункта приема '''Это обязательные поля.
Остальные поля служат для более тонкой настройки создания заказов:* '''Передавать объявленную ценность'''. Значение по умолчанию '''Да''', вы можете изменить это, выбрав одно из значений:** "Да"<br><span style="padding-left: 5px;">Оценочная стоимость формируется по принципу наибольшего значения.</span><br><span style="padding-left: 5px;">Учитываются Оценочная стоимость всего заказа, Оценочная стоимость товарных вложений, цена товарных вложений.</span><br>** "Нет"<br><span style= Интеграция с клиентами (получение заказов) "padding-left: 5px;">объявленная ценность товарных вложений передаваться не будет</span><br>** "Передавать, если указана"<br><span style="padding-left: 5px;">Учитываются только суммы из полей Оценочная стоимость заказа и Оценочная стоимость товарных вложений, где в приоритете Оценочная стоимость заказа.</span>** "Передавать, по местам, если указана"<br><span style="padding-left: 5px;">Оценочная стоимость заказа распределяется по вложениям. Вложения в свою очередь распределяются по местам.</span>* '''Добавлять услугу «Осмотр вложений»'''. Тарифицируемая услуга от СДЭК, поэтому она добавится, только если в настройках указано '''Да''';* '''Процент за наложенный платеж'''. Используется при получении агентской цены. Калькулятор API CDEK не включает в расчет сумму за наложенный платеж автоматически, но мы добавим указанный вами процент в итоговую сумму;* '''Использовать как номер'''. Номер заказа отображается в личном кабинете и отчетах СДЭК. Выберите удобный вариант: '''Шифр''' или '''Штрихкод''';* '''Код курьера'''. Укажите код курьера, который будет указан в поле '''Вручил курьер''' для доставленных заказов.* '''Способ доставки до ПВЗ отправления'''** "Самопривоз в офис СДЭК" - установлено по умолчанию, необходимо заполнить <b>Код пункта приема</b>** "Забор со склада" - в заказе указывается адрес склада с которого курьеры СДЭК забирают отправления. Адрес указывается в карточке ответственного филиала для которого настраивается интеграция со СДЭК вер.2.0** "Забор у отправителя" - в заказе указывается адрес отправителя с которого курьеры СДЭК забирают заказы.*** <i>Адрес из карточки клиента владельца фирмы отправителя</i> - если в ответственном филиале интеграции настроено "Скрывать отправителя"*** <i>Адрес отправителя из карточки заказа</i> - если он не пустой*** <i>Адрес из карточки отдела</i> - если пустой адрес отправителя в заказе*** <i>Адрес из карточки клиента отправившего заказ</i> - если пустой адрес отдела
=== Замечания ===
<div style="color: #a94442; background-color: #f2dede; border: 1px solid # В модулях систем '''PrestaShop''' и '''Joomla''' для отправки заказа в курьерскую службу зайдите в карточку заказа. В карточке отображается специальная форма отправки заказа, а если заказ отправлен, она позволяет проверить его статус. [[Файлebccd1; padding:Form3px 10px 10px;">* Интеграция СДЭК версии 2.png|400 px|Форма отправки 0 не предусматривает автоматическую отправку заказа|none]]# Оформление заказов до '''ПВЗ''' в модулях '''PrestaShop''' и '''Joomla''' не реализованопосле получения ошибки. Чтобы оформить такой отправить заказповторно после исправления, обратитесь в поле передаваемого адреса укажите одно из значений:техподдержку MeaSoft.#* код ПВЗ, который можно посмотреть в ЛК клиента или Интеграция не предусматривает проверку номеров телефонов передаваемых заказов на сайте агента (Boxberry, CDEK и тсоответствие стране.пapi СДЭК проверяет номера телефонов на соответствие списку стран после отправки заказа.). Обычно это цифровой или цифро-буквенный код;#* наименование ПВЗ, добавив Список стран номера телефонов которых принимаются без ограничений опубликованы в начале строку "ПВЗ ", например '''ПВЗ На Ленина'''.# Поддерживается передача маркировки [[Маркировка|«Честный ЗНАК»]] из InSales и RetailCRM. Информацию по настройке см. в документации [https://wwwapi-docs.insalescdek.ru/collection/doc-zprochee/product/prodazha-tovarov-s-markirovkoy-487-fz Insales29923926.html документации СДЭК] и [https:/</help.retailcrm.ru/Users/MarkingOfGoods RetailCRM].div>
=== OpenCart ===При выборе тарифа для отправки заказа приоритет отдается тарифам режима срочности, выбранного в заказе. Если в режиме срочности не настроены тарифы, то тариф выбирается из списка в параметре интеграции '''Приоритет тарифов'''. В этом случае отправка в СДЭК осуществляется первым доступным тарифом из списка.
==== 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При весе отправления больше 30 кг применяется тариф «Магистральный экспресс».0 и выше ====
===== Настройка интеграции =====Чтобы передать услугу «Примерка», установите флажок '''Принято на склад''' в [[Единица корреспонденции#Создание единицы корреспонденции|карточке корреспонденции]]. Если услуга не нужна, снимите флажок.
# Скачайте [[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''' и нажмите на кнопку '''Установить'''. Рядом станет активна кнопка '''Редактировать'''. # Нажмите на кнопку '''Редактировать''' и в поле '''Тариф для расчета стоимости доставки''' выберите нужный тариф. По умолчанию используется первое значение выпадающего спискавалюте страны назначения.
===== Изменение данных заказа =====В общем случае интеграция не поддерживает отправки в другие страны, кроме России.
# В административной части сайта откройте заказ и вверху справа нажмите на кнопку [http://courierexe.ru/download/userfunc/SDEK_report_load.xml Загрузка отчета СДЭК] создает входящий АПД по отчету СДЭК [Файлhttp:OpenCartEdit//courierexe.ru/download/userfunc/SDEK_report_demo.png|25 px]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>При выборе тарифа для отправки заказа приоритет отдается тарифам режима срочности, выбранного в заказе.
* Ошибка локализации. Чтобы переключить язык сайта на русский, сверьте названия папок локализации в скачанном архиве модуля (\upload\admin\language) и в созданном после установки модуля каталоге. Названия папок должны быть одинаковыми, например ru-ru и en-gb. Если в результате установки появилась папка Для настройки интеграции с другим именем, перенесите ее содержимое в нужную папку.* При возникновении ошибокплатформой DPD укажите следующие параметры:*# В панели управления выберите '''Менеджер дополненийКлиентский номер''' (- уникальный клиентский номер в системе DPD.* '''МодификаторыКлиентский ключ''') и в правом верхнем углу страницы нажмите на кнопку - ключ для авторизации, полученный у сотрудника DPD.* '''ОбновитьКод пункта самопривоза'''- не обязательный параметр.*# Очистите кэш везде — в панели состояниякод пункта самовывоза, в дополнительных модулях, в браузере и т.пкуда клиент DPD доставляет заказ для отправки.*# Проверьте работу модуля'''Номер регулярного заказа''' - номер регулярного заказа DPD. Если вы используете доставку на регулярной основе, уточните этот номер у своего менеджера.*: Для OpenCart 3'''Проверка комплектности''' - по умолчанию отсутствует.0 и выше с установленным модулем Simple установите [httpsЕсть возможность выбрать одно из значений://courierexe.ru/download/api/liveopencart.modtwigfix30356.ocmod.zip| модификатор] и выполните шаги 1-3.
<ul><ol><span style=== 1C"color: blue; margin-Битрикс===Чтобы настроить интеграциюright:# В личном кабинете 1C-Битрикс на вкладке '''Администрирование''' в панели слева выберите '''Marketplace''' 10px;"> '''Каталог решений''' и на странице «Каталог Маркетплейс» с помощью строки поиска найдите '''Модуль интеграции MEASoft'''.# Щелкните по ссылке «Установить».# Убедитесь, что в строке '''Модуль интеграции MEASoft''' установлен флажок, и нажмите на кнопку '''Загрузить'''. Далее примите лицензионное соглашение и нажмите '''Применить'''.# После окончания загрузки нажмите на кнопку '''Установить'''.# В панели слева выберите '''Магазин''' ○</span> '''Настройки''' Отсутствует</ol> '''Службы доставки''', затем на странице «Список служб доставок» раскройте выпадающий список кнопки '''Добавить''' и выберите пункт '''Автоматизированная служба доставки'''. Откроется страница «Новая служба доставки».# На странице «Новая служба доставки» перейдите на вкладку '''Настройки обработчика''' и в выпадающем списке '''Служба доставки''' выберите '''"Курьерская служба<ol><span style=" color: blue; margin- сервис доставки'''. Нажмите на кнопку '''Применить'''.# Перейдите на вкладку '''Настройки интеграции'''right: [[Файл:Bitrix Настройки интеграции.png|none|1100px]]10px;">○</span>С примеркой</ol>#<ol><span style="color: На этой вкладкеblue; margin-right:#* в разделе '''Настройка доступа''' введите учетные данные личного кабинета в поля '''Логин''', '''Пароль''' и '''Код клиента'''. Запросите эти данные у курьерской службы, с которой настраивается интеграция. Поле '''Код клиента ПВЗ''' оставляем пустым (оно заполнится автоматически позднее).#* в разделе '''Основные настройки''':#** в поле '''Статус отправки заказа''' выберите статус, при котором заказ будет отправляться в курьерскую службу10px;#** в поле '''Оплата картой''' выберите тип оплаты, который будет соответствовать оплате картой (если оплата картой возможна);#** установите флажок '''Использовать артикулы''', если артикулы будут использоваться для привязки номенклатуры к складу курьерской службы;#* в разделе '''Соответствующие поля покупателя''' настройте соответствие полей получателя (ФИО, города, адреса и др.) полям в форме создания заказа.# На вкладке '''Ценовая политика доставки''' при необходимости настройте стоимость доставки для покупателя в зависимости от стоимости заказа.# На вкладке '''Ограничения''' при необходимости укажите ограничения работы модуля по географии, типам оплаты и т.п.# По завершении настройки нажмите на кнопку '''Сохранить'''.# В настройках магазина укажите его местоположение для определения города отправителя.#: Если нужно производить расчет для другого города отправителя (например, физически магазин находится в области, а курьерская служба должна считать доставку, как по городу):#* в разделе '''Рабочий стол''' "> '''Настройки''' ○</span> '''Настройки продукта''' Простая</ol> '''Настройки модулей''' <ol> '''Курьерская служба''' в поле '''Города<span style="color: blue; margin-отправители''' добавьте город отправителяright: 10px;#* в разделе '''Рабочий стол''' "> '''Магазин''' ○</span> '''Настройки''' С проверкой работоспособности</ol> '''Службы доставки''' > Нужная служба > '''Настройки интеграции''' </ul> '''Город отправитель''' укажите добавленный выше город.
Чтобы отправить заказ в курьерскую службу, зайдите в карточку заказа, укажите настроенное значение в поле '''Статус отправки заказа''' и нажмите на кнопку '''Сохранить'''.=== TopDelivery ===
Для настройки интеграции с платформой TopDelivery укажите:* '''ПримечаниеЛогин'''. Значения полей * '''Пароль'''* '''Комментарий покупателя к заказуИнформация о поставщике товара''' и . Если указано '''Комментарий менеджераОтправлять''' передаются из 1С-Битрикс , то при отправке заказа будет предпринята попытка отправить место с габаритами и товарами с указанием данных поставщика: ИНН, наименование, номер телефона. Если данных поставщика нет, информация об ошибке отправки мест будет добавлена в поле сообщение к заказу. Информация о поставщике повторно не отправляется.* '''КомментарийВскрытие отправления до получения оплаты''' - по умолчанию разрешено.<br>Возможность запрета вскрытия отправления добавляется при отправке заказа , если в настройках интеграции разрешен запрет и в системе MeaSoft.заказе стоит отметка "Принято на склад"
Если статус уже установлен, но заказ не отправлен в курьерскую службу (связано с техническими особенностями):[[Файлы для загрузки# Выберите статус заказа по умолчанию после его создания (например, '''Новый''').# Перезагрузите страницу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]]
Для предоплаченных заказов === Почта России ===Интеграция с Почтой России описана в карточке корреспонденции отображается сумма к оплате 0, при наличии товарных вложений добавляется вложение «Предоплата» разделе [[%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 выделил вам диапазон трекинг-номеров, то необходимо настроить филиал и придерживаться последовательности отправки [[Манифесты#Отправка|манифестов]].
<spoiler text="Если возникает ошибка"># Если не рассчитывается стоимость:#* некорректно установлен модуль;#* введены некорректные учетные данные;#* в курьерской службе не настроен тариф. Обратитесь в курьерскую службу Чтобы настроить филиал для настройки тарифа. После настройки тарифы можно проверить в личном кабинетеинтеграции PickPoint с диапазоном, на вкладке '''Калькулятор'''.# По умолчанию при оформлении заказа должны появиться поля даты и времени желаемой доставки. Если они отсутствуют, то у формы были изменены стили. Также возможно обновление формы в системе Битрикс.[[Файл:Bitrix2.png|center|700 px]]# Проверьте правильность привязки свойств. Для этого в разделе основном меню выберите '''Рабочий столСправочники''' > '''МагазинМежгород''' > '''НастройкиФилиалы''' > , откройте карточку [[Филиалы|филиала]] и на вкладке '''Свойства заказаИнтеграция''' > в выпадающем списке '''Список свойствПравила назначения кода заказа у подрядчика''' найдите свойство, связанное с ошибкой, щелкните по нему правой кнопкой мыши и выберите '''Изменить параметры свойстваИз диапазона'''.<br>На вкладке Укажите начальный и конечные коды диапазона, префикс при необходимости и нажмите клавишу '''Привязка свойстваОК''' настраиваются условия, при которых поле будет показываться клиенту. Если у свойства заказа настроена привязка, то оно будет показываться ТОЛЬКО в том случае, когда покупатель выберет хотя бы один из указанных критериев:[[Файл:Битрикс Связь свойства.png|center|500px]]
В этом примере покупатель при оформлении заказа увидит созданное поле для заполнения только Для отправки манифестов добавьте заказы в том случаеманифест, если затем на предыдущих шагах он выбрал оплату вкладке '''Наличными курьеруМанифесты''' (при любой службе доставки), или же если захотел расплатиться любым способом, но выбрал отсканируйте заказы в мешок и выберите в карточке манифеста ранее настроенный филиал. После этого в качестве службы доставки контекстном меню манифеста выберите '''Воздушный транспортПроставить коды у подрядчика'''.
Свойство будет показано всегда, если привязка не выбрана или если выбраны все варианты платежных систем или служб доставкиПосле этого можно указать дату отправки манифеста.
Подробнее смОбратите внимание, что проставить коды с указанной датой отправки манифеста нельзя. [https://devНеобходимо сначала очистить дату отправки, а затем проставить коды.1c-bitrix.ru/learning/course/index.php?COURSE_ID=42&LESSON_ID=3073&LESSON_PATH=3912.4580.4828.3073 документацию 1С-Битрикс].</spoiler>
=== InSales ===Для удобства работы до настройки интеграции создайте в InSales следующие пользовательские статусы:* статус для автоматической передачи заказов в курьерскую службу,* статус для обозначения заказа с ошибкой передачи данных.Чтобы настроить статусы, в панели администрирования InSales выберите '''Настройки''' > '''Оформление заказа''' > '''Пользовательские статусы''' и создайте статусыАгентская цена интеграцией не возвращается, например «Передано так как эти данные отсутствуют в КС» и «Ошибка»API PickPoint.
Чтобы настроить интеграцию:=== КСЭ ===# В личном кабинете InSales откройте '''Приложения''' > '''Центр приложений''', с помощью строки поиска найдите модуль «Курьерская служба 2008» Для обращения к функциям системы необходимо знать своё имя пользователя и нажмите на кнопку '''Установить'''.# Откроется личный кабинет InSales. На странице «Установка приложения» нажмите на кнопку '''Установить'''.# В списке установленных приложений выберите «Модуль "Курьерская служба 2008"». Откроется страница авторизации личного кабинета клиента курьерской службы. Если вы авторизованы пароль в ЛК курьерской службы, то сразу откроется страница настроек, см. п. 5.# Введите учетные данные личного кабинета в поля '''Логин''', '''Пароль''' и '''Код курьерской службы'''. Запросите эти данные у курьерской службы, с которой настраивается интеграция.# На странице «Настройка интеграции "Insales"» выполните настройку интеграциисистеме КСЭ.<br>Особенности заполнения полей:#* '''Отправлять заказы в курьерскую службу автоматически после изменения статуса'''. Используется для автоматической передачи заказов с определенным статусом в курьерскую службу. Возможные значения: '''Да'''Если у вас еще нет доступа, '''Нет'''.#* '''Статус отправления заказа в курьерскую службу (если отправляется автоматически)'''. Выберите из выпадающего списка заранее созданный статус, который будет использоваться для автоматической передачи заказов в курьерскую службу.#* '''Отправлять статус заказа в Insales'''. Определяет, отправляется ли статус успешной доставки заказа в InSales. Возможные значения: '''Да''', '''Нет'''.#* '''Отправлять артикулы (для привязки то необходимо обратится к складу)'''. Если опция включена, артикулы товаров из InSales передаются Вашему менеджеру в MeaSoftподразделение клиентского сервиса КСЭ. #* '''Название доставки курьером на странице заказа'''. Укажите название доставки, которое будет отображаться в заказе вместо «Курьерская доставка МЕАСОФТ» при выборе способа доставки. Можно оставить поле пустым, тогда список будет выглядеть следующим образом:[[Файл:Insales Delivery.png|none|800 px]]#* '''Описание доставки курьером на странице заказа'''. Укажите описание вида доставки. Можно оставить поле пустым.#* '''Переводить заказ в специальный статус в случае ошибки передачи заказа?'''. Определяет, используется ли специальный статус для обозначения заказов с ошибкой передачи данных. Возможные значения: '''Да''', '''Нет'''.#* '''Синхронизировать остатки по складам'''. Если опция включена, данные по складским остаткам из курьерской службы передаются в InSales.#* '''Используется мультисклад?'''. Определяет, используется ли выбор товаров с одного склада или из нескольких. Возможные значения: '''Да''', '''Нет'''. В случае работы с несколькими складами убедитесь, что в настройках InSales ('''Настройки''' <br> '''Настройки магазина''' > '''Мультисклад'''.) указано такое же количество складов, как в системе MeaSoft.#* '''Специальный статус на случай ошибки передачи заказа'''. Выберите из выпадающего списка заранее созданный статус, который будет использоваться для обозначения заказов с ошибкой передачи данных.# По заполнении нужных полей нажмите '''Сохранить'''.
В результате в InSales в окне создания заказа появляется блок «Модуль "Курьерская служба 2008"»:::[[Файл:Insales Module KS.png|none|400 px]]Тип оплаты заказа определяется следующим образом<b>Настройки интеграции:</b><br>* если заказ оплачен, то передается тип оплаты '''ОплаченЛогин''';- логин от ЛК КСЭ* если тип оплаты '''Оплата банковской картойПароль''' или - пароль от ЛК КСЭ* '''Оплата банковской картой курьеруДанные отправителя''' — данные, которые будут подставляться во все отправления, передаваемые в КСЭ. Если не указать, то передается тип оплаты будут передаваться данные заказчика (отправителя) из корреспонденции.* '''Банковская картаЯвляется ИМ''' — признак отправителя в системе КСЭ. Указанные типы оплаты необходимо создать От данного признака зависит главным образом, как отправляются данные в InSales вручную: '''Настройки''' > '''Оформление заказа''' > '''Оплата''';КСЭ. Признак указывается в договоре клиента с КСЭ.* иначе передается тип оплаты '''НаличнымиЗабор''' — настройка, в которой можно указать, каким образом отправление передается в КСЭ — КСЭ забирает отправление у клиента или клиент сам привозит отправление в КСЭ.В системе MeaSoft в карточке интернет-магазина есть флажок ** '''Спрашивать тип оплаты у получателяПо умолчанию''' — груз будет принят для доставки в офисе (самопривоз в КСЭ) для всех заказов с товарной составляющей, иначе будет послан курьер для забора. Если он установлен, то независимо от переданного типа оплаты ** '''НаличнымиДо двери''' или  — будет послан курьер для забора** '''Банковская картаСамопривоз в КСЭ''' покупателю  — груз будет предложен выбор способа оплаты.принят для доставки в офисе
Настройки интеграции можно изменить При выборе тарифа для отправки заказа приоритет отдается тарифам режима срочности, выбранного в разделе '''Автоматизация''' [[Личный кабинет клиента#Автоматизация|личного кабинета MeaSoft]]заказе.
<!--=== RetailCRM DOSTAVKA.GURU ===
Чтобы настроить интеграцию:# В RetailСRM cоздайте API-ключ. Для этого откройте '''Администрирование''' > '''Интеграция''' > '''Ключи доступа к API''' и нажмите на кнопку '''ДобавитьНастройка'''. Откроется страница «Новый ключ API». На этой страницеДля интеграции введите следующие учетные данные:## В поле * '''КомментарийИдентификатор клиента''' введите краткое описание интеграции, например «По городу»— ID клиента DOSTAVKA.## В поле '''Тип доступа''' выберите '''Доступ ко всем магазинам'''GURU.## В списке '''Разрешенные методы API''' установите все флажкиID клиента отображается вверху страницы личного кабинета клиента DOSTAVKA.GURU;## Нажмите на кнопку * '''СохранитьКлюч клиента'''.#: — запросите API-ключей может быть несколько, и для каждого API-ключа необходимо выполнить эти настройки. Подробнее об управлении API-ключами см. [https://helpключ интеграции у DOSTAVKA.retailcrmGURU.ru/Users/ApiKeys документацию RetailCRM].# Настройте интеграцию в [[Личный кабинет клиента#Интеграция|личном кабинете клиента MeaSoft]]:## Выберите пункт основного меню * '''АвтоматизацияРегион откуда повезется заказ''', перейдите на вкладку '''Обратная интеграция''' и на странице «Список всех обратных интеграций» в строке RetailCRM нажмите '''Добавить'''. - Доступен выбор из трех вариантов:<ul>## В окне «Настройка интеграции <ol><span style="RetailCRM"» укажите название интеграции, домен RetailCRM, созданный выше APIcolor: blue; margin-ключ. При необходимости укажите значения других полей.#right: Если нужно10px;">○</span> По договору (В этом случае, чтобы мы не сообщаем о регионе отправки в RetailCRM отображался статус платежа после доставки заказа, заполните поле '''Получать статус платежа (укажите символьный код статуса платежасистему Guru и регион определяется договором с DOSTAVKA.GURU)'''. Чтобы увидеть символьный код платежа, в RetailCRM выберите '''Администрирование''' </ol> '''Справочники''' <ol> '''Статусы оплат'''.#<span style="color: По завершении настройки нажмите '''Сохранить'''.# Настройте интеграцию в RetailCRMblue; margin-right:10px;">○</span> Москва</ol>## Откройте '''Администрирование''' <ol> '''Справочники''' и на вкладке '''Типы доставок''' нажмите на кнопку '''Добавить'''. Откроется окно «Новая доставка»<span style="color:[[Файлblue; margin-right:Retail1.png|none|700 px|]]## В этом окне заполните обязательные поля и в выпадающем списке '''Интегрировать с''' выберите значение '''10px;"Курьерская служба 2008"''', затем нажмите '''Сохранить'''.>○</span> Санкт-Петербург</ol>## Чтобы настроить корректную передачу наложенного платежа, откройте '''Администрирование''' </ul> '''Интеграция''' и выберите модуль MEASOFT. Затем на странице «Настройки интеграции с Курьерская служба 2008» перейдите на вкладку '''Доставка''' и на панели справа выберите пункт '''Способы оплаты'''. Установите флажки для способов оплаты, которые могут использоваться для передачи наложенного платежа.[[Файл:Retail5.png|none|600 px]]
Чтобы проверить настройки интеграции:# Перейдите в форму создания заказа и убедитесь, что в списке '''Способ доставкиЗапрещенные символы''' появилось соответствующее значение:[[Файл:Retail2.png|none|600 px]]# Нажмите '''Выбрать тариф'''Перед отправкой номер заказа и имя получателя проверяются на наличие запрещенных символов. Если обнаружены запрещенные символы, заказ не отправляется в интеграцию и получает ошибку. Тарифы должны передаваться из настроек курьерской службы:[[Файл:Retail3Из других текстовых полей запрещенные символы удаляются.png|none|600 px]]<br>В случае Это не приводит к получению ошибки обратитесь в курьерскую службу для настройки тарифов. Проверить тарифы можно в ЛК в разделе '''Калькулятор'''При проверке имени получателя и других текстовых полей используется сокращенный список запрещенных символов.
Чтобы в RetailCRM формировать печатные формыСокращенный список недопустимых символов для текстовых полей:<code>['~', '`', '@', '#', '$', '%', аналогичные формам в личном кабинете'^', '&', используйте один из следующих способов:* в сохраненном заказе на панели действий сверху нажмите '=', 'Печать+', '!' и выберите нужную печатную форму «Курьерская служба»;* в списке заказов отметьте заказы флажками, внизу страницы нажмите '"', 'Действия', ';' > , ':', 'Распечатать документы?', '\' и выберите печатную форму «Курьерская служба».]</code>
Чтобы отправлять заказы в курьерскую службу по статусам и отменять при изменении типа доставкиПолный список недопустимых символов:<code>['~', '`', '@', '#', '$', '%', '^', '&', '=', '+', '!', '"', '№', ';', ':', используйте триггеры'?', '\', '\s', '*', '(', '_', '{', '}', '. Подробнее о настройке триггеров см. в разделе «', ',', '\[[Настройка триггеров для RetailCRM', '\]', '\']».</code>
'''Примечание'''. Интеграция привязана к личному кабинету клиента курьерской службы. При необходимости работать из другого личного кабинета создайте новую интеграциюКроме того, начиная с пункта настройки в личном кабинетедля штрихкодов недопустима кириллица.
=== cs'''Статусы'''. Запрашиваются интеграцией в автоматическом режиме. Изменение статуса на стороне Guru изменит и статус заказа в соответствии с картой статусов.cart ===
Чтобы настроить интеграцию:'''Агентская цена'''. Обновляется при получении статусов. Агентская цена Guru публикуется в разрезе стоимости услуг и тарифов, которые суммируются перед обновлением агентской цены в заказе.
# Скачайте архив модуля установки по [http://courierexe.ru/download/api/ms_courierexe-v1.1.1.zip ссылке].# В панели администратора cs.cart откройте '''Модули''' > Возвраты'''Управление модулями''' и на странице «Модули» нажмите на кнопку [[Файл:Cscart добавить.png|25 px]]. Откроется окно «Загрузить и установить модуль».# В этом окне нажмите на кнопку '''Загрузить''', выберите архив с модулем на компьютере и нажмите на кнопку Учитываются только при получении заказом статуса '''Загрузить и установитьЧастичная доставка'''. Модуль «Курьерская служба 2008» появится в списке модулей.# Откройте '''Администрирование''' > '''Доставка и налоги''' --> '''Способы доставки''' и нажмите на кнопку [[Файл:Cscart добавить.png|25 px]]. Откроется окно «Новый метод доставки»:#:<br>[[Файл:Cscart настройка.png|900px|none]]=== 5POST ===#:# В этом окне укажите следующие Параметры для настройки:#* в поле '''Расчет тарифаAPI-ключ''' установите переключатель * '''В режиме реального времениКод склада отправителя''';#* в выпадающем списке '''Перевозчик''' выберите значение Уникальный номер партнера в системе 5Post'''КС2008''';#* в выпадающем списке '''Служба доставкиМаксимальный вес для фиксированного тарифа''' выберите режим срочности по - При привышении установленного веса, сумма тарифа изменяется пропорционально. По умолчанию;3кг.#* заполните остальные поля.# Нажмите на кнопку '''Создать'''. Появляется оповещение о том, что изменения сохранены, и Код подрядчика в этом же окне появляются кнопки настройки. Нажмите на кнопку '''Настроитькарточке заказа'''- доступно три вида отображения кода подрядчика:#<ul><ol><span style="color: blue; margin-right:10px;">○</span> Оригинальный код 5post - Установлено по умолчанию</ol><brol>[[Файл<span style="color:Cscart курьером.png|800 px|none]]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>
Чтобы создать два способа доставки — * '''Курьером до двериТип расчета тарифа''' и '''ПВЗ''', повторите все шаги, начиная с п. 4.<ul><ol><span style="color: blue; margin-right: 10px;">○</span> Общий - Установлено по умолчанию</ol><ol><span style="color: blue; margin-right: 10px;">○</span> По местам</ol></ul>
В результате новые способы доставки будут отображаться в списке '''Администрирование''' > '''=== Яндекс.Доставка и налоги''' > '''Способы доставки''' и в окне создания заказа:===
::Для подключения к интеграции в вашем договоре с Яндекс.Доставкой должна быть подключена услуга доставки на следующий день. Если у вас эта услуга не подключена, заполните [[Файлhttps:Cscart оформить заказ//forms.png|700 px|none]yandex.ru/surveys/10833592.0f3ead3120074ee64cd9dde1df70b27d8d2678d2/ эту форму].
Чтобы просмотреть полученные заказы, откройте Для настройки интеграции с платформой Яндекс.Доставка укажите следующие параметры:*'''ЗаказыТокен''' > , можно посмотреть тут https://dostavka.yandex.ru/account/integration*'''Полученные заказыID пункта отправления'''. В карточке заказа , необходимо уточнить у вашего менеджера или в правом нижнем углу находится блок модуля «Курьерская служба 2008»: поддержке яндекса
::[[Файл:Cscart блок ксЭти параметры обязательные и влияют на отправку заказа. Доступы должны быть НЕ тестовые (продовые). Уточните эти данные у вашего менеджера или в поддержке Яндекс.Доставки.png]]
Чтобы передать заказ в курьерскую службу, нажмите на ссылку '''Отгрузить'''.Для настройки модулей используйте
Также в этом блоке вы можете проверить статус доставки заказа'''Логин''' - ваш токен.
=== amoCRM ==='''Пароль''' - Код пункта отправления. Имеет вот такой формат 4eccdad3-8d97-4fbf-b241-3c2a89a8aa79
Интеграция реализована через виджет «Курьерская служба 2008», предназначенный для передачи заказов из amoCRM в MeaSoft и возврата статусов'''Код курьерской службы''' - 90023.
Чтобы начать отправлять заказы в курьерскую службу, настройте интеграцию с MeaSoft и сопоставьте поля amoCRM и виджета для корректной передачи данных в MeaSoft.
==== Настройка интеграции ====Для удобства работы перед настройкой интеграции добавьте дополнительные поля в сделке: выберите '''Сделки''' > '''Новая сделка''' и При создании заказа обратите внимание на вкладке '''Настроить''' добавьте в любую группу новые поля '''Стоимость доставки'''адрес — он должен быть понятным. Наиболее понятным для Яндекса будет адрес, '''Стоимость товаров'''где нет дополнительных комментариев, '''Закупка'''а части адреса разделены запятыми.
[[Файл:Amo SettingsВ интеграцию не принимаются заказы на юридические лица. Т.е. в поле ФИО должно быть именно ФИО, а не название организации.png|none|500 px]]
Чтобы настроить интеграцию с amoCRM:# Этот этап можно делать из [[Личный кабинет клиента#Интеграция|личного кабинета MeaSoft]] '''ИЛИ''' из административной части amoCRM:#* В личном кабинете MeaSoft:#*# В разделе '''Автоматизация''' перейдите на вкладку '''Обратная интеграция''' и в таблице «Список всех обратных интеграций» в строке «AmoCRM» нажмите '''Добавить'''Отправка заказов происходит автоматически.#*#Укажите название интеграции Если адрес не распознан и префикс и нажмите на кнопку '''Сохранить'''.#*#Укажите аккаунт amoCRMзаказ не отправлен с первой попытки, в котором будет установлен виджет «Курьерская служба 2008» интеграция попытается разобрать адрес доступными ей средствами и нажмите '''Разрешить'''снова отправить заказ. Виджет установлен.#* В административной части amoCRM:#*# В меню выберите '''Настройки''' > '''Интеграции''' Если заказ так и в строке поиска введите «Курьерская служба 2008».#*#Щелкните по найденному модулюне получилось отправить, нажмите на кнопку '''Установить'''. Виджет установлен.# В amoCRM выберите '''Настройки''' > '''Интеграции''' и в разделе '''Установленные интеграции''' откройте «Курьерская служба 2008».# Введите логинпроверьте адрес получателя, пароль и код курьерской службы. Запросите эти данные у курьерской службывозможно, с которой настраивается интеграция.# Нажмите на кнопку '''Настройки виджета'''. В окне «Настройки интеграции с Курьерская служба 2008»:## Установите параметры товаров и доставки.## Установите поля для сохранения данных заказа. Например, в выпадающем списке поля '''Сохранять стоимость товаров в отдельное поле''' укажите значение '''Сохранять в поле: Стоимость товаров'''.## Укажите, откуда будут добавляться товары к заказу. Если это список в amoCRM, настройте соответствие полей. Списки amoCRM доступны начиная с тарифного плана «Расширенный».## Установите соответствие между статусами в личном кабинете клиента курьерской службы и статусами amoCRM.## Нажмите '''Сохранить настройки'''нем допущена ошибка.# В окне ввода учетных данных интеграции нажмите '''Сохранить'''После исправления адреса заказ отправится автоматически.
==== Сопоставление полей ===={|class="wikitable"!Поле виджета!Данные amoCRM!Где настраивается сопоставление|-|'''Имя''', '''Телефон'''||Поля карточки контакта||-|-|'''Номер При отправке заказа'''||• Название сделки;<br>• ID сделки;<br>• пользовательское поле||'''Настройки виджета''' > '''Настройки интеграции обязательно указываются места с Курьерская служба 2008'''|-|'''Город'''габаритами и массой. Если в заказе указаны места, '''Адрес'''они добавляются как есть. Если мест в заказе нет, '''Индекс'''то создается одно фиктивное место, '''Примечание''', '''Дата доставки'''|| Поля сделки|| '''Настройки виджета''' > '''Настройки интеграции с Курьерская служба 2008'''|-|'''Вес''', '''Сумма''', '''Объявленная ценность''', название габариты которого формируются на основе габаритов вложений. Вложения не разделяются по местам и количество товара||Карточка товара||• Если товар добавляется вручную или из каталога Курьерской службы 2008, сопоставление не требуется;<br>• если товар добавляется из списка amoCRM, настройте сопоставление в '''Настройки виджета''' > '''Настройка товаров'''|-|'''Количество мест'''|| - ||Заполняется попадают в виджете вручную|}первое сформированное место.
===Беру===При После настройки модуля или создания новой интеграции поддерживается:* Обработка координатПВЗ появляются на следующий день.
===Мой СкладЛ-Пост ===Интеграция предназначена для передачи заказов Для настройки интеграции с товарными вложимыми из системы "Мой платформой Л-Пост укажите следующие параметры:*'''Секретный ключ клиента''',*'''Код пункта приема''' - Не обязательный параметр. Заполнять параметр не нужно, если отправления сдаются на центральный склад" в систему "Курьерская служба 2008"Л-Пост (Родники, ул.Трудовая, д.10) или забираются со склада партнера силами Л-Пост . <br> В обратную сторону будут приходить статусыдругих случаях, стоимость доставки в качестве точки приема отправлений могут выступать пункты выдачи заказов Л-Пост и общая сумма заказа с учетом частичной доставкисклады Л-Пост.
'''Как настроить'''
# Пройти по ссылке https://home.courierexe.ru/moysklad/step1. Ввести логин и пароль от "Моего склада", а также логин, пароль При отправке заказа обязательно указываются места с габаритами и код экстраклиента от курьерской службымассой.# В случае ошибки "Данный пользователь "Мой склад" уже зарегистрирован." необходимо сбросить настройки одноименной кнопкой (появится Если в случае ошибки).# !ВАЖНО! Подождать пока синхронизируются справочники. Не закрывать и не перезагружать страницу. Данный процесс может занять продолжительное время (от 10 минут).# После синхронизации справочниковзаказе указаны места, автоматически произойдет переход на страницу следующего шагаони добавляются как есть.# !ВАЖНО! до выполнения настроек необходимо перейти Если мест в систему МойСклад и создать дополнительные поля в заказах в системе Мой Склад:#* строковые:#** "Город" - для указания населенного пункта получателя#** "Дата доставки" - для указания даты доставки наряду со временем#** "Сумма заказа" - для получения суммы заказа от КС#** "Стоимость доставки" - для получения стоимости доставки от КС#** "Строка для сохранения информации об ошибках" - для получения текста ошибки;#** "Количество мест" - для возможности указания количества мест;#* с типом '''"Файл"''':#** "Файл" - необязательное поле. Создаетсязаказе нет, если хотите передавать файлыто создается одно фиктивное место. Максимальный размер - 1 МБ.#* с типом '''"Справочник"''':#** "Виды срочности" (одноименный справочник),#** "Временные интервалы" (одноименный справочник),#** "Способы доставки" (одноименный справочник),#** "Тип оплаты" (одноименный справочник),#** "Время доставки с" (справочник '''Часы доставки'''),#** "Время доставки Вложения не разделяются по" (справочник '''Часы доставки''').# Перейти к шагу 4, обновить страницу. Вы увидите настройки, где нужно настроить статусы отправки, соответствие полей местам и соответствие статусов.# Сохранить настройки.# !ВАЖНО! Для отправки заказа обязательно должен быть заполнен вес товара (хотя бы одного)попадают в первое сформированное место.
При заполнении информации по заказу поля стоимость доставки, сумма и ошибка заполнять не нужно. Они заполнятся автоматически после синхронизации с курьерской службой.
Поле "Тип доставки" Обратите внимание, что в зависимости от настроек вашего аккаунта в Л- если пустое, значит доставка по адресу. Иначе выбираем ПВЗ из спискаПост может быть недоступна частичная оплата заказа.
Данные из поля "Комментарий" передаются в заказ автоматически.=== Omnic ===Для настройки интеграции с платформой Omnic укажите следующие параметры:
* '''Как отправить заказЛогин'''Переключите статус заказа на статус - создается самостоятельно, служит для передачи в курьерскую службудоступа к [https://home.courierexe. В этот момент "Мой Склад" сообщает нашей системе об этом событии и она забирает заказru/90025 ЛК экстраинтегратора], может быть любым, добавляет главное запомните его в курьерскую службу.Если после сохранения заказа в статусе для передачи в курьерскую службу статус не изменился необходимо проверить поле "ошибка". Необходимо дозаполнить поля указанные в поле "ошибка", очистить поле "ошибка" и сохранить заказ.
* '''Как проверитьПароль'''является составным и обязательно должен содержать токен (получается в службе поддержки омника).
Зайти в Личный кабинет курьерской службы и проверить с помощью вкладки отслеживание существует ли отправленный заказ.Так же может содержать
'''Известные проблемыПВЗ отправления'''- код ПВЗ подрядчика, пункт самопривоза. <i>Не обязательный параметр</i>
!ВАЖНО! Модуль интеграции не работает на бесплатном тарифе!При установке приложения в "Моем Складе" наша система в нем регистрирует <rspoiler text="событие">т.н. веб'''Приоритет тарифов''' -хук</rspoiler>последовательность тарифов подрядчика, на изменение заказаразделенная пробелами, чтобы "Мой Склад" нас извещал об измененияхуказывающая доступность и приоритет тарифов в общем случае. Так работают все модули служб доставки для МС. Проблема в том, что МС поддерживает только одно подобное событие для заказа, поэтому, если оно занято другим <rspoiler text="установленным модулем"i>А иногда бывает, что модуль удалили, или не до конца установили, а зарегистрированное событие от него осталосьНе обязательный параметр</rspoileri>, в этом случае мы не сможем его занять, и отправка заказов, к сожалению, работать не будет. Если у вас не отправляются заказы, и вы уверены, что у вас нет других модулей, использующих это событие, обратитесь к нам в службу поддержки, мы сможем проверить занятость события и при необходимости его освободить.
===Wordpress===<br> ====Требования к сайту перед установкой плагина:====#CMS WordPress версии 5, или более новая.#WooCommerce версии 3.9, или более новая.#PHP версии 7, или более новая.#Сайт должен использовать SSL-сертификатЕсли омник забирает заказы у вас
====Порядок установки плагина и вывод нового способа доставки в корзину:====Пример cf3f645a5afc2e7ae030522711b4464af77dcb2d11997f1ddf5f1de81b003906#В панели администратора вашего сайта откройте страницу “Плагины - Добавить новый” и нажмите на кнопку “Загрузить плагин”#В появившейся форме выберите архив с плагином на вашем компьютере и нажмите кнопку “Установить”#После загрузки и установки плагина вы можете его активировать нажав на соответствующую кнопку #После активации плагина в меню появится ссылка на страницу настроек плагина.Заполните все необходимые поля и нажмите кнопку “Сохранить изменения”.#Откройте настройки WooCommerce и переключите на вкладку “Доставка”#Выберите необходимую зону доставки, или создайте её.#Нажмите на кнопку “Добавить метод доставки” и выберите из списка “КС2008”#После создания заказа, в панели администратора, в форме изменения заказа, справа появится блок модуля "Отправить в курьерскую службу, снизу которого будет кнопка "Отправить заказ в КС2008", при нажатии на которую заказ будет отправлен в курьерскую службу.<br>
====Обновление статусов====Если вы сами привозите отправления на склад или в ПВЗ омника (самопривоз) пароль будет ТОКЕН, КОД ПУНКТА САМОПРИВОЗА.<br> Обновление статусов заказов происходит через технологию WP_Cron каждые 30 минут. Пример cf3f645a5afc2e7ae030522711b4464af77dcb2d11997f1ddf5f1de81b003906,MSK317<br>
Если статус заказа есть необходимость ограничить используемые тарифы, укажите те, которые можно использовать, в курьерской службе будет изменен на “Доставлен”пароле: <br>Пример cf3f645a5afc2e7ae030522711b4464af77dcb2d11997f1ddf5f1de81b003906,MSK317, то статус заказа в вашем магазине также будет изменен на “Выполнен”.,32 26<br>
Для настройки модулей в поле "Код клиента" укажите 90025. <br><br><div style===Проверка работоспособности "color: #a94442; background-color: #f2dede; border: 1px solid #ebccd1; padding: 3px 10px 10px;"><b>Внимание!</b><br> При использовании прямых интеграций===и модулей необходимо использовать второй режим срочности [2] <b>Посылка. Алгоритмический тариф</b>.<br>В разных модулях может выбираться из списка или вводиться числом. При выборе другого режима срочности интеграции и модули могут работать не верно либо рассчитывать не все возможные варианты.<br></div>
При неполадках == Отмена заказов в интеграциях ==<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>
Текст ошибки можно увидеть через [[Личный кабинет#Отладка|отладку]] в личном кабинете. Чтобы найти свой заказ в запросах, нажмите клавиши CTRL + F и введите в строку поиска номер заказа или ориентируйтесь на время создания заказа.
Убедитесь, что выполнены все шаги инструкции по настройки интеграции из этого раздела.
Ниже представлено описание проверки работоспособности для разных интеграторов[[Файл:2023-04-03_11-26-09.png |700px]]<br><br><br>
'''RetailCRM'''</li><li>Если заказ <i style="color:black; background-color:#e91e6326;"> не удалось отменить </i> на стороне подрядчика, (например, заказ уже находится в процессе доставки), то статус заказа изменится на "<b>В работе у подрядчика</b>".В этом случае, изменение заказа возможно только в личном кабинете подрядчика, либо обращением в <i>техподдержку подрядчика</i>.<br><br>
# Создайте заказ, заполните требуемые данные.
# Нажмите на кнопку '''Сохранить''' внизу страницы, флажок '''Не отправлять данные в службу доставки''' должен быть снят. Заказ должен отправиться в курьерскую службу.
# Если возникает ошибка, ее текст отображается наверху страницы.
:: Если это ошибка заполнения формы, исправьте внесенные данные и попробуйте отправить заказ снова. Пример ошибки: «Ошибка сервиса доставки "Курьерская служба 2008": field [receiver phone] has no valid phone number»
:: Если это ошибка ответа курьерской службы, сообщите об этом разработчику. Пример ошибки: «Служба доставки прислала ответ в неверном формате».
'''Мой склад'''[[Файл:2023-04-03_11-52-20.png |700px]]<br><br><br>
</li><li>Если заказ был <i style="color:black; background-color:# В личном кабинете клиента курьерской службы dafbda;"> успешно отменен </i> (в настройках обратной интеграции '''Мой склад''' в поле '''В каком статусе "Мой склад" отправлять этом случае интеграция сама удалит заказ на доставку''' уточните статусстороне подрядчика), при котором заказ отправляется в курьерскую службу.# Заполните форму заказа, нажмите на кнопку '''Сохранить''', затем смените то по истечении 1-15 минут статус заказа на статус, установленный для отправки в курьерскую службу и снова нажмите интеграции сменится на кнопку '''Сохранить'''"<b>Отменен</b>". Если все верно<br>Ответственный филиал корреспонденции будет автоматически переключен на главный ответственный филиал, заказ а код подрядчика (если он был присвоен) будет отправлен в курьерскую службуудален.<br># Обновите страницу в браузере и проверьте поле '''Строка для сохранения информации об ошибках'''<i style="color:black; background-color:#* если поле пустое и заказ пришел dafbda">Только после этого можно считать, что корреспонденция полностью отменена в личный кабинет, интеграция работает;#* если поле пустое интеграции</i> и заказ не пришел в личный кабинет, обратитесь можно приступать к разработчику;#* если в поле содержится текст ошибки, исправьте ее в форме заказа и попробуйте отправить его сноваповторной отправке.<br>
'''InSales'''
# В личном кабинете клиента курьерской службы в настройках обратной интеграции '''InSales''' проверьте данные в следующих полях<br>[[Файл:#* '''Отправлять заказы в курьерскую службу автоматически после изменения статуса''';#* '''Статус отправления заказа в курьерскую службу (если отправляется автоматически)''';#* '''Список доставок для отправления заказа в курьерскую службу (если отправляется автоматически)''';#* '''Оплачен ли заказ? (если отправляется автоматически)'''.# Создайте заказ и в случае ошибки проверьте данные заказа на соответствие этим полям. Например, в заказе может быть установлен тип доставки, не отмеченный как используемый в настройках в личном кабинете2023-04-03_12-03-35.png |700px]]
<br><br><br></li><li>Внесите исправления в данные корреспонденции. Сохраните ее.</li><li>Для повторной отправки корреспонденции по интеграции (предварительно убедившись, что все ошибки исправлены) вновь назначьте для корреспонденции ответственный филиал интеграции </li><li>После повторного назначения в корреспонденции ответственного филиала интеграции ожидайте сообщения об отправке. При возникновении ошибок при повторной отправке заказа появляется диалоговое окно с сообщением об ошибкеэтот процесс может занимать до 30 минут. Исправьте </li><li>При возникновении ошибки, если она очевидна, вновь исправьте ошибку в форме заказа корреспонденции и попробуйте отправить его сноваповторите процесс повторной отправки (отмена, исправление ошибок, повторное назначение на ответственный филиал интеграции)</li></ul>Если при получении ошибки от подрядчика нет понимания ее причин, пожалуйста напишите в нашу техподдержку.
'''amoCRM'''==Сквозная интеграция==
Ошибка Сквозная интеграция предполагает передачу тарифов подрядчика при создании заказа отображается в левом нижнем углу.
== RBK.money ==Чтобы настроить прием платежей через систему «RBK.money»сквозную интеграцию между [[#Интеграция с CMS-системами |CMS- или CRM-системой]] и подрядчиком [[#Тарификация и выбор подрядчика и его тарифа клиентом|из таблицы]]:# Перейдите по ссылке * Создайте свой Личный кабинет для экстраинтеграции.<br>Для этого, достаточно единоразово войти в ЛК экстраинтеграции под своим логином и паролем https://welcomehome.rbkcourierexe.moneyru/ и нажмите '''Подключиться'''XXX, где XXX — экстра-код партнера. С вами свяжутся сотрудники <br><i>Логин</i> и вышлют инструкцию для заключения договора <i>пароль</i>, - это данные из 3-го и дальнейшей работы4-го параметров (см.таблицу ниже) [[# После завершения регистрационных действий введите полученный публичный ключ Тарификация и выбор подрядчика и идентификатор в настройках личного кабинета курьерской службы. Подробнее смего тарифа клиентом|Тарификация и выбор подрядчика и его тарифа клиентом]]. * настройте [[Личный кабинет курьерской службы#Вкладка «Финансы»Виды срочности|настройки личного кабинетарежим срочности]]для подрядчика.
При успешной оплате заказ Для сквозной тарификации заказов интернет-магазинов доступны следующие варианты:* курьерская служба, с которой сотрудничает интернет-магазин, настраивает режим срочности для подрядчика. Интернет-магазин оформляет заказы в [[Личный кабинет клиента|личном кабинете клиента]] и выбирает указанный режим срочности;* интернет-магазины могут обратиться напрямую в MeaSoft отмечается как оплаченныйдля настройки сквозной тарификации. В этом случае нужно предварительно заключить договор на оказание услуг с выбранным подрядчиком, и сквозная тарификация позволит получать его цены.
== PimPay Тарификация и выбор подрядчика и его тарифа клиентом ==Чтобы начать работать с [https://pimpay.ru/ Pimpay] необходимо сначала зарегистрироваться Вы можете настроить подключение своего тарифа к тарифу партнера — любой компании, работающей в их системе по адресу [http://platform.api.pimpay.ru/site/register http://platform.api.pimpay.ru/site/register]. Далее pimpay активирует Вашу учетную запись. [[Файл:pimpayconfig.png|thumb|200px|right|рисMeaSoft, а также ряду компаний, с которыми у нас есть интеграции.1 Конфигурация PimPay]]
=== Настройка интеграции ===Чтобы продолжитьнастроить подключение к тарифу партнера:# Зарегистрируйтесь в системе подрядчика. Данные аккаунта понадобятся для настройки интеграции.# Откройте '''Справочники''' > '''Статусы''' > '''17 Виды срочности''' и создайте [[Статусы#Виды срочности|вид срочности]], например «СДЭК».# В контекстном меню вида срочности выберите пункт '''Дополнительная информация''' и во второй строке заполните параметры подключения к партнеру через запятую:#* 1-й параметр — код филиала партнера, вам нужно сгенерировать ключи шифрованияего можно посмотреть в '''Справочники''' > '''Межгород''' > '''Филиалы'''. Можно в одинарных кавычках указать несколько ответственных филиалов через запятую, тогда режим срочности будет доступен для всех перечисленных филиалов. Для версии системы 2021.0.0. Это делается на UNIX38 и выше вместо кода филиала можно указать знак вопроса (?), это обозначит доступность режима срочности для всех филиалов;#* 2-й параметр — экстра-подобной код партнера в системе: [http://platformMeaSoft.apiКоды для сторонних компаний приведены в таблице ниже;#* 3-й параметр — имя пользователя в системе партнера.pimpayМожет отличаться от того, под которым работает интеграция, здесь нужно для расчета цены для клиента.ru/v2_7/signature/openssl http://platformВ таблице ниже указано, что вводить для каждого интегратора;#* 4-й параметр — пароль пользователя из 3-го параметра. В таблице ниже указано, что вводить для каждого интегратора;#* 5-й параметр — вид срочности партнера.apiПосмотреть доступные коды видов срочности можно по ссылке в таблице ниже, в калькуляторе в выпадающем списке.pimpayМожно в одинарных кавычках указать несколько видов срочности через запятую, тогда система будет стараться выбрать из них первый доступный;#* 6-й параметр — наценка к цене, передаваемой подрядчиком.ru/v2_7/signature/openssl] В деньгах или в процентах, если стоит знак процента. Например, 10 — наценка 10 рублей, 10 % — наценка 10 процентов;#* 7-й параметр — если указать значение '''1''', сквозная тарификация выключена. Параметр используется, если подключение нужно только для передачи заказов по интеграции, а расчет цены не нужен. <spoiler text="наша инструкция"br>В этом случае, при визуализации суммы по режиму срочности, отображается внутренний тариф, а подрядчику заказ отправляется другим тарифом, выбранным согласно настройке в 5-м параметре (вид срочности партнера).;Чтобы получить приватный ключ#* 8-й параметр — если указать значение '''1''', среди указанных режимов срочности партнера выполняется поиск самого дешевого тарифа. Работает для СДЭК 1.5, необходимо запустить командную строкуПочты России и Omnic# Нажмите на кнопку '''OK'''.
{|class="wikitable"!Интеграция!Код экстра!Виды срочности!Авторизация!Пример строки|-|БОКСБЕРРИ||90001||https://home.courierexe.ru/90001/calculator||3-й параметр - токен. 4-й - Код пункта приема, по умолчанию 010.<br>Можно оба параметра оставить пустыми для расчета базовых цен.||33, 90001, j3ejwo2f10b2e47790174b41f4a11111, 010, 2, 50|-|ПИКПОИНТ||90002||https://home.courierexe.ru/90002/calculator||3-й параметр — логин, 4-й — через запятую пароль и договор ИКН. Можно оставить пустыми, но цены будут не все.||33, 90002,us0111, '6rGGuqRsW2qNQ,9990721312', 2, 50|-|rowspan="2"|СДЭК<br>(протокол обмена данными 1.5, поддержка прекращена с 01.01.2022)||rowspan="2"|90005||rowspan="2"|https://home.courierexe.ru/90005/calculator||Введите код учетной записи в 3-й параметр, секретный код — в 4-й. Можно оба оставить пустыми для расчета базовых цен.||45491, 90005, hfenJwlasiPr4pnFENpaVXSKPIn5Trh7i, '9vkQgWuiZgEj9fGCB8a6Xj3desnJkwsl,1.5', 5, 30%|-||Если вы хотите добавить в расчет тарифа процент за наложенный платеж, после пароля добавьте запятую и число процента. В командной строке настройке режима срочности пароль с числом процентов заключите в кавычки.||9vkQgWuiZgEj9fGCB8a6Xj3desnJkws,1.5|-|СДЭК<br>(протокол обмена данными 2.0)||90022||https://home.courierexe.ru/90022/calculator||3-й параметр — ID клиента, 4-й — ключ клиента.<br>Вы можете перечислить в пароле уточняющие параметры для расчета через запятую: <br><ul><li>не передавать объявленную ценность</li><li>добавлять услугу «Осмотр вложений»</li><li>процент за наложенный платеж</li><li>код пункта приема</li><li>процент за безналичный наложенный платеж</li></ul><br>Пример пароля: EMscd6r9JnFiQ3bLoyjJY6eM78JrJcee,1,1,2,MSK2,15||10497, 90022, EMscd6r7JnFyQ3bLoyjJY7eM78JrJceI, ‘Mscd6r9JnFiQ3bLoyjJY6eM78JrJcee,1,1,2,MSK2,15’, 1, 100|-|КСЭ||90008||https://home.courierexe.ru/90008/calculator||Введите логин в 3-й параметр, пароль — в 4-й. Пустыми оставить нельзя.||12504, 90008, Рога и копыта, 4CCB11864D06157, '2, 3, 6', 10%|-|ПОЧТА РОССИИ||90010||https://home.courierexe.ru/90010/calculator||Без авторизации||10497, 90010,,, '2, 1', 10 <!--10497, 90010, 89251234567, 'mypassword,u23B0r9AAJ1Fyh4ptMzJ3kjxcslamwdx', '2, 1', 10-->|-|rowspan="3"|DPD||rowspan="3"|90011||rowspan="3"|https://home.courierexe.ru/90011/calculator||Введите клиентский номер в 3-й параметр, клиентский ключ в 4-й. Можно оставить пустыми для базовых тарифов.||12504, 90011, 1019003662, '4CCB11864D06157A5934A9119F2A0AAAAAB4CCE8,D117', '3, 6', 10%|-||Если вы доставляете товар в пункт отправления самостоятельно, после пароля добавьте запятую и код ПВЗ, а в настройке режима срочности введите пароль в кавычках.||'4CCB11864D06157A5934A9119F2A0AAAAAB4CCE8,D117'|-|-|colspan="2"|ВНИМАНИЕ! У DPD есть 2 калькулятора, которые считают по-разному при одних и тех же вводных данных. При этом они не разглашают, по какому из расчетов определяют цену. Поэтому по не зависящим от нас причинам расчет по тарифам DPD может как совпасть с итоговым, так и сильно разойтись. Если вас это не устраивает, не используйте сквозную тарификацию с этим подрядчиком.|-<!--|DOSTAVKA.GURU||90017||https://home.courierexe.ru/90017/calculator||3-й параметр — ID партнера в системе DOSTAVKA.guru, 4-й — ключ доступа. Также можно указать признак отключения проверки интервала доставки. В этом случае необходимо выполнить следующие командыуказать ключ и "1" через запятую в кавычках. Можно оставить пустыми. ||10497, 90017, 9999, 'cc03e747a6afbbcbf8be7668acfebee5,1', '1', 100|- -->|5Post||90020||https://home.courierexe.ru/90020/calculator||3-й параметр — API-ключ,<br>4-й — уникальный номер партнера в системе 5post.<br>При необходимости в 4-м параметре можно через запятую указать параметры:<br><ul><li>пороговое значение веса (по умолчанию 3 кг).</li><li>Использовать штрихкод для отслеживания получателем</li><li>Код подрядчика в карточке заказа</li><li>Габариты мест</li><li>Тип расчета тарифа</li></ul><i>При указании параметров важно соблюдать последовательность.</i><br><i>Для вашего аккаунта в API 5post должна быть подключена возможность получать ПВЗ с вашими тарифами.</i><br>Пример пароля: 2123,7,,,,1||10497, 90020, u23B0r9AAJ1Fyh4ptMzJ3kjxcslamwdx,'2123,7,,,,1', '1,3', 100|-|GTD||90021||https://home.courierexe.ru/90021/calculator||3-й параметр — API-ключ, 4-й — пароль от личного кабинета https://home.courierexe.ru/90021. Предварительная авторизация по указанному URL обязательна.||10497, 90021, u23B0r9AAJ1Fyh4654MzJ3kjx1548wdx, pass, 100|- openssl genrsa |Яндекс.Доставка||90023||https://home.courierexe.ru/90023/calculator||3-й параметр — токен,<br> 4-out privateй — ID пункта отправления и через запятые интервал доставки.pem 2048<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/ openssl rsa ЛК экстраинтеграции Л-in privateПост]</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.pem ru/90025/calculator||3-outform PEM й параметр — логин, который требуется создать самостоятельно, для входа в <i>[https://home.courierexe.ru/90025/ ЛК экстраинтеграции Omnic]</i> <br> 4-pubout пароль, как Токен клиента<br> Дополнительно, есть возможность перечислить в пароле уточняющие параметры для расчета через запятую: <br><ul><li>Код пункта приема отправлений</li><li>Признак использования тестовой среды</li><li>Приоритет доступных тарифов через пробелы, -out public.pemпри указании алгоритмического тарифа, приоритет указанный в нем имеет преимущество</li></ul><br>Пример пароля: g67hjtTYjhgf765432,MCK45||10497, 90025, LoginTest, ‘g67hjtTYjhgf765432,MCK45,,21 22’, '3, 2', 100,,1|}
После успешного выполнение команд Вы получить 2 файла: public.pem и private.pemСодержимое файла public.pem - ваш публичный ключ, который необходимо целиком скопировать и вставить в ЛК PimPay.А содержимое файла private.pem необходимо скопировать и вставить в настройках интеграции с PimPay в нашем ЛК.</spoiler>[[Файл:pimpay client.png|thumb|200px|right|рис.2 Выбор платежного посредника]]Если у вас нет специалиста, чтобы сгенерировать ключи, обратитесь в PimPay, они с радостью сделают это за вас! Далее, необходимо прописать настройки для pimpay в панели управления нашего ЛК (см. рис.1). В ЛК PimPay нужно посмотреть код компании (у них называется "Код платформы") и токен, ввести их в форму. Для каждого клиента, который хочет передавать данные в PimPay необходимо зарегистрировать При выборе клиентом в личном кабинете PimPay, и в нашей системе выбрать платежного посредника на вкладке "Финансы" карточки клиента. В процессе передачи данных привязка клиентов между системами производится по ИНН. Наша система начинает передавать все заказы вашего клиента в PimPay, их статусы, и созданные [[Акты Передачи Денег и корреспонденции (АПД)|АПД]]. Обратно она ничего не получает. Для того, чтобы платежи в банк по АПД выгружались в адрес PimPayвида срочности, нужно создать клиента с точно подключенного таким названием ("PIMPAY")образом к партнеру, и заполнить его реквизиты. == Диадок ===== Начальная настройка === Рассказываем как начать пользоваться с самого начала: # Свяжитесь с [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://diadoc.kontur.ru], без пароля, просто по ЭЦП, подключенной к компьютеру. Вы уже можете принимать документы от контрагентов.# Обратитесь в СКБ Контур для выставления счета на пакет отправляемых документов. Пакет можно выбрать здесь: [https://www.diadoc.ru/price https://www.diadoc.ru/price]. Кроме того, для использования с нашей, как и с любой другой системой, нужно включить возможность использования API: сотрудники Контура выставят за это счет - 18 т.р. на год, или 38 т.р. за 5 лет (актуально в 2019 году). После '''оплаты счета''' за API они присылают '''API-ключ''' вида "API-1b1111ae-1111-1111-b111-111111cc1fd1". API-ключ приобретается отдельно на каждое ваше юр. лицо, поэтому его нужно вводить в "Фирмы".# Заполняем данные подключения в системе: ## В переменной <mparam code="EDocProvider"/> выбираем "Диадок".## API-ключ нужно внести в "Справочники" -> "Фирмы" -> Карточка фирмы -> "Ключ ЭДО".## Если в вашем токене несколько сертификатов, в поле <mparam code="EDocLogin"/> можно указать отпечаток сертификата, который нужно использовать. Если пусто - программа постарается выбрать сертификат сама по доступности компании, к которой производится подключение. Посмотреть отпечаток: Пуск - Программы - Крипто-ПРО - "Сертификаты пользователя" - "Личное" - "Сертификаты". Справа выберите нужный сертификат, откройте. Перейдите на вкладку "Состав", прокрутите список значений вниз, в самом низу выберите "Отпечаток".## В поле <mparam code="EDocPass"/> введите пин-код сертификата. Если вы его не меняли, можно пропустить: по-умолчанию для рутокена пин - "12345678", и программа сама будет его использовать, если вы ничего не указали. Если он окажется не правильным - Крипто-ПРО спросит у вас верный пин при передаче данных. Обратите внимание, что количество попыток ввода пин-кода ограничено.# После ввода данных подключения нужно выйти, и запустить программу от имени администратора (права windows, правой кнопкой на ярлык - запустить от администратора), и осуществить обмен данными: "Связь" -> "Обмен с ЭДО". При первом использовании программа установит на компьютер специальный COM-объект Диадока. Именно для этого нужны права. В дальнейшем она доступных ПВЗ будет использовать уже установленный компонент, и наличия прав не требуется. === Обмен данными с ЭДО ===Выберите в главном меню "Связь" -> "Обмен с ЭДО". Откроется окно с выпадающим списком фирм, у которых заполнено поле "Ключ ЭДО". Выберите фирму, и нажмите "Обмен!". Программа выполнит все операции, которые периодически нужно выполнять, чтобы иметь актуальные данные как в нашей системе так и в ЭДО:*Синхронизирует справочники контрагентов: Получит список контрагентов, уже являющихся вашими партнерами в ЭДО, проставит им соответствующие признаки (На вкладке "Клиенты" появилось новое поле "Статус ЭДО". Это поле нельзя менять, оно устанавливается автоматически), проверит, кто прислал вам приглашения к партнерству и примет их, разошлет приглашения всем вашим работающим контрагентам, проверит, кто принял приглашение, а кто - отказался.*Проверит статусы ранее отправленных документов. При подписании документа вашим ограничен выбранным партнером, сообщение получит статус "Доставлено". Если оно отправлено из счетов или АПД, то соответсвующий документ получит признак получения подписанного акта. === Отправка документов ===К отправке сейчас доступны счета, АПД и АПК. Отправка работает крайне похоже на e-mail. Документы формируются точно так же, но отправляются не почтой, а в ЭДО, уже подписанными вашей ЭЦП. В системе ЭДО "адресами" отправителя и получателя являются ИНН (по возможности еще КПП, но это не обязательно) компании, поэтому, чтобы все работало, ИНН должен быть заполнен. Так же ЭДО примет документы только в адрес компании, с которой у вас отмечены партнерские отношения, т.е. кто-то из вас отправил приглашение, а другой его принял. Поэтому, для удобства контроля - кому можно таким образом отправлять, а кому - нет, в списках документов добавлено поле "Есть ЭДО". Там галка ставится на основании статуса ЭДО клиента. Можете отсортировать по этому полю, выдели все, где есть галки, и разослать всем документы по ЭДО.
== Телефония ==Основная статьяВы можете войти в личный кабинет по адресу вида https: [[Интеграция //home.courierexe.ru/XXX, где XXX — экстра-код партнера, авторизоваться данными из 3-го и 4-го параметров (см. таблицу выше) и воспользоваться калькулятором с телефонией]]тарифами именно вашей компании.
== GPS-трекинг автотранспорта = Настройка стоимости доставки для получателя ===Для поддержки GPS-трекинга автотранспорта у нас разработана интеграция При интеграции с коробочной системой Wialonподрядчиками, на которой работают большинство компанийперечисленными в таблице выше, предоставляющих подобные услугивы можете настроить стоимость и срок доставки, отображаемые для получателя:# Перейдите в личный кабинет по адресу вида https://home.courierexe. Обратитесь в службу технической поддержки ru/XXX, где XXX — экстра-код партнера, и авторизуйтесь данными из 3-го и 4-го параметров (см. таблицу выше).# Откройте пункт основного меню '''Цена доставки для получателя''' и настройте правила расчета цены и сроков доставки. Подробнее см. раздел «[[Личный кабинет клиента#Цена доставки для получателя|Цена доставки для помощи в настройкеполучателя]]».
15
правок

Навигация