Alterar a loja

Altera a configuração da loja. Só o que vier no corpo muda.

PATCH/v1/loja-hub

Corpo

Todos os campos são opcionais; envie só o que quer mudar. null limpa os textos opcionais.

Parâmetro	Tipo	Padrão	Descrição
`nome`	texto	—	Até 60 caracteres. Não pode ficar vazio.
`endereco`	texto	—	O trecho da URL: letras minúsculas, números e hífen. Precisa estar livre.
`chamada`	texto	—	Até 120 caracteres.
`sobre`	texto	—	Até 2000 caracteres.
`corDestaque`	texto	—	Cor em `#rrggbb`.
`ocultarNome`	booleano	—	Esconde o nome em texto no cabeçalho.
`preco.tipoAcrescimo`	texto	—	`PERCENTUAL` ou `FIXO`.
`preco.acrescimo`	dinheiro	—	Não negativo, com até 2 casas.
`preco.arredondar`	booleano	—	Arredonda o preço final para terminar em ,90.
`seo.titulo`	texto	—	Até 70 caracteres.
`seo.descricao`	texto	—	Até 160 caracteres.
`contexto.nicho · regiao · tomDeVoz`	texto	—	Até 80, 80 e 120 caracteres.
`freteNoSite`	booleano	—	Mostra o cálculo de frete na vitrine. Exige a conta SuperFrete conectada.

Exemplo

curl -X PATCH "https://api.otlshoes.com.br/v1/loja-hub" \
  -H "Authorization: Bearer otl_prod_SEU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "nome": "João Calçados",
  "preco": {
    "tipoAcrescimo": "PERCENTUAL",
    "acrescimo": "50.00",
    "arredondar": true
  }
}'

curl -X PATCH "https://api-sandbox.otlshoes.com.br/v1/loja-hub" \
  -H "Authorization: Bearer otl_sbx_SEU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "nome": "João Calçados",
  "preco": {
    "tipoAcrescimo": "PERCENTUAL",
    "acrescimo": "50.00",
    "arredondar": true
  }
}'

const resposta = await fetch('https://api.otlshoes.com.br/v1/loja-hub', {
  method: 'PATCH',
  headers: {
    Authorization: 'Bearer otl_prod_SEU_TOKEN',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "nome": "João Calçados",
    "preco": {
      "tipoAcrescimo": "PERCENTUAL",
      "acrescimo": "50.00",
      "arredondar": true
    }
  }),
});

if (!resposta.ok) {
  const { erro } = await resposta.json();
  throw new Error(`${erro.codigo}: ${erro.mensagem} (${erro.requestId})`);
}
const dados = await resposta.json();

const resposta = await fetch('https://api-sandbox.otlshoes.com.br/v1/loja-hub', {
  method: 'PATCH',
  headers: {
    Authorization: 'Bearer otl_sbx_SEU_TOKEN',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "nome": "João Calçados",
    "preco": {
      "tipoAcrescimo": "PERCENTUAL",
      "acrescimo": "50.00",
      "arredondar": true
    }
  }),
});

if (!resposta.ok) {
  const { erro } = await resposta.json();
  throw new Error(`${erro.codigo}: ${erro.mensagem} (${erro.requestId})`);
}
const dados = await resposta.json();

<?php
$ch = curl_init('https://api.otlshoes.com.br/v1/loja-hub');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'PATCH');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer otl_prod_SEU_TOKEN',
    'Content-Type: application/json',
]);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode([
    'nome' => 'João Calçados',
    'preco' => [
        'tipoAcrescimo' => 'PERCENTUAL',
        'acrescimo' => '50.00',
        'arredondar' => true,
    ],
]));

$corpo = json_decode(curl_exec($ch), true);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

if ($status >= 400) {
    throw new Exception($corpo['erro']['codigo'] . ': ' . $corpo['erro']['mensagem']);
}

<?php
$ch = curl_init('https://api-sandbox.otlshoes.com.br/v1/loja-hub');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'PATCH');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer otl_sbx_SEU_TOKEN',
    'Content-Type: application/json',
]);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode([
    'nome' => 'João Calçados',
    'preco' => [
        'tipoAcrescimo' => 'PERCENTUAL',
        'acrescimo' => '50.00',
        'arredondar' => true,
    ],
]));

$corpo = json_decode(curl_exec($ch), true);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

if ($status >= 400) {
    throw new Exception($corpo['erro']['codigo'] . ': ' . $corpo['erro']['mensagem']);
}

import requests

resposta = requests.patch(
    "https://api.otlshoes.com.br/v1/loja-hub",
    headers={
        "Authorization": "Bearer otl_prod_SEU_TOKEN",
    },
    json={
        "nome": "João Calçados",
        "preco": {
            "tipoAcrescimo": "PERCENTUAL",
            "acrescimo": "50.00",
            "arredondar": True
        }
    },
    timeout=30,
)

if not resposta.ok:
    erro = resposta.json()["erro"]
    raise RuntimeError(f'{erro["codigo"]}: {erro["mensagem"]} ({erro["requestId"]})')
dados = resposta.json()

import requests

resposta = requests.patch(
    "https://api-sandbox.otlshoes.com.br/v1/loja-hub",
    headers={
        "Authorization": "Bearer otl_sbx_SEU_TOKEN",
    },
    json={
        "nome": "João Calçados",
        "preco": {
            "tipoAcrescimo": "PERCENTUAL",
            "acrescimo": "50.00",
            "arredondar": True
        }
    },
    timeout=30,
)

if not resposta.ok:
    erro = resposta.json()["erro"]
    raise RuntimeError(f'{erro["codigo"]}: {erro["mensagem"]} ({erro["requestId"]})')
dados = resposta.json()

Testar agora no ambiente de testes

A chamada é feita de verdade, do seu navegador para a API de testes (https://api-sandbox.otlshoes.com.br/v1). Use um token otl_sbx_…: ele fica só nesta aba, e some ao fechá-la. Token de produção não é aceito aqui.

Token de testePATCHCorpo (JSON)

Resposta

200 OK, com a loja inteira, como em Ver a loja:

{
  "url": "https://hubshoes.com.br/joao-calcados",
  "endereco": "joao-calcados",
  "publicada": true,
  "nome": "João Calçados",
  "chamada": "Tênis originais com entrega para todo o Brasil",
  "sobre": "Loja de Canoas (RS), no ar desde 2021.",
  "logoUrl": "https://cdn.otlshoes.com.br/otl-catalog/hub/logos/joao.webp",
  "ocultarNome": false,
  "corDestaque": "#f97316",
  "preco": {
    "tipoAcrescimo": "PERCENTUAL",
    "acrescimo": "50.00",
    "arredondar": true
  },
  "modoSelecao": "MANUAL",
  "freteNoSite": true,
  "seo": {
    "titulo": "João Calçados — tênis originais",
    "descricao": "Tênis casuais e esportivos com envio para todo o Brasil."
  },
  "contexto": {
    "nicho": "tênis casual masculino",
    "regiao": "Grande Porto Alegre",
    "tomDeVoz": "direto e descontraído"
  },
  "publicacao": {
    "temWhatsapp": true,
    "temEndereco": true,
    "temProdutos": true,
    "podePublicar": true
  },
  "criadoEm": "2026-09-05T09:00:00-03:00",
  "atualizadoEm": "2026-09-28T16:20:00-03:00"
}

Regras que não se leem no JSON

Mudar o preco muda o preço de todos os produtos da vitrine na hora, e o precoAtual que a API devolve. Não dispara webhook de produto.
Mudar o endereco muda a URL pública. Links antigos deixam de funcionar.
O logo, os banners, a seleção de produtos e a aparência têm rotas próprias.

Erros possíveis

HTTP	`codigo`	Quando
400	`VALIDACAO`	Campo fora do formato, ou corpo sem nenhum campo conhecido
400	`REQUISICAO_INVALIDA`	Endereço em formato inválido ou reservado
400	`SUPERFRETE_NOT_CONNECTED`	`freteNoSite: true` sem conta SuperFrete conectada
409	`CONFLITO`	O endereço já é de outra loja
403	`LOJA_HUB_NAO_LIBERADA`	A OTL ainda não liberou a loja no HUB para este parceiro
403	`ESCOPO_INSUFICIENTE`	A integração não tem `loja-hub:escrever`