CONTRATO [Sinônimos]: [contratos, contratos de serviço, contratos recorrentes, mensalidades, assinaturas, contratos de manutenção] — Tabela
CONTRATO
Tabela de contratos de prestacao de serviço recorrente. Armazena contratos com periodicidade mensal vinculados a clientes, contendo valor do contrato, valor da mensalidade, taxas, descontos, configuracoes de faturamento (gera nota fiscal ou apenas contas a receber), movimentação fiscal, serie, forma e condicao de pagamento. E a tabela base para o processamento em lote de mensalidades na tela MNF010 e para o cadastro de contratos na TFA015.
Tabelas Relacionadas Obrigatorias
- EMPRESA: empresa proprietaria do contrato. JOIN por CD_EMPRESA.
- PESSOA: cliente do contrato. JOIN por CD_PESSOA.
- TIPOCONTRATO: classificacao do tipo de contrato. JOIN por CD_TIPOCONTRATO. O campo TP_TIPOCONTRATO = 'S' identifica contratos de saida (serviço).
- MOVIMENTACAO: movimentação fiscal vinculada ao contrato. JOIN por CD_MOVIMENTACAO. Define CFOP, historico contábil, CST e impostos.
- ITEM: item/servico faturado no contrato. JOIN por CD_ITEM.
Tabelas Relacionadas Opcionais
- CONTRATOITEM: itens detalhados do contrato quando ha multiplos itens. JOIN por CD_EMPRESA + NR_CONTRATO.
- CONTAS: titulos financeiros gerados a partir do contrato. Vinculo por NR_DOCUMENTO = NR_CONTRATO.
- NOTA: notas fiscais geradas a partir do contrato. Vinculo por CD_EMPRCONTRATO + NR_CONTRATO.
- VENDEDOR: vendedor/representante do contrato. JOIN por CD_VENDEDOR.
- HISTORICO: historico contábil do contrato. JOIN por CD_HISTORICO.
CONTRATO.CD_EMPRESA
[Sinônimos]: [empresa, filial] Descrição: Código da empresa proprietaria do contrato. Regra de Domínio: Chave primaria composta com NR_CONTRATO. FK para EMPRESA.
CONTRATO.NR_CONTRATO
[Sinônimos]: [numero do contrato, contrato, codigo do contrato] [Perguntas]: ["Qual o contrato numero X?", "Detalhes do contrato."] Descrição: Numero sequencial do contrato dentro da empresa. Regra de Domínio: Chave primaria composta com CD_EMPRESA. Gerado automaticamente ou manualmente na TFA015.
CONTRATO.ST_CONTRATO
[Sinônimos]: [situacao, status, ativo, inativo] [Perguntas]: ["O contrato está ativo?", "Quais contratos estão cancelados?"] Descrição: Situacao do contrato. Regra de Domínio: 'S' = Ativo, 'N' = Inativo/Encerrado. Apenas contratos com ST_CONTRATO = 'S' aparecem na geracao de mensalidades (MNF010).
CONTRATO.ST_GERANOTA
[Sinônimos]: [gera nota fiscal, emite nota, faturamento] [Perguntas]: ["O contrato gera nota fiscal?", "Contratos sem nota fiscal."] Descrição: Indica se o contrato gera nota fiscal automaticamente ao processar mensalidades. Regra de Domínio: 'S' = Gera nota fiscal + contas a receber. 'N' = Gera apenas contas a receber. 'P' = Gera pedido de venda. Configurado na TFA015.
CONTRATO.VL_MENSALIDADE
[Sinônimos]: [valor mensal, mensalidade, valor da parcela] [Perguntas]: ["Quanto é a mensalidade?", "Valor mensal do contrato."] Descrição: Valor fixo da mensalidade recorrente do contrato. Regra de Domínio: Somado com VL_TAXAS para compor o valor total da parcela na geracao de mensalidades.
CONTRATO.VL_ENTRADA
[Sinônimos]: [entrada, valor de entrada, primeira parcela] Descrição: Valor da primeira parcela (entrada) quando diferente do valor da mensalidade. Regra de Domínio: Se preenchido, a primeira parcela gerada tera este valor ao inves de VL_MENSALIDADE.
CONTRATO.VL_TAXAS
[Sinônimos]: [taxas, encargos, valor adicional] Descrição: Valor de taxas adicionais que sao somadas a mensalidade. Regra de Domínio: Valor total da parcela = VL_MENSALIDADE + VL_TAXAS.
CONTRATO.VL_DESCONTO
[Sinônimos]: [desconto, abatimento, desconto antecipado] Descrição: Valor de desconto aplicado nas parcelas do contrato. Regra de Domínio: Gravado como VL_DESCONTOANTECIPADO no titulo financeiro gerado.
CONTRATO.DT_VENCTOPARCELA
[Sinônimos]: [data vencimento parcela, inicio parcelas, primeira parcela] Descrição: Data de vencimento da primeira parcela do contrato. Regra de Domínio: Usada como base para calculo das datas de vencimento das demais parcelas.
CONTRATO.NR_DIAVENCTO
[Sinônimos]: [dia do vencimento, dia fixo] Descrição: Dia fixo do mes para vencimento das parcelas. Regra de Domínio: Se preenchido, as parcelas vencerao sempre neste dia. Se nulo, usa o dia da DT_VENCTOPARCELA.
CONTRATO.TP_VALIDADE
[Sinônimos]: [tipo validade, unidade de validade] Descrição: Unidade de medida da validade do contrato. Regra de Domínio: 'D' = Dias, 'M' = Meses, 'A' = Anos, 'F' = Data fixa (usa DT_VENCTOCONTRATO). Default 'M'.
CONTRATO.NR_VALIDADE
[Sinônimos]: [prazo, duracao, vigencia] Descrição: Quantidade de periodos (conforme TP_VALIDADE) de vigencia do contrato. Regra de Domínio: Combinado com TP_VALIDADE e data de emissao/vencimento para calcular se o contrato ainda esta vigente.
CONTRATO.DT_VENCTOCONTRATO
[Sinônimos]: [vencimento do contrato, fim do contrato, data final] Descrição: Data de vencimento/encerramento do contrato. Regra de Domínio: Usada quando TP_VALIDADE = 'F' (data fixa). Pode ser estendida em 12 meses pela opcao de renovacao na MNF010.
CONTRATO.CD_REPRESENTANTE
[Sinônimos]: [representante, responsavel, vendedor do contrato] Descrição: Código da pessoa que e o representante/responsavel comercial do contrato. Regra de Domínio: FK para PESSOA. Se informado junto com PC_COMISSAO > 0, gera automaticamente uma conta a pagar de comissao ao processar mensalidades.
CONTRATO.PC_COMISSAO
[Sinônimos]: [percentual comissao, comissao] Descrição: Percentual de comissao do representante sobre o valor da mensalidade. Regra de Domínio: Valor entre 0 e 100. Comissao = VL_DOCUMENTO * PC_COMISSAO / 100.
Telas que usam esta tabela
Consulte a seção CONTRATO no Mapa de Impacto para ver todas as telas (producers/consumers) que operam sobre esta tabela.