Três formas de carregar o lote

No topo da tela, três cartões permitem alimentar o lote, combináveis livremente:

• Enviar XMLs — arraste arquivos “.xml” para a área indicada, ou clique para selecionar. Limite de 500 arquivos por carregamento; acima disso o carregamento é recusado.
• Chaves de Acesso — campo de texto para digitar uma ou mais chaves, separadas por vírgula, com um botão “Consultar”.
• Monitoramento — atalho que leva à tela de Monitoramento de NFS-e Recebidas, de onde é possível selecionar notas já capturadas e enviá-las para este lote.

Uma barra de progresso aparece durante o carregamento, mostrando quantos documentos já foram lidos e o tempo restante estimado.

Indicadores (KPIs) e filtro rápido

Acima da listagem aparecem contadores clicáveis — Total, Sucesso, Falha, Pendentes, Já Existente e Duplicadas — que funcionam como filtro rápido da listagem: clicar em um deles mostra só as linhas naquela situação; clicar de novo remove o filtro.

Listagem do lote

Cada linha mostra: um indicador de status (ícone), a chave de acesso (resumida, com indicação se veio de arquivo ou de consulta por chave), se já está “Importado?” no ERP, o documento interno já gerado (quando existir), se esse documento já está contabilmente atualizado, o documento de origem vinculado (quando aplicável), Filial, Participante, TMV, Produto + Referência, número da NFS-e, valor dos serviços e valor líquido.

Campos ainda não preenchidos (Filial, Participante, TMV, Produto/Referência, Documento de Origem) aparecem com o texto “Preencher” e podem ser clicados para edição direta na própria linha, sem abrir tela separada.

Seleção de linhas

A caixa de seleção de uma linha fica desabilitada quando o documento já está importado e atualizado, ou quando a mesma chave de acesso aparece duplicada dentro do lote atual.

Ações sobre o lote (botões da listagem)

• Esvaziar lote — remove todas as notas carregadas na tela (sem afetar documentos já importados no ERP).
• Limpar documentos já importados no ERP — remove da tela apenas as notas já identificadas como já existentes.
• Remover selecionados — remove da tela apenas as linhas marcadas.
• Edição em lote — define de uma vez Participante, Filial e Produto padrão para todas as linhas selecionadas.
• Processar Importação — envia o lote preenchido para o sistema.
• Sincronizar — reconsulta o servidor para atualizar o status (importado/atualizado) das notas já carregadas; é acionado automaticamente quando o usuário volta a focar a aba do navegador depois de 5 minutos ou mais parado nesta tela, e também pode ser acionado manualmente.

Ações por linha (menu de contexto)

• Editar Campos — ajusta manualmente Filial, Participante, TMV, Produto ou Documento de Origem daquela nota específica.
• Remover da Fila — remove apenas aquela linha do lote.

Origens do XML aceitas

Um XML pode ser carregado por três caminhos: envio direto do arquivo, consulta por chave de acesso, ou vindo da tela de Monitoramento. Quando a origem é uma chave de acesso, o sistema primeiro verifica se aquela nota já foi capturada pelo monitoramento contínuo (evitando uma consulta externa desnecessária); só se não encontrar é que consulta diretamente o provedor nacional da NFS-e.

Campos obrigatórios para processar uma linha

Toda linha do lote precisa ter, antes de ser processada: uma Chave de Acesso identificada (ou o arquivo XML correspondente), Filial, Tipo de Movimento, Produto e Referência.

O arquivo precisa ser um XML válido de NFS-e

Sugestões automáticas

Para cada nota carregada que ainda não exista no ERP, o sistema tenta preencher automaticamente:

• Filial: a filial cujo CNPJ corresponda ao CNPJ do tomador do serviço (destinatário) na nota.
• Participante: o cadastro cujo CNPJ corresponda ao CNPJ do emitente da nota.
• Tipo de Movimento: o último TMV de entrada usado para NFS-e pelo mesmo participante sugerido.
• Produto + Referência: primeiro tenta localizar um produto já configurado para o código de tributação nacional do serviço informado na nota; se não encontrar, sugere o último produto usado em uma entrada anterior de NFS-e para o mesmo participante.

Qualquer campo sugerido pode ser ajustado manualmente pelo usuário antes de processar.

Documento de origem

Dependendo da configuração do Tipo de Movimento escolhido, pode ser exigido (ou apenas permitido) vincular a NFS-e importada a um documento de origem já existente no ERP — mesma regra usada na rotina de Venda de Mercado Interno.

Notas já importadas não são duplicadas

Se a chave de acesso já corresponder a um documento existente no ERP:

• Se esse documento já estiver totalmente atualizado, a nota é sinalizada como “Já existe no ERP” e fica bloqueada para nova importação.
• Se ainda não estiver atualizado, o sistema permite reprocessar a nota para completar/atualizar o cabeçalho do documento já criado, em vez de criar um documento duplicado.

Notas duplicadas dentro do próprio lote

Se a mesma chave de acesso aparecer mais de uma vez no lote carregado na tela, todas as ocorrências duplicadas ficam bloqueadas para importação até que as repetidas sejam removidas.

Processamento em lote é isolado por nota

Ao processar a importação, cada nota é tratada de forma independente — uma falha em uma não impede o processamento das demais selecionadas.

Uma linha do lote não sai do status “Carregando…” / campos ficam em branco

Mensagem exibida: Nenhuma — os campos permanecem vazios com o texto “Preencher”.

O que fazer: o sistema não conseguiu calcular uma sugestão para aquele campo (por exemplo, nenhuma filial com aquele CNPJ, ou nenhum participante cadastrado com o CNPJ do emitente); preencha manualmente antes de processar.

A caixa de seleção de uma linha está desabilitada

Mensagem exibida: Nenhuma — a caixa aparece desabilitada, sem tooltip de erro.

O que fazer: a nota já foi importada e está atualizada, ou a chave de acesso está duplicada dentro do próprio lote — remova a duplicidade ou use “Limpar documentos já importados” para retirá-la da tela.

Caso 1 — Importar um lote de notas recebidas por e-mail

O usuário recebeu vários arquivos XML de fornecedores por e-mail. Ele arrasta todos os arquivos para a área “Enviar XMLs”. O sistema lê cada um, busca as sugestões de Filial/Participante/TMV/Produto automaticamente e monta a listagem. O usuário confere os poucos campos que ficaram como “Preencher”, marca as linhas corretas e clica em “Processar Importação”.

Caso 2 — Importar uma nota isolada pela chave de acesso

Um fornecedor informou por telefone a chave de acesso de uma NFS-e que ainda não chegou por e-mail. O usuário cola a chave no campo “Chaves de Acesso” e clica em “Consultar” — o sistema busca a nota (primeiro no que já foi capturado pelo monitoramento, depois diretamente no governo, se necessário), preenche a linha e aplica as sugestões automáticas.