Изменения

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

8959 байт добавлено, 6 февраль

→‎Яндекс.Доставка

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

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

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

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

==Настройка==# Обе компании должны иметь аккаунты в системе MeaSoft ('''Справочники''' > '''Дополнительные модули''') и у обеих компаний должен быть установлен флажок '''Личный кабинет''' в окне «Управление дополнительными модулями».# Агент на вкладке '''Клиенты''' создает карточку клиента в своей системе. На вкладке '''Прочее''' [[Клиенты и партнеры#Прочее|карточки клиента]] указывает логин и пароль для входа в [[личный кабинет]] клиента.# Агент передает клиенту логин и пароль из предыдущего шага и свой [[Личный кабинет курьерской службы#Подключение|код экстра]] в системе MeaSoft.# Клиент создает в своей системе [[Филиалы|филиал]] для указанного агента. После создания филиала нужно подождать 3 минуты для синхронизации данных.# Клиент заходит в [[личный кабинет курьерской службы]] и на вкладке '''Подрядчики''' в таблице находит созданный филиал.# Клиент в строке подрядчика нажимает на кнопку [[Файл:MeaShip_Интеграция.png]], в открывшемся окне выбирает интеграцию «MeaSoft», заполняет поля:<div style="padding-left: 45px; position: relative;">*'''Логин''', '''Пароль''' и '''Код клиента''' учетными данными, полученными в п. 3, *Тип оплаты - позволяет управлять логикой обработки типа оплаты в данных передаваемого по интеграции заказа. Доступные варианты:**Адаптируется в соответствии с данными заказа При отсутствии наложенного платежа передается No, иначе при типе оплаты картой CARD, во всех остальных случая CASH**Оригинальный В этом случае ~~нужно настроить~~ , тип оплаты заказа передается без изменений Группа параметров, отвечающая за разделение заказов по потокам с разной авторизацией:* '''Логин для заказов без чека''' и '''Пароль для заказов без чека'''* '''Определять заказы без чека по признаку''' - "Печатать чек - в карточке клиента" или "Спрашивать тип оплаты у получателя - в карточке клиента"В интеграции Measoft существует возможность отправлять заказы, распределяя их 2 -м разными клиентами по принципу необходимости чека. Для этого в интеграцииMeasoft нужно заполнить параметры "Логин для заказов без чека" и "Пароль для заказов без чека" Заказы, которые созданы клиентом '''с настройкой необходимости чека''' будут отправляться с авторизацией указанной в параметрах: "Логин" и "Пароль" Заказы, которым '''чек не требуется''' будут отправляться с авторизацией "Логин для заказов без чека" и "Пароль для заказов без чека" * '''Передавать наименование клиента, как отправителя''' - позволяет передавать наименование клиента, как отправителя* '''Разрешить подрядчику изменять данные получателя''' - при разрешении изменять данные получателя, изменения отразятся в оригинальном заказе. В этом случае заказ необходимо пересчитывать, для актуализации его стоимости.** ''Не разрешать'' - по умолчанию** ''Разрешать'' Далее, клиент указывает остальные настройки при необходимости и нажимает '''Сохранить'''.</div>В результате отправления, у которых клиент укажет филиал агента в качестве ответственного филиала, будут переданы в ~~одной~~ систему MeaSoft агента, и статусы будут передаваться обратно. Правильный способ отправки заказов — через [[Манифесты|манифест]], который нужно ~~рассматривать одну компанию~~ скомплектовать и проставить дату отправки. На передачу данных может уходить до 10 минут в штатном режиме и до 1 часа в случае возможных сбоев. <div style="color: #a94442; background-color: #f2dede; border: 1px solid #ebccd1; padding: 3px 10px 10px;">При передаче заказов, у которых плановая дата доставки меньше ближайшей возможной, дата доставки автоматически меняется на самую раннюю возможную.</div> Передача времени ожидания и заполнение информации о возврате не предусмотрено интеграцией. Для стабильной работы необходимо наличие версии MeaSoft минимум 518 от 05.12.2014 у обеих компаний. Для одного клиента может быть настроена только одна интеграция с агентом. ==Распределение заказов по признаку необходимости чека== Вы может распределять заказы по двум разным клиентам по принципу необходимости чека. Для этого агент создает в своей системе второго клиента для вашей компании, в карточке клиента на вкладке '''Прочее''' указывает логин и пароль, которые передает вам. В настройке интеграции Measoft (пункт 6 инструкции выше) заполните поля '''Логин для заказов без чека''' и '''Пароль для заказов без чека''' и выберите признак, по которому определяется необходимость чека, в поле '''Определять заказы без чека по признаку'''. Заказы, созданные клиентом, ~~вторую~~ которому нужен чек, будут отправляться с авторизацией, указанной в полях '''Логин''' и '''Пароль'''. Заказы, которым чек не требуется, будут отправляться с авторизацией '''Логин для заказов без чека''' и '''Пароль для заказов без чека'''. = Интеграция со сторонними системами =Сторонними системами могут быть:* [[#Интеграция с подрядчиками|системы подрядчиков]], принимающие заказы на доставку;* [[#Интеграция с CMS-системами|CRM- и CMS-системы]] интернет-магазинов, передающие заказы в курьерскую службу. Интеграции со сторонними системами делаются в соответствии с документацией на момент написания, без партнерства с компаниями-поставщиками сервиса. Об изменениях API нас не оповещают, поэтому интеграции по не зависящим от нас причинам могут переставать работать, работать нестабильно или некорректно, вплоть до потери важной информации. Заказы, переданные во внешние системы, нужно обязательно проверять на корректность, пользуясь личным кабинетом партнера. По интеграции уходят только новые заказы, созданные в день настройки интеграции. == Интеграция с CMS-системами == Для работы с популярными CMS и CRM-системами разработаны модули интеграции, перечисленные в таблице ниже. '''Модули распространяются бесплатно, без гарантий со стороны разработчика''', и не являются средством полной автоматизации взаимодействия с курьерской службой. Модули — это помощь разработчикам интернет-магазинов в построении интеграции с курьерскими службами. '''Ответственность за корректность передачи данных лежит на интернет-магазине.'''Модули сторонних разработчиков обслуживаются и разрабатываются сторонними компаниями. Все вопросы по их приобретению и поддержке необходимо задавать им. Сообщайте нам свои пожелания по работе наших модулей. Мы учтем их в новых версиях. {| class="wikitable" align="center" style="width: 80%; margin: auto; background-color:#ffffff; border: 1px solid #999999;" cellpadding="10" cellspacing="0"!style="width: 35%;"|Система управления контентом (CMS)!style="width: 15%;"|Ссылка!style="width: 35%;"|Примечание|-|[[Файл:bitrix.png|center|x44px]]|style="text-align: center;" | [https://marketplace.1c-bitrix.ru/solutions/measoft.courier/ Установить] |Поддерживает версии 20.5.0 и выше. Подробнее см. [[1C-Битрикс|описание]].|-|[[Файл:prestashop.png|center|x60px]]|style="text-align: center;"|[https://courierexe.ru/download/api/prestashop.zip Скачать]|Поддерживает версии 1.5.2.0 и выше. Инструкция в архиве|-|[[Файл:OpencartOCStore.png|center|x60px]]|style="text-align: center;"|[https://courierexe.ru/download/api/opencart.zip Скачать для версии 1.5.5.1] [https://courierexe.ru/download/api/measoft_oc2.ocmod.zip Скачать для версии 2.0] [https://courierexe.ru/download/api/measoft_oc2.3.ocmod.zip Скачать для версии 2.3] [https://courierexe.ru/download/api/measoft_oc3.ocmod.zip Скачать для версии 3.0]|Поддерживает версии с 1.5.5.1. Скачивайте модули для своей версии OpenCart. Подробнее см. [[OpenCart|описание]].|-|[[Файл:webasyst-shopscript.png|center|x44px]]|style="text-align: center;"|[https://www.webasyst.ru/store/plugin/shop/measoftcourier/ Установить модуль] [https://www.webasyst.ru/store/plugin/shipping/measoftcourier/ Установить плагин]|Модуль предназначен для отправки заявок в КС, а плагин для расчета стоимости доставки при оформлении заказа. Инструкции в маркете|-|[[Файл:insales.png|center|x80px]]|style="text-align: center;"|Настраивается в [[Личный кабинет клиента|ЛК пользователя]]|[[InSales|Инструкция по настройке]]|-|[[Файл:iiko.jpg|center|x80px]]|style="text-align: center;"|Настраивается в [[Личный кабинет клиента|ЛК пользователя]]|[[Iiko|Инструкция по настройке]]|-|[[Файл:Leadvertex.png|center|x44px]]|style="text-align: center;"|[https://blog.leadvertex.ru/news/2110-integraciya-s-kurerkami-na-platforme-measoft Настраивается] в ЛК [https://Leadvertex.ru Leadvertex]|[[LeadVertex|Инструкция по настройке]] Модуль разработан и поддерживается компанией LeadVertex.|-|[[Файл:Retailcrm.png|center|x30px]]|style="text-align: center;"|[https://www.retailcrm.ru/ RetailCRM]|[[RetailCRM|Настраивается]] в ЛК пользователя в системе|-|[[Файл:1C.jpg|center|x44px]]|style="text-align: center;"|-|[https://infostart.ru/public/692790/ Альтернативный модуль сторонних разработчиков (1 версия)] [https://infostart.ru/public/1531484/ Альтернативный модуль сторонних разработчиков (2 версия)]|-|[[Файл:Joomla2.jpg|center|x60px]]|style="text-align: center;"|[https://courierexe.ru/download/api/com_measoft.zip Скачать]|Работает только с компонентом Virtuemart. Инструкция в архиве|-|[[Файл:Amocrm.png|center|x44px]]|style="text-align: center;"|[https://www.amocrm.ru/extensions/measoft Описание на сайте amoCRM]|Подробное описание настроек читайте [[amoCRM|тут]].|-|rowspan="2"|[[Файл:MoySclad.jpg|center|x30px]]|style="height:50px; text-align: center;"||[[МойСклад|Инструкция]]|-|style="height:50px; text-align: center;"|[https://itmdev.ru/ms/shipping/ Скачать модуль сторонних разработчиков]|Интеграция МойСклад с курьерскими службами от сторонних разработчиков|-|[[Файл:wordpress.jpg|center|x80px]]|style="text-align: center;"|[https://courierexe.ru/wordpress/wordpress.php Скачать]|[[Wordpress|Инструкция]]|-|[[Файл:Cscart.png|center|x60px]]|style="text-align: center;"|[https://marketplace.cs-cart.com/measoft-en.html Установить]|Поддерживает версии 4.10 и выше. [[CS-Cart|Инструкция]]|-|[[Файл:webhooks.jpg|center|x100px]]|style="text-align: center;"|Читайте описание [[Webhook|на этой странице]]|Передача информации о статусах и заказах в вашу систему|-|[[Файл:Logo_tilda_black.png|center|x100px]]|style="text-align: center;"|Читайте описание [[Tilda|на этой странице]]|Работает только на платных тарифах|-|} === Замечания ===# В модулях систем PrestaShop и Joomla для отправки заказа в курьерскую службу зайдите в карточку заказа. В карточке отображается специальная форма отправки заказа, а если заказ отправлен, она позволяет проверить его статус:[[Файл:Form.png|400 px|Форма отправки заказа|none]]# Оформление заказов до '''ПВЗ''' в модулях '''PrestaShop''' и '''Joomla''' не реализовано. Чтобы оформить такой заказ, в поле передаваемого адреса укажите одно из значений:#* код ПВЗ, который можно посмотреть в ЛК клиента или на сайте агента (Boxberry, CDEK и т. п.). Обычно это цифровой или цифро-буквенный код;#* наименование ПВЗ, добавив в начале строку "ПВЗ ", например '''ПВЗ На Ленина'''.# Поддерживается передача маркировки «[[Маркировка|Честный ЗНАК]]» из InSales и RetailCRM. Информацию по настройке см. в документации [https://www.insales.ru/collection/doc-zprochee/product/prodazha-tovarov-s-markirovkoy-487-fz Insales] и [https://help.retailcrm.ru/Users/MarkingOfGoods RetailCRM].# Для отображения списка пунктов выдачи есть [https://home.courierexe.ru/js/measoft_map.js JavaScript модуль]. Инструкция по использованию — ~~агентом~~внутри. Посмотреть пример работы можно [https://home.courierexe.ru/pvz_test.html здесь].# При проблемах с отображением карты в модулях очистите кэш браузера: например, для Google Chrome нажмите CTRL+F5. Введенные данные потеряны не будут, карта после этого отобразится корректно.=== Проверка работоспособности интеграций ===При неполадках интеграции проверьте ее работоспособность. В общем случае для этого достаточно создать заказ и отправить его в курьерскую службу. Если заказ отправлен без ошибок и отображается в ЛК, значит, интеграция настроена. Если отправка не удалась, ошибка может быть в настройках интеграции или в заполнении формы отправки заказа. Текст ошибки можно увидеть через [[Личный кабинет#Отладка|отладку]] в личном кабинете. Чтобы найти свой заказ в запросах, нажмите клавиши CTRL + F и введите в строку поиска номер заказа или ориентируйтесь на время создания заказа. Убедитесь, что выполнены все шаги инструкции по настройки интеграции из этого раздела. Ниже представлено описание проверки работоспособности для разных интеграторов. '''RetailCRM''' # Убедитесь, ~~во второй~~ что выполнены все шаги [[RetailCRM#Настройка интеграции|инструкции по настройке интеграции ~~– наоборот~~]].# Если используются триггеры, убедитесь, что они настроены согласно [[RetailCRM#Настройка триггеров|инструкции]].# Создайте заказ, заполните требуемые данные.# Нажмите на кнопку '''Сохранить''' внизу страницы, флажок '''Не отправлять данные в службу доставки''' должен быть снят. Заказ должен отправиться в курьерскую службу.# Если возникает ошибка, ее текст отображается наверху страницы.:: Если это ошибка заполнения формы, исправьте внесенные данные и попробуйте отправить заказ снова. Пример ошибки: «Ошибка сервиса доставки „Курьерская служба 2008“: field [receiver phone] has no valid phone number»:: Если это ошибка ответа курьерской службы, сообщите об этом разработчику. Пример ошибки: «Служба доставки прислала ответ в неверном формате».

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

~~В результате такой~~ # При сбое интеграции проверьте, не изменен ли аккаунт, под которым создана интеграция:## Логин учетных данных МойСклад, которые использовались при создании интеграции, вставьте в ссылку <nowiki>https://home.courierexe.ru/moysklad/step2?id=</nowiki>'''логин'''. Если при переходе по ссылке отображается этап настройки интеграции, значит аккаунт существует.## Войдите в «МойСклад» под учетной записью, которая использовалась для настройки ~~все отправления~~интеграции, и откройте справочник '''Сотрудники''': меню пользователя > '''Настройки''' > '''Справочники'''> '''Сотрудники'''. Откройте карточку сотрудника, ~~у которых Клиент установит «Ответственный филиал»~~под учетной записью которого вы вошли, ~~соответствующий Агенту (правильнее всего это через [[Отправка корреспонденции|Создание манифеста|манифест]]~~и убедитесь, ~~скомплектовав~~ что его ~~и проставив дату отправки)~~роль — администратор.## Если хотя бы один из пунктов не выполнен, значит, аккаунт, использованный для создания интеграции, изменен.# В личном кабинете клиента курьерской службы в настройках обратной интеграции '''Мой склад''' в поле '''В каком статусе «Мой склад» отправлять заказ на доставку''' уточните статус, ~~будут переданы~~ при котором заказ отправляется в ~~БД Агента~~курьерскую службу.# Заполните форму заказа, нажмите на кнопку '''Сохранить''', затем смените статус заказа на статус, установленный для отправки в курьерскую службу и ~~статусы будут передаваться обратно~~снова нажмите на кнопку '''Сохранить'''. Если все верно, заказ будет отправлен в курьерскую службу. ~~На передачу данных может уходить до 10 минут~~ # Обновите страницу в браузере и проверьте поле '''Строка для сохранения информации об ошибках''':#* если поле пустое и заказ пришел в ~~штатном режиме~~ личный кабинет, интеграция работает;#* если поле пустое и ~~до 1 часа~~ заказ не пришел в ~~случае возможных сбоев~~личный кабинет, обратитесь к разработчику;#* если в поле содержится текст ошибки, исправьте ее в форме заказа и попробуйте отправить его снова.

~~Для стабильной работы необходимо наличие версии минимум 518 от 05.12.2014 у обеих компаний.~~'''InSales'''

~~== Интеграция с подрядчиками~~ # В личном кабинете клиента курьерской службы в настройках обратной интеграции '''InSales''' проверьте данные в следующих полях:#* '''Статус заказа для автоматической отправки в курьерскую службу''';#* '''Список доставок для отправления заказа в курьерскую службу (~~передача заказов~~если отправляется автоматически) ==''';~~=== Отказ от ответственности ===~~#* '''Оплачен ли заказ? (если отправляется автоматически)'''.~~Хотим обратить ваше внимание~~ # Создайте заказ и в случае ошибки проверьте данные заказа на тосоответствие этим полям. Например, ~~что интеграции со сторонними системами делаются~~ в ~~соответствии с документацией на момент написания~~заказе может быть установлен тип доставки, ~~без партнерства с компаниями-поставщиками сервиса. Об изменениях API нас~~ не оповещают, поэтому интеграции по независящим от нас причинам могут переставать работать, работать нестабильно или некорректно, вплоть до потери важной (финансовой?) информации. Заказы, переданные во внешние системы, нужно обязательно проверять на корректность, пользуясь личным кабинетом партнераотмеченный как используемый в настройках в личном кабинете.

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

Клиент должен иметь аккаунт и личный кабинет в системе MeaSoft. Подробнее см. раздел «[[Личный кабинет курьерской службы]]».'''amoCRM'''

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

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

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

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

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

Для стабильной работы необходимо наличие у клиента системы MeaSoft версии минимум 518 от 05.12.2014.

=== ~~СДЭК~~ =Последовательность финальных статусов ==== Параметр Исправлять ошибки последовательности статусов регулирует возможность исправления ошибочно опубликованных подрядчиком финальных статусов. Если в параметре интеграции указано "Исправлять", то при получении статуса CANCELED, вслед за финальным, дата доставки заказа будет приводится в состояние соответствующее последнему полученному статусу. === Boxberry ===* '''Токен'''* '''Код пункта приема''' по умолчанию 010* '''Не формировать акты автоматически'''* '''Разрешить вскрывать отправления'''** '''Без вскрытия отправления''' - вид выдачи отправления на стороне Boxberry 0 - без вскрытия** '''Со вскрытием отправления''' - вид выдачи отправления на стороне Boxberry 1 - со вскрытием** '''Разрешено вскрытие и частичная доставка''' - вид выдачи отправления на стороне Boxberry зависит от указания частичной доставки в карточке заказе:*** 1 - со вскрытием если частичная доставка не указана*** 2 - частичная доставка, при частичной доставке в карточке заказа** '''Разрешено вскрытие и Частичная доставка с примеркой''' вид выдачи отправления на стороне Boxberry от указания частичной доставки в заказе: Дополнительно, в этом случае указывается возможность примерки, если это доступно на ПВЗ получателя*** 1 - со вскрытием, если частичная доставка не указана*** 2 - частичная доставка, при частичной доставке в карточке заказа * '''Передавать штрихкоды мест'''* '''Передавать штрихкод заказа''' - Документацией Боксберри разрешено не передавать штрихкоды, тогда Бокберри сам создает ШК и этикетку можно получить по url который Boxberry возвращает вместе с кодом подрядчика при принятии заказа. На данный момент, интеграция не получает этикетки автоматически. Их нужно скачивать из ЛК Boxberry.

~~Отправка в СДЭК осуществляется первым доступным тарифом из списка:~~

* «Экономичная посылка»,

* «Посылочка»,

* «Экспресс-лайт»,

* «Магистральный экспресс».

==== Миграция на Яндекс Доставку ====Авторизация и принятие оферты Яндекс.Доставки будет происходитьчерез Личный кабинет Boxberry. * В ~~настройках интеграции MeaSoft может поменять местами тарифы «Экономичная посылка»~~ личном кабинете Boxberry необходимо кликнуть по баннеру со ссылкой на новый ЛК Boxberry.* Кликая на ссылку в банере, клиент последовательно увидит 2 окна:** авторизация (подтверди свой аккаунт)** принятие офертыПосле этого клиенту доступна работа в API и ~~«Посылочка».~~модулях для обновления~~При весе отправления больше 30 кг применяется тариф «Магистральный экспресс»~~гео-справочников.

~~Чтобы передать услугу «Примерка», установите флажок '''Принято на склад'''~~ ПВЗ Яндекс будут загружены в ~~[[Единица корреспонденции#Создание единицы корреспонденции|карточке корреспонденции]]~~течении суток после подтверждения офферты. Если ~~услуга~~ ПВЗ Яндекс не ~~нужна~~подгрузились в течении суток после подтверждения офферты, ~~снимите флажок~~то требуется обратиться в техподдержку Measoft для получения логов статуса клиента.

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

~~В общем случае~~ Компания СДЭК прекращает поддержку API версии 1.5 с 01.01.2022. По информации от службы поддержки, интеграция не ~~поддерживает отправки в другие страны~~будет резко отключена, ~~кроме России~~но поддержка будет осуществляться только для версии API СДЭК 2.0

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

~~=== TopDelivery ===~~Чтобы настроить интеграцию с платформой СДЭК версии 2.0, заполните следующие поля:* '''ID клиента'''* '''Ключ клиента '''~~[[Файлы для загрузки#.D0.9F.D0.B5.D1.87.D0.B0.D1.82.D0.BD.D1.8B.D0.B5_.D1.84.D0.BE.D1.80.D0.BC.D1.8B_.D0.B4.D0.BB.D1.8F_.D0.BC.D0.B0.D0.BD.D0.B8.D1.84.D0.B5.D1.81.D1.82.D0.BE.D0~~* '''Код пункта приема '''Это обязательные поля.~~B2|Печать наклеек для TopDelivery]]~~

Остальные поля служат для более тонкой настройки создания заказов:* '''Передавать объявленную ценность'''. Значение по умолчанию '''Да''', вы можете изменить это, выбрав одно из значений:** "Да" Оценочная стоимость формируется по принципу наибольшего значения. Учитываются Оценочная стоимость всего заказа, Оценочная стоимость товарных вложений, цена товарных вложений. ** "Нет" объявленная ценность товарных вложений передаваться не будет ** "Передавать, если указана" Учитываются только суммы из полей Оценочная стоимость заказа и Оценочная стоимость товарных вложений, где в приоритете Оценочная стоимость заказа.** "Передавать, по местам, если указана" Оценочная стоимость заказа распределяется по вложениям. Вложения в свою очередь распределяются по местам.Оценочная стоимость передается по каждому товару, а не общей суммой. Необходимо указать сумму оценочной стоимости, которая будет соответствовать количеству товаров и проверить отправку заказа.* '''Добавлять услугу «Осмотр вложений»'''. Тарифицируемая услуга от СДЭК, поэтому она добавится, только если в настройках указано '''Да''';* '''Процент за наложенный платеж'''. Используется при получении агентской цены. Калькулятор API CDEK не включает в расчет сумму за наложенный платеж автоматически, но мы добавим указанный вами процент в итоговую сумму;* '''Использовать как номер'''. Номер заказа отображается в личном кабинете и отчетах СДЭК. Выберите удобный вариант: '''Шифр''' или '''Штрихкод''';* '''Код курьера'''. Укажите код курьера, который будет указан в поле '''Вручил курьер''' для доставленных заказов.* '''Способ доставки до ПВЗ отправления'''** "Самопривоз в офис СДЭК" - установлено по умолчанию, необходимо заполнить Код пункта приема~~Интеграция~~ ** "Забор со склада" - в заказе указывается адрес склада с ~~Почтой России описана~~ которого курьеры СДЭК забирают отправления. Адрес указывается в карточке ответственного филиала для которого настраивается интеграция со СДЭК вер.2.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''' выделил вам диапазон трекинг~~<div style="color: #a94442; background-~~номеров~~color: #f2dede; border: 1px solid #ebccd1; padding: 3px 10px 10px;">* Интеграция СДЭК версии 2.0 не предусматривает автоматическую отправку заказа после получения ошибки. Чтобы отправить заказ повторно после исправления, ~~то необходимо настроить филиал и придерживаться последовательности отправки манифестов~~обратитесь в техподдержку MeaSoft.Для настройки филиала для интеграции '''PickPoint''' с диапазоном в основном меню выберите '''Справочники -> Межгород -> Филиалы''' нажатием правой кнопки мыши * Интеграция не предусматривает проверку номеров телефонов передаваемых заказов на ~~предварительно созданном филиале, в контекстном меню выберите '''Открыть''' в открывшейся форме перейдите~~ соответствие стране. api СДЭК проверяет номера телефонов на ~~вкладку '''Интеграция''' и~~ соответствие списку стран после отправки заказа. Список стран номера телефонов которых принимаются без ограничений опубликованы в ~~выпадающем списке '''Правила назначения кода заказа у подрядчика''' выберите '''Из диапазона'''~~[https://api-docs.cdek. ~~Укажите начальный и конечные коды диапазона, префикс при необходимости и нажмите клавишу '''ОК'''~~ru/29923926.html документации СДЭК]</div>

~~Для~~ При выборе тарифа для отправки ~~манифестов добавьте заказы в манифест, затем~~заказа приоритет отдается тарифам режима срочности, ~~на вкладке '''Манифесты''' необходимо добавить требуемые заказы~~ выбранного в ~~мешок, а далее выбрать~~ заказе. Если в ~~манифесте ранее настроенный филиал. После чего~~режиме срочности не настроены тарифы, то тариф выбирается из списка в ~~контекстном меню манифеста выбрать пункт~~ параметре интеграции '''~~Проставить коды у подрядчика~~Приоритет тарифов'''.~~После этого можно указать дату отправки манифеста~~В этом случае отправка в СДЭК осуществляется первым доступным тарифом из списка.

~~Обратите внимание~~Доступные для выбора списки тарифов по умолчанию:* «Экономичная посылка», ~~что проставить коды с указанной датой отправки манифеста нельзя. Необходимо сначала очистить дату отправки~~* «Посылочка», ~~а затем проставить коды~~* «Экспресс-лайт»,* «Магистральный экспресс».

~~Агентская цена данной интеграцией не возвращается~~Также возможно выбрать второй вариант, ткоторый поменяет местами тарифы «Экономичная посылка» и «Посылочка».~~к. эти данные отсутствуют в API PickPoint~~* «Посылочка»,* «Экономичная посылка»,* «Экспресс-лайт»,* «Магистральный экспресс».

~~=== КСЭ ===~~При весе отправления больше 30 кг применяется тариф «Магистральный экспресс».

~~Настройки интеграции:~~* Чтобы передать услугу «Примерка», установите флажок '''~~Данные отправителя~~Принято на склад''' ~~- данные, которые будут подставляться во все отправления, передаваемые~~ в ~~КСЭ~~[[Единица корреспонденции#Создание единицы корреспонденции|карточке корреспонденции]]. Если услуга не ~~указать, то будут передаваться данные заказчика (отправителя) из корреспонденции.~~* '''Является ИМ''' - признак отправителя в системе КСЭ. От данного признака зависит главным образом, как отправляются данные в КСЭ. Признак указывается в договоре клиента с КСЭ.* '''Забор''' - настройка, в которой можно указатьнужна, каким образом отправление передается в КСЭ - КСЭ забирает отправление у клиента или клиент сам привозит отправление в КСЭснимите флажок.

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

~~При настройке интеграции~~ В общем случае интеграция не поддерживает отправки в ~~CRM- или CMS-системе введите следующие учетные данные:~~* логин — ID клиента DOSTAVKA.GURU. ID клиента отображается вверху страницы личного кабинета клиента DOSTAVKA.GURU;* пароль — запросите API-ключ интеграции у DOSTAVKA.GURU;* код курьерской службы — 90017другие страны, кроме России.

~~== Тарификация и выбор подрядчика и его тарифа клиентом ==Вы можете настроить подключение своего тарифа к тарифу партнера~~[http://courierexe.ru/download/userfunc/SDEK_report_load.xml Загрузка отчета СДЭК] создает входящий АПД по отчету СДЭК [http://courierexe.ru/download/userfunc/SDEK_report_demo.xls такого формата]. ~~Партнерами могут быть любые компании, работающие~~ Работает при передаче заказов в ~~системе MeaSoft, а также ряд компаний,~~ СДЭК с ~~которыми у нас есть~~ помощью штатной интеграции~~, см~~. ~~список ниже. Для этого откройте~~ Заполняет поле '''~~Справочники~~Агентская цена''' > '''Статусы''', выберите '''17 Виды срочности'''. Создайте вид срочности, например «СДЭК». В контекстном меню выберите '''Дополнительная информация''' и во второй строке заполните параметры подключения к партнеру через запятую:* 1-й параметр — код филиала партнера, его можно посмотреть в ~~'''Справочники''' >~~ карточке корреспонденции на вкладке '''Межгород''' ~~> '''Филиалы''';~~* 2-й параметр — экстра-код партнера в системе MeaSoft. В том числе для сторонних компаний есть коды, см. таблицу ниже;* 3-й параметр — имя пользователя в системе партнера. Может отличаться от того, под которым работает интеграция, здесь нужно для расчета цены для клиента. В таблице ниже указано, что вводить для каждого интегратора;* 4-й параметр — пароль пользователя из 3-го параметра. В таблице ниже указано, что вводить для каждого интегратора;* 5-й параметр — вид срочности партнера. Посмотреть доступные коды видов срочности можно по ссылке в таблице ниже, в калькуляторе в выпадающем списке. Можно в одинарных кавычках указать несколько видов срочности через запятую, тогда система будет стараться выбрать из них первый доступный;* 6-й параметр — наценка к цене, передаваемой подрядчиком. В деньгах или в процентах, если стоит знак процента. Например, 10 — наценка 10 рублей, 10% — наценка 10 процентов.

~~{|class~~=~~"wikitable"!Интеграция!Код экстра!Виды срочности!Авторизация!Пример строки~~|-|БОКСБЕРРИ||90001||https://home.courierexe.ru/90001/calculator||Введите токен в 4-й параметр. 3-й можно оставить пустым. Можно оба оставить пустыми для расчета базовых цен.||33, 90001,, j3ejwo2f10b2e47790174b41f4a11111, 2, 50|-|ПИКПОИНТ||90002||https://home.courierexe.ru/90002/calculator||3-й параметр — логин, 4-й — через запятую пароль и договор ИКН. Можно оставить пустыми, но цены будут не все.||33, 90002,us0111, '6rGGuqRsW2qNQ,9990721312', 2, 50|-~~|rowspan~~=~~"2"|СДЭК||rowspan~~=~~"2"|90005||rowspan~~DPD ===<div style="~~2"|https~~color:~~//home.courierexe.ru/90005/calculator||Введите код учетной записи в 3~~#a94442; background-й параметр, секретный код — в 4-й. Можно оба оставить пустыми для расчета базовых цен.||45491, 90005, hfenJwlasiPr4pnFENpaVXSKPIn5Trh7i, '9vkQgWuiZgEj9fGCB8a6Xj3desnJkwsl,1.5', 5, 30%|-||Если вы хотите добавить в расчет тарифа процент за наложенный платеж, после пароля добавьте запятую и число процента. В настройке режима срочности пароль с числом процентов заключите в кавычки.||9vkQgWuiZgEj9fGCB8a6Xj3desnJkws,1.5|-~~|КСЭ||90008||https~~color: #f2dede; border: 1px solid #ebccd1; padding://home.courierexe.ru/90008/calculator||Введите логин в 3-й параметр, пароль — в 4-й. Пустыми оставить нельзя.||12504, 90008, Рога и копыта, 4CCB11864D06157, '2, 3, 6', 10%3px 10px 10px;">|-~~|ПОЧТА РОССИИ||90010||https:~~Внимание!</~~/home.courierexe.ru/90010/calculator||~~b><!--Введите "логин отправки" в 3-й параметр, а в 4-й в одинарных кавычках через запятую пароль отправки и токен. Пустыми оставлять нельзя, т.к. br> Для одного аккаунта DPD может быть настроена только одна интеграция ~~с Почтой пока не позволяет рассчитывать цены без договора (авторизации)~~.-- ~~Пока поддерживаются только базовые тарифы~~Если вам требуется настроить интеграцию для нескольких филиалов, ~~без авторизации~~предварительно создавайте новый аккаунт DPD для каждой интеграции.~~||10497, 90010,,, '2, 1', 10~~ <~~!--10497, 90010, 89251234567, 'mypassword,u23B0r9AAJ1Fyh4ptMzJ3kjxcslamwdx', '2, 1', 10--~~/div>|-~~|rowspan="2"|ДПД||rowspan="2"|90011||rowspan="2"|https://home.courierexe.ru/90011/calculator||Введите клиентский номер в 3-й параметр~~Статусы заказов передаются корректно, ~~клиентский ключ в 4-й. Можно оставить пустыми~~ только если для ~~базовых тарифов~~одного аккаунта DPD настроена одна интеграция.~~||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|}

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

При отправке заказа по интеграции с подключенным видом срочности интеграция постарается отправить заказ одним из режимов, введенных в п.6 (по порядку, в порядке приоритетов), а если не получится — вернет ошибку.<ul><ol>○Отсутствует</ol><ol>○С примеркой</ol><ol>○Простая</ol><ol>○С проверкой работоспособности</ol></ul>

Также можно для любой компании войти в личный кабинет по адресу вида https://home.courierexe.ru/90005 , где в конце — экстра-код партнера, авторизоваться данными из 3-го и 4-го параметров (см. таблицу выше) и воспользоваться калькулятором с тарифами именно вашей компании.=== TopDelivery ===

~~== Интеграция~~ Для настройки интеграции с ~~клиентами (получение заказов) ==~~платформой TopDelivery укажите:* '''Логин'''* '''Пароль'''* '''Информация о поставщике товара'''. Если указано '''Отправлять''', то при отправке заказа будет предпринята попытка отправить место с габаритами и товарами с указанием данных поставщика: ИНН, наименование, номер телефона. Если данных поставщика нет, информация об ошибке отправки мест будет добавлена в сообщение к заказу. Информация о поставщике повторно не отправляется.* '''Вскрытие отправления до получения оплаты''' - по умолчанию разрешено. Возможность запрета вскрытия отправления добавляется при отправке заказа, если в настройках интеграции разрешен запрет и в заказе стоит отметка "Принято на склад"

~~=== Замечания ===~~[[Файлы для загрузки#.D0.9F.D0.B5.D1.87.D0.B0.D1.82.D0.BD.D1.8B.D0.B5 .D1.84.D0.BE.D1.80.D0.BC.D1.8B .D0.B4.D0.BB.D1.8F .D0.BC.D0.B0.D0.BD.D0.B8.D1.84.D0.B5.D1.81.D1.82.D0.BE.D0.B2|Печать наклеек для TopDelivery]]

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

=== ~~OpenCart~~ PickPoint ===Если PickPoint выделил вам диапазон трекинг-номеров, то необходимо настроить филиал и придерживаться последовательности отправки [[Манифесты#Отправка|манифестов]].

~~==== OpenCart 1~~Чтобы настроить филиал для интеграции PickPoint с диапазоном, в основном меню выберите '''Справочники''' > '''Межгород''' > '''Филиалы''', откройте карточку [[Филиалы|филиала]] и на вкладке '''Интеграция''' в выпадающем списке '''Правила назначения кода заказа у подрядчика''' выберите '''Из диапазона'''.5Укажите начальный и конечные коды диапазона, префикс при необходимости и нажмите клавишу '''ОК'''.~~5.1 ====~~

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

~~==== OpenCart 2~~После этого можно указать дату отправки манифеста.~~0 и выше ====~~

~~===== Настройка интеграции =====~~Обратите внимание, что проставить коды с указанной датой отправки манифеста нельзя. Необходимо сначала очистить дату отправки, а затем проставить коды.

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

===~~== Изменение данных заказа ==~~КСЭ ===Для обращения к функциям системы необходимо знать своё имя пользователя и пароль в системе КСЭ. Если у вас еще нет доступа, то необходимо обратится к Вашему менеджеру в подразделение клиентского сервиса КСЭ.

~~# В административной части сайта откройте заказ и вверху справа нажмите на кнопку [[Файл~~Настройки интеграции:~~OpenCartEdit.png|25 px]].~~ * '''Логин''' - логин от ЛК КСЭ* '''Пароль''' - пароль от ЛК КСЭ~~# В режиме редактирования~~ * '''Данные отправителя''' — данные ~~заказа представлены на пяти вкладках~~, которые будут подставляться во все отправления, передаваемые в КСЭ. ~~Измените~~ Если не указать, то будут передаваться данные~~, для перемещения по вкладкам используйте кнопки~~ заказчика (отправителя) из корреспонденции.* '''~~Продолжить~~Является ИМ''' и — признак отправителя в системе КСЭ. От данного признака зависит главным образом, как отправляются данные в КСЭ. Признак указывается в договоре клиента с КСЭ.* '''~~Назад~~Забор''' — настройка, в которой можно указать, каким образом отправление передается в КСЭ — КСЭ забирает отправление у клиента или клиент сам привозит отправление в КСЭ.~~# На вкладке~~ ** '''~~Итоги~~По умолчанию''' ~~проверьте введенные данные и нажмите на кнопку~~ — груз будет принят для доставки в офисе (самопривоз в КСЭ) для всех заказов с товарной составляющей, иначе будет послан курьер для забора.** '''~~Применить~~До двери''' — будет послан курьер для ~~сохранения изменений в каждой строке.~~забора~~# Нажмите на кнопку~~ ** '''~~Сохранить~~Самопривоз в КСЭ'''. — груз будет принят для доставки в офисе

~~==== Возможные ошибки ====~~При выборе тарифа для отправки заказа приоритет отдается тарифам режима срочности, выбранного в заказе.

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

~~=== 1C-Битрикс===Чтобы настроить интеграцию:# В личном кабинете 1C-Битрикс на вкладке '''Администрирование'''~~ При отправке заказов учитывается тип отправления. Если в панели слева выберите '''Marketplace''' > '''Каталог решений''' и на странице «Каталог Маркетплейс» с помощью строки поиска найдите '''Модуль интеграции MEASoft'''.~~# Щелкните по ссылке «Установить».# Убедитесь~~карточке заказа указан тип [1] "Письмо", ~~что~~ то вида груза в ~~строке '''Модуль интеграции MEASoft''' установлен флажок~~CSE устанавливается, ~~и нажмите на кнопку '''Загрузить'''. Далее примите лицензионное соглашение и нажмите '''Применить'''.# После окончания загрузки нажмите на кнопку '''Установить'''.~~# В панели слева выберите '''Магазин''' > '''Настройки''' > '''Службы доставки''', затем на странице «Список служб доставок» раскройте выпадающий список кнопки '''Добавить''' и выберите пункт '''Автоматизированная служба доставки'''. Откроется страница «Новая служба доставки».# На странице «Новая служба доставки» перейдите на вкладку '''Настройки обработчика''' и в выпадающем списке '''Служба доставки''' выберите '''как "~~Курьерская служба~~Документы" [81dd8a13-8235-494f-84fd- ~~сервис доставки'''. Нажмите на кнопку '''Применить'''.# Перейдите на вкладку '''Настройки интеграции''': [[Файл:Bitrix Настройки интеграции.png|none|1100px~~9c04c51d50ec]]~~#: На этой вкладке:#* в разделе '''Настройка доступа''' введите учетные данные личного кабинета в поля '''Логин'''~~, '''Пароль''' и '''Код клиента'''. Запросите эти данные у курьерской службы, с которой настраивается интеграция. Поле '''Код клиента ПВЗ''' оставляем пустым (оно заполнится автоматически позднее).~~#* в разделе '''Основные настройки''':~~#** в поле '''Статус отправки заказа''' выберите статус, при котором заказ будет отправляться в курьерскую службу;#** в поле '''Оплата картой''' выберите тип оплаты, который будет соответствовать оплате картой (если оплата картой возможна);#** установите флажок '''Использовать артикулы''', если артикулы будут использоваться для привязки номенклатуры к складу курьерской службы;#* в разделе '''Соответствующие поля покупателя''' настройте соответствие полей получателя (ФИО, города, адреса и др.) полям в форме создания заказа.# На вкладке '''Ценовая политика доставки''' при необходимости настройте стоимость доставки для покупателя в зависимости от стоимости заказа.# На вкладке '''Ограничения''' при необходимости укажите ограничения работы модуля по географии, типам оплаты и т.п.~~# По завершении настройки нажмите на кнопку '''Сохранить'''.# В настройках магазина укажите его местоположение для определения города отправителя.~~#: Если нужно производить расчет для другого города отправителя (например, физически магазин находится в области, а курьерская служба должна считать доставку, как по городу):#* в разделе '''Рабочий стол''' > '''Настройки''' > '''Настройки продукта''' > '''Настройки модулей''' > '''Курьерская служба''' в поле '''Городаиначе [4aab1fc6-fc2b-473a-8728-~~отправители''' добавьте город отправителя;~~#* в разделе '''Рабочий стол''' > '''Магазин''' > '''Настройки''' > '''Службы доставки''' > Нужная служба > '''Настройки интеграции''' > '''Город отправитель''' укажите добавленный выше город58bcd4ff79ba] "Груз".

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

'''Примечание'''. Значения полей '''Комментарий покупателя к заказу''' и '''Комментарий менеджера''' передаются из 1С<!--~~Битрикс в поле '''Комментарий''' заказа в системе MeaSoft~~=== DOSTAVKA.GURU ===

~~Если статус уже установлен, но заказ не отправлен в курьерскую службу (связано с техническими особенностями)~~'''Настройка'''. Для интеграции введите следующие учетные данные:~~# Выберите статус заказа по умолчанию после его создания (например,~~ * '''~~Новый~~Идентификатор клиента''')— ID клиента DOSTAVKA.GURU. ID клиента отображается вверху страницы личного кабинета клиента DOSTAVKA.GURU;~~# Перезагрузите страницу~~* '''Ключ клиента''' — запросите API-ключ интеграции у DOSTAVKA.GURU.* '''Регион откуда повезется заказ''' - Доступен выбор из трех вариантов:<ul>~~# Выберите статус~~ <ol>○ По договору (В этом случае, мы не сообщаем о регионе отправки в систему Guru и ~~сохраните его~~регион определяется договором с DOSTAVKA.GURU)</ol>~~При отправке заказа появится сообщение об успешной отправке или об ошибке.~~<ol>○ Москва</ol><ol>○ Санкт-Петербург</ol>~~Статус заказа можно проверить в карточке заказа, в правом верхнем углу.~~</ul>

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

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

Полный список недопустимых символов:<~~spoiler text="Если возникает ошибка"~~code>~~# Если не рассчитывается стоимость:#* некорректно установлен модуль;#* введены некорректные учетные данные;~~#* в курьерской службе не настроен тариф. Обратитесь в курьерскую службу для настройки тарифа. После настройки тарифы можно проверить в личном кабинете, на вкладке ['~', '~~Калькулятор~~`', '@'.# По умолчанию при оформлении заказа должны появиться поля даты и времени желаемой доставки. Если они отсутствуют, ~~то у формы были изменены стили. Также возможно обновление формы в системе Битрикс.[[Файл:Bitrix2.png|center|700 px]]~~'# ~~Проверьте правильность привязки свойств. Для этого в разделе~~ ', '$'~~Рабочий стол~~, '%', ' > ^', '&'~~Магазин~~, '=', ' > +', '!'~~Настройки~~, '"', ' > №', ';'~~Свойства заказа~~, ':', ' > ?', '\'~~Список свойств~~, '\s'~~' найдите свойство~~, ~~связанное с ошибкой, щелкните по нему правой кнопкой мыши и выберите~~ '*', '~~Изменить параметры свойства~~(', '_'~~. На вкладке~~ , '{', '~~Привязка свойства~~}', '.' ~~настраиваются условия~~, ~~при которых поле будет показываться клиенту. Если у свойства заказа настроена привязка~~', ~~то оно будет показываться ТОЛЬКО в том случае~~', ~~когда покупатель выберет хотя бы один из указанных критериев:~~'\[~~[Файл:Битрикс Связь свойства.png|center|500px~~', '\]', '\']</code>

~~В этом примере покупатель при оформлении заказа увидит созданное поле~~ Кроме того, для заполнения только в том случае, если на предыдущих шагах он выбрал оплату '''Наличными курьеру''' (при любой службе доставки), или же если захотел расплатиться любым способом, но выбрал в качестве службы доставки '''Воздушный транспорт'''штрихкодов недопустима кириллица.

Свойство будет показано всегда, если привязка не выбрана или если выбраны все варианты платежных систем или служб доставки'''Статусы'''. Запрашиваются интеграцией в автоматическом режиме. Изменение статуса на стороне Guru изменит и статус заказа в соответствии с картой статусов.

~~Подробнее см~~'''Агентская цена'''. ~~[https://dev~~Обновляется при получении статусов.~~1c-bitrix~~Агентская цена Guru публикуется в разрезе стоимости услуг и тарифов, которые суммируются перед обновлением агентской цены в заказе.~~ru/learning/course/index.php?COURSE_ID=42&LESSON_ID=3073&LESSON_PATH=3912.4580.4828.3073 документацию 1С-Битрикс].</spoiler>~~

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

~~Чтобы настроить интеграцию~~=== 5POST ===Параметры для настройки:~~# В личном кабинете InSales откройте~~ * '''~~Приложения~~API-ключ''' > * '''~~Центр приложений~~Код склада отправителя'''~~, с помощью строки поиска найдите модуль «Курьерская служба 2008» и нажмите на кнопку~~ * '''~~Установить~~Уникальный номер партнера в системе 5Post'''.~~# Откроется личный кабинет InSales. На странице «Установка приложения» нажмите на кнопку~~ * '''~~Установить~~Максимальный вес для фиксированного тарифа'''.# В списке установленных приложений выберите «Модуль "Курьерская служба 2008"». Откроется страница авторизации личного кабинета клиента курьерской службы. Если вы авторизованы в ЛК курьерской службы- При привышении установленного веса, ~~то сразу откроется страница настроек, см~~сумма тарифа изменяется пропорционально. ~~п. 5~~По умолчанию 3кг.~~# Введите учетные данные личного кабинета в поля '''Логин''', '''Пароль''' и~~ * '''Код ~~курьерской службы~~подрядчика в карточке заказа'''~~. Запросите эти данные у курьерской службы, с которой настраивается интеграция.~~- доступно три вида отображения кода подрядчика:<ul>~~# На странице «Настройка интеграции~~ <ol>○ Оригинальный код 5post - Установлено по умолчанию</ol><brol>~~Особенности заполнения полей~~○ Код для ~~автоматической передачи заказов с определенным статусом~~ поиска заказа в ~~курьерскую службу. Возможные значения~~ЛК 5post</ol><ol>○ Код грузоместа</ol>#* '''Статус отправления заказа в курьерскую службу (если отправляется автоматически)'''. Выберите из выпадающего списка заранее созданный статус, который будет использоваться для автоматической передачи заказов в курьерскую службу.</ul>#* '''~~Отправлять статус заказа в Insales~~Габариты мест'''~~. Определяет, отправляется ли статус успешной доставки заказа в InSales. Возможные значения: '''Да''', '''Нет'''.~~#* '''Отправлять артикулы (для привязки к складу)'''. Если опция включена, артикулы товаров из InSales передаются в MeaSoft. <ul>#* '''Название доставки курьером на странице заказа'''. Укажите название доставки, которое будет отображаться в заказе вместо «Курьерская доставка МЕАСОФТ» при выборе способа доставки. Можно оставить поле пустым, тогда список будет выглядеть следующим образом<ol>○ Группировать - Установлено по умолчанию #* '''Описание доставки курьером на странице заказа'''. Укажите описание вида доставки. Можно оставить поле пустым.~~#* '''Переводить заказ в специальный статус в случае ошибки передачи заказа?'''. Определяет~~При установке этого значения, ~~используется ли специальный статус для обозначения заказов~~ всегда передается только одно место с ~~ошибкой передачи данных. Возможные значения: '''Да''', '''Нет'''~~обобщенными габаритами и кодом соответствующим коду заказа.#* '''Синхронизировать остатки по складам'''. Если опция включена, данные по складским остаткам из курьерской службы передаются в InSales.</ol>#* '''Используется мультисклад?'''. Определяет, используется ли выбор товаров с одного склада или из нескольких. Возможные значения<ol>○ ~~'''Настройки магазина'''~~ Отправлять указанные ~~'''Мультисклад'''.) указано такое же количество складов~~При установке этого значения, ~~как в системе MeaSoft.~~#* '''Специальный статус на случай ошибки передачи заказа'''. Выберите из выпадающего списка заранее созданный статускаждое место отправляется отдельно, ~~который будет использоваться для обозначения заказов~~ с ~~ошибкой передачи данных~~соответствующими ему габаритами и кодом.~~# По заполнении нужных полей нажмите '''Сохранить'''.~~</ol></ul>

~~В результате в InSales в окне создания заказа появляется блок «Модуль "Курьерская служба 2008"»:::[[Файл:Insales Module KS.png|none|300 px]]Тип оплаты заказа определяется следующим образом:~~* ~~если заказ оплачен, то передается тип оплаты~~ '''~~Оплачен~~Тип расчета тарифа'''<ul><ol>○ Общий - Установлено по умолчанию</ol>* если тип оплаты '''Оплата банковской картой''' или '''Оплата банковской картой курьеру''', то передается тип оплаты '''Банковская карта'''. Указанные типы оплаты необходимо создать в InSales вручную<ol>○ ~~'''Оформление заказа'''~~ По местам</ol> ~~'''Оплата''';~~* иначе передается тип оплаты '''Наличными'''.В системе MeaSoft в карточке интернет-магазина есть флажок '''Спрашивать тип оплаты у получателя'''. Если он установлен, то независимо от переданного типа оплаты '''Наличными''' или '''Банковская карта''' покупателю будет предложен выбор способа оплаты.</ul>

~~Настройки~~ В интеграции ~~можно изменить в разделе '''Автоматизация''' [[Личный кабинет клиента#Автоматизация|личного кабинета MeaSoft]]~~5post не предусмотрена передача оригинальных штрихкодов мест.Штрихкоды генерируются по правилам 5post.Предварительно, 5post предоставляет возможность добавления оригинального штрихкода места, который должен отвечать следующим правилам:

~~=== RetailCRM ===~~* Штрихкод должен состоять только из символов ASCII в диапазоне с 0 по 127 индекса. * Длина штрихкода не должна превышать 34 символа.

~~См. раздел «[[RetailCRM]]»~~=== Яндекс.Доставка ===

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

~~Чтобы настроить интеграцию:~~Сначала необходимо проверить, рассчитывается ли стоимость доставки в ЛК Яндекса и можно ли оформить заказ. Если все работает - переходим к настройке интеграции.

~~# Скачайте архив модуля установки по [http~~Для настройки интеграции с платформой Яндекс.Доставка укажите следующие параметры:~~//courierexe.ru/download/api/ms_courierexe-v1.1.1.zip ссылке].# В панели администратора CS-Cart откройте~~ *'''~~Модули~~Токен''' ~~> '''Управление модулями''' и на странице «Модули» нажмите на кнопку [[Файл~~, можно посмотреть тут https:~~Cscart добавить~~//dostavka.~~png|25 px]]. Откроется окно «Загрузить и установить модуль»~~yandex.ru/account/integration~~# В этом окне нажмите на кнопку~~ *'''~~Загрузить~~ID пункта отправления''', выберите архив с модулем на компьютере и нажмите на кнопку '''Загрузить и установить'''. Модуль «Курьерская служба 2008» появится необходимо уточнить у вашего менеджера или в ~~списке модулей.~~поддержке Яндекса~~# Откройте~~ * '''~~Администрирование~~Особенности формирования данных''' ~~> '''Доставка и налоги''' > '''Способы доставки''' и нажмите~~ с вариантами на ~~кнопку [[Файл:Cscart добавить.png|25 px]]. Откроется окно «Новый метод доставки»~~выбор:~~#: [[Файл:Cscart настройка.png|900px|none]]~~#:~~# В этом окне укажите следующие настройки:~~#* ~~в поле '''Расчет тарифа''' установите переключатель '~~* ''~~В режиме реального времени~~нет''';#* ~~в выпадающем списке~~ * ''Трактовать места, как товары'~~Перевозчик~~'~~'' выберите значение '''КС2008''';~~- в заказе формируется только одно место в котором размещаются вложения с габаритами и массой переданных мест.#* ~~в выпадающем списке '''Служба доставки''' выберите режим срочности по умолчанию;~~#* ~~заполните остальные поля.# Нажмите на кнопку~~ ''~~'Создать'~~Трактовать товары, как места''- каждый товар добавляется в место соответствующее его габаритам, т. ~~Появляется оповещение~~ о ~~том~~., ~~что изменения сохранены~~сколько в заказе товаров, ~~и в этом~~ столько же ~~окне появляются кнопки настройки~~будет сформировано мест. ~~Нажмите~~ Эти параметры обязательные и влияют на ~~кнопку '''Настроить''':#: [[Файл:Cscart курьером~~отправку заказа.~~png|800 px|none]]~~#:~~# В этом окне укажите следующие настройки:#* введите учетные данные клиента курьерской службы~~Доступы должны быть НЕ тестовые (продовые). ~~Запросите~~ Уточните эти данные у ~~курьерской службы, с которой настраивается интеграция;~~вашего менеджера или в поддержке Яндекс.Доставки.#* ~~Укажите тип доставки. Возможные значения:~~ '''~~Курьером до двери~~Настройка списка ПВЗ'''- Позволяет настраивать список получаемых от Яндекс ПВЗ, доступны варианты:** '''Получать все доступные ПВЗ'''.~~# Нажмите на кнопку~~ ** ''Отключить постаматы'~~Сохранить~~'~~''.Чтобы проверить работу интеграции, нажмите на кнопку~~ ** ''~~'Общее''', нажмите '''Рассчитать стоимость доставки''', введите вес отправления и нажмите на кнопку~~ Отключить все ПВЗ''~~'Тест'''. При настроенной интеграции отобразится окно с расчетной стоимостью и сроком доставки.~~

~~Чтобы создать два способа доставки — '''Курьером до двери''' и '''ПВЗ''', повторите все шаги, начиная с п. 4.~~

В результате новые способы доставки будут отображаться в списке '''Администрирование''' > '''Доставка и налоги''' > '''Способы доставки''' и в окне создания заказаДля настройки модулей используйте:

~~::[[Файл:Cscart оформить заказ~~*'''Логин''' - ваш токен.~~png|700 px|none]]~~

~~Чтобы просмотреть полученные заказы, откройте~~ *'''~~Заказы''' > '''Полученные заказы~~Пароль'''- Код пункта отправления. ~~В карточке заказа в правом нижнем углу находится блок модуля «Курьерская служба 2008»:~~ Имеет вот такой формат 4eccdad3-8d97-4fbf-b241-3c2a89a8aa79

~~::[[Файл:Cscart блок кс~~*'''Код курьерской службы''' - 90023.~~png]]~~

~~Чтобы передать заказ~~ ==== Настройка забора ====Забор в ~~курьерскую службу~~заказе определяется Пароль - Код пункта отправления (ID Станции на стороне Яндекс), ~~нажмите~~ если Пароль указывает на ~~ссылку '''Отгрузить'''~~склад клиента, с которого курьер Яндекса будет забирать отправления, согласно расписанию календаря отгрузок. Календарь отгрузок настраивается в личном кабинете Яндекс. Склад отгрузки так же добавляется в личном кабинете Яндекс.

~~Также в этом блоке вы можете проверить статус доставки заказа~~<div style="color: #a94442; background-color: #f2dede; border: 1px solid #ebccd1; padding: 3px 10px 10px;">Настроить забор можно только на стороне Яндекс, [https://yandex.ru/support2/delivery-profile/ru/other-day/rules#from-warehouses согласно инструкции]. </div> Для получения ID Станции отправления, требуется на стороне Яндекс:

* 1. Добавить склад в Избранные адреса, по инструкции в ссылке.* 2. Запланировать отгрузку на этот склад через Календарь отгрузок.* 3. Написать на почту в техподдержку Яндекс next_day_delivery@go.yandex.ru или чат поддержки в личном кабинете и запросить у специалиста техподдержки Яндекс ID Станции (склада, который был зарегистрирован, согласно инструкции).

Интеграция реализована через виджет «Курьерская служба 2008», предназначенный для передачи заказов из amoCRM в MeaSoft и возврата статусов.

~~Чтобы начать отправлять заказы в курьерскую службу~~При создании заказа обратите внимание на адрес — он должен быть понятным. Наиболее понятным для Яндекса будет адрес, ~~настройте интеграцию~~ где нет дополнительных комментариев, а части адреса разделены запятыми. Без заполнения адреса с ~~MeaSoft и сопоставьте поля amoCRM и виджета для корректной передачи данных в MeaSoft~~указанием номера дома курьерская доставка будет не доступна.

~~==== Настройка интеграции ====~~Для удобства работы перед настройкой интеграции добавьте дополнительные поля в сделке: выберите '''Сделки''' > '''Новая сделка''' и В интеграцию не принимаются заказы на ~~вкладке '''Настроить''' добавьте~~ юридические лица. Т.е. в ~~любую группу новые поля '''Стоимость доставки''', '''Стоимость товаров'''~~поле ФИО должно быть именно ФИО, ~~'''Закупка'''~~а не название организации.

~~[[Файл:Amo Settings~~Если заключен договор на передачу в Яндекс уже оплаченных товаров и производится попытка отправить запрос на передачу заказа с типом оплаты «Наличными» - Яндекс возвращает ошибку «Тариф не найден». Если клиент оплачивает заказ на сайте, затем передает в доставку, необходимо передавать значение «NO».~~png|none|500 px]]~~

~~Чтобы настроить интеграцию с amoCRM:~~# Этот этап можно делать из [[Личный кабинет клиента#Интеграция|личного кабинета MeaSoft]] '''ИЛИ''' из административной части amoCRM:~~#* В личном кабинете MeaSoft:~~#*# В разделе '''Автоматизация''' перейдите на вкладку '''Обратная интеграция''' и в таблице «Список всех обратных интеграций» в строке «AmoCRM» нажмите '''Добавить'''Отправка заказов происходит автоматически.~~#*#Укажите название интеграции~~ Если адрес не распознан и ~~префикс и нажмите на кнопку '''Сохранить'''.#*#Укажите аккаунт amoCRM~~заказ не отправлен с первой попытки, ~~в котором будет установлен виджет «Курьерская служба 2008»~~ интеграция попытается разобрать адрес доступными ей средствами и ~~нажмите '''Разрешить'''~~снова отправить заказ. ~~Виджет установлен.#* В административной части amoCRM:#*# В меню выберите '''Настройки''' > '''Интеграции'''~~ Если заказ так и ~~в строке поиска введите «Курьерская служба 2008».#*#Щелкните по найденному модулю~~не получилось отправить, ~~нажмите на кнопку '''Установить'''. Виджет установлен.~~# В amoCRM выберите '''Настройки''' > '''Интеграции''' и в разделе '''Установленные интеграции''' откройте «Курьерская служба 2008».~~# Введите логин~~проверьте адрес получателя, ~~пароль и код курьерской службы. Запросите эти данные у курьерской службы~~возможно, ~~с которой настраивается интеграция.# Нажмите на кнопку '''Настройки виджета'''. В окне «Настройки интеграции с Курьерская служба 2008»:## Установите параметры товаров и доставки.~~## Установите поля для сохранения данных заказа. Например, в выпадающем списке поля '''Сохранять стоимость товаров в отдельное поле''' укажите значение '''Сохранять в поле: Стоимость товаров'''.~~## Укажите, откуда будут добавляться товары к заказу. Если это список~~ в ~~amoCRM, настройте соответствие полей. Списки amoCRM доступны начиная с тарифного плана «Расширенный».## Установите соответствие между статусами в личном кабинете клиента курьерской службы и статусами amoCRM.## Нажмите '''Сохранить настройки'''~~нем допущена ошибка.~~# В окне ввода учетных данных интеграции нажмите '''Сохранить'''~~После исправления адреса заказ отправится автоматически.

~~==== Сопоставление полей ===={|class="wikitable"!Поле виджета!Данные amoCRM!Где настраивается сопоставление~~|-~~|'''Имя''', '''Телефон'''||Поля карточки контакта||-~~|-~~|'''Номер~~ При отправке заказа~~'''||• Название сделки; • ID сделки; • пользовательское поле||'''Настройки виджета''' > '''Настройки интеграции~~ обязательно указываются места с ~~Курьерская служба 2008'''~~|-~~|'''Город'''~~габаритами и массой. Если в заказе указаны места, ~~'''Адрес'''~~они добавляются как есть. Если мест в заказе нет, ~~'''Индекс'''~~то создается одно фиктивное место, '''Примечание''', '''Дата доставки'''|| Поля сделки|| '''Настройки виджета''' > '''Настройки интеграции с Курьерская служба 2008'''|-~~|'''Вес''', '''Сумма''', '''Объявленная ценность''', название~~ габариты которого формируются на основе габаритов вложений. Вложения не разделяются по местам и количество товара||Карточка товара||• Если товар добавляется вручную или из каталога Курьерской службы 2008, сопоставление не требуется; • если товар добавляется из списка amoCRM, настройте сопоставление в '''Настройки виджета''' > '''Настройка товаров'''|-~~|'''Количество мест'''|| - ||Заполняется~~ попадают в ~~виджете вручную~~|}первое сформированное место.

~~===Беру===При~~ После настройки модуля или создания новой интеграции ~~поддерживается:~~* Обработка координатПВЗ появляются на следующий день.

~~===Мой Склад===~~Для смены пароля зайдите в ЛК с токеном и старым id ПВЗ, как в модуле. Выберите '''Сменить пароль''' и укажите старые и новые пароли.

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

~~Чтобы настроить интеграцию:~~

~~# В системе «Мой Склад» создайте дополнительные поля в заказах:~~

~~#* с типом «Строка»:~~

~~#** '''Город''' — для указания населенного пункта получателя;~~

~~#** '''Дата доставки''' — для указания даты доставки наряду со временем;~~

~~#** '''Сумма заказа''' — для получения суммы заказа от курьерской службы;~~

~~#** '''Стоимость доставки''' — для получения стоимости доставки от курьерской службы;~~

~~#** '''Строка для сохранения информации об ошибках''' — для получения текста ошибки;~~

~~#** '''Количество мест''' — для возможности указания количества мест;~~

~~#* с типом «Файл»:~~

~~#** '''Файл''' — необязательное поле для передачи файлов. Максимальный размер файла — 1 МБ;~~

~~#* с типом «Справочник»:~~

~~#** '''Виды срочности''' — одноименный справочник;~~

~~#** '''Временные интервалы''' — одноименный справочник;~~

~~#** '''Способы доставки''' — одноименный справочник;~~

~~#** '''Тип оплаты''' — одноименный справочник;~~

~~#** '''Время доставки с''' — справочник '''Часы доставки''';~~

~~#** '''Время доставки по''' — справочник '''Часы доставки'''.~~

# Перейдите по [https://home.courierexe.ru/moysklad/step1 ссылке] и введите логин и пароль от системы «Мой склад». Затем укажите логин, пароль и код курьерской службы. Запросите эти данные у курьерской службы, с которой настраивается интеграция. '''Примечание'''. После настройки интеграции не рекомендуется менять логин и пароль от системы «Мой Склад». Это приведет к сбою интеграции. Если все же есть необходимость сменить учетные данные, после сообщите новый пароль от «Мой Склад» в техподдержку MeaSoft для внесения изменений в настройки интеграции.

# Нажмите на кнопку '''Сохранить'''. В случае ошибки «Данный пользователь "Мой склад" уже зарегистрирован.» нажмите на кнопку '''Сбросить'''.

# Дождитесь окончания синхронизации справочников. Не закрывайте и не перезагружайте страницу. Процесс может занять продолжительное время (от 10 минут). После синхронизации справочников автоматически произойдет переход на страницу следующего шага.

~~# Настройте статусы отправки, соответствие полей и соответствие статусов.~~

~~# Сохраните настройки.~~

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

При заполнении информации по заказу поля '''Cтоимость доставки''', '''Сумма''' и '''Ошибка''' заполнять не нужно. Они заполнятся автоматически после синхронизации с курьерской службой.

~~Если нужна доставка по адресу~~Обратите внимание, ~~оставьте поле '''Тип доставки''' пустым. Иначе выберите ПВЗ из списка~~что в зависимости от настроек вашего аккаунта в Л-Пост может быть недоступна частичная оплата заказа.

~~Данные из поля '''Комментарий''' передаются в заказ автоматически.~~=== Omnic ===Для настройки интеграции с платформой Omnic укажите следующие параметры:

~~Чтобы отправить заказ~~* '''Логин''' - создается самостоятельно, ~~присвойте заказу статус~~ служит для ~~передачи в курьерскую службу~~доступа к [https://home. ~~Заказ отправляется в курьерскую службу~~courierexe.ru/90025 ЛК экстраинтегратора], может быть любым, главное запомните его.

~~Если после сохранения заказа в статусе для передачи в курьерскую службу статус не изменился, проверьте поле~~ * '''~~Ошибка~~Пароль'''~~. Заполните поля, указанные~~ является составным и обязательно должен содержать токен (получается в ~~поле '''Ошибка''', очистите поле '''Ошибка''' и сохраните заказ~~службе поддержки омника).

Чтобы проверить, передан ли заказ в курьерскую службу, зайдите в Личный кабинет курьерской службы и проверьте с помощью вкладки '''Отслеживание''', существует ли отправленный заказ.Так же может содержать

'''~~Известные проблемы~~ПВЗ отправления'''- код ПВЗ подрядчика, пункт самопривоза. Не обязательный параметр

~~Модуль интеграции не работает на бесплатном тарифе~~'''Приоритет тарифов''' - последовательность тарифов подрядчика, разделенная пробелами, указывающая доступность и приоритет тарифов в общем случае.Не обязательный параметр

~~При установке приложения в «Моем Складе» в нем регистрируется~~ <~~rspoiler text="событие"~~br>веб-хук</rspoiler> на изменение заказа, чтобы «Мой Склад» передавал изменения в MeaSoft. Так работают все модули служб доставки для «Моего Склада». «Мой Склад» поддерживает только одно событие для заказа, поэтому, если оно занято другим <rspoiler text="установленным модулем">Или модуль может быть удален или не до конца установлен, а зарегистрированное событие от него осталось</rspoiler>, MeaSoft не сможет его занять, и отправка заказов работать не будет. Если ~~у вас не отправляются~~ омник забирает заказы ~~и вы уверены, что~~ у вас нет других модулей, использующих это событие, обратитесь к нам в службу поддержки, мы сможем проверить занятость события и при необходимости его освободить.

~~===Wordpress===~~Пример cf3f645a5afc2e7ae030522711b4464af77dcb2d11997f1ddf5f1de81b003906~~====Требования к сайту перед установкой плагина:====#CMS WordPress версии 5, или более новая.#WooCommerce версии 3.9, или более новая.#PHP версии 7, или более новая.#Сайт должен использовать SSL-сертификат~~

~~====Порядок установки плагина и вывод нового способа доставки в корзину:====~~#В панели администратора вашего сайта откройте страницу “Плагины - Добавить новый” и нажмите на кнопку “Загрузить плагин”~~#В появившейся форме выберите архив с плагином на вашем компьютере и нажмите кнопку “Установить”#После загрузки и установки плагина~~ Если вы ~~можете его активировать нажав~~ сами привозите отправления на ~~соответствующую кнопку~~ ~~#После активации плагина~~ склад или в меню появится ссылка на страницу настроек плагина.Заполните все необходимые поля и нажмите кнопку “Сохранить изменения”ПВЗ омника (самопривоз) пароль будет ТОКЕН, КОД ПУНКТА САМОПРИВОЗА. ~~#Откройте настройки WooCommerce и переключите на вкладку “Доставка”#Выберите необходимую зону доставки~~Пример cf3f645a5afc2e7ae030522711b4464af77dcb2d11997f1ddf5f1de81b003906, ~~или создайте её.#Нажмите на кнопку “Добавить метод доставки” и выберите из списка “КС2008”~~MSK317#После создания заказа, в панели администратора, в форме изменения заказа, справа появится блок модуля "Отправить в курьерскую службу, снизу которого будет кнопка "Отправить заказ в КС2008", при нажатии на которую заказ будет отправлен в курьерскую службу.

~~====Обновление статусов====~~Если есть необходимость ограничить используемые тарифы, укажите те, которые можно использовать, в пароле: ~~Обновление статусов заказов происходит через технологию WP_Cron каждые 30 минут.~~ Пример cf3f645a5afc2e7ae030522711b4464af77dcb2d11997f1ddf5f1de81b003906,MSK317,,32 26

~~Если статус заказа~~ Для настройки модулей в курьерской службе будет изменен на “Доставлен”, то статус заказа в вашем магазине также будет изменен на “Выполнен”поле "Код клиента" укажите 90025. <div style="color: #a94442; background-color: #f2dede; border: 1px solid #ebccd1; padding: 3px 10px 10px;">Внимание! При использовании прямых интеграций и модулей необходимо использовать второй режим срочности [2] Посылка. Алгоритмический тариф. В разных модулях может выбираться из списка или вводиться числом. При выборе другого режима срочности интеграции и модули могут работать не верно либо рассчитывать не все возможные варианты. </div>

===~~Проверка работоспособности интеграций~~BTS Узбекистан ===Для настройки интеграции с BTS укажите следующие параметры:

~~При неполадках интеграции проверьте ее работоспособность~~* '''Токен API''' - это обязательное поле. ~~В общем случае для этого достаточно создать заказ~~ Заполните его правильно, и ~~отправить его~~ заказы будут отправляться в ~~курьерскую службу~~BTS.Оставшиеся поля служат для более тонкой настройки создания заказов:

~~Если заказ отправлен без ошибок и отображается в ЛК~~* '''Отправка корреспонденций ''', ~~значит~~может принимать значения:** ''Со склада''** ''С адреса отправителя''* '''Вызов курьера отправителем''', ~~интеграция настроена. Если отправка не удалась~~может принимать значения:** ''Нет''** ''Забрать у отправителя''* '''Тестовый режим интеграции''', ~~ошибка~~ может ~~быть в настройках интеграции или в заполнении формы отправки заказа~~принимать значения:** ''Нет''** ''Включен тестовый режим''* '''Код курьера''' - Все заказы отмечаются, как доставленные указанным курьером.

~~Текст ошибки можно увидеть через [[Личный кабинет#Отладка|отладку]]~~ Для отправки заказа:* населенные пункты отправителя и получателя должны быть синхронизированы со списком населенных пунктов BTS. Если один из населенных пунктов не будет синхронизирован, то в ~~личном кабинете~~карточку заказа будет добавлено сообщение об ошибке:** ''Уточните город получателя'' или ** ''Уточните город отправителя''* заказ должен иметь одно грузоместо. ~~Чтобы найти свой~~ Если заказ ~~в запросах~~не имеет грузомест или имеет более одного грузоместа, то он интеграция заблокирует отправку, ~~нажмите клавиши CTRL + F и введите~~ а в ~~строку поиска номер заказа или ориентируйтесь на время создания~~ сообщении о доставке карточки заказаопубликуется сообщение: ** ''грузоместо должно и может быть только одно.''

~~Убедитесь~~<div style="color: #a94442; background-color: #f2dede; border: 1px solid #ebccd1; padding: 3px 10px 10px;">Внимание! * Заказ должен иметь Одно грузоместо.* Для отправки заказа, ~~что выполнены все шаги инструкции~~ населенные пункты отправителя и получателя должны быть синхронизированы со списком BTS. * Cинхронизация населенных пунктов, отсутствующих в списке BTS, проводится по ~~настройки интеграции из этого раздела.~~запросу в техподдержку</div>

~~Ниже представлено описание проверки работоспособности для разных интеграторов~~== Отмена заказов в интеграциях ==<div style="color: #a94442; background-color: #f2dede; border: 1px solid #ebccd1; padding: 3px 10px 10px;">Реализовано в интеграциях Почта России, 5Post, Gtd, СДЭК 2.0, YandexLogistic, LPost, Omnic.</div>Если корреспонденция была отправлена в интеграцию, но вы заметили ошибку в данных, либо из интеграции после отправки пришел отчет об ошибке (как например происходит в интеграции СДЭК версии 2.0), то корреспонденцию можно отправить по интеграции повторно, предварительно отменив ее предыдущую отправку. Для этого нужно произвести следующие действия:

~~'''RetailCRM'''~~Если ошибка очевидна: <ul><li>Отмените корреспонденцию в интеграции (Вкладка "Межгород" в карточке корреспонденции, кнопка "Отменить", нажатие кнопки "Сохранить" в карточке корреспонденции). При этом статус корреспонденции в интеграции сменится на "Отменяется"

~~# Убедитесь, что выполнены все шаги [[RetailCRM#Настройка интеграции|инструкции по настройке интеграции]].~~

~~# Если используются триггеры, убедитесь, что они настроены согласно [[RetailCRM#Настройка триггеров|инструкции]].~~

~~# Создайте заказ, заполните требуемые данные.~~

# Нажмите на кнопку '''Сохранить''' внизу страницы, флажок '''Не отправлять данные в службу доставки''' должен быть снят. Заказ должен отправиться в курьерскую службу.

~~# Если возникает ошибка, ее текст отображается наверху страницы.~~

:: Если это ошибка заполнения формы, исправьте внесенные данные и попробуйте отправить заказ снова. Пример ошибки: «Ошибка сервиса доставки "Курьерская служба 2008": field [receiver phone] has no valid phone number»

:: Если это ошибка ответа курьерской службы, сообщите об этом разработчику. Пример ошибки: «Служба доставки прислала ответ в неверном формате».

~~'''Мой склад'''~~

# В личном кабинете клиента курьерской службы в настройках обратной интеграции '''Мой склад''' в поле '''В каком статусе "Мой склад" отправлять заказ на доставку''' уточните статус, при котором заказ отправляется в курьерскую службу[[Файл:2023-04-03_11-26-09.png |700px]]# Заполните форму заказа, нажмите на кнопку '''Сохранить''', затем смените статус заказа на статус, установленный для отправки в курьерскую службу и снова нажмите на кнопку '''Сохранить'''. Если все верно, заказ будет отправлен в курьерскую службу.~~# Обновите страницу в браузере и проверьте поле '''Строка для сохранения информации об ошибках''':#* если поле пустое и заказ пришел в личный кабинет, интеграция работает;#* если поле пустое и заказ не пришел в личный кабинет, обратитесь к разработчику;#* если в поле содержится текст ошибки, исправьте ее в форме заказа и попробуйте отправить его снова.~~

~~'''InSales'''~~</li><li>Если заказ не удалось отменить на стороне подрядчика, (например, заказ уже находится в процессе доставки), то статус заказа изменится на "В работе у подрядчика".В этом случае, изменение заказа возможно только в личном кабинете подрядчика, либо обращением в техподдержку подрядчика.

# В личном кабинете клиента курьерской службы в настройках обратной интеграции '''InSales''' проверьте данные в следующих полях:

~~#* '''Отправлять заказы в курьерскую службу автоматически после изменения статуса''';~~

~~#* '''Статус отправления заказа в курьерскую службу (если отправляется автоматически)''';~~

~~#* '''Список доставок для отправления заказа в курьерскую службу (если отправляется автоматически)''';~~

~~#* '''Оплачен ли заказ? (если отправляется автоматически)'''.~~

# Создайте заказ и в случае ошибки проверьте данные заказа на соответствие этим полям. Например, в заказе может быть установлен тип доставки, не отмеченный как используемый в настройках в личном кабинете.

При возникновении ошибок при отправке заказа появляется диалоговое окно с сообщением об ошибке. Исправьте ошибку в форме заказа и попробуйте отправить его снова[[Файл:2023-04-03_11-52-20.png |700px]]

~~'''amoCRM'''~~</li><li>Если заказ был успешно отменен (в этом случае интеграция сама удалит заказ на стороне подрядчика), то по истечении 1-15 минут статус заказа в интеграции сменится на "Отменен". Ответственный филиал корреспонденции будет автоматически переключен на главный ответственный филиал, а код подрядчика (если он был присвоен) будет удален. Только после этого можно считать, что корреспонденция полностью отменена в интеграции и можно приступать к ее повторной отправке.

~~Ошибка при создании заказа отображается в левом нижнем углу.~~

~~== RBK.money ==~~ ~~Чтобы настроить прием платежей через систему «RBK.money»:# Перейдите по ссылке https~~[[Файл:~~//welcome.rbk~~2023-04-03_12-03-35.money/ и нажмите '''Подключиться'''. С вами свяжутся сотрудники и вышлют инструкцию для заключения договора и дальнейшей работы.# После завершения регистрационных действий введите полученный публичный ключ и идентификатор в настройках личного кабинета курьерской службы. Подробнее см. [[Личный кабинет курьерской службы#Вкладка «Финансы»png |~~настройки личного кабинета~~700px]].

</li><li>Внесите исправления в данные корреспонденции. Сохраните ее.</li><li>Для повторной отправки корреспонденции по интеграции (предварительно убедившись, что все ошибки исправлены) вновь назначьте для корреспонденции ответственный филиал интеграции </li><li>После повторного назначения в корреспонденции ответственного филиала интеграции ожидайте сообщения об отправке. При повторной отправке этот процесс может занимать до 30 минут.</li><li>При ~~успешной оплате заказ~~ возникновении ошибки, если она очевидна, вновь исправьте ошибку в корреспонденции и повторите процесс повторной отправки (отмена, исправление ошибок, повторное назначение на ответственный филиал интеграции)</li></ul>Если при получении ошибки от подрядчика нет понимания ее причин, пожалуйста напишите в ~~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|рис.1 Конфигурация PimPay]]

Чтобы продолжить, вам нужно сгенерировать ключи шифрования. Это делается на UNIX-подобной системе: [http://platform.api.pimpay.ru/v2_7/signature/openssl http://platform.api.pimpay.ru/v2_7/signature/openssl] или <spoiler text="наша инструкция">~~Чтобы получить приватный ключ, необходимо запустить командную строку~~Сквозная интеграция предполагает передачу тарифов подрядчика при создании заказа.

~~В командной строке необходимо выполнить следующие команды~~Чтобы настроить сквозную интеграцию между [[#Интеграция с CMS-системами |CMS- или CRM-системой]] и подрядчиком [[#Тарификация и выбор подрядчика и его тарифа клиентом|из таблицы]]: ~~openssl genrsa -out private~~* Создайте свой Личный кабинет для экстраинтеграции. Для этого, достаточно единоразово войти в ЛК экстраинтеграции под своим логином и паролем https://home.courierexe.~~pem 2048~~ ~~openssl rsa~~ ru/XXX, где XXX — экстра-~~in private~~код партнера.~~pem~~ Логин и пароль, -~~outform PEM~~ это данные из 3-~~pubout~~ го и 4-~~out public~~го параметров (см. таблицу ниже) [[#Тарификация и выбор подрядчика и его тарифа клиентом|Тарификация и выбор подрядчика и его тарифа клиентом]].* настройте [[Виды срочности|режим срочности]] для подрядчика.~~pem~~

~~После успешного выполнение команд Вы получить 2 файла~~Для сквозной тарификации заказов интернет-магазинов доступны следующие варианты: ~~public.pem и private.pemСодержимое файла public.pem~~ * курьерская служба, с которой сотрудничает интернет- ~~ваш публичный ключ~~магазин, ~~который необходимо целиком скопировать и вставить в ЛК PimPay~~настраивает режим срочности для подрядчика.~~А содержимое файла private.pem необходимо скопировать и вставить в настройках интеграции с PimPay~~ Интернет-магазин оформляет заказы в ~~нашем ЛК.</spoiler>~~[[~~Файл:pimpay client.png|thumb|200px|right~~Личный кабинет клиента|~~рис.2 Выбор платежного посредника~~личном кабинете клиента]]и выбирает указанный режим срочности;~~Если у вас нет специалиста, чтобы сгенерировать ключи, обратитесь~~ * интернет-магазины могут обратиться напрямую в ~~PimPay~~MeaSoft для настройки сквозной тарификации. В этом случае нужно предварительно заключить договор на оказание услуг с выбранным подрядчиком, ~~они с радостью сделают это за вас!~~и сквозная тарификация позволит получать его цены.

~~Далее~~== Тарификация и выбор подрядчика и его тарифа клиентом ==Вы можете настроить подключение своего тарифа к тарифу партнера — любой компании, ~~необходимо прописать настройки для pimpay~~ работающей в ~~панели управления нашего ЛК (см. рис.1). В ЛК PimPay нужно посмотреть код компании (~~системе MeaSoft, а также ряду компаний, с которыми у ~~них называется "Код платформы") и токен, ввести их в форму~~нас есть интеграции.

~~Для каждого клиента~~=== Настройка интеграции ===Чтобы настроить подключение к тарифу партнера:# Зарегистрируйтесь в системе подрядчика. Данные аккаунта понадобятся для настройки интеграции.# Откройте '''Справочники''' > '''Статусы''' > '''17 Виды срочности''' и создайте [[Статусы#Виды срочности|вид срочности]], например «СДЭК».# В контекстном меню вида срочности выберите пункт '''Дополнительная информация''' и во второй строке заполните параметры подключения к партнеру через запятую:#* 1-й параметр — код филиала партнера, ~~который хочет передавать данные~~ его можно посмотреть в ~~PimPay необходимо зарегистрировать~~ '''Справочники''' > '''Межгород''' > '''Филиалы'''. Можно в ~~личном кабинете PimPay~~одинарных кавычках указать несколько ответственных филиалов через запятую, тогда режим срочности будет доступен для всех перечисленных филиалов. Для версии системы 2021.0.0.38 и выше вместо кода филиала можно указать знак вопроса (?), это обозначит доступность режима срочности для всех филиалов;#* 2-й параметр — экстра-код партнера в ~~нашей~~ системе ~~выбрать платежного посредника на вкладке "Финансы" карточки~~ MeaSoft. Коды для сторонних компаний приведены в таблице ниже;#* 3-й параметр — имя пользователя в системе партнера. Может отличаться от того, под которым работает интеграция, здесь нужно для расчета цены для клиента. В ~~процессе передачи данных привязка клиентов между системами производится~~ таблице ниже указано, что вводить для каждого интегратора;#* 4-й параметр — пароль пользователя из 3-го параметра. В таблице ниже указано, что вводить для каждого интегратора;#* 5-й параметр — вид срочности партнера. Посмотреть доступные коды видов срочности можно по ~~ИНН~~ссылке в таблице ниже, в калькуляторе в выпадающем списке. ~~Наша~~ Можно в одинарных кавычках указать несколько видов срочности через запятую, тогда система ~~начинает передавать все заказы вашего клиента~~ будет стараться выбрать из них первый доступный;#* 6-й параметр — наценка к цене, передаваемой подрядчиком. В деньгах или в ~~PimPay~~процентах, если стоит знак процента. Например, 10 — наценка 10 рублей, 10 % — наценка 10 процентов;#* 7-й параметр — если указать значение '''1''', сквозная тарификация выключена. Параметр используется, если подключение нужно только для передачи заказов по интеграции, а расчет цены не нужен. В этом случае, при визуализации суммы по режиму срочности, ~~их статусы~~отображается внутренний тариф, ~~и созданные [[Акты Передачи Денег и корреспонденции~~ а подрядчику заказ отправляется другим тарифом, выбранным согласно настройке в 5-м параметре (~~АПД~~вид срочности партнера)~~|АПД]]~~. ~~Обратно она ничего не получает~~;#* 8-й параметр — если указать значение '''1''', среди указанных режимов срочности партнера выполняется поиск самого дешевого тарифа. Работает для СДЭК 1.5, Почты России и Omnic# Нажмите на кнопку '''OK'''.

{|class="wikitable"!Интеграция!Код экстра!Виды срочности!Авторизация!Пример строки|-|БОКСБЕРРИ||90001||https://home.courierexe.ru/90001/calculator||3-й параметр - токен. 4-й - Код пункта приема по умолчанию для старого Боксберри 010. После перехода на Яндекс, требуется выбрать ПВЗ отправления из нового списка, предоставляемого Яндекс. Для ~~того~~уточнения, свяжитесь с техподдержкой Boxberry Можно оба параметра оставить пустыми для расчета базовых цен.||33, 90001, j3ejwo2f10b2e47790174b41f4a11111, c1cb5465-1418-42eb-a74d-204682e18af8, 2, 50|-|ПИКПОИНТ||90002||https://home.courierexe.ru/90002/calculator||3-й параметр — логин, 4-й — через запятую пароль и договор ИКН. Можно оставить пустыми, но цены будут не все.||33, 90002,us0111, '6rGGuqRsW2qNQ,9990721312', 2, 50|-|rowspan="2"|СДЭК (протокол обмена данными 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|-|СДЭК (протокол обмена данными 2.0)||90022||https://home.courierexe.ru/90022/calculator||3-й параметр — ID клиента, 4-й — ключ клиента. Вы можете перечислить в пароле уточняющие параметры для расчета через запятую: <ul><li>не передавать объявленную ценность</li><li>добавлять услугу «Осмотр вложений»</li><li>процент за наложенный платеж</li><li>код пункта приема</li><li>процент за безналичный наложенный платеж</li></ul> Пример пароля: 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-й. Заполнение Логина и Пароля обязательно. Вы можете перечислить в пароле уточняющие параметры для расчета через запятую: <ul><li>Особенности отправки заказов:<ul><li>0 - Как документ SaveDocument</li><li>1 - Как накладная SaveWaybillOffice</li><li>2 - Определить автоматически</li></ul></li><li>Забор<ul><li>0 - По умолчанию</li><li>1 - До двери</li><li>2 - Самопривоз в КСЭ</li></ul></li></ul> Пример пароля: 4CCB11864D06157,2,2||12504, 90008, Рога и копыта, '4CCB11864D06157,1,2', '2, 3, 6', 10%|-|ПОЧТА РОССИИ||90010||https://home.courierexe.ru/90010/calculator||Без авторизации||10497, 90010,,, '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 может как совпасть с итоговым, так и сильно разойтись. Если вас это не устраивает, не используйте сквозную тарификацию с этим подрядчиком.|-|5Post||90020||https://home.courierexe.ru/90020/calculator||3-й параметр — API-ключ, ~~нужно создать клиента~~ 4-й — уникальный номер партнера в системе 5post. При необходимости в 4-м параметре можно через запятую указать параметры: <ul><li>пороговое значение веса (по умолчанию 3 кг).</li><li>Использовать штрихкод для отслеживания получателем</li><li>Код подрядчика в карточке заказа</li><li>Габариты мест</li><li>Тип расчета тарифа</li></ul>При указании параметров важно соблюдать последовательность. Для вашего аккаунта в API 5post должна быть подключена возможность получать ПВЗ с ~~точно таким названием~~ вашими тарифами. Пример пароля: 2123,7,,,,1||10497, 90020, u23B0r9AAJ1Fyh4ptMzJ3kjxcslamwdx,'2123,7,,,,1', '1,3', 100|-|GTD||90021||https://home.courierexe.ru/90021/calculator||3-й параметр — API-ключ, 4-й — пароль от личного кабинета https://home.courierexe.ru/90021. Предварительная авторизация по указанному URL обязательна.||10497, 90021, u23B0r9AAJ1Fyh4654MzJ3kjx1548wdx, pass, 100|-|Яндекс.Доставка||90023||https://home.courierexe.ru/90023/calculator||3-й параметр — токен, 4-й — ID пункта отправления в качестве пароля. При необходимости, в пароль можно расширить, передавая через запятые следующие параметры: - Начало интервала доставки (не активно) - Окончание интервала доставки (не активно) - Код курьера, для закрытия корреспонденции - параметр "Особенности формирования данных" '1' - Трактовать места, как товары '2' - Трактовать товары, как места - параметр "Настройка получения ПВЗ" по умолчанию - Получать все ПВЗ '1' - Отключить постаматы '2' - Отключить все ПВЗ Пример пароля: cfceadaa-4874-438a-999b-dbbafe5326ed,,,25,2,1||10497, 90023, AgAABBDzeAQMAAAPeISvM_9LUkxCijQoFXOH5QE, ‘cfceadaa-4874-438a-999b-dbbafe5326ed,,,,1,1’, 1, 100|-|Л-Пост||90024||https://home.courierexe.ru/90024/calculator||3-й параметр — логин, который требуется создать самостоятельно, для входа в [https://home.courierexe.ru/90024/ ЛК экстраинтеграции Л-Пост] 4- пароль, как Секретный ключ клиента Дополнительно, есть возможность перечислить в пароле уточняющие параметры для расчета через запятую: <ul><li>Признак использования тестовой среды</li><li>Код пункта приема</li></ul> Пример пароля: YGNoaR3cG00JYg67,0,1010||10497, 90024, LoginTest, ‘YGNoaR3cG00JYg67,0,1010’, 1, 100|-|Omnic||90025||https://home.courierexe.ru/90025/calculator||3-й параметр — логин, который требуется создать самостоятельно, для входа в [https://home.courierexe.ru/90025/ ЛК экстраинтеграции Omnic] 4- пароль, как Токен клиента Дополнительно, есть возможность перечислить в пароле уточняющие параметры для расчета через запятую: <ul><li>Код пункта приема отправлений</li><li>Признак использования тестовой среды</li><li>Приоритет доступных тарифов через пробелы, - при указании алгоритмического тарифа, приоритет указанный в нем имеет преимущество</li></ul> Пример пароля: g67hjtTYjhgf765432,MCK45||10497, 90025, LoginTest, ‘g67hjtTYjhgf765432,MCK45,,21 22’, '3, 2', 100,, ~~и заполнить его реквизиты~~1|-|A2-express||90029||https://home.courierexe.ru/90029/calculator||3-й параметр — логин, Идентификатор клиента в A2 состоящий из 4-х цифр [https://home.courierexe.ru/90029/ ЛК экстраинтеграции A2-express] 4-й параметр - пароль, это Ключ клиента в A2-express||10497, 90029, 1000, g67hjtTYjhgf765432hgtTnk5, '1, 2', 100,,1|}

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

# Обратитесь в [https://kontur.ru/ СКБ Контур] для выпуска [https://ru.wikipedia.org/wiki/%D0%AD%D0%BB%D0%B5%D0%BA%D1%82%D1%80%D0%BE%D0%BD%D0%BD%D0%B0%D1%8F_%D0%BF%D0%BE%D0%B4%D0%BF%D0%B8%D1%81%D1%8C электронной цифровой подписи (ЭЦП)] для использования с ЭДО Диадок. Нам выставили счет на 5250 рублей. Потом нужно прийти в предложенный офис удостоверяющего центра с уставными документами, вам дадут флешку (называется "Рутокен") с ЭЦП. При ее подключении автоматически устанавливается набор ПО для ее использования.~~# Вам становится доступен вход~~ Вы можете войти в ~~систему~~ личный кабинет по адресу [https://diadoc.kontur.ru https://diadoc.kontur.ru], без пароля, просто по ЭЦП, подключенной к компьютеру. Вы уже можете принимать документы от контрагентов.# Обратитесь в СКБ Контур для выставления счета на пакет отправляемых документов. Пакет можно выбрать здесь: [https://www.diadoc.ru/price вида https://~~www~~home.~~diadoc~~courierexe.ru/~~price]. Кроме того, для использования с нашей, как и с любой другой системой~~XXX, нужно включить возможность использования API: сотрудники Контура выставят за это счет - 18 т.р. на год, или 38 т.р. за 5 лет (актуально в 2019 году). После '''оплаты счета''' за API они присылают '''API-ключ''' вида "API-1b1111ae-1111-1111-b111-111111cc1fd1". API-ключ приобретается отдельно на каждое ваше юр. лицо, поэтому его нужно вводить в "Фирмы".# В системе Диадок откройте '''Настройки и оплата''' > '''Сотрудники''' и выберите сотрудника, который будет отвечать за подписание документов. В карточке сотрудника перейдите на вкладку '''Данные по сертификатам''' и в группе полей '''Область полномочий''' установите полномочия для входящих и исходящих документов. Нажмите на кнопку '''Сохранить'''.~~# Заполните данные подключения в системе:~~ ~~## В переменной <mparam code="EDocProvider"/> выберите '''Диадок'''.## Введите API-ключ в '''Справочники''' > '''Фирмы''' > '''Карточка фирмы''' > '''Ключ ЭДО'''.~~## Если в вашем токене несколько сертификатов, в поле <mparam code="EDocLogin"/>укажите без пробелов значение отпечатка сертификата, который нужно использовать. Чтобы просмотреть отпечаток, в меню '''Пуск''' выберите '''Программы''' > '''Крипто-ПРО''' > '''Сертификаты пользователя''' > '''Личное''' > '''Сертификаты'''. Справа выберите нужный сертификат, откройте. Перейдите на вкладку '''Состав''', прокрутите список значений вниз, в самом низу выберите '''Отпечаток'''.~~## В поле <mparam code="EDocPass"/>введите пин~~где XXX — экстра-код ~~сертификата. Если вы его не меняли~~партнера, ~~можно пропустить: по умолчанию пин~~авторизоваться данными из 3-~~код рутокена «12345678»,~~ го и ~~программа сама будет его использовать, если вы ничего не указали. Если он окажется неправильным, Крипто~~4-~~ПРО спросит у вас верный пин-код при передаче данных~~го параметров (см. ~~Обратите внимание, что количество попыток ввода пин-кода ограничено.# После ввода данных подключения выйдите из системы~~ таблицу выше) и запустить программу от имени администратора: в контекстном меню ярлыка MeaSoft выберите пункт '''Запуск от имени администратора'''. Чтобы осуществить обмен данными, выберите '''Связь''' > '''Обмен воспользоваться калькулятором с ЭДО'''. При первом использовании программа установит на компьютер специальный COM-объект Диадока. Именно для этого нужны права. В дальнейшем она будет использовать уже установленный компонент, и наличия прав не требуетсятарифами именно вашей компании.

=== ~~Обмен данными с ЭДО~~ Настройка стоимости доставки для получателя ===~~Выберите в главном меню "Связь" -> "Обмен~~ При интеграции с ~~ЭДО". Откроется окно с выпадающим списком фирм~~подрядчиками, ~~у которых заполнено поле "Ключ ЭДО". Выберите фирму~~перечисленными в таблице выше, вы можете настроить стоимость и ~~нажмите "Обмен!". Программа выполнит все операции~~срок доставки, ~~которые периодически нужно выполнять, чтобы иметь актуальные данные как в нашей системе так и в ЭДО~~отображаемые для получателя:*Синхронизирует справочники контрагентов# Перейдите в личный кабинет по адресу вида https: ~~Получит список контрагентов~~//home.courierexe.ru/XXX, ~~уже являющихся вашими партнерами в ЭДО~~где XXX — экстра-код партнера, ~~проставит им соответствующие признаки~~ и авторизуйтесь данными из 3-го и 4-го параметров (~~На вкладке "Клиенты" появилось новое поле "Статус ЭДО"~~см. ~~Это поле нельзя менять, оно устанавливается автоматически~~таблицу выше), проверит, кто прислал вам приглашения к партнерству и примет их, разошлет приглашения всем вашим работающим контрагентам, проверит, кто принял приглашение, а кто - отказался.*Проверит статусы ранее отправленных документов# Откройте пункт основного меню '''Цена доставки для получателя''' и настройте правила расчета цены и сроков доставки. ~~При подписании документа вашим партнером, сообщение получит статус "Доставлено"~~Подробнее см. Если оно отправлено из счетов или АПД, то соответсвующий документ получит признак получения подписанного актараздел «[[Личный кабинет клиента#Цена доставки для получателя|Цена доставки для получателя]]».

==~~= Отправка документов =~~TPS Gate==~~К отправке сейчас доступны счета, АПД~~ Интеграция с сервисом TPS Gate позволяет открывать шлагбаумы с мобильного приложения курьера на территории Москвы и ~~АПК~~Московской области. ~~Отправка работает крайне похоже~~ Это упрощает работу курьеров и уменьшает время на ~~e-mail~~доставку каждого адреса. ~~Документы формируются точно так же, но отправляются не почтой, а~~ Для подключения вам необходимо обратиться в ~~ЭДО~~сервис [https://tpsgate.ru TPS Gate], ~~уже подписанными вашей ЭЦП. В системе ЭДО "адресами" отправителя~~ заключить с ними договор и получателя являются ИНН (по возможности еще КПП, но это не обязательно) компании, поэтому, чтобы все работало, ИНН должен быть заполнен. Так же ЭДО примет документы только в адрес компании, подписать с ~~которой у вас отмечены партнерские отношения, т.е. кто-то из вас отправил приглашение, а другой его принял~~нами доп. Поэтому, для удобства контроля - кому можно таким образом отправлять, а кому - нет, в списках документов добавлено поле "Есть ЭДО"соглашение о передаче данных [https://courierexe. ~~Там галка ставится на основании статуса ЭДО клиента~~ru/download/TPS_DOP. ~~Можете отсортировать по этому полю, выдели все, где есть галки, и разослать всем документы по ЭДО~~docx Пример].

~~== Телефония ==~~Далее необходимо передать нам секретный ключ от сервиса TPS Gate и интеграция будет запущена. ~~Основная статья: [[Интеграция с телефонией]]~~Если на адресе доставки есть ворота, которые возможно открыть через TPS Gate в мобильном приложении курьера появится соответствующая кнопка.

~~== GPS-трекинг автотранспорта ==Для поддержки GPS-трекинга автотранспорта~~ Чтобы курьер мог открывать ворота через приложение, у нас разработана интеграция с коробочной системой Wialon, на которой работают большинство компаний, предоставляющих подобные услуги. Обратитесь в службу технической поддержки для помощи него должна быть включена галка '''Водитель''' в ~~настройке~~карточке сотрудника.

Daria

456

правок

Изменения

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

Навигация

Персональные инструменты

Пространства имён

Варианты

Просмотры

Ещё

Поиск

Навигация

Инструменты