Limites e perguntas frequentes

Na busca de novos arquivos, um arquivo cujo nome já está registrado é descartado e não vira um novo registro. Para que o arquivo corrigido seja lido, envie-o com outro nome ou, se o registro existente estiver com status Erro, use Excluir Registro na aba Arquivos processados e faça uma nova busca de arquivos.

• Não aparecem na lista: arquivos que não são .xml nem .txt, como .zip e .pdf, e arquivos vazios.
• Entram em Outros documentos, com status Erro: inutilização, carta de correção, retorno da SEFAZ, arquivo com erro de codificação e conteúdo não reconhecido.
• EFD Contribuições: não é importada, mas segue para a auditoria no Sankhya Tax.

Antes de ir para Outros documentos, todo XML não reconhecido passa pela conversão de NFS-e por IA, porque pode ser uma NFS-e num formato municipal.

Não. O XML completa a nota que veio pela EFD, com IPI e substituição tributária, e o financeiro não é gerado de novo. Se a quantidade de itens do XML for diferente da nota da EFD, o XML não é aplicado e o log registra a divergência de itens.

Depende do volume, do tipo dos arquivos e da memória do ambiente. A tela do Deploy Agent mostra o tempo restante estimado, ao lado da barra de progresso, e atualiza a estimativa durante o processamento.

A nota já existe e nada novo foi gerado. Isso acontece quando a mesma chave aparece em mais de um arquivo no mesmo processamento, ou quando a NF-e, NFC-e, NFCom ou NFS-e já foi importada antes para a mesma empresa. O log mostra "Nota já cadastrada: [nº único] - [nº da nota]".

Não é preciso fazer nada. Esses arquivos aparecem no cartão Duplicados, e o Reprocessar não os processa de novo.

Indica um arquivo que o próprio Deploy Agent vai processar de novo, no mesmo processamento. Acontece com o código do produto: por padrão, o produto recebe o menor código livre. Com a preferência Usar CProd (Int) do XML NFe direto como CODPROD ligada, o produto da nota própria usa o código do XML, se ele for numérico, tiver até 10 dígitos e estiver livre. Quando não é possível usar esse código, o arquivo fica com status Reprocessamento Automático e é processado de novo com um código sequencial.

Eventos do e-Social que não estão na preferência Deploy Agent: Eventos para processamento (eSocial) ficam com status Ignorado.

Alguns eventos, como S-1260, S-2400 e S-5001, não têm importação: eles aparecem como Processado, mas o log informa "O evento foi ignorado pois nao existe processador implementado." Os eventos do e-Social seguem uma ordem fixa por tipo de evento, e não pela data.

No arquivo, Cancelado indica uma nota cancelada na SEFAZ. Os eventos de cancelamento são processados antes das notas, e o XML autorizado de uma nota cancelada não é importado: o log mostra "Nota consta como cancelada: [chave]". Um evento de cancelamento sem justificativa, protocolo ou data de registro fica com status Erro.

Quando o processamento para e sobra arquivo Pendente ou Processando, o topo mostra Cancelado. As causas mais comuns são:

• uma EFD com erro, que interrompe a fila (confira Pontos de atenção);
• a versão do ERPCore abaixo da 5.16.7, que também interrompe a fila;
• uma interrupção no processamento.

Arquivos que ficam presos em Processando passam para Erro, com a mensagem "Evento travado em execução ao final do deploy (possível falha de conexão com o banco de dados). Reprocesse manualmente." Filtre por Erro, leia o log do primeiro arquivo e reprocesse.

Verifique o status na aba Arquivos processados e use Ver Notas para abrir as notas geradas a partir do arquivo. Para mais detalhes, confira o artigo Conheça o Deploy Agent.

As empresas vêm dos CNPJs do processamento, informados na oportunidade ou no repositório do cliente. Em base cliente sem essa lista, são usados os CNPJs licenciados. Nenhuma empresa é criada a partir das notas.

Um mesmo processamento pode ter várias empresas: cada nota é associada à empresa cadastrada pelo CNPJ do emitente ou do destinatário. A nota de uma empresa não cadastrada fica com status Erro, com a mensagem "Não existem arquivos válidos para as empresas cadastradas".

• Nota própria (saída): o emitente é uma empresa cadastrada.
• Nota de terceiros (entrada): só o destinatário é uma empresa cadastrada.
• Transferência entre empresas do grupo: quando emitente e destinatário são empresas cadastradas e o CFOP é de operação entre empresas do grupo, a mesma nota gera dois registros: a saída na empresa emitente e a entrada na destinatária. Por isso, o mesmo XML aparece duas vezes na aba Arquivos processados. O mesmo vale para NFS-e.

As notas próprias são processadas antes das de terceiros, em ordem de emissão.

Em base de prospecção, o estoque é recalculado ao final do processamento a partir das notas: entradas menos saídas. Se o cliente enviou só notas de venda, o estoque fica negativo.

O preço é a média do valor unitário das vendas na data mais recente. Ele é gravado só para produtos que ainda não têm preço.

Use a Limpeza de Base, disponível só em ambientes de prospecção. Em produção, a limpeza é bloqueada com a mensagem "Ambiente não liberado para limpeza de dados". O passo a passo está no artigo Enviar e reprocessar documentos fiscais, em Limpar a base de prospecção.

A limpeza é permanente e apaga os dados gerados na implantação, não só configurações: notas, financeiro, impostos, livro fiscal, dados de WMS, produtos, parceiros cadastrados a partir de 01/07/2025, empresas (exceto a empresa 1), vendedores, dados de folha e os registros do Deploy Agent. Os tipos de operação são inativados. Com o escopo Sankhya e BUs, os dados do Sankhya Tax também são apagados.

Sim, enquanto o status for Processando. O passo a passo está no artigo Enviar e reprocessar documentos fiscais, em Cancelar o processamento. Os cadastros já realizados até o cancelamento permanecem no sistema, e você pode retomar depois pelo reprocessamento.

As causas mais comuns são dados inválidos no arquivo, como CPF ou CNPJ inválido, colunas obrigatórias não preenchidas, a máscara do WMS não configurada, ou um artefato que já foi instalado e não pode ser reinstalado. Consulte o log para identificar a causa exata.

Antes de abrir o chamado, consulte o log do arquivo com Ver Log, na aba Arquivos processados. Ao contatar o suporte da Sankhya, reúna o arquivo original (quando a privacidade permitir), a mensagem do log, capturas da tela onde ocorreu o problema e a versão do módulo em uso. Confira Canais de atendimento e abertura de chamados.