Usina BRAdvPL Guia
Entrar
← Todos os tópicos
PONTO DE ENTRADAEm revisão

F340FCAN

User Function F340FCAN()

Permite gravações complementares no estorno da compensação a pagar.

F340FCANFINA340
01 · VISÃO GERAL

Visão geral

A ficha específica informa SE2 posicionada e execução dentro de Begin Transaction. Parâmetros e retorno não se aplicam. O exemplo oficial grava E2_DTCSTMZ, campo customizado; esse campo não deve ser tratado como padrão em qualquer ambiente. A chamada comunitária aparece em FA340CAN. (Refs. 1–2)

02 · SINTAXE

Sintaxe

User Function F340FCAN()

Retorno

Não se aplica. O exemplo oficial termina com NIL; o PE não é uma validação lógica do estorno.

03 · EXEMPLO PRÁTICO

Exemplo editorial baseado na documentação

#Include "Protheus.ch"

User Function F340FCAN()
    // Diagnóstico editorial no contexto transacional documentado (ref. 1).
    // Evita depender do campo customizado E2_DTCSTMZ do exemplo oficial.
    ConOut("F340FCAN: estorno em processamento; transacao ainda ativa")
Return Nil
Resultado esperado

Proposta didática com o comportamento descrito nos comentários. Conferir o contexto antes de compilar em homologação. Em revisão: exemplo não compilado nem executado em Protheus. Aliases, bloqueios, posição na transação e compatibilidade devem ser conferidos no release e patch utilizados.

04 · EXEMPLO PRÁTICO

Chamada observada e contexto

// Trecho do chamador P12.2210 (EURAI, ref. 2); não é implementação do PE.
// FINA340.PRX - FA340CAN() -> EXECBLOCK("F340FCAN",.F.,.F.)
Resultado esperado

O registro mostra argumentos e uso imediato do retorno quando presentes. Não inclui o corpo completo do chamador nem comprova a posição do commit.

BOAS PRÁTICAS
  • O diagnóstico publicado não grava. Para adaptar o exemplo de campo customizado, conferir SX3, identidade do título e RecLock; preservar a transação do padrão e testar rollback. Não enviar integrações externas supondo commit concluído.
  • Uma chamada sem quarto argumento não documenta um layout de PARAMIXB. Preservar identificadores do chamador e não inventar campos ou posições.
  • Roteiro de homologação: comparar o fluxo padrão e o customizado, testar sucesso, recusa e repetição e conferir saldos, movimentos e contabilização conforme o processo.
  • Em revisão: exemplo não compilado nem executado em Protheus. Aliases, bloqueios, posição na transação e compatibilidade devem ser conferidos no release e patch utilizados.

Conteúdos relacionados

REFERÊNCIAS
  1. TOTVS. F340FCAN – Gravação complementar no estorno da compensação de contas a pagar. TDN. Consulta em 2026-10-24.
  2. EURAI. Pontos de Entrada P12.2210 - Parte 2. Universo do Desenvolvedor, 2023. Consulta em 2026-10-24.
Situação
Em revisão
Página criada em
Última revisão em
Idioma original
Português
Revisão
Usina.BR
0 comentário(s) aprovado(s)

Comentários

Ainda não há comentários aprovados.

Entre com Google ou Microsoft para comentar.

Powered by Usina Docs · Alpha