OS 105333 - MELHORIA - DOC. ELETRONICO - MELHORIA NA IMPORTAÇÃO DE PEDIDOS VIA EXCEL - MÓDULO PEDIDOS

Objetivo: 

 A solicitação tem como objetivo aprimorar os processos de emissão e manutenção de documentos eletrônicos e de importação de pedidos , reduzindo atividades manuais e oferecendo validações mais claras ao usuário. 

 As melhorias contemplam três pontos principais: 

 

 Adequar a DC-e à Nota Técnica NT 2024.001_v1.30 , permitindo valor de até R$ 100.000.000,00 por item e também no total da declaração , com validação quando esse limite for ultrapassado. 

 Melhorar a consulta de documentos enviados por e-mail , disponibilizando o filtro Já Enviados com as opções Todos, Sim e Não e apresentando em tela a identificação do status de envio. 

 Permitir que, durante a importação de pedidos por planilha , CEPs ainda não existentes sejam cadastrados automaticamente a partir das informações fornecidas no arquivo, evitando a necessidade de cadastramento manual prévio. 

 

 Com essas alterações, o processo torna-se mais simples e seguro, facilitando a identificação de documentos pendentes de envio, adequando a emissão da DC-e às regras vigentes e reduzindo intervenções manuais na importação de pedidos. 

 Atenção: o modelo da planilha de importação de pedidos foi alterado para contemplar as informações de País e Município . Por esse motivo, o modelo anterior da planilha não deve mais ser utilizado para novas importações . 

 Premissas: 

 

 Necessário o ambiente estar atualizado com as versões:

 

 Dc-e de número 148527 ou superior; 

 Documento Eletrônico de número 148527 / 148533 (CNPJ) ou superior; 

 Comercial de número 148525 /148531 (CNPJ) ou superior; 

 

 

 

 Teste realizado após a atualização. 

 DC-e – Validação dos limites previstos na NT 2024.001_v1.30 

 Cenário 01: Validar valor permitido por item da DC-e 

 Objetivo: Validar que o usuário consiga cadastrar um item da DC-e com valor total de até R$ 100.000.000,00, conforme o novo limite permitido. 

 Pré-condição: Possuir acesso ao módulo de DC-e e uma declaração disponível para inclusão ou alteração de itens. 

 Resultado Esperado: O sistema deve permitir que o valor total do item seja de até R$ 100.000.000,00 , sem apresentar mensagem de limite excedido. O item deve permanecer ativo na declaração e o valor deve ser considerado normalmente no total da DC-e. 

 Passo a passo (Acessando a funcionalidade): 

 

 Acesse o módulo DC-e . 

 

 

 No menu lateral, acesse Transmissões > DCE . 

 

 

 Insira uma nova declaração ou localize uma declaração com status que permita manutenção. 

 

 

 Acesse a aba Itens . 

 Clique em Inserir ou altere um item existente. 

 Informe o produto e a quantidade desejada. 

 

 

 No campo Valor Unitário , informe um valor que resulte em um total do item de R$ 100.000.000,00 . 

 Confirme o item. 

 Verifique que o registro é aceito pelo sistema. 

 Retorne à aba de itens e confira o valor apresentado na coluna Valor Total . 

 

 

 

 Foi possível validar em tela a existência de item ativo com total de R$ 100.000.000,00. 

 

 Cenário 02: Validar bloqueio de item da DC-e acima do limite permitido 

 Objetivo: Garantir que o usuário seja informado quando tentar cadastrar um item cujo valor ultrapasse o limite permitido para a DC-e. 

 Pré-condição: Possuir uma DC-e disponível para manutenção e um produto que possa ser incluído ou alterado. 

 Resultado Esperado: Ao informar um valor que faça o total do item ultrapassar R$ 100.000.000,00 , o sistema deve impedir a confirmação do valor e apresentar uma mensagem informando que o valor do produto está acima do limite permitido para a DC-e. 

 Passo a passo (Acessando a funcionalidade): 

 

 Acesse Transmissões > DCE . 

 Insira ou altere uma declaração. 

 Acesse a aba Itens . 

 Insira ou altere um item. 

 

 

 Informe a quantidade. 

 Informe um Valor Unitário que faça o valor total do item ficar acima de R$ 100.000.000,00 . 

 Tente confirmar o item. 

 Confira a mensagem apresentada pelo sistema. 

 Verifique que o valor acima do limite não é aceito. 

 

 

 

 

 Cenário 03: Validar limite total da DC-e na importação por planilha 

 Objetivo: Validar o tratamento realizado durante a importação quando o valor total da declaração ultrapassar o limite permitido. 

 Pré-condição: Possuir acesso à rotina de importação de DC-e e uma planilha preparada para gerar declaração cujo valor total ultrapasse R$ 100.000.000,00. 

 Resultado Esperado: Quando os itens individualmente estiverem dentro do limite, mas o total da DC-e ultrapassar R$ 100.000.000,00 , a declaração deve ser criada e o relatório da importação deve informar que o valor total excedeu o limite permitido, permitindo que o usuário posteriormente realize a manutenção necessária. 

 Passo a passo (Acessando a funcionalidade): 

 

 Acesse o módulo DC-e . 

 No menu lateral, acesse Transmissões > DCE . 

 Na tela de consulta das declarações, clique no botão Importar . 

 Será apresentada a janela Importar dados do Excel . 

 

 

 No campo Agrupar DCE , selecione a opção desejada para o teste. 

 Caso necessário, clique em Baixar Modelo para obter o modelo atualizado da planilha de importação. 

 Prepare a planilha contendo registros que, quando agrupados em uma mesma DC-e, façam com que o valor total da declaração ultrapasse R$ 100.000.000,00 , mantendo individualmente os itens dentro do limite permitido. 

 Retorne à janela Importar dados do Excel . 

 Clique em Adicionar Arquivos... . 

 Localize e selecione a planilha preparada para o teste. 

 Após adicionar o arquivo, clique em Confirmar para iniciar a importação. 

 Aguarde o processamento. 

 Ao término, consulte o relatório apresentado pelo sistema. 

 Verifique a mensagem referente à declaração cujo valor total ultrapassou R$ 100.000.000,00 . 

 Confirme que a DC-e foi criada e que o relatório apresentou o alerta informando que o valor total excedeu o limite permitido. 

 Retorne à consulta de DC-e e localize a declaração gerada para conferir seu registro. 

 

 

 

 Atenção: para esta validação, utilize Agrupar DCE = Sim quando for necessário reunir as linhas da planilha em uma única declaração para atingir o valor total superior ao limite. 

 

 Cenário 04: Validar item acima do limite na importação da DC-e 

 Objetivo: Garantir que registros com item acima do limite permitido não originem uma DC-e incorreta durante a importação. 

 Pré-condição: Possuir uma planilha contendo pelo menos um item cujo valor total ultrapasse R$ 100.000.000,00. 

 Resultado Esperado: Com Agrupar DCE = Não , a linha cujo item ultrapasse R$ 100.000.000,00 deve ser desconsiderada e não deve gerar uma DC-e. Com Agrupar DCE = Sim , a declaração na qual esse item seria agrupado também não deve ser gerada. Em ambas as situações, o relatório deve informar claramente o motivo da rejeição. 

 Passo a passo (Acessando a funcionalidade): 

 

 Acesse o módulo DC-e . 

 No menu lateral, acesse Transmissões > DCE . 

 Na tela de consulta das declarações, clique em Importar . 

 Na janela Importar dados do Excel , selecione inicialmente Agrupar DCE = Não . 

 

 

 Caso necessário, utilize o botão Baixar Modelo para obter a planilha padrão. 

 Prepare a planilha contendo pelo menos um item cujo valor total ultrapasse R$ 100.000.000,00 . 

 Clique em Adicionar Arquivos... e selecione a planilha. 

 Clique em Confirmar para iniciar o processamento. 

 Aguarde a conclusão da importação. 

 Consulte o relatório gerado pelo sistema. 

 Verifique que a linha correspondente ao item acima do limite é identificada com erro informando que o valor total do produto excede R$ 100.000.000,00 . 

 Confirme que essa linha foi desconsiderada e não originou uma DC-e indevida. 

 

 

 

 Validação com agrupamento: 

 

 Retorne à consulta de DC-e e clique novamente em Importar . 

 Na janela Importar dados do Excel , altere o campo para Agrupar DCE = Sim . 

 

 

 Utilize uma planilha em que o item acima do limite faça parte de uma declaração que seria formada pelo agrupamento dos registros. 

 

 

 Clique em Adicionar Arquivos... . 

 Selecione a planilha e clique em Confirmar . 

 Aguarde o processamento. 

 Consulte o relatório da importação. 

 

 

 Verifique a mensagem de erro referente ao item que excedeu o limite. 

 Confirme que a DC-e que receberia o item inválido não foi gerada . 

 

 

 Cenário 05: Validar limite total ao transmitir a DC-e 

 Objetivo: Impedir que uma DC-e com valor total acima do permitido seja transmitida. 

 Pré-condição: Possuir uma DC-e com status Transmissão Pendente cujo valor total ultrapasse R$ 100.000.000,00. 

 Resultado Esperado: O sistema deve impedir a transmissão e apresentar ao usuário um alerta informando que o valor total da DC-e está acima do limite de R$ 100.000.000,00 . A validação deve ocorrer tanto na transmissão individual quanto pela opção Transmitir selecionados . 

 Passo a passo (Acessando a funcionalidade): 

 

 Acesse Transmissões > DCE . 

 Localize a declaração com valor total acima do permitido. 

 Tente realizar a transmissão pelo ícone disponível na própria declaração. 

 Confira a mensagem apresentada. 

 Verifique que a transmissão não é concluída. 

 Retorne à consulta. 

 Selecione a declaração. 

 Clique em Transmitir selecionados . 

 

 

 Confirme novamente que o sistema apresenta o alerta de valor excedido e não realiza a transmissão. 

 

 

 Documentos Eletrônicos – Controle dos documentos enviados por e-mail 

 Cenário 06: Validar filtro de documentos enviados por e-mail da NF-e 

 Objetivo: Facilitar a consulta dos documentos, permitindo ao usuário identificar aqueles que já foram enviados e aqueles que ainda estão pendentes de envio. 

 Pré-condição: Possuir documentos disponíveis na rotina de envio de e-mail, contemplando registros enviados e não enviados. 

 Resultado Esperado: O filtro Já Enviados deve ser apresentado como uma lista de seleção contendo as opções Todos, Sim e Não . A relação de documentos deve apresentar também a informação XML Enviado , identificando visualmente a situação de cada documento. A seleção de cada opção deve respeitar a situação de envio correspondente. 

 Passo a passo (Acessando a funcionalidade): 

 

 Acesse o módulo Documentos Eletrônicos . 

 No menu lateral, acesse NFE > Envio de E-mail . 

 

 

 Informe o período desejado. 

 Localize o campo Já Enviados . 

 Abra a lista de opções e confira a disponibilidade de:

 

 Todos ; 

 Sim ; 

 Não . 

 

 

 Selecione Todos e confira a apresentação dos documentos independentemente da situação de envio. 

 Selecione Sim e confira os registros já enviados. 

 Selecione Não e confira os documentos ainda não enviados. 

 Na grade de resultados, verifique a coluna XML Enviado . 

 

 

 Confira se cada documento apresenta sua respectiva situação de envio. 

 

 Atenção: esta alteração modifica a forma de consulta e visualização das informações. As demais regras existentes para o envio dos documentos permanecem inalteradas. 

 

 Cenário 07: Validar filtro de documentos enviados por e-mail da NFS-e 

 Objetivo: Disponibilizar na rotina de NFS-e o mesmo controle para identificação dos documentos enviados e pendentes. 

 Pré-condição: Possuir acesso à rotina de envio de e-mail de NFS-e e documentos disponíveis para consulta. 

 Resultado Esperado: O filtro Já Enviados deve possuir as opções Todos, Sim e Não , e a grade deve apresentar a informação XML Enviado , possibilitando distinguir os documentos enviados daqueles que permanecem pendentes. 

 Passo a passo (Acessando a funcionalidade): 

 

 Acesse o módulo Documentos Eletrônicos . 

 No menu lateral, acesse NFS-e > Envio de e-mail . 

 

 

 Informe o período da consulta. 

 Localize o filtro Já Enviados . 

 Verifique as opções Todos, Sim e Não . 

 Realize a consulta utilizando cada opção. 

 Confira os documentos apresentados. 

 Verifique a coluna XML Enviado e sua situação correspondente. 

 

 

 

 

 

 Vendas/Pedidos – Cadastro automático de CEP durante a importação 

 Cenário 08: Validar cadastro automático de CEP e tratamento de dados inválidos na importação 

 Objetivo: Validar que, durante a importação de pedidos por Excel, novos CEPs sejam cadastrados automaticamente quando possuírem informações válidas de localização e que, caso sejam identificados dados inválidos, o sistema impeça a efetivação dos pedidos até que as inconsistências sejam corrigidas. 

 Pré-condição: Possuir o modelo atualizado da planilha de importação de pedidos. Preparar uma planilha contendo CEPs ainda não cadastrados no sistema, incluindo pelo menos um registro com código de Município inválido. Os registros válidos devem possuir os respectivos códigos de País e Município preenchidos. 

 Resultado Esperado: O sistema deve validar as informações dos registros durante o processamento da planilha. Caso seja identificada qualquer inconsistência em uma das linhas, o erro deve ser apresentado no log e nenhum dos pedidos pertencentes ao arquivo deve ser efetivado . Após a correção das inconsistências e uma nova importação sem erros, os pedidos devem ser processados normalmente. 

 Passo a passo (Acessando a funcionalidade): 

 

 Acesse o módulo Corporativo . 

 Acesse Corporativos > Localização > CEP . 

 

 

 Pesquise os CEPs que serão utilizados na importação. 

 

 

 Prepare a planilha de importação contendo vários pedidos e novos CEPs. 

 Para os novos CEPs que deverão ser cadastrados corretamente, preencha as informações de endereço e informe:

 

 País: código correspondente de 4 dígitos; 

 Município: código correspondente de 7 dígitos. 

 

 

 Em pelo menos um dos registros da planilha, informe propositalmente um código de Município inexistente ou inválido , para validar o tratamento da inconsistência. 

 Acesse o módulo Vendas . 

 Vá até Orçamentos/Pedidos > Importação de pedidos por Excel . 

 

 

 Clique em Adicionar Arquivos e selecione a planilha preparada para o teste. 

 Inicie o upload e confirme a importação. 

 Aguarde o processamento do arquivo. 

 

 

 Acesse Orçamentos/Pedidos > Monitoramento de Processos Excel . 

 Localize o processamento realizado e abra o respectivo log. 

 

 

 Confira a mensagem indicando que o município informado não está cadastrado ou não é válido. 

 Confira também as mensagens indicando que os pedidos não foram efetivados devido aos erros encontrados na importação. 

 Acesse Orçamentos/Pedidos > Emissão/Alteração e confirme que nenhum dos pedidos pertencentes ao processamento com erro foi efetivado. 

 

 

 Retorne ao módulo Corporativo > Localização > CEP e confirme que o CEP associado ao Município inválido foi cadastrado. 

 

 

 Retorne ao módulo Vendas > Orçamentos/Pedidos > Importação de pedidos por Excel . 

 Adicione novamente a planilha corrigida, inicie o upload e confirme a importação. 

 Aguarde o processamento. 

 Acesse Monitoramento de Processos Excel , localize a nova execução e abra o log. 

 Verifique que os registros foram processados sem erros e que os pedidos foram cadastrados com sucesso. 

 

 

 Retorne ao módulo Vendas e acesse Orçamentos/Pedidos > Emissão/Alteração . 

 

 

 Localize os pedidos provenientes da importação. 

 Confirme que os pedidos foram efetivamente criados após a correção e o processamento bem-sucedido da planilha. 

 

 

 

 Atenção: A importação de pedidos por Excel realiza o processamento do arquivo de forma integral. Caso seja identificada qualquer inconsistência em uma das linhas da planilha, nenhum dos pedidos contidos no arquivo será efetivado , inclusive aqueles cujos dados estejam corretos. Essa regra evita o processamento parcial da planilha e possíveis divergências entre os pedidos importados. Após identificar a inconsistência no log de processamento, corrija a informação na planilha e realize uma nova importação. 

 

 ORIENTAÇÃO IMPORTANTE SOBRE O NOVO MODELO DA PLANILHA 

 O modelo da planilha de importação de pedidos foi atualizado porque o cadastro automático de novos CEPs necessita das informações de País e Município . A planilha utilizada nos testes apresenta essas informações juntamente com CEP, logradouro, bairro, cidade e UF. 

 Para CEPs novos , devem ser informados: 

 

 País: código de país com 4 dígitos. Exemplo para Brasil: 1058 . 

 Município: código de município com 7 dígitos. Exemplo: 3502200 . 

 

 Essas informações são necessárias somente quando houver necessidade de cadastrar um novo CEP . Para CEPs que já existirem no cadastro, o sistema deverá apenas utilizá-los, sem realizar alterações. 

 Importante: devido à inclusão dessas novas informações, o modelo anterior da planilha deixa de ser válido para esta rotina de importação . Recomenda-se que o usuário sempre utilize o modelo atualizado disponibilizado pela funcionalidade. 

 

 ATENÇÃO: As informações neste documento são meramente ilustrativas e utilizadas apenas para fins de teste.