API — различия между версиями

Материал из Меасофт
Перейти к: навигация, поиск
(Оформление заказа)
Строка 14: Строка 14:
 
<?xml version="1.0" encoding="UTF-8"?>
 
<?xml version="1.0" encoding="UTF-8"?>
 
<neworder>
 
<neworder>
<auth login="login" pass="pass"></auth>
+
<auth login="login" pass="pass"></auth>
<order orderno="111111">
+
<order orderno="111111">
<date_putn>2014-03-22</date_putn>
+
  <barcode>111111</barcode>
<time_min>21:00</time_min>
+
  <receiver>
<time_max>23:00</time_max>
+
    <target>МВД</target>
<townfrom>Москва</townfrom>
+
    <name>САМАРИТЯНИН</name>
<townto>Санкт-Петербург</townto>
+
    <phone>123-45-67</phone>
<address>Петровка 38 офис 35</address>
+
    <town>Санкт-Петербург</town>
<target>МВД</target>
+
    <address>Петровка 38 офис 35</address>
<name>САМАРИТЯНИН</name>
+
    <date>2014-03-22</date>
<phone>123-45-67</phone>
+
    <time_min>21:00</time_min>
<mass>5</mass>
+
    <time_max>23:00</time_max>
<quantity>23</quantity>
+
  </receiver>
<price>357</price>
+
  <weight>5.1</weight>
<enclosure>тест1</enclosure>
+
  <quantity>23</quantity>
<inshprice>1234</inshprice>
+
  <price>357.5</price>
<instruction>тест</instruction>
+
  <inshprice>357.5</inshprice>
<strbarcode>111111</strbarcode>
+
  <enclosure>Детские игрушки</enclosure>
<items>
+
  <instruction>Проверить при покупателе, подписать акт</instruction>
<item quantity="1" mass="1" retprice="1" barcode="1" article="1">тест1</item>
+
  <items>
<item quantity="2" mass="2" retprice="2" barcode="2" article="2">тест2</item>
+
      <item quantity="1" mass="1" retprice="1" barcode="1" article="1">тест1</item>
<item quantity="3" mass="3" retprice="3" barcode="3" article="3">тест3</item>
+
      <item quantity="2" mass="2" retprice="2" barcode="2" article="2">тест2</item>
</items>
+
      <item quantity="3" mass="3" retprice="3" barcode="3" article="3">тест3</item>
</order>
+
  </items>
 +
</order>
 
</neworder>
 
</neworder>
 
</source>
 
</source>
 
  
 
== Запрос статуса ==
 
== Запрос статуса ==

Версия 11:37, 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">
   <barcode>111111</barcode>
   <receiver>
     <target>МВД</target>
     <name>САМАРИТЯНИН</name>
     <phone>123-45-67</phone>
     <town>Санкт-Петербург</town>
     <address>Петровка 38 офис 35</address>
     <date>2014-03-22</date>
     <time_min>21:00</time_min>
     <time_max>23:00</time_max>
   </receiver>
   <weight>5.1</weight>
   <quantity>23</quantity>
   <price>357.5</price>
   <inshprice>357.5</inshprice>
   <enclosure>Детские игрушки</enclosure>
   <instruction>Проверить при покупателе, подписать акт</instruction>
   <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>