Last modified by Дмитрий Семёнов on 2024/01/11 12:31
From version < 5.1
edited by Дмитрий Семёнов
on 2024/01/11 12:31
To version 1.1 >
edited by Дмитрий Семёнов
on 2023/12/20 10:30
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://care.ellpa.ru:84/]]) предусмотреть новую функцию, предусматривающую создание ремонта из системы информационного центра. В качестве входной информации возможны следующие поля:
12 +Необходимо в публичном API портала ([[http:~~/~~/cc.tpvrussia.ru:84/>>http://cc.tpvrussia.ru:84/]]) предусмотреть новую функцию, предусматривающую создание ремонта из системы информационного центра. В качестве входной информации возможны следующие поля:
13 13  
14 14  1. Имя (текст, 50 символов)
15 15  1. Фамилия (текст, 50 символов)
... ... @@ -59,95 +59,40 @@
59 59  1. Настройка по примеру шаблонов АНРП/АТО с указанием текста или "кода поля" для каждого поля и его названия (чтобы можно было самостоятельно добавлять форму на разных языках)
60 60  1. Сделать шаблон по аналогии как давноо  делали генерацию договоров по шаблону в RTF, если не ошибаюсь.
61 61  
62 -= 4. API desdcription =
62 += 4. Описание перечня работ =
63 63  
64 +== 4.1. Автоматизация создания ремонта из системы информационного центра ==
64 64  
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 += API method //CreateTrackingCallCentr// =
66 66  
67 -== 4.1. //GetTicket// ==
68 +Input parameters:
68 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 -
82 -== 4.2. API method //CreateTrackingCallCentr// ==
83 -
84 -=== Input parameters: ===
85 -
86 86  |Name|(% style="width:116px" %)Тype|(% style="width:60px" %)Mandatory.|Parameter description
87 87  |ticket|(% style="width:116px" %)**string**|(% style="width:60px" %)Yes|Authentication session key
88 -|record|(% style="width:116px" %)**record**|(% style="width:60px" %)Yes|Structure with information to create order
72 +|record|(% style="width:116px" %)**record**|(% style="width:60px" %)Да|Structure with information to create order
89 89  |(% colspan="4" %)//**Record **//structure
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|(((
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" %)Нет|(((
95 95  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//"
96 96  )))
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
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
111 111  
112 -=== Output parameters:: ===
113 -
114 -|Name|Type|Description|Example
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]].|
116 -|SysNum|**string**|Tracking identifer|ET0123456
117 -|StatusName|**string**|Tracking status|
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]].|
119 -|Result|**Added** or **Changed** or **NotFound** or **Error** or **Unknown**|(((
120 -Operation result:
121 -
122 -Added – claim added in the database
123 -
124 -Changed – claim changed
125 -
126 -NotFound – Claim no found by GUID
127 -
128 -Error – Method fault
129 -
130 -Unknown – Unknown error
131 -)))|Added
132 -|TrackingUri|**string**|URL to the claim which could be opened in browser|
133 -|Errors|list of string|List of errors with error description|
134 -|ValidationErrors| | |
135 -
136 -=== Validation errors ===
137 -
138 -|Name|Type|Description|Example
139 -|ErrorCode|**string**|Error code|
140 -|ErrorLevel|**int**|(((
141 -Error level:
142 -
143 -1 – crytical
144 -
145 -3 – notification.
146 -)))|
147 -|Status|**string**|Claim status|
148 -|Descriptilon|**string**|Error description
149 -)))
150 -
151 151  (% class="col-xs-12 col-sm-4" %)
152 152  (((
153 153  {{box title="**Содержание**"}}