Изменения

← Предыдущая правка

API

33 301 байт добавлено, 27 март

→‎Описание элементов для оформления заказа

|[[Файл:prestashop.png|center|x60px]]

|style="text-align: center;"|[https://courierexe.ru/download/api/prestashop.zip Скачать]

|Поддерживает версии 1.5.2.0 и выше. ~~Инструкция в архиве~~Подробнее см. [[PrestaShop|описание]].

|-

|[[Файл:OpencartOCStore.png|center|x60px]]

|[[Файл:webasyst-shopscript.png|center|x44px]]

|style="text-align: center;"|[https://www.webasyst.ru/store/plugin/shop/measoftcourier/ Установить модуль]<br>[https://www.webasyst.ru/store/plugin/shipping/measoftcourier/ Установить плагин]

|Модуль предназначен для отправки заявок в КС, а плагин для расчета стоимости доставки при оформлении заказа. Инструкции есть в маркете, а также см. [[Webasyst|описание]].

|-

<!--|[[Файл:advantshop.png|center|x44px]]

|-

|[[Файл:Amocrm.png|center|x44px]]

|style="text-align: center;"|[https://www.amocrm.ru/extensions/~~courier2008 Установить~~measoft Описание на сайте amoCRM]|~~Подробнее см.~~ Подробное описание настроек читайте [[amoCRM|~~описание~~тут]].

|-

|rowspan="2"|[[Файл:MoySclad.jpg|center|x30px]]

|style="height:50px; text-align: center;"|~~[https://home.courierexe.ru/moysklad/step1 Настроить интеграцию с MeaSoft]~~

|[[МойСклад|Инструкция]]

|-

|Поддерживает версии 4.10 и выше.<br>[[CS-Cart|Инструкция]]

|-

~~|rowspan="2"~~|[[Файл:webhooks.jpg|center|x100px]]

|style="text-align: center;"|Читайте описание [[Webhook|на этой странице]]

|Передача информации о статусах и заказах в вашу систему

|-

|[[Файл:Logo_tilda_black.png|center|x100px]]

|style="text-align: center;"|Читайте описание [[Tilda|на этой странице]]

|Работает только на платных тарифах

|-

|}

* при запросе измененных статусов ОБЯЗАТЕЛЬНО нужно подтверждать успешное получение запросом [[#Передача только изменившихся статусов|commitlaststatus]].

* вы должны знать номера заказов, которые вы отправили. Не нужно перебирать номера всех заказов или брутфорсом перебирать все возможные номера.

* нужно проверять с каким ответом возвращаются ваши АПИ-запросы. Если мы отвечаем ошибкой, то даже запрос на создание нового заказа учитывается в количестве запросов.

Мы абсолютно уверены, что данные ограничения на порядки превосходят необходимые объемы предоставления сервиса для решения любых задач. Если у вас возникают проблемы, вы не знаете, как уложиться в эти рамки — спросите у нас, мы обязательно поможем!

<items>

</advprice>

</advprices>

<name>courier_car</name>

<value>ВАЗ 2106, бежевый</value>

</extrafield>

</extrafields>

<overall_volume>81</overall_volume>

* '''order''' — Контейнер для описания одного заказа, обязательный элемент. В одном контейнере '''neworder''' может быть много контейнеров '''order''' для создания нескольких заказов одним запросом.

:* '''''orderno''''' — Номер заказа. Если присваивается клиентом — указывается здесь. Если не присваивается — можно оставить пустым, система сгенерирует свой номер, и вернет его в ответе. Система проверяет '''у клиента''' наличие заказов с указанным номером в '''пределах текущего календарного года''', которые '''не являются недоставленными''', и в случае их существования — заказ создан не будет, а в ответе вернется ошибка 17 «Such number exists». Если не указан штрихкод (поле barcode), и значение поля подходит для использования его в качестве штрихкода, данное значение будет скопировано в поле «Штрихкод». Это накладывает ограничения в частности, на длину указанного поля (25 знаков, чтобы работали стандартные печатные формы).

* '''barcode''' — Штрихкод заказа. Если клиент штрихкодирует свои отправления и штрихкод отличается от номера заказа, в этом поле указывается штрихкод. Если ШК содержит кириллицу или малое количество символов, то формируется ШК в формате EAN13.

:* код ПВЗ в нашей системе

:* код ПВЗ в системе подрядчика

:* наименование ПВЗ в виде строки "ПВЗ " + «Наименование ПВЗ». При указании ПВЗ в поле адреса необходимо проверять значение поля город получателя (он должен соответствовать данным ПВЗ) либо не передавать его вообще.

Для тега города '''town''' можно указать код региона в атрибуте '''''regioncode''''' из [[#Справочник регионов|справочника регионов]]. Поиск будет производиться в указанном регионе.

* '''weight''' — Общий вес заказа в килограммах.

* '''quantity''' — Количество мест.

* '''service''' — Режим доставки (тип услуги) передается код из справочника «[[#Справочник ~~Видов~~ Виды срочности|Виды срочности]]».

* '''type''' — Тип корреспонденции (отправления) передается код из справочника «Типы корреспонденции».

* '''return''' — Признак необходимости возврата. Принимает значения:

* '''department''' — Подразделение, в котором оформляется заказ.

* '''costcode''' — Кост-код сотрудника.

* '''respstore''' — Код ответственного филиала.Для ответственного филиала в который передается заказ, требуется включение параметра "Разрешить клиенту передавать заказы в этот филиал"

* '''pickup''' — Признак оформления забора YES/NO. Если стоит YES, то весь заказ считается заданием на забор груза, а не на доставку! Применяется для вызова курьера к отправителю для забора других отправлений. ''Внимание!'' при добавлении в забор складских товаров, их тип '''''type''''' всегда должен быть установлен как [7] Забор товара, если будет указан другой тип, то он будет исправлен в момент добавления заказа на [7] Забор товара

* '''acceptpartially''' — Признак возможности частичного выкупа товаров отправления YES/NO.

* '''uid''' - Универсальный идентификатор заказа на стороне отправителя. Не обязательный параметр, ограниченного по времени действия. Время хранения в системе, - сутки.

* '''items''' — Контейнер для описания вложений. <rspoiler text="Необязательный контейнер">Если для поставщика товара в системе MeaSoft не указаны полное наименование компании и ИНН в карточке клиента, заполните параметры <code>suppcompany</code> и <code>suppINN</code> в этом контейнере. Отсутствие информации о поставщике приведет к [[Настройка модуля печати кассовых чеков#Ошибка фискализации (ошибка программирования реквизита 1226)|ошибке фискализации]].</rspoiler>. Атрибуты:

:: 6 — Оплата кредитом. Указывается сумма. Поле quantity игнорируется, всегда «1». В заказе сумма будет отрицательной независимо от знака в запросе.

:: 7 — Забор товара. Если товар нужно у получателя забрать, возможно — вернуть деньги, или его стоимость вычтется из суммы других товаров. У такого товара в заказе будет отрицательное количество независимо от знака в запросе.

:: 9 — Код подтверждения. Используется для вложения, в котором сохраняется регулярное выражение для проверки кодов вложений. См. '''''extraTags'''''

:* '''''extcode''''' — Внешний код строки. Используется для идентификации строк заказов при получении статусов. Необязательное поле.

:* '''''origincountry''''' — Код страны-производителя в соответствии со [https://ru.wikipedia.org/wiki/ISO_3166-1 стандартом ISO_3166-1], например, «RU», «RUS» или «643» для России.

:: 2 — ГИИС ДМДК.

:: 3 — Серийный номер.

:* '''''message''''' — Строка сообщения.:* '''''extraTags''''' — Строка в формате JSON для ~~отправки в ОФД~~различных целей.

:: Тэг 1265 - значение отраслевого реквизита = код места деятельности аптеки

:: Тэг 1212 - Признак предмета расчета

:: Маска валидации - регулярное выражение для проверки кодов вложений курьером. Указывается во вложении с типом 9 (см. атрибут вложения '''''type''''')

:: Пример:

"item_industry_props":{"tag1262":"020","tag1263":"14.12.2018","tag1264":"1556","tag1265":"tm=mdlp&sid=00000000XXXXXX"},

"tag1212": "1"

"ValidationMask": "(A-Z0-9){6,8}"

</source>

Для клиентов из '''Узбекистана''' необходимо указывать код ИКПУ и код упаковки в следующем формате:

"ikpu":"123123123","packageCode":"123456"

</source>

:* '''''code''''' — код услуги.

:* '''''value''''' — значение услуги. Если тип услуги bool, то в значении передаем true.

* '''extrafields''' — Контейнер для описания расширенных полей. Необязательный элемент. Может содержать несколько элементов extrafield

* '''extrafield''' — Контейнер для описания расширенного поля.

:* '''''name''''' — наименование переменной. Может содержать только латинские буквы, цифры и знак подчеркивания "_", но начинаться может только с буквы. Максимальная длина - 20 символов.

:* '''''value''''' — значение переменной. Максимальная длина - 250 символов.

* '''overall_volume''' — Общий объем, м3. Виртуальное поле. Необязательное. Из этого поля рассчитывается длина/высота/ширина места. Расчет срабатывает только если в каждом месте есть нулевые значения длины или высоты или ширины.

|-

|134||Specify a valid "paytype" for the town.||Укажите тип оплаты для города

|-

|135||Specify the correct SKU ID/code for item.||Укажите артикул/код вложения

|-

|136||Specify warehouse goods in the order.||Укажите вложения в заказе

|-

|137||The order's date of creation is more than 60 days ago.||Заказ создан более 60 дней назад

|-

|138||Specify a valid "Package dimension" field value.||Укажите корректные габариты места

|-

|139||Wrong type of XML query||Ошибка запроса

|-

|140||Duplicate item code in the order.||Дублирование кода вложения в заказе

|-

|141||Duplicate additional service in the order.||Дублирование кода дополнительной услуги в заказе

|-

|144||Incorrect extrafields.||Некорректные расширенные поля.

|-

|}

</conditions>

</statusreq>

</source>

* '''orderno''' — Идентификатор заказа у клиента (шифр). Необязательный элемент.

* '''ordercode''' — Внутренний код заказа. Необязательный элемент.

* '''orderno2''' — Номер заказа из срочных. Необязательный элемент.* '''uid''' — Уникальный идентификатор, если он был добавлен при создании заказа. Необязательный элемент. Запрос информации по uid возможен в течении суток после создания заказа

* '''datefrom''' — Дата заказа «с». Необязательный элемент.

* '''dateto''' — Дата заказа «по». Необязательный элемент.

:* '''namestarts''' — Поиск по номеру заказа(шифр), который начинается с «orderno».

* '''limit''' — Необязательный параметр. Дает возможность получить не все измененные заказы, а только какое-то определенное количество. Помогает на случай, если у вас скопилось очень много измененных заказов и нужно их грузить лимитировано. После каждой итерации нужно вызывать commitlaststatus с контейнером списка обработанных кодов, [[#Лимитирование запросов|читать подробнее]]

<town code="153361" regioncode="78" regionname="Санкт-Петербург город">Санкт-Петербург город</town>

<address>Петровка 38 офис 35</address>

<area>Район 1</area>

<pvz>

<paytypecode="1">CASH</paytype>

<return_weight>5.1</return_weight>

<return_message>Доставлено в целости</return_message>

<return_date>2026-01-19</return_date>

<return_time>13:18:00</return_time>

<print_check>YES</print_check>

<receipt fdNum="124555" fnSn="9289000100295555" kktNum="0001611984048555" inn="7722756555" fdValue="2899551555" summ="387.5" ofdUrl="gate.ofd.ru">https://ofd.ru/rec/7722756555/0001611984048555/9289000100295555/124555/2899551555</receipt>

<items>

<item code="34533" extcode="abc123" quantity="1" mass="0.2" retprice="37.5" VATrate="0" barcode="2345625213125" article="1" returns="0" origincountry="040" GTD="" excise="0.00" governmentCode="11223311" govType="1" suppcompany="Поставщик" suppINN="1112223334" suppphone="79161234567">Мяч</item> <item code="34456" extcode="abc124" quantity="2" mass="2" retprice="100" VATrate="10" barcode="4645625213138" article="2" returns="0" governmentCode="" govType="1">Обруч</item> <item code="34421" extcode="abc125" quantity="3" mass="0.3" retprice="50" VATrate="18" barcode="2345625213126" itemcode="44123" article="3" returns="0" governmentCode="" govType="1">Погремушка желтая</item>

</items>

</packages>

<name>courier_car</name>

<value>ВАЗ 2106, бежевый</value>

</extrafield>

</extrafields>

</order>

</statusreq>

:* '''''ordercode''''' — внутренний код заказа в системе, применяется для некоторых внутренних операций.

:* '''''givencode''''' — внутренний код заказа в системе, применяется для некоторых внутренних операций.

*'''paytype''' - Тип оплаты заказа получателем. Принимает значения:

:: CASH - Наличными при получении (по-умолчанию)

:: CARD - Картой при получении

:: NO - Без оплаты.

:: OTHER - Прочее (Предусмотрен для того, чтобы оплата поступала непосредственно в курьерскую службу посредством прочих типов оплаты - таких как: вебмани, яденьги, картой на сайте, прочие платежные системы и т.д.)

* Атрибуты контейнера '''paytype''':

** '''''code''''' - (integer) внутренний код типа оплаты заказа в системном справочнике "Типы оплаты корреспонденции". Не обязательный элемент.

* атрибут '''''code''''' контейнера '''item''' — внутренний код строки заказа в системе, применяется для некоторых внутренних операций.

:* '''''returns''''' — количество данного товара, от которого отказался получатель. Не нулевое только в случае частичного отказа.

* '''''area''''' в контейнере '''receiver''' — район/метро получателя.

* '''''coords''''' в контейнере '''receiver''' — координаты получателя.

* '''''deliveryPIN''''' в контейнере '''receiver''' — Пин-код.

* '''partner''' — текущий филиал/подрядчик.

* '''return_message''' — информация о возврате

* '''return_date''' - дата возврата

* '''return_time''' - время возврата

* '''department''' — Подразделение, в котором оформляется заказ.

: TRANSACCEPTED — Прибыл на склад перевозчика.

: PICKUPTRANS — Забран у перевозчика.

: WITHDRAWN_FROM_PICKUP_POINT - Изъят.: CUSTOMSDELAY - Задержка отправления таможенным органом.: DEPARTUREDELAY - Задержка отправления перевозчиком.: STORETAKE - Принят в работу на складе.

'''Примечание.''' В будущем возможно дополнение используемого набора статусов.

# Контейнер '''statushistory''' и '''deliveryprice''' заполняется для тарифов [[Личный кабинет курьерской службы#Функции личного кабинета|Премиум и Максимум]].

# Контейнер '''packages''' не возвращает более 1000 элементов.

# Система никогда не гарантирует последовательность прохождения заказом набора статусов. То есть Вы можете получить статус «COMPLETE», а следующим запросом — «NEW» — такое может произойти, например, если оператор ошибочно отметил заказ выполненным, а затем исправил ошибку.

</div>

<br>

~~== Трекинг заказа по номеру ==~~

Запрос трекинга по номеру предназначен для выдачи минимальной обезличенной информации о конкретном заказе не авторизованному пользователю. Наша система имеет для этого интерфейс по адресу «home.courierexe.ru/{код экстра}/tracking». Вы можете либо сделать ссылку на такую страницу на своем сайте, либо разместить ее iframe’ом у себя, либо сделать свою и пользоваться нашим API. Этот интерфейс создан специально для выдачи информации живому пользователю сайта. Для получения статусов заказов в свою информационную систему нужно использовать запрос «statusreq», желательно с параметром changes=ONLY_LAST!

=== Лимитирование запросов ===Дает возможность получить не все измененные заказы, а только какое-то определенное количество. Помогает на случай, если у вас скопилось очень много измененных заказов и нужно их грузить лимитировано. После успешной обработки получнных заказов, '''обязательно''' нужно вызвать commitlaststatus с кодами обработанных заказов. '''Пример ~~запроса:~~''' Для получения ограниченного числа изменившихся заказов отправьте запрос:

<?xml version="1.0" encoding="UTF-8" ?><statusreq> <auth extra="8" login="login" pass="pass"></auth> <changes>ONLY_LAST</changes> <limit>5</limit></statusreq></source> После успешной обработки ответа необходимо отметить полученные статусы успешно полученными, отправив запрос:<source lang="xml"><?xml version="1.0" encoding="UTF-8" ?><commitlaststatus> <auth extra="8" login="login" pass="pass"></auth> <acs> <ac>11111</ac> <ac>22222</ac> <ac>33333</ac> <ac>44444</ac> <ac>55555</ac> </acs></commitlaststatus></source> * '''acs''' — контейнер. Обязательный элемент.* '''ac''' — атрибут''' ordercode''' контейнера '''order''' полученного на этапе запроса '''statusreq'''. Помимо приведенных в примере параметров, вы также можете передавать и остальные, описанные ранее, например '''streamid'''. == Трекинг заказа по номеру ==Запрос трекинга по номеру предназначен для выдачи минимальной обезличенной информации о конкретном заказе не авторизованному пользователю. Наша система имеет для этого интерфейс по адресу «home.courierexe.ru/{код экстра}/tracking». Вы можете либо сделать ссылку на такую страницу на своем сайте, либо разместить ее [[#Размещение страниц на своем сайте (iframe)|iframe’ом]] у себя, либо сделать свою и пользоваться нашим API. Этот интерфейс создан специально для выдачи информации живому пользователю сайта. Для получения статусов заказов в свою информационную систему нужно использовать запрос «statusreq», желательно с параметром changes=ONLY_LAST! '''Пример запроса:'''<source lang="xml"><?xml version="1.0" encoding="UTF-8"?><tracking>

<?xml version="1.0" encoding="UTF-8"?>

<item code="34421" extcode="abc125" quantity="3" mass="0.3" retprice="50" VATrate="18" barcode="2345625213126" article="3" returns="0" governmentCode="">Погремушка желтая</item>

</items>

</acquirers>

</order>

</tracking>

</source>

где,

* '''acquirers''' / '''acquirer''' - эквайринг, доступный для получения ссылки на оплату заказа

** '''acquirers''' / '''acquirer''' / ''code'' - внутренний код эквайринга

** '''acquirers''' / '''acquirer''' / ''name'' - наименование эквайринга

"time":"2016-06-02 17:22:00",

"location":"RU",

"town":"Москва",

"store":"Москва Главный",

"content":"Complete"

},

"time":"2016-06-02 17:22:00",

"location":"RU",

"town":"Москва",

"store":"Москва Главный",

"content":"Courierdelivered"

},

"time":"2016-06-02 09:17:00",

"location":"RU",

"town":"Москва",

"store":"Москва Главный",

"content":"Delivery"

},

"time":"2016-06-02 07:41:00",

"location":"RU",

"town":"Москва",

"store":"Москва Главный",

"content":"Accepted"

},

"time":"2016-06-01 19:53:00",

"location":"RU",

"town":"Горький",

"store":"Горький Автозавод",

"content":"Departure"

},

"time":"2016-06-01 17:38:00",

"location":"RU",

"town":"Горький",

"store":"Горький Автозавод",

"content":"Departuring"

},

"time":"2016-05-30 10:20:00",

"location":"RU",

"town":"Горький",

"store":"Горький Автозавод",

"content":"New"

}

Описание контейнеров ответа аналогично описанию [[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|Запроса статусов заказов]].

== ~~Изменение~~ = Получение ссылки для оплаты заказа ==Запрос предназначен для изменения заказов, по которым не было произведено изменений статуса корреспонденции, времени доставки — то есть заказов, которые ещё не в работе. Изменять заказы могут курьерские службы с тарифами «Премиум» и «Максимум». Чтобы разрешить изменение заказов, в личном кабинете курьерской службы перейдите в '''Параметры''' > '''Расширенные''' и установите флажок '''Разрешить отмену и изменение заказов'''.=

'''Обратите внимание!'''

~~# Данные запроса изменения указываются '''полностью''', как если бы заказ создавался впервые~~Этим методом вы можете только получить ссылку на оплату.~~# При отсутствии вложения в запросе изменения данное вложение '''не удаляется''' из заказа, но~~ Фискализация этого платежа идет отдельным процессом. По его ~~количество становится равным 0.~~# При одновременном изменении заказа в API и системе курьерской службы приоритет отдается данным системы курьерской службы. То есть изменения возможности уточняйте в ~~API приняты не будут~~службе поддержки.

</div>

~~При редактировании~~ Заказ доступен для оплаты, если:* тип оплаты заказа не наличными, а например картой или по договору, альтернативой может ~~быть отменен запланированный курьер~~стать установка параметра "Спрашивать тип оплаты" в карточке клиента. Это зависит от значения переменной '''Справочники''' > '''Переменные''' > '''Корреспонденция''' > '''Автоматически устанавливать заплан. курьера по району''':* ~~'''Нет''' — при редактировании заказа по АПИ курьер~~ заказ имеет наложенный платеж* не ~~изменяется;~~оплачен* ~~'''Район''' — если изменен адрес доставки~~активен (не доставлен, ~~курьер сбрасывается;~~* '''Район или дата планне возвращен в т. ~~доставки''' — если изменен адрес доставки или плановая дата вручения, курьер сбрасывается~~ч.курьером)

'''Пример запроса:'''<source lang="xml"><?xml version="1.0" encoding="UTF-8"?><acqlink> <extra>8</extra> <acq> <code>2</code> </acq> <order> <code>12345</code> </order></acqlink></source> где*'''extra''' - код экстраклиента в системе Measoft.*acq.'''code''' - внутренний код платформы эквайринга в системе Measoft. (известен в МП из [https://wiki.courierexe.ru/index.php/API#.D0.A2.D1.80.D0.B5.D0.BA.D0.B8.D0.BD.D0.B3_.D0.B7.D0.B0.D0.BA.D0.B0.D0.B7.D0.B0_.D0.BF.D0.BE_.D0.BD.D0.BE.D0.BC.D0.B5.D1.80.D1.83 Трекинга]) *order.'''ordercode''' - внутренний код заказа, типа ''int'', уникальный в пределах экстраклиента '''Пример ответа:'''<source lang="xml"><?xml version="1.0" encoding="UTF-8"?><acqlink error="0" amount="2000" extid="161083231">https://qr.nspk.ru/AD10001A7GLVGA9YDO2I0789SIOPV3?type=02&bank=1000011&sum=2000&cur=RUB&crc=7E9C</acqlink></source> где*'''acqlink''' - ссылка на оплату заказа*acqlink.'''amount''' - тип integer сумма платежа в копейках в общем случае, в других случаях в соответствии с типом валюты*acqlink.'''extid''' - идентификатор счета на стороне платежной системы*acqlink.'''error'' - код ошибки, если отличается от 0, означает невозможность получения ссылки на оплату, в этом случае ссылки на оплату не будет и ответ будет выглядеть так:<source lang="xml"><?xml version="1.0" encoding="UTF-8"?><acqlink error="2" message="Ошибка авторизации: Invalid token" amount="2000" extid=""/></source> где*acqlink.'''message''' - текст ошибки возвращаемой эквайрингом Возможные типы ошибок получения ссылки:* '''1''' - не настроен эквайринг, либо не найден заказ* '''2''' - ошибка на стороне эквайринга* '''3''' - запрещающий статус курьера (заказ доставлен, частично доставлен)* '''4''' - оплата заказа не разрешена == Изменение заказа ==Запрос предназначен для изменения заказов. Изменять заказы могут курьерские службы с тарифами «Премиум» и «Максимум». Чтобы разрешить изменение заказов, в личном кабинете курьерской службы перейдите в '''Настройки''' > '''Заказы''' и в разделе '''Отмена и редактирование''' установите флажок '''Разрешить отмену и изменение заказов'''. Вы также можете пометить в списке '''Статусы для отмены и редактирования заказов''' галками статусы корреспонденции, для которых возможны отмена и изменение заказов. По умолчанию (когда в этом списке ничего не выбрано) редактирование и отмена разрешены для статуса «Новый» <div style="color: #a94442; background-color: #f2dede; border: 1px solid #ebccd1; padding: 3px 10px 10px;">'''Обратите внимание!'''# Данные запроса изменения указываются '''полностью''', как если бы заказ создавался впервые.# При отсутствии вложения в запросе изменения данное вложение '''не удаляется''' из заказа, но его количество становится равным 0.# При одновременном изменении заказа в API и системе курьерской службы приоритет отдается данным системы курьерской службы. То есть изменения в API приняты не будут.</div> При редактировании заказа может быть отменен запланированный курьер. Это зависит от значения переменной '''Справочники''' > '''Переменные''' > '''Корреспонденция''' > '''Автоматически устанавливать заплан. курьера по району''':* '''Нет''' — при редактировании заказа по АПИ курьер не изменяется;* '''Район''' — если изменен адрес доставки, курьер сбрасывается;* '''Район или дата план. доставки''' — если изменен адрес доставки или плановая дата вручения, курьер сбрасывается. === Описание полей запроса изменения ===

Все поля запроса соответствуют структуре order при создании заказа за исключением:

== Отмена заказа ==

Запрос предназначен для отмены заказов, по которым не было произведено изменений статуса доставки, статуса корреспонденции, времени доставки, то есть заказов, которые ещё не в работе.

Отменять заказы могут курьерские службы с тарифами «Премиум» и «Максимум». ~~Чтобы разрешить отмену~~ Разрешения для отмены заказов, и статусы в ~~личном кабинете курьерской службы перейдите~~ которых заказы можно отменять описаны в разделе '''~~Параметры''' > '''Расширенные''' и установите флажок '''Разрешить отмену и изменение~~ Изменение заказов'''.

При отмене заказа поле «Инфо о доставке» получает значение «Отменено заказчиком», поле «Дата доставки» — текущую дату, а «Вручил курьер» — системную запись «ОТМЕНА».

<?xml version="1.0" encoding="UTF-8"?>

<item name="doc1.docx" timestamp="2025-01-01 12:00:00" size="35654">~~JVBERi0xLjMN~~JVBERixLjMN ~~JUBQREYwMTIzNDU2Nzg5IDI NMyAwIG9iag08PA0vVHlwZSA~~UwLJdLwIDKxTn+AScMjKqor7Xm3sp1yj1k6BzlPdX2Qsiit6yg3g1fCI4YVAgclUOIY5tDra2LvAcIS ~~U3VidHlwZSAvSW1hZ2UNL1d pZHRoIDE4MDgNL0hlaWdodCA~~5/+8PsL/sXb0+aoper/9kL/4Ov/YE9QsHwyg7YZTtKICy0YVIYb4Nt7L1tPUMfaX9NpuTsvFCtBAvYG ~~ggNCAwIFINL0JpdHNQZXJDb 21wb25lbnQgMQ0vRGVjb2RlU~~eJVZoZ2tm6+fZVqAavZpeLizVLtct1a+xvG0+bTSkw3Ac8PhdNfL4smrT2hSgPJLfyaVGyA2ndyW22t ~~ENL0NvbHVtbnMgMTgwOA0~~sFtTP5knktPNumSZ56QsFRPJkaU8ExDxAcMYMDIoBiIoR4/dDjHMbMW/EW4fiB1pvWmV2ONWIl1Xdub Xg1ob0qWX9W4qagsqzGhjRLsEGeJGVXg9oVC+XkJa9esrhGUmC0tuKEla+AplVO/OtHwXcW0FWui1z7 6KHrtobuWV0xa9sCEiSvb91w3ePHOvfcveo5xt9o4ZevHF7ZOeKxV5qmVx2MI44a1L+Mhk5YuGT12xd Ibsb7r+j9bff/unQlv0al6HBnoD5G89q4+tkjgDtvwwARmqm2aa2Jgvmth8mrXquTNtl2u467vbF/5r vnMt9uesu21Me1bjeNJGlVfAaCtw+/jfenJ/fWjqa7ygExx+~~P g0vSW1hZ2VNYXNrIHRydWUNL~~L0BcTGroxrKexQXIQ1ImfEW7ZRJZa+O ~~XhEZWNvZGUNPj4Nc3RyZWFt DQ<~~ip7xJmmNESMxrgu/~~item>~~dquBbGypjJpFDJVRH1rVPR1Ifl4aFS5IEdDWZFSdyBBWKWhVSVu517ZgzOCFAwp wwbFph29g4fTaxnvn/3X78x+Tt56ZNffArgULt+HByvy7+yz6U6XWMawCi3+6gJXN0S+jf4t+HT34wg ~~<item name="photo2.jpg" size="74861">VBERi0xLjMN~~ km7/HDp55YTSWMoCMgZsvZkBrXtIv4WA7xgkT4YpYpxjwLvnsWKkGE+pDbxER0UUWlpVFRY4oilTfM4 ~~JUBQREYwMTIzNDU2Nzg5IDI NMyAwIG9iag08PA0vVHlwZSA~~MIzgCPgxjOlZ87ceA7ceRJrgpipFGyugPQ4OTI2S8lWJoqTpHJlJbNOeYM7zTcoVxSNyJXiYWSAMklT ~~vWE9iamVjdA0vU3VidHlwZS AvSW1hZ2UNL1dpZHRoIDEzNj~~ q/xd+3fd3/USq2V1rJ7RyBLHsuDSiLwgaOFc5LUCRGI+QWuBAsIwPlZrgRpSMseJyTzD15PKiIRE7bc ~~gNL0hlaWdodCAxMzMzDS9MZ W5ndGggNCAwIFINL0JpdHNQZ~~ Rggk5ijXAPpqISetD4wVm0AD2LHuBZdaxmK3HOKIZoG0QLmiZdVqspXnFIJwVyCKhWiDCI4bzH8Y76w ~~XJDb21wb25lbnQgMQ0vRGVj b2RlUGFybXMgPDwNL0sgLTEN~~ TAnwM67HIqMISOkmJXY8mlYhpiNa7g2oTBkKxo4wgnvETQIUUrlFOn9KdOreDiKQx071rN4N61yRAi1 ~~L0NvbHVtbnMgMTM2OA0~~7EGRhSOgoeLYv+k41+KZ1SVBXAuDjB+xuxnQmm8wJDcP5IRn+~~Pg0 vSW~~5penzbR/ivm7qleHK5o790w8ejXchI vOHIPWtWwYhtAO34LdDXqFqWxZEBLNstMCwwITBTWirxk12zuUppp</item>

</attachments>

</source>

<message>Клиент отказался от покупки</message>

<items>

</items>

<~~image~~ attachments> <attachment filename="filename1.jpg"> /9j/4AAQSkZJRgA BAQAAAQABAAD/2wBDAA0JCg sKCA0LCgsODg0PEyAVExISEy ccHhcgLikxMC4pLSwzOko+M zZGNywtQFdBRkxOUlNSMj5aY VpQYEpRUk//2wBDAQ4ODhMR EyYVFSZPNS01T09PT09PT09P T09PT09PT09PT09PT09PT09 PT09PT09PT09PT09PT09PT09 PT09PT0//wAARCAYACAADAS IA</attachment> <attachment filename="filename2.jpg"> /9j/4AAQSkZJRgA BAQAAAQABAAD/2wBDAA0JCg sKCA0LCgsODg0PEyAVExISEy ccHhcgLikxMC4pLSwzOko+M zZGNywtQFdBRkxOUlNSMj5aY VpQYEpRUk//2wBDAQ4ODhMR EyYVFSZPNS01T09PT09PT09P T09PT09PT09PT09PT09PT09 PT09PT09PT09PT09PT09PT09 PT09PT0//wAARCAYACAADAS IA</~~image~~attachment> </attachments>

</order>

</setorderinfo>

* '''outstrbarcode''' — код у подрядчика (код заказа во внешней системе). Используется в интеграциях с внешними системами.

* '''paytype''' — Тип оплаты заказа. Допустимые значения CASH/CARD.

* '''storeprice''' — Агентское вознаграждение.

* '''items''' — Контейнер для описания вложений '''item''' . Атрибуты:

:* '''''code''''' — Код вложения.

:* '''''quantity''''' — Количество доставленных единиц вложения.

:* '''''reason''''' — Причина недоставки, выбирается из соответствующего списка статусов.

:* '''~~image~~''governmentCode''''' — Указание кода ТН для вложения при необходимости.* '''attachments''' — Контейнер ~~прикрепляемого изображения~~прикрепляемых изображений. ~~Содержит текст файла изображения, закодированный по стандарту~~ Может содержать несколько контейнеров ''~~base64~~'attachment'~~. Контейнер~~ '':* '~~order~~''attachment' ~~может содержать более одного контейнера~~ '' — Контейнер изображения. Содержит текст файла изображения, закодированный по стандарту '~~image~~'base64''. Атрибут:::* '''''filename''''' — Имя файла.

<client>CLIENT</client>

</orders>

</waybill>

</source>

'''waybill''' — Корневой контейнер. Обязательный элемент

* '''auth''' — Авторизация. Обязательный элемент

* '''client''' — Признак клиента или агента. Необязательный элемент.

:* CLIENT — Признак клиента, значение по умолчанию

:* AGENT — Признак агента. В ответ отдается информация по заказам, переданным агенту на доставку

* '''orders''' — Список заказов для получения печатных форм. Содержит тэги '''order''' с атрибутами:

:* '''''orderno''''' — шифр заказа

:* 3 — Наклейки на страницу формата А4

:* 4 — Акты приема-передачи

* '''start''' — Имеет смысл только для form = 3. Начальная позиция первой наклейки. Используется для пропуска наклеек на листе для их экономии.

* '''integration''' - Получение наклеек от подрядчика. Не обязательный элемент, имеет смысл при наличии кода подрядчика в карточке заказа. Принимает значение:

:* 21 - подрядчик GTD

<?xml version="1.0" encoding="UTF-8"?>

<content>JVBERi0xLjYNJeLjz9MNC...</content>

</order>

<content>JVBERi0xLjYNJeLjz9MNC...</content>

</order>

</integration>

<content>EODIcaI8KSBlwQ 4MnEOR7Px8U8EBAyGICBnwpw

IZhQgz0ZxuPs8EBM/GcbjzB AwhBl8hwQYIO00GmEwg1CeEG

В тэге content возвращаются бинарные данные (файл pdf), закодированные в base64.

При записи в файл необходимо использовать двоичный формат записи!

Блок integration содержит отдельные наклейки для заказов, предоставленные подрядчиком, так же закодированные в base64. '''Обратите внимание'''~~, что печатные~~ Лимит количества при единовременном получении печатных форм - 1000 штук. Если нужно получить больше - делайте это несколькими запросами. '''Обратите внимание''' Печатные формы для заборов не формируются.

</document>

</serials>

</itemmovements>

</itemlist>

:* '''message''' — комментарий

~~== Получение справочника тарифов по городам ==~~* '''serials''' — контейнер серийных номеров:* '''serial''' — серийный номер единицы номенклатуры, участвующей в движении

== Серийные номера =='''Пример запроса ~~справочника тарифов по городам~~движения номенклатуры с серийным номером:'''

<?xml version="1.0" encoding="UTF-8"?><~~tariffs~~serialmovements> <auth extra="8" login="login" pass="pass" /> ~~<townfrom~~>~~Москва~~</~~townfrom>~~ ~~<service>1</service~~auth> <~~mainonly~~serial>1123456789</~~mainonly~~serial> </~~tariffs~~serialmovements>

</source>

* '''~~auth~~serial''' — ~~атрибут '''extra''' обязателен, по нему определяется курьерская служба.~~* '''townfrom''' — город-отправитель. Если не передан, то городом будет «Москва».* '''service''' — режим доставки. Обязательный элемент.* '''mainonly''' — необязательный элемент. Если передан, то в ответе будут данные только по городам из справочника '''Межгород''' > '''Зоны'''серийный номер единицы номенклатуры.

'''Пример ответа ~~справочника тарифов по городам~~движения номенклатуры с серийным номером:'''<source lang="~~json~~xml">{ <?xml version="~~townfrom~~1.0": encoding="~~0c5b2444-70a0-4932-980c~~UTF-~~b4dc0d3f02b5~~8",?> <serialmovements count="~~service~~16"~~: 1,~~> <serialmovement> ~~"tariffs": [~~<code>151500</code> { <serial>123456789</serial> ~~"towntofias": "0c5b2444~~ <date>2017-~~70a0~~05-~~4932-980c-b4dc0d3f02b5",~~26</date> ~~"towntocode": 1,~~ ~~"towntoname": "Москва город",~~ ~~"townregion": "Город Москва",~~ ~~"distance":~~ <delivered>0,</delivered> ~~"pricedistance": 0,~~ <item> ~~"pricesnew": {~~ <code>4259</code> ~~"before": [~~ <name>Настольная игра Дженга</name> { </item> ~~"price": 100,~~ <status> ~~"every": 0,~~ <code>5</code> ~~"mass": 1~~ <name>Возврат от покупателя</name> }, </status> { <order> ~~"price": 150,~~ <ordercode>3374830</ordercode> ~~"every":~~ <number>123660-0,</number> ~~"mass": 5~~ <date>2017-05-24</date> } <orderno>14123</orderno> ], <barcode>0000000670</barcode> ~~"after": [~~ <company>ТОВАР</company> { ~~"price": 0~~ <address>Кравченко ул., ~~"every":~~ 1,</address> ~~"mass": 38.01~~ <delivereddate>2017-05-29</delivereddate> }, { ~~"price"~~ <deliveredtime>12: ~~15,~~ ~~"every"~~00: 1,00</deliveredtime> ~~"mass": 51.01~~ <deliveredto /> } </order> ] <document> }, <code>21991</code> ~~"deliveryPeriodMin": 1,~~ <number>318</number> ~~"deliveryPeriodMax": 2~~ <date>2017-05-26</date> } <message></message> ]</document> </serialmovement>}</serialmovements>

</source>

''' Описание полей ответа '''

* '''townfrom''' — код ФИАС города-отправителя.

* '''service''' — режим доставки.

* '''tariffs''' — cписок тарифов по городу.

~~:* '''townregion''' — регион города-получателя.~~

~~:* '''towntofias''' — код ФИАС города-получателя.~~

~~:* '''towntocode''' — внутренний код города-получателя.~~

~~:* '''towntoname''' — наименование города-получателя.~~

~~:* '''distance''' — дистанция в км до города от МКАД, если в запросе townfrom — Москва.~~

~~:* '''pricedistance''' — сумма за километраж до города от МКАД, если в запросе townfrom — Москва.~~

~~:* '''pricesnew''' — ваши настройки тарифов из справочника '''Межгород''' > '''Тарифы по зонам'''.~~

~~::* '''before/after''' — контейнеры ДО/ОТ.~~

~~:::* '''price''' — цена. Если ответ идет по «before», то в цену также плюсуется сумма pricedistance~~

~~:::* '''every''' — за каждые.~~

~~:::* '''mass''' — масса.~~

~~:* '''prices''' — устаревший элемент, не используется.~~

~~:* '''deliveryPeriodMin''' — минимальный срок доставки.~~

~~:* '''deliveryPeriodMax''' — максимальный срок доставки.~~

Описание аналогично описанию полей [[#Движение номенклатуры|движения номенклатуры]] == ~~Номенклатура приходной накладной~~ Серийные номера по заказу =='''Пример запроса ~~номенклатуры приходной накладной~~движения серийных номеров заказа:'''

<?xml version="1.0" encoding="UTF-8" ?>

<~~itemdoc~~orderserials> <auth extra="8" login="login" pass="pass"></auth> <~~code~~ordercode>~~21991~~123456789</~~code~~ordercode> <orderno>123456789</orderno> <barcode>123456789</barcode></~~itemdoc~~orderserials>

</source>

* '''~~code~~ordercode''' — внутренний код ~~документа приходной накладной (см~~заказа. ~~предыдущий запрос)~~* '''orderno''' — шифр заказа.* '''barcode''' — штрих-код заказа.Указывать необходимо один из идентификаторов заказа.

'''Пример ответа движения ~~номенклатуры~~серийных номеров заказа:'''

<?xml version="1.0" encoding="UTF-8" ?>

<~~itemdoc~~orderserials> <order> <code>~~21991~~3374830</code> <orderno>14123</orderno> <~~number~~barcode>~~318~~0000000670</~~number~~barcode> <~~date~~delivereddate>~~2017~~2024-0507-2620</~~date~~delivereddate> <deliveredtime>10:04:00</deliveredtime> <assemblydate>2024-07-19 07:05:34<~~message~~/assemblydate> </~~message~~order>

<items>

<item > <code=">4259~~" quantity="1" barcode="200300" article="123555"~~</code> <name>Настольная игра Дженга</name> <article>123000</article> <state>Delivered</state> <serials> <serial>123456789</serial> </serials> </item> </items></~~itemdoc~~orderserials>

</source>

''' Описание полей ответа '''

* '''code''' — внутренний код приходной накладной

* '''number''' — номер документа

* '''date''' — дата документа

* '''message''' — комментарий

* '''~~item~~order''' — ~~контейнер товара~~блок заказа::* '''code''' — ~~внутренний~~ код ~~товара~~:* '''orderno''' — шифр:* '''barcode''' — ~~штрихкод товара~~штрих-код:* '''delivereddate''' — дата доставки факт:* '''~~article~~deliveredtime''' — ~~артикул товара~~время доставки факт:* '''~~quantity~~assemblydate''' — ~~количество поступившего товара~~дата сборки

~~== Справочник филиалов ==~~* '''item''' — блок товара::* '''~~Пример запроса списка филиалов~~code''' — код:* '''name''' — наименование~~<source lang="xml">~~:* '''article''' — артикул~~<?xml version="1.0" encoding="UTF-8" ?>~~:* '''state''' — статус Доставлено (Delivered) или Возвращено (Returned)~~<storelist>~~ ~~<auth extra="8"></auth>~~ ~~<json>YES</json>~~ ~~<client_code>7890</client_code></storelist></source>~~:* '''serials''' — блок серийных номеров по заказу

* '''auth''' — Атрибут '''extra''' — обязателен, == Получение справочника тарифов по ~~нему определяется курьерская служба~~* '''json''' — Признак вывода ответа в виде JSON YES/NO* '''client_code''' — Код клиента курьерской службыгородам ==

'''Пример ~~ответа:~~запроса справочника тарифов по городам'''

<?xml version="1.0" encoding="UTF-8" ?><~~storelist count~~tariffs> <auth extra="8" login="2login" pass="pass"> ~~<store>~~ ~~<code>123<~~/~~code~~> ~~<name>ABC~~ <~~/name~~townfrom> Москва</~~store~~townfrom> <~~store~~service> ~~<code>456~~1</~~code~~service> <~~name~~mainonly>~~Филиал 2~~1</~~name>~~ ~~</store~~mainonly> </~~storelist~~tariffs>

</source>

* '''~~code~~auth''' — ~~Код филиала~~атрибут '''extra''' обязателен, по нему определяется курьерская служба.* '''townfrom''' — город-отправитель. Если не передан, то городом будет «Москва».* '''service''' — режим доставки. Обязательный элемент.* '''~~name~~mainonly''' — ~~Наименование филиала~~необязательный элемент.Если передан, то в ответе будут данные только по городам из справочника '''Межгород''' > '''Зоны'''.

~~== Справочник пунктов самовывоза ==Для отображения списка пунктов выдачи (ПВЗ) есть '''готовый JavaScript модуль''': https://home~~Важно понимать, что в ответе отдаются только тарифы, указанные в разделе "Тарифы по зонам" раздела "Межгород" в офисной системе курьерской службы, т.~~courierexe~~е.~~ru/js/measoft_map~~считающихся междугородними.~~js Инструкция~~ Доставка до городов, рассчитываемая по ~~использованию — внутри. Посмотреть пример работы можно [https://home.courierexe.ru/pvz_test.html Здесь]~~внутригородским тарифам, в ответе НЕ ОТДАЕТСЯ!

Уникальные запросы списка ПВЗ кешируются на стороне личного кабинета и хранятся до 7 часов утра по московскому времени следующего дня. Например, если уникальный запрос с массой 2 кг был отправлен сегодня в 10 часов, то завтра в 7 утра он сбросится. Если сегодня в 18 часов в этом же запросе вы укажете массу 2 кг, в ответе вернется тот же список ПВЗ. Если передадите массу 3 кг, список может быть другим.

Обратите внимание, что если в выборке количество ПВЗ больше '''10000''' и не указаны параметры '''code''', '''json''' или '''limitcount''', то будет возвращаться ошибка. В этом случае необходимо использовать блок '''limit'''.

'''Пример ~~запроса пунктов самовывоза:~~ответа справочника тарифов по городам'''<source lang="~~xml~~json">~~<?xml version=~~{ "townfrom": "0c5b2444-70a0-4932-980c-b4dc0d3f02b5", "service": 1.0, "tariffs": [ { "towntofias" ~~encoding=~~: "~~UTF~~0c5b2444-870a0-4932-980c-b4dc0d3f02b5", "towntocode": 1, "towntoname": "Москва город", "townregion": "Город Москва" ?>,~~<pvzlist>~~ "distance": 0, ~~<auth extra=~~ "8pricedistance" ~~login=~~: 0, "~~login~~pricesnew" ~~pass=~~: { "~~pass~~before"~~></auth>~~: [ ~~<code>1234</code>~~ { ~~<client_code>7890</client_code>~~ "price": 100, ~~<city>Свердловская область</city>~~ "every": 0, ~~<town regioncode=~~ "66mass" ~~country=~~: 1 }, { "RUprice"~~>Нижний Тагил</town>~~: 150, ~~<address>Щёлковское шоссе</address>~~ "every": 0, ~~<house>77</house>~~ "mass": 5 ~~<parentcode>6</parentcode>~~ } ~~<acceptcash>YES</acceptcash>~~ ], ~~<acceptcard>YES</acceptcard>~~ "after": [ ~~<acceptfitting>YES</acceptfitting>~~ { ~~<maxweight>30</maxweight>~~ "price": 0, ~~<acceptindividuals>YES</acceptindividuals>~~ "every": 1, ~~<lt>57~~ "mass": 38.~~924737</lt>~~01 }, { ~~<lg>59.940019</lg>~~ "price": 15, ~~<rt>57.905682</rt>~~ "every": 1, ~~<rg>59~~ "mass": 51.~~984669</rg>~~01 ~~<json>YES</json>~~ } ~~<with_coords>YES</with_coords>~~ ] ~~<limit>~~ }, ~~<limitfrom>30</limitfrom>~~ "deliveryPeriodMin": 1, ~~<limitcount>~~ "deliveryPeriodMax": 2~~</limitcount>~~ } ~~<countall>YES</countall>~~] ~~</limit></pvzlist>~~}

</source>

''' Описание полей ответа '''* '''townfrom''' — код ФИАС города-отправителя.* '''~~auth~~service''' — ~~Атрибут~~ режим доставки.* '''~~extra~~tariffs''' — ~~обязателен,~~ cписок тарифов по ~~нему определяется курьерская служба,~~ городу.:* '''~~login~~townregion''' и — регион города-получателя.:* '''~~pass~~towntofias''' ~~позволяют авторизоваться под клиентом~~ — код ФИАС города-получателя.: ~~для отдельного клиента могут быть ограничения по доступности некоторых ПВЗ, и в этом случае они будут учтены~~* '''towntocode''' — внутренний код города-получателя.:* '''~~code~~towntoname''' — ~~Внутренний код~~наименование города-получателя.:* '''~~client_code~~distance''' — ~~Код клиента курьерской службы~~дистанция в км до города от МКАД, если в запросе townfrom — Москва.:* '''~~city~~pricedistance''' — ~~Регион получателя~~сумма за километраж до города от МКАД, если в запросе townfrom — Москва. ~~Можно указать код региона или полное наименование региона~~ :* '''pricesnew''' — ваши настройки тарифов из ~~[[#Справочник регионов|~~справочника ~~регионов]]~~'''Межгород''' > '''Тарифы по зонам'''.::* '''~~town~~before/after''' — ~~Город получателя~~контейнеры ДО/ОТ.~~Для тега города~~ :::* '''~~town~~price''' ~~можно указать код региона~~ — цена. Если ответ идет по «before», то в ~~атрибуте~~ цену также плюсуется сумма pricedistance:::* '''every''' — за каждые.:::* '''mass''' — масса.:* '''prices''' — устаревший элемент, не используется.:* '''deliveryPeriodMin''' — минимальный срок доставки.:* '''deliveryPeriodMax''' — максимальный срок доставки. == Номенклатура приходной накладной =='~~regioncode~~''Пример запроса номенклатуры приходной накладной:''' ~~из [[#Справочник регионов|справочника регионов]]~~<source lang="xml"><?xml version="1.0" encoding="UTF-8" ?><itemdoc> <auth extra="8" login="login" pass="pass"></auth> <code>21991</code></itemdoc></source> * '''code''' — внутренний код документа приходной накладной (см. ~~Поиск будет производиться в указанном регионе~~предыдущий запрос).

Также можно указать страну получателя в атрибуте '''''country''''' в соответствии с [https://ru.wikipedia.org/wiki/ISO_3166-1 стандартом ISO_3166-1], например, «RU», «RUS» или «643» для России.

~~Для формата запроса JSON фильтрация по городу работает только в связке с фильтром по адресу.~~

* '''address''' — Фильтр по адресу, работает только в связке с фильтром по городу* '''house''' — Фильтр по номеру дома, работает только в связке с фильтрами по адресу и городу* '''parentcode''' — Фильтр по родительскому [[#Справочник филиалов|филиалу]]* '''acceptcash''' — Фильтр по приему наличных YES/NO* '''acceptcard''' — Фильтр по приему банковских карт YES/NO* '''acceptfitting''' — Фильтр по наличию примерки YES/NO* '''maxweight''' — Фильтр по максимальному весу, с которым работает ПВЗ* '''acceptindividuals''' — Фильтр по доступности физическим лицам YES/NO* '''lt''' — Широта левого верхнего угла* '''lg''' — Долгота левого верхнего угла* '''rt''' — Широта правого нижнего угла* '''rg''' — Долгота правого нижнего угла* '''json''' — Признак вывода ответа в виде JSON YES/NO* '''with_coords''' — Признак вывода ПВЗ только с наличием координат YES/NO* '''limit''' — Ограничивает вывод результата.~~:* '''limitfrom''' — Задает номер записи результата, начиная с которой выдавать ответ. По-умолчанию — 0.:* '''limitcount'''- Задает количество записей результата, которые нужно вернуть. По-умолчанию — 100.~~:* '''countall''' — YES указывает на необходимость подсчета общего количества найденных совпадений. Это может замедлять выполнение запроса. Если отключено — в ответе не указываeтся totalcount. '''Пример ответа ~~справочника пунктов самовывоза~~движения номенклатуры:'''

<?xml version="1.0" encoding="UTF-8" ?>

<~~pvzlist count="2" totalcount="40465"~~itemdoc> ~~<pvz>~~ <code>~~126~~21991</code> <~~clientcode~~number>3318</~~clientcode~~number> <~~name~~date>~~Нижний Тагил~~2017-05-26</~~name~~date> <~~parentcode~~message>6</~~parentcode~~message> <~~parentname>Интеграция</parentname~~items> <~~town~~ item code="~~124267~~4259" ~~regioncode~~quantity="661" ~~regionname~~barcode="~~Свердловская область~~200300" article="123555">~~Нижний Тагил город~~Настольная игра Дженга</~~town~~item> ~~<address>622036, г. Нижний Тагил, ул. Циолковского, д. 17~~ </~~address~~items> ~~<phone>+73435417709, +73435254989~~</~~phone~~itemdoc> ~~<comment>Новый пункт доставки~~</~~comment~~source> ~~<worktime>Вс 10:00-16:00, Сб 10:00-16:00, Пн-Пт 10:00-20:00</worktime>~~ <traveldescription>Жилое 5-ти этажное здание, торцом к дороге, второе здание от перекрестка Пархоменко-Циолковского</traveldescription>''' Описание полей ответа ''' ~~<maxweight>10</maxweight>~~* '''code''' — внутренний код приходной накладной ~~<acceptcash>YES</acceptcash>~~* '''number''' — номер документа ~~<acceptcard>YES</acceptcard>~~* '''date''' — дата документа ~~<acceptfitting>YES</acceptfitting>~~* '''message''' — комментарий ~~<acceptindividuals>YES</acceptindividuals>~~ ~~<latitude>57.93457</latitude>~~* '''item''' — контейнер товара ~~<longitude>59.95131</longitude>~~:* '''code''' — внутренний код товара ~~<uid>40606d00-9c51-11eb-b2c9-cfd6c1111392</uid>~~:* '''barcode''' — штрихкод товара ~~</pvz>~~:* '''article''' — артикул товара ~~<pvz>~~:* '''quantity''' — количество поступившего товара ~~<code>245</code>~~ ~~<clientcode>NTG1</clientcode>~~== Справочник филиалов == ~~<name>На Красноармейской</name>~~'''Пример запроса списка филиалов:''' <~~parentcode>6</parentcode~~source lang="xml"> <~~parentname>Интеграция</parentname>~~ ~~<town code~~?xml version="~~124267~~1.0" ~~regioncode~~encoding="~~66" regionname="Свердловская область~~UTF-8"~~>Нижний Тагил город</town~~?> ~~<address>КРАСНОАРМЕЙСКАЯ, д.79~~<~~/address~~storelist> <~~phone>+7(3435)379-044</phone>~~ ~~<comment>Возможность примерки отсутствует</comment>~~ ~~<worktime>Вс 10:00-16:00, Сб 10:00-16:00, Пн-Пт 10:00-20:00</worktime>~~ ~~<traveldescription>Напротив ТЦ Пирамида</traveldescription>~~ ~~<maxweight>20</maxweight>~~ ~~<acceptcash>YES</acceptcash>~~ ~~<acceptcard~~auth extra="8">~~YES~~</~~acceptcard~~auth> ~~<acceptfitting>NO</acceptfitting>~~ <~~acceptindividuals~~json>YES</~~acceptindividuals~~json> <~~latitude~~client_code>~~57.93468</latitude>~~ ~~<longitude>60.55476</longitude>~~ ~~<uid>41116853-9c51-11eb-b2c9-cfd6c1451392</uid>~~ 7890</~~pvz~~client_code></~~pvzlist~~storelist>

</source>

* '''~~code~~auth''' — ~~Код ПВЗ в системе. Используется в запросе [[API#Оформление заказа|оформления заказов]]~~* Атрибут '''~~clientcode~~extra''' — ~~Код ПВЗ используемый компанией-подрядчиком.~~обязателен, по нему определяется курьерская служба* '''~~name~~json''' — ~~Наименование ПВЗ.~~Признак вывода ответа в виде JSON YES/NO* '''~~parentcode~~client_code''' — Код ~~родительского элемента.~~клиента курьерской службы * '''~~parentname~~Пример ответа:''' ~~— Наименование родительского элемента.~~* '''town''' — Населенный пункт с кодом из [[#Справочник городов|справочника городов]], а также с кодом и наименованием региона<source lang="xml"><?xml version="1.0" encoding="UTF-8" ?>* '''address''' — Адрес ПВЗ.<storelist count="2">* '''phone''' — Телефоны ПВЗ. <store>* '''comment''' — Дополнительная информация. <code>123</code> * '''worktime''' — Режим работы ПВЗ. <name>ABC</name> * '''traveldescription''' — Описание местонахождения ПВЗ или пути к нему. </store>* '''maxweight''' — Максимальный вес, с которым работает ПВЗ. <store>* '''acceptcash''' — Признак приема наличных <code>456</code> * '''acceptcard''' — Признак приема банковских карт <name>Филиал 2</name> * '''acceptfitting''' — Наличие примерки </store>* '''latitude''' — Широта</storelist>* '''longitude''' — Долгота</source>* '''uid''' — Уникальный идентификатор ПВЗ в системе Measoft* '''~~count~~code''' — ~~Количество записей в ответе~~Код филиала.* '''~~totalcount~~name''' — ~~Общее количество записей, отвечающее параметрам запроса~~Наименование филиала.

== ~~Получение фискальных данных заказа~~ Справочник пунктов самовывоза ==Для отображения списка пунктов выдачи (ПВЗ) есть '''~~Пример запроса получения фискальных данных:~~готовый JavaScript модуль'''~~<source lang="xml"><?xml version="1~~: https://home.courierexe.~~0" encoding="UTF-8"?><receiptdata>~~ ~~<auth extra="8" login="login" pass="pass"~~ ru/> ~~<orders>~~ ~~<order orderno="123456"~~ js/> ~~<order orderno="890111C"~~ measoft_map.js Инструкция по использованию — внутри. Посмотреть пример работы можно [https:/> </~~orders>~~<home.courierexe.ru/~~receiptdata>~~pvz_test.html Здесь]

Уникальные запросы списка ПВЗ кешируются на стороне личного кабинета и хранятся до 7 часов утра по московскому времени следующего дня. Например, если уникальный запрос с массой 2 кг был отправлен сегодня в 10 часов, то завтра в 7 утра он сбросится. Если сегодня в 18 часов в этом же запросе вы укажете массу 2 кг, в ответе вернется тот же список ПВЗ. Если передадите массу 3 кг, список может быть другим.

~~</source>~~Обратите внимание, что если в выборке количество ПВЗ больше '''10000''' и не указаны параметры '''code''', '''json''' или '''limitcount''', то будет возвращаться ошибка. В этом случае необходимо использовать блок '''limit'''.

'''Пример ~~ответа получения фискальных данных~~запроса пунктов самовывоза:'''

<?xml version="1.0" encoding="UTF-8"?><~~receipts count~~pvzlist> <auth extra="8" login="login" pass="1pass"></auth> <~~receipt~~code>1234</code> <~~orderno~~client_code>~~123456~~7890</~~orderno~~client_code> <~~fdDatetime~~city>~~2020-06-07 12:14:00~~Свердловская область</~~fdDatetime~~city> <~~fdValue~~town regioncode="66" country="RU">~~123~~Нижний Тагил</~~fdValue~~town> <~~fdNum~~address>~~456~~Щёлковское шоссе</~~fdNum~~address> <~~fnSn~~house>~~789~~77</~~fnSn~~house> <~~kktNum~~advanced_search>~~100~~Строка поиска</~~kktNum~~advanced_search> <~~inn~~parentcode>~~222~~6</~~inn~~parentcode> <~~ofdUrl~~acceptcash>~~gate.ofd.ru~~YES</~~ofdUrl~~acceptcash> <~~fullUrl~~acceptcard>~~https:~~YES</acceptcard> <acceptfitting>YES</~~check.ofd.ru/123~~acceptfitting> <maxweight>30</~~fullUrl~~maxweight> <~~price~~acceptindividuals>~~12345~~YES</~~price~~acceptindividuals> <~~lines count="1"~~respstores> YES<~~line~~/respstores> <~~item~~lt>~~1111764~~57.924737</~~item~~lt> <~~name~~lg>~~Сапоги~~59.940019</~~name~~lg> <~~qty~~rt>157.905682</~~qty~~rt> <~~price~~rg>~~1000~~59.984669</~~price~~rg> <~~vatRate~~json>20YES</~~vatRate~~json> <~~governmentCode~~with_coords>~~Z16513LK2~~YES</~~governmentCode~~with_coords> <~~itemType~~limit>1 <limitfrom>30</~~itemType~~limitfrom> <limitcount>2</~~line~~limitcount> <countall>YES</~~lines~~countall> </~~receipt~~limit></~~receipts~~pvzlist>

</source>

~~Параметры ответа:~~* '''~~orderno~~auth''' — ~~Номер заказа~~* Атрибут '''~~fdDatetime~~extra''' — ~~Дата и время пробития фискального чека~~* обязателен, по нему определяется курьерская служба, '''~~fdValue~~login''' ~~— ФПД (фискальный признак документа)~~* и '''~~fdNum~~pass''' ~~— ФИСКАЛЬНЫЙ ДОКУМЕНТ (фискальный номер чека)~~позволяют авторизоваться под клиентом: для отдельного клиента могут быть ограничения по доступности некоторых ПВЗ, и в этом случае они будут учтены.* '''~~fnSn~~code''' — ~~ФН (номер фискального накопителя)~~Внутренний код, целое число.* '''~~kktNum~~client_code''' — ~~РН (регистрационный номер кассы)~~Код клиента курьерской службы.* '''~~inn''' — ИНН~~* '''ofdUrl''' — URL адрес (доменное имя) ОФД* '''price''' — Сумма чека* '''fullUrl''' — URL чека для просмотра онлайн* '''lines''' — Позиции чека~~:* '''item~~city''' — Регион получателя. Можно указать код ~~товара:* '''name''' —~~ региона или полное наименование ~~товара~~региона из [[#Справочник регионов|справочника регионов]].:* '''~~qty~~town''' — ~~количество товара~~Город получателя.:* Для тега города '''~~price~~town''' ~~— цена товара:* '''governmentCode''' — считанная последовательность, которая~~ можно указать код региона в ~~дальнейшем преобразуется по алгоритму тега 1162:* ''~~атрибуте '~~vatRate~~''' ~~— НДС товара~~:* 'regioncode''~~itemType~~''' ~~— тип товара (товар, доставка и т~~из [[#Справочник регионов|справочника регионов]]. дПоиск будет производиться в указанном регионе.)

== Также можно указать страну получателя в атрибуте '''''country''''' в соответствии с [https://ru.wikipedia.org/wiki/ISO_3166-1 стандартом ISO_3166-1], например, «RU», «RUS» или «643» для России.Для формата запроса JSON фильтрация по городу работает только в связке с фильтром по адресу. * '''address''' — Фильтр по адресу, работает только в связке с фильтром по городу* '''house''' — Фильтр по номеру дома, работает только в связке с фильтрами по адресу и городу* '''advanced_search''' — Фильтр по коду агента, наименованию, телефону или комментарию* '''parentcode''' — Фильтр по родительскому [[#Справочник ~~Виды срочности ==~~филиалов|филиалу]]* '''acceptcash'~~Пример запроса видов срочности:~~'' — Фильтр по приему наличных YES/NO* '''acceptcard''' — Фильтр по приему банковских карт YES/NO* '''acceptfitting''' — Фильтр по наличию примерки YES/NO* '''maxweight''' — Фильтр по максимальному весу, с которым работает ПВЗ~~<source lang="xml">~~* '''acceptindividuals''' — Фильтр по доступности физическим лицам YES/NO~~<?xml version="1.0" encoding="UTF~~* '''respstores''' -~~8" ?>~~Признак вывода ответственных филиалов при значении YES~~<services>~~* '''lt''' — Широта левого верхнего угла~~<auth extra="8"~~* '''lg''' — Долгота левого верхнего угла* '''rt''' — Широта правого нижнего угла* '''rg''' — Долгота правого нижнего угла* '''json''' — Признак вывода ответа в виде JSON YES/>NO<* '''with_coords''' — Признак вывода ПВЗ только с наличием координат YES/~~services>~~NO~~</source>~~* '''limit''' — Ограничивает вывод результата.:* '''limitfrom''' — Задает номер записи результата, начиная с которой выдавать ответ. По-умолчанию — 0.:* '''limitcount'''- Задает количество записей результата, которые нужно вернуть. По-умолчанию — 100.:* '''countall''' — YES указывает на необходимость подсчета общего количества найденных совпадений. Это может замедлять выполнение запроса. Если отключено — в ответе не указываeтся totalcount.

~~'''Пример ответа справочника видов срочности:'''~~

~~<source lang="xml">~~

~~<?xml version="1.0" encoding="UTF-8" ?>~~

~~<services count="2">~~

~~<service>~~

~~<code>1</code>~~

~~<name>Эконом</name>~~

~~</service>~~

~~<service>~~

~~<code>2</code>~~

~~<name>Срочно</name>~~

~~</service>~~

~~</services>~~

~~</source>~~

~~== Справочник дополнительных услуг ==~~'''Пример ~~запроса дополнительных услуг~~ответа справочника пунктов самовывоза:'''

<?xml version="1.0" encoding="UTF-8"?><~~advprices~~pvzlist count="2" totalcount="40465"> <pvz> <code>126</code> <clientcode>3</clientcode> <name>Нижний Тагил</name> <parentcode>6</parentcode> <parentname>Интеграция</parentname> <~~auth extra~~town code="8124267" ~~login~~regioncode="~~login~~66" ~~pass~~regionname="~~pass~~Свердловская область" >Нижний Тагил город</town> <address>622036, г. Нижний Тагил, ул. Циолковского, д. 17</address> <phone>+73435417709, +73435254989</phone> <comment>Новый пункт доставки</comment> <worktime>Вс 10:00-16:00, Сб 10:00-16:00, Пн-Пт 10:00-20:00</~~advprices~~worktime> <traveldescription>Жилое 5-ти этажное здание, торцом к дороге, второе здание от перекрестка Пархоменко-Циолковского</~~source~~traveldescription> <maxweight>10</maxweight>~~'''advprices''' — Корневой контейнер. Обязательный элемент.~~ <acceptcash>YES</acceptcash> <acceptcard>YES</acceptcard> <acceptfitting>YES</acceptfitting>~~'''Пример ответа справочника дополнительных услуг:'''~~ <acceptindividuals>YES</acceptindividuals> <latitude>57.93457<~~source lang="xml"~~/latitude> <~~?xml version="1~~longitude>59.~~0" encoding="UTF~~95131</longitude> <uid>40606d00-9c51-11eb-b2c9-~~8" ?~~cfd6c1111392</uid> <~~advprices~~/pvz> <~~advprice~~pvz> <code>1245</code> <clientcode>NTG1</clientcode> <name>~~Этажей в доме~~На Красноармейской</name> <parentcode>6</parentcode> <~~type~~parentname>~~int~~Интеграция</~~type~~parentname> <town code="124267" regioncode="66" regionname="Свердловская область">Нижний Тагил город</~~advprice~~town> <~~advprice~~address>КРАСНОАРМЕЙСКАЯ, д.79</address> <~~code~~phone>+7(3435)379-044</phone> <comment>Возможность примерки отсутствует</comment> <worktime>Вс 10:00-16:00, Сб 10:00-16:00, Пн-Пт 10:00-20:00</worktime> <traveldescription>2Напротив ТЦ Пирамида</~~code~~traveldescription> <~~name~~maxweight>~~Коэффициент надбавки~~20</~~name~~maxweight> <~~type~~acceptcash>~~float~~YES</~~type~~acceptcash> <acceptcard>YES</~~advprice~~acceptcard> <acceptfitting>NO<~~advprice~~/acceptfitting> <~~code~~acceptindividuals>YES</acceptindividuals> <latitude>357.93468</~~code~~latitude> <~~name~~longitude>~~Расписаться на упаковке~~60.55476</~~name~~longitude> <~~type~~uid>~~bool~~41116853-9c51-11eb-b2c9-cfd6c1451392</~~type~~uid> </~~advprice~~pvz></~~advprices~~pvzlist>

</source>

~~Параметры:~~* '''code''' — Код ПВЗ в системе. Используется в запросе [[API#Оформление заказа|оформления заказов]]* '''~~code~~clientcode''' — ~~внутренний код услуги~~Код ПВЗ используемый компанией-подрядчиком.* '''name''' — ~~наименование услуги~~Наименование ПВЗ.* '''parentcode''' — Код родительского элемента.* '''parentname''' — Наименование родительского элемента. ~~Если поле «название в ЛК» в настройках услуги не пусто~~* '''town''' — Населенный пункт с кодом из [[#Справочник городов|справочника городов]], ~~то возвращает значение поля «название в ЛК»~~а также с кодом и наименованием региона.* '''address''' — Адрес ПВЗ.* '''phone''' — Телефоны ПВЗ.* '''comment''' — Дополнительная информация.* '''~~hine~~worktime''' — ~~подсказка по доп услуге для пользователя~~Режим работы ПВЗ.* '''~~type~~traveldescription''' — ~~тип услуги~~Описание местонахождения ПВЗ или пути к нему. ~~Может иметь значения:~~:* '''~~bool~~maxweight''' — ~~для услуг вида «чекбокс»~~Максимальный вес, ~~«Да»~~с которым работает ПВЗ.* '''acceptcash''' — Признак приема наличных* '''acceptcard''' — Признак приема банковских карт* '''acceptfitting''' — Наличие примерки* '''latitude''' — Широта:* '''~~float~~longitude''' — ~~для числа с плавающей точкой~~Долгота* '''uid''' — Уникальный идентификатор ПВЗ в системе Measoft. Создается автоматически при получении данных о ПВЗ от агентов.* '''count''' — Количество записей в ответе:* '''~~int~~totalcount''' — ~~для целого числа~~Общее количество записей, отвечающее параметрам запроса

== ~~Расчет стоимости доставки~~ Получение фискальных данных заказа =='''Пример запроса ~~стоимости доставки~~получения фискальных данных:'''

<?xml version="1.0" encoding="UTF-8" ?><~~calculator~~receiptdata> <auth extra="8" login="login" pass="pass" /> <~~order~~orders> <~~pricetype~~order orderno="123456" />~~CUSTOMER~~ <order orderno="890111C" /~~pricetype~~> <~~sender~~/orders> <~~town~~/receiptdata>~~Санкт-Петербург~~ </~~town~~source> '''Пример ответа получения фискальных данных:'''<~~address>Петровка 38 офис 35</address~~source lang="xml"> <~~coords lat~~?xml version="551.~~680327~~0" ~~lon~~encoding="~~37.604456~~UTF-8"?><receipts count="1"> <receipt> <orderno>123456</~~coords~~orderno> <fdDatetime>2020-06-07 12:14:00</~~sender~~fdDatetime> <fdValue>123<~~receiver~~/fdValue> <~~zipcode~~fdNum>~~125480~~456</~~zipcode~~fdNum> <~~town regioncode="78" country="RU"~~fnSn>~~Санкт-Петербург~~789</~~town~~fnSn> <~~address~~kktNum>~~Петровка 38 офис 35~~100</~~address~~kktNum> <~~pvz~~inn>~~124~~222</~~pvz~~inn> <~~coords lat="55~~ofdUrl>gate.~~680327" lon="37~~ofd.~~604456">~~ru</~~coords~~ofdUrl> <fullUrl>https://check.ofd.ru/123</~~receiver~~fullUrl> <~~weight~~price>~~5.1~~12345</~~weight~~price> <~~service~~payType>2</~~service~~payType> <~~paytype~~lines count="1">~~CASH~~ <~~/paytype~~line> <~~price~~item>~~387.5~~1111764</~~price~~item> <~~deliveryprice~~name>~~150~~Сапоги</~~deliveryprice~~name> <~~inshprice~~extcode>~~387.5~~27113415</~~inshprice~~extcode> <qty>1<~~packages~~/qty> <~~package mass="1" quantity="5"~~price>1000</~~package~~price> <~~package mass="2.5" length="10" width="~~vatRate>20~~" height="30">~~</~~package~~vatRate> <governmentCode>Z16513LK2</~~packages~~governmentCode> <~~userid~~itemType>~~user123~~1</~~userid~~itemType> <~~groupid~~/line>~~customer~~ </~~groupid~~lines> </~~order~~receipt></~~calculator~~receipts>

</source>

Параметры ответа:

* '''orderno''' — Номер заказа

* '''fdDatetime''' — Дата и время пробития фискального чека

* '''fdValue''' — ФПД (фискальный признак документа)

* '''fdNum''' — ФИСКАЛЬНЫЙ ДОКУМЕНТ (фискальный номер чека)

* '''fnSn''' — ФН (номер фискального накопителя)

* '''kktNum''' — РН (регистрационный номер кассы)

* '''inn''' — ИНН

* '''ofdUrl''' — URL адрес (доменное имя) ОФД

* '''price''' — Сумма чека

* '''paytype''' — Тип оплаты чека. Принимает значения:

:* CASH — Наличными (по-умолчанию)

:* CARD — Безналичным способом

* '''fullUrl''' — URL чека для просмотра онлайн

* '''lines''' — Позиции чека

:* '''item''' — код товара

:* '''name''' — наименование товара

:* '''extcode''' — код товара во внешних системах

:* '''qty''' — количество товара

:* '''price''' — цена товара

:* '''governmentCode''' — считанная последовательность, которая в дальнейшем преобразуется по алгоритму тега 1162

:* '''vatRate''' — НДС товара

:* '''itemType''' — тип товара (товар, доставка и т. д.)

~~Параметры~~== Справочник Виды срочности =='''Пример запроса видов срочности:'''~~Структура данных и заполнение полей аналогичны и совместимы с [[#Оформление заказа]]~~<source lang="xml"><?xml version="1.0" encoding="UTF-8" ?><services><auth extra="8"/></services></source>

~~Дополнительные поля:~~* '''~~pricetype~~Пример ответа справочника видов срочности:''' ~~— тип требуемой цены~~<source lang="xml"><?xml version="1. ~~Возможные значения: «CUSTOMER» (по~~0" encoding="UTF-умолчанию) — [[Личный кабинет клиента#Цена доставки для получателя|цена для конечного получателя]], «CLIENT» — цена курьерской службы для клиента.8" ?><services count="2"> <service> <code>1</code> <name>Эконом</name> </service> <service> <code>2</code> <name>Срочно</name> </service>* '''userid''' — Идентификатор пользователя, строковый или числовой тип. Виртуальное поле. Необязательное. Данное поле используется совместно с настройками «Цена доставки для получателя», определяя приоритет правила. Можно использовать в различных CMS</~~CRM системах, настраивая цены для определенного покупателя.~~services>* '''groupid''' — Идентификатор группы пользователя, строковый или числовой тип. Виртуальное поле. Необязательное. Данное поле используется совместно с настройками «Цена доставки для получателя», определяя приоритет правила. Можно использовать в различных CMS</~~CRM системах, настраивая цены для определенной группы покупателей.~~source>

Суммы НП и ОЦ, а также тип оплаты CARD имеют значение при настроенных в тарифе на вкладке Прочее долях (в процентах) от данных сумм== Справочник дополнительных услуг =='''Пример запроса дополнительных услуг:'''<source lang="xml"><?xml version="1.0" encoding="UTF-8"?><advprices> <auth extra="8" login="login" pass="pass" /></advprices></source>

В авторизации можно опустить параметры login и pass, тогда расчет будет производиться по стандартному тарифу курьерской службы, без учета возможных отличий для конкретного клиента'''advprices''' — Корневой контейнер.~~<br>Объемный вес будет учитываться только при условии указания всех габаритов: длины, ширины и высоты.<br>~~В полях город-отправитель и город-получатель можно указывать название города (не рекомендуется!), либо код города из нашего справочника, либо 13-ти значный код КЛАДР, либо 36-ти значный код адресной системы ФИАС (AOID)Обязательный элемент.

'''Пример ответа ~~стоимости доставки~~справочника дополнительных услуг:'''

<?xml version="1.0" encoding="UTF-8"?><~~calculator~~advprices> <~~calc~~advprice> <~~townfrom~~ code=">1~~">Москва город~~</~~townfrom~~code> <~~townto code="56603"~~name>~~Иркутск город~~Этажей в доме</~~townto~~name> <~~mass~~type>~~3.7~~int</~~mass~~type> ~~<service name="Экспресс">1~~ </~~service~~advprice> <~~zone>2</zone~~advprice> <~~price~~code>~~1113~~2</~~price~~code> <~~mindeliverydays~~name>1Коэффициент надбавки</~~mindeliverydays~~name> <~~maxdeliverydays~~type>3float</~~maxdeliverydays~~type> ~~<mindeliverydate>2020-05-13~~ </~~mindeliverydate~~advprice> <~~intervals~~advprice> <~~workdays~~code> ~~<interval>10:00-16:00~~3</~~interval~~code> <~~interval~~name>~~16:00-22:00~~Расписаться на упаковке</~~interval~~name> <~~/workdays~~type> bool<~~holidays~~/type> ~~<interval>12:00-16:00~~ </~~interval~~advprice> </~~holidays~~advprices> </~~intervals~~source> ~~<deliveryprice>~~ ~~<advprice code="1" price="1000">База</advprice>~~Параметры: ~~<advprice~~ * '''code~~="4" price="100">Процент от суммы руб</advprice>~~''' — внутренний код услуги ~~<advprice code="5" price="63">Процент от объявленной стоимости</advprice>~~* '''name''' — наименование услуги. Если поле «название в ЛК» в настройках услуги не пусто, то возвращает значение поля «название в ЛК». ~~<advprice code="6" price="-50">Скидка при доставке</advprice>~~* '''hine''' — подсказка по доп услуге для пользователя ~~</deliveryprice>~~* '''type''' — тип услуги. Может иметь значения: ~~</calc>~~:* '''bool''' — для услуг вида «чекбокс», «Да»~~</calculator>~~:* '''float''' — для числа с плавающей точкой~~</source>~~:* '''int''' — для целого числа

~~Параметры:~~* '''townfrom''' — Город-отправитель так, как система его распознала и привязала к справочнику. Атрибут '''code''' — код из справочника городов системы.* '''townto''' — Город-получатель так, как система его распознала и привязала к справочнику. Атрибут '''code''' — код из справочника городов системы.* '''mass''' — Масса в килограммах* '''service''' — Режим доставки — число, указывающее на запись в справочнике видов срочности (см описание на этой странице).* '''zone''' — номер тарифной зоны, по которой рассчиталась стоимость. В зависимости от зоны выбирается тарифная сетка. Так же к цене могут применяться повышающие или понижающие коэффициенты при доставке не из/в региональный центр.* '''price''' — рассчитанная стоимость доставки в валюте прайс-листа курьерской службы. Рекомендуется к использованию в отличие от одноименного атрибута родительского контейнера.* '''maxdeliverydays''' — максимальный срок доставки в рабочих днях.* '''mindeliverydate''' — минимальная дата доставки в учетом выходных дней.* '''intervals''' — список интервалов доставки для соответствующей зоны и режима срочности.* '''deliveryprice''' — Данные по составляющим ценам доставки '''''Обратите внимание:''''' В реальном ответе сервера в теге calc присутствует атрибут «price». Он оставлен для обратной совместимости, не используйте его. Пользуйтесь вложенным тегом price. == ~~Получение информации о клиенте~~ Расчет стоимости доставки =='''Пример запроса ~~получения информации о клиенте~~стоимости доставки:'''

<?xml version="1.0" encoding="UTF-8" ?>

<~~client~~calculator> <auth extra="8" login="login" pass="pass" /> <order> <pricetype>CUSTOMER</pricetype> <sender> <town>Санкт-Петербург</town> <address>Петровка 38 офис 35</address> <coords lat="55.680327" lon="37.604456"></coords> </sender> <receiver> <zipcode>125480</zipcode> <town regioncode="78" country="RU">Санкт-Петербург</town> <address>Петровка 38 офис 35</address> <pvz>124</pvz> <coords lat="55.680327" lon="37.604456"></coords> </receiver> <weight>5.1</weight> <service>2</service> <paytype>CASH</paytype> <price>387.5</price> <deliveryprice>150</deliveryprice> <inshprice>387.5</inshprice> <packages> <package mass="1" quantity="5"></package> <package mass="2.5" length="10" width="20" height="30"></package> </packages> <userid>user123</userid> <groupid>customer</groupid> </order> </~~client~~calculator>

</source>

~~'''client''' — Корневой контейнер. Обязательный элемент.~~

* '''auth''' — Авторизация. Обязательный элемент.

Параметры:Структура данных и заполнение полей аналогичны и совместимы с [[#Оформление заказа]]. Дополнительные поля:* '''~~Пример ответа на запрос получения информации о клиенте:~~pricetype'''~~<source lang="xml"><?xml version="1~~ — тип требуемой цены.~~0" encoding="UTF~~Возможные значения: «CUSTOMER» (по-~~8" ?>~~умолчанию) — [[Личный кабинет клиента#Цена доставки для получателя|цена для конечного получателя]], «CLIENT» — цена курьерской службы для клиента.~~<client>~~ ~~<code>1082<~~* '''userid''' — Идентификатор пользователя, строковый или числовой тип. Виртуальное поле. Необязательное. Данное поле используется совместно с настройками «Цена доставки для получателя», определяя приоритет правила. Можно использовать в различных CMS/~~code>~~CRM системах, настраивая цены для определенного покупателя.<* '''groupid''' — Идентификатор группы пользователя, строковый или числовой тип. Виртуальное поле. Необязательное. Данное поле используется совместно с настройками «Цена доставки для получателя», определяя приоритет правила. Можно использовать в различных CMS/~~client></source>~~CRM системах, настраивая цены для определенной группы покупателей.

* '''code''' — Код клиентаСуммы НП и ОЦ, а также тип оплаты CARD имеют значение при настроенных в тарифе на вкладке Прочее долях (в процентах) от данных сумм.

~~== Список актов передачи денег =='''Пример запроса списка актов передачи денег:'''~~В авторизации можно опустить параметры login и pass, тогда расчет будет производиться по стандартному тарифу курьерской службы, без учета возможных отличий для конкретного клиента.<~~source lang="xml"~~br>~~<?xml version="1~~Объемный вес будет учитываться только при условии указания всех габаритов: длины, ширины и высоты.~~0" encoding="UTF-8" ?><smalist>~~ <~~auth extra="8" login="login" pass="pass" /~~br> ~~<datefrom>2016~~В полях город-02отправитель и город-~~10</datefrom>~~ ~~<dateto>2016~~получатель можно указывать название города (не рекомендуется!), либо код города из нашего справочника, либо 13-03ти значный код КЛАДР, либо 36-~~10</dateto></smalist></source>~~ти значный код адресной системы ФИАС (AOID).

~~'''smalist''' — Корневой контейнер. Обязательный элемент.~~

* '''auth''' — Авторизация. Обязательный элемент.

* '''datefrom''' — Дата «с». Необязательный элемент.

* '''dateto''' — Дата «по». Необязательный элемент.

~~Если интервал дат не указан, то возвращаются акты передачи денег за последний месяц.~~

'''Пример ответа ~~на запрос списка актов передачи денег~~стоимости доставки:'''

<?xml version="1.0" encoding="UTF-8"?>

<~~smalist count~~calculator> <calc> <townfrom code="1"> Москва город<~~sma~~/townfrom> <townto code="56603">~~6278~~Иркутск город</~~code~~townto> <~~number~~mass>~~3992~~3.7</~~number~~mass> <~~actdate~~service name="Экспресс">~~2016-02-12~~1</~~actdate~~service> <~~datepay~~zone>2</~~datepay~~zone> <~~dateto~~price>~~2016-02-12~~1113</~~dateto~~price> <~~promiseddatepay~~mindeliverydays>1</~~promiseddatepay~~mindeliverydays> <~~price~~maxdeliverydays>~~637.00~~3</~~price~~maxdeliverydays> <~~pricecorr~~mindeliverydate>~~113.00~~2020-05-13</~~pricecorr~~mindeliverydate> <~~rur~~intervals> <workdays>~~13430.~~ <interval>10:00-16:00</~~rur~~interval> <~~pricekur~~interval>~~570.~~16:00-22:00</~~pricekur~~interval> </workdays> <holidays> <~~priceag~~interval>~~67.~~12:00-16:00</~~priceag~~interval> <~~payno~~/holidays>~~42423~~ </~~payno~~intervals> <~~paytype~~deliveryprice> <advprice code="1" price="1000">База</advprice> <advprice code="4" price="100">Процент от суммы руб</~~paytype~~advprice> <~~paytypename~~advprice code="5" price="63">~~Безнал~~Процент от объявленной стоимости</~~paytypename~~advprice> <advprice code="6" price="-50">Скидка при доставке<~~signedcopyreceived~~/advprice>NO </~~signedcopyreceived~~deliveryprice> </~~sma~~calc></~~smalist~~calculator>

</source>

Параметры:* '''~~code~~townfrom''' — ~~Код акта~~* Город-отправитель так, как система его распознала и привязала к справочнику. Атрибут '''~~number~~code''' — ~~Номер акта в системе~~код из справочника городов системы.* '''~~actdate~~townto''' — ~~Дата акта~~* Город-получатель так, как система его распознала и привязала к справочнику. Атрибут '''~~datepay~~code''' — ~~Дата оплаты по акту~~код из справочника городов системы.* '''~~dateto~~mass''' — ~~Дата конечного периода для формирования АПД~~Масса в килограммах* '''~~promiseddatepay~~service''' — ~~Плановая дата оплаты~~Режим доставки — число, указывающее на запись в справочнике видов срочности (см описание на этой странице).* '''~~price~~zone''' — ~~Стоимость услуг~~номер тарифной зоны, по которой рассчиталась стоимость. В зависимости от зоны выбирается тарифная сетка. Так же к цене могут применяться повышающие или понижающие коэффициенты при доставке не из/в региональный центр.* '''~~pricecorr~~price''' — ~~Сумма корректировки~~рассчитанная стоимость доставки в валюте прайс-листа курьерской службы. Рекомендуется к использованию в отличие от одноименного атрибута родительского контейнера.* '''~~rur~~maxdeliverydays''' — ~~Сумма заказа~~максимальный срок доставки в рабочих днях.* '''~~pricekur~~mindeliverydate''' — ~~Стоимость курьерской~~ минимальная дата доставкив учетом выходных дней.* '''~~priceag~~intervals''' — ~~Агентское вознаграждение~~список интервалов доставки для соответствующей зоны и режима срочности.* '''~~payno~~deliveryprice''' — ~~Номер платежного поручения~~Данные по составляющим ценам доставки * '''~~paytype~~''Обратите внимание:''''' ~~— Тип оплаты~~В реальном ответе сервера в теге calc присутствует атрибут «price». Он оставлен для обратной совместимости, не используйте его. Пользуйтесь вложенным тегом price. === Коды и описание ошибок ==={|class=wikitable!Код ошибки!Английское описание!Русское описание!Примечание|-|15||tarif not found||Тариф не найден||Ошибка получения тарифов: ~~1 — безнал~~для клиента не указан тариф|-|19||field [town to] cannot be empty||Поле [город получателя] не может быть пустым||Необходимо указать город получателя или ПВЗ|-|20||field [weight] is incorrect||Некорректное значение [масса]||Значение массы некорректное, например, ~~2 — наличными курьером~~не является числом. Его необходимо исправить|-|21||town from not found||Город отправителя не найден||Системе не удалось найти указанный населенный пункт отправителя|-|22||town to not found||Город получателя не найден||Системе не удалось найти указанный населенный пункт отправителя|-|23||field [weight] cannot be empty||Поле [масса] не может быть пустым||Необходимо указать значение массы отправления, ~~3 — наличными~~ поле [weight]|-|36||subtown not found||Город в регионе не найден||Не настроено направление доставки до города в регионе: не добавлен регион или указанный город отсутствует в ~~офисе~~списке региона|-|37||zoneprice not found||Тариф зоны не найден||Отсутствуют зоны тарификации или для них не указаны стоимости|-|38||tarif not found - 1||Тариф не найден 1||Результаты расчета отсутствуют: общая ошибка в случае, ~~4 — перевод на карту~~если других ошибок нет, но результат пустой |-|39||tarif not found - 2||Тариф не найден 2||Ошибка получения тарифов: для клиента не настроен тариф или тарификация от количества заказов|-|82||field [weight] exceeded limit PVZ||Значение [weight] превышает ограничение ПВЗ||Указанное значение массы больше, чем максимально допустимое для указанного ПВЗ|-* '''paytypename''' — Строковое представление типа |83||attribute [paytype] not allowed PVZ||Значение [paytype] не допустимо для ПВЗ||В ПВЗ не допустим указанный тип оплаты* '''signedcopyreceived''' — Признак факта возврата акта YES/NO|-|}

== ~~Детализация актов передачи денег~~ Получение информации о клиенте =='''Пример запроса ~~детализации актов передачи денег~~получения информации о клиенте:'''

<?xml version="1.0" encoding="UTF-8" ?>

<~~smadetail~~client> <auth extra="8" login="login" pass="pass" /> ~~<code>6278</code~~></~~smadetail~~client>

</source>

'''~~smadetail~~client''' — Корневой контейнер. Обязательный элемент.

* '''auth''' — Авторизация. Обязательный элемент.

* '''code''' — Код акта передачи денег (см. запрос списка АПД). Обязательный элемент.

'''Пример ответа на запрос ~~детализации актов передачи денег~~получения информации о клиенте:'''

<?xml version="1.0" encoding="UTF-8"?><~~smadetail count="2"~~client> ~~<specialsma>~~ <code>~~42494~~1082</code> ~~<ordercode>14424</ordercode>~~ ~~<orderno>11111</orderno>~~ ~~<orderdate>2018-01-01</orderdate>~~ ~~<delivereddate>2018-10-01</delivereddate>~~ ~~<company>Компания</company>~~ ~~<price>314.00</price>~~ ~~<rur>8800.00</rur>~~ ~~<inshprice>314.00</inshprice>~~ ~~<pricekur>270.00</pricekur>~~ ~~<priceag>44.00</priceag>~~ ~~<pricecalc>8486.00</pricecalc>~~ ~~<paytype>2</paytype>~~ ~~<paytypename>наличными курьером</paytypename>~~ ~~<weight>0.400</weight>~~ ~~<distance>0.0</distance>~~ ~~<status>Доставлено</status>~~ ~~</specialsma~~></~~smadetail~~client>

</source>

* '''code''' — Код ~~записи.~~* '''ordercode''' — Код заказа.* '''orderno''' — Шифр заказа.* '''orderdate''' — Дата заказа.* '''delivereddate''' — Дата доставки.* '''company''' — Получатель.* '''price''' — Стоимость услуг.* '''rur''' — Сумма заказа.* '''inshprice''' — Стоимость заказа.* '''pricekur''' — Стоимость курьерской доставки.* '''priceag''' — Агентское вознаграждение.* '''pricecalc''' — Сумма для передачи агенту.* '''paytype''' — Тип оплаты: 1 — безнал, 2 — наличными курьером, 3 — наличными в офисе, 4 — перевод на карту.* '''paytypename''' — Строковое представление типа оплаты* '''weight''' — Вес заказа.* '''distance''' — Дистанция по заказу* '''status''' — Статус заказа.клиента == ~~Генерация коротких ссылок~~ Список актов передачи денег ==В некоторых случаях, например, при использовании в СМС, может потребоваться использование коротких ссылок на ЛК.~~Для этого, необходимо отправить запрос с полной ссылкой, в ответ на который придёт хэш-код для ссылки.~~ '''Пример запроса ~~генерации коротких ссылок~~списка актов передачи денег:'''

<?xml version="1.0" encoding="UTF-8" ?>

<~~shortlink~~smalist> <~~link short~~auth extra="08" login="login" pass="pass"/> <datefrom> ~~https:~~2016-02-10</~~/home.courierexe.ru/8/site/orders~~ datefrom> <dateto>2016-03-10</~~link~~dateto></~~shortlink~~smalist>

</source>

'''smalist''' — Корневой контейнер. Обязательный элемент.* '''auth''' — Авторизация. Обязательный элемент.* '''datefrom''' — Дата «с». Необязательный элемент.* '''dateto''' — Дата «по». Необязательный элемент.Если интервал дат не указан, то возвращаются акты передачи денег за последний месяц. '''Пример ответа на запрос списка актов передачи денег:'''<source lang="xml"><?xml version="1.0" encoding="UTF-8"?><smalist count="1"> <sma> <code>6278</code> <number>3992</number> <actdate>2016-02-12</actdate> <datepay></datepay> <dateto>2016-02-12</dateto> <promiseddatepay></promiseddatepay> <price>637.00</price> <pricecorr>113.00</pricecorr> <rur>13430.00</rur> <pricekur>570.00</pricekur> <priceag>67.00</priceag> <payno>42423</payno> <paytype>1</paytype> <paytypename>Безнал</paytypename> <signedcopyreceived>NO</signedcopyreceived> </sma></smalist></source> * '''code''' — Код акта* '''number''' — Номер акта в системе* '''actdate''' — Дата акта* '''datepay''' — Дата оплаты по акту* '''dateto''' — Дата конечного периода для формирования АПД* '''promiseddatepay''' — Плановая дата оплаты* '''price''' — Стоимость услуг* '''pricecorr''' — Сумма корректировки* '''rur''' — Сумма заказа* '''pricekur''' — Стоимость курьерской доставки* '''priceag''' — Агентское вознаграждение* '''payno''' — Номер платежного поручения* '''paytype''' — Тип оплаты: 1 — безнал, 2 — наличными курьером, 3 — наличными в офисе, 4 — перевод на карту* '''paytypename''' — Строковое представление типа оплаты* '''signedcopyreceived''' — Признак факта возврата акта YES/NO == Детализация актов передачи денег =='''Пример запроса детализации актов передачи денег:'''<source lang="xml"><?xml version="1.0" encoding="UTF-8" ?><smadetail> <auth extra="8" login="login" pass="pass" /> <code>6278</code></smadetail></source> '''smadetail''' — Корневой контейнер. Обязательный элемент.* '''auth''' — Авторизация. Обязательный элемент.* '''code''' — Код акта передачи денег (см. запрос списка АПД). Обязательный элемент. '''Пример ответа на запрос детализации актов передачи денег:'''<source lang="xml"><?xml version="1.0" encoding="UTF-8"?><smadetail count="2"> <specialsma> <code>42494</code> <ordercode>14424</ordercode> <orderno>11111</orderno> <orderdate>2018-01-01</orderdate> <delivereddate>2018-10-01</delivereddate> <company>Компания</company> <price>314.00</price> <rur>8800.00</rur> <inshprice>314.00</inshprice> <pricekur>270.00</pricekur> <priceag>44.00</priceag> <pricecalc>8486.00</pricecalc> <paytype>2</paytype> <paytypename>наличными курьером</paytypename> <weight>0.400</weight> <distance>0.0</distance> <status>Доставлено</status> </specialsma></smadetail></source> * '''code''' — Код записи.* '''ordercode''' — Код заказа.* '''orderno''' — Шифр заказа.* '''orderdate''' — Дата заказа.* '''delivereddate''' — Дата доставки.* '''company''' — Получатель.* '''price''' — Стоимость услуг.* '''rur''' — Сумма заказа.* '''inshprice''' — Стоимость заказа.* '''pricekur''' — Стоимость курьерской доставки.* '''priceag''' — Агентское вознаграждение.* '''pricecalc''' — Сумма для передачи агенту.* '''paytype''' — Тип оплаты: 1 — безнал, 2 — наличными курьером, 3 — наличными в офисе, 4 — перевод на карту.* '''paytypename''' — Строковое представление типа оплаты* '''weight''' — Вес заказа.* '''distance''' — Дистанция по заказу* '''status''' — Статус заказа. == Установка статуса согласования заказа ==Для возможности клиентом установки статуса согласования заказа необходимо включить переменную [[Личный кабинет курьерской службы#Заказы|Разрешить менять статус согласования]] '''Пример запроса установки статуса согласования заказа'''<source lang="xml"><?xml version="1.0" encoding="UTF-8"?><setapprovalstatus> <auth extra="8" login="login" pass="pass" /> <order ordercode="1234561"> <confirmstate>1</confirmstate> <message>Сообщение статуса</message> </order> <order ordercode="1234562"> <confirmstate>2</confirmstate> <message>Согласовано</message> </order> <order ordercode="1234563"> <confirmstate>3</confirmstate> <message>Не согласовано</message> </order></setapprovalstatus></source> * '''order''' — Контейнер заказа. Обязателен как минимум один элемент.:* '''ordercode''' — Внутренний код заказа.* '''confirmstate''' — Код статуса заказа. Все статусы с кодами можно получить запросом [[#Получение списка статусов согласования заказа|Получение списка статусов согласования заказа]]* '''message''' — Дополнительный комментарий, который отобразится в поле ''Инфо о доставке''. == Получение списка статусов согласования заказа =='''Пример запроса списка статусов согласования заказа'''<source lang="xml"><?xml version="1.0" encoding="UTF-8"?><approvalstatuses> <auth extra="8" login="login" pass="pass" /></approvalstatuses></source> '''Пример ответа списка статусов согласования заказа'''<source lang="xml"><?xml version="1.0" encoding="UTF-8" ?><approvalstatuses count="6"> <status> <code>1</code> <name>Неизвестно</name> </status> <status> <code>2</code> <name>Согласование запрошено</name> </status> <status> <code>3</code> <name>Доставка полностью согласована</name> </status> <status> <code>4</code> <name>Согласовано с изменением времени</name> </status> <status> <code>5</code> <name>Перенос на другую дату</name> </status> <status> <code>6</code> <name>Отказ</name> </status></approvalstatuses></source> == Генерация коротких ссылок ==В некоторых случаях, например, при использовании в СМС, может потребоваться использование коротких ссылок на ЛК.Для этого, необходимо отправить запрос с полной ссылкой, в ответ на который придёт хэш-код для ссылки. '''Пример запроса генерации коротких ссылок:'''<source lang="xml"><?xml version="1.0" encoding="UTF-8" ?><shortlink> <link short="0"> https://home.courierexe.ru/8/site/orders </link></shortlink></source> '''shortlink''' — Корневой контейнер. Обязательный элемент.* '''link''' — Полная ссылка, для которой необходимо получить код. Обязательный элемент. Если атрибут '''short''' равен 1, то ответ не будет содержать XML, а только хэш-код.

'''Пример ответа на запрос генерации коротких ссылок:'''

<?xml version="1.0" encoding="UTF-8"?>

<shortlink> <hash>35AF350C</hash></shortlink></source> * '''hash''' — Хэш-код ссылки. Далее, можно использовать ссылку на ЛК: <nowiki>https://home.courierexe.ru/35AF350C или curie.ru/35AF350C</nowiki> '''Примечание!''' Сервис коротких ссылок работает только для ресурсов компании MeaSoft. == Проверка надежности покупателя ==Проверка надежности работает только для тарифа «Максимум» личного кабинета. <source lang="xml"><?xml version="1.0" encoding="UTF-8" ?><mcheck> <auth extra="8" login="login" pass="pass" /> <phones> <phone>89161147992</phone> </phones></mcheck></source> Ответ: <source lang="xml"><?xml version="1.0" encoding="UTF-8" ?><mcheck> <phones> <phone rate="90">89161147992</phone> </phones></mcheck></source> == Размещение страниц на своем сайте (iframe) == В некоторых случаях имеет смысл разметить те или иные страницы на своем сайте. Например, чтобы клиенты могли рассчитать стоимость доставки не переходя по внешней ссылке, а там же, на сайте, калькулятор можно разместить прямо на странице такого сайта посредством так называемого фрейма — '''iframe'''. [https://ya.ru/search/?text=iframe Фрейм] — контейнер внутри обычной страницы, который позволяет загружать сторонние страницы. Пример загрузки калькулятора: <source lang="html"><iframe id="frame" src="https://home.courierexe.ru/8/calculator"> Здесь должен отобразиться калькулятор</iframe></source> Для удобства пользователей вашего сайта можно указать язык интерфейса (который переключается непосредственно на сайте) параметром '''lang''': <source lang="html"><iframe id="frame" src="https://home.courierexe.ru/8/calculator?lang=2"> Здесь должен отобразиться калькулятор</iframe></source> <div style="color: #a94442; background-color: #f2dede; border: 1px solid #ebccd1; padding: 3px 10px 10px;">'''Обратите внимание!'''# При использовании iFrame могут не работать некоторые функции, например, подписка на push-уведомления на странице трекинга или отслеживания.# Если язык не указать, то на страницах калькулятора и трекинга отображается свой переключатель языка. Если язык указан, то переключатель не отображается. Поддерживаемые языки и их коды::'''1''' — русский:'''2''' — английский:'''4''' — узбекский</div> == Оформление манифеста == '''Пример запроса на создание манифеста:'''<source lang="xml"><?xml version="1.0" encoding="UTF-8" ?><manifest> <auth extra="8" login="login" pass="pass" /> <store_from>1</store_from> <store_to>2</store_to> <trn_code>3</trn_code> <sentdate>2024-11-07</sentdate> <places> <place> <number>1</number> <seal>7890AABBB</seal> </place> <place> <number>2</number> <seal>123456ABC</seal> </place> </places> <addresses> <address> <code>12345</code> <place>1</place> </address> <address> <code>67890</code> <place>2</place> </address> </addresses></manifest></source> '''manifest''' - Корневой контейнер. Обязательный элемент.*'''auth''' - Авторизация. Обязательный элемент.*'''store_from''' - код филиала отправителя. Обязательный элемент.*'''store_to''' - код филиала получателя. Обязательный элемент.*'''trn_code''' - код перевозчика. Обязательный элемент.*'''sentdate''' - дата отправки манифеста. Не обязательный элемент.*'''addresses''' - корневой элемент для списка заказов.*:'''address''' - корневой элемент для заказа.*::'''code''' - наш внутренний номер заказа. Обязательный элемент.*::'''place''' - номер места заказа. Обязательный элемент, если переданы места.*'''places''' - корневой элемент для списка мест.*::'''place''' - корневой элемент для места.*::'''number''' - номер места. Обязательный элемент.*::'''seal''' - номер пломбы. Необязательный элемент. '''Пример успешного ответа'''<source lang="xml"><?xml version="1.0" encoding="UTF-8"?><manifest> <result>OK</result></manifest></source> '''Пример ответа с ошибкой'''<source lang="xml"><?xml version="1.0" encoding="UTF-8"?><manifest> <result error="Текст ошибки">ERROR</result></manifest>

</source>

* '''~~hash~~manifest''' ~~— Хэш~~-~~код ссылки~~Корневой контейнер. Обязательный элемент. ~~Далее, можно использовать ссылку на ЛК:~~ ~~<nowiki>https://home.courierexe~~*'''result ''' - Результат.~~ru/35AF350C~~ Принимает значения OK или ~~curie~~ERROR.~~ru/35AF350C</nowiki>~~ *'''~~Примечание!~~error''' ~~Сервис коротких ссылок работает только для ресурсов компании MeaSoft.~~ ~~== Проверка надежности покупателя ==Проверка надежности работает только для тарифа «Максимум» личного кабинета.~~ ~~<source lang="xml"><?xml version="1.0" encoding="UTF~~-~~8" ?><mcheck>~~ ~~<auth extra="8" login="login" pass="pass" />~~ ~~<phones>~~ ~~<phone>89161147992</phone>~~ ~~</phones></mcheck></source>~~ ~~Ответ:~~ ~~<source lang="xml"><?xml version="1~~атрибут с текстом ошибки, если она была.~~0" encoding="UTF-8" ?><mcheck>~~ ~~<phones>~~ ~~<phone rate="90">89161147992</phone>~~ ~~</phones></mcheck></source>~~

Radmir

Бюрократы, Администраторы

849

правок

Изменения

API

Навигация

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

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

Варианты

Просмотры

Ещё

Поиск

Навигация

Инструменты