Mapeamento de Webhook de Cumprimento e Sincronização de Rastreamento - Salp

Mapeamento de Webhook de Cumprimento e Sincronização de Rastreamento

Diretrizes completas de payload para mapear números de rastreamento, códigos de transportadora e atualizações de cumprimento multi-armazém para o Saleor.

Última atualização: 3 de junho de 2026

O parâmetro 'warehouseId' é obrigatório em todos os webhooks de ingestão para prevenir bloqueios na sincronização do status do pedido.

Fluxo de Trabalho de Sincronização de Cumprimento

Quando você cumpre um pedido dentro do seu sistema de e-commerce principal (por exemplo, Lightspeed, Shopify), um webhook de cumprimento é acionado e capturado por nossas threads de trabalho em segundo plano. O número de rastreamento e o código da transportadora devem ser mapeados perfeitamente para garantir que o cliente final receba notificações oportunas e precisas.

Cada marca parceira recebe um ID de armazém principal durante o onboarding. Se estiver cumprindo a partir de múltiplos nós, certifique-se de que o warehouseId passado no payload corresponda a um dos seus perfis ativos.

json

{
  "orderId": "ORD-772910-EU",
  "warehouseId": "wh-amsterdam-primary",
  "fulfillment": {
    "trackingNumber": "1Z999AA10123456784",
    "carrier": "DHL_EXPRESS",
    "shippedItems": [
      {
        "sku": "ELEC-SKU-990",
        "quantity": 1
      }
    ]
  }
}

Suportamos códigos padrão: DHL_EXPRESS, POST_NL, DPD, UPS e FEDEX. O uso de um código não suportado recorrerá ao rastreamento geral.

Uma vez que o payload do webhook é analisado, o portal gera uma URL de rastreamento e atualiza automaticamente o status do pedido na loja do cliente. Isso aciona um e-mail de confirmação de envio localizado.