Integração de Fornecedores da Plataforma Marketplace LTM

Detalhes técnicos

LTM Marketplace

O LTM Marketplace é uma plataforma onde os participantes trocam pontos por produtos. Os participantes adquirem os pontos por meio de programas de fidelização gerenciados pelos clientes da plataforma.

É importante definir alguns conceitos:

  • Cliente : empresa que possui o programa de fidelização, e oferece pontos ao Participantes desses programas;

  • Participante : pessoa física ou jurídica que participa dos programas de fidelização oferecidos Clientes;

  • Fornecedor : Dono do produto, responsável por cumprir com a entrega do SKU.

  • SKU : Produto trocado pelos pontos do participante. O termo Stock Keeping Unit ( SKU ), ou Unidade de Manutenção de Estoque, está ligado à logística de armazém e designa os diferentes itens do estoque, estando normalmente associado a um código identificador.

SKU

SKUs podem ser entendidos como variações de um mesmo produto.

Considere um tênis, por exemplo, com duas possibilidades de cor, vermelho e branco, e duas possibilidades de tamanho, 40 e 41. Nesse exemplo, o mesmo ID de produto estaria relacionados a 4 variações, ou 4 SKUs:

  • Vermelho, Tamanho 40

  • Vermelho, Tamanho 41

  • Branco, Tamanho 40

  • Branco, Tamanho 41

Outro exemplo seria um eletrodoméstico disponível em duas possibilidades de voltagem, 127V e 220V.

1. Importação de produtos

A primeira etapa relacionada à integração entre o Marketplace e fornecedores parceiros é a importação de produtos. Possuímos um sistema de agendamento que, de acordo com o padrão configurado, consulta o endpoint de produtos do fornecedor e os importa para que sejam comercializados na plataforma.

As demais etapas são realizadas durante o processo de resgate de pontos na web.

2. Verificação de disponibilidade

Durante a operação de resgate de produtos, a plataforma Marketplace acessa os endpoints dos fornecedores parceiros, a fim de confirmar se o produto ainda está disponível e atualizar qualquer mudança de preço que não tenha sido importada.

3. Cálculo de Frete

Como a entrega do produto ao parceiro é de responsabilidade do fornecedor, esse é responsável por realizar o cálculo do frete. Sendo assim, o Marketplace consulta o valor do frete em um endpoint disponibilizado pelo fornecedor, que retorna o valor cobrado pelo frete e a data em que os itens serão entregues.

4. Fechamento de Pedido

Após o participante confirmar sua compra, já tendo sido informado sobre o preço atualizado do produto, valor de frete e prazo de entrega, o Marketplace fecha o pedido no endpoint do fornecedor, enviando todas as informações necessárias para que o pedido seja finalizado.

5. Rastreamento de pedidos

O participante, após finalizar seu resgate, pode retornar à plataforma e acessar o menu Meus Pedidos. Nesse local ele tem acesso aos dados de rastreabilidade de seus pedidos. 

Para obter esses dados de rastreabilidade, o Marketplace acessa um endpoint de rastreabilidade disponibilizado pelo fornecedor, que retorna o status do pedido e, se

possível, um link que permita rastrear a entrega do produto pela empresa responsável pelo transporte.

Fluxo de Processos Marketplace

Para entender o contexto de utilização das APIs de integração, é válido mencionar superficialmente as etapas relacionadas à integração entre um fornecedor e a plataforma Marketplace.

Detalhes técnicos de integrações

Detalhes técnicos