Páginas filhas
  • DBACKRTLGX-3676 - RT - Transmissão (envio/retorno) Novos Eventos NF-e [TC2]

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

Deck of Cards
effectDuration0.5
idtudo-sobre
effectTypeslide
Card
effectDuration0.5
labelOBF26200 - Envio de Eventos eventos via TC2
effectTypeslide

3.1

Programa OBF26200

Central de Eventos - Envio

de Eventos

via TC2

3.1.1

Ambiente TC2

Alteração na Função de Ambiente:

Função: obf26001_retorna_ambiente

Modificação:

SE vdpr140_usa_TC_sem_TSS = TRUE ENTÃO    

     Buscar ambiente TC2 com vdpr140_get_ambiente_tc   

     Retornar ambiente TC2

SENÃO   

     Continuar processo atual (TSS)

Identificação do Transmissor

Detecção Automática do Ambiente:

  • O sistema identifica automaticamente se deve utilizar TSS ou TC2
  • Quando TC2 estiver configurado, busca o ambiente específico do TC2
  • Mantém funcionamento normal para TSS quando não houver TC2

3.1.2

Novo Fonte OBF26003 - Processamento TC2

Mapeamento de Eventos para TC2

Correspondência de Eventos

Criação de Fonte Específico:

  • Nome: OBF26003
  • Função: Processamento completo de envio e retorno via TC2

Função de Tipo de Documento:

obf26003_tipo_doc_tc2(evento)

- Receber código do evento

- Retornar código do tipo documento Neogrid

- Para cancelamento: verificar origem (entrada/saída)

Mapeamento de Eventos para TC2:

Evento

DescriçãoTipo Neogrid

Código TC2

112110

Informação de efetivo pagamento integral

457

112120

Importação em ALC/ZFM não convertida

471

112130

Perecimento durante transporte (fornecedor)

472

112140

Fornecimento não realizado

473

112150

Atualização de Data de Previsão

000

211110

Solicitação de Apropriação de crédito

458

211120

Destinação para consumo pessoal

460

211124

Perecimento durante transporte (adquirente)

474

211128

Aceite de débito na apuração

475

211130

Imobilização de Item

461

211140

Apropriação de Crédito de Combustível

462

211150

Apropriação de Crédito para bens/serviços

464

212110

Manifestação Transferência IBS

465

212120

Manifestação Transferência CBS

466

110001

Cancelamento - Saída

469

110001

Cancelamento - Entrada

470

3.1.3 Processamento de Envio

Alteração na Função obf26200_processa_enviar:

SE m_usa_TC_sem_TSS = FALSE ENTÃO   

     Processamento TSS atual

SENÃO   

     SE vdpr140_copia_arquivo_xml_TC(tipo_documento, relatório, modo_exibição) ENTÃO       

     Obter caminho do arquivo XML copiado       

     Incluir monitoramento TC2       

     Gravar mensagem de sucesso no relatório   

SENÃO       

     Gravar mensagem de erro no relatório

Fluxo de Envio via TC2:

  1. Identificação do Transmissor
    • Sistema verifica se TC2 está configurado
    • Seleciona o processo de envio apropriado
  2. Preparação do Arquivo
    • Gera XML no formato compatível com TC2
    • Copia arquivo para diretório de saída do TC2
    • Registra informações de monitoramento
  3. Confirmação
    • Exibe mensagem de sucesso com localização do arquivo
    • Registra log do processo de envio
    • Atualiza status do evento

3.1.4

Atualização

Centralização do Processamento de Retorno

Centralizada

Nova Função: obf26001_atualiza_retorno_evento

Parâmetros da Função:

Padronização de Atualização:

  • Criação de processo centralizado para atualização de status
  • Utilizado tanto para retornos TSS quanto TC2
  • Evita duplicação de código e garante consistência

Mapeamento de Status de Retorno

  • empresa_origem: Empresa origem
  • trans_evento_apuracao: Transação
  • evento: Código do evento
  • status: Status do retorno (A/R/S)
  • id_evento: ID do evento
  • lote: Lote processado
  • protocolo_aut: Protocolo de autorização
  • data_hor_rec_protocolo: Data de retorno

Mapeamento de Status:

  • Status 6: "A" - Autorizado
  • Status 3 e 5: "R" - Rejeitado
  • Status 1, 2 e 4: "S" - Sem retorno

3.1.5 Adequações na Interface

-

Ajustes para

TC2

Remoção do Botão RetornoSuporte Dual:

  • Ocultar botão opção "Retornar" quando TC2 estiver configurado
  • Exibir mensagem informativa quando nenhum transmissor estiver configurado:

"Configurações do TSS/TC2 não encontradas. Configure para habilitar o envio e retorno de eventos."

Card
effectDuration0.5
labelGeração XML Parte Geral parte geral - TC2
effectTypeslide

3.2 Geração

XML Parte Geral - TC2

de XML Padrão SEFAZ

3.2.1

Nova Função de Versão

Função: obf26001_busca_versao_produto

  • Baseada em vdp9230_busca_versao_produto
  • Adaptada para programa OBF26200
  • Retorno sem caracteres especiais (PIPE)

3.2.2 Alteração na Geração XML

Função: obf26001_gera_xml_parte_geral

Estrutura XML para TC2:<?xml version="1.0" encoding="UTF-8"?>
<evento xmlns="http://www.portalfiscal.inf.br/nfe
        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance
        versao="1.00">
    <infEvento Id="[ID_EVENTO]">
        <cOrgao>[ORGAO_AUTOR]</cOrgao>
        <tpAmb>[AMBIENTE]</tpAmb>
        <CNPJ>[CPF_CNPJ]</CNPJ> <!-- ou CPF -->
        <chNFe>[CHAVE_ACESSO]</chNFe>
        <dhEvento>[DATA_HORA_UTC]</dhEvento>
        <tpEvento>[CODIGO_EVENTO]</tpEvento>
        <nSeqEvento>[SEQUENCIA]</nSeqEvento>
        <verEvento>[VERSAO_LAYOUT]</verEvento>
        <detEvento versao="[VERSAO_LAYOUT]">
            <descEvento>[DESCRICAO_EVENTO]</descEvento>
            <cOrgaoAutor>[ORGAO_AUTOR]</cOrgaoAutor>
            <tpAutor>[TIPO_AUTOR]</tpAutor> <!-- Não gerar para cancelamento -->
            <verAplic>[VERSAO_PRODUTO]</verAplic>
            <!-- Informações específicas do evento -->
        </detEvento>
    </infEvento>
</evento>

Formato Conforme Nota Técnica:

  • XML gerado seguindo padrão da NT da SEFAZ
  • Compatível com processamento TC2
  • Inclui todas as informações obrigatórias do evento

Elementos Principais do XML:

  • Identificação do evento
  • Dados da empresa (CNPJ/CPF)
  • Chave de acesso da NFe
  • Data e hora do evento
  • Tipo e sequência do evento
  • Versão do layout
  • Descrição do evento
  • Órgão autor
  • Tipo de autor (quando aplicável)
  • Versão da aplicação
Card
effectDuration0.5
labelJOB - Retorno de Eventos eventos via TC2
effectTypeslide

3.3

JOB - Retorno de Eventos via TC2

Processamento Automático de Retorno

3.3.1 Estrutura

Geral do JOB

Função Principal: obf26003_processa_arquivos_eventos_ibs_cbs

  • Chamada na função obf90001_processa_job_nfe
  • Antes da função obf90001_disconecta_banco
  • Processa retornos de todos os eventos

3.3.2 Eventos Fiscais e Cancelamento

Funções Específicas por Evento:

Evento 211128:

obf26003_processa_arquivos_211128

- Tipo documento: 475

- Buscar arquivos: '475_*'

- Processar retorno conforme padrão

Eventos 212110 e 212120:

obf26003_processa_arquivos_212110 → Tipo: 465

obf26003_processa_arquivos_212120 → Tipo: 466

Evento 110001 (Cancelamento):

obf26003_processa_arquivos_110001

- Tipos: 469 (saída) e 470 (entrada)

- Processar ambos os tipos na mesma função

3.3.3 Eventos CRE e PAT

Funções Específicas:

obf26003_processa_arquivos_112110 → Tipo: 457

obf26003_processa_arquivos_211130 → Tipo: 461

3.3.4 Eventos FAT

Funções Específicas:

obf26003_processa_arquivos_112130 → Tipo: 472

obf26003_processa_arquivos_112140 → Tipo: 473

obf26003_processa_arquivos_112150 → Tipo: 000

3.3.5 Processamento de Retorno

Estrutura Padrão de Processamento:

  1. Leitura de Arquivos

Buscar arquivos por tipo de documento

Processar cada arquivo encontrado

Extrair informações das TAGs XML

       2. TAGs Extraídas do Retorno:

    • <cStat>: Status do retorno
    • <xMotivo>: Motivo/descrição
    • <chNFe>: Chave de acesso da NFe
    • <tpEvento>: Tipo do evento
    • <nSeqEvento>: Sequência do evento
    • <idLote>: Lote processado
    • <nProt>: Protocolo de autorização
    • <dhRegEvento>: Data/hora do retorno

        3. Busca de Informações

SELECT empresa_origem, num_ar_trans, id_evento, trans_evento_apuracao

FROM obf_evento_apuracao

WHERE evento = [evento_retornado]

AND chave_acesso_nfe = [chave_retornada]

AND sequencia = [sequencia_retornada]

AND status_envio IN ('2','4')

         4. Atualização de Status

Mapeamento cStat para Status:

- cStat = 135 ou 136: \"A\" - Autorizado

- cStat > 200: \"R\" - Rejeitado

- Demais: \"S\" - Sem retorno

Chamar: obf26001_atualiza_retorno_evento

04. DEMAIS INFORMAÇÕES

4.1 Validações

4.1.1 Envio via TC2:

    • Envio via TC2 com sucesso
    • Geração correta do XML
    • Cópia para diretório OUT
    • Envio e confirmação de recebimento

4.1.2 Retorno via JOB:

Processamento de arquivos

    • Leitura correta dos arquivos de retorno
    • Extração das TAGs XML
    • Atualização correta do status

Validação por tipo de evento

    • Cada evento deve ter retorno processado
    • Status atualizados corretamente
    • Logs gerados adequadamente

4.2 Fluxo de Processamento

4.2.1 Envio de Eventos:

  • Identificar transmissor (TSS/TC2)
  • SE TC2:  

- Gerar XML padrão NT SEFAZ  

- Copiar para diretório OUT   

- Incluir monitoramento

  • Aguardar processamento TC2

4.2.2 Retorno de Eventos:

  • JOB processa diretório IN
  • Identifica arquivos por tipo de documento
  • Extrai informações do XML de retorno
  •  Busca evento na base de dados
  • Atualiza status via função centralizada
  • Registra logs de processamento

4.3 Benefícios

  • Suporte completo ao transmissor TC2
  • Padronização do processamento de retorno
  • Geração de XML conforme NT da SEFAZ
  • Processamento automatizado via JOB
  • Interface adaptada para ambos transmissores
  • Manutenção da compatibilidade com TSS

4.4 Considerações Técnicas

Configuração TC2:

  • Parametrização conforme documentação TOTVS Colaboração 2.0
  • Configuração de diretórios IN/OUT
  • Configuração de ambiente (homologação/produção)

Monitoramento:

  • Logs detalhados de envio e retorno
  • Controle de status por evento
  • Relatórios de inconsistências

Performance:

  • Processamento via JOB para não impactar usuários
  • Processamento em lotes para otimização
  • Controle de arquivos processados

05. ASSUNTOS RELACIONADOS

Programas Envolvidos:

  • OBF26200: Central de Eventos
  • OBF26003: Processamento TC2 (novo)
  • OBF26001: Funções auxiliares
  • OBF90001: JOB de processamento

Funções TC2 Utilizadas:

  • vdpr140_usa_TC_sem_TSS: Verificar uso TC2
  • vdpr140_get_ambiente_tc: Obter ambiente TC2
  • vdpr140_copia_arquivo_xml_TC: Copiar XML
  • vdpr140_get_arquivo_xml_tc: Obter caminho XML

Eventos Suportados e origens:

  • 110001: Cancelamento de Evento
  • 112110, 112130, 112140 E 112150: Eventos Faturamento ou fiscal
  • 112120, 211110, 211120, 211124, 211128, 211140, 211150, 212110 e 212120: Eventos do Suprimentos ou fiscal
  • 211130: Evento do Patrimônio 
  • 112110: Evento do Contas a receber

Estruturas de Dados:

...

de Processamento

Sistema Automatizado:

  • Processamento via rotina automática (JOB)
  • Leitura periódica de arquivos de retorno
  • Atualização automática do status dos eventos
  • Geração de logs de processamento

Funcionalidades:

  • Processamento automático de retorno
  • Identificação por tipo de documento
  • Atualização completa do status

3.3.5 Fluxo de Processamento de Retorno

Etapas do Processamento:

  1. Leitura de Arquivos
    • Sistema monitora diretório de retorno
    • Identifica arquivos por tipo de evento
    • Processa cada arquivo individualmente
  2. Extração de Informações
    • Lê informações do XML de retorno
    • Extrai status, motivos e protocolos
    • Identifica chave de acesso e evento relacionado
  3. Localização do Evento
    • Busca evento correspondente na base
    • Verifica chave de acesso e sequência
    • Confirma status de aguardando retorno
  4. Atualização de Status
    • Atualiza status conforme retorno recebido
    • Registra protocolo e data de autorização
    • Grava motivos de rejeição quando aplicável
  5. Registro de Logs
    • Gera logs detalhados do processamento
    • Registra erros e inconsistências
    • Mantém histórico de processamento
Card
effectDuration0.5
labelGeração de XML por empresa ou pasta central
effectTypeslide

03.4 Geração de XML por empresa ou pasta central

Critério de Definição de Diretório:

O sistema define automaticamente onde gerar os arquivos XML dos eventos seguindo uma hierarquia de configurações:

Prioridade 1 - Configuração por Empresa LOG00098:

  • Sistema verifica primeiro se existe parâmetro "EVT" configurado para a empresa específica com o caminho onde deve ser gravado o xml
  • Quando configurado, utiliza o caminho definido para aquela empresa
  • Permite configuração individualizada por empresa

Prioridade 2 - Pasta Central (Todas as Empresas):

  • Quando não existe parâmetro "EVT" por empresa, verifica o cadastro de eventos OBF26100
  • Se o campo "Caminho do XML" estiver preenchido no cadastro de eventos
  • Todos os XMLs do evento serão gerados no mesmo diretório
  • Aplicável para todas as empresas do sistema

Fluxo de Validação:

  1. Sistema verifica se existe parâmetro "EVT" configurado para a empresa no LOG00098
  2. Se configurado: utiliza caminho específico da empresa
  3. Se não configurado: verifica campo "Caminho do XML" no cadastro de eventos
  4. Se preenchido: utiliza pasta central para todas as empresas
  5. Gera XML no diretório apropriado conforme hierarquia identificada

...


06. ASSUNTOS RELACIONADOS



Templatedocumentos