Pular para o conteúdo principal

CONTAS [Sinônimos]: [faturas, duplicatas, títulos, boletos, pendências, parcelas, contas a pagar, contas a receber, dívidas, créditos] — Tabela

CONTAS​

Tabela principal do módulo financeiro que armazena todas as contas a pagar e contas a receber da empresa. Cada registro representa um título financeiro (duplicata, boleto, parcela, nota fiscal) vinculado a uma pessoa (cliente ou fornecedor). Contém informações de valor original, saldo devedor, datas de lançamento, vencimento e liquidação, status (aberta, liquidada, cancelada) e forma de pagamento. É a tabela central para consultas de inadimplência, cobrança, fluxo de caixa e posição financeira.

Tabelas Relacionadas Obrigatórias​

  • TIPOCONTA: classificação do tipo de conta (pagar, receber, adiantamento, provisão, cheque, cartão). JOIN obrigatório por CD_TIPOCONTA para filtrar por TP_TIPOCONTA.
  • PESSOA: dados do cliente ou fornecedor (nome, CNPJ/CPF). JOIN obrigatório por CD_PESSOA para exibir nome.
  • EMPRESA: dados da empresa emissora. JOIN obrigatório por CD_EMPRESA para nome da empresa.
  • USUARIOEMPRESA: controle de acesso do usuário às empresas. JOIN obrigatório por CD_EMPRESA para restringir dados por permissão.

CONTAS.CD_EMPRESA​

[Sinônimos]: [empresa, filial, matriz, unidade de negócio, código da loja] [Perguntas]: ["Qual o saldo da empresa 1?", "Quantas contas a pagar tem na filial de Curitiba?", "Lista de notas da matriz."] Descrição: Identificar a empresa proprietária do título financeiro. Regra de Domínio: Deve ser filtrado pelo código da empresa desejada. Geralmente vinculada à permissão do usuário em USUARIOEMPRESA.

CONTAS.CD_PESSOA​

[Sinônimos]: [cliente, fornecedor, sacado, cedente, parceiro, contraparte, quem paga, quem recebe] [Perguntas]: ["Quanto o cliente John Snow deve?", "Quais faturas do fornecedor Junsoft estão abertas?", "Lista de títulos por cliente."] Descrição: Identificar a pessoa (entidade) vinculada ao lançamento financeiro. Regra de Domínio: Código da pessoa na tabela PESSOA. Define se é o devedor (no Receber) ou credor (no Pagar).

CONTAS.VL_SALDO​

[Sinônimos]: [valor pendente, saldo em aberto, valor devedor, o que falta pagar, restante, saldo atual] [Perguntas]: ["Quanto ainda falta receber deste título?", "Quais os valores em aberto hoje?", "Qual o montante da inadimplência?"] Descrição: Valor residual que ainda não foi liquidado/baixado no título. Regra de Domínio: Se VL_SALDO = 0, a conta está quitada. Se VL_SALDO > 0 e < VL_DOCUMENTO, houve pagamento parcial.

CONTAS.DT_VENCIMENTO​

[Sinônimos]: [data de vencimento, prazo, vencendo em, programado para, vencimento da fatura, dia do pagamento, atraso] [Perguntas]: ["O que vence esta semana?", "Quais faturas estão atrasadas?", "Quais contas vencem amanhã?"] Descrição: Data limite para o pagamento do título sem a incidência de juros ou multa. Regra de Domínio: Títulos em atraso são identificados por DT_VENCIMENTO < CURRENT_DATE e VL_SALDO > 0.

CONTAS.ST_CONTAS​

[Sinônimos]: [status da conta, situação, estágio do título, estado da fatura, cancelada, pendente] [Perguntas]: ["Quais faturas foram canceladas?", "Mostre apenas o que já foi baixado.", "Quais títulos ainda não foram pagos?"] Descrição: Indica o estágio atual da conta no sistema (Pendente, Paga, Cancelada). Regra de Domínio: T=Pendente Total, P=Pago Parcial, L=Liquidada, C=Cancelada, A=Agrupada. SEMPRE filtrar ST_CONTAS <> 'C' para evitar títulos inválidos.

CONTAS.TP_CONTAS​

[Sinônimos]: [natureza da conta, direção do movimento, tipo de conta, entrada ou saída] [Perguntas]: ["Quanto tenho para pagar?", "Qual o total de receitas hoje?", "Listar contas a receber."] Descrição: Define se o lançamento é de entrada (Receber) ou saída (Pagar). Regra de Domínio: S=Contas a Receber (Entrada/Receita), E=Contas a Pagar (Saída/Despesa).

CONTAS.VL_DOCUMENTO​

[Sinônimos]: [valor original, valor bruto, valor de face, valor da nota, total do título] [Perguntas]: ["Qual o valor total da nota fiscal?", "Quanto foi a venda bruta?", "Qual o valor de face desta duplicata?"] Descrição: Valor nominal total da conta no momento do seu lançamento. Regra de Domínio: Valor fixo histórico. Não sofre alteração com baixas parciais ou juros de mora.

CONTAS.TP_DOCUMENTO​

[Sinônimos]: [tipo de nota, espécie, origem, documento legal, duplicata, nota fiscal, adiantamento, cheque] [Perguntas]: ["Quais títulos são adiantamentos?", "Listar apenas os cheques recebidos.", "Filtrar por notas fiscais."] Descrição: Identifica a origem legal ou operacional que gerou o registro financeiro. Regra de Domínio: DP=Duplicata, NT=Nota Fiscal, CH=Cheque, AD=Adiantamento, CT=Cartão.

CONTAS.DT_LIQUIDACAO​

[Sinônimos]: [data do pagamento, data da baixa, quando foi pago, data de quitação] [Perguntas]: ["Quando esta fatura foi quitada?", "Quais títulos foram pagos ontem?", "Quanto recebi na segunda-feira?"] Descrição: Data em que o título foi totalmente liquidado (VL_SALDO chegou a zero). Regra de Domínio: Fica nula (NULL) enquanto o título estiver pendente ou pago parcialmente.

CONTAS.NR_DOCUMENTO​

[Sinônimos]: [número da nota, número do boleto, número da fatura, documento impresso] [Perguntas]: ["Localizar a nota número 1234.", "Qual o saldo do boleto 5566?", "Verificar status da fatura 99."] Descrição: Número visual/impresso do documento que originou a conta. Regra de Domínio: Geralmente usado para buscas exatas por parte do usuário.

CONTAS.ST_CARTORIO​

[Sinônimos]: [cartorio, protesto, protestado, titulo protestado, em cartorio, cobranca judicial] [Perguntas]: ["Quais clientes tem contas em cartorio?", "Listar titulos protestados.", "Contas enviadas para protesto."] Descricao: Indica o estagio de cobranca judicial/cartorial do titulo. Regra de Dominio: N=Nao (default, titulo em cobranca administrativa normal), C=Em Cartorio (enviado para cartorio de protesto, aguardando efetivacao), S=Protestado (protesto efetivado em cartorio). Para filtrar titulos em cartorio OU protestados: ST_CARTORIO IN ('C', 'S'). Para excluir de cobranca administrativa: ST_CARTORIO = 'N'.

CONTAS.ST_INCOBRAVEL​

[Sinônimos]: [incobravel, perda, titulo perdido, calote, provisao para devedores duvidosos, PDD] [Perguntas]: ["Quais contas sao incobraveis?", "Total de perdas reconhecidas.", "Titulos marcados como incobraveis."] Descricao: Indica se o titulo foi reconhecido como perda (incobravel) pelo financeiro. Regra de Dominio: N=Nao (default, titulo cobravel), S=Sim (perda reconhecida). Titulos incobraveis devem ser excluidos de rankings e indicadores financeiros (ST_INCOBRAVEL = 'N').

CONTAS.ST_BOLETO​

[Sinônimos]: [status do boleto, situação do boleto, boleto enviado, boleto registrado] [Perguntas]: ["Quais boletos já foram registrados?", "Quais contas ainda não tiveram boleto gerado?", "Boletos com erro de envio."] Descrição: Indica o status do boleto bancário vinculado à conta. Regra de Domínio: N=Não Enviado (sem boleto registrado), I=Boleto Impresso, R=Boleto Registrado (confirmado pelo banco), D=Descontado, A=Enviado com Erro, F=Finalizado. Para contas sem boleto registrado via API: NR_NOSSONUMEROAPI IS NULL. Na MFC033, o status é derivado: CASE WHEN NR_NOSSONUMEROAPI IS NOT NULL THEN 'R' ELSE 'N' END.

CONTAS.NR_BOLETO​

[Sinônimos]: [número do boleto, sequência do boleto, identificador do boleto] [Perguntas]: ["Qual o número do boleto desta conta?", "Buscar conta pelo número do boleto."] Descrição: Número sequencial do boleto gerado para a conta, obtido da sequência configurada no cadastro de boleto (BOLETO.NM_SEQBOLETO). Regra de Domínio: Preenchido automaticamente pela procedure GERA_SEQUENCIA ao gerar o boleto na MFC033. NULL quando o boleto ainda não foi gerado.

CONTAS.NR_NOSSONUMEROAPI​

[Sinônimos]: [nosso número, nosso número API, número de registro no banco, identificador bancário] [Perguntas]: ["O boleto foi registrado no banco?", "Qual o nosso número desta conta?"] Descrição: Nosso número retornado pela API do banco após o registro do boleto. Indica que o boleto foi efetivamente registrado. Regra de Domínio: NULL quando o boleto não foi registrado. Preenchido indica boleto registrado com sucesso. Usado como critério para determinar se o boleto foi enviado: NR_NOSSONUMEROAPI IS NOT NULL = registrado.

CONTAS.DS_LINKBOLETO​

[Sinônimos]: [link do boleto, URL do boleto, endereço do boleto, PDF do boleto] [Perguntas]: ["Onde acessar o boleto?", "Qual o link para visualizar o boleto?"] Descrição: URL retornada pela API do banco para visualização/download do boleto em PDF. Regra de Domínio: Preenchido pela API após registro do boleto. Pode ser aberto no navegador pela MFC033.

CONTAS.DS_LINKGRUPO​

[Sinônimos]: [link do boleto agrupado, boleto em grupo, carnê] [Perguntas]: ["Existe um boleto agrupado para este lançamento?"] Descrição: URL para visualização de boletos agrupados (múltiplas parcelas em um único documento). Regra de Domínio: Preenchido pela API quando há agrupamento de parcelas. Pode ser aberto no navegador pela MFC033.

CONTAS.DS_ERROENVIOPEFIN​

[Sinônimos]: [erro do boleto, mensagem de erro, falha no envio, erro de registro] [Perguntas]: ["Por que o boleto não foi enviado?", "Qual o erro do boleto?"] Descrição: Mensagem de erro retornada pela API do banco quando o registro do boleto falha. Regra de Domínio: Campo memo. Preenchido apenas quando há erro no envio. Exibido na MFC033 quando não vazio.

CONTAS.VL_ABATIMENTOBOLETO​

[Sinônimos]: [abatimento do boleto, desconto no boleto, valor de abatimento] [Perguntas]: ["Qual o abatimento concedido neste boleto?"] Descrição: Valor de abatimento registrado no boleto bancário. Regra de Domínio: Valor informado na geração do boleto pela MFC033. Enviado ao banco via API.

CONTAS.CD_PIX​

[Sinônimos]: [código PIX, chave PIX, cobrança PIX] [Perguntas]: ["Esta conta tem cobrança PIX?", "Qual o PIX desta conta?"] Descrição: Código identificador da cobrança PIX vinculada à conta. Referencia a tabela PIX. Regra de Domínio: NULL quando não há cobrança PIX. Preenchido quando a cobrança é do tipo PIX (BOLETO.ST_APIBOLETOS = 'PX'). JOIN com tabela PIX para obter ORDERID e ORDERQRCODE (código copia-e-cola).

CONTAS.DS_OBSERVACAO​

[Sinônimos]: [observação, nota, comentário, informação adicional] [Perguntas]: ["Qual a observação desta conta?"] Descrição: Campo de texto livre para observações sobre a conta. Editável na MFC033 durante o processo de geração de boletos. Regra de Domínio: Atualizado junto com a geração do boleto na MFC033.

Telas que usam esta tabela​

Consulte a seção CONTAS no Mapa de Impacto para ver todas as telas (producers/consumers) que operam sobre esta tabela.