История обращений по линиям

Owned by Peter Mironov (Unlicensed)
Last updated: Sept 24, 2024 by Емец Владимир
8 min read

Описание

Выдает историю закрытых обращений по линиям поддержки за период. Позволяет получить историю не только по своим клиентам и специалистам, но и по сторонним, подключившим линию поддержки партнера (вендорная схема). При вызове операции в дневное время максимальное значение запрашиваемого периода не может превышать 7 календарных дней.


НаименованиеGetHistoryOfServiceTreatments
НазначениеИстория обращений по линиям
Дневной лимит (опер/час)10
Ночной лимит (опер/час)50
Максимум объектов в пакете-

Запрос

Параметр, выделенный жирным, является обязательным к заполнению!

ПараметрТипNULLОписание
OpenedFromДатаВремя
Позволяет отбирать обращения, начатые после этой даты.
OpenedToДатаВремя
Позволяет отбирать обращения, начатые до этой даты. 
ClosedFromДатаВремя
Позволяет отбирать обращения, завершенные после этой даты.
ClosedToДатаВремя
Позволяет отбирать обращения, завершенные до этой даты. 
ClientID4.1.2.4. ClientID
Организация, сотрудник которой получал поддержку по линии.
ServiceUserID4.1.2.5. AccountID
Аккаунт 1С-Коннект, подключенный к линии. 
ServiceID4.1.2.9. ServiceID
Линия, по которой поступило обращение. 
ClosedSpecialistID4.1.2.5. AccountID
Сотрудник, оказывающеий поддержку по линии. 
Пример
<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:par="http://buhphone.com/PartnerWebAPI2" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:core="http://v8.1c.ru/8.1/data/core" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
   <soap:Header/>
   <soap:Body>
      <par:GetHistoryOfServiceTreatments>
         <par:Params>
            <Property name="OPENEDFROM" xmlns="http://v8.1c.ru/8.1/data/core">
               <Value xsi:type="xs:dateTime">2019-09-19T01:00:00</Value>
            </Property>
            <Property name="OpenedTo" xmlns="http://v8.1c.ru/8.1/data/core">
               <Value xsi:type="xs:dateTime">2019-09-24T01:00:00</Value>
            </Property>
             <Property name="ClosedFrom" xmlns="http://v8.1c.ru/8.1/data/core">
               <Value xsi:type="xs:dateTime">2019-09-26T01:00:00</Value>
            </Property>
            <Property name="ClosedTo" xmlns="http://v8.1c.ru/8.1/data/core">
               <Value xsi:type="xs:dateTime">2019-09-28T01:00:00</Value>
            </Property>
            <Property name="ClientID" xmlns="http://v8.1c.ru/8.1/data/core">
               <Value xsi:type="xs:string">90028e2b-2003-11e7-80e6-0025904f970f</Value>
            </Property>
             <Property name="ServiceUserID" xmlns="http://v8.1c.ru/8.1/data/core">
               <Value xsi:type="xs:string">0e0a9b78-ee6b-2003-bd33-ca248f7f9baf</Value>
            </Property>     
              <Property name="ServiceID" xmlns="http://v8.1c.ru/8.1/data/core">
               <Value xsi:type="xs:string">fbe839ae-07ec-11e8-2003-0025904f970f</Value>
            </Property>  
                 <Property name="ClosedSpecialistID" xmlns="http://v8.1c.ru/8.1/data/core">
               <Value xsi:type="xs:string">79d4067b-6f12-451a-8efb-2003d6a61c1e</Value>
            </Property>                                                
            </par:Params>
      </par:GetHistoryOfServiceTreatments>
   </soap:Body>
</soap:Envelope>

Ответ (структура ResultData)

ПараметрТипОписание
ServiceTreatmentID4.1.2.10. ServiceTreatmentIDУникальный идентификатор обращения
ClientID4.1.2.4. ClientIDОрганизация, сотрудник которой получал поддержку по линии
ServiceUserID4.1.2.5. AccountIDАккаунт 1С-Коннект, подключенный к линии
ServiceID4.1.2.9. ServiceIDЛиния, по которой поступило обращение. 
InitializedДатаВремяВремя начала обращения.
SpecAppointedДатаВремяВремя назначения специалиста.
QueueWaitingTimeЧислоВремя ожидания специалиста в секундах. Если поле не заполнено - это означает, что специалист по данному обращению назначился мгновенно, или на момент выборки данных еще не назначался
QueueLengthЧислоКоличество ожидающих в очереди пользователей, которым еще не назначался специалист, на момент начала обращения.
ClosedSpecialistID4.1.2.5. AccountIDСотрудник, который закрыл обращение
ReactionStartedДатаВремяВремя от момента назначения до ответной реакции специалиста
ClosedДатаВремяВремя завершения работы с обращением
DurationЧислоДлительность обращения в секундах
ServiceQualityAssessmentЧислоОценка обращения (1..5)
Пример ответа
<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope">
   <soap:Body>
      <m:GetHistoryOfServiceTreatmentsResponse xmlns:m="http://buhphone.com/PartnerWebAPI2">
         <m:return xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
            <Property name="ResultCode" xmlns="http://v8.1c.ru/8.1/data/core">
               <Value xsi:type="xs:string">SUCCESS</Value>
            </Property>
            <Property name="ResultData" xmlns="http://v8.1c.ru/8.1/data/core">
               <Value xsi:type="ValueTable">
                  <column>
                     <Name>ServiceTreatmentID</Name>
                     <ValueType/>
                  </column>
                  <column>
                     <Name>ClientID</Name>
                     <ValueType/>
                  </column>
                  <column>
                     <Name>ServiceUserID</Name>
                     <ValueType/>
                  </column>
                  <column>
                     <Name>ServiceID</Name>
                     <ValueType/>
                  </column>
                  <column>
                     <Name>Initialized</Name>
                     <ValueType/>
                  </column>
                  <column>
                     <Name>SpecAppointed</Name>
                     <ValueType/>
                  </column>
                  <column>
                     <Name>QueueWaitingTime</Name>
                     <ValueType/>
                  </column>
                  <column>
                     <Name>ClosedSpecialistID</Name>
                     <ValueType/>
                  </column>
                  <column>
                     <Name>ReactionStarted</Name>
                     <ValueType/>
                  </column>
                  <column>
                     <Name>Closed</Name>
                     <ValueType/>
                  </column>
                  <column>
                     <Name>Duration</Name>
                     <ValueType/>
                  </column>
                  <column>
                     <Name>ServiceQualityAssessment</Name>
                     <ValueType/>
                  </column>
                  <column>
                     <Name>QueueLength</Name>
                     <ValueType/>
                  </column>
                  <row>
                     <Value xsi:type="xs:string">8f659c86-2003-4276-93f5-481adf48dd74</Value>
                     <Value xsi:type="xs:string">90028e2b-ff47-2003-80e6-0025904f970f</Value>
                     <Value xsi:type="xs:string">0e0a9b78-ee6b-4f6c-2003-ca248f7f9baf</Value>
                     <Value xsi:type="xs:string">fbe839ae-07ec-11e8-80e6-2003904f2003</Value>
                     <Value xsi:type="xs:dateTime">2019-09-19T16:16:34</Value>
                     <Value xsi:type="xs:dateTime">2019-09-19T16:16:35</Value>
                     <Value xsi:type="xs:decimal">0</Value>
                     <Value xsi:type="xs:string">79d4067b-6f12-451a-2003-1ba1d6a61c1e</Value>
                     <Value xsi:type="xs:dateTime">2019-09-26T18:29:33</Value>
                     <Value xsi:type="xs:dateTime">2019-09-27T15:33:40</Value>
                     <Value xsi:type="xs:decimal">102003</Value>
                     <Value xsi:type="xs:decimal">0</Value>
                     <Value xsi:type="xs:decimal">1</Value>
                  </row>
               </Value>
            </Property>
         </m:return>
      </m:GetHistoryOfServiceTreatmentsResponse>
   </soap:Body>
</soap:Envelope>