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.

...

Produto:

TOTVS Backoffice

Linha de Produto:

Linhas_totvs
LinhaLinha Logix

Segmento:

Segmentos_totvs
SegmentoBackoffice

Módulo:

Modulos_cross_segmentos
ModulosCrossSegmentosTOTVS Backoffice (Linha Logix) - Fiscal

Programa:

OBF26200: Central de Eventos

OBF26003: Processamento TC2 (novo)

OBF26001: Funções auxiliares

OBF90001: JOB de processamento

País:Brasil
Requisito/Story/Issue (informe o requisito relacionado) :

DBACKRTLGX-3676, DBACKRTLGX-3401, DBACKRTLGX-3511, DBACKRTLGX-3460, DBACKRTLGX-3566, DBACKRTLGX-3565, DBACKRTLGX-3439, DBACKRTLGX-3326, DBACKRTLGX-3529, DBACKRTLGX-3564, DBACKRTLGX-3531



VISÃO GERAL


Implementação completa do sistema de envio e retorno de eventos fiscais via TC2 (TOTVS Colaboração 2.0), incluindo geração de XML no padrão da Nota Técnica da SEFAZ, processamento via JOB de retorno e adequações na interface do usuário para suporte ao novo transmissor.

02. SITUAÇÃO/REQUISITO

2.1 Situação Atual

O sistema atualmente suporta apenas envio de eventos via TSS. Com a necessidade de utilizar o TC2 (TOTVS Colaboração 2.0) como transmissor alternativo, é necessário implementar:

  • Envio de eventos via TC2
  • Geração de XML no padrão da NT da SEFAZ
  • Processamento de retorno via JOB
  • Adequações na interface para suporte aos dois transmissores

2.2 Requisitos

  • Implementar envio de eventos via TC2
  • Desenvolver geração de XML compatível com TC2
  • Criar processamento de retorno via JOB
  • Adequar interface para suporte dual (TSS/TC2)
  • Manter compatibilidade com funcionalidades existentes

03. SOLUÇÃO


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

3.1 Programa OBF26200 - Envio de Eventos via TC2

3.1.1 Ambiente TC2

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

Função: obf26001_retorna_ambienteModificação:SE vdpr140_usa_TC_sem_TSS = TRUE ENTÃO    Buscar ambiente TC2 com vdpr140_get_ambiente_tc    Retornar ambiente TC2SENÃO    Continuar processo atual (TSS)

3.1.2 Novo Fonte OBF26003 - Processamento TC2

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ção

Tipo Neogrid

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 atualSENÃ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

3.1.4 Atualização de Retorno Centralizada

Nova Função: obf26001_atualiza_retorno_evento

Parâmetros da Função:

  • 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 Interface - Ajustes para TC2

Remoção do Botão Retorno:

  • Ocultar botão "Retornar" quando TC2 estiver configurado
  • Exibir mensagem 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 - TC2
effectTypeslide

3.2 Geração XML Parte Geral - TC2

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>


Card
effectDuration0.5
labelJOB - Retorno de Eventos via TC2
effectTypeslide

3.3 JOB - Retorno de Eventos via TC2

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:

 Validar evento 211128

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

Validar eventos fiscais

    • 212110, 212120, 110001
    • Envio e confirmação de recebimento

Validar eventos CRE/PAT

    • 112110, 211130
    • Processamento completo

Validar eventos FAT

    • 112130, 112140, 112150
    • Geração e envio corretos

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:

1. Identificar transmissor (TSS/TC2)

2. SE TC2:  

- Gerar XML padrão NT SEFAZ  

- Copiar para diretório OUT   

- Incluir monitoramento

3. Aguardar processamento TC2

4.2.2 Retorno de Eventos:

1. JOB processa diretório IN

2. Identifica arquivos por tipo de documento

3. Extrai informações do XML de retorno

4. Busca evento na base de dados

5. Atualiza status via função centralizada

6. 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:

  • 110001: Cancelamento de Evento
  • 112110, 112120, 112130, 112140, 112150: Eventos do Faturamento
  • 211110, 211120, 211124, 211128, 211130, 211140, 211150: Eventos de Entrada
  • 212110, 212120: Eventos de Manifestação

Estruturas de Dados:

  • Tabela de Eventos de Apuração
  • Tabela de Monitoramento TC2
  • Arquivos XML de envio e retorno


06. ASSUNTOS RELACIONADOS

...