Consultar rastreamento

Este guia usa a capacidade de rastreamento, relacionada ao Meu Rastreio, pela API REST do Meu Ecommerce.

Mantenha a chave no servidor

Configure MEUECOMMERCE_SECRET_KEY no ambiente do backend. Nunca utilize uma variável com prefixo público do framework para essa credencial.

// Execute somente no backend, em Node.js 22+.
export async function rastrear(codes) {
  const key = process.env.MEUECOMMERCE_SECRET_KEY;
  if (!key) throw new Error('Configure MEUECOMMERCE_SECRET_KEY no backend.');

  const response = await fetch('https://api.meuecommerce.com.br/v1/tracking', {
    method: 'POST',
    headers: {
      Authorization: `Bearer ${key}`,
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({ codes }),
    signal: AbortSignal.timeout(15000),
  });
  const data = await response.json();
  if (!response.ok) {
    throw new Error(data.error?.message ?? 'Não foi possível rastrear.');
  }
  return data.results;
}

Interprete cada resultado

• found indica se o objeto foi encontrado.
• delivered indica entrega concluída.
• events contém os eventos disponíveis.
• lastStatus, quando presente, descreve o status atual.
• message pode trazer informação sobre a consulta do objeto.

Um objeto recém-criado pode ainda não ter eventos. Não confunda esse cenário com entrega concluída. Respeite o timestamp retornado, sem atribuir um fuso que não esteja informado.

Proteja sua rota

Se sua aplicação expuser uma rota de rastreio para clientes, valide que eles podem consultar aquele pedido e aplique limites de uso. O endpoint não retorna uma página pronta: sua aplicação é responsável pela apresentação dos dados.

Referência de rastreamento