1452
правки
Изменения
→Получение статусов заказов
<order orderno="11_11_11">
<barcode>11_11_11</barcode>
<sender>
<enclosure>Детские игрушки</enclosure>
<instruction>Проверить при покупателе, подписать акт</instruction>
<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> </order> </neworder></source>
Вместо блока <auth></auth> используется <auth2></auth2>
Поле clientcode - код клиента в системе, от которого создается заказ При создании нового заказа в блоке <order></order>так же добавлены новые поля:<source lang="xml"> <code>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"?> <commitdownload> <auth login="login" pass="pass" /> <table>givn</table> <code>19368</code> </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>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 - имя таблицы. В случае успеха сервер вернет ответ вида: <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> </item></source> Поля:*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></source>