Документ с заключением по выполненному ремонту и интеграцией с системой ИЦ
Задача, которая объединяет два связанных между собой функционала: автоматизация создания заявки на ремонт из системы информационного центра (Sales Force) и выдача клиенту документа с заключением о выполненных работах вместе с отремонтированным аппаратом или АНРП.
1. Автоматизация создания ремонта из системы информационного центра
Необходимо в публичном API портала (http://cc.tpvrussia.ru:84/) предусмотреть новую функцию, предусматривающую создание ремонта из системы информационного центра. В качестве входной информации возможны следующие поля:
- Имя (текст, 50 символов)
- Фамилия (текст, 50 символов)
- Отчество (текст, 50 символов)
- Номер телефона (текст, 50 символов, обязательное)
- Адрес почты (текст, 50 символов)
- Страна (текст, 50 символов)
- Город (текст, 50 символов)
- Улица клиента (текст, 50 символов)
- Номер дома (текст, 50 символов)
- Квартира (текст, 50 символов)
- Бренд аппарата (текст, 50 символов)
- Модель (текст, 50 символов,Обязательное поле)
- Серийный номер (текст, 50 символов)
- Описание неисправности (текст, 255 символов)
- Номер заявки ИЦ (текст, 50 символов, обязательно)
- URL на анкету для прохождения опроса по завершению ремонта (текст, 50 символов). Ссылка для Philips имеет вид https://survey.medallia.com/?TPVConsumerCareQR&job_number=123&country=18&lang=en. Здесь Job number идентификатор обращения в системе ИЦ, Сountry - код страны (26 для РФ), language код языка анкеты (ru для русского). Для других брендов может иметь другой вид. Возможно в будущем реализуем свою систему опроса потребителей и этот URL будем генерировать самостоятельно.
Все поля необязательные, кроме номера телефона с проверкой по минимальной длине10 символов и номера заявки ИЦ.
При создании ремонта нужно подобрать переданные страну, город, бренд и модель. Если не получается - оставить пустым. Если эти четыре поля подобрать удалось, проверить количество АСЦ, авторизованных по этому бренду в городе. Если такой АСЦ ровно один - назначить ремонт на него.
В ответ на запрос нужно вернуть URL созданного ремонта чтобы ИЦ мог его открыть, проверить выбор города, бренда, АСЦ и модели и внести изменения вручную при необходимости.
К трекингу нужно добавить поле с URL анкеты, которая невидна никому кроме NSO TPV, которые её ещё и редактировать смогут (при острой необходимости).
2. Выдача клиенту документа с заключением о выполненных работах
После завершения ремонта, клиенту должен быть выдан документ с заключением о выполненных работах (см. следующий раздел). Это требование нужно пока для нескольких АСЦ в РФ (Орбис и ИРП), поэтому считаю что нужна настройка, требующая от АСЦ это сделать: по аналогии с тарифами на транспортировку - добавить такой флаг в настроечные коэффициенты стран и возможность индивидуального пересмотра в карточке авторизации АСЦ. С возможностью импорта и экспорта.
Для тех АСЦ, у которых это требование обязательно - они должны будут хотя бы один раз скачать этот документ, иначе должна возникнуть ошибка. Проерка деляается по счётчику нажатия на кнопку печати документа сотрудником АСЦ, выполняющим ремонт. Предлагаю сделать через механизм правил проверки, которое проверят что число нажатий больше нуля..
Хотелось бы чтобы этот документ отображался на видном месте, например, рядом с иконкой статуса "Ремонт завершён". Если это сложно, можем обсудить где лучше.
Наличие или отсутствие такого документа определяется есть ли настроенный шаблон такого документа для комбинации страна и бренд. Если такой шаблон есть, но в 1С нет требования его печати - то АСЦ могут его распечатать, но это опционально.
3. Механизм настройки шаблона документа
3.1 Шаблон Philips
По аналогии с механизмом настройки шаблонов АНРП и АТО нужна возможность их настройки (выбора) для каждого бренда и страны. Сейчас нужно сделать под требования Philips: шаблон простой и включает приветственный текст для клиента и QR-код со ссылкой на прохождение опроса из пункта 1.16. Шаблон документа есть по ссылке (только первая страница)
3.2 Шаблон Ellpa
В дальнейшем планируем выдавать подобный документ всем клиентам Эллпа и Эллпа Трейд, но хотелось бы иметь возможность гибкой настройки шаблона для разных брендов. Во вложении пример макета. Пока вижу два варианта:
- Настройка по примеру шаблонов АНРП/АТО с указанием текста или "кода поля" для каждого поля и его названия (чтобы можно было самостоятельно добавлять форму на разных языках)
- Сделать шаблон по аналогии как давноо делали генерацию договоров по шаблону в RTF, если не ошибаюсь.
4. Описание перечня работ
4.1. Автоматизация создания ремонта из системы информационного центра
Создается метод CreateTrackingCallCentr
Входные параметры:
| Название параметра | Тип параметра | Обяз. | Описание параметра |
| ticket | string | Да | Сессионный ключ |
| record | record | Да | структура содержащая данные |
| Структура Record | |||
| Model | string (50) | Да | Строка названия модели |
| OrderNumBrand | string (50) | Да | Номер заявки колл-центра |
| SerialNumb | string (50) | Нет | Серийный номер |
| DesRepair | string (3000) | Нет | Заявленная неисправность |
| RepairTypeUid | guid | Нет | Тип ремонта (связь с брендами (Default)). Значение берется из метода GetSpRepairTypes. Если не заполнено, то подставится «Клиентский гарантийный».
|
| BrandUid | guid | Да | Бренд (торговая марка). Значение берётся из GetBrands.BrandUid |
| CountryServiceCenter | string (2) | Нет | Стана АСЦ. Указывается страна в виде кода ALFA-2. Если страна найдена, то город будет сопоставляться с городами этой страны, иначе со страной пользователя колл-центра. |
| CityServiceCenter | string (255) | Нет | Город АСЦ. Город будет подбираться по тексту и стране. Если город найден, то по городу и бренду будет осуществляться поиск АСЦ. Если найден единственный АСЦ, то подставляется он иначе, если не единственный или если город не найден, то берется город пользователя колл-центра и в качестве АСЦ указывается пусто. Далее при редактировании данного трекинга, его сохранить с пустым АСЦ не возможно. |
| CName | string (255) | Нет | Имя клиента |
| CSurname | string (255) | Нет | Фамилия клиента |
| CPatronymic | string (255) | Нет | Отчество клиента |
| CCity | string (255) | Нет | Город клиента |
| CAddress | string (255) | Нет | Адрес клиента |
| CHouse | string (5) | Нет | Номер дома клиента |
| CBuild | string (5) | Нет | Корпус дома клиента |
| CFlat | string (5) | Нет | Номер квартиры клиента |
| CMobTel | string (15) | Нет | Мобильный телефон клиента |
| Cemail | string (255) | Нет | Email клиента |
| UrlQuestionnaire | string | Нет | URL на анкету для прохождения опроса по завершению ремонта |
Выходные параметры:
| Название параметра | Тип параметра | Описание параметра | Пример |
| TrackingUid | guid | Уникальный идентификатор трекинга. Значение можно использовать для дальнейших вызовов метода SaveTracking, если нужно обновить значения трекинга. | |
| SysNum | string | Системный номер трекинга (учётный номер ремонта в системе) | |
| StatusName | string | Статус трекинга | |
| StatusUid | guid | UID статуса трекинга. Значение берётся из GetStatuses. | |
| Result | Added or Changed or NotFound or Error or Unknown | Результат выполнения операции: Added – трекинг создан и помещён в базу Changed – трекинг изменён NotFound – трекинг не найден по uid Error – ошибка в работе метода Unknown – неизвестная ошибка | Added |
| TrackingUri | string | Ссылка на трекинг, которую можно открыть в браузере |
Секция Errors содержит коллекцию строк ошибок.
Секция ValidationErrors содержит коллекцию ErrorItem следующего вида:
| Название параметра | Тип параметра | Описание параметра | Пример |
| ErrorCode | string | Код ошибки | |
| ErrorLevel | int | Уровень ошибки: 1-критичная, 3-предупреждение. | |
| Status | string | Статус трекинга | |
| Descriptilon | string | Описание ошибки |
Добавляем в структуру трекинга и на форму трекинга новое поле Url анкеты.
Данное поле доступно только NSO TPV.
4.2. Механизм настройки шаблона для результата работ.
Может быть реализован один из двух способов:
4.2.1. Настройка шаблона на подобии как это реализовано в шаблонах АНРП.
Создается отдельный макет формы с зонами, которые могут заполняться из формы редактирования и форма редактирования с возможностью подставлять спец символы.
В том числе с указанием текста для названия поля табличной части.
Данная настройка осуществляется для бренда и страны
Минус данного способа в том, что при появлении нового макета, необходимо делать доработку и создавать тип шаблона с самим шаблоном
4.2.2. Настройка шаблонов с помощью программы редактирования файла rtf.
Перерабатывается существующая программа для редактирования файла rtf.
работа программы будет заключаться в том, чтобы в любой файл rtf можно было добавить спец поля и сохранить данный файл.
На сайте создается раздел с шаблонами результата работ.
Это просто перечень сохраненных файлов rtf с наименованием шаблона, описанием. С возможностью скачать и закачать новый.
Так же в данном разделе можно будет скачать саму программу для редактирования шаблонов и скачивания списка спец полей.
Далее делается настройка шаблонов, где для бренда и страны выбирается какой шаблон должен выводится в трекинге.
Так как у RTF нет отдельного понятия QR-код, а только изображение. то основная сложность это обработка спецполя с QR-кодом в программе по редактированию шаблонов.
4.3. Выдача клиенту документа с заключением о выполненных работах
В 1С в карточке контрагента и в справочнике настроечных коэффициентов стран добавляется новый признак "Печать заключения при завершении трекинга". Значение Да/Нет.
После перевода трекинга в статус "Ремонт завершен" и если у страны АСЦ и бренда или у авторизации АСЦ по бренду признак "Печать заключения при завершении трекинга" равен "Да" и есть шаблон для бренда и страны, то выводится кнопка "Заключение о выполненных работах".
Данное заключение выводится под номером ремонта АСЦ.
Возможно условием вывода должны быть и определенные типы ремонтов.
По кнопке заполняется и выводится шаблон и проставляется признак, что шаблон распечатан, если на кнопку печати нажимал сотрудник АСЦ.
При переводе в статус "Отчет" добавляется проверка, если у страны АСЦ и бренда или у авторизации АСЦ по бренду признак "Печать заключения при завершении трекинга" равен "Да" и есть шаблон для бренда и страны и признак что шаблон распечатывался АСЦ не установлен, то ошибка "Нельзя перевести ремонт в отчет, пока не распечатано заключение о выполненных работах сотрудником АСЦ"