Uma parte crucial da integração de pedidos vindo de marketplaces para uma loja VTEX é o mapeamento dos métodos de entrega de cada pedido, que garante que a estratégia de envio correta será utilizada para o envio. Diferentes marketplaces tem diferentes regras e métodos para que este mapeamento seja feito e este tópico visa explicar como ele é feito para integrações com o marketplace Magazine Luiza (Magalu) e como garantir que não ocorram erros.
A principal forma com a qual a integração mapeia o método de entrega para pedidos vindos da Magalu é atráves do Tipo de Envio, que é uma característica de qualquer política de envio. Então, no exemplo abaixo, pedidos criados na Magalu que tiverem como meio de entrega o método “Normal” serão associados, na VTEX, à Transportadora 1; enquanto isso, pedidos com meio de entrega “Expressa” serão associados à Transportadora 2:
Porém, este mapeamento é feito com o nome do tipo de envio, então caso não exista nenhum equivalente dentro do modo de logística para o método definido na Magalu, o pedido não será integrado. No exemplo abaixo temos um pedido que foi processado com erro no bridge da loja porque o método de entrega na Magalu foi definido como “Convencional” sem haver um Tipo de Envio com este nome:
Levando em conta estes cenários, a integração VTEX-Magalu permite o uso da ferramenta “Mapeamento de SLA Customizável”, na qual o lojista pode associar os meios de entrega da Magalu como sinônimos de determinados Tipos de Envio na VTEX. Para acessar esta ferramenta, precisamos abrir a sessão “Marketplaces e integrações” no admin e editarmos a integração com a Magalu:
No campo de Mapeamento de SLA Customizável, preenchemos o campo “De” com o nome do meio de entrega enviado pela Magalu (neste caso, “Convencional”) e o campo “Para” com o Tipo de Envio desejado (neste caso, “Expressa”). Após clicar no botão +, o resultado será esse:
Ao preencher estes campos, leve em conta que o mapeamento é sensível a letras maiúsculas e minúsculas, assim como a caractéres especiais. Para que o mapeamento funcione, os valores preenchidos devem ser exatamente iguais àqueles definidos dos dois lados.
Depois disso, podemos salvar esta alteração e verificar o resultado final:
É importante ressaltar que este processo só precisa ser feito se o método enviado pela Magalu não tiver um equivalente entre os Tipos de Envio da loja ou se o objetivo for utilizar um método de envio específico. Também é importante confirmar que o mapeamento está sendo preenchido com o Tipo de Envio e não com outra informação, como por exemplo o nome da Estratégia de Envio.
Este processo deve ser feito mesmo em entregas do tipo FOB dentro da Magalu já que, para que a integração funcione, sempre é necessário o uso de um método de entrega válido dentro da VTEX para que o estoque e frete sejam validados.
Por fim, se a integração está com pedidos processados com erro como o exemplo acima, após a configuração de mapeamento recomendamos um reprocessamento manual destes pedidos.
Eduardo Luciano
Field Software Engineer | VTEX