Geração de Documento Destino
GeracaoDeDocumentoDestino (ERPV2)
Geração de Documento Destino é uma rotina que permite gerar, de forma independente da carga de faturamento, o documento fiscal de destino (ex: Nota Fiscal de Saída) a partir de um documento de origem (ex: Romaneio), sem precisar passar pelo fluxo tradicional de carga.
Visão Geral
Geração de Documento Destino é uma rotina que permite gerar, de forma independente da carga de faturamento, o documento fiscal de destino (ex: Nota Fiscal de Saída) a partir de um documento de origem (ex: Romaneio), sem precisar passar pelo fluxo tradicional de carga. O usuário consulta documentos de origem, identifica quais já têm (ou não) documento destino gerado, gera os destinos manualmente (individualmente ou em lote) e pode trocar o Tipo de Movimento (TMV) de destino configurado antes de gerar.
Consulta de documentos de origem
- A listagem traz documentos de origem já processados pelo faturamento, mostrando se cada um já possui ou não um documento destino vinculado.
- Filtros disponíveis: Filial, Data do documento, Carga (opcional), Percurso (opcional), Status do destino (Sem destino / Com destino / Todos). Também existem atalhos de filtro rápido (botões) para os três status de destino.
- Cada linha traz, lado a lado, os dados do documento de origem e — quando existir — os dados do documento destino já gerado: filial, tipo, série, número, status do documento, status contábil, TMV, participante, valor.
- Quando um documento está sendo processado (geração assíncrona em andamento), a linha mostra o status do processamento e o detalhe do erro, se houver (ex.: “Saldo insuficiente de estoque”, “Documento bloqueado por restrição financeira”).
Gerar Documento Destino
- Para cada documento selecionado, confirma que ele ainda não possui destino gerado — se já possuir, aquele item específico é rejeitado (mas os demais do lote continuam sendo processados).Mensagem exibida: “Operação rejeitada pois o documento já possui um destino gerado no banco de dados.”
- A geração de cada documento passa por etapas de evento de faturamento (tipo “GeracaoDocumentoDestino”) — o mesmo mecanismo usado pelo Painel de Monitoramento de Eventos, o que permite acompanhar o processamento (inclusive em modo assíncrono/paralelo) e registrar erros individualmente por documento.
- Ao final, se houver qualquer erro em algum documento do lote, o resultado geral é reportado como erro, mas cada documento é tratado individualmente — a lista de erros identifica exatamente quais documentos falharam e por quê.Mensagem exibida (sucesso, por documento): “A criação do Documento Destino foi realizada com sucesso.”
Mensagem exibida (erro parcial no lote): “Falha na geração de documento(s) de destino. Ocorreram erros durante o processamento de um ou mais registros da lista. Verifique os detalhes das falhas individuais para identificar as chaves de fato que não puderam ser processadas.”
Atualizar Documento Destino
- Também passa pela verificação de sincronismo do lote.
- Diferente de “Gerar”, esta ação reprocessa um documento destino já existente — útil para reexecutar/sincronizar dados de um destino já gerado, sem precisar excluir e gerar de novo.
- Mesmas mensagens de sucesso/erro parcial da geração.
Trocar TMV de Destino
- Também passa pela verificação de sincronismo do lote.
- O novo Tipo de Movimento (TMV) de destino informado precisa existir no cadastro — caso contrário, a operação inteira é recusada antes mesmo de processar qualquer documento.Mensagem exibida: “Tipo de movimento não encontrado. Código do tipo de movimento: [{código}]. Verifique o código do tipo de movimento informado.”
- Para cada documento do lote, o sistema localiza o documento de origem e atualiza o TMV de destino configurado nele — isso não gera o documento destino, apenas define qual TMV será usado quando a geração acontecer.
- Documentos não encontrados durante o processo entram na lista de erros, mas não impedem que os demais documentos do lote sejam atualizados — a confirmação final é salva de uma vez (commit único) para todo o lote processado com sucesso até aquele ponto.Mensagem exibida (sucesso): “Alteração de Tipo De Movimento concluída com sucesso. Novo Tipo De Movimento para Documento Destino: ‘{TMV}’. Documentos atualizados: {quantidade}.”
Mensagem exibida (sucesso parcial): “A alteração de TMV de destino foi concluída parcialmente. Novo TMV: ‘{TMV}’.” - Segundo a especificação, a lista de TMVs disponíveis para escolha é filtrada pela permissão do usuário — só aparecem os TMVs em que o usuário logado tem permissão de uso.
Processamento paralelo (síncrono/assíncrono)
A rotina tem uma opção liga/desliga para processar os documentos selecionados em paralelo (mais rápido, para grandes lotes) ou sequencialmente. O comportamento segue o mesmo padrão já usado no “Painel de Monitoramento” de eventos de faturamento — os documentos entram numa fila de eventos, cada um com seu próprio status de processamento, permitindo acompanhar o progresso e ver o resultado (sucesso/erro) de cada documento individualmente, mesmo em lotes grandes.
Sincronização manual do lote
Existe uma ação específica (“Sincronizar”) para atualizar, sem refazer a consulta inteira, a informação de quais documentos já ganharam destino — útil depois de um processamento em segundo plano (geração assíncrona) ainda estar rodando quando a tela foi carregada.
- A ação não recarrega a linha inteira — ela não atualiza status, valores, TMV ou qualquer outro dado exibido na grade. Ela só reconsulta, para cada documento selecionado, se agora já existe uma chave de documento destino vinculada a ele.
- Ela só faz essa reconsulta para os documentos que a tela já considerava “sem destino” no momento da chamada. Documentos que a tela já mostrava com destino são devolvidos exatamente como estavam — não há uma nova verificação se aquele vínculo específico ainda é válido.
- Ou seja: “Sincronizar” resolve especificamente o cenário “eu deixei a geração em segundo plano rodando e quero saber quais dos documentos pendentes já ficaram prontos” — para atualizar o restante dos dados da tela (status, valores, etc.), é necessário refazer a consulta/filtro completo, não basta sincronizar.
- Essa é uma reconsulta leve (só chaves de origem/destino), diferente da verificação de sincronismo completa que roda automaticamente antes de qualquer ação em lote (que checa as duas direções — ganho e perda de vínculo — mas só no momento de executar uma ação, não como consulta independente).
Os documentos em si não são “editados” nesta tela — o que pode ser alterado é o TMV de destino configurado (antes da geração) e, depois de gerado, o documento destino pode ser atualizado/reprocessado através da ação específica, mas os dados do documento de origem não são alterados por aqui.