01. DADOS GERAIS
Linha de Produto: | Virtual Age |
---|---|
Segmento: | Moda |
Módulo: | Integração |
Função: | Enviar os dados do produto para o TOTVS Omni através de arquivo json |
Ticket: | |
Requisito/Story/Issue (informe o requisito relacionado) : | DVAITG-3989 |
02. SITUAÇÃO/REQUISITO
A TOTVS usará o TOTVS Omni como ferramenta de Omni Channel, e com isso surgiu a necessidade de integrar os produtos do Virtual Age com essa ferramenta.
03. SOLUÇÃO
Foi criado no GERFP069, para o tipo Integração, o processo 200 para a exportação de produto para o TOTVS Omni, onde ao exportar será criado em um diretório o arquivo json com os dados do produto.
Também foi implementado uma opção de envio de e-mail para caso o processo apresente alguma falha ao exportar, para esse envio de e-mail funcionar é necessário ter um remetente configurado no componente ADMFM099 e configurar o parâmetro DS_EMAILDESTINATARIO para o processo 200.
Para utilizar essa nova opção terão alguns parâmetros obrigatórios a serem informados, como CD_PRECO, DS_CLASFILTRO, DS_DIRETORIOARQUIVO, DS_TPCLASTIPOPRODUCTO, DS_TPCLASGENERO, DS_TPCLASMARCA e DS_TPCLASMODELO. Esses parâmetros serão detalhados abaixo.
Imagem 1 - Configurar o e-mail do remetente para o usuário que utilizará o sistema.
Imagem 2 - Foi criado o processo 200 para exportação de produtos para o TOTVS Omni, após informar o processo clicar dê duplo clique no campo Parâmetro.
Imagem 3 - No GERFM251, informar um código de sequência e uma descrição, e na lista abaixo informar os parâmetros.
Os parâmetros marcados na imagem são os obrigatórios para a exportação de produto:
- CD_PRECO: Código do tipo de valor de Preço(É possível visualizar o código dos tipos através do componente PRDFL003)
- DS_CLASFILTRO: Tipo e a classificação que será utilizada para filtrar os produtos encontrados, ou seja, apenas os produtos que possuem essa classificação serão exportados. O formato de cadastro no campo deve ser Tipo;Classificação(501;01). É possível visualizar as classificações no componente PRDFL012.
- DS_DIRETORIOARQUIVO: É o diretório onde será exportado o arquivo com os dados do produto, caso dê um duplo clique no campo Conteúdo será aberta uma tela para seleção de pasta, para facilitar a informação do diretório.
O parâmetro DS_EMAILDESTINATARIO será o e-mail pra onde será enviado as informações de falhas que aconteceram ao exportar o produto.
Nos parâmetros DS_TPCLASCATEGORIA, DS_TPCLASGENERO, DS_TPCLASMARCA, DS_TPCLASMODELO, DS_TPCLASTEMPORADA e DS_TPCLASTIPOPRODUCTO será informado o tipo de classificação que será buscado a descrição para cada campo. Para encontrar a descrição será verificado primeiro se o produto padrão possui alguma classificação para esse tipo, se possuir, será verificado se essa classificação possui alguma descrição para web no PRDFM264 para ser utilizada, mas caso não tiver a descrição web será utilizado a própria descrição da classificação encontrada.
Após informar os campos, clicar para salvar(F3), e dê duplo clique na sequência para selecioná-la.
Imagem 4 - Após selecionar o parâmetro, clique em Executar. Será aberto a tela para informar o intervalo de data que será consultado os produtos. Serão considerados os produtos que tiverem a data de alteração nesse intervalo, será verificado a data de alteração dos:
- Dados do grupo(PRDFM009 - Se for alterado o grupo então serão enviados todos os produtos do grupo)
- Dados do produto(PRDFM011)
- Dados do produto para web(PRDFM164 e PRDFM234)
- Descritivo do produto para web(PRDFM164 e PRDFM246 - Se for alterado o grupo então serão enviados todos os produtos do grupo)
Após informar o intervalo, clique em Confirmar para realizar a exportação.
Imagem 5 - Foi gerado o arquivo com sucesso, dê um duplo clique no campo Resultado para consultar o caminho que foi gerado o arquivo.
Imagem 6 - No resultado aparecerá o arquivo que foi gerado.
Imagem 7 - Nessa imagem está a informação que foi gerada no arquivo, porém foi formatado o json para uma melhor visualização.
Os campos enviados são:
- precio: Preço do produto para aquele código informado no GERFM251(Imagem 3), caso o produto padrão não tiver esse preço o produto seria rejeitado para exportar.
- precioRebajado: Valor da promoção para aquele tipo de valor informado(Caso o produto não tenha valor de promoção será repetido o mesmo valor do campo precio).
- codigoAlfa: Nível do grupo + cor do produto(Qualquer espaço em branco será substituído por ponto).
- color: Código da cor
- descripcionColor: Descrição da cor
- material: Será exportado a primeira lista de composição do produto(PRDFM031).
- categoria: Descrição da classificação informada no parâmetro DS_TPCLASCATEGORIA.
- tipoProducto: Descrição da classificação informada no parâmetro DS_TPCLASTIPOPRODUCTO.
- genero: Descrição da classificação informada no parâmetro DS_TPCLASGENERO.
- temporada: Descrição da classificação informada no parâmetro DS_TPCLASTEMPORADA.
- modelo: Descrição da classificação informada no parâmetro DS_TPCLASMODELO.
- marca: Descrição da classificação informada no parâmetro DS_TPCLASMARCA.
- descripcion: Descritivo do grupo para web cadastro no PRDFM164 frame Descritivo.
- nombre: Descrição do grupo para web cadastro no PRDFM164 frame Web service.
- ean: Código de barras padrão, ou o primeiro código encontrado caso não tenha padrão.
- sku: Código reduzido do produto.
- tallajeOriginal: Tamanho do produto.
Imagem 8 - Caso o produto padrão não possua o preço informado no filtro, será apresentado uma falha. E caso tenha configurado o e-mail do destinatário, será enviado essa mensagem por email.
Imagem 9 - Como podemos ver foi enviado o e-mail com a informação da falha.
Imagem 10 - Também é possível executar o processo de forma automática, informando a frequência que será executado esse processo, o intervalo de início e fim que serão buscado os produtos e o intervalo de tempo entre as consultas, pois cada vez que for executado o processo será atualizado o intervalo de início e fim para consulta.