Page Comparison

...

Входные данные запроса getOrdersLog

#	Наименование поля	Тип данных	Длина	Обязательность	Описание
1	sessionID	Текст

Да

Идентификатор сессии, полученный от сервера после запроса авторизации.

Срок жизни сессии – 5 минут.. Если в течении этого времени в рамках сессии были проведены запросы, то срок жизни сессии увеличивается еще на 5 минут

2

filter


2.1	limit	Целое число

	Нет	Максимальное количество статусов, которое должна вернуть система. Если лимит не указан, по умолчанию возвращается информация максимум о 30 статусах заказа.
2.2	date

				Данный блок может использоваться как вместе с блоком "ref", так и отдельно от него.
2.2.1	begin

		Нет	Начало временного интервала для выбора изменений. Формат – “ГГГГ-ММ-ДДTЧЧ:ММ:СС.00Z”
2.2.2	end

		Нет	Окончания временного интервала для выбора изменений. Формат – “ГГГГ-ММ-ДДTЧЧ:ММ:СС.00Z”
2.3	refs

			Блок содержит список заказов. Может использоваться как с блоком "date" (тогда будут выведены выбранные заказы в указанном промежутке), так и без него.
2.3.1	reference	Текст	64

Имя заказа.

...

Примеры запроса getOrdersLog

Заголовки:

URL: /rest/2/distribution-api/orders/getOrdersLog

...

Структура: application/xml

XML:

1)

Code Block

language	xml

<?xml version="1.0" encoding="UTF-8"?>
<apiRequest>
   <sessionID>38a0e5953a744ff8be3a928453d735a6</sessionID>
   <filter>
      <limit>5000</limit>
      <date>
         <begin>2014-12-26T00:00:10.00Z</begin>
         <end>2014-12-26T23:54:10.00Z</end>
      </date>
   </filter>
</apiRequest>

2)

Code Block

language	xml

<?xml version="1.0" encoding="UTF-8"?>
<apiRequest>
   <sessionID>8057758B67649106D9AB0E46EC943265</sessionID>
   <filter>
      <limit>50</limit>
      <date>
         <begin>2015-06-07T00:00:10.00Z</begin>
         <end>2015-06-082T23:54:10.00Z</end>
      </date>
      <refs>
         <reference>Order_API_1955952_6</reference>
      </refs>
   </filter>
</apiRequest>

3)

Code Block

language	xml

<?xml version="1.0" encoding="UTF-8"?>
<apiRequest>
   <sessionID>8057758B67649106D9AB0E46EC943265</sessionID>
   <filter>
      <refs>
         <reference>Order_API_1955952_6</reference>
      </refs>
   </filter>
</apiRequest>

...

Для получения данных по изменению статусов заказов API использует структуру application/xml в качестве структуры ответа.

Output for getOrdersLog response

*если в ответе пришел статус "removed", это значит, что заказ был удален.

#	Наименование поля	Описание
1	Orders


1.1	Order


	Атрибут “referenceNumber”	Название/Идентификатор заказа
	Атрибут “status”	Статус заказа. Возможные значения представлены в Приложении 3.
	Атрибут “type”	Тип заказа. DO – Доставка PU – Сбор
	Атрибут “date”	Дата и время изменения статуса
	Атрибут “author”	Имя пользователя, от имени которого совершено действие
	Атрибут “shortNotes”	Название действия
	Атрибут “fullNotes”	Расшифровка действия
	Атрибут “fullNotes”	Причина недоставки если таковая имеется и комментарий введенный водителем. Возможные причины: Адресат выбыл Адресат отсутствует Доставка перенесена по просьбе адресата Отказ от получения По техническим причинам Неточный/неверный адрес Не найден адрес Погодные условия Иная

...

Примеры ответа getOrdersLog

...

Code Block

language	xml

<?xml version="1.0" encoding="UTF-8"?>
<apiResponse version="1.0">
   <apiResponse>
      <orders>
         <order referenceNumber="Order_API_1955952_6" status="NEW" type="PU" date="2015-06-08T05:30:15.000Z" author="&lt;external_system&gt;" shortNotes="&lt;created_from_external_system&gt;" fullNotes="" />
         <order referenceNumber="Order_API_1955952_6" status="UPDATED" type="PU" date="2015-06-08T11:41:11.000Z" author="&lt;external_system&gt;" shortNotes="&lt;updated_from_external_system&gt;" fullNotes="" />
      </orders>
   </apiResponse>
</apiResponse>

...

Возможные ошибки:

	ошибка
1	1134 - "No logs found for the order"
2	1108 - "Job with the provided reference number was not found"

Versions Compared

Old Version 11

New Version 12

Key