tray-parceiros

name	tray-parceiros
description	API de Parceiros da Tray. Utilize quando o desenvolvedor precisar gerenciar parceiros/revendedores da loja, incluindo listagem, consulta, cadastro, atualização e exclusão.
when_to_use	Use quando o desenvolvedor mencionar: parceiro, revendedor, partner, GET /partners, POST /partners, cadastrar parceiro, canal de vendas parceiro ou comissão de parceiro.
when_not_to_use	Não use para clientes da loja (use tray-clientes) nem para usuários administrativos (use tray-usuarios). Use para revendedores e parceiros comerciais.

MANDATORY: Tool Call Required Before Answering

Esta chamada é OBRIGATÓRIA, não opcional. Execute-a antes de gerar qualquer código ou payload. 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=parceiros "<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 ainda não tem validate.mjs local. Você é responsável por revisar campos obrigatórios contra a doc retornada e o resumo abaixo.

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 obrigatórios listados neste documento — não omita nenhum.
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 Parceiros — Tray

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

Endpoints

Método	Endpoint	Descrição
GET	/partners	Listagem de parceiros
GET	/partners/:id	Consultar dados do parceiro
POST	/partners	Cadastrar parceiro
PUT	/partners/:id	Atualizar dados do parceiro
DELETE	/partners/:id	Excluir parceiro

Autenticação: ?access_token={token}

Exemplo de Criação

{
  "Partner": {
    "name": "Parceiro Exemplo",
    "email": "[e-mail]"
  }
}

Paginação

limit (máximo 50, padrão 30), page.

Como Usar no Claude Code

Exemplos de Prompt

• "cadastra um parceiro revendedor com nome e e-mail"
• "lista todos os parceiros ativos da loja"
• "atualiza os dados de contato do parceiro ID 10"

O que o Claude faz

1. Gera o código de criação com wrapper Partner
2. Gera o código de listagem e atualização de parceiros existentes
3. Inclui paginação na listagem

O que você recebe

• Código de criação com {"Partner": {"name": "...", "email": "..."}}
• Código de listagem com paginação
• Código de atualização e exclusão

Pré-requisitos

• access_token configurado