Получение списка линий

Owned by Peter Mironov (Unlicensed)
Last updated: Sept 24, 2019 by Сушенцева Виктория (Unlicensed)
33 min read

Описание

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


НаименованиеServiceLineKindRead
НазначениеПолучение списка линий поддержки
Дневной лимит (опер/час)250
Ночной лимит (опер/час)1250
Максимум объектов в пакете-

Запрос

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

ПараметрТипNULLОписание
ChangedFromДатаВремя
Отбор объектов по которым были изменения не ранее указанной даты. Точность до секунд. 
Пример
<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:ServiceLineKindRead>
         <par:Params>
            <Property xmlns="http://v8.1c.ru/8.1/data/core" name="ChangedFrom">
             <Value xsi:type="xs:dateTime">2019-01-01T12:00:00</Value>
           </Property>
         </par:Params>
      </par:ServiceLineKindRead>
   </soap:Body>
</soap:Envelope>

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

ПараметрТипОписание
ServiceID4.1.2.9. ServiceIDИдентификатор линии поддержки.
DeletedБулевоПризнак удаления линии поддержки. Истина если линия удалена.
NameСтрока(50)Наименование линии поддержки
DisplayedNameСтрока(100)Отображаемое в агенте название
DisplayedHintСтрока(100)Всплывающая подсказка.
DescriptionLinkURLСсылка на описание
OwnerTypeСтрока

Тип принадлежности линии поддержки. Значения:

  • INTERNAL = своя внутренняя
  • EXPORTED = своя экспортируемая
  • IMPORTED = импортирована
VendorID4.1.2.4. ClientIDВендор. Если услуга собственная, то поле пустое. Только для чтения
EMailForNotificationsE-Mail_множE-Mail для уведомления по линии поддержки.
NotifyBeforeExpiresБулевоУведомлять об истечении поддержки по линии
NotifyAtDaysBeforeExpiresЧисло (от 1 до 30)Количество дней до напоминания об истечении поддержки по линии. По умолчанию 10 дней.
ServiceUsersAudienceСтрока

Доступность услуги. Значения:

  • ALL = всем
  • FORSPECIALISTS = своим сотрудникам
OfferServiceForClientsБулевоРекламировать линию в программе клиента
OfferServiceForSpecialistsБулевоРекламировать линию в программе специалиста
AutoConnectServiceForClientsБулевоАвтоматически подключать линию клиенту при создании.
AutoConnectServiceForSpecialistsБулевоАвтоматически подключать линию специалисту при создании.
AutoAcceptRequestForConnectServiceБулевоАвтоматически принимать заявку на подключение линии поддержки
CloseTreatmentAfterInactivityForSeveralDaysЧисло (от 0 до 90)Завершать обращение при отсутствии активности более указанного числа дней. 31 Если 0, то автозаврешение отключено. 
MaxQueueTimeBySLAЧисло (от 0 до 99 999)Нормативное время ожидания в очереди. В минутах. 
MaxSpecialistReactionTimeBySLAЧисло (от 0 до 99 999)Нормативное время реакции специалиста. В минутах.
MaxTreatmentTimeBySLAЧисло (от 0 до 99 999)Нормативное время работы с обращением. В минутах.
NotifyOfNoAppointedSpecБулевоОтправлять уведомление если обращение поставлено в очередь(отсутствуют свободные специалисты).
NotifyOfCriticalQueueLengthReachedБулевоОтправлять уведомление если длина очереди достигла лимита.
CriticalQueueLengthЧисло (от 1 до 99)Количество обращений, при достижении которого отправляется уведомление о превышении длины очереди.
ScheduleOfServiceAvailabilityEnabledБулевоПризнак использования расписания доступности услуги. Если Ложь, то элемент "ScheduleOfServiceAvailability" пустой (или неопределенно).
ScheduleOfServiceAvailabilityСтруктура

Время доступности услуги. Все поля структуры должны быть заполнены (существовать).Расписание сохраняется вне зависимости от значения параметра «ScheduleOfServiceAvailabilityEnabled» Значения:

  • AvailableOnMonday - <Булево> - Вид линии поддержки доступен в понедельник
  • AvailableOnTuesday - <Булево> - Вид линии поддержки доступен во вторник
  • AvailableOnWednesday - <Булево> - Вид линии поддержки доступен в среду
  • AvailableOnThursday - <Булево> - Вид линии поддержки доступен в четверг
  • AvailableOnFriday - <Булево> - Вид линии поддержки доступен в пятницу
  • AvailableOnSaturday - <Булево> -  Вид линии поддержки доступен в субботу
  • AvailableOnSunday - <Булево> -  Вид линии поддержки доступен в воскресенье
  • StartTime - <ДатаВремя> -  Время начала рабочего дня по местному времени партнера. Обязательный параметр. Можно указывать пустое значение. Время в часовом поясе головного региона партнера.
  • EndTime - ДатаВремя Время окончания рабочего дня по местному времени партнера. Обязательный параметр. Можно указывать пустое значение. Время в часовом поясе головного региона обслуживающей компании.
MessageDeliveryPriorityСтрока

Приоритет доставки сообщений:

  • NO_PRIORITY=без персонального приоритета
  • FIRST_TO_SPECIALIST = сервис-инженер → клиент-менеджер → остальные по приоритету
  • FIRST_TO_MANAGER = клиент-менеджер → сервис-инженер → остальные по приоритету
MaximumQualityMarkToNotifyPartnerЧислоУведомлять об оценках. От 1 до 5. Если уведомление отключено то 0.
ServiceQueueLimitEnabledБулевоТумблер включения лимитов по количеству обращений на одного специалиста
ServiceQueueLimitЧислоЛимит обращений на одного специалиста. Возможные значения 1-99
AutoAcceptRequestForImportБулевоАвтоматически принимать заявку на импорт.
EnableFirstLineOnImportБулевоРазрешать первую линию при импорте.
RequiringPaymentБулевоПлатная услуга. Только чтение.
EnableSearchБулевоРазрешение поиска. Значение по умолчанию false
SearchAreaVisibilityСтрока

Вариант поиска. Возможные значения:

  • NONE = Значение отсутствует.
  • FOR_MY_CUSTOMERS = "Только для моих клиентов и специалистов". Можно установить своей или вендорной линии поддержки. Значение по умолчанию.
  • FOR_CUSTOMERS_IN_MY_REGION = "Всем клиентам в моем регионе". Можно установить только своей линии поддержки
  • FOR_CUSTOMERS_IN_MY_TIME_ZONE = "Всем в моем часовом поясе". Можно установить только своей линии поддержки
  • FOR_CUSTOMERS_IN_MY_COUNTRY ="Всем клиентам в стране". Можно установить только своей линии поддержки
Пример ответа
<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope">
   <soap:Body>
      <m:ServiceLineKindReadResponse 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>ServiceID</Name>
                     <ValueType>
                        <Type>xs:string</Type>
                        <Type>Null</Type>
                        <StringQualifiers>
                           <Length>0</Length>
                           <AllowedLength>Variable</AllowedLength>
                        </StringQualifiers>
                     </ValueType>
                  </column>
                  <column>
                     <Name>Deleted</Name>
                     <ValueType>
                        <Type>xs:boolean</Type>
                     </ValueType>
                  </column>
                  <column>
                     <Name>Name</Name>
                     <ValueType>
                        <Type>xs:string</Type>
                        <StringQualifiers>
                           <Length>50</Length>
                           <AllowedLength>Variable</AllowedLength>
                        </StringQualifiers>
                     </ValueType>
                  </column>
                  <column>
                     <Name>DisplayedName</Name>
                     <ValueType>
                        <Type>xs:string</Type>
                        <StringQualifiers>
                           <Length>100</Length>
                           <AllowedLength>Variable</AllowedLength>
                        </StringQualifiers>
                     </ValueType>
                  </column>
                  <column>
                     <Name>DisplayedHint</Name>
                     <ValueType>
                        <Type>xs:string</Type>
                        <StringQualifiers>
                           <Length>100</Length>
                           <AllowedLength>Variable</AllowedLength>
                        </StringQualifiers>
                     </ValueType>
                  </column>
                  <column>
                     <Name>DescriptionLink</Name>
                     <ValueType>
                        <Type>xs:string</Type>
                        <StringQualifiers>
                           <Length>300</Length>
                           <AllowedLength>Variable</AllowedLength>
                        </StringQualifiers>
                     </ValueType>
                  </column>
                  <column>
                     <Name>OwnerType</Name>
                     <ValueType>
                        <Type>xs:string</Type>
                        <StringQualifiers>
                           <Length>8</Length>
                           <AllowedLength>Variable</AllowedLength>
                        </StringQualifiers>
                     </ValueType>
                  </column>
                  <column>
                     <Name>VendorID</Name>
                     <ValueType>
                        <Type>xs:string</Type>
                        <Type>Null</Type>
                        <StringQualifiers>
                           <Length>0</Length>
                           <AllowedLength>Variable</AllowedLength>
                        </StringQualifiers>
                     </ValueType>
                  </column>
                  <column>
                     <Name>EMailForNotifications</Name>
                     <ValueType>
                        <Type>xs:string</Type>
                        <StringQualifiers>
                           <Length>1000</Length>
                           <AllowedLength>Variable</AllowedLength>
                        </StringQualifiers>
                     </ValueType>
                  </column>
                  <column>
                     <Name>NotifyBeforeExpires</Name>
                     <ValueType>
                        <Type>xs:boolean</Type>
                     </ValueType>
                  </column>
                  <column>
                     <Name>NotifyAtDaysBeforeExpires</Name>
                     <ValueType>
                        <Type>xs:decimal</Type>
                        <NumberQualifiers>
                           <Digits>10</Digits>
                           <FractionDigits>0</FractionDigits>
                           <AllowedSign>Any</AllowedSign>
                        </NumberQualifiers>
                     </ValueType>
                  </column>
                  <column>
                     <Name>ServiceUsersAudience</Name>
                     <ValueType>
                        <Type>xs:string</Type>
                        <StringQualifiers>
                           <Length>14</Length>
                           <AllowedLength>Variable</AllowedLength>
                        </StringQualifiers>
                     </ValueType>
                  </column>
                  <column>
                     <Name>OfferServiceForClients</Name>
                     <ValueType>
                        <Type>xs:boolean</Type>
                     </ValueType>
                  </column>
                  <column>
                     <Name>OfferServiceForSpecialists</Name>
                     <ValueType>
                        <Type>xs:boolean</Type>
                     </ValueType>
                  </column>
                  <column>
                     <Name>AutoConnectServiceForClients</Name>
                     <ValueType>
                        <Type>xs:boolean</Type>
                     </ValueType>
                  </column>
                  <column>
                     <Name>AutoConnectServiceForSpecialists</Name>
                     <ValueType>
                        <Type>xs:boolean</Type>
                     </ValueType>
                  </column>
                  <column>
                     <Name>AutoAcceptRequestForConnectService</Name>
                     <ValueType>
                        <Type>xs:boolean</Type>
                     </ValueType>
                  </column>
                  <column>
                     <Name>CloseTreatmentAfterInactivityForSeveralDays</Name>
                     <ValueType>
                        <Type>xs:decimal</Type>
                        <NumberQualifiers>
                           <Digits>0</Digits>
                           <FractionDigits>0</FractionDigits>
                           <AllowedSign>Any</AllowedSign>
                        </NumberQualifiers>
                     </ValueType>
                  </column>
                  <column>
                     <Name>MaxQueueTimeBySLA</Name>
                     <ValueType>
                        <Type>xs:decimal</Type>
                        <NumberQualifiers>
                           <Digits>5</Digits>
                           <FractionDigits>0</FractionDigits>
                           <AllowedSign>Nonnegative</AllowedSign>
                        </NumberQualifiers>
                     </ValueType>
                  </column>
                  <column>
                     <Name>MaxSpecialistReactionTimeBySLA</Name>
                     <ValueType>
                        <Type>xs:decimal</Type>
                        <NumberQualifiers>
                           <Digits>5</Digits>
                           <FractionDigits>0</FractionDigits>
                           <AllowedSign>Nonnegative</AllowedSign>
                        </NumberQualifiers>
                     </ValueType>
                  </column>
                  <column>
                     <Name>MaxTreatmentTimeBySLA</Name>
                     <ValueType>
                        <Type>xs:decimal</Type>
                        <NumberQualifiers>
                           <Digits>5</Digits>
                           <FractionDigits>0</FractionDigits>
                           <AllowedSign>Nonnegative</AllowedSign>
                        </NumberQualifiers>
                     </ValueType>
                  </column>
                  <column>
                     <Name>ScheduleOfServiceAvailabilityEnabled</Name>
                     <ValueType>
                        <Type>xs:boolean</Type>
                     </ValueType>
                  </column>
                  <column>
                     <Name>ScheduleOfServiceAvailability</Name>
                     <ValueType/>
                  </column>
                  <column>
                     <Name>MessageDeliveryPriority</Name>
                     <ValueType>
                        <Type>xs:string</Type>
                        <StringQualifiers>
                           <Length>19</Length>
                           <AllowedLength>Variable</AllowedLength>
                        </StringQualifiers>
                     </ValueType>
                  </column>
                  <column>
                     <Name>MaximumQualityMarkToNotifyPartner</Name>
                     <ValueType>
                        <Type>xs:decimal</Type>
                        <NumberQualifiers>
                           <Digits>0</Digits>
                           <FractionDigits>0</FractionDigits>
                           <AllowedSign>Any</AllowedSign>
                        </NumberQualifiers>
                     </ValueType>
                  </column>
                  <column>
                     <Name>AutoAcceptRequestForImport</Name>
                     <ValueType>
                        <Type>xs:boolean</Type>
                     </ValueType>
                  </column>
                  <column>
                     <Name>EnableFirstLineOnImport</Name>
                     <ValueType>
                        <Type>xs:boolean</Type>
                     </ValueType>
                  </column>
                  <column>
                     <Name>EnableSearch</Name>
                     <ValueType>
                        <Type>xs:boolean</Type>
                     </ValueType>
                  </column>
                  <column>
                     <Name>SearchAreaVisibility</Name>
                     <ValueType>
                        <Type>xs:string</Type>
                        <StringQualifiers>
                           <Length>29</Length>
                           <AllowedLength>Variable</AllowedLength>
                        </StringQualifiers>
                     </ValueType>
                  </column>
                  <column>
                     <Name>RequiringPayment</Name>
                     <ValueType>
                        <Type>xs:boolean</Type>
                     </ValueType>
                  </column>
                  <column>
                     <Name>NotifyOfNoAppointedSpec</Name>
                     <ValueType>
                        <Type>xs:boolean</Type>
                     </ValueType>
                  </column>
                  <column>
                     <Name>NotifyOfCriticalQueueLengthReached</Name>
                     <ValueType>
                        <Type>xs:boolean</Type>
                     </ValueType>
                  </column>
                  <column>
                     <Name>CriticalQueueLength</Name>
                     <ValueType>
                        <Type>xs:decimal</Type>
                        <NumberQualifiers>
                           <Digits>5</Digits>
                           <FractionDigits>0</FractionDigits>
                           <AllowedSign>Any</AllowedSign>
                        </NumberQualifiers>
                     </ValueType>
                  </column>
                  <column>
                     <Name>ServiceQueueLimitEnabled</Name>
                     <ValueType>
                        <Type>xs:boolean</Type>
                     </ValueType>
                  </column>
                  <column>
                     <Name>ServiceQueueLimit</Name>
                     <ValueType>
                        <Type>xs:decimal</Type>
                        <NumberQualifiers>
                           <Digits>2</Digits>
                           <FractionDigits>0</FractionDigits>
                           <AllowedSign>Nonnegative</AllowedSign>
                        </NumberQualifiers>
                     </ValueType>
                  </column>
                  <row>
                     <Value xsi:type="xs:string">d7aa2020-b10a-2020-80dc-ba5e5a722020</Value>
                     <Value xsi:type="xs:boolean">false</Value>
                     <Value xsi:type="xs:string">Линия поддержки пользователей ИТС - первая линия</Value>
                     <Value xsi:type="xs:string">Линия поддержки пользователей ИТС</Value>
                     <Value xsi:type="xs:string">Линия для обслуживания клиентов с договором ИТС-Проф</Value>
                     <Value xsi:type="xs:string">нашсайт.рф</Value>
                     <Value xsi:type="xs:string">INTERNAL</Value>
                     <Value xsi:nil="true"/>
                     <Value xsi:type="xs:string">mail@mail.com</Value>
                     <Value xsi:type="xs:boolean">true</Value>
                     <Value xsi:type="xs:decimal">10</Value>
                     <Value xsi:type="xs:string">FORSPECIALISTS</Value>
                     <Value xsi:type="xs:boolean">false</Value>
                     <Value xsi:type="xs:boolean">false</Value>
                     <Value xsi:type="xs:boolean">false</Value>
                     <Value xsi:type="xs:boolean">false</Value>
                     <Value xsi:type="xs:boolean">false</Value>
                     <Value xsi:type="xs:decimal">30</Value>
                     <Value xsi:type="xs:decimal">60</Value>
                     <Value xsi:type="xs:decimal">15</Value>
                     <Value xsi:type="xs:decimal">7200</Value>
                     <Value xsi:type="xs:boolean">true</Value>
                     <Value xsi:type="Structure">
                        <Property name="AvailableOnMonday">
                           <Value xsi:type="xs:boolean">true</Value>
                        </Property>
                        <Property name="AvailableOnTuesday">
                           <Value xsi:type="xs:boolean">true</Value>
                        </Property>
                        <Property name="AvailableOnWednesday">
                           <Value xsi:type="xs:boolean">true</Value>
                        </Property>
                        <Property name="AvailableOnThursday">
                           <Value xsi:type="xs:boolean">true</Value>
                        </Property>
                        <Property name="AvailableOnFriday">
                           <Value xsi:type="xs:boolean">true</Value>
                        </Property>
                        <Property name="AvailableOnSaturday">
                           <Value xsi:type="xs:boolean">false</Value>
                        </Property>
                        <Property name="AvailableOnSunday">
                           <Value xsi:type="xs:boolean">false</Value>
                        </Property>
                        <Property name="StartTime">
                           <Value xsi:type="xs:dateTime">0001-01-01T09:00:00</Value>
                        </Property>
                        <Property name="EndTime">
                           <Value xsi:type="xs:dateTime">0001-01-01T18:00:00</Value>
                        </Property>
                     </Value>
                     <Value xsi:type="xs:string">NO_PRIORITY</Value>
                     <Value xsi:type="xs:decimal">3</Value>
                     <Value xsi:type="xs:boolean">false</Value>
                     <Value xsi:type="xs:boolean">true</Value>
                     <Value xsi:type="xs:boolean">false</Value>
                     <Value xsi:type="xs:string">FOR_MY_CUSTOMERS</Value>
                     <Value xsi:type="xs:boolean">false</Value>
                     <Value xsi:type="xs:boolean">true</Value>
                     <Value xsi:type="xs:boolean">true</Value>
                     <Value xsi:type="xs:decimal">3</Value>
                     <Value xsi:type="xs:boolean">false</Value>
                     <Value xsi:type="xs:decimal">10</Value>
                  </row>
               </Value>
            </Property>
         </m:return>
      </m:ServiceLineKindReadResponse>
   </soap:Body>
</soap:Envelope>