1452
правки
Изменения
API
,Нет описания правки
<?xml version="1.0" encoding="UTF-8" ?>
<statusreq>
<auth login="login" pass="pass"></auth> <client>CLIENT</client> <orderno>1234</orderno> <ordercode>34234</ordercode> <givencode>234534</givencode> <datefrom>2014-04-03</datefrom> <dateto>2014-04-03</dateto> <done>ONLY_NOT_DONE</done> <changes>ONLY_LAST</changes> (not yet supported)
</statusreq>
</source>
*Только доставленные '''ONLY_DONE'''
*Все '''пусто'''
*'''changes''' - может принимать значение только ONLY_LAST. Если указан этот параметр, все остальные игнорируются. Описание данного режима приведено здесь: [[#Передача только изменившихся статусов]]
=== Примеры ответов ===
<source lang="xml">
<?xml version="1.0" encoding="utf-8"?>
<statusreqcount="0">
</statusreq>
</source>
''Примечание:'' В будущем планируется расширение используемого набора статусов.
=== Передача только изменившихся статусов ===
Для получения только изменившихся статусов отправьте запрос
<source lang="xml">
<?xml version="1.0" encoding="UTF-8" ?>
<statusreq>
<auth login="login" pass="pass"></auth>
<changes>ONLY_LAST</changes>
</statusreq>
</source>
Система выдает все заказы, в которых, с момента последнего запроса в этом режиме изменилось одно из полей:
orderno
status
delivereddate
deliveredtime
deliveredto
receiver->date
receiver->address
price
После успешной обработки ответа необходимо отметить полученные статусы успешно полученными, отправив запрос
<source lang="xml">
<?xml version="1.0" encoding="UTF-8" ?>
<commitlaststatus>
<auth login="login" pass="pass"></auth>
</commitlaststatus>
</source>
В случае успех вы получите ответ
<source lang="xml">
<?xml version="1.0" encoding="UTF-8" ?>
<commitlaststatus>
<error error="0" errormsg="OK"></error>
</commitlaststatus>
</source>
Данный способ передачи статусов гарантирует полную корректную передачу статусов, даже в случае, если в нашей системе статус изменился в промежутке времени между запросом статусов и подтверждением их получения. Если система не получила подтверждение успешной передачи статуса, она будет считать информацию не переданной, и выдаст ее при повторном запросе.
''Внимание!'' При данном способе передачи система просматривает заказы, оформленные за последние 3 месяца. Если заказ сделан ранее - изменение статуса по нему не попадет в результат выполнения данного запроса.
''Внимание!'' Система всегда выдает текущий статус. Т.е. Вы можете одним запросом получить статус "NEW", а следующим - "COMPLETE". В помежутке между запросами отправление могло пройти через несколько промежуточных статусов.
''Внимание!'' Система не гарантирует последовательность прохождения заказом набора статусов. Т.е. Вы можете получить статус "COMPLETE", а следующим запросом - "NEW" - такое может произойти, например, если оператор ошибочно отметил заказ выполненным, а затем исправил ошибку.
== Справочник городов ==
