DT Integração do TOTVS Moda com a plataforma Lexos

01. DADOS GERAIS

Produto:	TOTVS Moda
Linha de Produto:	Virtual Age
Segmento:	Varejo
Módulo:	Moda - Faturamento
Função:	Integração do TOTVS Moda com a plataforma Lexos.
País:	Brasil
Requisito/Story/Issue (informe o requisito relacionado) :	DVAARM-11065, DVAARM-11066, DVAARM-11068, DVAARM-11069, DVAARM-11128, DVAARM-10405

02. SITUAÇÃO/REQUISITO

Foi solicitada a possibilidade de realizar a integração do sistema TOTVS Moda com a plataforma Lexos, para que seja possível realizar o envio dos dados de produto do sistema TOTVS Moda para a Lexos.

03. SOLUÇÃO

Foram realizadas as seguintes implementações para atender a necessidade solicitada:

Criado o parâmetro empresa "DS_CONFIG_INT_LEXOS" onde deverá ser realizada toda a configuração para realizar a integração com a plataforma Lexos, através dos campos:
- DS_CHAVE → Onde deverá ser informada a chave de autenticação da plataforma integrada (obtido através da configuração de integração com a API Lexos dentro do hub da mesma);
- CD_TPCLASMARCA → Onde deverá ser informado o código do tipo de classificação para realizar a busca da marca do produto que será enviado;
- CD_TPCLASMODELO → Onde deverá ser informado o código do tipo de classificação para realizar a busca do modelo do produto que será enviado;
- CD_TIPODESCRICAO → Onde deverá ser informado o código do tipo de descritivo (deverá ser cadastrado através do componente PRDFM315 para o grupo de produto que será enviado);
- CD_TIPODESCMARKETPLACE → Onde deverá ser informado o código do tipo de descritivo para marketplace (deverá ser cadastrado através do componente PRDFM315 para o grupo de produto que será enviado);
- CD_TIPODESCRESUMIDA → Onde deverá ser informado o código do tipo de descrição resumida (cadastrado através do componente PRDFM315 para o grupo de produto que será enviado);
- DS_LST_PRECO → Onde deverá ser informada a lista de código de preços (separado por vírgula);
- CD_SALDO → Onde deverá ser informado o código do saldo do produto que será enviado para a integração com a plataforma;
- TP_ENVIOCOR → Onde deverá ser configurado como "1" para realizar o envio da cor auxiliar configurado ou "2" para enviar a descrição da cor auxiliar configurada, ressaltando que a cor auxiliar será obtida da empresa em que está sendo acessada o sistema;
- DT_INICIOBUSCARPEDIDO → Caso informado, o sistema irá realizar a busca dos pedidos a partir da data configurada;
- CD_REPRESENTANTE → Onde deverá ser informado o código do representante responsável pela importação dos pedidos;
- CD_OPERACAO → Onde deverá ser informado o código da operação para a importação dos pedidos;
- CD_OPERACAO_FULFILLMENT→ Código de operação para gravação de pedidos fullfillment;
- CD_CLAS_PEDIDO_FULFILLMENT→ Código do tipo e da classificação que será gravada nos pedidos fulfillment. Os demais pedidos não serão gravados esta classificação;
- DS_DEPARAPORTADOR→ Onde será relacionado nome do MarketPlace com um código de portador do tipo cartão de crédito. Caso não esteja configurado, a forma de pagamento do pedido ficará sem dados de portador;
- CD_CONDPGTO → Onde deverá ser informado o código da condição de pagamento para a realização da importação dos pedidos;
- CD_TIPODESCONTO → Onde deverá ser informado o código do tipo de desconto para realizar a importação dos pedidos;
- CD_MOTIVOCANCELARPEDIDO → Onde deverá ser informado o código do motivo para a realização do cancelamento do pedido antes do envio (motivo pode ser cadastrado através do componente PEDFL008) ;
- DS_DEPARAMARKETPLACE → Onde deverá ser informado o código do de para integração de marketplace na Lexos quando preciso, exemplo: informado o código de integração cadastrado na Lexos e separado por ";" o código da pessoa cadastrada no sistema responsável pelo marketplace, tendo a opção de cadastrar mais de um marketplace caso necessário, para isso basta colocar uma "/" entre as informações;
- DS_DEPARAVENDEDOR → Onde deverá configurar o de para da integração na Lexos x o vendedor no TOTVS Moda;
- NR_TEMPO → Define o tempo em minutos que será utilizado na busca de alterações de saldo e preço;
  - Observação: Importante ressaltar também que o tempo configurado no GERFP095 deve ser menor ou igual ao tempo configurado no parâmetro de integração demonstrado anteriormente, para evitar lacunas de tempo que possam causar a falta de atualização do estoque/preço do produto.
- IN_CONSIDERAPEDIDO → Determina se o estoque alocado em pedidos abertos deve ser considerado no cálculo do saldo disponível. Quando configurado como TRUE, o estoque em pedidos abertos será desconsiderado, considerando apenas o estoque disponível para comercialização;
- CD_TIPOEMAILPESSOA → Define o tipo de e-mail da pessoa que será importado no seu cadastro. Componente de manutenção é o PESFL018 . Obrigatório;
- CD_TIPOFONEPESSOA → Define o tipo de telefone da pessoa que será importado no seu cadastro. Componente de manutenção é o PESFL019. Obrigatório;
- IN_CONSIDERATRANSACAO → Determina se o estoque alocado em transações abertas deve ser considerado no cálculo do saldo disponível. Quando configurado como TRUE, o estoque em transações abertas será desconsiderado, considerando apenas o estoque disponível para comercialização;
- IN_FORMA_PGTO_VTEX → Define se busca a forma de pagamento da VTEX para o pedido de venda integrado no TOTVS Moda.

Foi desenvolvido o componente PRDFP213 (Envio/Atualização de Dados para Plataforma Lexos) e que tem como objetivo realizar o envio/atualização dos dados de produtos como por exemplo: o tipo de preço, o saldo ou atualizações das informações de produto em geral. Para esse componente foram desenvolvidas três restrições, onde caso exista um usuário configurado, o processo não poderá ser executado para os demais.
- São elas:
  - IN_ENVIAR_CADASTRO → Permitir o usuário realizar o envio do cadastro/atualização de produtos para a plataforma da Lexos;
  - IN_ENVIAR_ESTOQUE → Permitir enviar os dados de estoque de produtos para a plataforma da Lexos;
  - IN_ENVIAR_PRECO → Permitir o usuário enviar/atualizar os dados de preço de produtos para a plataforma da Lexos;
- É possível enviar o tipo de classificação e a classificação do produto, caso essas informações estejam vinculadas ao produto. Ambas serão enviadas junto com as demais informações para a plataforma Lexos.

Imagem 01 - Demonstra o componente ADMFM014, onde está sendo configurado o parâmetro empresa "DS_CONFIG_INT_LEXOS" para a empresa "001".

Imagem 02 - Ao acessar detalhadamente as informações do parâmetro citado anteriormente, é apresentado o componente GERFL135, onde está sendo configurada a lista de parâmetro com as informações necessárias para realizar o envio dos produtos para a plataforma da Lexos.

Imagem 03 - Demonstra o componente PRDFM319, onde pode ser observado que o grupo de produto "V001 001" possui os mesmos tipos de classificação de marca e modelo configurados no parâmetro demonstrado anteriormente.

Imagem 04 - Demonstra o componente PRDFM328, onde está sendo informado o grupo de produto "V001 001" que será utilizado como exemplo, onde podem ser observadas as informações referente ao produto e os descritivos que serão enviados junto a plataforma da Lexos.

Observação: Caso o produto possua peso informado no campo "Peso Web", o peso enviado para a plataforma da Lexos será o mesmo, caso contrário, será enviado o peso do configurado para o produto.
Observação²: O peso do produto na lexos é em gramas, desta forma, o valor a ser informado no peso web, deve ser de 1000 para ser 1kg. A altura, largura e profundidade são em centímetros, desta forma, necessário informar 100 para 1m.

Gif 01 - Pode ser observado acima através do componente PRDFP020, uma demonstração dos três tipos de preços que serão enviados para a Lexos, sendo eles: "A PRAZO (P1), A VISTA (P2) e PROMOCAO LEXOS".

Configuração do componente GERFP095 para integração automática de preços e estoque de produto

Gif 02 - Demonstração de como configurar os processos de atualização de estoque e preço de produto em background no componente GERFP095.

Configuração	Valor
Tipo de processo	Integração
Tipo de frequência	Intervalo Minuto
Processo	102 - Lexos atualizar estoque
Intervalo	Tempo de intervalo entre as execuções do processo
Data/hora início	Qualquer data e hora futura, a critério do usuário

Configuração	Valor
Tipo de processo	Integração
Tipo de frequência	Intervalo Minuto
Processo	104 - Lexos atualizar preço produto
Intervalo	Tempo de intervalo entre as execuções do processo
Data/hora início	Qualquer data e hora futura, a critério do usuário

Configuração	Valor
Tipo de processo	Integração
Tipo de frequência	Intervalo Minuto
Processo	101 - Lexos buscar lista de pedidos
Intervalo	Tempo de intervalo entre as execuções do processo - Recomendado tempo acima de 5 minutos para que não seja processo o mesmo pedido em caso de um tempo menor
Data/hora início	Qualquer data e hora futura, a critério do usuário

Configuração do componente PEDFM260 para funcionalidade de relacionamento do Canal de venda X Representante

Imagem 05 - Demonstração de configuração do parâmetro DS_LST_CANAL_REPRESENTANT, localizado no componente PEDFM260.

Imagem 06 - Demonstração da listagem de relacionamento canal X representante, localizado no componente PEDFM260.

Imagem 01 - Demonstra o componente PRDFP213, onde está sendo informado o grupo de produto "V001 001" em seguida realizada a consulta do mesmo e selecionado o tipo de processamento "Cadastro/atualização de produto". Na sequencia está sendo acionado o botão "Processar" e a mensagem informando que os dados foram enviados para a plataforma da Lexos corretamente é apresentada.

Observação: No cadastro do produto, será validado se o produto está inativo na empresa logada para envio do mesmo. Se estiver inativo um dos produtos do grupo, apenas os produtos ativos serão enviados para cadastro/atualização.

Observação: Caso esteja utilizando o filtro de classificação, ao processar será enviado apenas os produtos que tiverem a classificação escolhida no filtro.

Imagem 02 - Acima pode ser observado, o componente GERFP008, que é apresentado caso o grupo de produto informado, não contenha algumas informações ao realizar a busca para o envio das informações para a Lexos.

Imagem 03 - Ao consultar o catálogos de produtos através do hub da Lexos, pode ser observado que toda a grade do produto informado anteriormente, foi importada para a Lexos. Onde vale ressaltar que o tipo "Configurável" corresponde a nossa referencia e os tipos variação correspondem aos nossos sku's.

Imagem 04 - Ao verificar detalhadamente as informações referente ao produto "119280", podem ser observadas que as informações configuradas anteriormente para o grupo de produto foram importadas corretamente, como o peso, o comprimento, largura e altura.

Imagem 05 - Demonstra o componente ADMFM014, onde está sendo configurada a restrição "IN_ENVIAR_CADASTRO" para o usuário "777890", usuário esse que é diferente do que está acessando o sistema.

Imagem 06 - Ao tentar realizar o processamento do envio do cadastro/atualização de produtos, pelo fato do usuário que está acessando o sistema não se encontrar configurado na restrição, a mensagem acima é apresentada e o processo não é permitido seguir.

Processo de integração manual de preços

Imagem 01 - Demonstra o componente PRDFP213, onde está sendo informado o grupo de produto "V001 001", em seguida realizada a consulta do mesmo e selecionado o tipo de processamento "Preço". Na sequencia está sendo acionado o botão "Processar" e a mensagem informando que os dados foram enviados para a plataforma da Lexos corretamente é apresentada.

Observação: Caso não seja selecionado nenhum tipo de preço, ao realizar o envio das informações para a Lexos, serão enviados os preços configurados no parâmetro de integração demonstrado anteriormente. Vale ressaltar também que caso não existam os preços informados na Lexos, a plataforma irá criá-los a partir do momento em que o mesmo for enviado.

Imagem 02 - Ao consultar os preços referente ao produto "119280", pode ser observado que foram enviados corretamente para a plataforma.

Imagem 03 - Demonstra o componente ADMFM014, onde está sendo configurada a restrição "IN_ENVIAR_PRECO" para o usuário "777890", usuário esse que é diferente do que está acessando o sistema.

Imagem 04 - Ao tentar realizar o processamento do envio da atualização de preço, pelo fato do usuário que está acessando o sistema não se encontrar configurado na restrição, a mensagem acima é apresentada e o processo não é permitido seguir.

Processo de integração automática de preços

Imagem 05 - Demonstra o componente GERFP095, responsável por configurar os processos de preço e estoque dos produtos à serem atualizados no LexosHub. No campo de Resultado é possível observar o status do envio de carga, configurado para 10 (Dez) minutos.

Observação: Importante ressaltar também que o tempo configurado no GERFP095 deve ser menor ou igual ao tempo configurado no parâmetro de integração demonstrado anteriormente, para evitar lacunas de tempo que possam causar a falta de atualização do valor do produto.

Imagem 06 - Demonstra o componente INTFC010, responsável por exibir o log de comunicação, bem como o ciclo de envio para atualização de preços no LexosHub.

Gif 01 - Demonstração do processo de alteração de preço, seguido do envio de carga para a Lexos, atualizando o preço automaticamente.

Processo de integração manual de saldo de estoque

Imagem 04 - Demonstra o componente PRDFP213, onde está sendo informado o grupo de produto "V001 001", em seguida realizada a consulta do mesmo e selecionado o tipo de processamento "Estoque". Na sequencia está sendo acionado o botão "Processar" e a mensagem informando que os dados foram enviados para a plataforma da Lexos corretamente é apresentada.

Imagem 02 - Pode ser observado através da timeline do produto "119280", que o estoque foi adicionado corretamente após a realização do envio das informações.

Imagem 03 - Demonstra o componente ADMFM014, onde está sendo configurada a restrição "IN_ENVIAR_ESTOQUE" para o usuário "777890", usuário esse que é diferente do que está acessando o sistema.

Imagem 04 - Ao tentar realizar o processamento do envio da atualização de estoque, pelo fato do usuário que está acessando o sistema não se encontrar configurado na restrição, a mensagem acima é apresentada e o processo não é permitido seguir.

Processo de integração automática de saldo de estoque

Imagem 05 - Demonstra o componente GERFP095, responsável por configurar os processos de estoque e preço dos produtos à serem atualizados no LexosHub. No campo de Resultado é possível observar o status do envio de carga, configurado para 10 (Dez) minutos.

Observação: Importante ressaltar também que o tempo configurado no GERFP095 deve ser menor ou igual ao tempo configurado no parâmetro de integração demonstrado anteriormente, para evitar lacunas de tempo que possam causar a falta de atualização do estoque do produto.

Imagem 06 - Demonstra o componente INTFC010, responsável por exibir o log de comunicação do webservice, bem como o ciclo de envio para atualização de estoque no LexosHub.

Gif 01 - Demonstração do processo de venda e recebimento com geração de nota fiscal e movimentação de kardex, seguido do envio de carga para a Lexos, atualizando o estoque automaticamente.

04. ASSUNTOS RELACIONADOS

Para mais informações sobre a realização do processo venda, faturamento e devolução utilizando a plataforma da Lexos acessar o TDN: DT Realizar venda, faturamento e cancelamento com devolução para pedidos realizados pela integração com a Lexos

Páginas filhas