TOTVS Moda

Páginas filhas
  • 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 processoIntegração
Tipo de frequênciaIntervalo Minuto
Processo102 - Lexos atualizar estoque
IntervaloTempo de intervalo entre as execuções do processo
Data/hora inícioQualquer data e hora futura, a critério do usuário

Configuração

Valor

Tipo de processoIntegração
Tipo de frequênciaIntervalo Minuto
Processo104 - Lexos atualizar preço produto
IntervaloTempo de intervalo entre as execuções do processo
Data/hora inícioQualquer 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