1452
правки
Изменения
→Получение статусов заказов
Для взаимодействия модуля мобильных устройств со сторонними системами предусмотрено XML API. Сторонняя система передает справочники клиентов (компаний-заказчиков доставки), курьеров, и заказы на доставку. Обратно получает статусы заказов, приложенные документы (фото и подписи с экрана), и треки курьеров.
== Создание/изменение клиентов ==
<address>Варшавское шоссе, 125</address>
<AskPayType>T</AskPayType>
<CreateTrans>T</CreateTrans>
<CheckMessage>По возвратам обращаться тел. 123-45-67</CheckMessage>
</item>
<item>
*address - фактический адрес.
*AskPayType - Спрашивать способ оплаты (наличными/картой) при доставке. T - истина, F - ложь.
*CreateTrans - Кассовое обслуживание. T - истина, F - ложь. Если у курьера подключен фискальный регистратор, приложение не позволит сохранить доставку не распечатав чек. Если у курьера нет ФР - приложение укажет на необходимость печати чека на отдельном кассовом аппарате или выдачи заранее распечатанного чека.
*CheckMessage - Дополнительный текст для вывода на чек.
В случае успеха запроса сервер вернет:
== Создание заказов ==
Запросы отправляются по адресу https://home.courierexe.ru/api2api/
Запрос создания заказа почти полностью совпадает с обычным [[API]], за исключением нескольких полей:
<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 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>
== Получение изображений к заказам ==
