API — различия между версиями
Johny (обсуждение | вклад) (Новая страница: «Тут скоро будет описание API!!!») |
Johny (обсуждение | вклад) |
||
| Строка 1: | Строка 1: | ||
| − | + | В системе "Курьерская служба 2008" имеется возможность интеграции средствами XML API, по протоколу HTTP POST. | |
| + | |||
| + | |||
| + | == Общие понятия == | ||
| + | |||
| + | На стороне курьерской службы имеется веб-сервис. Адрес уточняйте у представителей компании. Авторизационные данные так же уточняйте у представителей компании. | ||
| + | Клиент отправляет запросы к сервису, сервис обрабатывает запросы и возвращает результат выполнения. Все запросы и ответы передаются в формате XML. | ||
| + | Кодировка - UTF-8. Разделитель целой и дробной частей чисел - используется символ точки. Даты представляются в виде YYYY-MM-DD, время - HH:MM. | ||
| + | |||
| + | |||
| + | == Оформление заказа == | ||
| + | |||
| + | <source lang="xml"> | ||
| + | <?xml version="1.0" encoding="UTF-8"?> | ||
| + | <neworder> | ||
| + | <auth login="login" pass="pass"></auth> | ||
| + | <order orderno="111111"> | ||
| + | <date_putn>2014-03-22</date_putn> | ||
| + | <time_min>21:00</time_min> | ||
| + | <time_max>23:00</time_max> | ||
| + | <townfrom>Москва</townfrom> | ||
| + | <townto>Санкт-Петербург</townto> | ||
| + | <address>Петровка 38 офис 35</address> | ||
| + | <target>МВД</target> | ||
| + | <name>САМАРИТЯНИН</name> | ||
| + | <phone>123-45-67</phone> | ||
| + | <mass>5</mass> | ||
| + | <quantity>23</quantity> | ||
| + | <price>357</price> | ||
| + | <enclosure>тест1</enclosure> | ||
| + | <inshprice>1234</inshprice> | ||
| + | <instruction>тест</instruction> | ||
| + | <strbarcode>111111</strbarcode> | ||
| + | <items> | ||
| + | <item quantity="1" mass="1" retprice="1" barcode="1" article="1">тест1</item> | ||
| + | <item quantity="2" mass="2" retprice="2" barcode="2" article="2">тест2</item> | ||
| + | <item quantity="3" mass="3" retprice="3" barcode="3" article="3">тест3</item> | ||
| + | </items> | ||
| + | </order> | ||
| + | </neworder> | ||
| + | </source> | ||
| + | |||
| + | |||
| + | == Запрос статуса == | ||
| + | |||
| + | <source lang="xml"> | ||
| + | <?xml version="1.0" encoding="UTF-8" ?> | ||
| + | <statusreq> | ||
| + | <auth login="login" pass="pass"></auth> | ||
| + | <order orderno=""> | ||
| + | <datefrom>2014-04-03</datefrom> | ||
| + | <dateto>2014-04-03</dateto> | ||
| + | <done>ONLY_NOT_DONE</done> | ||
| + | </order> | ||
| + | </statusreq> | ||
| + | </source> | ||
Версия 11:22, 14 апреля 2014
В системе "Курьерская служба 2008" имеется возможность интеграции средствами XML API, по протоколу HTTP POST.
Общие понятия
На стороне курьерской службы имеется веб-сервис. Адрес уточняйте у представителей компании. Авторизационные данные так же уточняйте у представителей компании. Клиент отправляет запросы к сервису, сервис обрабатывает запросы и возвращает результат выполнения. Все запросы и ответы передаются в формате XML. Кодировка - UTF-8. Разделитель целой и дробной частей чисел - используется символ точки. Даты представляются в виде YYYY-MM-DD, время - HH:MM.
Оформление заказа
<?xml version="1.0" encoding="UTF-8"?>
<neworder>
<auth login="login" pass="pass"></auth>
<order orderno="111111">
<date_putn>2014-03-22</date_putn>
<time_min>21:00</time_min>
<time_max>23:00</time_max>
<townfrom>Москва</townfrom>
<townto>Санкт-Петербург</townto>
<address>Петровка 38 офис 35</address>
<target>МВД</target>
<name>САМАРИТЯНИН</name>
<phone>123-45-67</phone>
<mass>5</mass>
<quantity>23</quantity>
<price>357</price>
<enclosure>тест1</enclosure>
<inshprice>1234</inshprice>
<instruction>тест</instruction>
<strbarcode>111111</strbarcode>
<items>
<item quantity="1" mass="1" retprice="1" barcode="1" article="1">тест1</item>
<item quantity="2" mass="2" retprice="2" barcode="2" article="2">тест2</item>
<item quantity="3" mass="3" retprice="3" barcode="3" article="3">тест3</item>
</items>
</order>
</neworder>
Запрос статуса
<?xml version="1.0" encoding="UTF-8" ?>
<statusreq>
<auth login="login" pass="pass"></auth>
<order orderno="">
<datefrom>2014-04-03</datefrom>
<dateto>2014-04-03</dateto>
<done>ONLY_NOT_DONE</done>
</order>
</statusreq>