Nó Shopee

O nó de workflow Shopee é um cliente REST para a Shopee Open Platform API. Use-o para consultar pedidos, produtos e informações da loja da sua conta de vendedor Shopee.

Node ID no editor: shopee_request
URL padrão: GET https://partner.shopeemobile.com/api/v2/order/get_order_list

O que faz

• Envia requisições HTTP assinadas para Shopee Partner API v2
• Suporta GET, POST, PUT e DELETE
• Retorna HTTP status, data da resposta e headers da resposta
• Exige HMAC signature (sign) no request body junto com partner_id, shop_id e timestamp

Pré-requisitos

1. Conta Shopee Seller
2. Registro no Shopee Open Platform com:
   • partner_id
   • partner_key (para geração de signature)
   • shop_id (loja autorizada)
3. Integration keys em Configurações → API Keys:
   • shopee_partner_id
   • shopee_shop_id
   • shopee_partner_key — usado para calcular shopee_sign
   • shopee_sign — HMAC signature (frequentemente calculada em nó JavaScript antes do nó Shopee)

A Shopee exige request signature em toda chamada. Templates integrados incluem placeholders sign, timestamp, partner_id e shop_id — você deve fornecer valores válidos em runtime.

Como configurar

Passo 1 — Registrar no Shopee Open Platform

Crie app parceiro em Shopee Open Platform. Complete autorização da loja para obter shop_id.

Passo 2 — Definir credenciais

Adicione shopee_partner_id, shopee_shop_id e shopee_partner_key como integration keys.

Passo 3 — Gerar signature (obrigatório)

A Shopee assina requisições usando partner key + path + timestamp. Padrão típico:

1. JavaScript node — calcular shopee_sign e timestamp conforme documentação de autenticação Shopee
2. Armazenar resultados em workflow variables
3. Shopee node — usa {{shopee_sign}} e {{timestamp}} no body

Passo 4 — Configurar o nó

Templates de operação integrados

Exemplo de body para get order detail:

{
  "partner_id": {{shopee_partner_id}},
  "shop_id": {{shopee_shop_id}},
  "order_sn_list": ["{{trigger.body.order_sn}}"],
  "timestamp": {{timestamp}},
  "sign": "{{shopee_sign}}"
}

Shopee v2 frequentemente envia parâmetros no request body mesmo em endpoints estilo GET — siga templates integrados.

Passo 5 — Usar dados da resposta

Order SN: {{shopee_1.data.response.order_list[0].order_sn}}
Order status: {{shopee_1.data.response.order_list[0].order_status}}

Saídas do nó

Dicas e boas práticas

• Signature é obrigatória — workflows sem sign válido falham com erros de auth
• Use nó JavaScript para centralizar lógica de signature — reutilize em múltiplos nós Shopee
• timestamp deve ser Unix epoch seconds atual — timestamps antigos são rejeitados
• Configure Shopee push notifications para eventos de pedido; busque detalhes com este nó
• Teste no ambiente sandbox Shopee antes de credenciais de produção
• Shopee API retorna objeto response aninhado — inspecione logs de execução para caminhos

Exemplos de uso

Notificação de pedido enviado

1. Webhook — push de status de pedido Shopee
2. JavaScript — calcular sign + timestamp
3. Shopee GET — order detail
4. Send WhatsApp — atualização de envio ao comprador

Resumo diário de pedidos

1. Schedule — 18:00
2. JavaScript — assinar requisição
3. Shopee — get order list
4. Send message — resumo para equipe de operações

FAQ

Por que "Wrong sign" ou erros de auth?
Signature calculada incorretamente. Verifique partner key, ordem da base string e timestamp conforme docs Shopee. Use sandbox para debug.

Por que body é obrigatório em endpoints GET?
Convenção Shopee Partner API v2 — parâmetros vão no JSON body, não na query string.

Armazeno shopee_sign como integration key estática?
Não — sign muda a cada requisição. Calcule dinamicamente em nó JavaScript.

Posso pular o nó JavaScript?
Apenas se pré-calcular sign em outro lugar (serviço externo). A WhatsWave exige sign válido no momento da execução.

Referência da API

Relacionado

• Visão geral de E-commerce
• Nó JavaScript
• Webhook trigger