Изменения

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

API

4015 байт добавлено, 08:41, 9 июля 2020
Справочник дополнительных услуг
<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>
:* '''''below_sum''''' - граница стоимости выкупаемого заказа
:* '''''price''''' - стоимость выкупаемого заказа до соответствующей границы
 
* '''advprices''' - Контейнер для описания дополнительных услуг. Необязательный
:* '''''code''''' - код услуги
:* '''''value''''' - значение услуги. Если тип услуги bool, то в значении передаем true
 
*'''costcode''' - Кост-код сотрудника.
<?xml version="1.0" encoding="UTF-8"?>
<tracking>
<order orderno="1234111111"> <barcode>111111</barcode> <AWB>111111</AWB> <sender> <town code="1" country="RU">Москва город</town> <date>2014-03-22</date> <time_min>09:00</time_min> <time_max>14:00</time_max> </sender> <receiver> <town code="1" country="RU">Москва город</town> <zipcode>125480</zipcode> <date>20152014-0403-1822</date> <time_min>09:00</time_min> <time_max>14:00</time_max> </receiver> <AWBprice>387.5</price> <inshprice>387.5</inshprice> <paytype>BarCodeCASH</AWBpaytype> <weight>05.1</weight> <quantity>12</quantity> <service>2</service> <type>3</type> <return>NO</return> <return_service>2</service> <return_date></return_date> <return_time></return_time> <return_message></return_message> <waittime>12</waittime> <enclosure>Детские игрушки</enclosure> <instruction>Проверить при покупателе, подписать акт</instruction> <deliveryprice total="158.6" delivery="100.00" return="58.6" /> <courier> <code>26</code> <name>Иванов Владимир Петрович</name> <phone>+79161234567</phone> </courier> <currcoords lat="55.680327" lon="37.604456" accuracy="50" RequestDateTime="2014-04-21 18:07:45" /> <status eventstore="филиал в Санкт-Петербурге" eventtime="2016-06-02 17:22:00" createtimegmt="2016-06-03 16:14:44" message="" title="Доставлен" country="RU">COMPLETE</status> <statushistory> <status eventstore="Офис в Москве" eventtime="2016-05-30 10:20:00" createtimegmt="2016-06-03 16:14:44" message="" title="Новый" country="RU">NEW</status> <status eventstore="Офис в Москве" eventtime="2016-06-01 17:38:00" createtimegmt="2016-06-03 16:14:44" message="филиал в Санкт-Петербурге" title="Планируется отправка" country="RU">DEPARTURING</status> <status eventstore="Офис в Москве" eventtime="2016-06-01 19:53:00" createtimegmt="2016-06-03 16:14:44" message="филиал в Санкт-Петербурге" title="Отправлено со склада" country="RU">DEPARTURE</status> <status eventstore="филиал в Санкт-Петербурге" eventtime="2016-06-02 07:41:00" createtimegmt="2016-06-03 16:14:44" message="" title="Получен складом" country="RU">ACCEPTED</status> <status eventstore="филиал в Санкт-Петербурге" eventtime="2016-06-02 09:17:00" createtimegmt="2016-06-03 16:14:44" message="" title="Выдан курьеру на доставку" country="RU">DELIVERY</status> <status eventstore="филиал в Санкт-Петербурге" eventtime="2016-06-02 17:22:00" createtimegmt="2016-06-03 16:14:44" message="" title="Доставлен (предварительно)" country="RU">COURIERDELIVERED</status> <status eventstore="филиал в Санкт-Петербурге" eventtime="2016-06-02 17:22:00" createtimegmt="2016-06-03 16:14:44" message="" title="Доставлен" country>COMPLETE</status> </statushistory> <deliveredto>Иванова, секр.</deliveredto> <delivereddate>2016-06-02</delivereddate> <deliveredtime>17:22</deliveredtime> <outstrbarcode>EXT123456</outstrbarcode> <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" 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="">Обруч</item> <item code="34421" extcode="abc125" quantity="3" mass="0.3" retprice="50" VATrate="18" barcode="2345625213126" article="3" returns="0" governmentCode="RU">COMPLETEПогремушка желтая</statusitem> </statushistoryitems> </order></tracking></source>  '''Получение информации в формате 17 TRACK''' '''Пример запроса:'''<source lang="xml"><?xml version="1.0" encoding="UTF-8"?><tracking17> <extra>8</extra> <orderno>1234</orderno></tracking17></source> '''Пример ответа:'''<pre>{ "number":"ExtNumber", "oriNumber":"1234", "oriCountry":"RU", "destCountry":"RU", "status":"Complete", "events":[ { "time":"2016-06-02 17:22:00", "location":"RU", "content":"Complete" }, { "time":"2016-06-02 17:22:00", "location":"RU", "content":"Courierdelivered" }, { "time":"2016-06-02 09:17:00", "location":"RU", "content":"Delivery" }, { "time":"2016-06-02 07:41:00", "location":"RU", "content":"Accepted" }, { "time":"2016-06-01 19:53:00", "location":"RU", "content":"Departure"
},
{
Функция ищет последний заказ по номеру среди заказов всех клиентов. Выдает неперсонализированную информацию о текущем состоянии заказа.<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|Запроса статусов заказов]].
 
== Изменение заказа ==
# Данные запроса изменения указываются '''полностью''', как если бы заказ создавался впервые.
# При отсутствии вложения в запросе изменения данное вложение '''не удаляется''' из заказа, но его количество становится равным 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''' - для целого числа
== Расчет стоимости доставки ==
mass="3.7"
service="1"
rurprice="1200"
inshprice="1200"
paytype="CASH" />
*'''mass''' - Масса в килограммах
*'''service''' - Режим доставки - число, указывающее на запись в справочнике [[#Справочник Видов срочности|видов срочности]]. Если этот параметр опустить, система выдаст расчет для всех доступных видов срочности, передав много контейнеров <calc> в ответе.
*'''rurprice''' - Сумма наложенного платежа
*'''inshprice''' - Сумма объявленной ценности
*'''paytype''' - Тип оплаты

Навигация