¶ Adicionar um serviço contratado
¶ Objetivo
Adicionar um serviço/plano contratado a um contrato de cliente dentro do módulo Contratos.
¶ Quando usar
- Após cadastrar/selecionar um contrato já existente.
- Quando precisar vincular um novo plano/serviço ao contrato (independente de o contrato já ter serviços ATIVOS ou CANCELADOS).
¶ Pré-requisitos
- Contrato do cliente criado e disponível na lista de Contratos.
- Plano/serviço previamente cadastrado no LHISP.
- Permissão para alterar contratos e serviços contratados.
¶ Passo a passo
- Acesse Contratos (menu lateral).
- Abra o contrato desejado na lista. Na exploração, a tela do contrato foi carregada em uma URL do tipo
/contratos/{id}. - Na tela do contrato, clique na aba Serviços.
- Revise a grade de serviços contratados.
- Clique em Novo Serviço.
- Preencha o modal Contratação de Serviço:
- Plano (combo, com opções como
[699] ACESSO RESIDENCIAL 200mega,[700] novo 500mega,[701] novo 600mega,[702] novo plano para migraçãoe[703] 600M DUPLICADO) - Quantidade (spin)
- Observação (texto)
- Tipo de IP: IP PRIVADO / IP PÚBLICO / NÃO APLICÁVEL
- Tipo de Equipamento: PRÓPRIO / COMODATO / LOCAÇÃO / NÃO APLICÁVEL
- Conta Bancária [Boleto] e Conta Bancária [Pix] (combos)
- Vendedor / Promoção / Fidelidade (combos)
- Regras de cobrança/automação (checkboxes), incluindo:
- Não Enviar Mensagens de Cobrança?
- Não Efetuar Bloqueio Automático?
- Não Efetuar Cancelamento Automático?
- Enviar Boletos por Email?
- Enviar Boletos por WhatsApp?
- Cancelar Contas Automaticamente?
- Valor, Desconto [%] e Vencimento
- Opções adicionais observadas no modal (conforme regra do sistema), por exemplo:
- Gerar Nota Fiscal?
- Enviar Notas Fiscais por Email?
- Exigir OTT para gerar SVA? / Exigir OTT para gerar ISS?
- Plano (combo, com opções como
- Clique em Salvar.
- Confirme que a nova linha foi incluída na tabela da aba Serviços (coluna Situação pode aparecer como ATIVO ou CANCELADO, dependendo da regra do contrato/serviço).
¶ Campos importantes
Na aba Serviços, a grade exibe colunas observadas:
| Campo/coluna | Descrição |
|---|---|
| Ações | Ações do serviço (ex.: Editar e outras opções conforme status/fluxo). |
| Id | Identificador interno do serviço contratado. |
| Plano | Plano/serviço vinculado ao contrato. |
| Contratação | Data/hora de contratação do serviço. |
| Ativação | Data/hora de ativação do serviço. |
| Ultimo Reajuste | Data do último reajuste (texto observado na tela: Ultimo Reajuste). |
| Ultimo Renovação | Data da última renovação (texto observado na tela: Ultimo Renovação). |
| Venc. | Vencimento associado ao ciclo do serviço/cobrança. |
| Valor | Valor contratado (conforme configuração do plano e descontos). |
| Desc [%] | Desconto percentual aplicado. |
| Situação | Status do serviço (observado ATIVO e CANCELADO; podem existir outros). |
¶ Resultado esperado
- O serviço/plano fica vinculado ao contrato.
- A linha do serviço aparece na aba Serviços.
- O serviço passa a integrar os fluxos seguintes (por exemplo, acessos/cobrança), conforme as regras do sistema.
¶ Problemas comuns
| Problema | Como tratar |
|---|---|
| Botão Novo Serviço não está disponível | Confirme se você está na aba Serviços do contrato (e não em outra aba). Verifique também permissão do usuário. |
| Modal Contratação de Serviço não aceita o salvamento / não persiste | No demo, o fluxo abriu o modal e exibiu os campos esperados, mas a persistência definitiva não foi confirmada para um novo cadastro. Como prática, revise principalmente: Plano, Valor, Desconto [%] e Vencimento, além das Contas (Boleto/Pix), Vendedor, Promoção e Forma de pagamento. |
| Plano/Conta Bancária indisponíveis na lista do modal | Confirme parametrizações do sistema (filial/categoria/provedor, além de contas cadastradas). |
| Linhas não aparecem após salvar | Reabra a tela do contrato e verifique se o serviço está no status esperado. |
¶ Observações
- A aba Serviços reúne a grade e o botão Novo Serviço.
- Na tabela, o botão de ação visível por linha costuma aparecer como Editar (com título de detalhe do serviço) e, em alguns casos, há ação adicional Alteração de Plano.
- O modal Contratação de Serviço abre como sobreposição na própria tela e exibe, além do plano, campos como Quantidade, Observação, Tipo de IP, Tipo de Equipamento, Conta Bancária (Boleto/Pix), Vendedor, Promoção, Fidelidade e as regras de cobrança.
¶ Dúvidas para revisão
- Quais são obrigatórios no modal Contratação de Serviço para que o salvamento persista (especialmente campos relacionados a Valor, Desconto [%], Vencimento e Contas/Forma de pagamento)?
- Quais valores fazem o serviço iniciar como ATIVO vs CANCELADO (regra do contrato/serviço)?
¶ Screenshots sugeridos
- Aba Serviços do contrato:
assets/screenshots/contratos/servicos-aba.png
- Modal Contratação de Serviço:
assets/screenshots/contratos/contratacao-servico-modal.png
