Ponto de Entrada FA050INC: Validação Crucial na Inclusão do Contas a Pagar (FINA050) no Protheus

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
1
FA050INC
.

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