API модуля мобильных устройств — различия между версиями

Материал из Меасофт
Перейти к: навигация, поиск
(→‎Создание заказов)
Строка 146: Строка 146:
  
 
== Получение изображений к заказам ==
 
== Получение изображений к заказам ==
 +
Запрос отправляется по адресу https://home.courierexe.ru/api/clientapi.php
 +
 +
<source lang="xml">
 +
<?xml version="1.0" encoding="UTF-8"?>
 +
  <download>
 +
    <auth login="login" pass="pass" />
 +
    <table>attachment</table>
 +
  </download>
 +
</source>
 +
 +
Запрос содержит тег download - загрузка c сервера. auth - авторизация по login и pass. table - имя таблицы.
 +
 +
В случае успеха сервер вернет ответ вида:
 +
 +
<source lang="xml">
 +
<?xml version="1.0" encoding="UTF-8"?>
 +
<download count="1">
 +
  <item>
 +
    <prkey>205115</prkey>
 +
    <extraclientcode>8</extraclientcode>
 +
    <code>-19368</code>
 +
    <item_code>1863405</item_code>
 +
    <type>3</type>
 +
    <file>FFABRRRQAUUUUAFFFFABRRRQAUUUUAFFFFABRRRQAUUUUAFFFFABRRRQAUUUUAFFFFABRRRQAUUUUAFFFFABRRRQAUUUUAFFFFABRRRQAUUUUAfDv8OZ</file>
 +
    <filename>sign.jpg</filename>
 +
    <filesize>215130</filesize>
 +
    <extraID />
 +
    <UID>NULL</UID>
 +
    <ldtime>2015-07-21 23:25:16</ldtime>
 +
  </item>
 +
</download>
 +
</source>
 +
 +
В ответе 0 или более контейнеров item с записями. Значимые поля:
 +
code - отрицательный идентификатор, присвоенный сервером.
 +
item_code - код заказа.
 +
file - содержимое файла в кодировке base64
 +
filename - имя файла
 +
 +
В случае успешного приема данных необходимо подтвердить получение, послав запрос:
 +
 +
<source lang="xml">
 +
<?xml version="1.0" encoding="UTF-8"?>
 +
  <commitdownload>
 +
    <auth login="login" pass="pass" />
 +
    <table>attachment</table>
 +
    <oldcodes>-19368, -19369, -19370</oldcodes>
 +
    <newcodes>123, 124, 125</newcodes>
 +
  </commitdownload>
 +
</source>
 +
 +
*oldcodes - коды записей, пришедшие от сервера. Перечисление через запятую.
 +
*newcodes - коды записей, присвоенных в принимающей системе. Последовательность и количество должны соответствовать oldcodes.
 +
 +
В случае успеха подтверждения сервер вернет ответ:
 +
 +
<source lang="xml">
 +
<?xml version="1.0" encoding="UTF-8"?>
 +
<commitdownload error="0">OK</commitdownload>
 +
</source>
 +
 +
До тех пор пока вся последовательность "запрос данных - ответ данными - подтверждение приема - подтверждение подтверждения" не пройдена - данные считаются не переданными, и будут возвращены сервером при следующем запросе.
  
 
== Получение треков курьеров ==
 
== Получение треков курьеров ==
 +
 +
 +
Запрос отправляется по адресу https://home.courierexe.ru/api/clientapi.php
 +
 +
<source lang="xml">
 +
<?xml version="1.0" encoding="UTF-8"?>
 +
  <download>
 +
    <auth login="login" pass="pass" />
 +
    <table>tracking</table>
 +
  </download>
 +
</source>
 +
 +
Запрос содержит тег download - загрузка c сервера. auth - авторизация по login и pass. table - имя таблицы.

Версия 20:40, 21 июля 2015

Для взаимодействия модуля мобильных устройств со сторонними системами предусмотрено XML API.

Создание/изменение клиентов

Запрос отправляется по адресу https://home.courierexe.ru/api/clientapi.php 

<?xml version="1.0" encoding="UTF-8"?>
  <upload>
    <auth login="login" pass="pass" />
    <table>clients</table>
    <item>
      <code>2681</code>
      <company>Рога и копыта</company>
      <name>Иванов Иван Иванович</name>
      <phone>8-916-123-45-67</phone>
      <address>Варшавское шоссе, 125</address>
      <AskPayType>T</AskPayType>
    </item>
    <item>
      ...
    </item>
  </upload>

Запрос содержит тег upload - загрузка на сервер. auth - авторизация по login и pass. table - имя таблицы. Далее следуют один или несколько контейнеров item, каждый содержит 1 запись для добавления или изменения на сервере.

Описание полей: code - int, идентификатор записи. Если запись с таким code уже есть - она будет заменена. company - наименование компании name - ФИО контактного лица phone - телефон. address - фактический адрес. AskPayType - Спрашивать способ оплаты при доставке. T - истина, F - ложь.

В случае успеха запроса сервер вернет: 

  <?xml version="1.0" encoding="UTF-8"?>
  <upload error="0">OK</upload>

Создание/изменение курьеров

Запрос отправляется по адресу https://home.courierexe.ru/api/clientapi.php 

<?xml version="1.0" encoding="UTF-8"?>
  <upload>
    <auth login="login" pass="pass" />
    <table>kurier</table>
    <item>
      <code>2681</code>
      <name>Иванов Иван Иванович</name>
      <phonem>8-916-123-45-67</phonem>
      <dateput>NULL</dateput>
    </item>
    <item>
      ...
    </item>
  </upload>

Запрос содержит тег upload - загрузка на сервер. auth - авторизация по login и pass. table - имя таблицы. Далее следуют один или несколько контейнеров item, каждый содержит 1 запись для добавления или изменения на сервере.

Описание полей: code - int, идентификатор записи. Если запись с таким code уже есть - она будет заменена. name - ФИО курьера phonem - телефон курьера. Используется для обратного звонка при интеграции с телефонией. dateput - дата увольнения, чтобы блокировать курьера. Если курьер работает - NULL, если уволен - укажите дату увольнения в формате YYYY-MM-DD

В случае успеха запроса сервер вернет: 

  <?xml version="1.0" encoding="UTF-8"?>
  <upload error="0">OK</upload>

Создание заказов

Запросы отправляются по адресу https://home.courierexe.ru/api2/

Запрос создания заказа почти полностью совпадает с обычным API, за исключением нескольких полей: 

 <?xml version="1.0" encoding="UTF-8" ?>
 <neworder>
  <auth2 clientcode="655" extra="8" login="MEASOFT2" pass="pass"></auth2>
  <order orderno="11_11_11">
  <coords>
  <lat>55.768679</lat>
  <lon>37.589042</lon>
  </coords>
    <code>1851117</code>
    <courier>927</courier>
   <barcode>11_11_11</barcode>
   <sender>
     <company>МВД</company>
     <person>Иванов И.И.</person>
     <phone>123-45-67</phone>
     <town>Санкт-Петербург</town>
     <address>Петровка 38 офис 35</address>
     <date>2014-03-22</date>
     <time_min>09:00</time_min>
     <time_max>14:00</time_max>
   </sender>
   <receiver>
     <company>МВД</company>
     <person>Чип &amp; Дейл</person>
     <phone>123-45-67</phone>
     <zipcode>125480</zipcode>
     <town>Санкт-Петербург</town>
     <address>Петровка 38 офис 35</address>
     <date>2014-03-22</date>
     <time_min>09:00</time_min>
     <time_max>14:00</time_max>
   </receiver>
   <return>NO</return>
   <return_service>1</return_service>
   <weight>5.1</weight>
   <quantity>2</quantity>
   <paytype>CASH</paytype>
   <service>2</service>
   <price>387.5</price>
   <inshprice>387.5</inshprice>
   <enclosure>Детские игрушки</enclosure>
   <instruction>Проверить при покупателе, подписать акт</instruction>
   
  </order>
 </neworder>

Вместо блока <auth></auth> используется <auth2></auth2> Поле clientcode - код клиента в системе, от которого создается заказ


При создании нового заказа в блоке <order></order> так же добавлены новые поля: 

 <coords> - координаты
  <lat>55.768679</lat>
  <lon>37.589042</lon>
 </coords>
 <code>1851117</code>      Идентификатор заказа
 <courier>927</courier> код курьера

Получение статусов заказов

Получение изображений к заказам

Запрос отправляется по адресу https://home.courierexe.ru/api/clientapi.php 

<?xml version="1.0" encoding="UTF-8"?>
  <download>
    <auth login="login" pass="pass" />
    <table>attachment</table>
  </download>

Запрос содержит тег download - загрузка c сервера. auth - авторизация по login и pass. table - имя таблицы.

В случае успеха сервер вернет ответ вида: 

<?xml version="1.0" encoding="UTF-8"?>
<download count="1">
  <item>
    <prkey>205115</prkey>
    <extraclientcode>8</extraclientcode>
    <code>-19368</code>
    <item_code>1863405</item_code>
    <type>3</type>
    <file>FFABRRRQAUUUUAFFFFABRRRQAUUUUAFFFFABRRRQAUUUUAFFFFABRRRQAUUUUAFFFFABRRRQAUUUUAFFFFABRRRQAUUUUAFFFFABRRRQAUUUUAfDv8OZ</file>
    <filename>sign.jpg</filename>
    <filesize>215130</filesize>
    <extraID />
    <UID>NULL</UID>
    <ldtime>2015-07-21 23:25:16</ldtime>
  </item>
</download>

В ответе 0 или более контейнеров item с записями. Значимые поля: code - отрицательный идентификатор, присвоенный сервером. item_code - код заказа. file - содержимое файла в кодировке base64 filename - имя файла

В случае успешного приема данных необходимо подтвердить получение, послав запрос: 

<?xml version="1.0" encoding="UTF-8"?>
  <commitdownload>
    <auth login="login" pass="pass" />
    <table>attachment</table>
    <oldcodes>-19368, -19369, -19370</oldcodes>
    <newcodes>123, 124, 125</newcodes>
  </commitdownload>
  • oldcodes - коды записей, пришедшие от сервера. Перечисление через запятую.
  • newcodes - коды записей, присвоенных в принимающей системе. Последовательность и количество должны соответствовать oldcodes.

В случае успеха подтверждения сервер вернет ответ: 

<?xml version="1.0" encoding="UTF-8"?>
<commitdownload error="0">OK</commitdownload>

До тех пор пока вся последовательность "запрос данных - ответ данными - подтверждение приема - подтверждение подтверждения" не пройдена - данные считаются не переданными, и будут возвращены сервером при следующем запросе.

Получение треков курьеров

Запрос отправляется по адресу https://home.courierexe.ru/api/clientapi.php 

<?xml version="1.0" encoding="UTF-8"?>
  <download>
    <auth login="login" pass="pass" />
    <table>tracking</table>
  </download>

Запрос содержит тег download - загрузка c сервера. auth - авторизация по login и pass. table - имя таблицы.

Источник — «https://wiki.courierexe.ru/index.php?title=API_модуля_мобильных_устройств&oldid=3033»