Изменения

Для взаимодействия модуля мобильных устройств со сторонними системами предусмотрено XML API. Сторонняя система передает справочники клиентов (компаний-заказчиков доставки), курьеров, и заказы на доставку. Обратно получает статусы заказов, приложенные документы (фото и подписи с экрана), и треки курьеров.

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

== Получение статусов заказов == == Получение изображений к заказам == == Получение треков курьеров == API модуля мобильных устройств Запрос создания заказа почти полностью совпадает с обычным [[API]], за исключением авторизациинескольких полей:

<coords> <lat>55.768679</lat> <lon>37.589042</lon> </coords> <code>1851117</code> <courier>927</courier>

<items> <item extcode="abc123" quantity="1" mass="0.2" retprice="37.5" barcode="2345625213125">Мяч</item> <item extcode="abc124" quantity="2" mass="2" retprice="100" barcode="4645625213138">Обруч</item> <item extcode="abc125" quantity="3" mass="0.3" retprice="50" barcode="2345625213126">Погремушка желтая</item> </items>

 Поле clientcode - код клиента в системе, от которого создается заказ

<coordscode>1851117</code> Идентификатор заказа <courier>927</courier> Код курьера</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>givn</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> <address>1863405</address> <kurierstate>3</kurierstate> <kurierundelstate>2</kurierundelstate> <kurierstatetime>2016-11-01 15:38</kurierstatetime> <kurierdate>2016-11-01</kurierdate> <kuriermessage>Иванова, секр.</kuriermessage> <kuriertime>15:38</kuriertime> <kuriermoney>1560</kuriermoney> <ldtime>2016-11-21 23:25:16</ldtime> </item></download></source> *address - код заказа*kurierstate - Статус доставки (справочник 64)*kurierundelstate - Причина недоставки (Справочник 6)*kuriermessage - примечания курьера/ФИО получившего*kurierdate, kuriertime - дата, время статуса.*kuriermoney - сумма, полученная курьером. В случае успешного приема данных необходимо подтвердить получение, послав запрос: <source lang="xml"> <?xml version="1.0" encoding="UTF- координаты8"?> <latcommitdownload> <auth login="login" pass="pass" /> <table>givn</table> <code>19368</code> </commitdownload></source> == Получение изображений к заказам ==Запрос отправляется по адресу https://home.courierexe.ru/api/clientapi.php <source lang="xml">55<?xml version="1.7686790" encoding="UTF-8"?> <download> <auth login="login" pass="pass" /lat> <table>attachment</table> <lon/download></source> Запрос содержит тег download - загрузка c сервера. auth - авторизация по login и pass. table - имя таблицы. В случае успеха сервер вернет ответ вида: <source lang="xml">37<?xml version="1.5890420" encoding="UTF-8"?><download count="1"> <item> <prkey>205115</lonprkey> <extraclientcode>8</coordsextraclientcode> <code>1851117-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 - имя таблицы. В случае успеха сервер вернет ответ вида: <source lang="xml"><?xml version="1.0" encoding="UTF-8"?><download count="1"> <item> <code>29798426</code> <kurier>2249</kurier> <phoneid>1160</phoneid> <lat>56.4565</lat> <lon>34.2777</lon> <Accuracy>30</Accuracy> <RequestDateTime>2015-07-21 21:02:31</RequestDateTime> <courier/item>927</couriersource>  Поля:*code - внутренний идентификатор, присвоенный сервером.*kurier - код курьера.*lat - широта.*lon - долгота.*Accuracy - точность определения координат в метрах.*RequestDateTime - дата/время запроса по часам мобильного устройства. В случае успешного приема данных необходимо подтвердить получение, послав запрос: <source lang="xml"><?xml version="1.0" encoding="UTF-8"?> <commitdownload> <auth login="login" pass="pass" /> <table>tracking</table> <code>29798426</code> </commitdownload></source> *code - поле code последней успешно добавленной записи. Сервер отметит все записи с таким или меньшим кодом отправленными. В выдаче download для таблицы tracking записи всегда отсортированы по возрастанию поля code. В случае успеха подтверждения сервер вернет ответ: <source lang="xml"><?xml version="1.0" encoding="UTF-8"?><commitdownload error="0">OK</commitdownload>