Documentação de

desenvolvimento

Desconto Especial

Documento de Desenvolvimento

Documentação de desenvolvimento 1 / 37
 Documentação de
desenvolvimento

Sumário
1 CONTROLE DE VERSÕES..........................................................................................................................3
2 DESCRIÇÃO..............................................................................................................................................4
3 PREMISSAS..............................................................................................................................................4
4 FUNCIONALIDADES.................................................................................................................................4
5 FLUXOGRAMA DETALHADO....................................................................................................................5
5.1.1 Visão geral do fluxograma........................................................................................................5
6 PASSO A PASSO DO PROCESSO...............................................................................................................6
6.1 Acessar o FTP e download do arquivo.............................................................................................6
6.2 Operações no sistema NET SMS......................................................................................................8
6.2.1 Login no Sistema.......................................................................................................................8
6.2.2 Acessando o cadastro do assinante.......................................................................................10
6.2.3 Pesquisando os dados do assinante.......................................................................................12
6.2.4 Consultar se o assinante já possui um desconto vigente.......................................................17
6.2.5 Dados da assinatura...............................................................................................................20
6.2.5.1 Seleção do pacote principal do assinante.......................................................................21
6.2.5.2 Cálculo do desconto........................................................................................................22
6.2.5.3 Efetivação do desconto...................................................................................................22
6.2.6 Iniciando uma nova operação de desconto...........................................................................30
6.2.7 Encerramento do processamento..........................................................................................31
6.2.7.1 Enviar e-mail para o analista responsável.......................................................................31
6.2.7.2 Orientações sobre os arquivos........................................................................................31
7 CONTROLE OPERACIONAL.....................................................................................................................34
7.1 Agendamento e Início....................................................................................................................34
7.2 Disponibilidade dos dados na origem............................................................................................34
7.3 Regras de Descarte e Armazenamento.........................................................................................34
7.4 Alertas e Respostas........................................................................................................................34
7.5 Reprocessamento..........................................................................................................................34
7.6 Controle de Log..............................................................................................................................34
7.7 Consultas........................................................................................................................................34
8 FORA DO ESCOPO DE RPA (O QUE NÃO CONTEMPLA O ROBÔ)...........................................................36

Documentação de desenvolvimento 2 / 37
 Documentação de
desenvolvimento

1 Controle de Versões

Versão Autor Data Comentário

1.0 João Marcelo Collar 16/08/2021 Versão inicial
1.1 João Marcelo Collar 24/08/2021 Orientações sobre arquivos origem e retorno

Documentação de desenvolvimento 3 / 37
 Documentação de
desenvolvimento

2 Descrição

Desenvolver uma solução RPA que faça o processo de aplicação de desconto negociado no plano principal
do assinante.

3 Premissas

 O layout e o formato do arquivo de origem dos dados a serem processados, NÃO deve ser alterado com o
risco de o robô não executar corretamente.
 Se for imprescindível sua alteração, deve-se informar a área competente para que sejam feitos os ajustes
necessários para o correto funcionamento do robô ANTES do novo layout ser colocado em produção.
 Ambos, o novo layout e os ajustes no robô devem ser colocados em produção juntos para não haver falha
na execução.
 Caso não seja preciso manter o histórico dos arquivos baixados do mailing, deve-se deixar explícito o
motivo na seção “Funcionalidades”.
 Caso não seja preciso enviar e-mail informativo no final de cada processamento, deve-se deixar
explícito o motivo na seção “Funcionalidades”.
 O usuário/máquina do robô deve ter acesso a TODAS as cidades do NET SMS para poder
consultar os dados dos assinantes, bem como qualquer outro acesso que se fizer necessário para
garantir a correta execução.

4 Funcionalidades

 Arquivo de Mailing: Arquivo que será disponibilizado o arquivo em formato CSV para
processamento. FTP origem do arquivo:
o Host: 172.30.24.77
o Pasta: /home/Cob_Sercom/NET/Quebras
 NET SMS: Sistema onde serão processados e efetivados os descontos para os assinantes.

 ORACLE: Servidor de Banco de Dados.

 MS Excel: Software de planilhas eletrônicas.

 MS Outlook: Cliente de e-mails.

Documentação de desenvolvimento 4 / 37
 Documentação de
desenvolvimento

5 Fluxograma Detalhado

5.1.1 Visão geral do fluxograma.

Documentação de desenvolvimento 5 / 37
 Documentação de
desenvolvimento

6 Passo a passo do processo

6.1 Acessar o FTP e download do arquivo.

O robô deverá acessar o FTP de mailing para efetuar o download do arquivo em formato CSV.

Detalhe da tela do FTP para download/upload do arquivo para processamento.

O arquivo de origem em formato CSV deverá estar no seguinte formato:

Visão do arquivo em formato texto.

Documentação de desenvolvimento 6 / 37
 Documentação de
desenvolvimento

Visão do arquivo aberto do MS Excel em formato de colunas.

Documentação de desenvolvimento 7 / 37
 Documentação de
desenvolvimento

6.2 Operações no sistema NET SMS

6.2.1 Login no Sistema

Campos a serem preenchidos:

 Usuário:
 Senha:
 Base: <CONFIRMAR SE ESSE CAMPO SEMPRE VIRÁ PREENCHIDO>

2
Clicar em conectar para acessar o sistema.
1
Campos a serem preenchidos.

Detalhe da tela de login do NET SMS.

Documentação de desenvolvimento 8 / 37
 Documentação de
desenvolvimento

Após o login, os botões com as opções dos menus ficarão habilitados e as informações do usuário
que está com a sessão ativa aparecerão no canto superior direito como visto na figura abaixo:

Botões de menu habilitados. Informações do usuário.

Detalhe da tela após o login.

Documentação de desenvolvimento 9 / 37
 Documentação de
desenvolvimento

6.2.2 Acessando o cadastro do assinante

Seleciona-se então o menu “Relacionamento” e a opção “Individual”.

1
Seleciona o menu “Relacionamento”

Opção “Individual”
2

Detalhe da seleção do menu e opção.

Documentação de desenvolvimento 10 / 37
 Documentação de
desenvolvimento

Surgirá então a tela inicial do sistema.

Clica-se no primeiro botão “Atendimento -> Dados do Assinante” com o ícone semelhante a uma
pessoa (assinante) para acessar a tela de cadastro.

Botão para acesso a tela de cadastro.

Detalhe do acesso a tela de cadastro.

Documentação de desenvolvimento 11 / 37
 Documentação de
desenvolvimento

6.2.3 Pesquisando os dados do assinante.

Na tela inicial do cadastro do assinante, deve-se procurar pelo contrato que desejamos efetuar o
desconto combinado.
Clica-se no botão “BUSCAR” e surgirá a tela para pesquisar os dados do assinante.

Clicar em “BUSCAR” para acessar a tela de

pesquisa.

Detalhe da tela inicial do cadastro do assinante.

Documentação de desenvolvimento 12 / 37
 Documentação de
desenvolvimento

Ao clicarmos em “BUSCAR” surgirá a caixa de diálogo de erro e apenas devemos clicar em “OK”.

Clicar no botão “OK”.

Detalhe da caixa de diálogo de erro de perfil.

Documentação de desenvolvimento 13 / 37
 Documentação de
desenvolvimento

Surgirá a tela para pesquisar os dados do assinante.

Nela deverão ser preenchidos, o código da cidade e o número do contrato do assinante, ambos
estarão no arquivo CSV que efetuamos o download do mailing.

2
Preencher o número do contrato
Preencher o código da cidade.

Clicar em “OK”
3

Detalhe da tela de pesquisa.

Deve-se atentar para o erro abaixo, o mesmo ocorre quando a máquina onde o sistema está
executando, não tiver permissão para acessar os dados da cidade inserida.
O erro não deve ocorrer pois o usuário/máquina não poderá ter restrições quanto as consultas
que podem gerá-lo.

Detalhe da tela de erro.

Documentação de desenvolvimento 14 / 37
 Documentação de
desenvolvimento

Tela do cadastro com o resultado da pesquisa.

Na janela “Pergunta” sobre a geração do protocolo de atendimento, deve-se clicar em “Sim”.

Clicar em “Sim”

Detalhe do resultado da pesquisa e tela de geração de protocolo.

Documentação de desenvolvimento 15 / 37
 Documentação de
desenvolvimento

1
Pegar o número do protocolo

Clicar em “OK”
2

Tela com o número do protocolo.

Documentação de desenvolvimento 16 / 37
 Documentação de
desenvolvimento

6.2.4 Consultar se o assinante já possui um desconto vigente.

Na tela inicial do cadastro, deve-se clicar na guia “Financeiro”.

Selecionar em “Ir para:” na combobox, a opção “Visualização Cobranças” e clicar em “ENTRAR”.

Selecionar a guia “Financeiro”

1

2 3
Selecionar a opção Clicar em “ENTRAR”
“Visualização Cobrança”

Detalhe da seleção da opção.

Documentação de desenvolvimento 17 / 37
 Documentação de
desenvolvimento

Na janela que surgirá, devemos clicar na guia “Lançamento Futuro”.

Selecionar a guia “Lançamento Futuro”

Detalhe do resultado após clicar em “ENTRAR”.

Documentação de desenvolvimento 18 / 37
 Documentação de
desenvolvimento

É exibida a lista de lançamentos futuros do assinante.

Não pode haver desconto caso o assinante já tenha um e em vigência, para isso deve-se consultar
a coluna “Tipo do Item” para obter a descrição que identifica desconto, a coluna “Data Vencimento” e a
coluna “Parcela” para obtermos a quantidade de parcelas e com isso, a partir de quando ele pode
negociar um novo desconto.

Ex: Um registro com parcela 3/3 e data de vencimento em 04/08/2021 e temos que lançar um
novo desconto para o mesmo assinante em 24/08/2021.

Detalhe do lançamento de desconto.

Documentação de desenvolvimento 19 / 37
 Documentação de
desenvolvimento

6.2.5 Dados da assinatura.

Deve-se selecionar a guia “Cadastro” e clicar no botão “Assinatura”, como mostrado na figura
abaixo:

Detalhe da tela para acesso a assinatura do cliente.

Documentação de desenvolvimento 20 / 37
 Documentação de
desenvolvimento

6.2.5.1 Seleção do pacote principal do assinante.

Ao clicar no botão “Assinatura”, surgirá a janela com os dados dos pacotes do assinante.

Deve-se selecionar os tipos “PRINCIPAL” e “ADICIONAL”.

IMPORTANTE:

 Os tipos são identificados pela ausência de data na coluna “Até” e que possuam valor na
coluna “Preço”.
 Se houver mais tipos “ADICIONAL”, deve-se pegar APENAS o de maior valor.
 Datas na coluna “De” mais atualizadas com os maiores valores na coluna “Preço”.
 Deve-se também selecionar a descrição do tipo “PRINCIPAL” na coluna “Pacote / Produto”.

Detalhe da seleção de somente um tipo.

Tipos a serem selecionados para

cálculo do desconto.

Detalhe da seleção de vários tipos.

Documentação de desenvolvimento 21 / 37
 Documentação de
desenvolvimento

6.2.5.2 Cálculo do desconto.

De posse dos valores dos pacotes do assinante, efetua-se o cálculo do desconto da seguinte
maneira:

 Soma-se os valores dos tipos principal e adicional e multiplica-os pelo desconto

informado no arquivo CSV origem que foi baixado do mailing.

VALOR DO DESCONTO = (ADICIONAL + PRINCIPAL) x PERCENTUAL DE DESCONTO

O resultado da operação deve ser ARREDONDADO.

6.2.5.3 Efetivação do desconto.

Depois dos valores coletados, deve-se clicar no botão “Atendimento -> Dados do Assinante” para
voltar para a tela inicial do cadastro.

Clicar no botão “Atendimento -> Dados do Assinante”

Detalhe do botão para voltar a tela inicial do cadastro.

Documentação de desenvolvimento 22 / 37
 Documentação de
desenvolvimento

Na tela inicial do cadastro, deve-se clicar na guia “Financeiro”.

Selecionar em “Ir para:” na combobox, a opção “Acerto Financeiro” e clicar em “ENTRAR”.

Por padrão o sistema seleciona essa opção, porém é aconselhável selecioná-la explicitamente.

Selecionar “Acerto Financeiro”

Detalhe dos passos para acessar a operação de “acerto financeiro”.

Documentação de desenvolvimento 23 / 37
 Documentação de
desenvolvimento

Ao clicar no botão “ENTRAR”, surgirá na mesma tela, na parte inferior a seção de “Acerto
Financeiro” onde serão inseridas as informações do desconto.

1
2 3

4 5

Detalhe da seção “Acerto Financeiro”.

Deverão ser preenchidos os seguintes campos:

1. Produto (combobox)......: selecionar o nome do produto do tipo “PRINCIPAL”, a mesma

descrição obtida na janela dos valores dos pacotes.
2. Tipo do Item (combobox): Selecionar SEMPRE “CREDITO POR DESPESA CONTESTADA”.
3. Tipo (radiobutton)..........: Selecionar SEMPRE “Crédito”.
4. Valor ...............................: Valor do desconto calculado.
5. Qtd. meses lançamento. : Quantidade de parcelas que está no arquivo CSV.
6. Observação.....................: SEMPRE “Desconto nova política negociação”.

Documentação de desenvolvimento 24 / 37
 Documentação de
desenvolvimento

Sequência de preenchimento.

Documentação de desenvolvimento 25 / 37
 Documentação de
desenvolvimento

Documentação de desenvolvimento 26 / 37
 Documentação de
desenvolvimento

Documentação de desenvolvimento 27 / 37
 Documentação de
desenvolvimento

1
2 3

4 5

Com as informações devidamente inseridas, clicar

6 em “SALVAR”

Detalhe da seção de acerto financeiro preenchida com um exemplo.

Documentação de desenvolvimento 28 / 37
 Documentação de
desenvolvimento

Tela após pressionar o botão “SALVAR” com o valor do desconto devidamente lançado.

Detalhe do lançamento do desconto efetuado.

Documentação de desenvolvimento 29 / 37
 Documentação de
desenvolvimento

6.2.6 Iniciando uma nova operação de desconto.

Para iniciarmos uma nova operação de desconto, clica-se no primeiro botão “Atendimento ->
Dados do Assinante” com o ícone semelhante a uma pessoa (assinante) para acessar a tela de cadastro
novamente.
Ao fazermos isso, o sistema irá retornar para o passo descrito na seção “6.3.3 Pesquisando os
dados do assinante”.

Para iniciar uma nova operação.

Clicar no botão “Atendimento -> Dados do Assinante”

Detalhe do botão que retorna para a seção para iniciarmos um novo processamento.

Documentação de desenvolvimento 30 / 37
 Documentação de
desenvolvimento

Documentação de desenvolvimento 31 / 37
 Documentação de
desenvolvimento

6.2.7 Encerramento do processamento.

6.2.7.1 Enviar e-mail para o analista responsável.

Serão coletadas as informações de sucesso/erro durante a operação e enviadas aos analistas

responsáveis no final do processamento total.

Lista dos analistas responsáveis:

o debora.pedroso@accenture.com;
o carlos.krug.da.rocha@accenture.com;
o renata.muniz@claro.com.br;
o degleiton.melo@claro.com.br;
o thiago.moschetta@claro.com.br;
o wladimir.miola@claro.com.br.

6.2.7.2 Orientações sobre os arquivos.

No final do processo total, o arquivo de origem deverá ser salvo em um local (informado pela
área) para o histórico e deverá conter o valor calculado do desconto.

6.2.7.2.1 Nomes e formato.

 O nome do arquivo de origem segue o padrão

“MAILING_DESCONTO_FUTURO_XXXXXXXX.CSV” onde “XXXXXXXX” é a data no formato
“ANO(4 dígitos) MÊS (2 dígitos) DIA (2 dígitos)”.
 O arquivo de origem está no formato CSV (Comma-separated values).
 O arquivo para histórico será salvo no mesmo local do arquivo de origem.
 O nome do arquivo do histórico será o mesmo do de origem acrescentado no final, antes
da extensão o sufixo “_PROCESSADO”.
o Ex: “MAILING_DESCONTO_FUTURO_XXXXXXXX_PROCESSADO.CSV”

Documentação de desenvolvimento 32 / 37
 Documentação de
desenvolvimento

6.2.7.2.2 Layout original.

O arquivo de origem em formato CSV deverá estar no seguinte formato:

Visão do arquivo em formato original CSV.

Visão do arquivo aberto do MS Excel em formato de colunas.

Documentação de desenvolvimento 33 / 37
 Documentação de
desenvolvimento

6.2.7.2.3 Layout do arquivo de retorno.

O arquivo de retorno em formato CSV deverá estar no seguinte formato:

Visão do arquivo em formato original CSV.

Visão do arquivo aberto do MS Excel em formato de colunas.

Documentação de desenvolvimento 34 / 37
 Documentação de
desenvolvimento

7 Controle Operacional

7.1 Agendamento e Início.

 Descrever a periodicidade de execução do robô. (diária, semanal, mensal, etc.)

7.2 Disponibilidade dos dados na origem.

 Por quanto tempo os dados ficam disponíveis na origem quando não são processados?

7.3 Regras de Descarte e Armazenamento.

 A partir de quanto tempo os dados devem ser ignorados no arquivo de origem, caso ocorra?
 No arquivo de histórico dos descontos, deve-se excluir os registros antigos a partir de quanto
tempo decorrido (caso o histórico esteja em um único arquivo)?

7.4 Alertas e Respostas.

 Caso ocorram erros no processamento, quem deve receber o e-mail com os avisos (se
aplicável)?
 Há um modelo padrão para o e-mail (se aplicável)?
 As mensagens de alertas/erros devem ser controladas com log´s para análise (se aplicável)?

7.5 Reprocessamento.

 O processo efetua uma única operação, o cadastro do desconto e por isso para o
reprocessamento em caso de erro, basta executá-lo novamente com a informação vinda do
arquivo de origem (formato CSV). Verificar o quanto tempo fica na origem o registro para
efetuar o desconto.

7.6 Controle de Log.

 Log para controle dos status das fases do processamento?

 Log para controle da execução do robô?
 Log para controle de alertas e erros?

7.7 Consultas.

 Deverá haver a necessidade de consultas para acompanhamento do processamento?

 Se sim, quais dados do assinante e do processamento deverão ser gravados para consulta?
 Qual o tipo de consulta necessária?
Documentação de desenvolvimento 35 / 37
 Documentação de
desenvolvimento

 A consulta deverá ser automática?

Documentação de desenvolvimento 36 / 37
 Documentação de
desenvolvimento

8 Fora do Escopo de RPA (O que não contempla o robô).

São consideradas operações fora do escopo dessa automação, tudo que não estiver descrito nesse
documento quando do levantamento dos requisitos e necessidades junto a área usuária.

Documentação de desenvolvimento 37 / 37