Casos de uso - NeoGrid

Histórico de Revisões

Data	Quem	Comentários
23/03/2018	Ryvane Maria	Criação do Documento

Necessidade

Realizar o cadastro de pedidos de forma automática, sem que haja necessidade de montá-lo no portal ou no mobile.

Alguns pedidos são grandes o suficiente para inviabilizar o processo de cadastro de pedido via portal. É necessária a automatização de pedidos, para facilitar a sua importação.

Solução

A importação de pedidos será feita diretamente no servidor através de um micro serviço que será criado com esta finalidade.

Em um arquivo, de formato txt, será possível inserir automaticamente vários pedidos diferentes.

Após a inserção desses pedidos, via micro serviço, será possível visualizar a lista de todos os pedidos que já foram importados na tela de Pedido Auto. A partir dessa tela o usuário pode carregar o pedido na tela de cadastro de pedido usual do GeoSales e salvá-lo.

A partir do momento que o usuário salva o pedido, ele é excluído da lista exibida na tela de pedido auto, e para o GeoSales, se torna um pedido convencional como outro qualquer que foi inserido via cadastro manual. É importante salientar que, antes de salvar o pedido capturado na tela de pedido auto, o usuário deve verificar se os dados foram carregados corretamente na tela de pedido.

Os pedidos importados de forma automática só poderão ser visualizados no relatório de pedidos quando for devidamente salvo na tela de cadastro de pedido. Isso ocorre porque o código (id) do pedido só é gerado após o usuário salvar o pedido.

Implementação

Processo de importação do pedido:

No servidor do cliente há um Client, chamado Neogrid Client, que tem a função de processar os pedidos e enviar os seus dados pro micro serviço. Dentro deste diretório de instalação há uma pasta onde os pedidos são inseridos no formato TXT. O client realiza uma varredura no diretório, dentro do tempo previamente configurado pelo usuário no processo de instalação.m

Os arquivos TXT que serão inseridos para importação devem possuir a seguinte formatação:

- A primeira linha define os dados referente ao cabeçalho do pedido. Esta linha contém informações a respeito do cliente, tipo de pedido, vendedor, condição de pagamento dentre as várias outras informações definidas no cabeçalho do pedido.

- As demais linhas representam um ou mais itens, onde cada linha é referente a um único item e um pedido pode ter vários itens.

O primeiro dígito de cada linha especifica se aquela linha se trata de um pedido ou de um item, se o primeiro dígito for 1, aquela linha é referente a um pedido, se for 2 é referente a um item.

Com os pedidos nessa pasta, o serviço irá realizar uma varredura nessa pasta num período (em milisegundos) pré-determinado pelo usuário no momento da instalação do Neogrid, automaticamente, e, quando surgirem arquivos novos, o serviço irá processá-los.

É nessa pasta também que irão ser listados os pedidos. Quando o client lê um novo pedido e processa-o, esse arquivo TXT deve ser movido para outro diretório chamado 'lidos'. Isso deve ocorrer para que o serviço não precise varrer o arquivo novamente, ou seja, para que o serviço não precise decidir se aquele arquivo já foi lido ou não.

Quando o client processa um arquivo, os dados do pedido serão enviados para o microserviceda GeoSales. Ao perceber que um novo pedido foi recebido, o microservice, por sua vez, recebe os dados do pedido e persiste no banco.

Esses dados são salvos nas seguintes tabelas:

- PEDIDO_AUTO: dados do pedido;

- ITEM_AUTO: dados dos itens;

- LOG_PEDIDO_AUTO: dados do log do serviço. Quando ocorre algum problema referente aos dados do pedido (por exemplo: cliente não existe na base, produto não possui referência válida, mais de um cliente para um mesmo CNPJ e etc), o cliente deve corrigir esses dados diretamente no banco e subir o pedido novamente, para isso, é necessário criar um novo arquivo que atualize as informações. Essa situação é de responsabilidade exclusiva do cliente.

PENDENCIA: PASSAR OS CAMPOS E FORMATAÇÃO DA TABELA

Após a importação dos pedidos, o usuário deve acessar a tela de pedido auto, no portal GeoSales, e verificar se os pedidos foram importados corretamente.

É importante salientar que os pedidos processados pelo microservice do Neogrid só poderão ser visualizados na tela de pedido auto pelos vendedores que tem vínculo com o cliente do pedido. Caso o usuário não tenha nenhum vínculo com o cliente, o pedido não estará disponível na tela de pedido auto para este vendedor.

---

- Com os pedidos importados, o cliente deve ir no portal, na tela de pedido auto, e verificar se os pedidos foram importados corretamente. Detalhe importante: NO GEOSALES HÁ UMA REGRA QUE TODO VENDEDOR DEVE ESTAR ASSOCIADO A UM CLIENTE E A UM SUPERVISOR, (SO IMPORTA PRA GENTE O VINCULO USUARIO/CLIENTE) PARA O USUARIO LOGADO NO PORTAL PODER VER OS PEDIDOS NA TELA DE PEDIDO AUTO, ESSE USUARIO DEVE TER UM VINCULO COM O CLIENTE DO PEDIDO, SE O USUARIO NÃO TIVER NENHUM VINCULO COM O CLIENTE, O PEDIDO NÃO VAI APARECER PRA ELE, SO VAI APARECER OS PEDIDOS DOS CLIENTES DAQUELE VENDEDOR.

Regras de Negócio

[RN1] –

Aprovação

Considero aprovada a documentação da funcionalidade especificada acima, e autorizo a implementação da mesma no Sistema GeoSales, em nome da Organização a qual estou vinculado.

Setor	Aprovado Por	Data	Assinatura
Gerente TI
Gerente Projeto
Gerente Comercial