Tempo de leitura: 4 minutos
Se você trabalha com ADVPL, TOTVS Protheus, e o módulo Financeiro (SIGAFIN), o Ponto de Entrada FA050INC é uma ferramenta indispensável para a customização e validação na rotina de Inclusão de Títulos a Pagar (FINA050).
Este Ponto de Entrada permite que o desenvolvedor ADVPL execute rotinas personalizadas após o preenchimento dos dados do título, mas antes da efetiva gravação na tabela SE2 (Contas a Pagar), possibilitando verificações de regras de negócio específicas da sua empresa.
🎯 O que é o Ponto de Entrada FA050INC?
O FA050INC é um hook liberado pela TOTVS na rotina FINA050 (Manutenção de Contas a Pagar). Ele é executado no momento de “Tudo Ok” da inclusão, ou seja, quando o usuário clica em “Salvar” ou quando a inclusão é feita via ExecAuto.
Sua principal função é permitir validações adicionais para garantir que o título a ser gravado no Contas a Pagar (SE2) atenda a todos os requisitos de negócio antes de ser persistido no banco de dados.
📝 Exemplo de Uso do FA050INC em ADVPL
Para que o FA050INC funcione corretamente, sua User Function deve retornar um valor lógico (.T. ou .F.). Se retornar .F., a gravação do título será abortada, e a rotina voltará para a tela de inclusão.
// FA050INC.PRX
#INCLUDE "TOTVS.CH"
#INCLUDE "PROTHEUS.CH"
/*/{Protheus.doc} FA050INC
Ponto de Entrada: FA050INC
Rotina: FINA050 - Inclusão de Contas a Pagar
Execução: Na validação do "Tudo Ok" na inclusão do Contas a Pagar.
Utilidade: Permite a execução de validações personalizadas antes da gravação do título na SE2.
@type function
@author Adilio Costa
@since 06/11/2025
@version 1.0
@Inscreva-se no Blog ProtheusAdvpl:
https://www.protheusadvpl.com.br
@Inscreva-se no Canal ProtheusAdvpl:
https://www.youtube.com/protheusadvpl
@Siga-nos no Instagram:
https://www.instagram.com/protheusadvpl
@Conheça os Cursos do ProtheusAdvpl:
https://cursos-e-formacoes-protheusadvpl.gr-site.com/
@Participe de nossas comunidades no WhatsApp:
-Comunidade Protheus Backoffice:https://chat.whatsapp.com/KMUIAjwZ6EZ6eAHsLkPTyb
-Comunidade Protheus-RH:https://chat.whatsapp.com/L5dUyAna6xU4ylG5DUgfOW
-Comunidade Protheus-Programação:https://chat.whatsapp.com/LsD6z0apdqKHlOz67bcaEn
-Comunidade Protheus-Framework:https://chat.whatsapp.com/BzUFpjaSnTC3vtsfa77jmG
|Se esse conteúdo foi útil pra você nos ajude divulgando
ele e nossas redes sociais!!|
*/
User Function FA050INC()
Local lRet := .T. // Variável que define se a inclusão será permitida
// O alias SE2 já estará posicionado no buffer de memória com os dados que
// seriam gravados, caso o ponto de entrada retorne .T.
// Use SE2->(NOME_DO_CAMPO) para acessar os campos.
// Exemplo de Validação: Verificar se o Tipo de Título (E2_TIPO) não é 'DUP'
If AllTrim(SE2->E2_TIPO) == 'DUP'
Alert("Inclusão de Títulos do tipo 'DUP' não é permitida por este usuário.")
lRet := .F. // Aborta a gravação
EndIf
// Exemplo de Validação 2: Verificar o valor do título (E2_VALOR)
If SE2->E2_VALOR > 10000.00
Alert("Títulos acima de R$ 10.000,00 devem ser aprovados pelo gestor financeiro antes da inclusão.")
// Aqui você pode adicionar uma lógica mais complexa, como uma rotina de aprovação
lRet := .F. // Aborta temporariamente se não houver aprovação
EndIf
// Certifique-se de retornar a variável lógica
Return lRet
💡 Benefícios de Utilizar o FA050INC
-
Controle de Regras: Aplique regras de negócio complexas que o Protheus não cobre nativamente.
-
Integridade dos Dados: Garanta que todos os títulos a pagar sigam um padrão de qualidade e dados antes de serem gravados (na tabela SE2).
-
Fluxo de Aprovação: Implemente gatilhos para fluxos de aprovação ou alçadas baseadas em valores ou tipos de título, interrompendo a inclusão se necessário.
-
Gatilhos de Processos: Inicie processos automáticos, como o envio de um e-mail de notificação para o setor financeiro ou a atualização de tabelas auxiliares.
🔗 Link(s) de referência(s):
http://tdn.totvs.com/pages/releaseview.action?pageId=6071109
Bem, finalizamos mais um post aqui do Blog ProtheusAdvpl.
Se esse conteúdo lhe foi útil nos ajude compartilhando ele em suas redes sociais do TOTVS Protheus.
Grande abraço e fica com Deus.
📢 Aprenda ADVPL e Protheus do Zero ao Avançado!
Chega de procurar tutoriais incompletos e de perder tempo!
Conheça o Portal ProtheusAdvpl e tenha acesso a uma plataforma completa para dominar o ADVPL/TLPP e os processos dos módulos mais importantes do Protheus.
Com o Portal, você aprende de forma estruturada:
-
Programação ADVPL/TLPP para criar customizações eficientes.
-
Processos de Módulos: Compras, Estoque e Custos, Faturamento, Financeiro, Gestão de Pessoal e muito mais!
-
Aprenda a utilizar e customizar Pontos de Entrada como o
.1FA050INC
Transforme sua carreira e torne-se um especialista em Protheus!
👉 Clique e comece a dominar o Protheus hoje mesmo: https://go.hotmart.com/O10336806O?dp=1