Data de publicação: 26/03/2026
🎯 Objetivo
Apresentar, de forma organizada, os principais Pontos de Entrada disponíveis na rotina Pedidos de Venda (MATA410) do Protheus, permitindo identificar onde realizar customizações, validações e tratamentos específicos no processo de pedido de venda.
📘 Visão Geral
A rotina MATA410 é uma das mais importantes do módulo de Faturamento no Protheus, pois concentra o processo de manutenção dos Pedidos de Venda.
Por sua abrangência, a rotina disponibiliza diversos Pontos de Entrada que possibilitam intervenções em etapas como:
validação de inclusão, alteração e exclusão;
manipulação de cabeçalho e itens;
tratamento de interface;
planilha financeira;
cálculo de impostos;
geração de notas;
controle de acessos;
integração com outras rotinas.
Na prática, esses pontos de entrada são utilizados para adaptar o comportamento padrão do sistema às regras de negócio da empresa, sem necessidade de alterar diretamente o código padrão da rotina.
🧩 O que são Pontos de Entrada
Os Pontos de Entrada são eventos disponibilizados pelo padrão do Protheus para permitir que o desenvolvedor implemente lógicas complementares em momentos específicos da execução da rotina.
Na MATA410, isso significa que é possível:
validar dados antes da gravação;
impedir ações indevidas;
preencher campos automaticamente;
alterar comportamento visual da rotina;
manipular informações financeiras;
executar integrações e regras customizadas.
🗂️ Relação dos Pontos de Entrada da MATA410
🔹 Grupo A410
A410BLCO
Altera a linha do aCols dos itens bonificados.
Link: https://tdn.totvs.com/pages/releaseview.action?pageId=6784029
A410BONU
Executa regras relacionadas ao cálculo de bônus.
Link: https://tdn.totvs.com/pages/releaseview.action?pageId=6784030
A410BPRC
Permite acessar a planilha de formação de preços.
Link: https://tdn.totvs.com/pages/releaseview.action?pageId=6784031
A410BPRO
Inibe o botão Estrutura de Produtos.
Link: https://tdn.totvs.com/pages/releaseview.action?pageId=6784032
A410CONS
Permite incluir botões na EnchoiceBar.
Link: https://tdn.totvs.com/pages/releaseview.action?pageId=6784033
A410EXC
Trata regras na exclusão do pedido de vendas.
Link: https://tdn.totvs.com/pages/releaseview.action?pageId=6784034
A410GRDW
Manipula a interface da grade de produtos.
Link: https://tdn.totvs.com/display/public/PROT/A410GRDW+-+Manipula+a+interface+de+grade+de+produtos
A410GVLD
Valida a grade de produtos do pedido.
Link: https://tdn.totvs.com/pages/releaseview.action?pageId=6784036
A410PLAN
Permite acesso à planilha financeira da rotina.
Link: https://tdn.totvs.com/pages/releaseview.action?pageId=108659113
A410PVCL
Trata a alteração do vendedor no pedido de venda.
Link: https://tdn.totvs.com/pages/releaseview.action?pageId=6784546
A410RNF
Altera o filtro de pesquisa das notas fiscais de entrada na devolução de compras.
Link: https://tdn.totvs.com/pages/releaseview.action?pageId=623896913
A410TAB
Atua sobre tabela de preços.
Link: https://tdn.totvs.com/pages/releaseview.action?pageId=6784037
A410VTIP
Valida pedido com condição de pagamento tipo 9.
Link: https://tdn.totvs.com/pages/releaseview.action?pageId=6784540
GMMA410BUT
Adiciona botões na Enchoice.
Link: https://tdn.totvs.com/pages/releaseview.action?pageId=6784493
🔹 Grupo M410
M410ABN
Trata o cancelamento de pedido.
Link: https://tdn.totvs.com/display/public/PROT/M410ABN+-+Cancelamento+de+pedido
M410ACDL
Valida itens liberados.
Link: https://tdn.totvs.com/display/public/PROT/M410ACDL+-+Validar+itens+lliberados
M410AGRV
Executa lógica antes da gravação das alterações do pedido.
Link: https://tdn.totvs.com/pages/viewpage.action?pageId=6784142
M410ALDT
Altera a database durante o processamento.
Link: https://tdn.totvs.com/display/public/PROT/M410ALDT+-+Altera+a+database
M410ALOK
Trata a alteração do pedido de venda.
Link: https://tdn.totvs.com/pages/releaseview.action?pageId=6784143
M410CODBAR
Permite o uso de rotina específica para código de barras.
Link: https://tdn.totvs.com/pages/releaseview.action?pageId=6784144
M410EBAR
Preenche as colunas do pedido via código de barras.
Link: https://tdn.totvs.com/pages/releaseview.action?pageId=58720659
M410FLDR
Inibe a apresentação do folder Rentabilidade.
Link: https://tdn.totvs.com/pages/releaseview.action?pageId=6077187
MA410FRT
Não apresenta a tela de memória de cálculo na simulação de frete via pedido.
Link: https://tdn.totvs.com/pages/releaseview.action?pageId=239040159
M410FSQL
Aplica filtro aos pedidos de venda.
Link: https://tdn.totvs.com/display/public/PROT/M410FSQL+-+Filtro+de+pedidos+de+venda
M410GET
Permite montagem de tela.
Link: https://tdn.totvs.com/display/public/PROT/M410GET+-+Montagem+de+tela
M410ICM
Retorna valor de ICMS.
Link: https://tdn.totvs.com/display/public/PROT/M410ICM+-+Retorno+do+valor+de+ICMS
M410INIC
Executa validação de usuário no início do processo.
Link: https://tdn.totvs.com/pages/releaseview.action?pageId=6784147
M410IPI
Retorna valor de IPI.
Link: https://tdn.totvs.com/display/public/PROT/M410IPI+-+Retorno+do+valor+de+IPI
M410lDel
Valida a exclusão de itens na alteração do pedido.
Link: https://tdn.totvs.com/pages/releaseview.action?pageId=6784565
M410LIOK
Valida a linha do pedido.
Link: https://tdn.totvs.com/pages/releaseview.action?pageId=6784149
M410PCDV
Faz o preenchimento do grid.
Link: https://tdn.totvs.com/display/public/PROT/M410PCDV+-+Preenchimento+do+gride
M410PLNF
Executa o pós-cálculo dos impostos da planilha financeira.
Link: https://tdn.totvs.com/pages/releaseview.action?pageId=6787794
M410PVNF
Atua na geração de notas fiscais.
Link: https://tdn.totvs.com/pages/releaseview.action?pageId=6784152
M410REC
Reprocessa o fluxo de caixa.
Link: https://tdn.totvs.com/display/public/PROT/M410REC+-+Reprocessamento+do+Fluxo+de+Caixa
M410REMB
Manipula dados de remessa para beneficiamento.
Link: https://tdn.totvs.com/display/public/PROT/M410REMB+-+Manipular+dados+de+remessa+para+beneficiamento
M410SOLI
Retorna valor de ICMS.
Link: https://tdn.totvs.com/display/public/PROT/M410SOLI+-+Retorno+do+valor+de+ICMS
M410STTS
Executa alterações no pedido após o processamento.
Link: https://tdn.totvs.com/pages/viewpage.action?pageId=6784155
M410TIP9
Substitui a validação de função para condição tipo 9.
Link: https://tdn.totvs.com/pages/releaseview.action?pageId=6784156
M410VCT
Altera as duplicatas na planilha financeira.
Link: https://tdn.totvs.com/pages/releaseview.action?pageId=237396627
M410VIS
Executa lógica antes da visualização do pedido.
Link: https://tdn.totvs.com/pages/releaseview.action?pageId=6784157
M410VRES
Confirma a eliminação de resíduos.
Link: https://tdn.totvs.com/pages/releaseview.action?pageId=6784158
M410PSDC
Atua na recuperação de registros.
Link: https://tdn.totvs.com/pages/releaseview.action?pageId=657058410
M410RLIB
Refaz liberações de estoque.
Link: https://tdn.totvs.com/pages/releaseview.action?pageId=657062279
🔹 Grupo MA / MAFIS / MRat
MAFISRASTRO
Controla o rastro das informações e do processamento.
Link: https://tdn.totvs.com/display/public/PROT/PE+-+MAFISRASTRO+-+Controle+de+rastro
MA410BOM
Inclui produtos na estrutura do pedido de venda.
Link: https://tdn.totvs.com/pages/releaseview.action?pageId=6784266
MA410COR
Altera as cores do cadastro de status do pedido.
Link: https://tdn.totvs.com/display/public/PROT/DT_MA410COR_Alterar_cores_do_cadastro_do_status_do_pedido
MA410DEL
É executado antes de deletar registro no SC5.
Link: https://tdn.totvs.com/display/public/PROT/MA410DEL
MA410LEG
Altera os textos da legenda de status do pedido.
Link: https://tdn.totvs.com/display/public/PROT/MA410LEG+-+Alterar+textos+da+legenda+de+status+do+pedido
MA410MNU
É disparado antes da abertura do browse.
Link: https://tdn.totvs.com/display/public/PROT/MA410MNU
MA410PR
É executado na validação de linha com opcionais.
Link: https://tdn.totvs.com/pages/releaseview.action?pageId=63276419
MA410RPV
Altera valores ou inibe demonstrações de valores.
Link: https://tdn.totvs.com/pages/releaseview.action?pageId=6784271
MA410VLD
Valida o cancelamento de inclusão ou alteração.
Link: https://tdn.totvs.com/pages/releaseview.action?pageId=479827493
MRatLOk
Trata o rateio no pedido de vendas.
Link: https://tdn.totvs.com/display/public/PROT/MRatLOk+-+Rateio+no+Pedido+de+Vendas
🔹 Grupo MT / MTA
MT410ACE
Verifica acessos dos usuários.
Link: https://tdn.totvs.com/pages/releaseview.action?pageId=6784346
MT410ALT
É executado após a gravação das alterações.
Link: https://tdn.totvs.com/display/public/PROT/MT410ALT
MT410BRW
É chamado antes da apresentação da mBrowse.
Link: https://tdn.totvs.com/display/public/PROT/MT410BRW
MT410CPY
Altera aCols e variáveis da Enchoice.
Link: https://tdn.totvs.com/pages/releaseview.action?pageId=6784349
MT410EAI
Edita arrays de cabeçalho e itens antes da gravação para integração.
Link: https://tdn.totvs.com/pages/releaseview.action?pageId=181961743
MT410INC
Na alteração do pedido, é executado após a gravação das informações.
Link: https://tdn.totvs.com/display/PROT/MT410INC
MT410PC
Valida condição de pagamento tipo 9.
Link: https://tdn.totvs.com/pages/releaseview.action?pageId=6784351
MT410ROD
Altera valores informados no rodapé.
Link: https://tdn.totvs.com/pages/releaseview.action?pageId=6784352
MT410TOK
Confirma a operação em processamento do pedido de vendas.
Link: https://tdn.totvs.com/pages/releaseview.action?pageId=479827791
MT410TRV
Otimiza o lock de registros para as tabelas SA1, SA2 e SB2.
Link: https://tdn.totvs.com/pages/releaseview.action?pageId=187531533
MT411EAI
Edita arrays de cabeçalho e itens antes da gravação para integração.
Link: https://tdn.totvs.com/pages/releaseview.action?pageId=181963557
MTA410BR
Transforma código de barras em código do B1.
Link: https://tdn.totvs.com/pages/releaseview.action?pageId=6784389
MTA410
Valida toda a tela no pedido de venda.
Link: https://tdn.totvs.com/pages/releaseview.action?pageId=6784388
MTA410E
É executado após deletar o registro no SC6.
Link: https://tdn.totvs.com/display/public/PROT/MTA410E
MTA410I
É executado durante a gravação do pedido, após a atualização de cada item.
Link: https://tdn.totvs.com/display/public/PROT/MTA410I
MTA410T
É o ponto de entrada para todos os itens do pedido.
Link: https://tdn.totvs.com/display/public/PROT/MTA410T
MTA410V
É executado na visualização do pedido, após a apresentação das informações.
Link: https://tdn.totvs.com/pages/viewpage.action?pageId=6784393
MTPROCP3
Interage no processamento de valores.
Link: https://tdn.totvs.com/display/public/PROT/MTPROCP3+-+Interagir+no+processamento+de+valores
✅ Considerações Técnicas
A rotina MATA410 possui uma quantidade significativa de pontos de entrada, o que demonstra a flexibilidade da rotina para adaptações de negócio.
Antes de desenvolver qualquer customização, recomenda-se sempre analisar se o requisito pode ser atendido por um ponto de entrada já existente, preservando o padrão do produto e reduzindo riscos em atualizações futuras.
Também é importante observar o momento exato de execução de cada ponto, pois alguns atuam:
antes da abertura da rotina;
durante a digitação dos dados;
na validação da linha;
antes da gravação;
após a gravação;
na visualização;
em integrações e cálculos específicos.
Esse cuidado é essencial para garantir estabilidade, previsibilidade e aderência técnica no desenvolvimento em ADVPL/TL++.
❓ FAQ
1. O que é a rotina MATA410?
É a rotina de Pedidos de Venda do Protheus, utilizada para inclusão, alteração, exclusão, consulta e processamento de pedidos de venda.
2. O que são pontos de entrada na MATA410?
São eventos disponibilizados pelo padrão do sistema para permitir customizações em momentos específicos da execução da rotina.
3. Quando devo usar um ponto de entrada?
Quando houver necessidade de aplicar regra de negócio, validação, preenchimento automático ou alteração de comportamento sem modificar diretamente o código padrão.
4. A MATA410 possui muitos pontos de entrada?
Sim. É uma das rotinas com maior quantidade de pontos de entrada no módulo de faturamento, justamente por sua relevância operacional.
5. Posso alterar tela e comportamento da rotina usando ponto de entrada?
Sim. Existem pontos específicos para montagem de tela, inclusão de botões, manipulação de grid, validações e tratamentos de interface.
6. Há pontos de entrada para validações financeiras e fiscais?
Sim. A rotina possui pontos voltados à planilha financeira, cálculo de impostos, duplicatas e reprocessamentos.
7. Qual o principal cuidado antes de implementar uma customização?
Identificar corretamente o momento da execução do ponto de entrada e validar se ele atende ao requisito sem comprometer o padrão da rotina.
👤 Autor
Fabrizio Augusto Ventavolo
Consultor Especialista TOTVS — Mastersiga Consultoria