Modulo de Faturamento (FAT)

Visao Geral

O modulo de Faturamento (SIGAFAT) do TOTVS Protheus gerencia todo o ciclo de vendas da empresa, desde o cadastro de clientes e tabelas de precos ate a emissao de notas fiscais de saida e transmissao eletronica (NF-e). Ele abrange orcamentos, pedidos de venda, liberacao de credito e estoque, faturamento (emissao de documentos de saida) e integracao com os modulos de Estoque, Financeiro, Fiscal e Contabilidade.

Prefixo do modulo: FAT Sigla do ambiente: SIGAFAT Prefixo das rotinas: MATA4xx (ex: MATA410, MATA440, MATA450, MATA455, MATA460, MATA461), FATA0xx (ex: FATA050), OMSA0xx (ex: OMSA010)

Ciclo principal de faturamento

Orcamento → Pedido de Venda → Liberacao (Credito + Estoque) → Documento de Saida (NF) → Transmissao NF-e → Titulo a Receber

O modulo permite tanto o fluxo completo (com orcamento e analise de credito/estoque) quanto o fluxo simplificado (pedido direto com faturamento), controlado pelo parametro MV_BLOQUEI.

Tabelas Principais

SC5 - Pedidos de Venda (Cabecalho)

Armazena o cabecalho dos pedidos de venda. Cada registro representa um pedido vinculado a um cliente.

Indices principais:

• Ordem 1: C5_FILIAL + C5_NUM
• Ordem 2: C5_FILIAL + C5_CLIENTE + C5_LOJACLI + C5_NUM
• Ordem 3: C5_FILIAL + C5_EMISSAO + C5_NUM

SC6 - Pedidos de Venda (Itens)

Armazena os itens dos pedidos de venda. Cada registro representa um item do pedido vinculado ao cabecalho SC5.

Indices principais:

• Ordem 1: C6_FILIAL + C6_NUM + C6_ITEM
• Ordem 2: C6_FILIAL + C6_PRODUTO + C6_NUM + C6_ITEM
• Ordem 3: C6_FILIAL + C6_CLI + C6_LOJA + C6_NUM + C6_ITEM

SC9 - Itens Liberados do Pedido de Venda

Armazena as liberacoes dos itens do pedido de venda. Gerada pela rotina de liberacao (MATA440/MATA456), controla os bloqueios de credito e estoque. Cada registro pode ter status liberado ou bloqueado.

Indices principais:

• Ordem 1: C9_FILIAL + C9_PEDIDO + C9_ITEM
• Ordem 2: C9_FILIAL + C9_CLIENTE + C9_LOJA + C9_PEDIDO

SF2 - Cabecalho de NF de Saida

Armazena o cabecalho das notas fiscais de saida, gerado pelo processo de faturamento (MATA460/MATA461).

Indices principais:

• Ordem 1: F2_FILIAL + F2_DOC + F2_SERIE + F2_CLIENTE + F2_LOJA + F2_TIPO
• Ordem 2: F2_FILIAL + F2_CLIENTE + F2_LOJA + F2_DOC
• Ordem 3: F2_FILIAL + F2_EMISSAO + F2_DOC

SD2 - Itens de Nota Fiscal de Saida

Armazena os itens do documento de saida (NF). Gerada no faturamento do pedido de venda.

Indices principais:

• Ordem 1: D2_FILIAL + D2_DOC + D2_SERIE + D2_CLIENTE + D2_LOJA + D2_COD + D2_ITEM
• Ordem 2: D2_FILIAL + D2_COD + D2_DOC + D2_SERIE
• Ordem 3: D2_FILIAL + D2_EMISSAO + D2_DOC + D2_SERIE
• Ordem 4: D2_FILIAL + D2_PEDIDO + D2_ITEMPV

SA1 - Clientes (referencia)

Cadastro mestre de clientes, consultado em todo o ciclo de faturamento.

Indices principais:

• Ordem 1: A1_FILIAL + A1_COD + A1_LOJA
• Ordem 2: A1_FILIAL + A1_NOME
• Ordem 3: A1_FILIAL + A1_CGC

DA0 / DA1 - Tabela de Precos

DA0 armazena o cabecalho da tabela de precos e DA1 armazena os itens (produtos e seus precos). Consultada na inclusao de pedidos de venda para definir o preco de venda dos produtos.

DA0 - Cabecalho da Tabela de Precos:

DA1 - Itens da Tabela de Precos:

Indices principais (DA1):

• Ordem 1: DA1_FILIAL + DA1_CODTAB + DA1_CODPRO
• Ordem 2: DA1_FILIAL + DA1_CODPRO + DA1_CODTAB

SE1 - Titulos a Receber (referencia)

Titulos financeiros gerados automaticamente ao faturar o pedido de venda, representando os creditos a receber do cliente.

Indices principais:

• Ordem 1: E1_FILIAL + E1_PREFIXO + E1_NUM + E1_PARCELA + E1_TIPO
• Ordem 2: E1_FILIAL + E1_CLIENTE + E1_LOJA + E1_PREFIXO + E1_NUM
• Ordem 3: E1_FILIAL + E1_VENCTO

Rotinas Principais

MATA030 - Cadastro de Clientes

O que faz: Permite incluir, alterar, excluir e visualizar o cadastro de clientes na tabela SA1. E o cadastro mestre utilizado em todo o ciclo de faturamento, contendo dados comerciais (limite de credito, risco, vendedor, condicao de pagamento) e fiscais (CNPJ, IE, endereco). A partir do Protheus 12, a rotina CRMA980 (MVC) substitui progressivamente o MATA030 quando MV_MVCSA1 esta habilitado.

Tabelas envolvidas:

• SA1 (escrita) - Cadastro de Clientes
• SA3 (leitura) - Cadastro de Vendedores
• SE4 (leitura) - Condicoes de Pagamento
• AI0 (leitura) - IBGE (Municipios)

Parametros relevantes:

Pontos de entrada:

OMSA010 - Tabela de Precos

O que faz: Permite o cadastro e manutencao de tabelas de precos (DA0/DA1). Define os precos de venda dos produtos por tabela, com controle de vigencia, status (ativa/inativa) e desconto maximo. As tabelas de precos sao consultadas automaticamente na inclusao de pedidos de venda.

Tabelas envolvidas:

• DA0 (escrita) - Cabecalho da Tabela de Precos
• DA1 (escrita) - Itens da Tabela de Precos
• SB1 (leitura) - Cadastro de Produtos

Parametros relevantes:

Pontos de entrada:

MATA410 - Pedido de Venda

O que faz: Permite incluir, alterar, excluir e visualizar pedidos de venda. E a rotina central do ciclo de faturamento, formalizando a venda de produtos ou servicos ao cliente com condicoes comerciais (precos, descontos, prazos, tabela de precos). O pedido pode ser gerado manualmente, a partir de um orcamento, ou automaticamente via ExecAuto (integracao e-commerce, EDI, etc.).

O codigo-fonte do MATA410 foi modularizado em processos incrementais, sendo o MATA410 padrao (BASE) responsavel pelas operacoes de inclusao, alteracao, exclusao, visualizacao, browse e interfaces.

Tabelas envolvidas:

• SC5 (escrita) - Cabecalho do Pedido de Venda
• SC6 (escrita) - Itens do Pedido de Venda
• SA1 (leitura) - Cadastro de Clientes
• SB1 (leitura) - Cadastro de Produtos
• DA0/DA1 (leitura) - Tabela de Precos
• SE4 (leitura) - Condicoes de Pagamento
• SA3 (leitura) - Cadastro de Vendedores
• SB2 (leitura) - Saldos por Armazem

Parametros relevantes:

Pontos de entrada:

MATA440 - Liberacao de Pedidos de Venda

O que faz: Controla a liberacao dos pedidos de venda para faturamento, aplicando analise de credito do cliente e disponibilidade de estoque dos produtos. Os pedidos aptos para liberacao sao aqueles com status de "Pedido de Venda em Aberto". Gera registros na tabela SC9 (Itens Liberados), controlando as quantidades liberadas, bloqueadas por credito e bloqueadas por estoque.

Possui dois modos de operacao:

• Manual: apresenta os dados do pedido para verificacao e permite definir a quantidade a faturar.
• Automatico: libera um grupo de pedidos com base em parametros, avaliando credito do cliente, estoque disponivel e data de entrega.

Se existem 100 unidades em estoque e o usuario libera 180, sao gerados 2 registros na SC9: o primeiro com 100 unidades liberadas e o segundo com 80 unidades bloqueadas por estoque.

Tabelas envolvidas:

• SC9 (escrita) - Itens Liberados do Pedido
• SC5 (leitura/escrita) - Cabecalho do Pedido (atualiza C5_LIBEROK, C5_BLQ)
• SC6 (leitura) - Itens do Pedido de Venda
• SA1 (leitura) - Cadastro de Clientes (verifica credito)
• SB2 (leitura) - Saldos por Armazem (verifica estoque)

Parametros relevantes:

Pontos de entrada:

MATA450 - Analise de Credito

O que faz: Permite avaliar o credito do cliente por pedido de venda, analisando sua situacao quanto a classificacao de risco (A1_RISCO), limite de credito (A1_LC) e data de vencimento desse limite (A1_VENCLC). O valor em analise e somado aos titulos em aberto (SE1) e pedidos em aberto (SC5/SC6) e comparado com o limite de credito, desde que a data de validade seja superior a data corrente.

Possui dois modos:

• Automatico: reavalia credito conforme parametros de risco, limite e vencimento.
• Manual: permite liberar ou bloquear credito independente da avaliacao parametrica.

Tabelas envolvidas:

• SC9 (leitura/escrita) - Itens Liberados (atualiza C9_BLCRED)
• SA1 (leitura) - Cadastro de Clientes (risco, limite, vencimento)
• SE1 (leitura) - Titulos a Receber (titulos em aberto)
• SC5/SC6 (leitura) - Pedidos em Aberto

Parametros relevantes:

MATA455 - Liberacao de Estoque

O que faz: Permite verificar e liberar os itens de pedidos bloqueados por insuficiencia de estoque. Utilizada quando e necessario liberar em qualquer circunstancia, mesmo com estoque negativo.

Possui dois modos:

• Automatico: reprocessa a analise de estoque; se houver saldo suficiente apos reposicao, libera o pedido automaticamente.
• Manual: permite liberar o bloqueio independentemente do saldo, podendo deixar o estoque negativo (quando MV_ESTNEG permite).

Tabelas envolvidas:

• SC9 (leitura/escrita) - Itens Liberados (atualiza C9_BLEST)
• SB2 (leitura) - Saldos por Armazem

Parametros relevantes:

Pontos de entrada:

MATA460 / MATA461 - Documento de Saida (Nota Fiscal de Saida)

O que faz: MATA460 (interface/selecao de pedidos) e MATA461 (processamento/geracao) sao as rotinas de faturamento que geram a nota fiscal de saida (SF2/SD2) a partir dos pedidos de venda liberados. Os documentos de saida sao preparados para finalizar o processo de expedicao de mercadorias e/ou prestacao de servicos, gerando diferentes documentos: Nota Fiscal, Complemento de Preco, Complemento de ICMS, Complemento de IPI, Devolucao de Compra e Beneficiamento, conforme definido no pedido de venda.

Para que os documentos de saida sejam emitidos, os pedidos de venda devem estar liberados pela analise de credito do cliente e pela disponibilidade de estoque (SC9 sem bloqueios).

A rotina MATA460A e a versao mais recente, com interface modernizada.

Tabelas envolvidas:

• SF2 (escrita) - Cabecalho NF de Saida
• SD2 (escrita) - Itens NF de Saida
• SC5 (leitura/escrita) - Cabecalho do Pedido (atualiza C5_NOTA, C5_SERIE)
• SC6 (leitura/escrita) - Itens do Pedido (atualiza C6_QTDENT, C6_NOTA, C6_SERIE)
• SC9 (leitura/escrita) - Itens Liberados (atualiza vinculo com NF)
• SD3 (escrita) - Movimentacoes de Estoque (baixa)
• SE1 (escrita) - Titulos a Receber
• SFT (escrita) - Livros Fiscais
• CT2 (escrita) - Lancamentos Contabeis
• SA1 (leitura) - Cadastro de Clientes
• SB1 (leitura) - Cadastro de Produtos
• SB2 (leitura/escrita) - Saldos por Armazem (baixa de estoque)

Parametros relevantes:

Pontos de entrada:

MATA430 - Controle de Reservas

O que faz: Gerencia as reservas de estoque vinculadas aos pedidos de venda. Quando uma reserva excede o prazo de validade definido em MV_PZRESER e nao esta vinculada a nenhum pedido ativo, ao logar no modulo SIGAFAT, o processo de depuracao exclui automaticamente as reservas vencidas e atualiza o campo B2_RESERVA.

Tabelas envolvidas:

• SB2 (leitura/escrita) - Saldos por Armazem (atualiza B2_RESERVA)
• SC6 (leitura) - Itens do Pedido de Venda

SPEDNFE (NF-e SEFAZ) - Transmissao de NF-e

O que faz: Rotina de transmissao da Nota Fiscal Eletronica (NF-e) para a SEFAZ (Secretaria da Fazenda). Acessada no SIGAFAT em Atualizacoes > NF-e e NFS-e > NF-e Sefaz (SPEDNFE), com a opcao Transmissao. Permite transmitir, consultar status, cancelar e inutilizar numeracao de NF-e.

Integra com o TSS (TOTVS Service SOA) para comunicacao com os web services da SEFAZ. Suporta contingencia automatica em caso de indisponibilidade da SEFAZ.

Tabelas envolvidas:

• SF2 (leitura/escrita) - Cabecalho NF de Saida (atualiza F2_CHVNFE, status de transmissao)
• SD2 (leitura) - Itens NF de Saida

Processos de Negocio

Fluxo Completo de Faturamento

┌─────────────────┐     ┌─────────────────┐     ┌─────────────────┐
│  1. Pedido de    │────>│  2. Liberacao    │────>│  3. Analise de   │
│  Venda           │     │  (MATA440)       │     │  Credito          │
│  MATA410/SC5+SC6 │     │  SC9             │     │  MATA450/SA1+SE1  │
└─────────────────┘     └─────────────────┘     └────────┬────────┘
                                                          │
┌─────────────────┐     ┌─────────────────┐     ┌────────v────────┐
│  6. Titulo a     │<────│  5. Transmissao  │<────│  4. Documento    │
│  Receber         │     │  NF-e            │     │  de Saida         │
│  SE1             │     │  SPEDNFE         │     │  MATA460-461      │
└─────────────────┘     └─────────────────┘     │  SF2+SD2          │
                                                 └─────────────────┘

Passo 1: Pedido de Venda (MATA410)

Passo 2: Liberacao de Pedidos (MATA440)

Passo 3: Analise de Credito e Estoque (MATA450/MATA455)

Passo 4: Documento de Saida (MATA460/MATA461)

Passo 5: Transmissao NF-e (SPEDNFE)

Passo 6: Titulo a Receber (SE1)

Fluxo Simplificado (sem liberacao separada)

Pedido de Venda (SC5/SC6) → Documento de Saida (SF2/SD2) → Transmissao NF-e → Titulo a Receber (SE1)

Quando MV_BLOQUEI estiver desabilitado (.F.), o pedido pode ser faturado diretamente sem etapa intermediaria de liberacao.

Regras de Negocio

Campos obrigatorios por rotina

Pedido de Venda (MATA410 - SC5/SC6):

• C5_CLIENTE + C5_LOJACLI (Cliente)
• C5_CONDPAG (Condicao de pagamento)
• C5_TIPO (Tipo do pedido)
• C6_PRODUTO (Codigo do produto)
• C6_QTDVEN (Quantidade vendida)
• C6_PRCVEN (Preco unitario de venda)
• C6_TES (Tipo de Entrada/Saida)
• C6_LOCAL (Armazem)

Documento de Saida (MATA460/461 - SD2):

• D2_COD (Codigo do produto)
• D2_QUANT (Quantidade)
• D2_PRCVEN (Preco de venda)
• D2_TES (Tipo de Entrada/Saida)
• D2_DOC (Numero do documento)
• D2_SERIE (Serie da NF)
• D2_LOCAL (Armazem)

Validacoes principais

Gatilhos SX7 relevantes

Pontos de entrada mais utilizados no modulo

Integracoes

Faturamento → Estoque

Faturamento → Financeiro

Faturamento → Fiscal

Faturamento → Contabilidade

Faturamento → Comissoes

Resumo das integracoes no Documento de Saida

                         MATA461 - Documento de Saida
                                     │
                    ┌────────────────┼────────────────┐
                    │                │                │
              ┌─────v─────┐   ┌─────v─────┐   ┌─────v─────┐
              │  Estoque   │   │ Financeiro│   │   Fiscal  │
              │ SD3 / SB2  │   │  SE1/SE3  │   │ SFT / SF3 │
              └───────────┘   └───────────┘   └───────────┘
                    │                                │
              ┌─────v─────┐                   ┌──────v──────┐
              │  Reservas  │                   │Contabilidade│
              │ B2_RESERVA │                   │     CT2     │
              └───────────┘                   └─────────────┘
                                                     │
                                              ┌──────v──────┐
                                              │  NF-e SEFAZ │
                                              │   SPEDNFE   │
                                              └─────────────┘

Cadastros Auxiliares

Parametros Globais do Modulo (MV_*)