Редактировал(а) Григорий Лепёшкин 2023/11/30 16:55
Последние авторы
1 (% class="row" %)
2 (((
3 (% class="col-xs-12 col-sm-8" %)
4 (((
5 (% class="box floatinginfobox" id="H41243243543443543D438435" %)
6 (((
7 Задача, которая объединяет два связанных между собой функционала: автоматизация создания заявки на ремонт из системы информационного центра (Sales Force) и выдача клиенту документа с заключением о выполненных работах вместе с отремонтированным аппаратом или АНРП.
8 )))
9
10 = 1. Автоматизация создания ремонта из системы информационного центра =
11
12 Необходимо в публичном API портала ([[http:~~/~~/cc.tpvrussia.ru:84/>>http://care.ellpa.ru:84/]]) предусмотреть новую функцию, предусматривающую создание ремонта из системы информационного центра. В качестве входной информации возможны следующие поля:
13
14 1. Имя (текст, 50 символов)
15 1. Фамилия (текст, 50 символов)
16 1. Отчество (текст, 50 символов)
17 1. Номер телефона (текст, 50 символов, обязательное)
18 1. Адрес почты (текст, 50 символов)
19 1. Страна (текст, 50 символов)
20 1. Город (текст, 50 символов)
21 1. Улица клиента (текст, 50 символов)
22 1. Номер дома (текст, 50 символов)
23 1. Квартира (текст, 50 символов)
24 1. Бренд аппарата (текст, 50 символов)
25 1. Модель (текст, 50 символов,**Обязательное поле**)
26 1. Серийный номер (текст, 50 символов)
27 1. Описание неисправности (текст, 255 символов)
28 1. Номер заявки ИЦ (текст, 50 символов, обязательно)
29 1. URL на анкету для прохождения опроса по завершению ремонта (текст, 50 символов). Ссылка для Philips имеет вид [[https:~~/~~/survey.medallia.com/?TPVConsumerCareQR&job_number=123&country=18&lang=en>>url:https://survey.medallia.com/?TPVConsumerCareQR&job_number=123&country=18&lang=en||style="background-color: rgb(255, 255, 255);"]]. Здесь **Job number** идентификатор обращения в системе ИЦ, **Сountry **- код страны (26 для РФ), **language** код языка анкеты (ru для русского). Для других брендов может иметь другой вид. Возможно в будущем реализуем свою систему опроса потребителей и этот URL будем генерировать самостоятельно.
30
31 Все поля необязательные, кроме номера телефона с проверкой по минимальной длине10 символов и номера заявки ИЦ.
32
33 При создании ремонта нужно подобрать переданные страну, город, бренд и модель. Если не получается - оставить пустым. Если эти четыре поля подобрать удалось, проверить количество АСЦ, авторизованных по этому бренду в городе. Если такой АСЦ ровно один - назначить ремонт на него.
34
35 В ответ на запрос нужно вернуть URL созданного ремонта чтобы ИЦ мог его открыть, проверить выбор города, бренда, АСЦ и модели и внести изменения вручную при необходимости.
36
37 К трекингу нужно добавить поле с URL анкеты, которая невидна никому кроме NSO TPV, которые её ещё и редактировать смогут (при острой необходимости).
38
39 = 2. Выдача клиенту документа с заключением о выполненных работах =
40
41 После завершения ремонта, клиенту должен быть выдан документ с заключением о выполненных работах (см. следующий раздел). Это требование нужно пока для нескольких АСЦ в РФ (Орбис и ИРП), поэтому считаю что нужна настройка, требующая от АСЦ это сделать: по аналогии с тарифами на транспортировку - добавить такой флаг в настроечные коэффициенты стран и возможность индивидуального пересмотра в карточке авторизации АСЦ. С возможностью импорта и экспорта.
42
43 Для тех АСЦ, у которых это требование обязательно - они должны будут хотя бы один раз скачать этот документ, иначе должна возникнуть ошибка. Проерка деляается по счётчику нажатия на кнопку печати документа сотрудником АСЦ, выполняющим ремонт. Предлагаю сделать через механизм правил проверки, которое проверят что число нажатий больше нуля..
44
45 Хотелось бы чтобы этот документ отображался на видном месте, например, рядом с иконкой статуса "Ремонт завершён". Если это сложно, можем обсудить где лучше.
46
47 Наличие или отсутствие такого документа определяется есть ли настроенный шаблон такого документа для комбинации страна и бренд. Если такой шаблон есть, но в 1С нет требования его печати - то АСЦ могут его распечатать, но это опционально.
48
49 = 3. Механизм настройки шаблона документа =
50
51 == 3.1 Шаблон Philips ==
52
53 По аналогии с механизмом настройки шаблонов АНРП и АТО нужна возможность их настройки (выбора) для каждого бренда и страны. Сейчас нужно сделать под требования Philips: шаблон простой и включает приветственный текст для клиента и QR-код со ссылкой на прохождение опроса из пункта 1.16. Шаблон документа есть [[по ссылке >>https://docs.google.com/document/d/1123rUYfhZqLb92w9R-h3B1jvKrOac5ZayHmv1ST4wEk/edit?usp=sharing]](только первая страница)
54
55 == 3.2 Шаблон Ellpa ==
56
57 В дальнейшем планируем выдавать подобный документ всем клиентам Эллпа и Эллпа Трейд, но хотелось бы иметь возможность гибкой настройки шаблона для разных брендов. Во вложении пример макета. Пока вижу два варианта:
58
59 1. Настройка по примеру шаблонов АНРП/АТО с указанием текста или "кода поля" для каждого поля и его названия (чтобы можно было самостоятельно добавлять форму на разных языках)
60 1. Сделать шаблон по аналогии как давноо  делали генерацию договоров по шаблону в RTF, если не ошибаюсь.
61
62
63 = 4. Описание перечня работ =
64
65 == 4.1. Автоматизация создания ремонта из системы информационного центра ==
66
67 = Создается метод CreateTrackingCallCentr =
68
69 Входные параметры:
70
71 |Название параметра|Тип параметра|Обяз.|Описание параметра
72 |ticket|**string**|Да|Сессионный ключ
73 |record|**record**|Да|структура содержащая данные
74 |(% colspan="4" %)**Структура Record**
75 |Model|**string (50)**|Да|Строка названия модели
76 |OrderNumBrand|**string (50)**|Да|Номер заявки колл-центра
77 |SerialNumb|**string (50)**|Нет|Серийный номер
78 |DesRepair|**string (3000)**|Нет|Заявленная неисправность
79 |RepairTypeUid|**guid**|Нет|(((
80 Тип ремонта  (связь с брендами (Default)). Значение берется из метода GetSpRepairTypes. Если не заполнено, то подставится «Клиентский гарантийный».
81
82
83 )))
84 |BrandUid|**guid**|Да|Бренд (торговая марка). Значение берётся из [[GetBrands>>path:#_heading=h.1s4cna7gwqf1]].BrandUid
85 |CountryServiceCenter|**string (2)**|Нет|Стана АСЦ. Указывается страна в виде кода ALFA-2. Если страна найдена, то город будет сопоставляться с городами этой страны, иначе со страной пользователя колл-центра.
86 |CityServiceCenter|**string (255)**|Нет|Город АСЦ. Город будет подбираться по тексту и стране. Если город найден, то по городу и бренду будет осуществляться поиск АСЦ. Если найден единственный АСЦ, то подставляется он иначе, если не единственный или если город не найден, то берется город пользователя колл-центра и в качестве АСЦ указывается пусто. Далее при редактировании данного трекинга, его сохранить с пустым АСЦ не возможно.
87 |CName|**string (255)**|Нет|Имя клиента
88 |CSurname|**string (255)**|Нет|Фамилия клиента
89 |CPatronymic|**string (255)**|Нет|Отчество клиента
90 |CCity|**string (255)**|Нет|Город клиента
91 |CAddress|**string (255)**|Нет|Адрес клиента
92 |CHouse|**string (5)**|Нет|Номер дома клиента
93 |CBuild|**string (5)**|Нет|Корпус дома клиента
94 |CFlat|**string (5)**|Нет|Номер квартиры клиента
95 |CMobTel|**string (15)**|Нет|Мобильный телефон клиента
96 |Cemail|**string (255)**|Нет|Email клиента
97 |UrlQuestionnaire|**string**|Нет|URL на анкету для прохождения опроса по завершению ремонта
98
99 Выходные параметры:
100
101 |Название параметра|Тип параметра|Описание параметра|Пример
102 |TrackingUid|**guid**|Уникальный идентификатор трекинга. Значение можно использовать для дальнейших вызовов метода [[SaveTracking>>path:#_heading=h.l7e46hz5zu9z]], если нужно обновить значения трекинга.|
103 |SysNum|**string**|Системный номер трекинга (учётный номер ремонта в системе)|
104 |StatusName|**string**|Статус трекинга|
105 |StatusUid|**guid**|UID статуса трекинга. Значение берётся из [[GetStatuses>>path:#_heading=h.h5onyu1z1pfy]].|
106 |Result|**Added** or **Changed** or **NotFound** or **Error** or **Unknown**|(((
107 Результат выполнения операции:
108
109 Added – трекинг создан и помещён в базу
110
111 Changed – трекинг изменён
112
113 NotFound – трекинг не найден по uid
114
115 Error – ошибка в работе метода
116
117 Unknown – неизвестная ошибка
118 )))|Added
119 |TrackingUri|**string**|Ссылка на трекинг, которую можно открыть в браузере|
120
121 Секция Errors содержит коллекцию строк ошибок.
122
123 Секция ValidationErrors содержит коллекцию ErrorItem следующего вида:
124
125 |Название параметра|Тип параметра|Описание параметра|Пример
126 |ErrorCode|**string**|Код ошибки|
127 |ErrorLevel|**int**|Уровень ошибки: 1-критичная, 3-предупреждение.|
128 |Status|**string**|Статус трекинга|
129 |Descriptilon|**string**|Описание ошибки|
130
131 Добавляем в структуру трекинга и на форму трекинга новое поле Url анкеты.
132
133 Данное поле доступно только NSO TPV.
134
135 == 4.2. Механизм настройки шаблона для результата работ. ==
136
137 Может быть реализован один из двух способов:
138
139 === 4.2.1. Настройка шаблона на подобии как это реализовано в шаблонах АНРП. ===
140
141 Создается отдельный макет формы с зонами, которые могут заполняться из формы редактирования  и форма редактирования с возможностью подставлять спец символы.
142
143 В том числе с указанием текста для названия поля табличной части.
144
145 Данная настройка осуществляется для бренда и страны
146
147 Минус данного способа в том, что при появлении нового макета, необходимо делать доработку и создавать тип шаблона с самим шаблоном
148
149 === 4.2.2. Настройка шаблонов с помощью программы редактирования файла rtf. ===
150
151 Перерабатывается существующая программа для редактирования файла rtf.
152
153 работа программы будет заключаться в том, чтобы в любой файл rtf можно было добавить спец поля и сохранить данный файл.
154
155 На сайте создается раздел с шаблонами результата работ.
156
157 Это просто перечень сохраненных файлов rtf с наименованием шаблона, описанием. С возможностью скачать и закачать новый.
158
159 Так же в данном разделе можно будет скачать саму программу для редактирования шаблонов и скачивания списка спец полей.
160
161 Далее делается настройка шаблонов, где для бренда и страны выбирается какой шаблон должен выводится в трекинге.
162
163 Так как у RTF нет отдельного понятия QR-код, а только изображение. то основная сложность это обработка спецполя с QR-кодом в программе по редактированию шаблонов.
164
165 == 4.3. Выдача клиенту документа с заключением о выполненных работах ==
166
167
168 В 1С в карточке контрагента и в справочнике настроечных коэффициентов стран добавляется новый признак "Печать заключения при завершении трекинга". Значение Да/Нет.
169
170 После перевода трекинга в статус "Ремонт завершен" и если у страны АСЦ и бренда или у авторизации АСЦ по бренду признак "Печать заключения при завершении трекинга" равен "Да" и есть шаблон для бренда и страны, то выводится кнопка "Заключение о выполненных работах".
171
172 Данное заключение выводится под номером ремонта АСЦ.
173
174 **Возможно условием вывода должны быть и определенные типы ремонтов.**
175
176 По кнопке заполняется и выводится шаблон и проставляется признак, что шаблон распечатан, если на кнопку печати нажимал сотрудник АСЦ.
177
178 При переводе в статус "Отчет" добавляется проверка, если у страны АСЦ и бренда или у авторизации АСЦ по бренду признак "Печать заключения при завершении трекинга" равен "Да" и есть шаблон для бренда и страны и признак что шаблон распечатывался АСЦ не установлен, то ошибка "Нельзя перевести ремонт в отчет, пока не распечатано заключение о выполненных работах сотрудником АСЦ"
179
180
181
182
183 )))
184
185 (% class="col-xs-12 col-sm-4" %)
186 (((
187 {{box title="**Содержание**"}}
188 {{toc/}}
189 {{/box}}
190 )))
191 )))