Geração de Documento Destino
Documentação Técnica 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. 01. VISÃO GERAL 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. Como funciona de fato: 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). Informação
Venda de Mercado Interno
Impressão de Documento Auxiliar, Quantidade de Impressões por TMV e Ordem
Documentação Técnica Impressão de Documento Auxiliar, Quantidade de Impressões por TMV e Ordem Esta funcionalidade faz com que o sistema respeite, ao imprimir os documentos gerados em uma movimentação (Documento Fiscal, Cobrança Bancária e Documentos Auxiliares/RPTs), a configuração de quantidade de vias e ordem de impressão já definida no cadastro do Tipo de Movimento (TMV), na configuração “Impressão de Documentos” (Dados Relacionados do TMV). 01. VISÃO GERAL Visão Geral Esta funcionalidade faz com que o sistema respeite, ao imprimir os documentos gerados em uma movimentação (Documento Fiscal, Cobrança Bancária e Documentos Auxiliares/RPTs), a configuração de quantidade de vias e ordem de impressão já definida no cadastro do Tipo de Movimento (TMV), na configuração “Impressão de Documentos” (Dados Relacionados do TMV). 02. REGRAS DE NEGÓCIO Regras de Negócio 1. Origem da configuração A configuração de impressão de cada TMV fica gravada em um XML (campo ConfigXML do Tipo de Movimento), estruturado em duas partes: Documentos Padrão: Documento Fiscal e Cobrança Bancária — cada um com sua própria quantidade de vias e ordem. Documentos Auxiliares: uma lista de RPTs adicionais (relatórios/documentos auxiliares vinculados ao TMV), cada um com caminho do arquivo, quantidade de vias e ordem. 2. Quando não há configuração Se o TMV não tiver nenhuma configuração de impressão definida (XML vazio ou ausente), o sistema aplica o comportamento padrão: 1 via do Documento Fiscal seguida de 1 via da Cobrança Bancária — sem nenhum documento auxiliar. 3. Quantidade de vias Para cada documento (Documento Fiscal, Cobrança Bancária ou cada RPT auxiliar), o sistema imprime exatamente a quantidade de vias configurada para aquele documento. Se a quantidade não estiver definida na configuração, o padrão é 1 via. Documentos que não chegaram a ser gerados (ex: Cobrança Bancária quando o documento não gera boleto, ou um RPT auxiliar que não pôde ser processado) são simplesmente ignorados na impressão, independente da quantidade configurada. 4. Ordem de impressão Os documentos são impressos na ordem configurada (do menor para o maior número de ordem). Casos especiais: Se nenhum documento tiver ordem configurada (todos com ordem = 0), o sistema usa uma ordem padrão interna (Documento Fiscal, depois Cobrança Bancária, depois os Auxiliares). Se alguns documentos tiverem ordem configurada e outros não, os que não têm ordem definida (ordem = 0) são impressos por último, depois de todos os que têm ordem configurada. 5. Onde a regra é aplicada Esta lógica de montagem da impressão (vias + ordem) é compartilhada pelos dois pontos do sistema que geram a impressão combinada de documentos: Transmissão/emissão de NF-e (módulo Documentos Fiscais Eletrônicos). Painel de Monitoramento de Faturamento, na geração de documentos de carga. Isso garante que a configuração do TMV tenha o mesmo efeito, seja o documento impresso a partir de um ou de outro processo. 03. MODELO DE DADOS (CONFIGURAÇÃO DE IMPRESSÃO POR DOCUMENTO) Modelo de Dados (Configuração de Impressão por Documento) Campo Tipo Descrição Tipo de Documento Documento Fiscal / Cobrança Bancária / Auxiliar (RPT) Qual documento a configuração se refere Quantidade de Vias número inteiro Quantas cópias desse documento serão impressas (padrão: 1) Ordem número inteiro Posição do documento na sequência de impressão (0 = sem ordem definida, impresso por último) Caminho do Arquivo (apenas Auxiliares) texto Identifica qual RPT auxiliar deve ser gerado/impresso 04. AUTORIZAÇÃO Autorização Não há papel de autorização específico para esta capacidade — ela é aplicada automaticamente sempre que o sistema monta a impressão de um documento cujo TMV tenha essa configuração, sem exigir permissão adicional além do já necessário para emitir/imprimir o documento em si.
