• Avisos
  • Novidades
  • Documentação
  • Depoimentos
  • Blog
  • Materiais
  • Manuais
  • Dúvidas
  • Avisos
  • Novidades
  • Documentação
  • Depoimentos
  • Blog
  • Materiais
  • Manuais
  • Dúvidas

Documentação

  • ERP
    • Cadastro Geral (ERP)
      • Aprovação
        • Comercial
        • Contabilidade
        • Financeira
      • Cadastro geral
      • Consultas
        • Cadastro via SEFAZ
      • Manutenção de Cadastro Geral
      • Órgão Público
        • Item
        • Órgão Público
      • Propriedade rural
      • Relatórios
        • WRCAD009 - Relatório de cadastro geral
        • WRCAD080 - Relatório de endereços
        • WRCAD081 - Relatório de referências
        • WRCAD082 - Relatório de contatos
        • WRCAD083 - Relatório de parâmetros logísticos
        • WRCAD084 - Relatório de crédito de pessoa física
        • WRCAD085 - Relatório de propriedades rurais
        • WRCAD088 - Relatório de parâmetros financeiros
        • WRCAD089 - Relatório de clientes
    • Contabilidade
      • Cadastros
        • Centro de Custo
        • Divisão Contábil
        • Histórico Padrão
        • Lançamento Contábil Padrão
        • Livros Contábeis/Fiscais
        • Notas Explicativas
        • Perfil Contábil Item
        • Plano de Conta x Centro de Custo/Controle
        • Plano de Contas
      • Conciliação
        • Razão Auxiliar - Financeiro x Contábil
      • Consultas
        • Consulta Balancete
        • Consultas DRE
        • Validação do TMV
      • Custeio
        • Apuração Custeio
        • Centro de Custo
      • Demonstrativos
        • Lista de Modelos
      • Geração Arquivos
        • Lançamentos Contábeis
        • Razão Auxiliar – Implantação de Saldo
      • Lalur-Presumido
        • Apuração do IRPJ e da CSLL
      • Movimentações
        • Contábil Extemporâneo
        • Exercício Social
        • Integridade de Saldos Contábeis
        • Lote Contábil
        • Movimentação Contábil - Contabilidade
          • Exclusão de Lançamento - Movimentação Contábil
        • Razão Auxiliar
        • Validar Plano de Contas
      • Orçamento
        • Entidades
        • Entidades/Gestores
        • Geração de Orçamento
        • Indicadores
        • Manutenção de Orçamentos
        • Pacotes
        • Pacotes/Gestores
      • Rateio
        • Critério Rateio
        • Geração Rateio off-line
        • Lista de Modelos Rateio off-line
      • Relatórios
        • Exportação para Excel
        • WRCTD001 - Razão Contábil
        • WRCTD002 - Diário Contábil
        • WRCTD003 – Balanço Patrimonial
        • WRCTD004 - Balancete de Verificação
        • WRCTD005 – Demonstração de Resultado do Exercício
        • WRCTD007 - Conferência Lote Contábil
        • WRCTD008 - Conferência Lote Contábil (Sintético)
        • WRCTD010
        • WRCTD011 - Demonstração de Resultado do Exercício (Trimestral)
        • WRCTD023 – Orçamento Contábil por Pacote de Gastos (Modelo A)
      • Sped Contábil (ECD)
        • Bloco I
          • I053 - Subcontas Correlatas
          • I157 - Transferência de Saldos de Plano de Contas Anterior
        • Bloco K
          • K100 - Empresas Consolidadas
          • K200 - Plano de Contas Consolidadas
          • K300 - Saldos das Contas Consolidadas
        • Geração de Arquivo SPED Contábil
      • Sped Fiscal (ECF)
        • Bloco M
          • M312 - Números dos Lançamentos Relacionados à Conta Contábil IRPJ
          • M315 - Processo do Lalur
          • M362 - Números dos Lançamentos Relacionados à Conta Contábil CSLL
          • M365 - Processo do Lacs
          • M415 - Processo da Parte B
        • Bloco V
          • V010 - DEREX - Instituição
          • V020 - DEREX - Responsável Movimentação
          • V100 - DEREX - Demonstrativo dos recursos em moeda estrangeira
        • Bloco X
          • X280 - Atividade Incentivada
          • X291 - Pessoa Vinculada
          • X292 - Pessoa Não Vinculada
          • X300/X305/X310 - Exportações
          • X320/X325/X330 - Importações
          • X340/X350-X357 - Part. Exterior
          • X400/X410 - Comércio Eletrônico e Tecnologia da Informação
          • X420 - Royalties Rec./Pag. a Beneficiários do Brasil e do Exterior
          • X430 - Rendimentos relativos a Serviços, Juros e Dividendos
          • X450 - Pagamentos/Remessas Relativos a Serviços, Juros e Dividendos Recebidos do Brasil e do Exterior
          • X460 - Inovação Tecnológica e Desenvolvimento Tecnológico
          • X470 - Capacitação de Informática e Inclusão Digital
          • X480/X485 - Benefícios Fiscais - Parte I/Parte II
          • X490 - Pólo Industrial de Manaus e Amazônia Ocidental
          • X500 - Zonas de Processamento de Exportação (ZPE)
          • X510 - Áreas de Livre Comércio
        • Bloco Y
          • Y570 - IR/CSLL Retidos na Fonte
          • Y580 - Doações a Camp. Eleitorais
          • Y590 - Ativos no Exterior
          • Y600 - Ident. Sócios ou Titular
          • Y611 - Rendimentos
          • Y620 - Coligadas/Controladas
          • Y630 - Fundos/Clubes de Investimentos
          • Y640/Y650 - Part. Consórcio de Empresa
          • Y660 - Dados de Sucessora
          • Y665 - Diferenças na Adoção Inicial
          • Y671 - Outra Informação (LR)
          • Y672 - Outra Informação (LP/LA)
          • Y680/Y681 - Refis de Lucros
          • Y690 - Paes
        • Contas e Saldos Iniciais da Parte B
        • Controle de Saldos das Contas do E-lalur e do E-lacs (ParteB)
        • ECF Apuração
    • Controle Patrimonial
      • Cadastros
        • Bem — Cadastro de Bens do Controle Patrimonial
        • Local do Bem — Controle Patrimonial
        • Motivo de Ocorrência
        • Ocorrência do Bem — Controle Patrimonial
        • Ocorrências em Lote — Controle Patrimonial
        • Perfil Contábil do Patrimônio — Controle Patrimonial
      • Fechamentos
        • Depreciação (Simulador) - Controle Patrimonial
        • Fechamento de CIAP
        • Fechamento de CPCAP (Pis/Cofins) — Controle Patrimonial
        • Fechamento do Controle Patrimonial
      • Manuais, Procedimentos, Orientações e Boas Práticas
        • Implantação do Controle Patrimonial
        • Roteiro de Boas Práticas - Orientação de uso rotineiro do módulo Controle Patrimonial do ERP Atak
      • Relatórios
        • WRCPM050 — Relatório de Inventário de Bens (Analítico)
        • WRCPM051
        • WRCPM052 — Extrato de Ocorrência do Bem
        • WRCPM053 — Demonstrativo de Saldo de Bens por Grupo Contábil (Analítico)
        • WRCPM054 — Relação de Ocorrências com Bens por Período
        • WRCPM055
        • WRCPM056 — Ocorrências com Bens por Período (Sintético)
        • WRCPM057 — Extrato do Bem: Recuperação de Tributos
        • WRCPM058 — Resumo Mensal: Recuperação de Tributos
        • WRCPM059 — Lista de Bens a Serem Alocados
        • WRCPM060 — Conferência das Contabilizações das Ocorrências
        • WRCPM061 — Demonstrativo de Tributos a Recuperar
        • WRCPM062 — Relatório de Bens por Centro de Custo/Controle e Conta Contábil
    • Curtume
      • Cadastro de Classificações de Couro
      • Ordem de Produção Classificação de Couros
    • DF-e
      • NFS-e
        • Importação de NFS-e
        • Monitoramento de NFS-e
        • Transmissão de NFS-e
    • Escrita Fiscal
      • Apuração por UF
        • Conferência da Sistemática
        • ICMS Sistemática (PE)
        • Livro SEFAZ
        • Ocorrências do ICMS Antecipado (PE)
      • Apurações
        • Fechamento Apuração de IPI
        • Fechamento Apuração ICMS Difal
        • Fechamento Apuração ICMS-ST - Escrita Fiscal
        • Fechamento Apuração ISS
        • Fechamento Apuração PIS/COFINS - Escrita Fiscal
        • Fechamento Apuração Tributo (Genérico)
        • Período Apuração Tributos - Escrita Fiscal
      • Cadastros
        • 5.3 - Tabela de Ajustes e Informações de Valores Provenientes de Documento Fiscal
        • Classificação Tributária de Crédito Presumido IBS/CBS
        • Classificação Tributária IBS/CBS
        • Classificação Tributária IS
        • Código de Serviço NBS
        • Código Serviço Tributação Nacional do ISSQN
        • INSS - Escrita Fiscal
        • Modelo Guia de Tributos
        • Pauta de Tributo
        • Pauta Produto — Escrita Fiscal
        • Situação Tributária
          • Situação Tributária COFINS — Escrita Fiscal
          • Situação Tributária IBS/CBS — Escrita Fiscal
          • Situação Tributária ICMS — Escrita Fiscal
          • Situação Tributária IPI — Escrita Fiscal
          • Situação Tributária IS — Escrita Fiscal
          • Situação Tributária PIS - Escrita Fiscal
        • Tabela de Códigos de Ajuste da Apuração do IPI
        • Tabela de Códigos de Ajustes da Apuração do ICMS / Tabela de Informações Adicionais da Apuração - Valores Declaratórios
        • Tabela de Informações Adicionais dos Itens do Documento Fiscal
        • Tabela de Tipos de Utilização dos Créditos Fiscais de ICMS
        • Tabelas Códigos Receitas (Federal)
      • Escrita X Contabilidade
        • Consulta de Documentos Eletrônicos - CT-e
        • Consulta de Documentos Eletrônicos - NF-e
        • Consulta de Lançamentos Fiscais
        • Contabilização de Lançamentos Fiscais
        • Contabilização de Tributos Fiscais
        • Importar Notas do XML - Escrita Fiscal
      • Eventos
        • ECONF - Conciliação Financeira - Escrita Fiscal
        • Registro de Eventos — Escrita Fiscal
      • Módulo De Inclusão De Tributos
        • Declaração do MIT
      • Movimentações
        • Inventário de Estoque Fiscal
        • Livro de Registro de Exportação
        • Livro Registro de Importação — Escrita Fiscal
        • Manutenção de Geração de Tributos nos Documentos — Escrita Fiscal
        • Movimentação de Apuração de Tributo — Escrita Fiscal
      • Tabelas/Modelos
        • Exportação para Excel - Escrita Fiscal
        • Modelo de Ajuste de Apuração
      • Tributos
        • Alíquota Referência - Município
        • Alíquota Referência - País
        • Alíquota Referência - UF
        • Assistente de Parametrização IBS/CBS/IS
        • Configurador IBS/CBS/IS
        • Tributação por Item
        • Tributação por TMV — Escrita Fiscal
    • Faturamento
      • Dashboard de Documentos Eletrônicos
      • Geração de Documento Destino
      • Impressão de Documento Auxiliar, Quantidade de Impressões por TMV e Ordem
      • Rotina de Transferência de Participante
    • Financeiro
      • Cadastro
        • Moeda
      • Caixa
        • Depósito Não Identificado
        • Despesas
        • Devolução de Cheque a Receber Segunda Vez
        • Devolução de Cheque Próprio pela Primeira Vez
        • Reapresentação de Cheque de Terceiro
        • Reapresentação de Cheque Próprio
        • Receitas
      • Cobranca
        • Alteração da Forma de Cobrança
        • Alteração de Carteira
        • Alteração de Comissão
        • Alteração de Vencimento
        • Baixa de Título da Cobrança
        • Baixa de Título da Cobrança Descontada
        • CobrancaAlteracaoDeFormaDeCobranca
        • Consulta de Remessa
        • Consulta de Títulos
        • Consulta e Liquidação via API (PIX e Boleto)
        • Consulta e Liquidação via API (PIX)
        • Desconto de Duplicatas
        • Inclusão de Decréscimo
        • Inclusão de Desconto na Cobrança
        • Inclusão de Juros
        • Inclusão de Multa
        • Liquidação Manual
        • Remessa (arquivo)
        • Retorno (arquivo)
      • Comex
        • Contrato de Câmbio
          • Contrato de Câmbio
        • Desvinculação de Contrato x Fatura
        • Desvinculação De Fatura
          • Desvinculação de fatura
        • Juros Do Contrato
          • Juros do contrato
        • Juros para Contrato de Câmbio
        • Liquidação de Contrato
          • Liquidação de contrato
        • Liquidação de Fatura
          • Liquidação de fatura
        • Liquidação De Fatura Sem Contrato
          • Liquidação de Fatura Sem Contrato
        • Relatórios
          • Wrexp021 - Faturas Vinculadas X Contrato De Câmbio
            • WREXP021 - Faturas Vinculadas X Contrato De Câmbio
        • Vinculação de Contrato x Fatura
        • Vinculação De Fatura
          • Vinculação de fatura
      • Comex - Relatórios
        • Wrexp011 - Posição Financeira Exportação
          • WREXP011 - Posição Financeira Exportação
        • Wrexp012 - Posição Contrato Câmbio X Faturas Não Vinculadas Por Carteira
          • WREXP012 - Posição Contrato Câmbio x Faturas Não Vinculadas por Carteira
        • Wrexp013 - Contratos De Cambio X Faturas Vinculadas
          • WREXP013 - Contratos de Cambio X Faturas Vinculadas
      • Compensações
        • Pagar X Adto. A Fornecedor
          • Pagar x adto. a fornecedor
        • Pagar X Devolução A Fornecedor
          • Pagar x devolução a fornecedor
        • Receber X Adto. De Cliente
          • Receber x adto. de cliente
        • Receber X Devolução Cliente
          • Receber x devolução cliente
        • Receber X Pagar
          • Receber x pagar
      • Fechamentos
        • Banco
          • Banco
        • Financeiro
          • Financeiro
      • Pagamento
        • Inclusão de Desconto no Pagamento
      • Relatorios
        • Movimentação Financeira por Carteira - Conciliado
        • Relatório de Negativação SERASA
        • WRBNC001 - Fluxo de Caixa Analítico
        • WRBNC002 - Fluxo de Caixa Sintético
        • WRBNC003 - Fluxo de Caixa Analítico por Conta de Resultado
        • WRBNC004 - Fluxo de Caixa Sintético por Conta de Resultado
        • WRBNC005 - Fechamento Diário
        • WRBNC006 - Movimentação Financeira por Carteira
        • WRBNC007 - Movimentação Financeira por Carteira (sintética)
        • WRBNC008 - Fechamento Diário Detalhado
        • WRBNC010 - Fluxo de Caixa
        • WRBNC011 - Movimentação Financeira por Carteira e Conta Contábil
        • WRBNC090 - Conferência Diária Vendas Cupom Loja
      • Renegociações
        • Com Clientes
          • Com clientes
        • Com Fornecedores
          • Com fornecedores
      • Serviços
        • 2ª Via Boleto Cliente
          • 2ª via boleto cliente
        • 2ª Via Comprovante Lançamento
          • 2ª via comprovante lançamento
        • Envio De Negativação
          • Envio de Negativação
        • Geração Pix
          • Geração PIX
        • Manutenção De Remessa
          • Manutenção de Remessa
        • Retorno De Negativação
          • Retorno de Negativação
      • Serviços / Orgão Público
        • Empenho
          • Empenho
      • Transferencias
        • Adiantamento de Cliente
        • Adiantamento de Fornecedor
        • Transferência Entre Contas
        • Transferência Entre Múltiplas Contas
    • Obrigações Acessórias Federais
    • Suprimentos
      • Cadastros
        • Compradores Família Produtos
        • Fornecedores Família Produtos
      • Compra
        • Aprovação de Orçamentos (Cotações)
        • Aprovação de Pedidos de Compra
        • Aprovação de solicitação
        • Cotações de compra
        • Gerar cotações
        • Orçamentos de Fornecedores
        • Pedido de Compra sem Cotação
        • Pré-aprovação de orçamentos
        • Solicitação de Compras
      • Consumo
        • Devolução de consumo
        • Requisição de consumo
        • Solicitação de Materiais
      • Recebimento
        • Registro de entregas
      • Relatórios
        • WRSUP001 - Lista de compradores
        • WRSUP002 - Lista de fornecedores
        • WRSUP003 - Sugestão de compra
        • WRSUP004 - Solicitação de compra
        • WRSUP005 - Cotação
        • WRSUP006 - Orçamento
        • WRSUP007 - Análise de orçamentos
        • WRSUP008 - Entregas em atraso
        • WRSUP009 - Previsão de entrega
        • WRSUP010 - Conferência de carga x lançamentos de notas de entrada
        • WRSUP011 - Acompanhamento de compra
        • WRSUP012 - Solicitação de material
        • WRSUP013 - Gastos por centro de custo/controle
        • WRSUP014 - Gastos por conta contábil
        • WRSUP015 - Gastos por centro de custo/controle conta contábil
        • WRSUP016 - Ficha de histórico de produto
        • WRSUP017 - Histórico de fornecedor
        • WRSUP018 - Sugestão de Compras
    • Tabelas Auxiliares
      • Cadastros Gerais
        • Mensagem
Nenhum resultado encontrado
Inteligência Atak / Documentação / ERP / Escrita Fiscal / Escrita X Contabilidade

Importar Notas do XML – Escrita Fiscal

Criado por Igor Ribeiro em 26 de outubro de 2026
•
Atualizado por Igor Ribeiro em 26 de outubro de 2026
Documentação Técnica

Escrita Fiscal — Escrita x Contabilidade — Importar Notas do XML

A rotina Importar Notas do XML pertence ao módulo Escrita Fiscal do ERP Atak, dentro do agrupamento de menu Escrita x Contabilidade.

01. 1. VISÃO GERAL DA ROTINA

1. Visão Geral da Rotina

A rotina Importar Notas do XML pertence ao módulo Escrita Fiscal do ERP Atak, dentro do agrupamento de menu Escrita x Contabilidade. Ela lê arquivos XML de notas fiscais eletrônicas depositados em uma pasta do servidor e transforma cada arquivo em um lançamento completo do Livro de Registro de Entradas e Saídas da filial logada, sem que o usuário precise digitar a nota manualmente na escrituração.

A importação cobre todo o ciclo de escrituração de um documento eletrônico: identifica se a nota é de entrada ou de saída comparando o CNPJ da filial com o emitente e o destinatário do XML, cria automaticamente os cadastros que ainda não existem no sistema (fornecedor, cliente, transportador, produto, referência de produto, unidade de medida, CFOP, estado, seção, grupo e subgrupo de produto e o próprio lote da escrita), grava o cabeçalho do livro, os itens com CFOP e CST, os tributos de cada item (ICMS, ICMS-ST, IPI, PIS e COFINS), as parcelas da cobrança informadas em duplicatas e o conteúdo do XML original vinculado ao lançamento. A rotina também interpreta arquivos de evento de cancelamento de NF-e e marca o lançamento correspondente como cancelado.

A rotina trabalha exclusivamente com NF-e modelo 55 e NFC-e modelo 65, nas versões de leiaute 2.00, 3.10 e 4.00, além dos arquivos de evento de NF-e na versão 1.00 e dos arquivos de cancelamento de NF-e no formato antigo. Documentos de outros tipos — CT-e, NFS-e, MDF-e, CF-e SAT e NF-e sem protocolo de autorização — não são escriturados por esta rotina. A importação não emite nota fiscal, não se comunica com a SEFAZ, não gera títulos em Contas a Pagar ou Contas a Receber (as parcelas ficam registradas apenas no livro) e não movimenta estoque.

02. 2. VÍDEO TUTORIAL

2. Vídeo Tutorial

▶ Tutorial em vídeo: ainda não disponível para esta rotina.

03. 3. PRÉ-REQUISITOS E CONTEXTO DE ACESSO

3. Pré-requisitos e Contexto de Acesso

3.1 Permissões de acesso

O acesso à tela e a cada uma de suas ações é controlado pelo cadastro de recursos disponíveis do usuário, dentro do menu Escrita Fiscal, no grupo Escrita x Contabilidade. Os direitos envolvidos são:

  • Importar Notas do XML (recurso 1634) — libera a abertura da própria tela.
  • Iniciar Processo (recurso 1664) — libera a execução da importação.
  • Parar Processo (recurso 1665) — libera a interrupção de uma importação em andamento.
  • Excluir Histórico (recurso 1826) — libera a limpeza dos logs de execução.

As ações de leitura — obtenção da pasta e do status da filial e carga das grades de log — não exigem direito específico: basta que o usuário tenha sessão ativa no sistema. O título do recurso aparece traduzido como “Import XML Notes” em inglês e “Importar notas XML” em espanhol.

3.2 Filial logada

A rotina opera sempre sobre a filial logada. A tela identifica a filial a partir da sessão do usuário e envia esse identificador em todas as chamadas ao servidor. Se o usuário não possuir filial logada atribuída, o sistema interrompe a execução com a mensagem “Filial logada não atribuída ao usuário.”

3.3 Estrutura de pastas no servidor

O sistema procura os arquivos em uma estrutura fixa no servidor, criada a partir da raiz C:\XML. Dentro dela o sistema usa uma pasta por filial, nomeada com o identificador da filial seguido de hífen e do CNPJ cadastrado no campo CPFCGC da filial. Dentro da pasta da filial o sistema cria, quando ainda não existirem, as subpastas NFE (arquivos de controle e logs), IMPORTADOS e NAOIMPORTADOS.

O usuário — ou uma rotina externa do cliente — deposita os arquivos XML diretamente na raiz da pasta da filial. Arquivos colocados em subpastas não são lidos, porque a varredura não é recursiva. Se o sistema não conseguir criar a pasta da filial, a execução é interrompida com a mensagem “Erro ao processar arquivos. / Não foi possível criar a pasta da filial {0}. / Verifique as permissões de acesso à pasta e tente novamente.”

A pasta de origem é fixa, definida pelo próprio sistema, e não é informada nem alterada pelo usuário na tela.

3.4 Cadastros e configurações exigidos previamente

Para que a importação conclua um documento, o ambiente precisa estar preparado com:

  • Sequência de numeração ativa para o modelo fiscal da nota, na tabela TBSEQUENCIA, com STATUS_SEQUENCIA igual a “S”. É dela que o sistema obtém o código do documento usado no livro.
  • Período de apuração aberto para cada tributo escriturado (ICMS, ICMST, IPI, PIS e COFINS), na filial e na data de entrada/saída do documento.
  • Lote da escrita compatível com a data do documento, ou permissão para que a rotina crie o lote diário automaticamente. O lote precisa estar aberto no momento da gravação.
  • Impostos cadastrados no cadastro de tributos do sistema com os identificadores ICMS, ICMST, IPI, PIS e COFINS.
  • Parâmetros de tipo de cadastro: parâmetro de identificador 22 (tipo de cadastro de fornecedor), parâmetro 15 (tipo de cadastro de cliente) e parâmetro 68 (tipo de cadastro de transportadora). O primeiro valor de cada parâmetro é atribuído aos cadastros criados pela rotina.
  • Parâmetro de identificador 255 — cadastro geral usado como participante padrão nas NFC-e sem destinatário identificado.
  • Exercício social aberto, exigido quando o sistema precisa excluir um livro gravado parcialmente.

3.5 Cadastros auxiliares criados pela própria rotina

A rotina cria sozinha, quando ainda não existem, o item tributário padrão de código 999999 com o nome “Importação XML – Item tributário”, a seção, o grupo e o subgrupo de produto de código 9999 com o nome “Importação XML”, as unidades de medida informadas nos XML, os estados, os códigos CFOP e os lotes diários da escrita. Nenhum desses cadastros precisa ser preparado antes da primeira execução.

04. 4. PROCESSO DE CRIAÇÃO / EMISSÃO — PASSO A PASSO

4. Processo de Criação / Emissão — Passo a Passo

Passo 1: Abertura da tela Importar XML’s O usuário acessa o menu Escrita Fiscal, grupo Escrita x Contabilidade, e seleciona a rotina Importar Notas do XML. O sistema abre a janela Importar XML’s em aba única. Imediatamente após a abertura, o sistema consulta a pasta e o status de processamento da filial logada, preenche o campo Caminho da janela Importar XML’s com a pasta devolvida pelo servidor e exibe no campo Status da janela Importar XML’s o indicador correspondente ao estado atual.

Passo 2: Verificação do status corrente da filial O sistema avalia a existência do arquivo semáforo PROCESSANDO.TXT na subpasta NFE da filial. Quando o arquivo existe, o sistema considera que há uma importação em andamento, exibe a imagem de carregamento no campo Status da janela Importar XML’s, desabilita o botão Importar XML’s e habilita o botão Cancelar importação. Quando o arquivo não existe, o sistema exibe a imagem de confirmação, habilita o botão Importar XML’s e desabilita o botão Cancelar importação.

Passo 3: Depósito dos arquivos XML na pasta da filial O usuário coloca os arquivos de extensão XML na raiz da pasta da filial indicada no campo Caminho da janela Importar XML’s. O sistema reconhece apenas as grafias de extensão em letras minúsculas e em letras maiúsculas; grafias mistas são ignoradas na varredura.

Passo 4: Acionamento da importação O usuário clica no botão Importar XML’s da barra de ferramentas, ou usa o atalho Ctrl+I. O sistema envia ao servidor o comando de início de processo para a filial logada e exibe de imediato a mensagem “O processo foi iniciado com sucesso. Você pode sair e retornar a qualquer momento para esta tela, para acompanhar o status do processo.” O processamento continua no servidor mesmo que o usuário feche a aba.

Passo 5: Inicialização do processo no servidor O sistema carrega a filial e o usuário logado, resolve ou cria a pasta da filial e suas subpastas, cria o arquivo semáforo PROCESSANDO.TXT e apaga o conteúdo dos arquivos SUCESSO.LOG e ERROS.LOG, de modo que o histórico apresentado na tela corresponde sempre à última execução. Se o sistema não conseguir criar os arquivos de controle e de log, ele remove o semáforo e emite a mensagem “Erro ao processar arquivos. / Não foi possível criar os arquivos de processamento e de logs.”

Passo 6: Listagem e ordenação dos arquivos O sistema lista os arquivos existentes na raiz da pasta da filial, filtra somente os de extensão XML e os ordena por tamanho decrescente, de modo que as notas fiscais completas são processadas antes dos arquivos de evento, que são menores. Se a pasta estiver vazia, o sistema grava no log de erros a linha “Nenhum arquivo foi encontrado na pasta {pasta}”.

Passo 7: Leitura do arquivo e verificação de cancelamento do processo Antes de cada arquivo o sistema verifica se o semáforo PROCESSANDO.TXT ainda existe. Se o arquivo de controle tiver sido removido pelo botão Cancelar importação, o sistema encerra o laço e para a execução. Caso contrário, o sistema lê o conteúdo completo do arquivo e remove as quebras de linha do texto. É esse texto, sem quebras de linha, que o sistema grava posteriormente como XML do documento.

Passo 8: Identificação do tipo de arquivo O sistema procura no texto do arquivo as marcações de nota fiscal eletrônica processada, de evento de NF-e e de cancelamento de NF-e. Encontrando qualquer uma delas, o sistema segue com a interpretação. Não encontrando nenhuma, o sistema grava no log de erros a linha “{arquivo} – Não foi possível importar o arquivo. Padrão não suportado.” e marca o arquivo como não importado.

Passo 9: Interpretação do XML conforme versão e modelo O sistema identifica a versão do leiaute presente no texto e direciona a leitura: versão 2.00, versão 3.10 ou versão 4.00. Na versão 4.00 o sistema ainda lê o modelo do documento: modelo 55 segue pela leitura de NF-e e modelo 65 segue pela leitura específica de NFC-e. Arquivos de evento alimentam a chave de acesso do evento e o tipo do evento; arquivos de cancelamento no formato antigo recebem o tipo de evento 110111.

Passo 10: Classificação em entrada ou saída O sistema compara o CNPJ do emitente e o CNPJ do destinatário com o CNPJ da filial logada. Quando o emitente é diferente da filial e o destinatário é a filial, o documento é classificado como entrada. Quando o destinatário é diferente da filial e o emitente é a filial, o documento é classificado como saída. Quando o documento não se encaixa em nenhuma das duas situações, o sistema emite “Nota não pertencente a essa filial. / A nota fiscal não está vinculada à filial informada. / Verifique a filial da nota fiscal e tente novamente.”

Passo 11: Verificação de duplicidade O sistema procura um livro já gravado com a mesma chave de acesso, na mesma filial e no mesmo tipo de lote (entrada ou saída). Encontrando, o sistema grava no log de erros a linha “{chave} – Chave de acesso já existente.” e não importa o documento. Não encontrando, o sistema prossegue para a gravação.

Passo 12: Criação ou localização do cadastro do emitente O sistema procura o cadastro geral pelo CNPJ ou CPF do emitente. Não existindo, cria o cadastro com nome, apelido, inscrição estadual, estado e tipo de pessoa deduzido do tamanho do documento, atribuindo o tipo de cadastro do parâmetro 22. O sistema grava no log de sucesso a linha “Fornecedor incluído com sucesso. Código: {id} – Nome: {nome}”.

Passo 13: Criação ou localização do cadastro do destinatário O sistema repete o procedimento para o destinatário, atribuindo o tipo de cadastro do parâmetro 15 e usando o nome também como apelido. O sistema grava no log de sucesso a linha “Cliente incluído com sucesso. Código: {id} – Nome: {nome}”. O emitente e o destinatário são sempre tratados, tanto em notas de entrada quanto em notas de saída.

Passo 14: Resolução dos produtos de cada item Para cada item da nota o sistema identifica o produto correspondente no cadastro de itens. Em notas de saída, o sistema separa o código do produto do XML em código e referência e procura o item no cadastro. Em notas de entrada, o sistema procura antes a tabela de de/para entre o código do produto do fornecedor e o código do produto do sistema. Não encontrando o produto, o sistema cria o cadastro conforme as regras da seção 8.

Passo 15: Resolução das unidades de medida Para cada item o sistema procura a unidade de medida informada no XML dentro da tabela TBUNIDADE. Não encontrando, o sistema cria a unidade automaticamente aplicando as regras de montagem de código descritas na seção 8.

Passo 16: Obtenção ou criação do lote da escrita O sistema determina o tipo do lote (“E” para entrada, “S” para saída) e a data de referência (data de entrada/saída para entradas, data de emissão para saídas). Em seguida procura um lote da filial, do mesmo tipo, cujo intervalo entre data inicial e data final contenha essa data. Não existindo, o sistema cria um lote diário, com nome e identificador formados pelo prefixo “LE” ou “LS” seguido da data no formato de dia, mês e ano, com data inicial igual à data final e status aberto. O sistema grava no log de sucesso a linha “Lote da Escrita Fiscal incluído com sucesso. Código: {id} – Tipo do Lote: {Entrada ou Saída}”.

Passo 17: Gravação do cabeçalho do livro O sistema grava o lançamento no Livro de Registro de Entradas e Saídas com os dados do cabeçalho da nota, do participante e do veículo, status “F” de faturado, status da NF-e “A” de autorizado e origem do lançamento “X” de importado por XML. Antes de gravar, o sistema valida a existência do lote, se o lote está aberto, se a data de registro está preenchida e se o lançamento cabe no período do lote. O sistema grava no log de sucesso a linha “Livro com chave fato: {id} adicionado com sucesso ao lote: {lote} na filial: {filial}”.

Passo 18: Gravação dos itens do livro Para cada item o sistema grava número do item, produto, referência, nome, unidade, quantidade, valor unitário, valor do item, frete, seguro, desconto, valor contábil do item, situação tributária de ICMS formada pela origem da mercadoria mais o CST, situações tributárias de IPI, PIS e COFINS, e o CFOP resultante da regra descrita na seção 9. O sistema grava no log de sucesso a linha “item {id} adicionado ao livro: {livro} no lote: {lote} da filial: {filial}” e acumula o valor contábil do item no valor contábil do livro.

Passo 19: Cálculo e gravação dos tributos de cada item Para cada imposto presente na nota, o sistema classifica os valores vindos do XML nas colunas de base, imposto, percentual, percentual de redução, isentas e outras, conforme a tabela de CST aplicável. Antes de gravar cada tributo, o sistema localiza o período de apuração do imposto para a filial e a data de entrada/saída. Sem período aberto, o sistema emite “Não foi possível concluir a operação. / Não existe período de apuração aberto para o tributo {0} na filial {1} para a data {2}, lote {3}, livro {4}, item {5}.” Gravando, registra no log de sucesso “Tributo: {imposto} adicionado ao item: {item}, lote: {lote}, livro: {livro}”.

Passo 20: Gravação das parcelas da cobrança Havendo duplicatas no XML, o sistema grava as parcelas do documento fiscal com número do título montado pelo código do documento, série e número da nota, tipo de emissão própria ou de terceiros, número da parcela, total de parcelas, data de vencimento, valor da duplicata e origem do lançamento “X”. O sistema grava no log de sucesso a linha “Parcelas adicionadas ao lote: {lote}, livro: {id}”.

Passo 21: Armazenamento do XML original O sistema grava o texto do XML, sem as quebras de linha, na tabela TBLIVROREGESXMLDOC, acompanhado do hash MD5 do conteúdo, vinculado ao livro recém-criado. O sistema grava no log de sucesso a linha “Documentos XML adicionados ao lote: {lote}, livro: {id}”.

Passo 22: Fechamento do lançamento O sistema regrava o livro para persistir o valor contábil acumulado a partir dos itens e atualizar o valor e a quantidade realizados do lote da escrita.

Passo 23: Destinação do arquivo processado Ao final de cada arquivo, o sistema copia o XML para a subpasta IMPORTADOS quando nenhum erro foi registrado, ou para a subpasta NAOIMPORTADOS quando qualquer erro foi registrado para aquele arquivo, e em seguida remove o arquivo da raiz da pasta da filial.

Passo 24: Reprocessamento dos eventos pendentes Depois de percorrer todos os arquivos, o sistema reprocessa a lista de eventos cujo livro ainda não existia no momento da primeira tentativa, permitindo que um evento de cancelamento encontre a nota importada na mesma execução.

Passo 25: Encerramento do processo O sistema remove o arquivo semáforo PROCESSANDO.TXT. Na próxima consulta de status, a tela identifica que o processamento terminou, troca a imagem do campo Status da janela Importar XML’s, reabilita o botão Importar XML’s, desabilita o botão Cancelar importação e encerra a atualização automática das grades.

Passo 26: Conferência dos logs O usuário consulta a aba Sucesso e a aba Erros da janela Importar XML’s para verificar o que foi gravado e o que precisa de correção, e inspeciona as subpastas IMPORTADOS e NAOIMPORTADOS para confirmar a destinação física dos arquivos.

05. 5. DESCRIÇÃO DE CADA CAMPO DA TELA

5. Descrição de Cada Campo da Tela

5.1 Área de identificação da janela Importar XML’s

A janela Importar XML’s abre em aba única e trabalha exclusivamente com a filial logada. Não existem filtros, parâmetros, campos de data, seleção de modelo de documento ou seleção manual de arquivo. A origem dos arquivos é determinada pelo próprio sistema a partir da filial, e todo o comportamento da rotina decorre do conteúdo dos arquivos encontrados nessa pasta.

O campo Caminho da janela Importar XML’s é um campo de texto somente leitura. O sistema o preenche na abertura da tela com a pasta da filial devolvida pelo servidor, formada pela raiz fixa de importação, pelo identificador da filial e pelo CNPJ cadastrado na filial. O usuário usa esse valor para saber exatamente em que diretório deve depositar os arquivos XML; ele não digita nem altera esse conteúdo. Quando o servidor não consegue resolver a pasta, a tela exibe a mensagem “Erro ao Obter caminho e status do processamento para a filial {id}” acompanhada do motivo devolvido pelo servidor.

O campo Status da janela Importar XML’s é um campo de exibição acompanhado de imagem. O sistema apresenta a imagem de carregamento enquanto a importação está em andamento no servidor e a imagem de confirmação quando não há processamento ativo. O conteúdo desse campo é atualizado pela consulta periódica de status e governa a habilitação dos botões da barra de ferramentas.

5.2 Barra de ferramentas da janela Importar XML’s

O botão Importar XML’s da barra de ferramentas da janela Importar XML’s, de atalho Ctrl+I, dispara a execução da rotina para a filial logada. O sistema o mantém habilitado apenas enquanto não há importação em andamento. Ao ser acionado, o sistema exibe de imediato a mensagem “O processo foi iniciado com sucesso. Você pode sair e retornar a qualquer momento para esta tela, para acompanhar o status do processo.” e retoma a consulta periódica de status após cinco segundos. O processamento prossegue no servidor independentemente de o usuário permanecer na tela.

O botão Cancelar importação da barra de ferramentas da janela Importar XML’s, de atalho Ctrl+Alt+C, interrompe a execução em andamento. O sistema o mantém habilitado apenas enquanto há importação ativa. Ao ser acionado, o sistema remove o arquivo semáforo da pasta de controle da filial; o laço de processamento verifica a ausência desse arquivo antes de iniciar o próximo XML e encerra a execução nesse ponto. O arquivo que estiver sendo processado no momento do cancelamento é concluído normalmente. Em caso de sucesso, a tela exibe “O processo foi interrompido com sucesso.”; em caso de falha, exibe “Falha ao interromper o processo.{filial}” seguida do motivo devolvido pelo servidor.

O botão Excluir Histórico da barra de ferramentas da janela Importar XML’s, de atalho Delete, apaga os arquivos de log da filial. O sistema o mantém sempre habilitado. Ao ser acionado, o sistema abre a janela de confirmação Deseja excluir todo o histórico de importação? com os botões Ok e Cancelar. Confirmando, a tela exibe “Excluindo o histórico, por favor aguarde …” e solicita a exclusão ao servidor, que remove os arquivos SUCESSO.LOG e ERROS.LOG, retirando previamente o atributo de somente leitura. Em caso de sucesso a tela exibe “O histórico foi excluído com sucesso.”; em caso de falha exibe “Falha ao excluir histórico.” seguida do motivo.

A barra de ferramentas ainda traz os comandos padrão de vídeo e de fechamento de aba fornecidos pelo próprio ERP Atak.

5.3 Aba Sucesso da janela Importar XML’s

A aba Sucesso da janela Importar XML’s apresenta a grade de ocorrências bem-sucedidas da execução. A grade possui uma única coluna, Descrição do log, e trabalha com paginação de trinta registros por página. O sistema alimenta essa grade com as linhas do arquivo SUCESSO.LOG da pasta de controle da filial, lendo o arquivo em codificação UTF-8 e com compartilhamento de leitura e escrita, de modo que a consulta funciona mesmo enquanto o servidor ainda grava novas linhas. O sistema inverte a ordem das linhas, apresentando a ocorrência mais recente no topo.

Cada linha dessa grade segue o formato composto pelo caminho do arquivo que estava sendo processado, pela data e hora do servidor e pela mensagem de sucesso. São registradas nessa grade a inclusão de fornecedor, de cliente, de transportador, de produto, de lote da escrita, a adição do livro ao lote, a adição de cada item ao livro, a adição de cada tributo ao item, a adição das parcelas e a adição do documento XML, além do registro de eventos adicionados a um livro existente.

5.4 Aba Erros da janela Importar XML’s

A aba Erros da janela Importar XML’s apresenta a grade de ocorrências que impediram a gravação de um documento ou de parte dele. A grade possui a mesma estrutura de coluna única Descrição do log e paginação de trinta registros, e também apresenta as linhas em ordem inversa, da mais recente para a mais antiga.

Cada linha dessa grade segue o formato composto pelo nome do arquivo, pela data e hora com precisão de milissegundos e pela mensagem de erro. Toda linha gravada nessa grade também marca o arquivo correspondente como não importado, o que determina a cópia do XML para a subpasta NAOIMPORTADOS. São registradas nessa grade a ausência de arquivos na pasta, o padrão de arquivo não suportado, a chave de acesso já existente, a ausência de grade para o produto, a existência de mais de uma grade para a mesma referência, os erros de cálculo de ICMS, IPI, PIS e COFINS, a exclusão de um livro gravado parcialmente, as falhas de processamento de evento e a mensagem da exceção que interrompeu o arquivo.

Quando a chave de acesso do documento foi identificada, a linha de erro da exceção assume o formato “Não foi possível gravar nota com chave de acesso: {chave} – ‘{mensagem}'”. Quando a chave não foi identificada, o sistema grava apenas a mensagem da exceção.

5.5 Atualização automática da janela Importar XML’s

Ao abrir a janela Importar XML’s o sistema liga uma atualização automática que, a cada cinco segundos, reconsulta a pasta e o status da filial e recarrega as grades das abas Sucesso e Erros. Assim o usuário acompanha o avanço da importação em tempo quase real, sem precisar reabrir a tela. O sistema encerra a atualização automática quando o servidor informa que não há mais processamento em andamento.

5.6 Mensagens de negócio apresentadas pela janela Importar XML’s

As mensagens de negócio devolvidas pelo servidor seguem o padrão do ERP Atak, composto pela descrição do erro, pelo motivo e pela solução, apresentados em linhas separadas. As traduções correspondentes existem em inglês, com os rótulos “Reason” e “Solution”, e em espanhol, com os rótulos “Razón” e “Solución”. As mensagens gravadas nas grades de log podem conter entidades HTML para acentuação, já que são exibidas em grade HTML.

06. 6. UTILIZAÇÃO E CONSULTA DE REGISTROS

6. Utilização e Consulta de Registros

6.1 Consulta do andamento e do resultado da execução

A consulta dos resultados da rotina é feita dentro da própria janela Importar XML’s, pelas abas Sucesso e Erros. Não existem filtros de pesquisa nessas grades: o usuário navega pelas páginas de trinta linhas, com a ocorrência mais recente sempre no topo. O conteúdo apresentado corresponde somente à última execução, porque o sistema apaga os dois arquivos de log no início de cada importação.

Quando os arquivos de log estão vazios, as grades não apresentam linhas. Quando o sistema encontra dificuldade para ler um dos arquivos de log, a tela apresenta a ocorrência como aviso, sem interromper a navegação.

6.2 Consulta dos lançamentos gerados

Os documentos efetivamente escriturados pela rotina passam a existir como lançamentos normais do Livro de Registro de Entradas e Saídas, e são consultados nas rotinas próprias de consulta de livro da Escrita Fiscal. Todos os registros gerados pela importação — cabeçalho do livro, itens, tributos dos itens e parcelas — recebem a origem do lançamento “X”, correspondente a “Importado XML”, o que permite separar na consulta de livro o que veio da importação do que foi digitado ou gerado por outras rotinas.

O lançamento importado fica vinculado ao lote diário criado ou localizado pela rotina, identificado pelo prefixo “LE” para entradas ou “LS” para saídas seguido da data, o que também serve como critério de localização nas consultas de lote da escrita.

O XML original de cada documento fica armazenado vinculado ao livro, podendo ser recuperado a partir do próprio lançamento.

6.3 Consulta pelos arquivos no servidor

A separação física dos arquivos é um segundo recurso de conferência. Depois de cada execução, os XML que foram escriturados sem nenhum erro estão na subpasta IMPORTADOS da pasta da filial e os que apresentaram qualquer erro estão na subpasta NAOIMPORTADOS. A raiz da pasta da filial fica vazia dos arquivos já processados, restando nela apenas os arquivos que não chegaram a ser lidos por cancelamento da execução.

07. 7. PROCESSO DE EDIÇÃO

7. Processo de Edição

A rotina Importar Notas do XML não possui tela de edição de registros. Ela não mantém cadastro próprio: a janela Importar XML’s é uma tela de execução de processo, com campos somente leitura e grades de log.

Os lançamentos gerados pela rotina são editados pelas rotinas próprias do Livro de Registro de Entradas e Saídas, obedecendo às regras de edição daquele módulo — em especial a exigência de lote aberto e de período de apuração aberto para os tributos do documento. Quando o documento possui tributos cujo período de apuração está fechado, o sistema impede a alteração do livro com a mensagem “Documento ou um item do documento possui tributos com o período de apuração fechado.”

A própria rotina altera lançamentos já existentes em duas situações. A primeira é o fechamento do lançamento, logo após gravar os itens: o sistema regrava o livro para persistir o valor contábil acumulado e atualizar o valor e a quantidade realizados do lote. A segunda é o processamento de evento de cancelamento: ao encontrar um arquivo de evento com o tipo 110111 cuja chave de acesso corresponda a um livro já gravado, o sistema altera o status do livro para “C” de cancelado, o status da NF-e para “X” de cancelado e o status de todos os itens do livro para “C”, e anexa o XML do evento ao livro como documento XML adicional.

O histórico de execução é editável apenas por exclusão: o botão Excluir Histórico da janela Importar XML’s remove integralmente os dois arquivos de log, e o início de qualquer nova execução também os zera. Não há log de alterações por campo nem versionamento das linhas de log.

08. 8. ESTRUTURA TÉCNICA E COMPORTAMENTO DO SISTEMA

8. Estrutura Técnica e Comportamento do Sistema

8.1 Arquivos de controle no servidor

O sistema mantém três arquivos na subpasta NFE da pasta da filial. O arquivo PROCESSANDO.TXT funciona como semáforo: sua existência significa “importação em andamento”, e é ele que a tela consulta para montar o campo Status da janela Importar XML’s e habilitar os botões. O arquivo SUCESSO.LOG recebe uma linha por ocorrência bem-sucedida e o arquivo ERROS.LOG recebe uma linha por ocorrência de erro. Os dois arquivos de log são zerados no início de cada execução.

8.2 Leitura e interpretação do XML

A leitura dos arquivos é feita por componente de conversão que transforma o XML em conjunto de dados navegável, a partir do qual o sistema obtém cada campo pelo código do leiaute oficial da NF-e. A identificação da versão e do modelo é feita por busca de texto no conteúdo do arquivo. Os campos por item são lidos posicionando o cursor no grupo de detalhe correspondente ao índice do item.

As datas de emissão, de entrada/saída e de vencimento das duplicatas são convertidas para horário universal durante a leitura, e as datas gravadas no livro e no lote usam apenas a porção de data dessas informações.

A conversão de valores numéricos adapta o separador decimal à cultura do servidor; campos vazios ou ausentes de valor resultam em zero, sem gerar erro.

8.3 Classificação de entrada e de saída

A decisão entre entrada e saída é feita exclusivamente pela comparação dos documentos do emitente e do destinatário com o CNPJ da filial, como texto exato e sem máscara. O indicador de tipo de operação presente no XML não participa dessa decisão. As combinações reconhecidas pelo sistema são: emitente igual à filial e destinatário cliente, que gera saída de venda com emissão própria; emitente fornecedor e destinatário igual à filial, que gera entrada de compra com emissão de terceiros; emitente cliente e destinatário igual à filial, que gera entrada de devolução de venda; emitente igual à filial e destinatário fornecedor, que gera saída de devolução de compra.

8.4 Tratamento específico da NFC-e

Na NFC-e modelo 65, quando o consumidor informado no XML não possui cadastro no sistema pelo CPF ou CNPJ, e também quando a NFC-e não traz CPF ou CNPJ de destinatário, o sistema utiliza o cadastro geral apontado pelo parâmetro de identificador 255 como participante do lançamento, copiando desse cadastro o nome, a inscrição estadual, o apelido, o documento, o identificador e o endereço. Em consequência, a NFC-e emitida pela filial é sempre tratada como saída.

8.5 Cadastro automático de participantes

A busca de cadastro geral por CPF ou CNPJ é feita sem filtro de filial e sem restrição de tipo ou de situação do cadastro, trazendo junto o endereço de faturamento. O sistema mantém um cache dos cadastros localizados durante a execução, reduzindo as consultas repetidas.

Quando o cadastro já existe mas está sem endereço, ou com município, unidade federativa ou país em branco, o sistema completa o endereço em memória com os dados do XML, apenas para permitir a validação do livro; essa complementação não é gravada no cadastro.

Ao criar um cadastro novo, o sistema define o tipo de pessoa como jurídica quando o documento tem quatorze caracteres e como física nos demais casos, atribui a área de cadastro “0”, registra a origem como cadastro geral e grava o estado a partir da sigla da unidade federativa.

8.6 Cadastro automático de transportador

Quando a nota informa CNPJ ou CPF de transportador e não existe cadastro com esse documento, o sistema cria o cadastro usando o nome do transportador também como apelido, a inscrição estadual informada, o tipo de pessoa deduzido do tamanho do documento, o tipo de cadastro do parâmetro 68 e a área de cadastro “0”, sem endereço. O transportador criado não é vinculado ao livro: o sistema apenas garante a existência do cadastro. Da mesma forma, a modalidade do frete, o registro ANTT, a marca dos volumes e o endereço do transportador são lidos do XML e não são gravados no livro; do grupo de transporte o livro recebe apenas a placa do veículo, a unidade federativa do veículo, a quantidade de volumes, o peso líquido e o peso bruto.

8.7 Resolução de produtos em notas de saída

Em notas de saída o sistema separa o conteúdo do código do produto do XML em código e referência, testando como separadores, nessa ordem, o hífen, o sublinhado, o ponto e a barra vertical. Havendo referência, o sistema procura o produto pelo par código e referência; não havendo, adota a referência “0” e busca a primeira referência do produto.

Encontrando o produto, o sistema copia para o item da nota o código, a referência, o nome, a grade, as unidades primária e auxiliar, o NCM, o status, a seção, o grupo, o subgrupo, o item tributário, o tipo do item e a descrição para nota fiscal.

Não encontrando o produto, o sistema procura a grade pelo código de referência. Não existindo grade, o sistema grava no log de erros a linha “O produto {id}.{ref} não possui uma grade. Por favor cadastre uma grade.” e marca o item como problemático. Existindo mais de uma grade com a mesma referência, o sistema grava “Existe mais que uma grade com a referência {ref}. Por favor, cadastre o produto {id}.{ref} com a referência adequada.” e também marca o item como problemático. Existindo exatamente uma grade, o sistema cria o produto — ou apenas a nova referência, quando o código do produto já existe — com tipo de item “OI”, nome cortado em sessenta caracteres, NCM do XML, unidade resolvida, status ativo, data de cadastro corrente, seção, grupo e subgrupo padrão e o código EAN informado, registrando no log de sucesso a linha “Produto incluído com sucesso. Código: {id} – Nome: {nome} – NCM: {ncm}”.

8.8 Resolução de produtos em notas de entrada

Em notas de entrada o sistema separa o código do produto do fornecedor apenas pelo hífen, adotando a referência “0” quando ela não vem informada. Em seguida consulta a tabela de de/para entre o código do produto do participante e o código do produto do sistema, usando como participante o cadastro do emitente.

Havendo de/para, o sistema busca o produto do sistema e copia os dados cadastrais para o item da nota. Não havendo, o sistema cria um produto novo, cujo código é obtido a partir do último identificador do cadastro de itens, com grade “0”, tipo de item “OI” e os demais atributos definidos como na resolução de saída, e cria o vínculo de de/para entre o código do produto do fornecedor, o cadastro do emitente e o produto recém-criado. O log de sucesso recebe a mesma linha de inclusão de produto.

Na entrada o sistema não exige grade e não marca itens como problemáticos por ausência de grade.

8.9 Cadastro automático de unidade de medida

O sistema procura a unidade de medida pelo código informado no XML. Não encontrando, procura pela unidade completa e, achando, adota o identificador correspondente. Não achando, cria a unidade: quando o código do XML tem até quatro caracteres, o sistema usa esse mesmo conteúdo como identificador, nome e unidade completa; quando tem mais de quatro, o sistema tenta os quatro primeiros caracteres como identificador e, estando ocupado, monta um identificador com os dois primeiros caracteres seguidos de uma sequência de dois dígitos calculada sobre a quantidade de unidades já cadastradas que começam com esses dois caracteres.

8.10 Cadastro automático de unidade federativa

Ao precisar do estado de um participante, o sistema procura o cadastro de estado pelo identificador correspondente à sigla. Não existindo, consulta a tabela de municípios do IBGE mantida em arquivo de apoio e cria o estado a partir dela.

8.11 Regra de CFOP

Para cada item o sistema determina o CFOP do lançamento em três etapas. Primeiro procura uma exceção de CFOP cadastrada na rotina CFOP Exceções, buscando o registro que combine o CFOP do XML com o produto e a referência específicos e, não havendo, o registro genérico com o mesmo CFOP do XML e produto e referência em branco. Encontrando a exceção, o sistema adota o CFOP de destino cadastrado e encerra a regra.

Não havendo exceção, o sistema inverte o primeiro dígito do CFOP conforme o tipo do lote, mantendo os três dígitos restantes. Em lote de entrada, o dígito 5 vira 1, o 6 vira 2 e o 7 vira 3. Em lote de saída, o dígito 1 vira 5, o 2 vira 6 e o 3 vira 7. Demais dígitos permanecem iguais.

Por último, o sistema verifica se o CFOP resultante existe no cadastro de CFOP. Não existindo, procura o código na tabela de CFOP mantida em arquivo de apoio e cadastra o CFOP automaticamente com identificador, nome e nome completo. Não existindo também no arquivo, o sistema emite “Código CFOP não encontrado. / Favor adicionar nas exceções de CFOP o código destino para origem {cfop}, produto: {produto} {referência}.”

8.12 Classificação dos tributos a partir do XML

O sistema não recalcula os tributos a partir de base e alíquota: ele reaproveita os valores informados no XML e decide, conforme o CST, em quais colunas do livro esses valores entram — base de cálculo, valor do imposto, percentual do imposto, percentual de redução, isentas e outras. Cada imposto precisa existir no cadastro de tributos do sistema; não existindo, o sistema emite “Nenhum tributo cadastrado no sistema com o ID: {0}.”

A presença de cada grupo de imposto é avaliada no documento como um todo: havendo o grupo de ICMS, de IPI, de PIS ou de COFINS em qualquer item, o sistema tenta classificar aquele imposto em todos os itens da nota.

Para o ICMS o CST utilizado é a origem da mercadoria somada ao CST de três dígitos. O comportamento por CST é o seguinte:

  • CST 000: base, imposto e percentual conforme o XML; isentas e outras zeradas.
  • CST 010: base, imposto e percentual conforme o XML; outras igual à base de substituição menos a base; gera também o tributo de substituição tributária.
  • CST 020: base, imposto, percentual e percentual de redução conforme o XML; outras igual ao valor do item menos a base.
  • CST 030: base, imposto e percentual conforme o XML; outras igual à base de substituição menos a base; gera também o tributo de substituição tributária.
  • CST 040: todo o valor da base vai para a coluna de isentas.
  • CST 041: todo o valor da base vai para a coluna de outras.
  • CST 050: apenas a base é registrada.
  • CST 051: base, imposto e percentual conforme o XML; outras igual ao valor do item menos a base.
  • CST 060: todo o valor da base vai para a coluna de outras.
  • CST 070: base, imposto, percentual e percentual de redução conforme o XML; outras igual à base de substituição menos a base; gera também o tributo de substituição tributária.
  • CST 090: todo o valor da base vai para a coluna de outras.

Qualquer CST de ICMS fora dessa relação faz o sistema emitir “Não foi possível definir uma regra de cálculo de tributo ICMS e código CST: {0}.”

Nos CST 010 e 070 o sistema grava um segundo tributo, identificado como ICMST, com a base de substituição e o valor do imposto de substituição informados no XML, aplicando o mesmo percentual, percentual de redução, isentas e outras registrados no ICMS do item.

Para o IPI o sistema consulta primeiro a regra configurada no cadastro de situação tributária de IPI, quando todas as colunas de status estão preenchidas; não havendo regra configurada, aplica a classificação por CST de dois dígitos. Os CST 00 e 50 registram base, imposto e percentual conforme o XML. O CST 01 registra a base e registra imposto e percentual apenas quando maiores que zero. Os CST 05, 51 e 55 registram apenas a base. Os CST 02 e 52 levam a base para a coluna de isentas. Os CST 03, 04, 49, 53 e 99 levam a base para a coluna de outras. O CST 54 registra em outras o valor do item menos a base. Qualquer outro CST faz o sistema emitir a mensagem de regra de cálculo de IPI não definida, orientando a inclusão de exceção para o código e o item.

Para o PIS e para a COFINS o sistema também consulta primeiro a regra configurada no cadastro de situação tributária e, não havendo, aplica a classificação por CST. Os CST 01, 02, 03, 04, 50, 51, 52, 53, 54, 55 e 56 registram base, imposto e percentual conforme o XML. O CST 05 registra base, imposto e percentual e ainda leva a base para a coluna de outras. O CST 06 registra como base a base do XML quando maior que zero e, caso contrário, o valor do item. O CST 07 e o CST 71 levam esse mesmo critério para a coluna de isentas. Os CST 08, 49, 70, 74, 75, 98 e 99 levam esse critério para a coluna de outras. Os CST 09, 72 e 73 registram apenas a base. Os CST de 60 a 67 registram base, imposto, percentual e percentual de redução conforme o XML e lançam em outras o valor do item menos a base. Qualquer outro CST faz o sistema emitir a mensagem de regra de cálculo de PIS e COFINS não definida, orientando a inclusão de exceção para o código e o item.

8.13 Exceções de CST

Antes de classificar IPI, PIS e COFINS, o sistema procura uma exceção de CST cadastrada para o imposto, combinando o CST do XML com o produto e a referência específicos e, não havendo, o CST do XML com produto e referência em branco. Encontrando, o sistema substitui o CST do XML pelo CST de destino da exceção, tanto no item gravado quanto na classificação dos valores. A exceção cadastrada para PIS e COFINS vale simultaneamente para os dois tributos.

8.14 Composição do valor contábil

O valor contábil de cada item é o valor do produto informado no XML menos o desconto do item. Frete, seguro e outras despesas acessórias são gravados nos campos próprios do item, mas não compõem o valor contábil. O valor contábil do livro é o somatório dos valores contábeis dos itens, persistido na regravação final do lançamento.

8.15 Campos do XML lidos e não escriturados

O sistema lê do XML e não grava no livro a natureza da operação, a chave de acesso de documento referenciado, o local de destino da operação, a unidade federativa de origem do processo, o município do fato gerador, o valor de outras despesas acessórias do item, a modalidade e os dados do frete, os dados completos do transportador, o grupo de ISSQN e os campos de fundo de combate à pobreza, diferencial de alíquota, diferimento, desoneração, ICMS retido anteriormente e código de benefício fiscal.

8.16 Transações e compensação

Cada gravação da rotina — livro, item, tributo, parcelas, XML e cadastros auxiliares — é confirmada individualmente no banco. Quando a gravação dos itens ou das parcelas falha, o sistema exclui o livro já criado, junto com seus itens, atualiza o lote e registra no log de erros a linha “Livro com chave fato: {id} excluído do lote: {lote} na filial: {filial}” seguida da mensagem original do erro. Os cadastros criados antes da falha — fornecedor, cliente, transportador, produto, referência, unidade, CFOP, estado e lote — permanecem gravados.

8.17 Entidades e tabelas envolvidas

A rotina movimenta as entidades de Filial, Cadastro Geral com endereço de faturamento, Item, Referência de Item, Grade de Produto, de/para de item por cadastro geral, Seção, Grupo e Subgrupo de Produto, Unidade na tabela TBUNIDADE, CFOP, Exceção de CFOP, Exceção de CST para IPI, Exceção de CST para PIS e COFINS, Situação Tributária de ICMS, IPI, PIS e COFINS, Imposto, Período de Apuração de Imposto, Lote da Escrita, cabeçalho e itens do Livro de Registro de Entradas e Saídas, tributos dos itens do livro, parcelas do documento fiscal, a tabela TBLIVROREGESXMLDOC de armazenamento do XML, a tabela TBSEQUENCIA de sequências de numeração e os cadastros de Estado e Município. A rotina ainda consome os arquivos de apoio de tabela de CFOP, de tabela de municípios do IBGE e de tabela de modelo fiscal.

8.18 Indicadores e status gravados

Todo registro produzido pela rotina recebe a origem do lançamento “X”, correspondente a “Importado XML”. O livro e os itens nascem com status “F” de faturado e o status da NF-e nasce como “A” de autorizado. O tipo de emissão da nota fiscal é gravado como “P” quando o emitente é a própria filial e como “T” quando o emitente é terceiro. A finalidade de emissão do XML é convertida em tipo de documento complementar, com os valores “Normal”, “Complementar”, “Ajuste” e “Devolução”; finalidade não reconhecida deixa o campo em branco. O tipo do lote assume “E” para entrada e “S” para saída, e o status do lote e do período de apuração usa “A” para aberto e “F” para fechado. Os produtos criados nascem com status ativo e tipo de item “OI”.

8.19 Data de registro do lançamento

A data de registro do livro nasce igual à data de emissão e é recalculada na validação. Em lote de entrada, o sistema adota a data de entrada/saída. Em lote de saída, o sistema consulta a configuração de tipo de data de referência do lote de saída da filial: quando a configuração indica movimentação, o sistema adota a data de entrada/saída; nos demais casos adota a data de emissão.

8.20 Processamento de eventos

Ao identificar um arquivo de evento, o sistema procura o livro pela chave de acesso informada no evento, em qualquer lote e qualquer tipo. Não encontrando o livro, o sistema guarda o evento em uma lista de pendências e o reprocessa ao final do laço de arquivos, o que permite importar nota e evento na mesma execução, já que a ordenação por tamanho coloca os eventos depois das notas. Encontrando o livro, o sistema carrega os itens e, sendo o evento do tipo 110111, aplica o cancelamento do lançamento e anexa o XML do evento ao livro. Eventos de outros tipos, como a carta de correção, não alteram o lançamento e não têm o XML anexado, mas o sistema registra no log de sucesso a linha “{arquivo}: Evento Adicionado com sucesso no livro com chave fato: {id}”. Falhas no processamento geram a linha de erro “Não foi possível processar evento da nota com chave de acesso {chave} – ‘{msg}'”.

09. 9. REGRAS DE NEGÓCIO E RESTRIÇÕES

9. Regras de Negócio e Restrições

Regra 1 — Escopo de filial: o sistema executa a importação exclusivamente para a filial logada, usando a pasta nomeada com o identificador e o CNPJ dessa filial. O usuário que não tenha filial logada atribuída recebe a mensagem “Filial logada não atribuída ao usuário.” e nenhum arquivo é lido.

Regra 2 — Origem fixa dos arquivos: o sistema lê os XML somente da raiz da pasta da filial, dentro da estrutura fixa de importação do servidor. O usuário não informa caminho, não seleciona arquivos e não navega por subpastas; arquivos depositados em subpastas da filial não são processados.

Regra 3 — Extensão aceita: o sistema processa somente arquivos cuja extensão esteja grafada integralmente em letras minúsculas ou integralmente em letras maiúsculas. Arquivos com grafia mista de extensão permanecem na pasta sem processamento.

Regra 4 — Ordem de processamento: o sistema ordena os arquivos por tamanho decrescente antes de processá-los, de modo que as notas fiscais completas sejam escrituradas antes dos arquivos de evento, que são menores. Com isso, um evento de cancelamento recebido junto com a sua nota tende a encontrar o lançamento já gravado.

Regra 5 — Pasta sem arquivos: quando a pasta da filial não contém nenhum arquivo elegível, o sistema registra no log de erros a linha “Nenhum arquivo foi encontrado na pasta {pasta}” e encerra a execução sem gravar lançamentos.

Regra 6 — Modelos e versões suportados: o sistema escritura apenas NF-e modelo 55 e NFC-e modelo 65, nas versões de leiaute 2.00, 3.10 e 4.00, além de eventos de NF-e na versão 1.00 e arquivos de cancelamento de NF-e no formato antigo. Arquivos de CT-e, NFS-e, MDF-e, CF-e SAT e NF-e sem protocolo de autorização recebem no log de erros a linha “{arquivo} – Não foi possível importar o arquivo. Padrão não suportado.” e são copiados para a subpasta NAOIMPORTADOS.

Regra 7 — Vínculo do documento com a filial: o sistema só escritura o documento quando o CNPJ da filial aparece como emitente ou como destinatário, mas não nos dois ao mesmo tempo. Notas em que a filial é simultaneamente emitente e destinatária, e notas entre terceiros, recebem a mensagem “Nota não pertencente a essa filial. / A nota fiscal não está vinculada à filial informada. / Verifique a filial da nota fiscal e tente novamente.”

Regra 8 — Indicador de tipo de operação ignorado: o sistema decide entre entrada e saída exclusivamente pela comparação dos CNPJ do emitente e do destinatário com o CNPJ da filial. O indicador de tipo de operação informado no XML não influencia essa classificação.

Regra 9 — Comparação de documentos sem máscara: o sistema compara os documentos do emitente e do destinatário com o CNPJ da filial como texto exato, sem aplicar máscara nem normalizar pontuação. O CNPJ cadastrado na filial precisa estar gravado na mesma forma em que vem no XML para que a classificação funcione.

Regra 10 — Unicidade por chave de acesso, filial e tipo de lote: o sistema impede a importação de um documento cuja chave de acesso já exista em um livro da mesma filial e do mesmo tipo de lote, registrando no log de erros a linha “{chave} – Chave de acesso já existente.” e copiando o arquivo para a subpasta NAOIMPORTADOS. Como a verificação considera o tipo de lote e a filial, a mesma nota de transferência pode ser escriturada como saída na filial de origem e como entrada na filial de destino.

Regra 11 — Participante padrão da NFC-e: quando a NFC-e não identifica o consumidor, ou identifica um documento sem cadastro no sistema, o sistema adota como participante o cadastro geral indicado pelo parâmetro de identificador 255, copiando dele nome, apelido, inscrição estadual, documento, identificador e endereço. Em consequência, a NFC-e emitida pela filial é sempre escriturada como saída.

Regra 12 — Criação automática de participantes: o sistema cria o cadastro geral do emitente e do destinatário sempre que o documento não existir no cadastro, atribuindo ao fornecedor o tipo de cadastro do parâmetro 22 e ao cliente o tipo de cadastro do parâmetro 15. Como a rotina trata emitente e destinatário em qualquer sentido da operação, o CNPJ da própria filial pode vir a ser criado como cliente em uma nota de entrada ou como fornecedor em uma nota de saída, quando ainda não existir no cadastro geral.

Regra 13 — Complementação de endereço em memória: quando o participante já cadastrado está sem endereço, ou com município, unidade federativa ou país em branco, o sistema completa esses dados com o conteúdo do XML apenas para permitir a validação do lançamento. A complementação não altera o cadastro geral do participante.

Regra 14 — Endereço obrigatório no lançamento: o sistema exige unidade federativa, país, município e endereço preenchidos no participante do livro. Faltando qualquer um deles, o sistema emite “UF, País, Município ou Endereço não foram informados.” e o documento não é escriturado.

Regra 15 — Criação automática de transportador sem vínculo: quando a nota informa documento de transportador inexistente no cadastro, o sistema cria o cadastro com o tipo definido pelo parâmetro 68, mas não vincula o transportador ao lançamento. Do grupo de transporte, o livro recebe somente placa do veículo, unidade federativa do veículo, quantidade de volumes, peso líquido e peso bruto.

Regra 16 — Exigência de grade em notas de saída: em notas de saída, o sistema só cria um produto inexistente quando encontra exatamente uma grade para o código de referência informado. Sem grade, o sistema registra “O produto {id}.{ref} não possui uma grade. Por favor cadastre uma grade.”; com mais de uma grade, registra “Existe mais que uma grade com a referência {ref}. Por favor, cadastre o produto {id}.{ref} com a referência adequada.” Em ambos os casos o item é marcado como problemático.

Regra 17 — Bloqueio da nota por problema em item: encontrado qualquer item problemático na resolução de produtos, o sistema interrompe a importação do documento com a mensagem “É necessário corrigir problemas nos itens para importar a nota.” Os cadastros criados antes da interrupção permanecem gravados.

Regra 18 — De/para de produto em notas de entrada: em notas de entrada, o sistema identifica o produto do sistema a partir da tabela de de/para entre o código do produto do fornecedor e o produto cadastrado, usando o emitente como participante. Não havendo de/para, o sistema cria o produto e registra o vínculo de de/para, de modo que as importações seguintes do mesmo fornecedor reutilizem o produto. Em entrada o sistema não exige grade.

Regra 19 — Nome do produto limitado a sessenta caracteres: ao criar um produto a partir do XML, o sistema corta a descrição informada na nota em sessenta caracteres para gravá-la como nome do item.

Regra 20 — Item tributário e classificação padrão: todo produto criado pela rotina recebe como item tributário o produto de código 999999, nome “Importação XML – Item tributário”, e recebe a seção, o grupo e o subgrupo de código 9999, nome “Importação XML”. O sistema cria esses cadastros na primeira execução em que precisar deles.

Regra 21 — Criação automática de unidade de medida: não existindo a unidade informada no XML, o sistema a cria. Códigos de até quatro caracteres são usados integralmente como identificador; códigos maiores usam os quatro primeiros caracteres e, estando esse identificador ocupado, o sistema monta um identificador com os dois primeiros caracteres seguidos de dois dígitos sequenciais.

Regra 22 — Prioridade da exceção de CFOP: havendo exceção cadastrada na rotina CFOP Exceções para o CFOP do XML, o sistema adota o CFOP de destino da exceção e não aplica a inversão de dígito. A exceção específica, que combina CFOP, produto e referência, prevalece sobre a exceção genérica, cadastrada apenas com o CFOP do XML.

Regra 23 — Inversão do primeiro dígito do CFOP: não havendo exceção, o sistema inverte o primeiro dígito do CFOP do XML conforme o tipo do lote — em entrada, 5 vira 1, 6 vira 2 e 7 vira 3; em saída, 1 vira 5, 2 vira 6 e 3 vira 7 — mantendo inalterados os três dígitos restantes.

Regra 24 — Cadastro automático de CFOP: não existindo o CFOP resultante no cadastro, o sistema o inclui automaticamente a partir da tabela de CFOP mantida em arquivo de apoio. Não existindo também nessa tabela, o sistema emite “Código CFOP não encontrado. / Favor adicionar nas exceções de CFOP o código destino para origem {cfop}, produto: {produto} {referência}.” e o documento não é escriturado.

Regra 25 — Composição do CST de ICMS: o sistema grava como situação tributária do ICMS do item a origem da mercadoria concatenada ao CST informado no XML. Quando a origem ou o CST não vêm preenchidos, o sistema grava a situação tributária “000”.

Regra 26 — Reaproveitamento dos valores do XML: o sistema não recalcula os tributos a partir de base e alíquota. Ele usa os valores informados no XML e, conforme o CST de cada imposto, decide se eles entram nas colunas de base, imposto, percentual, percentual de redução, isentas ou outras do livro.

Regra 27 — CST de ICMS sem regra: quando a situação tributária de ICMS do item não corresponde a nenhuma das regras previstas, o sistema emite “Não foi possível definir uma regra de cálculo de tributo ICMS e código CST: {0}.” e o documento não é escriturado.

Regra 28 — Geração do tributo de substituição tributária: nas situações tributárias de ICMS 010 e 070, o sistema grava um segundo tributo ICMST com a base e o valor de substituição informados no XML, replicando o percentual, o percentual de redução e as colunas de isentas e outras registrados no ICMS do item.

Regra 29 — CST de IPI, PIS ou COFINS sem regra: quando a situação tributária de IPI, de PIS ou de COFINS não corresponde a nenhuma regra prevista nem a uma regra configurada no cadastro de situação tributária, o sistema emite a mensagem de regra de cálculo não definida para o tributo e orienta a inclusão de uma exceção para aquele código e aquele item.

Regra 30 — Exceções de CST para IPI, PIS e COFINS: havendo exceção cadastrada para o CST do XML, o sistema substitui a situação tributária pela situação de destino da exceção, tanto no item gravado quanto na classificação dos valores. A exceção específica, combinando CST, produto e referência, prevalece sobre a genérica, e a exceção cadastrada para PIS e COFINS vale para os dois tributos.

Regra 31 — Erro de tributo bloqueia o documento: erro na classificação de ICMS, de PIS ou de COFINS faz o sistema emitir “É necessário arrumar os tributos para importar a nota. / Existem problemas nos tributos associados à nota fiscal. / Corrija os tributos para poder importar a nota.” e excluir o livro já criado. Erro na classificação de IPI é registrado no log de erros e o documento segue a escrituração sem o IPI daquele item.

Regra 32 — Período de apuração aberto por tributo: para gravar cada tributo de cada item, o sistema exige um período de apuração do imposto existente e aberto para a filial na data de entrada/saída do documento. Não havendo, o sistema emite “Não foi possível concluir a operação. / Não existe período de apuração aberto para o tributo {0} na filial {1} para a data {2}, lote {3}, livro {4}, item {5}.” e o documento não é escriturado.

Regra 33 — Imposto cadastrado no sistema: cada tributo escriturado precisa existir no cadastro de impostos do sistema. Não existindo, o sistema emite “Nenhum tributo cadastrado no sistema com o ID: {0}.”

Regra 34 — Presença do imposto avaliada por documento: o sistema avalia a existência dos grupos de ICMS, IPI, PIS e COFINS no documento inteiro, e não item a item. Havendo o grupo em qualquer item, o sistema classifica aquele imposto para todos os itens da nota.

Regra 35 — Lote diário automático: não existindo lote da filial, do tipo correspondente, cujo intervalo contenha a data de referência do documento, o sistema cria um lote diário com nome e identificador formados pelo prefixo “LE” ou “LS” seguido da data, com data inicial igual à data final e status aberto.

Regra 36 — Lote precisa estar aberto: o sistema só grava o lançamento em lote aberto. Lote inexistente gera a mensagem de lote não existente para o documento; lote fechado gera “Este lote fiscal não está aberto!”; data fora do intervalo do lote gera “Lançamento fora do período aceito pelo lote.” Em qualquer dos casos o documento não é escriturado.

Regra 37 — Data de referência do lote: o sistema usa a data de entrada/saída como referência de lote nas notas de entrada e a data de emissão nas notas de saída. Quando o XML não informa a data de entrada/saída, o sistema adota a data de emissão.

Regra 38 — Recálculo da data de registro: o sistema regrava a data de registro do lançamento durante a validação. Em lote de entrada adota a data de entrada/saída; em lote de saída adota a data de entrada/saída quando a configuração de tipo de data de referência do lote de saída da filial indicar movimentação, e a data de emissão nos demais casos.

Regra 39 — Sequência de numeração obrigatória: o sistema obtém o código do documento do livro a partir da sequência ativa cadastrada para a filial e para o modelo fiscal da nota. Sem sequência ativa para o modelo, o lançamento não é gerado.

Regra 40 — Dispensa de validação de chave na importação: nos lançamentos gerados por esta rotina o sistema dispensa a validação de chave de acesso aplicada na digitação manual do livro, porque a chave vem do próprio documento autorizado.

Regra 41 — Truncamento de participante e cidade no livro: ao gravar o lançamento, o sistema corta o nome do participante em cinquenta caracteres e o nome da cidade em vinte e cinco caracteres.

Regra 42 — Composição do valor contábil do item: o sistema calcula o valor contábil de cada item como o valor do produto menos o desconto. Frete, seguro e demais despesas acessórias não entram nessa composição, embora sejam gravados nos campos próprios do item.

Regra 43 — Valor unitário recalculado: havendo quantidade maior que zero no item, o sistema grava como valor unitário o valor do item dividido pela quantidade, arredondado em quatro casas decimais. Não havendo quantidade, o sistema grava o valor unitário informado no XML, também arredondado.

Regra 44 — Numeração do título das parcelas: o sistema grava o número do título de cada parcela montado pelo código do documento, pela série e pelo número da nota, substituindo o número de duplicata informado no XML. O vencimento ausente é substituído pela data de emissão do documento.

Regra 45 — Condição de criação da parcela: nas versões de leiaute 3.10 e 4.00 e na NFC-e, o sistema só cria a parcela quando o número da duplicata vem preenchido. Na versão 2.00 o sistema cria a parcela mesmo sem o número da duplicata.

Regra 46 — Parcelas sem integração financeira: as parcelas geradas ficam registradas apenas no Livro de Registro de Entradas e Saídas. O sistema não gera títulos em Contas a Pagar nem em Contas a Receber a partir desta rotina.

Regra 47 — Armazenamento do XML: o sistema grava o conteúdo do XML junto ao lançamento, com o hash MD5 do conteúdo, usando o texto já sem as quebras de linha. É esse conteúdo que o sistema devolve nas consultas de XML do livro.

Regra 48 — Compensação por exclusão do livro: quando a gravação de itens ou de parcelas falha, o sistema exclui o livro e seus itens, atualiza o lote e registra o erro no log. Os cadastros de participantes, produtos, unidades, CFOP, estados e lotes criados antes da falha permanecem gravados.

Regra 49 — Exclusão do livro exige lote e períodos adequados: a exclusão compensatória do livro exige lote apto a ser atualizado, período de apuração sem impostos fechados e exercício social aberto.

Regra 50 — Alteração do livro com período fechado: o sistema impede a regravação do lançamento quando o documento ou um de seus itens possui tributos com período de apuração fechado, emitindo “Documento ou um item do documento possui tributos com o período de apuração fechado.”

Regra 51 — Sem movimentação de estoque e sem comunicação com a SEFAZ: a rotina escritura o documento no livro fiscal, sem gerar movimentação de estoque, sem emitir documento fiscal e sem qualquer comunicação com a SEFAZ.

Regra 52 — Evento de cancelamento: o evento de tipo 110111 cuja chave de acesso corresponda a um lançamento existente faz o sistema alterar o status do livro para cancelado, o status da NF-e para cancelado e o status de todos os itens para cancelado, e anexar o XML do evento ao lançamento.

Regra 53 — Eventos de outros tipos: eventos diferentes do cancelamento, como a carta de correção, não alteram o lançamento nem têm o XML anexado. Mesmo assim o sistema registra no log de sucesso a linha “{arquivo}: Evento Adicionado com sucesso no livro com chave fato: {id}”.

Regra 54 — Evento sem nota correspondente: quando o evento chega antes do lançamento da nota, o sistema guarda o arquivo em uma lista de pendências e o reprocessa depois de percorrer todos os arquivos da pasta, permitindo que nota e evento sejam tratados na mesma execução.

Regra 55 — Cancelamento da execução entre arquivos: o botão Cancelar importação da janela Importar XML’s remove o arquivo semáforo, e o sistema verifica a ausência desse arquivo antes de iniciar cada XML. O arquivo em processamento no momento do cancelamento é concluído, e os arquivos ainda não lidos permanecem na raiz da pasta da filial para a próxima execução.

Regra 56 — Histórico restrito à última execução: o sistema apaga os arquivos SUCESSO.LOG e ERROS.LOG no início de cada importação. As abas Sucesso e Erros da janela Importar XML’s apresentam sempre apenas as ocorrências da execução mais recente.

Regra 57 — Exclusão do histórico sob confirmação: o botão Excluir Histórico da janela Importar XML’s só executa a limpeza depois da confirmação na janela Deseja excluir todo o histórico de importação? e remove integralmente os dois arquivos de log da filial, retirando antes o atributo de somente leitura.

Regra 58 — Destinação do arquivo conforme o resultado: o sistema copia para a subpasta IMPORTADOS o XML que não gerou nenhuma linha no log de erros e para a subpasta NAOIMPORTADOS o XML que gerou qualquer erro, inclusive o de chave de acesso já existente e o de padrão não suportado. Em seguida o sistema remove o arquivo original da raiz da pasta da filial. Documentos com sucesso parcial, em que cadastros foram criados antes de uma falha, são classificados como não importados.

Regra 59 — Nome de arquivo repetido na pasta de destino: quando já existe na subpasta de destino um arquivo com o mesmo nome, o sistema mantém a cópia anterior e remove o arquivo da raiz da pasta da filial.

Regra 60 — Execução independente da tela: a importação prossegue no servidor depois de acionada, mesmo que o usuário feche a aba ou saia da rotina. O usuário retorna à janela Importar XML’s a qualquer momento para acompanhar o status e consultar os logs da execução em andamento.

NA PÁGINA

  • 1. Visão Geral da Rotina
  • 2. Vídeo Tutorial
  • 3. Pré-requisitos e Contexto de Acesso
  • 4. Processo de Criação / Emissão — Passo a Passo
  • 5. Descrição de Cada Campo da Tela
  • 6. Utilização e Consulta de Registros
  • 7. Processo de Edição
  • 8. Estrutura Técnica e Comportamento do Sistema
  • 9. Regras de Negócio e Restrições
NEWSLETTER

Conteúdo para quem vive a indústria de alimentos

Receba conteúdos sobre tecnologia, gestão e inovação para a indústria de alimentos.

Acompanhe novidades, tendências e soluções para melhorar a eficiência da sua operação.

Produtos

  • ERP
  • Frigosoft
  • Força de Vendas
  • Coleta de Resíduos
  • Venda Ambulante
  • Coleta de Leite
  • BI Atak
  • EasyPAC
  • Delivery B2B

Soluções

  • Bovinos
  • Suínos
  • Aves
  • Ovinos
  • Pescados
  • Laticínios
  • Curtumes
  • Charqueadas
  • Distribuidores Entrepostos
  • Indústria de Alimentos em Geral

Conteúdos

  • Blog
  • E-books (em breve)
  • Podcasts (em breve)
  • Webinars (em breve)
  • Depoimentos

Ajuda

  • Dúvidas
  • Documentação (em breve)
  • Manuais (em breve)
  • Avisos (em breve)
  • Novidades (em breve)

Empresa

  • Sobre
  • Carreiras
  • Privacidade
  • Contato
  • llms.txt
  • llms-full.txt

Social

  • LinkedIn
  • Instagram
  • YouTube

© 2026 Atak Sistemas Todos os direitos reservados.

Av. Nildo Ribeiro da Rocha, 5766 Parque Tecnológico, Maringá/PR. CNPJ: 73.500.290/0001-06