Manual de Utilização da Tela de Contratos (Criação e Edição)
1. Introdução
A tela de contratos permite cadastrar, editar e administrar contratos firmados com clientes. Este manual descreve cada campo do formulário, funcionalidades e boas práticas de uso.
2. Campos e Funcionalidades do Formulário
Cliente
- Função: Seleciona o cliente que está contratando o sistema.
- Observação: Após a seleção, o responsável legal é preenchido automaticamente.
Início
- Função: Define a data de início do contrato.
- Sugestão: Geralmente é o dia da assinatura ou do começo do uso.
Tipo de Contrato
- Opções:
- Trial: Período de testes.
- Novo: Primeiro contrato com o cliente.
- Renovação: Prorrogação de contrato.
- Migração: Importado de outro sistema.
Sistema
- Função: Indica o sistema contratado (ERP, PDV, etc.).
- Observação: Este campo é bloqueado na edição.
Plano
- Função: Lista os planos disponíveis do sistema.
- Interação: Carregado dinamicamente ao selecionar o sistema.
Valor Tabela / Valor da Assinatura
- Tabela: Valor cheio do plano.
- Assinatura: Valor efetivamente cobrado, considerando descontos ou acréscimos.
Desconto/Acréscimo
- Calculado automaticamente com base no valor da assinatura e da tabela.
Duração
- Função: Meses de vigência do contrato (1 a 24).
- Sugestão: 12 meses é o padrão mais comum.
Dias Bônus
- Função: Período adicional gratuito antes da 1ª parcela.
Dia de Vencimento
- Opções fixas: 5, 10, 15, 20, 25 ou 30.
- Interação: Define a data de vencimento das parcelas mensais.
1º Vencimento
- Calculado automaticamente a partir do início e dia de vencimento.
Manter Desconto
- Sim/Não: Informa se o desconto deve ser mantido em futuras renovações.
Representante
- Função: Nome do representante comercial associado ao contrato.
Responsável Legal e Documento
- Preenchido automaticamente com os dados do cliente selecionado.
Meio de Faturamento
- Opções: BB (boleto bancário) ou PS (PagSeguro).
Origem do Contrato
- Função: Define de onde veio o contrato (painel, site, indicação, etc.).
Token de Acesso
- Função: URL segura para visualização do contrato pelo cliente.
- Botão "Copiar Link" facilita o compartilhamento.
Modelo de Contrato
- Função: Seleciona o template jurídico a ser usado.
Emitir NFS-e
- Sim/Não: Define se as parcelas geram nota fiscal de serviço.
Status
- Estados: Stand-by, Trial, Ativo, Suspenso, Cancelado.
Ações (botões)
- Lista: Retorna à listagem geral de contratos.
- Imprimir: Gera PDF do contrato baseado no modelo.
- Administrar Contrato: Acessa a tela para suspensão ou cancelamento.
- Efetivar Contrato: Cria parcelas se ainda não houver.
- Salvar: Atualiza os dados do contrato.
3. Seção de Faturamento
- Tabelas: Mostram parcelas emitidas ou simulação de cobrança futura.
- Campos: Nº da parcela, data de vencimento, valor, data e valor pago, comissão.
- Ação: Acesso à edição da parcela.
4. Texto da NFS-e (se aplicável)
- Aba Modelo: Edita o modelo com variáveis como:
[contrato],[mes],[sistema], etc.
- Aba Texto Final: Mostra o texto gerado substituindo as tags pelas informações reais do contrato.
5. Simulação de Parcelas
- Interatividade: Mudanças nos campos de valor, vencimento e duração geram simulação dinâmica.
- Comissão: Calculada com base em regras por sistema e nº da parcela.
6. API Verificar Contrato
- Botão API Verificar Contrato: Consulta status de liberação do contrato no sistema externo via token.
- Resposta: Mostra alerta de sucesso ou erro conforme retorno da API.
Este manual pode ser atualizado conforme mudanças na estrutura da tela ou novas funcionalidades forem adicionadas.