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

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

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
Card
effectDuration0.5
labelJOB - Retorno de Eventos eventos via TC2
effectTypeslide

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
    • Evento 211128: Aceite de débito na apuração
    • Eventos 212110/212120: Manifestações de transferência
    • Evento 110001: Cancelamento
  2. Validação de Eventos de Faturamento
    • Eventos 112110, 112130, 112140, 112150, 211130
    • Envio com sucesso via TC2
    • Geração correta do XML

Testes de Retorno Automático:

  1. Processamento de Arquivos
    • Leitura correta dos arquivos de retorno
    • Atualização automática do status
    • Geração de logs apropriados
  2. Validação por Categoria
    • Eventos fiscais e cancelamento
    • Eventos de crédito e patrimônio
    • Eventos de faturamento

4.2 Benefícios da Implementação

Vantagens Operacionais:

  • Suporte completo ao transmissor TC2
  • Processamento automático de retorno
  • Geração de XML conforme padrão SEFAZ
  • Interface adaptada para ambos transmissores
  • Manutenção da compatibilidade com TSS

Melhorias no Processo:

  • Redução de intervenção manual
  • Padronização do processamento
  • Logs detalhados para auditoria
  • Controle centralizado de status

4.3 Considerações de Implementação

Configuração Necessária:

  • Parametrização do TOTVS Colaboração 2.0
  • Configuração de diretórios de entrada e saída
  • Definição de ambiente (homologação/produção)

Monitoramento:

  • Acompanhamento via logs do sistema
  • Controle de status por evento
  • Relatórios de inconsistências quando necessário

Manutenção:

  • Processamento automático via rotina do sistema
  • Controle de arquivos processados
  • Otimização para não impactar performance

4.4 Fluxo Operacional

Para o Usuário:

  1. Envio de Eventos
    • Selecionar eventos na Central de Eventos
    • Clicar em "Enviar"
    • Sistema identifica transmissor automaticamente
    • Confirmação de envio exibida na tela
  2. Acompanhamento
    • Status atualizado automaticamente
    • Consulta via Central de Eventos
    • Logs disponíveis para auditoria

Processamento Interno:

  1. Envio
    • Geração automática do XML
    • Cópia para diretório TC2
    • Registro de monitoramento
  2. Retorno
    • Processamento automático via rotina
    • Atualização de status
    • Geração de logs

05. ASSUNTOS RELACIONADOS

Programas Envolvidos:

  • Central de Eventos (OBF26200)
  • Cadastro de Eventos (OBF26100/OBF26300)
  • Processamento de Retorno (rotina automática)

Transmissores Suportados:

  • TSS (TOTVS Serviços de Sefaz)
  • TC2 (TOTVS Colaboração 2.0)

Eventos Fiscais Suportados:

  • Eventos de Cancelamento (110001)
  • Eventos de Faturamento (112xxx)
  • Eventos de Entrada (211xxx)
  • Eventos de Manifestação (212xxx)

Funcionalidades Relacionadas:

...

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

...