Исходный код вики Документ с заключением по выполненному ремонту и интеграцией с системой ИЦ

Редактировал(а) Григорий Лепёшкин 2023/11/30 16:55

version	line-number	content
1.1	1	(% class="row" %)
	2	(((
	3	(% class="col-xs-12 col-sm-8" %)
	4	(((
4.1	5	(% class="box floatinginfobox" id="H41243243543443543D438435" %)
	6	(((
1.1	7	Задача, которая объединяет два связанных между собой функционала: автоматизация создания заявки на ремонт из системы информационного центра (Sales Force) и выдача клиенту документа с заключением о выполненных работах вместе с отремонтированным аппаратом или АНРП.
4.1	8	)))
1.1	9
3.1	10	= 1. Автоматизация создания ремонта из системы информационного центра =
1.1	11
11.1	12	Необходимо в публичном API портала ([[http:~~/~~/cc.tpvrussia.ru:84/>>http://care.ellpa.ru:84/]]) предусмотреть новую функцию, предусматривающую создание ремонта из системы информационного центра. В качестве входной информации возможны следующие поля:
1.1	13
1.2	14	1. Имя (текст, 50 символов)
	15	1. Фамилия (текст, 50 символов)
	16	1. Отчество (текст, 50 символов)
	17	1. Номер телефона (текст, 50 символов, обязательное)
	18	1. Адрес почты (текст, 50 символов)
1.3	19	1. Страна (текст, 50 символов)
1.2	20	1. Город (текст, 50 символов)
9.2	21	1. Улица клиента (текст, 50 символов)
1.2	22	1. Номер дома (текст, 50 символов)
	23	1. Квартира (текст, 50 символов)
	24	1. Бренд аппарата (текст, 50 символов)
11.1	25	1. Модель (текст, 50 символов,Обязательное поле)
1.3	26	1. Серийный номер (текст, 50 символов)
1.2	27	1. Описание неисправности (текст, 255 символов)
9.2	28	1. Номер заявки ИЦ (текст, 50 символов, обязательно)
5.3	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 будем генерировать самостоятельно.
1.2	30
9.2	31	Все поля необязательные, кроме номера телефона с проверкой по минимальной длине10 символов и номера заявки ИЦ.
1.3	32
	33	При создании ремонта нужно подобрать переданные страну, город, бренд и модель. Если не получается - оставить пустым. Если эти четыре поля подобрать удалось, проверить количество АСЦ, авторизованных по этому бренду в городе. Если такой АСЦ ровно один - назначить ремонт на него.
	34
	35	В ответ на запрос нужно вернуть URL созданного ремонта чтобы ИЦ мог его открыть, проверить выбор города, бренда, АСЦ и модели и внести изменения вручную при необходимости.
3.1	36
	37	К трекингу нужно добавить поле с URL анкеты, которая невидна никому кроме NSO TPV, которые её ещё и редактировать смогут (при острой необходимости).
5.1	38
5.2	39	= 2. Выдача клиенту документа с заключением о выполненных работах =
	40
	41	После завершения ремонта, клиенту должен быть выдан документ с заключением о выполненных работах (см. следующий раздел). Это требование нужно пока для нескольких АСЦ в РФ (Орбис и ИРП), поэтому считаю что нужна настройка, требующая от АСЦ это сделать: по аналогии с тарифами на транспортировку - добавить такой флаг в настроечные коэффициенты стран и возможность индивидуального пересмотра в карточке авторизации АСЦ. С возможностью импорта и экспорта.
	42
9.3	43	Для тех АСЦ, у которых это требование обязательно - они должны будут хотя бы один раз скачать этот документ, иначе должна возникнуть ошибка. Проерка деляается по счётчику нажатия на кнопку печати документа сотрудником АСЦ, выполняющим ремонт. Предлагаю сделать через механизм правил проверки, которое проверят что число нажатий больше нуля..
5.2	44
	45	Хотелось бы чтобы этот документ отображался на видном месте, например, рядом с иконкой статуса "Ремонт завершён". Если это сложно, можем обсудить где лучше.
	46
5.3	47	Наличие или отсутствие такого документа определяется есть ли настроенный шаблон такого документа для комбинации страна и бренд. Если такой шаблон есть, но в 1С нет требования его печати - то АСЦ могут его распечатать, но это опционально.
5.2	48
5.3	49	= 3. Механизм настройки шаблона документа =
	50
	51	== 3.1 Шаблон Philips ==
	52
6.1	53	По аналогии с механизмом настройки шаблонов АНРП и АТО нужна возможность их настройки (выбора) для каждого бренда и страны. Сейчас нужно сделать под требования Philips: шаблон простой и включает приветственный текст для клиента и QR-код со ссылкой на прохождение опроса из пункта 1.16. Шаблон документа есть [[по ссылке >>https://docs.google.com/document/d/1123rUYfhZqLb92w9R-h3B1jvKrOac5ZayHmv1ST4wEk/edit?usp=sharing]](только первая страница)
5.3	54
	55	== 3.2 Шаблон Ellpa ==
6.2	56
9.1	57	В дальнейшем планируем выдавать подобный документ всем клиентам Эллпа и Эллпа Трейд, но хотелось бы иметь возможность гибкой настройки шаблона для разных брендов. Во вложении пример макета. Пока вижу два варианта:
	58
	59	1. Настройка по примеру шаблонов АНРП/АТО с указанием текста или "кода поля" для каждого поля и его названия (чтобы можно было самостоятельно добавлять форму на разных языках)
	60	1. Сделать шаблон по аналогии как давноо делали генерацию договоров по шаблону в RTF, если не ошибаюсь.
11.1	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
1.1	83	)))
11.1	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 на анкету для прохождения опроса по завершению ремонта
1.1	98
11.1	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
1.1	185	(% class="col-xs-12 col-sm-4" %)
	186	(((
	187	{{box title="Содержание"}}
	188	{{toc/}}
	189	{{/box}}
	190	)))
	191	)))

Исходный код вики Документ с заключением по выполненному ремонту и интеграцией с системой ИЦ

Приложения

Навигация