Introdução

Esta documentação visa auxiliar os parceiros a disponibilizarem rotas de suas APIs para realização de integração com Marketplace através do fluxo de operações::

  1. Será realizada a importação do catálogo de produtos do parceiro;

  2. Os produtos ficam disponíveis para adicionar ao carrinho de compras;

  3. Para adicionar ao carrinho será verificada a disponibilidade do produto e consulta de opções e valores de frete;

  4. Para realizar o pedido será feita a consulta das opções de pagamento e a consulta das opções de parcelamento com base na opção de pagamento;

  5. Finalização do pedido informando forma de envio (opção de frete), forma de pagamento e parcelamento, dados do cliente (pessoa física ou jurídica) e do endereço de entrega.

  6. Pedido é finalizado pela API e parceiro recebe o número do pedido gerado para consultas futuras;

  7. Após finalização do pedido pode ser realizada a consulta de Tracking para acompanhamento da entrega do pedido;

Autenticação

Hubs

Para o caso de Hubs, ou seja, endpoints através dos quais se pode acessar informações de diferentes fornecedores, é necessário que se adicione aos requests uma informação que permita filtrar os dados por fornecedor, pois a plataforma Marketplace trata fornecedores do Hub de forma independente.

Por exemplo, se o endpoint http://endpoint.domain.com/products permite obter o catálogo dos fornecedores A, B e C, é necessário que exista uma rota que permita a filtragem por fornecedor, por exemplo http://endpoint.domain.com/products?supplier=A 

Uma vez que esses endpoints estejam implementados, a equipe de integração da LTM deve ser acionada, e desenvolverá um conector baseado nas especificidades dos endpoints criados.