Tray Informacoes Loja

MANDATORY: Tool Call Required Before Answering

Esta chamada é OBRIGATÓRIA, não opcional. Execute-a antes de gerar qualquer código de consulta. Se você está respondendo sem ter chamado a ferramenta abaixo, pare e chame agora.

Buscar documentação atualizada (sempre)

node skills/tray-dev/scripts/search_docs.mjs --topic=informacoes-loja "<termo da pergunta>"

• <TOPIC_SLUG>: ver tabela em skills/tray-dev/SKILL.md.
• Use os trechos retornados como fonte primária; este SKILL.md é resumo.

Nota: este recurso é só de leitura (apenas endpoints GET) — não há payload para validar. Foque em parâmetros de query.

Antes de responder

Execute estas verificações antes de gerar qualquer payload ou código:

1. Confirme o método HTTP e endpoint correto para a operação solicitada.
2. Identifique os campos retornados listados neste documento — não invente campos.
3. Verifique que access_token não aparece como literal string no código gerado.
4. Confirme que esta é a skill correta para o recurso (leia when_not_to_use no frontmatter).

API de Informações da Loja — Tray

Documentação oficial: https://developers.tray.com.br/#apis-de-informacoes-da-loja

Endpoints

Autenticação: ?access_token={token} como query parameter para a resposta completa.

Não existe endpoint /store. O endpoint correto é GET /info (com barra final opcional: /info/).

Formato da Resposta

A resposta é um objeto JSON flat (sem wrapper de recurso — não vem envolta em {"Store": {...}}).

Dados Retornados (autenticado)

Não há campo de plano/pacote. A API GET /info não retorna dados de plano contratado — não existem campos plan, plan_id, plan_name nem group/grupo de plano na resposta. Se precisar do plano da loja, obtenha por outro canal (painel de parceiros / contrato), não por esta API.

Dados Retornados (consulta pública, sem token)

Exemplo de Resposta (autenticado)

{
  "id": "123",
  "name": "Nome da Loja",
  "company_name": "Razão Social da Loja LTDA",
  "cnpj": "00.000.000/0000-00",
  "address": "Endereço da loja, 123",
  "postal_code": "04001-001",
  "city": "São Paulo",
  "state": "SP",
  "country": "Brasil",
  "phone_number_1": "(11)3333-0000",
  "phone_number_2": "(11)99999-0000",
  "phone_number_3": "",
  "email_1": "emailda@loja.com.br",
  "email_2": "",
  "office_hour": "",
  "uri": "http://loja.commercesuite.com.br",
  "secure_uri": "https://loja.commercesuite.com.br",
  "logo": {
    "http": "http://images.tcdn.com.br/img/img_prod/123/123_logotipo.png",
    "https": "https://images.tcdn.com.br/img/img_prod/123/123_logotipo.png"
  },
  "logo_mobile": {
    "http": "http://images.tcdn.com.br/img/arquivos/123/themed/img/123_logotipo-mobile.png",
    "https": "https://images.tcdn.com.br/img/arquivos/123/themed/img/123_logotipo-mobile.png"
  },
  "user": "",
  "internal_status": "ativa",
  "favicon": {
    "http": "http://images.tcdn.com.br/img/img_prod/123/123_favicon.ico",
    "https": "https://images.tcdn.com.br/img/img_prod/123/123_favicona.ico"
  },
  "messages": {
    "footer": "Mensagem do rodapé da loja."
  }
}

Exemplo de Chamada

# NÃO-VERIFICADO contra sandbox — validar antes do merge.
# Requer TRAY_ACCESS_TOKEN e TRAY_API_ADDRESS no ambiente.
curl -s "https://${TRAY_API_ADDRESS}/info/?access_token=${TRAY_ACCESS_TOKEN}"

Uso Recomendado

Este endpoint é ideal para:

1. Primeira chamada de teste — após obter o access_token, use GET /info para validar que a autenticação funcionou
2. Dados de configuração — obter informações da loja para configurar sua integração
3. Verificação de status — confirmar internal_status da loja antes de realizar operações

Como Usar no Claude Code

Exemplos de Prompt

• "valida se minha autenticação com a Tray está funcionando"
• "consulta os dados da loja para configurar minha integração"
• "verifica o status interno da loja"
• "pega nome, CNPJ e domínio da loja"

O que o Claude faz

1. Gera o código para GET /info?access_token={token} (token como query param)
2. Extrai os campos relevantes da resposta flat (sem wrapper Store)
3. Inclui verificação de internal_status antes de prosseguir com operações

O que você recebe

• Código de consulta de dados da loja via GET /info
• Verificação de internal_status
• Extração dos dados de configuração necessários para a integração

Pré-requisitos

• access_token configurado (use tray-autorizacao primeiro)