01. DADOS GERAIS

Produto:

TOTVS Backoffice

Linha de Produto:

Segmento:

Módulo:

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:

2.2 Requisitos

03. SOLUÇÃO

3.1 Central de Eventos - Envio via TC2

3.1.1 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 Mapeamento de Eventos para TC2

Correspondência de Eventos:

Evento

Descrição

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

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 Centralização do Processamento de Retorno

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:

  • Status 6: Autorizado
  • Status 3 e 5: Rejeitado
  • Status 1, 2 e 4: Sem retorno

3.1.5 Adequações na Interface

Ajustes para Suporte Dual:

  • Ocultar 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."

3.2 Geração de XML Padrão SEFAZ

3.2.1 Estrutura XML para TC2

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

3.2.2 Eventos Suportados para Geração

Eventos Validados:

  • 211128: Aceite de Débito na Apuração por Emissão de Nota de Crédito
  • 212110: Manifestação sobre Transferência de Crédito de IBS
  • 212120: Manifestação sobre Transferência de Crédito de CBS
  • 110001: Cancelamento de Evento

3.3 Processamento Automático de Retorno

3.3.1 Estrutura 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

3.3.2 Eventos Fiscais e Cancelamento

Processamento por Categoria:

Eventos de Apuração:

  • 211128: Aceite de débito na apuração
  • 212110: Manifestação Transferência IBS
  • 212120: Manifestação Transferência CBS
  • 110001: Cancelamento (entrada e saída)

Processamento:

  • Leitura automática dos arquivos de retorno
  • Identificação por código de documento TC2
  • Atualização do status conforme retorno recebido

3.3.3 Eventos de Crédito e Patrimônio

Eventos Suportados:

  • 112110: Informação de efetivo pagamento integral
  • 211130: Imobilização de Item

Características:

  • Processamento automático via rotina
  • Atualização de status em tempo real
  • Logs detalhados de processamento

3.3.4 Eventos de Faturamento

Eventos Incluídos:

  • 112130: Perecimento durante transporte (fornecedor)
  • 112140: Fornecimento não realizado
  • 112150: Atualização de Data de Previsão

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


04. DEMAIS INFORMAÇÕES

4.1 Critérios de Aceite

Testes de Envio via TC2:

  1. Validação de Eventos Principais
  2. Validação de Eventos de Faturamento

Testes de Retorno Automático:

  1. Processamento de Arquivos
  2. Validação por Categoria

4.2 Benefícios da Implementação

Vantagens Operacionais:

Melhorias no Processo:

4.3 Considerações de Implementação

Configuração Necessária:

Monitoramento:

Manutenção:

4.4 Fluxo Operacional

Para o Usuário:

  1. Envio de Eventos
  2. Acompanhamento

Processamento Interno:

  1. Envio
  2. Retorno


05. ASSUNTOS RELACIONADOS

Programas Envolvidos:

Transmissores Suportados:

Eventos Fiscais Suportados:

Funcionalidades Relacionadas:


06. ASSUNTOS RELACIONADOS