Ponto de Entrada MT103FIM – MATA103: Operação Após a Gravação da NFE

No universo do ERP Totvs Protheus, o ponto de entrada MT103FIM no módulo MATA103 representa uma oportunidade poderosa para customizar o processo após a gravação de uma Nota Fiscal Eletrônica (NFE). Empresas que desejam aprimorar suas rotinas de automação e personalização nos fluxos fiscais encontram neste ponto de entrada um recurso essencial para criar operações adicionais, como notificações automáticas, atualizações de status e integrações. Neste artigo, vamos explorar o potencial do MT103FIM, destacando suas vantagens e proporcionando um exemplo prático em AdvPL para aplicar esse ponto de entrada.

Por Que Usar o Ponto de Entrada MT103FIM?

O ponto de entrada MT103FIM permite a execução de comandos adicionais logo após a gravação da NFE. Em vez de apenas registrar a nota fiscal, ele possibilita que o sistema execute operações adicionais, melhorando o controle sobre o fluxo financeiro e a integração entre módulos. Entre os benefícios desse ponto de entrada, destacam-se:

1. Automação Pós-Processo: Permite que etapas subsequentes sejam acionadas automaticamente, minimizando a necessidade de intervenção manual.
2. Flexibilidade de Customização: Adapta o sistema de acordo com as regras de negócios específicas da empresa.
3. Integração com Outros Módulos: Facilita a comunicação entre módulos e sistemas externos, gerando eficiência e controle.
4. Aprimoramento de Controle: Oferece maior rastreabilidade e segurança ao automatizar processos que exigem acompanhamento detalhado.

Como Funciona o Ponto de Entrada MT103FIM?

Para implementar o ponto de entrada MT103FIM, usamos uma User Function MT103FIM() no AdvPL, onde definimos as ações e condições específicas a serem aplicadas. No exemplo abaixo, mostramos uma configuração prática onde, após a gravação de uma NFE, o sistema altera automaticamente o status de um registro.

Exemplo Prático: Alteração de campo Pós-Gravação de NFE

No exemplo a seguir, configuramos o MT103FIM para atualizar o campo F1-XCMSG (customizado) de uma nota fiscal de “xpto” para “Alteração efetuada Fornecedor Internacional” logo após a sua gravação.

#Include "Protheus.ch"
#Include "Topconn.ch"
/*-------------------------------------------------------------------------------------------*
{Protheus.doc} User Function MT103FIM()
@type:      User Function
@author:    Jose Moura
@site:      https://academiaprotheus.com.br
@desc.:     Programa MT103FIM - Operação após gravação da NFe
*-------------------------------------------------------------------------------------------*/

User Function MT103FIM()
// Declaração das variáveis
Local aArea     := FWGetArea()
Local aAreaF1   := SF1->(FWGetArea())
Local nOpcao    := PARAMIXB[1] 
Local nConfirma := PARAMIXB[2]   
Local cSF1Fil   := FWxFilial('SF1')

If nConfirma == 1
    SF1->(dbSetOrder(1))    //FILIAL + DOCUMENTO + SERIE + CLIENTE + LOJA + TIPO
    If SF1->( MsSeek( cSF1Fil + SF1->F1_DOC + SF1->F1_SERIE + SF1->F1_FORNECE + SF1->F1_LOJA  ) ) 
        If SF1->F1_EST == 'EX'
            RecLock("SF1",.F.) //Alterção
                SF1->F1_XCMSG := 'Alteração efetuada Fornecedor Internacional'
            SF1->(MsUnlock())
		FWAlertInfo('Alteração efetuada com sucesso!','Academia Protheus')


        Endif       
    Endif
Endif

FWRestArea(aArea)
FWRestArea(aAreaF1)
Return( Nil )

Neste código:

• SF1->F1_XCMSG representa um campo customizado para mensagens no cabeçalho da Nota após a gravação da NFE.
• FWAlertInfo exibe uma mensagem confirmando a mudança para o usuário.

Esse ponto de entrada não só automatiza o processo de atualização de status como também aumenta a segurança ao garantir que apenas notas com fornecedor internacional sejam alteradas.

Benefícios da Customização com MT103FIM

Aplicar o MT103FIM com uma função como essa pode ser benéfico para empresas que buscam agilidade e precisão no pós-processo fiscal. Algumas das vantagens incluem:

1. Redução de Erros Humanos: A atualização automática elimina a necessidade de intervenções manuais, minimizando a chance de erros.
2. Rastreabilidade: Logs e mensagens automáticas geradas pela função facilitam o rastreamento de ações, proporcionando maior controle.
3. Eficiência Operacional: Automatizar processos complementares à gravação da NFE aumenta a eficiência do fluxo de trabalho.
4. Customização de Regras de Negócio: Com o MT103FIM, a empresa consegue adaptar o sistema a processos específicos, garantindo uma gestão mais personalizada.

Considerações Finais

O ponto de entrada MT103FIM é uma ferramenta de automação poderosa e flexível no sistema Protheus. Sua capacidade de realizar operações adicionais após a gravação de uma NFE permite que as empresas customizem os fluxos fiscais e financeiros de acordo com suas necessidades, criando um processo mais automatizado e seguro. Ao aplicar as técnicas e exemplos práticos discutidos neste artigo, as empresas podem transformar a maneira como gerenciam as operações pós-gravação no Protheus, otimizando tempo e recursos enquanto garantem a integridade dos dados fiscais.