Last modified by Дмитрий Семёнов on 2024/01/11 12:31
From version < 3.1 >
edited by Дмитрий Семёнов
on 2023/12/20 10:43
To version < 5.1
edited by Дмитрий Семёнов
on 2024/01/11 12:31
<
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -9,7 +9,7 @@
9 9  
10 10  = 1. Автоматизация создания ремонта из системы информационного центра =
11 11  
12 -Необходимо в публичном API портала ([[http:~~/~~/cc.tpvrussia.ru:84/>>http://cc.tpvrussia.ru:84/]]) предусмотреть новую функцию, предусматривающую создание ремонта из системы информационного центра. В качестве входной информации возможны следующие поля:
12 +Необходимо в публичном API портала ([[http:~~/~~/cc.tpvrussia.ru:84/>>http://care.ellpa.ru:84/]]) предусмотреть новую функцию, предусматривающую создание ремонта из системы информационного центра. В качестве входной информации возможны следующие поля:
13 13  
14 14  1. Имя (текст, 50 символов)
15 15  1. Фамилия (текст, 50 символов)
... ... @@ -59,10 +59,26 @@
59 59  1. Настройка по примеру шаблонов АНРП/АТО с указанием текста или "кода поля" для каждого поля и его названия (чтобы можно было самостоятельно добавлять форму на разных языках)
60 60  1. Сделать шаблон по аналогии как давноо  делали генерацию договоров по шаблону в RTF, если не ошибаюсь.
61 61  
62 -= 4. API desdcription =
62 += 4. API desdcription =
63 63  
64 -== 4.1. GetTicket ==
65 65  
65 +List of available API functions are listed [[here>>url:http://care.ellpa.ru:84/TrackingExchangeSoap.asmx?wsdl]] (functions list is in Russian since till now only local service centers have been using it). And there is [[WSDL scheme>>url:http://care.ellpa.ru:84/TrackingExchangeSoap.asmx?wsdl]] as well. To create claim by call center~,~, need two main functions listed below.
66 +
67 +== 4.1. //GetTicket// ==
68 +
69 +Method returns binary ticket to be used for authentication
70 +
71 +=== Input parameters ===
72 +
73 +
74 +1. Login (string)
75 +1. Password (string)
76 +
77 +=== Output parameters ===
78 +
79 +1. Ticket (string)
80 +1. Version (string)
81 +
66 66  == 4.2. API method //CreateTrackingCallCentr// ==
67 67  
68 68  === Input parameters: ===
... ... @@ -69,37 +69,37 @@
69 69  
70 70  |Name|(% style="width:116px" %)Тype|(% style="width:60px" %)Mandatory.|Parameter description
71 71  |ticket|(% style="width:116px" %)**string**|(% style="width:60px" %)Yes|Authentication session key
72 -|record|(% style="width:116px" %)**record**|(% style="width:60px" %)Да|Structure with information to create order
88 +|record|(% style="width:116px" %)**record**|(% style="width:60px" %)Yes|Structure with information to create order
73 73  |(% colspan="4" %)//**Record **//structure
74 -|Model|(% style="width:116px" %)**string (50)**|(% style="width:60px" %)Да|String with model CTN (e.g. //49PUS7101/60//)
75 -|OrderNumBrand|(% style="width:116px" %)**string (50)**|(% style="width:60px" %)Да|CRM+ claim identifer
76 -|SerialNumb|(% style="width:116px" %)**string (50)**|(% style="width:60px" %)Нет|Serial number
77 -|DesRepair|(% style="width:116px" %)**string (3000)**|(% style="width:60px" %)Нет|Fault description
78 -|RepairTypeUid|(% style="width:116px" %)**guid**|(% style="width:60px" %)Нет|(((
90 +|Model|(% style="width:116px" %)**string (50)**|(% style="width:60px" %)Yes|String with model CTN (e.g. //49PUS7101/60//)
91 +|OrderNumBrand|(% style="width:116px" %)**string (50)**|(% style="width:60px" %)Yes|CRM+ claim identifer
92 +|SerialNumb|(% style="width:116px" %)**string (50)**|(% style="width:60px" %)No|Serial number
93 +|DesRepair|(% style="width:116px" %)**string (3000)**|(% style="width:60px" %)No|Fault description
94 +|RepairTypeUid|(% style="width:116px" %)**guid**|(% style="width:60px" %)No|(((
79 79  Repair type. Value is taken from method GetSpRepairTypes. It couldbe omitted, in that case used value for //"Client's IW repair"// with guid "//a2ecf1a0-f3db-4cb9-85b5-3caad9228edc//"
80 80  )))
81 -|BrandUid|(% style="width:116px" %)**guid**|(% style="width:60px" %)Да|Brand GUID. Could be get from method [[GetBrands>>path:#_heading=h.1s4cna7gwqf1]]. For "Philips TV" it is "//ac8c0cf9-8f56-4349-9c2f-cfebdc60abad//"
82 -|CountryServiceCenter|(% style="width:116px" %)**string (2)**|(% style="width:60px" %)Нет|Service center country in ALFA-2 notation. RU for Russia. If not found, then call center user countru would be iused.
83 -|CityServiceCenter|(% style="width:116px" %)**string (255)**|(% style="width:60px" %)Нет|City of the service center to be assigned for repair. System will try to find city by country and it's name in Russian. If city was found, try to assign service center by brand. If it's unique in the city, then this ASC would be assigned. If not found, then service center remains empty and agent would need to manually select it.  
84 -|CName|(% style="width:116px" %)**string (255)**|(% style="width:60px" %)Нет|Client's first name
85 -|CSurname|(% style="width:116px" %)**string (255)**|(% style="width:60px" %)Нет|Client's last name
86 -|CPatronymic|(% style="width:116px" %)**string (255)**|(% style="width:60px" %)Нет|Client's middle name
87 -|CCity|(% style="width:116px" %)**string (255)**|(% style="width:60px" %)Нет|City of the client (could be different from service center's name)
88 -|CAddress|(% style="width:116px" %)**string (255)**|(% style="width:60px" %)Нет|Client's address
89 -|CHouse|(% style="width:116px" %)**string (5)**|(% style="width:60px" %)Нет|House number
90 -|CBuild|(% style="width:116px" %)**string (5)**|(% style="width:60px" %)Нет|Building number
91 -|CFlat|(% style="width:116px" %)**string (5)**|(% style="width:60px" %)Нет|Flat number
92 -|CMobTel|(% style="width:116px" %)**string (15)**|(% style="width:60px" %)Нет|Phone number (7xxxxxxxxxx)
93 -|Cemail|(% style="width:116px" %)**string (255)**|(% style="width:60px" %)Нет|Client's e-mail
94 -|UrlQuestionnaire|(% style="width:116px" %)**string**|(% style="width:60px" %)Нет|URL to NPS survey which would be provided to the client after it has been finished
97 +|BrandUid|(% style="width:116px" %)**guid**|(% style="width:60px" %)No|Brand GUID. Could be get from method [[GetBrands>>path:#_heading=h.1s4cna7gwqf1]]. For "Philips TV" it is "//ac8c0cf9-8f56-4349-9c2f-cfebdc60abad//"
98 +|CountryServiceCenter|(% style="width:116px" %)**string (2)**|(% style="width:60px" %)No|Service center country in ALFA-2 notation. RU for Russia. If not found, then call center user countru would be iused.
99 +|CityServiceCenter|(% style="width:116px" %)**string (255)**|(% style="width:60px" %)No|City of the service center to be assigned for repair. System will try to find city by country and it's name in Russian. If city was found, try to assign service center by brand. If it's unique in the city, then this ASC would be assigned. If not found, then service center remains empty and agent would need to manually select it.  
100 +|CName|(% style="width:116px" %)**string (255)**|(% style="width:60px" %)No|Client's first name
101 +|CSurname|(% style="width:116px" %)**string (255)**|(% style="width:60px" %)No|Client's last name
102 +|CPatronymic|(% style="width:116px" %)**string (255)**|(% style="width:60px" %)No|Client's middle name
103 +|CCity|(% style="width:116px" %)**string (255)**|(% style="width:60px" %)No|City of the client (could be different from service center's name)
104 +|CAddress|(% style="width:116px" %)**string (255)**|(% style="width:60px" %)No|Client's address
105 +|CHouse|(% style="width:116px" %)**string (5)**|(% style="width:60px" %)No|House number
106 +|CBuild|(% style="width:116px" %)**string (5)**|(% style="width:60px" %)No|Building number
107 +|CFlat|(% style="width:116px" %)**string (5)**|(% style="width:60px" %)No|Flat number
108 +|CMobTel|(% style="width:116px" %)**string (15)**|(% style="width:60px" %)No|Phone number (7xxxxxxxxxx)
109 +|Cemail|(% style="width:116px" %)**string (255)**|(% style="width:60px" %)No|Client's e-mail
110 +|UrlQuestionnaire|(% style="width:116px" %)**string**|(% style="width:60px" %)No|URL to NPS survey which would be provided to the client after it has been finished
95 95  
96 96  === Output parameters:: ===
97 97  
98 98  |Name|Type|Description|Example
99 -|TrackingUid|**guid**|Unique claim identifer. Could be used to update data by using method [[SaveTracking>>url:http://wiki.cc.tpvrussia.ru:8080/bin/view/Sandbox/%D0%94%D0%BE%D0%BA%D1%83%D0%BC%D0%B5%D0%BD%D1%82%20%D1%81%20%D0%B7%D0%B0%D0%BA%D0%BB%D1%8E%D1%87%D0%B5%D0%BD%D0%B8%D0%B5%D0%BC%20%D0%BF%D0%BE%20%D0%B2%D1%8B%D0%BF%D0%BE%D0%BB%D0%BD%D0%B5%D0%BD%D0%BD%D0%BE%D0%BC%D1%83%20%D1%80%D0%B5%D0%BC%D0%BE%D0%BD%D1%82%D1%83%20%D0%B8%20%D0%B8%D0%BD%D1%82%D0%B5%D0%B3%D1%80%D0%B0%D1%86%D0%B8%D0%B5%D0%B9%20%D1%81%20%D1%81%D0%B8%D1%81%D1%82%D0%B5%D0%BC%D0%BE%D0%B9%20%D0%98%D0%A6/#_heading=h.l7e46hz5zu9z]].|
115 +|TrackingUid|**guid**|Unique claim identifer. Could be used to update data by using method [[SaveTracking>>url:http://wiki.ellpa.ru/bin/view/Sandbox/%D0%94%D0%BE%D0%BA%D1%83%D0%BC%D0%B5%D0%BD%D1%82%20%D1%81%20%D0%B7%D0%B0%D0%BA%D0%BB%D1%8E%D1%87%D0%B5%D0%BD%D0%B8%D0%B5%D0%BC%20%D0%BF%D0%BE%20%D0%B2%D1%8B%D0%BF%D0%BE%D0%BB%D0%BD%D0%B5%D0%BD%D0%BD%D0%BE%D0%BC%D1%83%20%D1%80%D0%B5%D0%BC%D0%BE%D0%BD%D1%82%D1%83%20%D0%B8%20%D0%B8%D0%BD%D1%82%D0%B5%D0%B3%D1%80%D0%B0%D1%86%D0%B8%D0%B5%D0%B9%20%D1%81%20%D1%81%D0%B8%D1%81%D1%82%D0%B5%D0%BC%D0%BE%D0%B9%20%D0%98%D0%A6/#_heading=h.l7e46hz5zu9z]].|
100 100  |SysNum|**string**|Tracking identifer|ET0123456
101 101  |StatusName|**string**|Tracking status|
102 -|StatusUid|**guid**|Tracking status GUID. Value could be obtained by using method [[GetStatuses>>url:http://wiki.cc.tpvrussia.ru:8080/bin/view/Sandbox/%D0%94%D0%BE%D0%BA%D1%83%D0%BC%D0%B5%D0%BD%D1%82%20%D1%81%20%D0%B7%D0%B0%D0%BA%D0%BB%D1%8E%D1%87%D0%B5%D0%BD%D0%B8%D0%B5%D0%BC%20%D0%BF%D0%BE%20%D0%B2%D1%8B%D0%BF%D0%BE%D0%BB%D0%BD%D0%B5%D0%BD%D0%BD%D0%BE%D0%BC%D1%83%20%D1%80%D0%B5%D0%BC%D0%BE%D0%BD%D1%82%D1%83%20%D0%B8%20%D0%B8%D0%BD%D1%82%D0%B5%D0%B3%D1%80%D0%B0%D1%86%D0%B8%D0%B5%D0%B9%20%D1%81%20%D1%81%D0%B8%D1%81%D1%82%D0%B5%D0%BC%D0%BE%D0%B9%20%D0%98%D0%A6/#_heading=h.h5onyu1z1pfy]].|
118 +|StatusUid|**guid**|Tracking status GUID. Value could be obtained by using method [[GetStatuses>>url:http://wiki.ellpa.ru/bin/view/Sandbox/%D0%94%D0%BE%D0%BA%D1%83%D0%BC%D0%B5%D0%BD%D1%82%20%D1%81%20%D0%B7%D0%B0%D0%BA%D0%BB%D1%8E%D1%87%D0%B5%D0%BD%D0%B8%D0%B5%D0%BC%20%D0%BF%D0%BE%20%D0%B2%D1%8B%D0%BF%D0%BE%D0%BB%D0%BD%D0%B5%D0%BD%D0%BD%D0%BE%D0%BC%D1%83%20%D1%80%D0%B5%D0%BC%D0%BE%D0%BD%D1%82%D1%83%20%D0%B8%20%D0%B8%D0%BD%D1%82%D0%B5%D0%B3%D1%80%D0%B0%D1%86%D0%B8%D0%B5%D0%B9%20%D1%81%20%D1%81%D0%B8%D1%81%D1%82%D0%B5%D0%BC%D0%BE%D0%B9%20%D0%98%D0%A6/#_heading=h.h5onyu1z1pfy]].|
103 103  |Result|**Added** or **Changed** or **NotFound** or **Error** or **Unknown**|(((
104 104  Operation result:
105 105  
... ... @@ -121,7 +121,13 @@
121 121  
122 122  |Name|Type|Description|Example
123 123  |ErrorCode|**string**|Error code|
124 -|ErrorLevel|**int**|Error level: 1 — crytical, 3 — notification.|
140 +|ErrorLevel|**int**|(((
141 +Error level:
142 +
143 +1 – crytical
144 +
145 +3 – notification.
146 +)))|
125 125  |Status|**string**|Claim status|
126 126  |Descriptilon|**string**|Error description
127 127  )))