Controllr/Aplicativos/Cadastros/Contratos

Contratos

No App Contratos

No aplicativo de Contratos, é realizado o cadastro da prestação dos serviços para o seus clientes. Cada cliente pode ter mais de um contrato com um ou vários serviços diferentes. Lembre-se que para começar a cadastrar contratos, é necessário já ter preenchido, pelo menos, um escritório e um perfil, caso não queira utilizar os padrões default do sistema.

Para adicionar um novo contrato, basta clicar no botão Novo. Além dessa maneira, se preferir, clique em um cliente na listagem do aplicativo aplicativo Cliente e clique na opção Contratos no menu superior e, por fim, selecione o botão Novo.

Novo Contrato

Nesta sessão, algumas configurações do contrato devem ser preenchidas. Na tabela a seguir, são descritos os detalhes de cada campo.

Novo Contrato
Campo	Descrição	Exemplo
Cliente	Escolha um cliente que estará associado a este contrato.	Gabriel Henry Moraes
Número	Escolha um número para este contrato. O sistema já preenche na sequência correta. Só altere o número se realmente for necessário.	17
Status	Marque o status deste contrato. As opções são: • Ativado; • Alertado; • Alertado; • Pendente; • Bloqueado; • Cancelado; • Desabilitado.	Ativado
Endereço	Contém o endereço criado no cadastro do seu cliente. Se desejar modificar o endereço, clique no atalho da engrenagem ao lado.	Endereço Principal
Modelo	Marque o modelo deste contrato. O Controllr já conta com um modelo default do layout de contrato para o provedor. Se não quiser usar esse modelo, você pode editá-lo ou criar um modelo novo. Para isso, basta clicar no atalho da engrenagem ao lado.	Contrato Padrão
Escritório	Marque o escritório que irá pertencer este contrato. Se desejar criar outro escritório, clique no atalho da engrenagem ao lado.	Matriz
Controle	Aqui você deve escolher o tipo de controle. As opções são: • Controle Automático - o contrato vai seguir as especificações do perfil. Por exemplo: gerar as cobranças automaticamente, fazer bloqueios, entre outros. • Controle Manual - as operações citadas acima serão feitas por você.	Controle Automático
Perfil	Escolha um perfil. Lembre-se que nele estarão definidas as informações para o controle automático.	Simples
Ativação
Ativação	Corresponde a data que estará iniciando o contrato. Esse campo já vem preenchido, porém ela pode ser modificada. Um exemplo de modificação seria para deixar feito o contrato e somente depois irá ativar a sua internet. Lembre-se que o calculo que o sistema faz para a primeira cobrança proporcional é com base na data de ativação até o primeiro vencimento configurado no contrato.	06/01/2023 10:10:22
Ativação Valor (R$)	Defina um valor associado a ativação.	50,00
Área do Cliente
Permitir Visualização	Marque a opção para permitir a visualização do contrato pelo cliente dentro da sua área do cliente.
Permitir Impressão	Marque a opção para permitir o cliente de imprimir o contrato dentro da sua área do cliente.
Pagamento
Serviço Grátis	Marque essa opção se nenhum valor será pago na fatura, independentemente, dos serviços contratados adicionados.
Boleto	Marque a forma de pagamento (banco) que irá gerar as cobranças deste contrato. Se desejar criar uma nova forma de pagamento, clique no ícone da lupa ao lado.	Banco do Provedor
Data de Vencimento	Marque a data de vencimento padrão para as cobranças do tipo internet do seu cliente. Se desejar criar mais datas de vencimento, clique no ícone da lupa ao lado.	20
Desconto (R$)	Essa opção permite você adicionar um valor de desconto até o vencimento. Por exemplo: • O vencimento da fatura do seu cliente é todo dia 10 de cada mês. A soma dos serviços contratados corresponde ao valor de R$ 115,00. Se o desconto for de R$ 15,00, ele pagará R$ 100,00 até o dia do vencimento da sua fatura.	R$ 10,00
Informações Fiscais
CFOP	Informe qual é o CFOP (Código Fiscal de Operações e Prestações) das entradas e saídas de mercadorias, intermunicipal e interestadual para o tipo de cliente que irá contratar o serviço do tipo Internet. Os tipos são: • Clientes do mesmo estado do Provedor Tabela 5300-5307; • Clientes fora do estado do Provedor Tabela 6300-6307.	5307 - Prestação de serviço de comunicação a não-contribuinte
Observações
Contrato	Anote alguma observação que deseja para este contrato.	Esse cliente solicitou uma interrupção de contrato entre os dias 01/01/2023 a 07/01/2023.
Fiscal	Anote alguma observação fiscal que deseja para este contrato.	Valor do ICMS é diferente dos demais clientes.

Assinatura

Para esta sessão funcionar corretamente, você deverá cadastrar os Endereços do Servidor (localizado no aplicativo de Cadastros). Todos os campos da imagem abaixo são descritos na tabela a seguir.

Assinatura
Campo	Descrição	Exemplo
Data	Contém a data cujo contrato foi assinado.	01/10/2021
Código	Insira o código que o cliente deverá informar para assinar o contrato. Observação: O código precisa conter 6 números e não pode começar com o dígito zero.	123456
IP de Assinatura	Contém o endereço IP do local de assinatura.	111.22.33.0
Hash de Assinatura	Contém o código que transcreve a assinatura do cliente.	da3543v7a03pc9021537z3c26737a7ed1
Link	Contém o link de assinatura online do contrato para o cliente.	[Link de Exemplo]
Botões
Anexos	O botão abre o App de Anotações do cliente, filtrando por anexos desse contrato.
Limpar Assinatura	O botão limpa a assinatura caso não esteja válida.

Login da Assinatura

Após o envio do link de acesso para o cliente, ele poderá acessar a área para fazer assinatura online do contrato. Você pode ver o exemplo abaixo, clicando aqui.

Login
Campo	Descrição	Exemplo
6 Primeiros digitos do documento	O cliente deverá informar os seis primeiros dígitos do CPF (se for pessoa física) ou CNPJ (se for jurídica).	690224
Código de Contrato	O cliente deverá informar o código que foi definido na criação do contrato.	123456
Termo de Assinatura Digital	Esse campo precisa estar marcado para prosseguir. Marcando ele, o cliente concorda com o termo de assinatura digital.

Área da Assinatura

Após o processo de autenticação, o cliente poderá assinar o contrato. Se precisar que o cliente envie alguns documentos antes de realizar assinatura, poderá estar configurando no App Perfil que está vinculado ao contrato do cliente. Os documentos que são enviados pelo cliente, são salvos na Anotação do cliente.

Após enviar os documentos necessários, aparecerá a opção do cliente assinar o documento. Você pode editar o texto que é mostrado ao cliente na hora de assinar e depois de assinar. Para isso, basta editar no Modelo de contrato.

Serviços Contratados

Após configurar e salvar a primeira parte do contrato, será aberto as configurações do serviço contratado. Essa aba refere-se a prestação de serviço do seu Provedor com o Cliente, que é o serviço do tipo internet.

Para adicionar um novo serviço contratado, basta clicar no botão Adicionar. Após isso, você deverá escolher um tipo de serviço para incluir no contrato deste cliente. Você pode ver os detalhes de cada opção na tabela abaixo.

Serviços Contratados
Opção	Descrição
Internet	Será adicionado um serviço de internet para este contrato. Será aberto uma nova janela para a edição da autenticação de CPE deste cliente.
Cobrança Desconto	Nessa opção, adicionamos um valor que será somado/descontado no valor do contrato. No texto a seguir, vamos detalhar cada campo da imagem abaixo. Categoria Info: • Habilitado: Ao marcar essa opção, você habilitará ou desabilitará esse serviço. • Permitir Visualização: Ao marcar essa opção, permitirá que o cliente visualize esse serviço (cobrança / desconto) em seu contrato na área do cliente. • Contrato: Define o contrato ao qual esse serviço estará associado. • Autenticação: Define a autenticação ao qual esse serviço estará associado. Categoria Serviço: • Nome: Escolha um serviço pré-cadastrado no aplicativo Serviços. • Descrição: Defina uma descrição para o seu serviço. • Tag: Insira uma tag para o serviço. A tag serve também para uma melhor organização das empresas que irão integrar com o Controllr, na questão da identificação das requisições API. Categoria Cobrança: • Tax Modelo: Escolha o modelo da nota fiscal para esse serviço. • Valor: Defina o valor desse serviço. Categoria Status: • Cadastrado: Campo preenchido automaticamente. O campo contém a data e horário da criação do serviço. • Atualizado: Campo preenchido automaticamente. O campo contém a data e horário da última atualização nos campos desse serviço.
Integração	Nessa opção, adicionamos um serviço a qual uma empresa irá integrar com o Controllr para adicionar um Serviço de Valor Agregado (SVA). Categoria Info: • Habilitado: Ao marcar essa opção, você habilitará ou desabilitará esse serviço. • Permitir Visualização: Ao marcar essa opção, permitirá que o cliente visualize esse serviço (cobrança / desconto) em seu contrato na área do cliente. • Contrato: Define o contrato ao qual esse serviço estará associado. • Autenticação: Define a autenticação ao qual esse serviço estará associado. Categoria Serviço: • Nome: Escolha um serviço pré-cadastrado no aplicativo Serviços. • Descrição: Defina uma descrição para o seu serviço. • Tag: Insira uma tag para o serviço. A tag serve também para uma melhor organização das empresas que irão integrar com o Controllr, na questão da identificação das requisições API. Categoria Cobrança: • Tax Modelo: Escolha o modelo da nota fiscal para esse serviço. • Valor: Defina o valor desse serviço. Categoria API: • Usuário: Defina o usuário para poder conectar com a API. • Senha: Defina a senha para poder conectar com a API. • CID: Defina o identificador de chamada para a conexão. • DID: Defina a discagem interna direta para a conexão. Categoria Status: • Cadastrado: Campo preenchido automaticamente. O campo contém a data e horário da criação do serviço. • Atualizado: Campo preenchido automaticamente. O campo contém a data e horário da última atualização nos campos desse serviço.
Equipamento	Nessa opção, podemos adicionar um equipamento no contrato, podendo ele ser comodato ou não. Categoria Info: • Habilitado: Ao marcar essa opção, você habilitará ou desabilitará esse serviço. • Permitir Visualização: Ao marcar essa opção, permitirá que o cliente visualize esse serviço (cobrança / desconto) em seu contrato na área do cliente. • Contrato: Define o contrato ao qual esse serviço estará associado. • Autenticação: Define a autenticação ao qual esse serviço estará associado. • Equipamento: Selecione o equipamento que já deve estar pré-cadastrado no sistema. Categoria Serviço: • Nome: Escolha um serviço pré-cadastrado no aplicativo Serviços. • Descrição: Defina uma descrição para o seu serviço. • Tag: Insira uma tag para o serviço. A tag serve também para uma melhor organização das empresas que irão integrar com o Controllr, na questão da identificação das requisições API. Categoria Cobrança: • Comodato: Ao marcar essa opção, é definido se o equipamento é um comodato, ou seja, empréstimo de bem que não pode ser substituído e deve ser devolvido ao final. • Tax Modelo: Escolha o modelo da nota fiscal para esse serviço. • Valor: Defina o valor desse serviço. Categoria Status: • Cadastrado: Campo preenchido automaticamente. O campo contém a data e horário da criação do serviço. • Atualizado: Campo preenchido automaticamente. O campo contém a data e horário da última atualização nos campos desse serviço.

Ao invés de inserir manualmente cada serviço, você pode adicionar um combo. Para isso, clique no botão Combo (Aplicar) e a tela abaixo surgirá. Lembre-se que, para adicionar um combo, você deverá ter um Combo pré-definido.

Selecione o combo criado anteriormente no campo Combo e clique no botão Arquivo:Co-salvar.png Salvar.

Menus

Na tela de listagem dos contratos, temos menus que podem ser acessados.

Menus
Menu	Descrição
Alterações Múltiplas	Nessa opção, pode ser realizado alteração em massa para vários contratos simultaneamente. Os campos são iguais da criação de um novo contrato.
Imprimir	Nessa opção, você pode imprimir um contrato. Basta preencher os campos corretamente. Os campos da imagem acima são descritos a seguir. • Modelo: Selecione o modelo do contrato para impressão. • Cliente: Selecione o cliente que gostaria de imprimir o contrato. • Contrato: Defina o contrato da impressão. • Valor: Caso queira, insira um valor a taxa de de implantação do serviço, isto é, como se fosse o valor de contratação.
Aplicativos > Modelos de Contrato	Nessa opção, você poderá editar o modelo padrão ou criar novos modelos de contrato.
Aplicativos > Dias de Vencimento	Nessa opção, você poderá adicionar novas dias para vencimento das cobranças do tipo internet que seu provedor trabalha. Para adicionar, clique no botão Novo, conforme a imagem acima. Em seguida, adicione o novo dia de vencimento e clique em salvar.
Relatórios	No App Relatórios, contamos com alguns relatórios para melhor organização do seu Provedor. Clique aqui para ter acesso aos relatórios disponíveis para você.

Alterações Múltiplas

Nessa opção do Menu poderá realizar alterações em massa, para vários contratos de uma vez.

Para que os Contratos sejam listados nessa janela. Primeiro deve marcar quais os Contratos que irá realizar as alterações múltiplas. Só então irá clicar em Alterações Múltiplas.

Alterações Múltiplas
Menu	Descrição
Ativação	Pode ser alterado a data de ativação dos Contratos
Modelo	Pode ser alterado o modelo de contrato padrão
Escritório	Pode ser alterado o escrito dos Contratos
Pagamento	Pode ser alterado a cortesia do Contrato, marcando Sim ou Não
Banco	Pode ser alterado o banco (forma de pagamento) deste Contrato
Bloqueio Automático	Pode ser alterado o tipo de bloqueio deste contrato, marcando Sim ou Não
Data	Pode ser alterado a data de vencimento do Contrato
Desconto	Pode ser alterado o desconto até o vencimento do Contrato
Tipo de Corte	Pode ser alterado a execução das pendencias em dias úteis ou corridos
CFOP	Pode ser alterado o CFOP do Contrato
Alíquota ICMS (%)	Pode ser alterado o ICMS do Contrato
Percentual IBPT (%)	Pode ser alterado o IBPT do Contrato
Contratos Selecionados	Os Contratos selecionados anteriormente serão listados, para você checar mais uma vez e ter certeza da sua alteração em massa. Se estiver tudo OK basta clicar em Salvar

Modelos de Contrato

Nessa opção, pode ser editado o contrato padrão ou criado novos modelos de contratos.

Para criar um novo modelo de contrato, basta clicar no botão Novo. Os campos da figura abaixo são descritos na tabela a seguir.

Modelos de Contrato
Campo	Descrição	Exemplo
Título	Insira o nome desse modelo de contrato	Contrato Padrão
Variáveis	Ao montar um novo modelo de contrato, você pode usar palavras chaves para trazer alguma informação específica do banco de dados do seu Controllr. A seguir, citaremos todas as variáveis disponíveis para utilizar.	{CLI_NAME}
Menu
Modelo	Edita o modelo de contrato.
Assinar	Edita o modelo que é mostrado antes do cliente assinar.
Assinado	Edita o modelo que é mostrado após o cliente assinar.

Variáveis

As variáveis abaixo podem ser utilizadas no contrato. Para adicioná-las, basta clicar em uma delas e automaticamente ela aparecerá no lugar selecionado.

Informações do Cliente
Nome	Descrição	Exemplo
{CLI_NAME}	Imprime o nome/razão social do cadastro do cliente.	Beltrano
{CLI_NAME_L}	Imprime o sobrenome/fantasia do cadastro do cliente.	de Tal
{CLI_NAME_FULL}	Imprime o nome completo/razão social do cliente.	Beltrano de Tal
{CLI_USER}	Imprime o usuário da área do cliente.	belt
{CLI_CPF_CNPJ}	Imprime o CPF/CNPJ do cadastro do cliente.	621.533.590-82
{CLI_RG_IE}	Imprime o RG/IE do cadastro do cliente.	16.919.961-7
{CLI_PHONE}	Imprime o telefone do cadastro do cliente	(67) 99999-9999
{CLI_MAIL}	Imprime o(s) e-mail(s) cadastrados do cliente.	beltrano@detal.com.br
{CLI_DATE_CAD}	Imprime a data de cadastro do cliente no sistema.	18/03/2020
{CPE_AUTH}	Imprime usuário e senha de autenticação do cliente.	Usuário: belt Senha: belt123
{CPE_INFO}	Imprime as informações de autenticação deste contrato.	Usuário: belt Senha: belt Plano: Plano 60Mb Painel: Painel Padrão Modelo
{CLI_DATE_BIRTH}	Imprime a data de aniversário do cliente ou data de abertura da empresa.	14/01/1965

Informações do Contrato
Nome	Descrição	Exemplo
{CONT_DATE_ACT}	Imprime a data de ativação do contrato	26/03/2020
{CONT_DATE_CAD}	Imprime a data de cadastro do contrato.	26/03/2020
{CONT_DATE_DEACT}	Imprime a data de desativação do contrato.	-
{CONT_NUMBER}	Imprime o número de identificação do contrato.	00000003
{CONT_AMOUNT}	Imprime o valor total do contrato.	229,00
{CONT_ACT_AMOUNT}	Imprime o valor de ativação do contrato.	25,00
{CONT_PAY_DAY}	Imprime a data de vencimento do contrato.	10
{CONT_ITEMS}	Imprime todos os serviços contratados em forma de tabela. A tabela possui três campos: nome, valor e descrição.	Internet R$ 120,00 Serviço Internet 100MB Adicional R$ 30,00 Adicional 2023 Equipamento R$ 0,00 Roteador (00:1B:44:11:3A:B7) - #1
{CONT_EQUIPMENT}	Imprime as informações do(s) equipamento(s) de internet do contrato. A tabela possui cinco campos: nome do equipamento, MAC, Valor, Aluguel e comodato.	Roteador | 00:1B:44:11:3A:B7 | R$ 0,00 | R$ 0,00 | Sim
{CONT_PLAN}	Imprime as informações do(s) serviço(s) de internet do contrato.	Plano 60Mb - R$ 179,00
{CONT_ADDR}	Imprime o endereço vinculado ao contrato.	Rua Manoel Rosa
{CONT_ADDR_NUM}	Imprime o número do endereço vinculado ao contrato.	559
{CONT_ADDR_B}	Imprime o bairro do endereço vinculado ao contrato.	Amambaí
{CONT_ADDR_CEP}	Imprime o CEP do endereço vinculado ao contrato.	79005-560
{CONT_ADDR_COMP}	Imprime o complemento do endereço vinculado ao contrato.	Portão Amarelo
{CONT_ADDR_CITY}	Imprime a cidade do endereço vinculado ao contrato.	Campo Grande
{CONT_ADDR_UF}	Imprime a sigla do estado do endereço vinculado ao contrato.	MS
{CONT_ADDR_STATE}	Imprime o estado do endereço vinculado ao contrato.	Mato Grosso do Sul
{CONT_EMISSION_AMOUNT}	Imprime o valor da emissão do contrato.	0,00
{CONT_OBS}	Imprime as observações do contrato.	Cliente residencial
{CONT_SIGN_IMG}	Imprime a imagem da assinatura no formato real.	-
{CONT_SIGN_IMG_BOX}	Imprime a imagem da assinatura dentro de uma caixa menor.	-

Informações do Escritório
Nome	Descrição	Exemplo
{ISP_NAME_C}	Imprime a razão social do escritório vinculado ao contrato.	Softov ME
{ISP_NAME}	Imprime o nome fantasia do escritório vinculado ao contrato.	Matriz
{ISP_NAME_RESP}	Imprime o nome do responsável do escritório vinculado ao contrato.	Maria José
{ISP_ADDR_B}	Imprime o bairro do escritório vinculado ao contrato.	Jardim TV Morena
{ISP_ADDR}	Imprime o endereço do escritório vinculado ao contrato.	Rua Maués
{ISP_ADDR_COMP}	Imprime o complemento do escritório vinculado ao contrato.	Prédio - Bloco 3 - Quinto Andar
{ISP_NUM}	Imprime o número do escritório vinculado ao contrato.	200
{ISP_CITY}	Imprime a cidade do escritório vinculado ao contrato.	Campo Grande
{ISP_UF}	Imprime a sigla do estado do escritório vinculado ao contrato.	MS
{ISP_STATE}	Imprime o estado do escritório vinculado ao contrato.	Mato Grosso do Sul
{ISP_CEP}	Imprime o CEP do escritório vinculado ao contrato.	79050-110
{ISP_CNPJ}	Imprime o CNPJ do escritório vinculado ao contrato.	23.065.656/0001-98
{ISP_IE}	Imprime a Inscrição Estadual do escritório vinculado ao contrato.	085.548.371.933
{ISP_PHONE}	Imprime o telefone do escritório vinculado ao contrato.	(67) 2233-4455
{ISP_EMAIL}	Imprime o e-mail do escritório vinculado ao contrato.	internetmaismais@telecom.com.br
{ISP_URL}	Imprime o endereço do site do escritório vinculado à este Contrato	http://www.internetmaismais.com.br
{ISP_LOGO}	Imprime a logomarca do escritório vinculado ao contrato.	link=
{ISP_HEADER}	Imprime um resumo do escritório vinculado ao contrato.	Matriz Endereço: Rua Ipacaraí, 242 CEP:79004650 Email: comercial@brbyte.com Tel:: 67 99222223

Outras Variáveis
Nome	Descrição	Exemplo
{PLAN_INFO}	Imprime algumas informações a mais do plano de internet incluso no contrato.	Plano 60Mb- TX: 60000 Kbps - RX: 60000 Kbps
{DAY}	Imprime o dia atual com base na data do seu computador.	08
{YEAR}	Imprime o ano atual com base na data do seu computador.	2023
{MONTH}	Imprime o número do mês atual com base na data do seu computador.	01
{MONTH_FULL}	Imprime o mês nominal com base na data do seu computador.	Janeiro

Listagem e Status

Assim como em Relatórios, na parte principal do seus Contratos, você pode realizar filtros, para listar e consultar Contratos específicos.

Listagem e Status
Menu	Descrição
Tipo de Bloqueio	Marque o status do tipo de corte do Contrato Dias Corridos Dias Úteis Todas
Cortesia	Marque os contratos com Cortesia: Sim Não Todas
Status	Marque o status de listagem do contrato: Habilitado Cancelado Desabilitado Todas
Categoria	Marque a categoria do cliente que deseja filtrar os Contratos
Vencimento	Marque a data de vencimento que deseja listar os Contratos
Forma de Pagamento	Marque a forma de pagamento (banco) referenciado nos contratos. Para mostrar todos cliente em Todos os Bancos
Escritório	Marca o escritório referenciado ao Contrato. Para não tem filtro marque Todas as Unidades
Filtro de datas	Poderá filtrar os contrato por data de: • Cadastro • Ativação • Desativação No campo de data você pode escolher o período de referencia: - : Nessa opção irá marcar uma data personalizada. Basta clicar na seta para abrir o campo de inserção de data. Hoje: Filtra com a data de hoje (26/03/2020) Ontem: Filtra com a data de ontem (25/03/2020) Essa semana: Filtra com a data de uma semana (22/03/2020 - 28/03/2020) Semana passada: Filtra com a data da semana passada (15/03/2020 - 21/03/2020) Esse mês: Filtra pelo período do mês (01/03/2020 - 31/03/2020) Mês passado: Filtro pelo período do mês passado (01/02/2020 - 29/02/2020) Esse ano: Filtra pelo período do ano (01/2020 - 12/2020) Ano passado: Filtra pelo período do ano passado (01/2019 - 12/2019) Desde o Inicio: Filtra por um período que contemple todas as datas.
Exportar	Após aplicar os filtros, poderá realizar a exportação desse relatório no formato: Excel CSV HTML
Colunas Ocultas	Você pode complementar o seu relatório habilitando colunas ocultas dessa janela. Para aparecer a opção de colunas ocultas você deve passar o mouse em cima da coluna (qualquer coluna), então irá aparecer uma ceta para baixo. Clique nela e vá na opção Columns
Busca	Nesse campo você pode realizar buscar específicas. Primeiro marque a opção que se refere a busca, depois no outro campo escreve o que buscar conforme a opção marcada, por fim clique na Lupa

Importar

Essa opção você pode importar Contratos de outro sistema para o Controllr.

Veja a documentação completa de Importar planilha de dados.