PROC001 Melhoria importação de produtos

1. Introdução

Este processo visa exemplificar a melhoria para a importação de cadastro de produtos.

2. Processo

Especificação Funcional

PROC001 Melhoria importação de produtos:

Protótipo de Tela:

Imagem I - Exemplo de nova Dialog de guia para importação de Produtos.

Imagem II- Exemplo de nova Dialog.

Imagem III - Importação de planilha.

Imagem IV - Exemplo de nova Dialog de importação.

Imagem V - Progresso importação.

Imagem VI - Tela de resultado.

Descrição dos Campos:

Regras de Interface:

1. Baixar Planilha Modelo: Executa o download do modelo para guia de importação.
2. Resolução de conflitos: Deve conter as seguintes opções "Atualizar cadastro existente"; "Ignorar duplicados" e "Gerar erro e bloquear".
3. Planilha com Cabeçalho: Por padrão deve vir como , o evento de clique deve alterar o botão para

4. Arquivo XLSX/XML: Ao importar o arquivo deve gerar o Loading da importação do arquivo. Caso seja possível a importação, retornar o popup "Arquivo importado". Caso não seja possível, retornar a mensagem de erro "Não foi possível importar, verifique o arquivo".
5. Fechar (Imagem IV): Deve encerrar a tela sem modificações em base, apenas memoria.
6. Importar: Se possível importar, deve ir para a Imagem V - Progresso importação.
7.Campo do Sistema: O campo para o vínculo entre campo do sistema e coluna de vínculo da planilha deve ser um Dropdown com campo para busca, comportamento já existente no componente atual. Deve conter as opções já existentes com a adição do "Tipo de Cadastro". Os campos obrigatórios devem ser listados primeiro:

8. Importar: Se possível iniciar a importação, a tela deve ser finalizada e deve ser dado sequência para a Dialog da  Imagem V - Progresso importação.
Essa tela deve mostrar o progresso tanto em percentual quanto de registros sendo salvos.

8.1 Caso não seja possível a importação, deve exibir em tela a mensagem: 
"Erro
Valide a estrutura do arquivo a ser importado"

9. Cancelar Importação: A ação deve abrir uma tela de confirmação pro usuário "Deseja interromper o processo de importação?" caso o usuário clique em 'Não', deve ser fechada a tela de confirmação e o processo continuado. Caso clique em 'Sim' a tela de importação deve ser encerrada.
10. Tela de resultado: Deve exibir a quantidade de registros no arquivo, importados com sucesso e registros com erro. Caso houverem erros exibir a mensagem:

Alguns registros não puderam ser importados. Verifique o relatório para mais detalhes.

Regras de Negócio:

1. Baixar Planilha Modelo: Deve fazer o download de uma planilha XLSX contendo a coluna com todos os campos disponíveis para vínculo no sistema, conforme Tabela I - Tabela de campos para vínculo.
2. Arquivo XLSX/XML: Deve validar o formato do arquivo, se é XLSX ou XML e se o arquivo não supera 2MB . Caso for um formato diferente desses, não dar sequência na tentativa de importação.
3. Tipo de Cadastro*: Servirá pra marcar caso um item seja "1-Produto" ou "2-Serviço".
4. Importar: Validar se os campos obrigatórios do sistema possuem vínculo com a coluna da planilha. Se estiverem vinculados, deve ser validado a "Resolução de conflitos"

• Se for "Atualizar cadastro existente", novos registros devem gerar uma Inserção na base de dados. Registros existentes devem ser Atualizados. O Critério para isso é o Código de Barras, caso não tiver, considerar o SKU, caso contrário não será feito validação e sempre gerar adição nova em banco.
• Se for "Ignorar duplicados", os registros conflitantes/já existentes na base de dados devem ser ignorados no momento da importação dos registros da planilha.
• Se "Gerar erro e bloquear", quando um registro já existir em banco, a importação deve ser interrompida, não realizando mais inserções no banco.

5. Campos do Sistema-Saldo de Estoque: Caso seja informado uma linha de registro como Serviço e ela possua valor acima de zero no Saldo de Estoque, deve ser validado para não registrar esse saldo no cadastro respectivo. Apesar da importação deve ser informado no relatório de erros o informe da não permissão de saldo de estoque para serviço.

6. Deve ser gerado um log de registro da importação, contendo dados básicos 'data/hora', 'modulo', 'Usuário' e 'Descrição'. Inserir a descrição como "Realizada importação de planilha {nome_arquivo} de produtos com total de {numero_total_registros}, importados com sucesso: {numero_total_sucesso}, com erro: {numero_total_erro}"

7. Cancelar Importação:  A ação deve interromper a importação até que o usuário confirme alguma ação. Caso o usuário confirme o cancelamento da importação, deve ser interrompida as inserções e alterações na base de dados.

8. Baixar relatório de Erros -  Esse relatório deverá conter:

• • • número da linha na planilha
    • campo que apresentou erro
    • descrição do erro encontrado

Questões Técnicas:

1. Tabela onde deve ser inserido ou alterado o cliente: 'produto'.

2. Baixar Planilha Modelo: Planilha de padrão XLSX, deve conter cabeçalho com os campos para vínculo.

3. Baixar relatório de Erros: Relatório temporário gerado por HTML, deve listar apenas as rejeições e a linha onde ocorreu a rejeição da importação. 

©SOFTEN SISTEMAS 2026