Tag Pixel e GPC

A documentação aborda os sistemas Tag Pixel e GPC (Gerenciamento de Pontos e Cashback), utilizados para gerenciar a jornada de compra e a confirmação de venda no clube da Magalu. O Tag Pixel é opcional, e o GPC é obrigatório.

Tag Pixel: É a primeira API acionada após a realização de um pedido. Seu objetivo é notificar o parceiro em tempo real sobre a intenção de compra, gerando uma pendência de crédito. As transações são enviadas por pedido.

GPC: É utilizado exclusivamente para a confirmação de pedidos, que ocorre quando a venda é faturada ou o prazo de entrega é atingido. O sistema envia transações unitárias (por produto, não por pedido) para que a pontuação/cashback seja entregue ao cliente de forma mais rápida, devido à política de logística que permite faturamentos e entregas separados.

O objetivo principal é gerenciar todo o ciclo de vida da transação em canais de clube de benefícios (exceto clubes de descontos).

Tag Pixel: Permitir o envio da intenção de compra em tempo real. A plataforma permite configurar de forma personalizada o payload de envio para os parceiros.

GPC: Permitir as configurações para o envio de pontos e/ou cashback de pedidos confirmados. O sistema foi projetado para não depender do controle de status do parceiro e utiliza regras específicas para avaliar a confirmação do pedido (7 dias após a data da entrega, ou 30 a 60 dias após a data do faturamento).

Para realizar a integração de ambos os sistemas, é necessário seguir passos de configurações e definições junto ao parceiro.

Escolha do Método de Integração (Apenas GPC): O parceiro deve escolher entre API ou SFTP para o GPC.

Abertura de Chamado: É necessário abrir um chamado com a equipe de tecnologia para definir o tipo de integração e seguir o fluxo.

Configuração de Ambiente e Documentação: O parceiro deve fornecer a documentação de implementação/consumo dos endpoints da API (para Tag Pixel e GPC, se for a opção escolhida). Deve ser disponibilizado um ambiente de teste, sendo responsabilidade do parceiro separar os pedidos/arquivos de teste caso opte por usar o mesmo ambiente de produção. Pode ser necessária a liberação dos IPs do Magalu no ambiente do parceiro para evitar bloqueios.

Definição de Layout/Payload: O parceiro deve definir junto à equipe técnica o layout do payload de transação (para Tag Pixel) ou do arquivo/payload (para GPC), escolhendo os campos que irão compor a estrutura.

Validação: Após a configuração das informações providas pelo parceiro, é enviado um pedido/arquivo de teste para validação.

Mudança para Produção: Uma vez que as informações estejam em conformidade, é necessária a confirmação das informações de produção dos endpoints ou do servidor SFTP para realizar a mudança da configuração.