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(s) Required Before Answering

- **OBRIGATÓRIO:** `node skills/tray-dev/scripts/search_docs.mjs "<termo>"` — confirme o comportamento da API antes de gerar código.

## 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

```json
{
  "Partner": {
    "name": "Parceiro Exemplo",
    "email": "parceiro@exemplo.com"
  }
}
```

## 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