352
правки
Изменения
API
,→Справочник дополнительных услуг
{| class="wikitable" align="center" style="width: 80%; margin: auto; color: black; boreder: 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;"|[http://marketplace.1c-bitrix.ru/solutions/measoft.courier/ Установить] <!-- [http://courierexe.ru/download/api/bitrix.zip Скачать Unicode]<br>[http://courierexe.ru/download/api/bitrix_ansi.zip Скачать ANSI] -->
|Поддерживает версии 14.5 и выше
|-
|[[Файл:prestashop.png|center|x44px]]
|style="text-align: center;"|[http://courierexe.ru/download/api/prestashop.zip Скачать]
|Поддерживает версии 1.5.2.0 и выше (2.x в том числе!)
|-
|[[Файл:OpencartOCStore.png|center|x44px]]
|Поддерживает версии с 1.5.5.1<br>Версия 2.0.0 поддерживает версии с 2.0<br>[https://opencartforum.com/files/file/2906-avtomatizaciya-otpravki-i-otslezhivanie-dostavok-courierexe-dlya-opencart-15x/ Альтернативный модуль сторонних разработчиков]
|-
|[[Файл:webasyst-shopscript.png|center|x44px]]
|style="text-align: center;"|[http://www.webasyst.ru/store/plugin/shop/measoftcourier/ Установить модуль]<br>[https://www.webasyst.ru/store/plugin/shipping/measoftcourier/ Установить плагин]
|Модуль предназначен для отправки заявок в КС, а плагин для расчета стоимости доставки при оформлении заказа.
|-
|[[Файл:advantshop.png|center|x44px]]
|style="text-align: center;"|[https://promo-z.ru/ Сайт компании PROMO]
|Компания PROMO разработала этот модуль и настраивает интеграцию КС 2008 с ADVANTSHOP своим клиентам.
|-
|[[Файл:insales.png|center|x44px]]
|style="text-align: center;"|[http://www.insales.ru/collection/all/product/kurierskaya-sluzhba-2008 Установить]
|[http://wiki.courierexe.ru/index.php?title=Интеграция_с_другими_системами#Insales Настраивается] в ЛК пользователя в системе
|-
|[[Файл:Leadvertex.png|center|x44px]]
|style="text-align: center;"|[[Файл:Leadvertex-howto.png|center|x44px]]
|[http://blog.leadvertex.ru/news/2110-integraciya-s-kurerkami-na-platforme-measoft/ Настраивается] в ЛК пользователя в системе [https://Leadvertex.ru Leadvertex]
|-
|[[Файл:Retailcrm.png|center|x44px]]
|style="text-align: center;"|[https://www.retailcrm.ru/ RetailCRM]
|[http://wiki.courierexe.ru/index.php?title=Интеграция_с_другими_системами#RetailCRM Настраивается] в ЛК пользователя в системе
|-
|[[Файл:1C.jpg|center|x44px]]
|style="text-align: center;"|-
|[https://infostart.ru/public/692790/ Альтернативный модуль сторонних разработчиков]
|-
|[[Файл:Joomla2.jpg|center|x44px]]
|style="text-align: center;"|[http://courierexe.ru/download/api/com_measoft.zip Скачать]
|Работает только с компонентом Virtuemart. Внимание! Модуль новый, поэтому возможна некорректная передача данных. Проверяйте, если что - сообщайте, исправим!
|-
|[[Файл:Amocrm.png|center|x44px]]
|style="text-align: center;"|[https://www.amocrm.ru/extensions/courier2008 Установить]
|Внимание! Модуль новый, поэтому возможна некорректная передача данных. Проверяйте, если что - сообщайте, исправим!
|-
|[[Файл:MoySclad.jpg|center|x44px]]
|style="text-align: center;"|[https://home.courierexe.ru/moysklad/step1 Подключение] [[Интеграция с другими системами#Мой Склад|Инструкция]]
|Ожидается в ближайшее время в магазине Мой Склад
|-
|[[Файл:wordpress.jpg|center|x80px]]
|style="text-align: center;"|[http://courierexe.ru/download/api/wordpress.zip Скачать] [[Интеграция с другими системами#Wordpress|Инструкция]]
|Внимание! Модуль новый, поэтому возможна некорректная передача данных. Проверяйте, если что - сообщайте, исправим!
Для отображения списка пунктов выдачи есть '''готовый JavaScript модуль''': https://home.courierexe.ru/js/measoft_map.js Инструкция по использованию - внутри.Посмотреть пример работы можно [https://home.courierexe.ru/pvz_test.html Здесь]
Данные модули распространяются бесплатно, без каких-либо гарантий со стороны разработчика. Их наличие не нужно рассматривать как средство полной автоматизации взаимодействия с курьерской службой, а скорее как помощь разработчикам интернет-магазинов в построении интеграции с курьерскими службами. В любом случае нужно понимать, что ответственность за корректность передачи данных лежит на интернет-магазине. Однако, мы будем очень признательны, если Вы будете нам сообщать о своих потребностях и/или найденных неточностях в наших модулях, это позволит нам учитывать пожелания в новых версиях.
<items>
<item extcode="abc123" quantity="1" mass="0.2" retprice="37.5" VATrate="0" barcode="2345625213125" article="1" volume="3" origincountry="AUT" GTD="321546654" excise="15.20" suppcompany="ООО "Рога и копыта"" suppphone="79161234567" suppINN="1112223334" governmentCode="11223311">Мяч</item>
<item extcode="abc124" quantity="2" mass="2" retprice="100" inshprice="100" VATrate="10" barcode="4645625213138" article="2" length="10" width="20" height="30" origincountry="004">Обруч</item> <item extcode="abc125" quantity="3" mass="0.3" retprice="50" inshprice="50" barcode="2345625213126" article="3" type="1">Погремушка желтая</item>
</items>
<packages>
<below below_sum="2000" price="300" />
</deliveryset>
<advprices>
<advprice>
<code>1</code>
<value>123</value>
</advprice>
<advprice>
<code>2</code>
<value>10.5</value>
</advprice>
<advprice>
<code>3</code>
<value>true</value>
</advprice>
</advprices>
</order>
</neworder>
:* '''''height''''' - Высота единицы товара (в сантиметрах).
:* '''''retprice''''' - Цена единицы товара. Округляется до копеек. Должна быть с учетом всех скидок и наценок. Для вложений типов 1, 2, 3 не может быть отрицательной. <!-- , либо мы сами посчитаем скидку при указании тега order->discount -->
:* '''''inshprice''''' - Объявленная ценность единицы товара. Округляется до копеек. Если не указана принимается равной '''''retprice'''''.
:* '''''VATrate''''' - Ставка НДС - целое число процентов. Если значение не указано, подставляется значение "20". Значение "0" означает ставку "Без НДС", ставка "0%" на данный момент не поддерживается.
:* '''''barcode''''' - Штрих-код вложения. [[Файл:Article.png|thumb|100px|right]]
:* '''''below_sum''''' - граница стоимости выкупаемого заказа
:* '''''price''''' - стоимость выкупаемого заказа до соответствующей границы
* '''advprices''' - Контейнер для описания дополнительных услуг. Необязательный
:* '''''code''''' - код услуги
:* '''''value''''' - значение услуги. Если тип услуги bool, то в значении передаем true
*'''costcode''' - Кост-код сотрудника.
* '''deliveryprice''' - Стоимость услуг в валюте расчетов с клиентом. Атрибуты:
:* '''''total''''' - общая стоимость услуг
:* '''''delivery''''' - стоимость доставки"Туда":* '''''return''''' - стоимость возвратадоставки "Обратно" (если order->return=YES)
Тэг '''deliveryprice''' включает список дополнительных услуг (только для тарифа "Премиум"):
:* '''''advprice''''' - наименование дополнительной услуги
<?xml version="1.0" encoding="UTF-8"?>
<tracking>
{
"time":"2016-06-01 17:38:00",
Функция ищет последний заказ по номеру среди заказов всех клиентов. Выдает неперсонализированную информацию о текущем состоянии заказа.<br />
Описание контейнеров ответа аналогично описанию [[API#.D0.97.D0.B0.D0.BF.D1.80.D0.BE.D1.81_.D1.81.D1.82.D0.B0.D1.82.D1.83.D1.81.D0.B0_.D0.B7.D0.B0.D0.BA.D0.B0.D0.B7.D0.BE.D0.B2|Запроса статусов заказов]].
== Изменение заказа ==
Запрос предназначен для изменения заказов, находящихся в статусах "Ожидает синхронизации" или "Новый", а также по которым не было произведено изменений - статуса доставки, статуса корреспонденции, времени доставки - то есть заказов, которые ещё не находятся в работе.
<div style="color: #a94442; background-color: #f2dede; border: 1px solid #ebccd1; padding: 3px 10px 10px;">
# Данные запроса изменения указываются '''полностью''', как если бы заказ создавался впервые.
# При отсутствии вложения в запросе изменения данное вложение '''не удаляется''' из заказа, но его количество становится равным 0.
# Изменение мест пока При одновременном изменении заказа в API и системе курьерской службы приоритет отдается данным системы курьерской службы. То есть изменения в API приняты не поддерживается.будут!
</div>
<br />
<parentcode>6</parentcode>
<parentname>Интеграция</parentname>
<town code="124267" regioncode="66" regionname="Свердловская область">Нижний Тагил город</town>
<address>622036, г. Нижний Тагил, ул. Циолковского, д. 17</address>
<phone>+73435417709, +73435254989</phone>
<parentcode>6</parentcode>
<parentname>Интеграция</parentname>
<town code="124267" regioncode="66" regionname="Свердловская область">Нижний Тагил город</town>
<address>КРАСНОАРМЕЙСКАЯ, д.79</address>
<phone>+7(3435)379-044</phone>
*'''parentcode''' - Код родительского элемента.
*'''parentname''' - Наименование родительского элемента.
*'''town''' - Населенный пункт с кодом из [[#Справочник городов|справочника городов]], а также с кодом и наименованием региона.
*'''address''' - Адрес ПВЗ.
*'''phone''' - Телефоны ПВЗ.
</services>
</source>
== Справочник дополнительных услуг ==
'''Пример запроса дополнительных услуг:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<advprices>
<auth extra="8" login="login" pass="pass" />
</advprices>
</source>
'''Пример ответа справочника дополнительных услуг:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8" ?>
<advprices>
<advprice>
<code>1</code>
<name>Этажей в доме</name>
<type>int</type>
</advprice>
<advprice>
<code>2</code>
<name>Коэффициент надбавки</name>
<type>float</type>
</advprice>
<advprice>
<code>3</code>
<name>Расписаться на упаковке</name>
<type>bool</type>
</advprice>
</advprices>
</source>
Параметры:
*'''code''' - внутренний код услуги
*'''name''' - наименование услуги
*'''type''' - тип услуги. Может иметь значения:
:*'''bool''' - для услуг вида "чекбокс", "Да"
:*'''float''' - для числа с плавающей точкой
:*'''int''' - для целого числа
== Расчет стоимости доставки ==
<calculator>
<auth extra="8" login="login" pass="pass" />
<calc townfrom="Москва" addressfrom="Ленинский проспект, 95" zipcode="664000" townto="3800000300000" addressto="Ленина ул., 10" l="10" w="20" h="30" mass="3.7" service="1" rur price="1200" inshprice="1200" paytype="CASH" />
</calculator>
</source>
*'''mass''' - Масса в килограммах
*'''service''' - Режим доставки - число, указывающее на запись в справочнике [[#Справочник Видов срочности|видов срочности]]. Если этот параметр опустить, система выдаст расчет для всех доступных видов срочности, передав много контейнеров <calc> в ответе.
*'''rurprice''' - Сумма наложенного платежа
*'''inshprice''' - Сумма объявленной ценности
*'''paytype''' - Тип оплаты
<mindeliverydays>1</mindeliverydays>
<maxdeliverydays>3</maxdeliverydays>
<mindeliverydate>2020-05-13</mindeliverydate>
</calc>
</calculator>
*'''price''' - рассчитанная стоимость доставки в валюте прайс-листа курьерской службы. Рекомендуется к использованию в отличие от одноименного атрибута родительского контейнера.
*'''maxdeliverydays''' - максимальный срок доставки в рабочих днях.
*'''mindeliverydate''' - минимальная дата доставки в учетом выходных дней.
'''''Обратите внимание:''''' В реальном ответе сервера в теге calc присутствует атрибут "price". Он оставлен для обратной совместимости, не используйте его. Пользуйтесь вложенным тегом price.