Получение списка изменений состояния заказов (GetReservesStateChangeList)

Owned by Anna Gorovaya (Unlicensed)
Last updated: Mar 05, 2023 by Confluence Admin
2 min read

Операция доступна только агенту.

 

Данный метод позволяет получить все изменения состояния заказов за переданный период дат.

https://demo.corteos.ru/XmlGate/V3/OrderManagement/OrdersAPI.asmx?op=GetReservesStateChangeList

Запрос

HTML/XML

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:cor="http://corteos.ru">     <soapenv:Header>        <cor:AuthHeader>          <!--Optional:-->             <cor:Token>5cfcdb30-xxx-xxxx-xxxx-2e360c455249</cor:Token>        </cor:AuthHeader>      </soapenv:Header>      <soapenv:Body>         <cor:GetReservesStateChangeList>           <cor:dateStart>2019-01-01</cor:dateStart>           <cor:dateEnd>2019-10-10</cor:dateEnd>        </cor:GetReservesStateChangeList>      </soapenv:Body> </soapenv:Envelope>

Обязательные параметры:

  • dateStart - дата и время начала выборки

  • dateEnd - дата и время окончания выборки

Не следует передавать диапазон дат более 1 дня в высокочастотной выгрузке (чаще одного раза в день), так как это создает дополнительную нагрузку на БД Corteos. При обнаружении чрезмерной нагрузки IP-адрес, с которого производятся обращения, будет перманентно заблокирован.

 

Опциональные параметры:

  • id_ClientGroup - идентификатор группы компаний клиента-заказчика (не путать с номером договора!);

  • id_Reserve - идентификатор заказа в том случае, если мы хотим получить информацию об изменениях по конкретному заказу (но диапазон дат нужно передавать все равно).

Для проведения данного вызова необходимо пройти авторизацию.

Примеры: запрос / ответ


Разберем структуру ответа на примере одного элемента:

HTML/XML

<StableSimpleReserveStateChanges id_Reserve="1756996" id_ReserveState="5"             id_PreviousState="4" IsManual="true" DateChanged="2019-07-16T17:50:30.337"             id_ReserveType="1" id_CurrentState="5" BookerEmail="marina@elmotest.ru" id_ClientBooker="113"             id_ClientGroup="63">        <id_Change>3131098</id_Change> </StableSimpleReserveStateChanges>

  • id_Reserve - номер заказа, у которого произошло изменение статуса (виден, например, в списке заказов):

 



  • id_ReserveState - статус, в который заказ был переведен при проведении этой операции;

  • id_PreviousState - статус, в котором находился заказ до проведения операции;

  • IsManual:

  • true - в случае, если данное изменение статуса было сделано агентом;

  • false - если изменение статуса произошло автоматически (например, клиент выписал билет и заказ перешел в состояние "Выполнен");

  • DateChanged - дата и время, в которые произошло это изменение;

  • id_ReserveType - тип заказа, к которому относится данное изменение;

  • id_CurrentState - статус заказа на момент запроса, может не совпадать с id_ReserveState в том случае, если после указанного изменения статус заказа был изменен ещё раз;

  • BookerEmail - адрес электронной почты заказчика;

  • id_ClientGroup - идентификатор группы клиента, который создал этот заказ.