Modulo de Compras (COM)
Documentacao completa do modulo de Compras (SIGACOM) do TOTVS Protheus - ciclo de aquisicao, tabelas, rotinas, regras de negocio e integracoes
Modulo de Compras (COM)
Visao Geral
O modulo de Compras (SIGACOM) do TOTVS Protheus gerencia todo o ciclo de aquisicao de materiais e servicos da empresa. Ele abrange desde a identificacao da necessidade de compra ate o recebimento fisico e fiscal dos materiais, integrando-se diretamente com os modulos de Estoque, Financeiro, Fiscal e Contabilidade.
Prefixo do modulo: COM Sigla do ambiente: SIGACOM Prefixo das rotinas: MATA1xx (ex: MATA110, MATA120, MATA121, MATA130, MATA131, MATA140)
Ciclo principal de compras
Necessidade → Solicitacao de Compra → Cotacao → Analise de Cotacao → Pedido de Compra → Documento de Entrada → Titulo a PagarO modulo permite tanto o fluxo completo (com cotacao) quanto o fluxo simplificado (pedido direto sem cotacao), controlado pelo parametro MV_RESTINC.
Tabelas Principais
SC1 - Solicitacoes de Compra
Armazena as solicitacoes de compra geradas manualmente ou via MRP/Ponto de Pedido. Cada registro representa um item solicitado.
| Campo | Tipo | Tam | Descricao |
|---|---|---|---|
| C1_FILIAL | C | 8 | Filial |
| C1_NUM | C | 6 | Numero da solicitacao |
| C1_ITEM | C | 4 | Item da solicitacao |
| C1_PRODUTO | C | 15 | Codigo do produto |
| C1_DESCRI | C | 30 | Descricao do produto |
| C1_UM | C | 2 | Unidade de medida |
| C1_QUANT | N | 12,2 | Quantidade solicitada |
| C1_QUJE | N | 12,2 | Quantidade ja atendida |
| C1_EMISSAO | D | 8 | Data de emissao |
| C1_DATPRF | D | 8 | Data de necessidade (previsao) |
| C1_SOLICIT | C | 25 | Nome do solicitante |
| C1_OBS | C | 40 | Observacoes |
| C1_LOCAL | C | 2 | Armazem destino |
| C1_CC | C | 9 | Centro de custo |
| C1_CONTA | C | 20 | Conta contabil |
| C1_ITEMCTA | C | 9 | Item contabil |
| C1_CLVL | C | 9 | Classe de valor |
| C1_CODCOMP | C | 25 | Codigo do comprador |
| C1_APESSION | C | 1 | Status da aprovacao: L=Liberada, B=Bloqueada, R=Residuo |
| C1_QECON | N | 12,2 | Quantidade economica |
| C1_IMPORT | C | 1 | Importacao (S/N) |
| C1_OP | C | 13 | Ordem de producao vinculada |
| C1_GRUPCOM | C | 3 | Grupo de compras |
| C1_TPSC | C | 3 | Tipo de solicitacao de compra |
Indices principais:
- Ordem 1:
C1_FILIAL + C1_NUM + C1_ITEM - Ordem 2:
C1_FILIAL + C1_PRODUTO + C1_NUM + C1_ITEM - Ordem 3:
C1_FILIAL + C1_EMISSAO + C1_NUM + C1_ITEM - Ordem 4:
C1_FILIAL + C1_CODCOMP + C1_NUM + C1_ITEM
SC7 - Itens do Pedido de Compra
Armazena os itens dos pedidos de compra. Cada registro e um item do pedido, vinculado a um fornecedor.
| Campo | Tipo | Tam | Descricao |
|---|---|---|---|
| C7_FILIAL | C | 8 | Filial |
| C7_NUM | C | 6 | Numero do pedido |
| C7_ITEM | C | 4 | Item do pedido |
| C7_PRODUTO | C | 15 | Codigo do produto |
| C7_DESCRI | C | 30 | Descricao do produto |
| C7_UM | C | 2 | Unidade de medida |
| C7_QUANT | N | 12,2 | Quantidade |
| C7_QUJE | N | 12,2 | Quantidade ja entregue |
| C7_PRECO | N | 14,2 | Preco unitario |
| C7_TOTAL | N | 14,2 | Valor total do item |
| C7_IPI | N | 5,2 | Percentual de IPI |
| C7_VALIPI | N | 14,2 | Valor de IPI |
| C7_ICMS | N | 5,2 | Percentual de ICMS |
| C7_VALICM | N | 14,2 | Valor de ICMS |
| C7_FORNECE | C | 6 | Codigo do fornecedor |
| C7_LOJA | C | 2 | Loja do fornecedor |
| C7_COND | C | 3 | Condicao de pagamento |
| C7_CONTATO | C | 20 | Contato no fornecedor |
| C7_DATPRF | D | 8 | Data de previsao de entrega |
| C7_EMISSAO | D | 8 | Data de emissao |
| C7_NUMSC | C | 6 | Numero da SC vinculada |
| C7_ITEMSC | C | 4 | Item da SC vinculada |
| C7_CC | C | 9 | Centro de custo |
| C7_CONTA | C | 20 | Conta contabil |
| C7_ITEMCTA | C | 9 | Item contabil |
| C7_CLVL | C | 9 | Classe de valor |
| C7_RESIDUO | C | 1 | Residuo (S/N) |
| C7_COTEFET | C | 6 | Numero da cotacao efetivada |
| C7_APESSION | C | 1 | Status aprovacao: L=Liberado, B=Bloqueado, R=Residuo |
| C7_LOCAL | C | 2 | Armazem destino |
| C7_NUMCOT | C | 6 | Numero da cotacao |
| C7_ITEMCOT | C | 4 | Item da cotacao |
| C7_TES | C | 3 | Tipo de entrada/saida (TES) |
| C7_CODCOMP | C | 25 | Codigo do comprador |
| C7_GRUPCOM | C | 3 | Grupo de compras |
| C7_OBSM | M | 10 | Observacoes (memo) |
| C7_TPSC | C | 3 | Tipo de compra |
Indices principais:
- Ordem 1:
C7_FILIAL + C7_NUM + C7_ITEM - Ordem 2:
C7_FILIAL + C7_FORNECE + C7_LOJA + C7_NUM + C7_ITEM - Ordem 3:
C7_FILIAL + C7_EMISSAO + C7_NUM + C7_ITEM - Ordem 4:
C7_FILIAL + C7_PRODUTO + C7_NUM + C7_ITEM - Ordem 5:
C7_FILIAL + C7_NUMSC + C7_ITEMSC
SC8 - Cotacoes
Armazena os itens de cotacao enviados aos fornecedores. Cada registro representa a proposta de um fornecedor para um item cotado.
| Campo | Tipo | Tam | Descricao |
|---|---|---|---|
| C8_FILIAL | C | 8 | Filial |
| C8_NUM | C | 6 | Numero da cotacao |
| C8_ITEM | C | 4 | Item da cotacao |
| C8_PRODUTO | C | 15 | Codigo do produto |
| C8_DESCRI | C | 30 | Descricao do produto |
| C8_UM | C | 2 | Unidade de medida |
| C8_QUANT | N | 12,2 | Quantidade cotada |
| C8_PRECO | N | 14,2 | Preco unitario proposto |
| C8_TOTAL | N | 14,2 | Valor total do item |
| C8_FORNECE | C | 6 | Codigo do fornecedor |
| C8_LOJA | C | 2 | Loja do fornecedor |
| C8_COND | C | 3 | Condicao de pagamento |
| C8_DATPRF | D | 8 | Data prevista de entrega |
| C8_EMISSAO | D | 8 | Data de emissao |
| C8_NUMSC | C | 6 | Numero da SC origem |
| C8_ITEMSC | C | 4 | Item da SC origem |
| C8_IPI | N | 5,2 | Percentual IPI |
| C8_ICMS | N | 5,2 | Percentual ICMS |
| C8_PRAZO | N | 3 | Prazo de entrega em dias |
| C8_APROV | C | 1 | Aprovada: S=Sim, N=Nao |
| C8_TOTPCO | N | 14,2 | Valor total do pedido de cotacao |
| C8_ITEMPCO | N | 14,2 | Valor total por item do pedido de cotacao |
| C8_CODGRP | C | 3 | Grupo de compras |
| C8_CODITE | C | 4 | Item do grupo |
| C8_TAXAFIN | N | 6,2 | Taxa de financiamento |
Indices principais:
- Ordem 1:
C8_FILIAL + C8_NUM + C8_ITEM + C8_FORNECE + C8_LOJA - Ordem 2:
C8_FILIAL + C8_PRODUTO + C8_NUM - Ordem 3:
C8_FILIAL + C8_FORNECE + C8_LOJA + C8_NUM
SA5 - Amarracao Produto x Fornecedor
Registra o vinculo entre produtos e seus respectivos fornecedores, incluindo historico de precos, condicoes e avaliacao de qualificacao.
| Campo | Tipo | Tam | Descricao |
|---|---|---|---|
| A5_FILIAL | C | 8 | Filial |
| A5_FORNECE | C | 6 | Codigo do fornecedor |
| A5_LOJA | C | 2 | Loja do fornecedor |
| A5_PRODUTO | C | 15 | Codigo do produto |
| A5_NOMPROD | C | 30 | Descricao do produto |
| A5_CODPRF | C | 20 | Codigo do produto no fornecedor |
| A5_COND | C | 3 | Condicao de pagamento padrao |
| A5_PRECO | N | 14,2 | Ultimo preco praticado |
| A5_QUANT | N | 12,2 | Quantidade minima de compra |
| A5_LEATIME | N | 4 | Lead time (prazo de entrega em dias) |
| A5_QUALIF | N | 3 | Qualificacao/nota do fornecedor |
| A5_DTREF | D | 8 | Data de referencia do preco |
| A5_PRIORI | N | 2 | Prioridade do fornecedor para este produto |
Indices principais:
- Ordem 1:
A5_FILIAL + A5_FORNECE + A5_LOJA + A5_PRODUTO - Ordem 2:
A5_FILIAL + A5_PRODUTO + A5_FORNECE + A5_LOJA
SA2 - Fornecedores (referencia)
Cadastro mestre de fornecedores, consultado em todo o ciclo de compras.
| Campo | Tipo | Tam | Descricao |
|---|---|---|---|
| A2_FILIAL | C | 8 | Filial |
| A2_COD | C | 6 | Codigo do fornecedor |
| A2_LOJA | C | 2 | Loja |
| A2_NOME | C | 40 | Razao social |
| A2_NREDUZ | C | 20 | Nome reduzido |
| A2_CGC | C | 14 | CNPJ/CPF |
| A2_INSCR | C | 18 | Inscricao estadual |
| A2_END | C | 40 | Endereco |
| A2_EST | C | 2 | Estado |
| A2_MUN | C | 30 | Municipio |
| A2_CEP | C | 8 | CEP |
| A2_TEL | C | 15 | Telefone |
| A2_EMAIL | C | 50 | |
| A2_CONTATO | C | 20 | Nome do contato |
| A2_TIPO | C | 1 | Tipo: F=Fisico, J=Juridico, X=Exterior |
| A2_COND | C | 3 | Condicao de pagamento padrao |
| A2_MSBLQL | C | 1 | Bloqueado (1=Sim, 2=Nao) |
Indices principais:
- Ordem 1:
A2_FILIAL + A2_COD + A2_LOJA - Ordem 2:
A2_FILIAL + A2_NOME - Ordem 3:
A2_FILIAL + A2_CGC
SD1 - Itens de Nota Fiscal de Entrada (referencia)
Armazena os itens do documento de entrada (NF). Gerada ao classificar o documento de entrada vinculado ao pedido de compra.
| Campo | Tipo | Tam | Descricao |
|---|---|---|---|
| D1_FILIAL | C | 8 | Filial |
| D1_DOC | C | 9 | Numero do documento |
| D1_SERIE | C | 3 | Serie |
| D1_FORNECE | C | 6 | Codigo do fornecedor |
| D1_LOJA | C | 2 | Loja do fornecedor |
| D1_COD | C | 15 | Codigo do produto |
| D1_ITEM | C | 4 | Item |
| D1_QUANT | N | 12,2 | Quantidade |
| D1_VUNIT | N | 14,2 | Valor unitario |
| D1_TOTAL | N | 14,2 | Valor total |
| D1_TES | C | 3 | Tipo de entrada/saida |
| D1_PEDIDO | C | 6 | Numero do pedido de compra vinculado |
| D1_ITEMPC | C | 4 | Item do pedido de compra |
| D1_LOCAL | C | 2 | Armazem destino |
| D1_DTDIGIT | D | 8 | Data de digitacao |
| D1_EMISSAO | D | 8 | Data de emissao da NF |
Indices principais:
- Ordem 1:
D1_FILIAL + D1_DOC + D1_SERIE + D1_FORNECE + D1_LOJA + D1_COD + D1_ITEM - Ordem 2:
D1_FILIAL + D1_COD + D1_DOC + D1_SERIE
SF1 - Cabecalho de NF de Entrada (referencia)
Cabecalho da nota fiscal de entrada, criada no momento da classificacao do documento de entrada.
| Campo | Tipo | Tam | Descricao |
|---|---|---|---|
| F1_FILIAL | C | 8 | Filial |
| F1_DOC | C | 9 | Numero do documento |
| F1_SERIE | C | 3 | Serie |
| F1_FORNECE | C | 6 | Codigo do fornecedor |
| F1_LOJA | C | 2 | Loja do fornecedor |
| F1_EMISSAO | D | 8 | Data de emissao |
| F1_DTDIGIT | D | 8 | Data de digitacao |
| F1_VALBRUT | N | 14,2 | Valor bruto |
| F1_VALMERC | N | 14,2 | Valor das mercadorias |
| F1_FRETE | N | 14,2 | Valor do frete |
| F1_SEGURO | N | 14,2 | Valor do seguro |
| F1_DESPESA | N | 14,2 | Despesas acessorias |
| F1_DESCONT | N | 14,2 | Desconto |
| F1_VALICM | N | 14,2 | Valor de ICMS |
| F1_VALIPI | N | 14,2 | Valor de IPI |
| F1_TIPO | C | 1 | Tipo da NF: N=Normal, D=Devolucao, C=Complemento |
| F1_COND | C | 3 | Condicao de pagamento |
| F1_CHVNFE | C | 44 | Chave da NFe |
Indices principais:
- Ordem 1:
F1_FILIAL + F1_DOC + F1_SERIE + F1_FORNECE + F1_LOJA + F1_TIPO - Ordem 2:
F1_FILIAL + F1_FORNECE + F1_LOJA + F1_DOC
SE2 - Titulos a Pagar (referencia)
Titulos financeiros gerados automaticamente ao classificar o documento de entrada, representando as obrigacoes de pagamento ao fornecedor.
| Campo | Tipo | Tam | Descricao |
|---|---|---|---|
| E2_FILIAL | C | 8 | Filial |
| E2_PREFIXO | C | 3 | Prefixo do titulo |
| E2_NUM | C | 9 | Numero do titulo |
| E2_PARCELA | C | 1 | Parcela |
| E2_TIPO | C | 3 | Tipo do titulo (NF, DP, etc.) |
| E2_FORNECE | C | 6 | Codigo do fornecedor |
| E2_LOJA | C | 2 | Loja do fornecedor |
| E2_EMISSAO | D | 8 | Data de emissao |
| E2_VENCTO | D | 8 | Data de vencimento |
| E2_VALOR | N | 14,2 | Valor do titulo |
| E2_SALDO | N | 14,2 | Saldo em aberto |
| E2_HIST | C | 40 | Historico |
| E2_NATUREZ | C | 10 | Natureza financeira |
Indices principais:
- Ordem 1:
E2_FILIAL + E2_PREFIXO + E2_NUM + E2_PARCELA + E2_TIPO + E2_FORNECE + E2_LOJA - Ordem 2:
E2_FILIAL + E2_FORNECE + E2_LOJA + E2_PREFIXO + E2_NUM
Rotinas Principais
MATA110 - Solicitacao de Compras
O que faz: Permite incluir, alterar, excluir e visualizar solicitacoes de compra. E o ponto de partida do ciclo de compras, formalizando a necessidade de aquisicao de materiais ou servicos.
Tabelas envolvidas:
- SC1 (escrita) - Solicitacoes de Compra
- SB1 (leitura) - Cadastro de Produtos
- SA2 (leitura) - Cadastro de Fornecedores
- CTT (leitura) - Centro de Custo
Parametros relevantes:
| Parametro | Descricao |
|---|---|
| MV_SCLCNI | Habilita controle de numeracao sequencial da SC por filial |
| MV_SEQESP | Habilita sequencia especifica para numeracao de SC |
| MV_RESTSOL | Restringe solicitantes de produtos |
| MV_RESTCOM | Restringe acesso as solicitacoes por comprador |
Pontos de entrada:
| Ponto de Entrada | Descricao |
|---|---|
| MT110BRW | Adiciona opcoes no menu da rotina |
| MT110VLD | Valida o registro na Solicitacao de Compras |
| ITMT110 | Inclui campos customizados na SC1 |
| MT106SC1 | Apos gravacao da SC, manipula informacoes em tabelas relacionadas |
MATA131 - Gerar Cotacoes
O que faz: Gera cotacoes a partir das solicitacoes de compra aprovadas. Envia propostas aos fornecedores vinculados (via SA5 - Produto x Fornecedor) para que informem precos, prazos e condicoes. Pode enviar e-mail automatico ao fornecedor se MV_ENVCOT estiver habilitado.
Tabelas envolvidas:
- SC1 (leitura) - Solicitacoes de Compra (origem)
- SC8 (escrita) - Cotacoes
- SA5 (leitura) - Amarracao Produto x Fornecedor
- SA2 (leitura) - Cadastro de Fornecedores
Parametros relevantes:
| Parametro | Descricao |
|---|---|
| MV_ENVCOT | Envia e-mail de cotacao automaticamente ao fornecedor |
Pontos de entrada:
| Ponto de Entrada | Descricao |
|---|---|
| MT131VAL | Verifica se a cotacao pode ser gerada |
| MT131MNU | Inclusao de novas rotinas na geracao de cotacoes |
| MT131C8 | Exibe informacoes de outros campos da SC8 no grid de fornecedores |
MATA130 - Analise de Cotacoes (Atualizar Cotacoes)
O que faz: Permite registrar as respostas dos fornecedores (precos, prazos, condicoes) nas cotacoes geradas. Compara propostas lado a lado, possibilitando selecionar a melhor oferta para cada item. Fornece historico de analise do fornecedor: saldo historico, maiores compras, titulos pagos, faturamento, informacoes fiscais, garantia estendida, ultimos pedidos e consumo medio.
Tabelas envolvidas:
- SC8 (leitura/escrita) - Cotacoes
- SA5 (leitura) - Amarracao Produto x Fornecedor
- SA2 (leitura) - Cadastro de Fornecedores
- SC1 (leitura) - Solicitacoes de Compra
- SC7 (escrita) - Pedido de Compra (quando gera pedido a partir da analise)
Pontos de entrada:
| Ponto de Entrada | Descricao |
|---|---|
| MT130COR | Regras para cores dos status na MarkBrowse |
| AVALCOT | Manipula dados da SC7 ao gerar pedido a partir da cotacao |
| MT130FIM | Executado ao finalizar a analise de cotacao |
MATA120 / MATA121 - Pedido de Compras
O que faz: MATA120 e a rotina de processamento (backend) e MATA121 e a interface de manutencao (browse/tela). O Pedido de Compra e um contrato formal entre a empresa e o fornecedor, representando as condicoes da negociacao: material, quantidade, qualidade, frequencia de entregas, prazos, precos, local de entrega, tributacao, entre outros.
O pedido pode ser gerado:
- Manualmente (inclusao direta)
- A partir de uma Solicitacao de Compra previamente cadastrada
- Automaticamente a partir da analise da melhor cotacao (MATA130)
Tabelas envolvidas:
- SC7 (escrita) - Itens do Pedido de Compra
- SC1 (leitura/escrita) - Solicitacoes de Compra (atualiza saldo atendido)
- SC8 (leitura) - Cotacoes (quando originado de cotacao)
- SA2 (leitura) - Cadastro de Fornecedores
- SA5 (leitura) - Amarracao Produto x Fornecedor
- SB1 (leitura) - Cadastro de Produtos
- SE4 (leitura) - Condicoes de Pagamento
Parametros relevantes:
| Parametro | Descricao |
|---|---|
| MV_RESTINC | Restringe criacao de pedido sem solicitacao de compra |
| MV_RESTPED | Restringe manutencao do pedido de compra |
| MV_RESTNFE | Restringe recebimento de pedido bloqueado |
| MV_ARRPEDC | Arredondamento do valor total do Pedido de Compra |
| MV_ALTPRCC | Controla alteracao do preco na classificacao de NF/pre-nota |
| MV_PCNFE | Obrigatoriedade de informar numero do PC na pre-nota |
| MV_ALTPEDC | Controla se usuario pode modificar pedidos de compra ja atendidos |
Pontos de entrada:
| Ponto de Entrada | Descricao |
|---|---|
| MT121BRW | Adiciona opcoes no menu da rotina MATA121 |
| MT120F | Manipula dados na SC7 apos gravacao do pedido |
| MT120OK | Validacoes especificas de usuario |
| MT120TEL | Manipula tela do pedido de compra |
| MT120APV | Manipula grupo de aprovacao e saldo de pedido |
| MT120PCOK | Valida Pedido de Compra |
| MT120VSC | Manipula array de SC ou Contrato de Parceria na busca pelo fornecedor |
| WFW120P | Manipula dados gravados na SC7 (workflow) |
| GRVSC7 | Modifica valores da tabela SC7 |
| MTA120G1 | Grava informacoes contidas nas variaveis do array |
| A120FILT | Altera a ordem de indice na tabela SC7 |
| A120F4FI | Disponibiliza filtro em tabelas SC1 e SC3 |
| CN120GSC | Grava informacoes especificas na SC7 (projeto CNI) |
MATA094 - Liberacao de Documentos (Aprovacao de Compras)
O que faz: Controla o fluxo de aprovacao/liberacao dos documentos de compra (SC, PC, Autorização de Entrega). Somente usuarios registrados como Aprovadores (MATA095) podem liberar documentos. Utiliza o conceito de alcadas (limites de aprovacao por valor) e grupos de aprovacao (MATA114).
Documentos sujeitos a aprovacao:
- Solicitacao de Compra (SC1)
- Pedido de Compra (SC7)
- Contrato de Parceria
- Autorização de Entrega
- Documento de Entrada com divergencia
Tabelas envolvidas:
- SC1 (leitura/escrita) - Solicitacoes (atualiza status C1_APESSION)
- SC7 (leitura/escrita) - Pedidos de Compra (atualiza status C7_APESSION)
- SAL (leitura) - Alcadas
- SCR (leitura) - Aprovadores
- DBL (leitura) - Entidades de aprovacao
Parametros relevantes:
| Parametro | Descricao |
|---|---|
| MV_ALTPDOC | Determina quais documentos sao validos para o grupo de aprovacao |
| MV_APRIPPC | Aprovacao automatica via parametro |
Rotinas auxiliares de aprovacao:
| Rotina | Descricao |
|---|---|
| MATA095 | Cadastro de Aprovadores |
| MATA114 | Cadastro de Grupos de Aprovacao |
MATA140 - Pre-Nota de Entrada (Pre-Documento de Entrada)
O que faz: Registro preliminar dos dados basicos do documento fiscal que sera recebido pela empresa: tipo da nota, numero do documento, data de emissao, fornecedor, especie, estado de origem, produtos, quantidades, valores unitarios e totais, tributos, descontos, frete, despesas e pedidos de compra vinculados.
A pre-nota nao gera lancamentos fiscais, contabeis ou financeiros e nao atualiza o estoque. Seu objetivo e facilitar e agilizar o recebimento de materiais no Documento de Entrada (MATA103).
Tabelas envolvidas:
- SF1 (escrita) - Cabecalho NF Entrada (pre-nota)
- SD1 (escrita) - Itens NF Entrada (pre-nota)
- SC7 (leitura) - Pedidos de Compra (vinculo)
- SA2 (leitura) - Cadastro de Fornecedores
Parametros relevantes:
| Parametro | Descricao |
|---|---|
| MV_PCNFE | Obrigatoriedade de vincular pedido de compra a pre-nota |
Pontos de entrada:
| Ponto de Entrada | Descricao |
|---|---|
| MT140CAB | Preenche automaticamente o cabecalho da pre-nota |
| MT140PC | Manipula parametro MV_PCNFE |
| CM120GR | Permite cancelar inclusao/alteracao da pre-nota |
| MT140LPC | Manipula vinculo com pedido de compra |
| A140IPED | Campos para vinculo com pedido de compras |
MATA103 - Documento de Entrada (Nota Fiscal de Entrada)
O que faz: Classificacao e efetivacao do documento fiscal de entrada. E nesta rotina que o recebimento e consumado, gerando movimentacao de estoque (SD3), lancamento fiscal (SF3/SFT), titulo a pagar (SE2) e lancamento contabil (CT2). Pode ser vinculado a um pedido de compra (via F5/F6).
Quando o produto possui controle de qualidade e a qualificacao do fornecedor no SA5 nao atinge a nota minima do produto, o lote e direcionado para o armazem de controle de qualidade (parametro MV_CQ).
Tabelas envolvidas:
- SF1 (escrita) - Cabecalho NF Entrada
- SD1 (escrita) - Itens NF Entrada
- SC7 (leitura/escrita) - Pedido de Compra (atualiza C7_QUJE)
- SD3 (escrita) - Movimentacoes de Estoque
- SE2 (escrita) - Titulos a Pagar
- SFT (escrita) - Livros Fiscais
- CT2 (escrita) - Lancamentos Contabeis
- SA2 (leitura) - Cadastro de Fornecedores
- SB1 (leitura) - Cadastro de Produtos
- SB2 (leitura/escrita) - Saldos por Armazem
Parametros relevantes:
| Parametro | Descricao |
|---|---|
| MV_TESPCNF | TES que nao necessita de PC amarrado |
| MV_CQ | Armazem de controle de qualidade |
Pontos de entrada:
| Ponto de Entrada | Descricao |
|---|---|
| MT100F4 | Entrada de Notas Fiscais de Compra |
| A103CUST | Manipula custo de entrada |
| MT103NAT | Altera natureza no documento de entrada |
| MT103QPC | Manipula query ao selecionar Pedido de Compra no Documento de Entrada |
| MA103F4I | Importacao de pedidos de compra |
MATA061 - Amarracao Produto x Fornecedor
O que faz: Cadastro e manutencao do vinculo entre produtos e fornecedores na tabela SA5. Registra historico dos ultimos 12 precos de compra, condicoes de pagamento acordadas, datas e valores de compras, qualificacao do fornecedor, lead time, entre outros.
Essas informacoes sao utilizadas na geracao automatica de cotacoes (MATA131) e na avaliacao de qualidade no recebimento (MATA103).
Tabelas envolvidas:
- SA5 (escrita) - Amarracao Produto x Fornecedor
- SA2 (leitura) - Cadastro de Fornecedores
- SB1 (leitura) - Cadastro de Produtos
Processos de Negocio
Fluxo Completo de Compras (com cotacao)
┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
│ 1. Solicitacao │────>│ 2. Cotacao │────>│ 3. Analise de │
│ de Compra │ │ (Gerar) │ │ Cotacao │
│ MATA110 / SC1 │ │ MATA131 / SC8 │ │ MATA130 / SC8 │
└─────────────────┘ └─────────────────┘ └────────┬────────┘
│
┌─────────────────┐ ┌─────────────────┐ ┌────────v────────┐
│ 6. Titulo a │<────│ 5. Documento │<────│ 4. Pedido de │
│ Pagar │ │ de Entrada │ │ Compra │
│ SE2 │ │ MATA103/SD1/SF1 │ │ MATA120-121/SC7 │
└─────────────────┘ └─────────────────┘ └─────────────────┘Passo 1: Solicitacao de Compra (MATA110)
| Aspecto | Detalhe |
|---|---|
| Rotina | MATA110 |
| Tabelas | SC1 (escrita), SB1 (leitura) |
| O que acontece | Usuario formaliza necessidade de compra informando produto, quantidade, data de necessidade, centro de custo, armazem destino e observacoes. Se alcadas estiverem habilitadas (via cadastro de Grupos de Aprovacao - MATA114), a SC fica bloqueada (C1_APESSION = "B") aguardando liberacao. |
| Resultado | Registro na SC1 com status pendente ou liberado |
Passo 2: Geracao de Cotacao (MATA131)
| Aspecto | Detalhe |
|---|---|
| Rotina | MATA131 |
| Tabelas | SC1 (leitura), SC8 (escrita), SA5 (leitura), SA2 (leitura) |
| O que acontece | O comprador seleciona SCs liberadas e gera cotacoes para os fornecedores vinculados ao produto (SA5). Se MV_ENVCOT estiver ativo, e-mail e enviado automaticamente ao fornecedor. Multiplos usuarios podem gerar cotacoes simultaneamente; SCs marcadas ficam indisponiveis para outros usuarios. |
| Resultado | Registros na SC8 (um por item x fornecedor) |
Passo 3: Analise de Cotacao (MATA130)
| Aspecto | Detalhe |
|---|---|
| Rotina | MATA130 |
| Tabelas | SC8 (leitura/escrita), SA5 (leitura), SA2 (leitura) |
| O que acontece | O comprador registra os precos, prazos e condicoes recebidos de cada fornecedor. O sistema permite comparacao lado a lado e pode sugerir o melhor fornecedor. Ao aprovar a cotacao, pode gerar automaticamente o Pedido de Compra. |
| Resultado | SC8 atualizada com precos e cotacao aprovada (C8_APROV = "S"); opcionalmente gera SC7 |
Passo 4: Pedido de Compra (MATA120/MATA121)
| Aspecto | Detalhe |
|---|---|
| Rotina | MATA120 (processamento) / MATA121 (interface) |
| Tabelas | SC7 (escrita), SC1 (leitura/escrita), SC8 (leitura), SA2 (leitura) |
| O que acontece | Gerado manualmente, a partir da SC ou da cotacao aprovada. O pedido registra fornecedor, produto, quantidade, preco, condicao de pagamento, prazo de entrega e tributos. Se alcadas estiverem habilitadas, o PC fica bloqueado (C7_APESSION = "B") ate liberacao (MATA094). A SC vinculada tem C1_QUJE atualizada. |
| Resultado | Registros na SC7; SC1 atualizada |
Passo 5: Documento de Entrada (MATA103)
| Aspecto | Detalhe |
|---|---|
| Rotina | MATA103 |
| Tabelas | SF1 (escrita), SD1 (escrita), SC7 (escrita), SD3 (escrita), SE2 (escrita), SFT (escrita), CT2 (escrita) |
| O que acontece | Ao receber a NF do fornecedor, o usuario classifica o documento vinculando ao pedido de compra. A classificacao gera simultaneamente: movimentacao de estoque (SD3), titulo a pagar (SE2), escrituracao fiscal (SFT) e lancamentos contabeis (CT2). O saldo do pedido (C7_QUJE) e atualizado. |
| Resultado | NF registrada (SF1/SD1), estoque atualizado, financeiro gerado, fiscal escriturado |
Nota: Opcionalmente, antes do MATA103 pode-se usar MATA140 (Pre-Nota de Entrada) para registro preliminar dos dados da NF sem gerar lancamentos.
Passo 6: Titulo a Pagar (SE2)
| Aspecto | Detalhe |
|---|---|
| Tabelas | SE2 (gerada automaticamente no passo 5) |
| O que acontece | O titulo a pagar e gerado automaticamente na classificacao do documento de entrada, conforme condicao de pagamento (SE4). O desdobramento em parcelas segue a regra da condicao. O titulo fica disponivel para o modulo Financeiro (SIGAFIN) para baixa/pagamento. |
| Resultado | Titulos em SE2 com vencimentos e valores conforme condicao de pagamento |
Fluxo Simplificado (sem cotacao)
Solicitacao de Compra (SC1) → Pedido de Compra (SC7) → Documento de Entrada (SD1/SF1) → Titulo a Pagar (SE2)Quando MV_RESTINC estiver desabilitado, o pedido pode ser criado diretamente sem necessidade de SC previa. Quando habilitado, exige SC mas pode-se pular a etapa de cotacao.
Regras de Negocio
Campos obrigatorios por rotina
Solicitacao de Compra (MATA110 - SC1):
- C1_PRODUTO (Codigo do produto)
- C1_QUANT (Quantidade)
- C1_DATPRF (Data de necessidade)
- C1_LOCAL (Armazem)
Pedido de Compra (MATA120/121 - SC7):
- C7_PRODUTO (Codigo do produto)
- C7_QUANT (Quantidade)
- C7_PRECO (Preco unitario)
- C7_FORNECE + C7_LOJA (Fornecedor)
- C7_COND (Condicao de pagamento)
- C7_TES (Tipo de Entrada/Saida)
Documento de Entrada (MATA103 - SD1):
- D1_COD (Codigo do produto)
- D1_QUANT (Quantidade)
- D1_VUNIT (Valor unitario)
- D1_TES (Tipo de Entrada/Saida)
- D1_DOC (Numero do documento)
- D1_SERIE (Serie da NF)
Validacoes principais
| Validacao | Descricao |
|---|---|
| Saldo de SC | Ao gerar pedido vinculado a SC, a quantidade do pedido nao pode ultrapassar o saldo disponivel (C1_QUANT - C1_QUJE) |
| Saldo de PC | Ao classificar documento de entrada, a quantidade nao pode ultrapassar o saldo do pedido (C7_QUANT - C7_QUJE), a menos que parametrizado para permitir |
| Aprovacao/Alcada | Se controle de alcada estiver ativo, documentos bloqueados nao podem seguir no fluxo ate liberacao pelo aprovador |
| Amarracao Produto x Fornecedor | Se MV_RESTINC exigir, o fornecedor deve estar vinculado ao produto no SA5 |
| Fornecedor bloqueado | Nao permite gerar pedido para fornecedor com A2_MSBLQL = "1" |
| Duplicidade de NF | Verifica duplicidade de numero de NF por fornecedor (validacao nativa do sistema) |
| Residuo | Itens marcados como residuo (C7_RESIDUO = "S" ou C1_APESSION = "R") nao participam de novos pedidos/cotacoes |
Gatilhos SX7 relevantes
| Campo origem | Campo destino | Regra | Tabela lookup |
|---|---|---|---|
| C7_PRODUTO | C7_DESCRI | SB1->B1_DESC | SB1 |
| C7_PRODUTO | C7_UM | SB1->B1_UM | SB1 |
| C7_FORNECE | C7_CONTATO | SA2->A2_CONTATO | SA2 |
| C1_PRODUTO | C1_DESCRI | SB1->B1_DESC | SB1 |
| C1_PRODUTO | C1_UM | SB1->B1_UM | SB1 |
| C7_QUANT * C7_PRECO | C7_TOTAL | Calculado | - |
| D1_COD | D1_DESCRI | SB1->B1_DESC | SB1 |
Pontos de entrada mais utilizados no modulo
| Ponto de Entrada | Rotina | Descricao |
|---|---|---|
| MT110BRW | MATA110 | Customiza menu da Solicitacao de Compras |
| MT110VLD | MATA110 | Validacao customizada na SC |
| MT121BRW | MATA121 | Customiza menu do Pedido de Compras |
| MT120F | MATA120 | Pos-gravacao do Pedido de Compras na SC7 |
| MT120OK | MATA120 | Validacao customizada no Pedido de Compras |
| MT120PCOK | MATA120 | Validacao do Pedido de Compra |
| MT131VAL | MATA131 | Validacao da geracao de cotacao |
| MT130FIM | MATA130 | Pos-analise de cotacao |
| AVALCOT | MATA130 | Manipula SC7 ao gerar pedido pela cotacao |
| MT140CAB | MATA140 | Preenche cabecalho da pre-nota |
| MT140LPC | MATA140 | Manipula vinculo com PC na pre-nota |
| A103CUST | MATA103 | Manipula custo de entrada |
| MT103QPC | MATA103 | Manipula query de selecao de PC no Documento de Entrada |
| MT097GRV | MATA094 | Substitui gravacao nos processos de compras (aprovacao) |
| GRVSC7 | MATA120 | Modifica valores gravados na SC7 |
Integracoes
Compras → Estoque
| Aspecto | Detalhe |
|---|---|
| Quando | Na classificacao do Documento de Entrada (MATA103) |
| O que acontece | Gera movimentacao na SD3 (Movimentacoes de Estoque) do tipo Entrada. Atualiza saldo do produto no armazem (SB2). O tipo de movimento e definido pela TES (Tipo de Entrada/Saida) informada no item da NF |
| Tabelas afetadas | SD3 (movimentacao), SB2 (saldo por armazem), SB9 (saldo consolidado) |
| Controles | Se controle de lote/sublote estiver ativo (B1_RASTRO), exige informacao de lote. Se qualidade ativa, pode direcionar para armazem CQ (MV_CQ) |
Compras → Financeiro
| Aspecto | Detalhe |
|---|---|
| Quando | Na classificacao do Documento de Entrada (MATA103) |
| O que acontece | Gera titulo(s) a pagar na SE2, desdobrados conforme a condicao de pagamento (SE4). O prefixo e numero do titulo sao baseados no numero da NF. Natureza financeira e determinada pela TES |
| Tabelas afetadas | SE2 (Titulos a Pagar) |
| Observacao | O titulo fica disponivel para o modulo Financeiro (SIGAFIN) para bordero, pagamento e baixa |
Compras → Fiscal
| Aspecto | Detalhe |
|---|---|
| Quando | Na classificacao do Documento de Entrada (MATA103) |
| O que acontece | Gera escrituracao no livro de entradas (SFT/SF3). Registra valores de ICMS, IPI, PIS, COFINS e demais tributos conforme configuracao da TES e natureza de operacao (SED). NFe recebida pode ser importada via XML |
| Tabelas afetadas | SFT (Livros Fiscais), SF3 (Resumo de NF) |
| Observacao | Integra com o modulo SIGAFIS para apuracao de impostos e obrigacoes acessorias (SPED, EFD) |
Compras → Contabilidade
| Aspecto | Detalhe |
|---|---|
| Quando | Na classificacao do Documento de Entrada (MATA103), se contabilizacao online estiver habilitada |
| O que acontece | Gera lancamentos contabeis na CT2, debitando as contas de estoque/despesa e creditando as contas de fornecedores/impostos, conforme Lancamento Padrao (CT5) configurado na TES |
| Tabelas afetadas | CT2 (Lancamentos Contabeis) |
| Parametro | Contabilizacao on-line controlada pela configuracao da TES e Lancamento Padrao (CT5) |
Compras → Qualidade (CQ)
| Aspecto | Detalhe |
|---|---|
| Quando | Na classificacao do Documento de Entrada (MATA103) |
| O que acontece | Se a qualificacao do fornecedor (SA5->A5_QUALIF) nao atingir a nota minima do produto (SB1->B1_QUALIF), o lote e direcionado para o armazem de CQ (MV_CQ). Se atingir, passa pela avaliacao de Skip-lote |
| Tabelas afetadas | SB2 (saldo no armazem CQ), SQA (inspecao de entrada) |
Resumo das integracoes no Documento de Entrada
MATA103 - Documento de Entrada
│
┌────────────────┼────────────────┐
│ │ │
┌─────v─────┐ ┌─────v─────┐ ┌─────v─────┐
│ Estoque │ │ Financeiro│ │ Fiscal │
│ SD3 / SB2 │ │ SE2 │ │ SFT / SF3 │
└───────────┘ └───────────┘ └───────────┘
│
┌──────v──────┐
│Contabilidade│
│ CT2 │
└─────────────┘Cadastros Auxiliares
| Rotina | Descricao | Tabela |
|---|---|---|
| MATA061 | Amarracao Produto x Fornecedor | SA5 |
| MATA095 | Cadastro de Aprovadores | SCR |
| MATA114 | Grupo de Aprovacao | SAL / DBL |
| MATA020 | Cadastro de Fornecedores | SA2 |
| Tipo de Compra | Define politica de compra por tipo | SX5 tabela generica |
| Grupo de Compras | Segmenta compradores por grupo | SX5 tabela generica |
Parametros Globais do Modulo (MV_*)
| Parametro | Tipo | Descricao |
|---|---|---|
| MV_RESTINC | C | Restringe criacao de PC sem SC (S/N) |
| MV_RESTPED | C | Restringe manutencao de PC (S/N) |
| MV_RESTNFE | C | Restringe recebimento de PC bloqueado (S/N) |
| MV_RESTSOL | C | Restringe solicitantes de produtos (S/N) |
| MV_RESTCOM | C | Restringe acesso as SCs por comprador (S/N) |
| MV_ENVCOT | C | Envia e-mail de cotacao ao fornecedor (S/N) |
| MV_PCNFE | C | Obrigatoriedade de PC na pre-nota (S/N) |
| MV_ARRPEDC | C | Arredondamento do valor total do PC (ROUND/NOROUND) |
| MV_ALTPRCC | C | Controla alteracao do preco na classificacao de NF/pre-nota |
| MV_ALTPEDC | C | Controla se usuario pode modificar pedidos de compra ja atendidos |
| MV_CQ | C | Codigo do armazem de controle de qualidade |
| MV_TESPCNF | C | TES que nao necessita de PC amarrado |
| MV_SCLCNI | L | Controle de numeracao sequencial da SC por filial |
| MV_SEQESP | L | Sequencia especifica para numeracao de SC |
| MV_APRIPPC | C | Aprovacao automatica via parametro |
| MV_ALTPDOC | L | Determina quais documentos sao validos para o grupo de aprovacao |