📅 Data de publicação

19/03/2026

🎯 Objetivo

Apresentar o funcionamento do ponto de entrada M410FSQL, utilizado para aplicar filtros na exibição de pedidos de venda na rotina padrão do Protheus, permitindo restringir os registros apresentados na browse conforme regras específicas do negócio.

🧩 Visão geral

O ponto de entrada M410FSQL é utilizado para filtrar os pedidos de venda exibidos na rotina correspondente, atuando diretamente sobre a mBrowse da aplicação.

Sua utilização é indicada quando há necessidade de limitar a visualização dos pedidos com base em critérios definidos pela empresa, como faixa de números, clientes específicos, tipos de pedido ou qualquer outra condição que possa ser expressa em SQL.

🏢 Ambiente

Linha Microsiga Protheus
Abrangência: Microsiga Protheus 10
Compatível com países: Todos
Sistemas operacionais: Todos
Bases de dados compatíveis: Todas com TotvsDbAccess

⚙️ Características técnicas

📌 Programa fonte

MATA410.PRX

📌 Sintaxe

M410FSQL() --> cFilSQL

📌 Parâmetros

Este ponto de entrada não recebe parâmetros.

📌 Retorno esperado

cFilSQL — caractere — expressão SQL utilizada para filtrar a mBrowse.

🛠️ Como funciona

Ao ser acionado pela rotina padrão, o ponto de entrada deve retornar uma expressão SQL válida, que será utilizada para restringir os pedidos de venda exibidos na browse.

Na prática, isso significa que a customização define uma condição de filtro complementar, influenciando diretamente os registros que o usuário poderá visualizar na rotina.

💡 Exemplo prático

#Include "Protheus.ch"

User Function M410FSQL()

Local cFilSQL := ""

cFilSQL := "C5_NUM >= '000100' AND C5_NUM <= '000200'"

Return cFilSQL

📍 Exemplos de aplicação

Filtrar por faixa de pedidos

cFilSQL := "C5_NUM >= '000100' AND C5_NUM <= '000200'"

Filtrar por cliente específico

cFilSQL := "C5_CLIENTE = '000001'"

Filtrar por tipo de pedido

cFilSQL := "C5_TIPO = 'N'"

Filtrar por cliente e tipo

cFilSQL := "C5_CLIENTE = '000001' AND C5_TIPO = 'N'"

⚠️ Cuidados na implementação

Ao utilizar o ponto de entrada M410FSQL, é importante observar alguns pontos:

• O retorno deve ser obrigatoriamente uma expressão SQL válida.

• A condição deve estar compatível com os campos efetivamente utilizados pela rotina de pedidos.

• Filtros incorretos podem comprometer a exibição dos registros ou gerar comportamento inesperado.

• Toda customização deve ser validada em ambiente de homologação antes da publicação em produção.

• É recomendável garantir que o filtro implementado esteja alinhado às regras de segurança e visibilidade da operação.

✅ Benefícios do uso

A utilização do ponto de entrada M410FSQL traz vantagens importantes para a operação:

• Restringe a visualização dos pedidos conforme regras de negócio.

• Permite adequar a rotina padrão às necessidades da empresa.

• Melhora o controle operacional sobre os registros exibidos.

• Reduz exposição indevida de pedidos fora do contexto do usuário.

• Contribui para uma navegação mais objetiva na rotina.

❓ FAQ

1. O ponto de entrada M410FSQL recebe parâmetros?

Não. Conforme a documentação, esse ponto de entrada não possui parâmetros de entrada.

2. Qual é o retorno esperado?

O retorno esperado é uma variável do tipo caractere contendo uma expressão SQL.

3. Em qual rotina esse ponto de entrada é utilizado?

Ele está vinculado ao programa fonte MATA410.PRX, relacionado à rotina de pedidos de venda.

4. Onde o filtro é aplicado?

O filtro é aplicado diretamente sobre a mBrowse, restringindo os pedidos de venda exibidos na consulta.

5. Posso usar esse ponto de entrada para filtrar por cliente?

Sim. Desde que a condição seja montada corretamente em SQL, é possível filtrar por cliente, número do pedido, tipo e outros campos pertinentes à rotina.

🧾 Conclusão

O ponto de entrada M410FSQL é um recurso importante para personalizar a exibição de pedidos de venda no Protheus, permitindo aplicar filtros específicos diretamente na browse da rotina. Por retornar uma expressão SQL, sua implementação deve ser feita com atenção técnica, garantindo aderência às regras do negócio e segurança na apresentação das informações. As características técnicas desta documentação oficial indicam que ele é aplicável ao Microsiga Protheus 10, sem parâmetros e com retorno do tipo caractere para filtragem da mBrowse. (TDN)

✍️ Autor

Fabrizio Augusto Ventavolo
Consultor Especialista TOTVS — Mastersiga Consultoria