Enviar e reprocessar documentos fiscais

O que é o processamento de documentos fiscais

Há uma funcionalidade no Deploy Agent para processar documentos fiscais já emitidos pelo cliente para pré-popular o banco com as operações, parceiros, produtos e movimentações registrados neles, reduzindo o quanto você pessoa implantadora precisa lançar manualmente. É um processamento em lote de arquivos históricos, não uma captura em tempo real.

Para conhecer a tela do Deploy Agent, as abas e os indicadores de acompanhamento, confira o artigo Conheça o Deploy Agent.

Antes de começar

Confirme que os arquivos estão em formato válido:

Enviar arquivos para processamento

Pelo repositório de arquivos

1. Envie o arquivo por upload direto, ou coloque-o em um bucket S3 e notifique o sistema.
2. Acione Buscar novos arquivos para disparar o processamento.
3. Acompanhe pelas etapas: leitura do arquivo, processamento de cadastros base, processamento de documentos e sincronização com a API de Melhores Práticas.

Pela Consulta do Portal Deploy

ℹ️ Nota

O botão só aparece em ambientes com integração ativa com o Portal Deploy.

1. Acesse o Deploy Agent e clique em Consulta do Portal Deploy, na barra superior.
2. Consulte a lista de oportunidades disponíveis, com empresa, CNPJ e total de arquivos de cada uma.
3. Filtre por data de início e período dos documentos, se quiser refinar a lista.
4. Selecione a oportunidade desejada e clique em Iniciar processamento.
5. Acompanhe o andamento na tela do Deploy Agent.

Quando não houver oportunidades, a tela mostra que nenhuma está disponível. Se a lista não carregar, tente consultar novamente.

Reprocessar e cancelar

Reprocessar documentos

Use este fluxo quando quiser reiniciar o processamento escolhendo quais tipos de documento reprocessar.

ℹ️ Nota

O reprocessamento fica indisponível enquanto há processamento em andamento.

1. Acesse o Deploy Agent e clique em Reprocessar, na barra superior.
2. Selecione os modelos de documento a reprocessar: CF-e, CT-e, e-Social, EFD, MDF-e, NF-e, NFC-e, NFCom e/ou NFS-e. Por padrão, todos vêm marcados.
3. Marque Buscar novos arquivos no repositório, se quiser incluir arquivos novos no reprocessamento.
4. Clique em Confirmar para iniciar, ou em Cancelar, na janela, para desistir sem reprocessar.
5. Acompanhe o andamento na tela do Deploy Agent.

Para reprocessar um único arquivo, use Reprocessar registro, na aba Arquivos processados.

Cancelar o processamento

ℹ️ Nota

O botão Cancelar só fica disponível com o processamento Em andamento.

1. Acesse o Deploy Agent e confirme que o status está Em andamento.
2. Clique em Cancelar, na barra superior.
3. Leia a confirmação: "Cancelar o processamento — Ao cancelar, o processamento dos arquivos será interrompido imediatamente. Os cadastros já realizados até o momento serão mantidos no sistema. Caso deseje reiniciar o processamento, utilize o botão Reprocessar. Deseja mesmo cancelar?"
4. Clique em Sim para confirmar, ou em Não para manter o processamento.

O cancelamento não desfaz os cadastros e movimentos já gerados antes da interrupção. Para retomar, use Reprocessar documentos.

Tratar erros de processamento

Se um arquivo falhar, o erro é registrado no log e o processamento para apenas naquele arquivo; os demais seguem normalmente. Dados parcialmente inseridos não são revertidos automaticamente.

1. Acesse o Deploy Agent e abra a aba Arquivos processados.
2. Filtre pelo status Erro e, se quiser, pelo tipo de documento.
3. Selecione um único arquivo e clique em Visualizar para conferir o conteúdo.
4. Identifique a causa. Para MDF-e e NFS-e, confira o artigo específico do documento nesta seção.
5. Corrija a causa e acione Reprocessar registro, ou exclua o registro com Excluir registro, quando for o caso.

Limpar a base de prospecção

Use este fluxo para reiniciar um ambiente de prospecção ou demonstração.

Atenção: Disponível apenas em ambientes de prospecção. A exclusão é permanente: confirme o escopo antes de prosseguir.

1. Acesse o Deploy Agent e clique em Limpeza de Base, na barra superior.
2. Escolha o escopo: Apenas Sankhya ou Sankhya e BUs.
3. Clique em Confirmar.
4. Leia a mensagem de confirmação, que informa que os dados serão excluídos permanentemente, e clique em Sim para confirmar ou em Não para desistir.
5. Aguarde a conclusão da limpeza e leia a mensagem final, que indica se a limpeza ocorreu apenas na Sankhya ou em todos os sistemas, conforme o escopo escolhido.

A limpeza Apenas Sankhya exclui os dados da base que estão no Sankhya Om. Já a opção Sankhya e BUs apaga os dados do Sankhya Om e do ambiente do Sankhya Tax.

Documentos suportados

Os tipos de documento abaixo podem ser processados pelo Deploy Agent. MDF-e e NFS-e têm regras próprias, descritas em artigos específicos desta seção.

Saiba mais

• Conheça o Deploy Agent: visão geral, abas, indicadores e arquivos processados.
• Como importar MDF-e no Deploy Agent e - Como importar NFS-e no Deploy Agent: regras e tratamento de erros por tipo de documento.
• Limites e dúvidas frequentes: pontos de atenção e perguntas frequentes sobre o Deploy Agent.