Requisição curl --request PUT \
--url 'https://api.hoteldaslojas.com.br/v1/pedidos/2178/rastreio' \
--header 'Authorization: Bearer <chave>' \
--header 'Content-Type: application/json' \
--data '{"codigo": "AA123456789BR"}'
const resposta = await fetch('https://api.hoteldaslojas.com.br/v1/pedidos/2178/rastreio', {
method: 'PUT',
headers: {
'Authorization': `Bearer ${process.env.HDL_CHAVE}`,
'Content-Type': 'application/json'
},
body: JSON.stringify({
"codigo": "AA123456789BR"
})
});
if (!resposta.ok) throw new Error((await resposta.json()).erro?.mensagem);
const { dados } = await resposta.json();
console.log(dados);
import os, requests
resposta = requests.put(
"https://api.hoteldaslojas.com.br/v1/pedidos/2178/rastreio",
headers={"Authorization": f"Bearer {os.environ['HDL_CHAVE']}"},
json={
"codigo": "AA123456789BR"
},
timeout=30,
)
resposta.raise_for_status()
print(resposta.json()["dados"])
<?php
$ch = curl_init('https://api.hoteldaslojas.com.br/v1/pedidos/2178/rastreio');
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => 'PUT',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . getenv('HDL_CHAVE'), 'Content-Type: application/json'],
CURLOPT_POSTFIELDS => json_encode([
'codigo' => 'AA123456789BR'
]),
]);
$resposta = json_decode(curl_exec($ch), true);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
print_r($resposta);
{
"dados": {
"id": 2178,
"criado_em": "2026-10-28T00:43:00-03:00",
"status": "cancelado",
"status_nome": "Cancelado",
"situacao_pagamento": "aprovado",
"situacao_entrega": "cancelada",
"cliente": {
"id": null,
"nome": "Cliente Lançamentos",
"email": "[email protected]",
"whatsapp": "11999990000",
"documento": ""
},
"valores": {
"subtotal": 59.9,
"desconto": 0.0,
"frete": 0.0,
"total": 59.9
},
"cupom": null,
"pagamento": {
"forma": "6",
"nome": "Pix",
"informacao": "",
"pago_em": "2026-10-28T00:44:12-03:00",
"link": null
},
"entrega": {
"forma": "retirada",
"nome": "Envio - retirada",
"codigo_rastreio": "AA123456789BR",
"endereco": {
"cep": "01001000",
"rua": "Rua Teste",
"numero": "10",
"complemento": "",
"bairro": "Centro",
"referencia": "",
"cidade": "Florianópolis",
"estado": "Santa Catarina"
}
},
"observacao": "Deixar na portaria",
"itens": [
{
"id": 769,
"produto_id": 2496,
"sku": "LIV-001",
"nome": "O Farol das Horas Quietas",
"variacao": "Edição: Brochura",
"quantidade": 1,
"preco_unitario": 59.9,
"total": 59.9,
"peso_kg": 0.4
}
],
"notas_internas": "[28/10/2026 00:44 · API] Nota fiscal 1234 emitida",
"historico": [
{
"status": "pago",
"origem": "api",
"detalhe": null,
"em": "2026-10-28T00:44:12-03:00"
},
{
"status": "aceito",
"origem": "api",
"detalhe": null,
"em": "2026-10-28T00:44:22-03:00"
},
{
"status": "info",
"origem": "api",
"detalhe": "separando no ERP",
"em": "2026-10-28T00:44:22-03:00"
},
{
"status": "info",
"origem": "api",
"detalhe": "Código de rastreio: AA123456789BR",
"em": "2026-10-28T00:44:23-03:00"
},
{
"status": "cancelado",
"origem": "api",
"detalhe": null,
"em": "2026-10-28T00:44:27-03:00"
}
]
}
}
{
"erro": {
"codigo": "chave_invalida",
"mensagem": "Chave da API inválida ou revogada.",
"request_id": "req_1b9c7d2e3f4a5b6c"
}
}
{
"erro": {
"codigo": "sem_permissao",
"mensagem": "Esta chave não tem o escopo \"pedidos.ler\". Crie uma chave com esse escopo no painel da loja (Integração › API).",
"request_id": "req_95f4a872c180063c"
}
}
{
"erro": {
"codigo": "nao_encontrado",
"mensagem": "Pedido não encontrado nesta loja.",
"request_id": "req_6b6e2da7f1bb1871"
}
}
{
"erro": {
"codigo": "validacao",
"mensagem": "Confira os campos enviados.",
"request_id": "req_b08d82d702d96001",
"campos": {
"nome": "Campo obrigatório."
}
}
}
