001 - Enviar e reprocessar documentos fiscais

O Deploy Agent lê os documentos fiscais que o cliente já emitiu e, a partir deles, cadastra no Sankhya Om as operações, parceiros, produtos e movimentações. Assim, você lança menos dados manualmente.

O processamento é feito em lote, com arquivos já emitidos. Não é uma captura em tempo real.

Neste artigo, você confere como enviar os arquivos, reprocessar ou cancelar o processamento, tratar erros e limpar a base de prospecção.

Figura 1: Jornada do Deploy Agent. As etapas tratadas neste artigo estão em destaque.

Antes de começar

Confirme com o cliente se os arquivos atendem a estes requisitos:

Os arquivos também precisam estar no formato esperado:

Enviar arquivos para processamento

Só a equipe de serviços opera o Deploy Agent: prospects e clientes não têm acesso a ele. O que muda é por onde os arquivos chegam:

O link de envio é individual, conforme o momento da jornada. Os arquivos de cada cliente ficam num repositório exclusivo, separado dos demais.

Arquivos do prospect, pelo Portal Deploy

ℹ️ Nota

A opçã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. Na janela Oportunidades disponíveis, selecione a oportunidade do prospect. Para localizá-la, use os filtros Data de início e Período dos documentos.
3. Clique em Iniciar processamento. O botão só fica disponível com uma oportunidade selecionada e com o ambiente livre.
4. Acompanhe o andamento na tela do Deploy Agent.

A lista de oportunidades mostra o número da oportunidade no Ploomes, a empresa, os CNPJs, a quantidade e o tamanho dos documentos enviados, a data de início e o período dos documentos. Quando não há oportunidades, a tela informa que nenhuma está disponível. Se a lista não carregar, consulte novamente.

Arquivos no repositório do cliente, pelo agente de importação

1. Acesse o agente de importação e insira os arquivos no repositório do cliente.
2. Acesse o Deploy Agent e acompanhe o indicador de status até ficar Concluído.

O processamento começa automaticamente quando os arquivos ficam disponíveis no repositório. Não é preciso reprocessar nem marcar os modelos de documento.

Reprocessar ou cancelar o processamento

Reprocessar documentos

Como o processamento já é automático, o reprocessamento é um fluxo alternativo, para casos esporádicos:

• depois de ajustar uma configuração ou um cadastro, como o de empresas, para corrigir um erro apontado no log;
• depois de incluir no repositório arquivos novos que não foram processados.

ℹ️ Nota

O reprocessamento fica indisponível enquanto o status for Processando ou Cancelando, ou enquanto outra pessoa estiver usando o ambiente.

1. Acesse o Deploy Agent e clique em Reprocessar, na barra superior.
2. Na janela "Deseja processar novamente os arquivos?", selecione os modelos de documento a reprocessar: CF-e, CT-e, NF-e, NFC-e, NFCom, NFS-e, EFD, E-Social e/ou MDF-e. Por padrão, todos vêm marcados.
3. Se incluiu arquivos novos no repositório, marque Buscar novos arquivos no repositório. Essa opção vem desmarcada.
4. Clique em Confirmar para iniciar, ou em Cancelar, na janela, para desistir sem reprocessar.
5. Acompanhe o andamento na tela do Deploy Agent.

O que é reprocessado, nos modelos marcados:

Com NFS-e marcada, as notas que ainda aguardam conversão por IA são enviadas de novo para conversão.

Reprocessar um único registro

Para reprocessar apenas um arquivo, de qualquer tipo de documento, acesse a aba Arquivos processados, selecione o arquivo e acione Reprocessar Registro. A opção não está disponível para arquivos com status Processado. Para mais detalhes, acesse o artigo Conheça o Deploy Agent.

Cancelar o processamento

ℹ️ Nota

O botão Cancelar só fica disponível com o status Processando.

1. Acesse o Deploy Agent e confirme que o status está Processando.
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, como descrito em Reprocessar documentos.

Tratar erros de processamento

Quando um arquivo falha, o erro é registrado no log e só aquele arquivo para; 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 Ver Documento para conferir o conteúdo.
4. Identifique a causa. Para MDF-e e NFS-e, confira o artigo de regras 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 de 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 e leia a mensagem final, que indica se a limpeza ocorreu apenas na Sankhya ou em todos os sistemas, conforme o escopo escolhido.

Documentos suportados

O Deploy Agent processa os tipos de documento abaixo. MDF-e e NFS-e têm regras próprias, descritas em artigos específicos desta seção.

Próximos passos

• Regras de importação de MDF-e no Deploy Agent
• Regras de importação de NFS-e no Deploy Agent