メニュー
API de Clientes da Tray. Utilize quando o desenvolvedor precisar gerenciar dados de clientes da loja: listagem, consulta, cadastro, atualização e exclusão. Inclui campos de pessoa física (CPF) e jurídica (CNPJ), validações brasileiras e gestão de newsletter.
Codex または Claude でインストール この Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。
| name | tray-clientes |
| description | API de Clientes da Tray. Utilize quando o desenvolvedor precisar gerenciar dados de clientes da loja: listagem, consulta, cadastro, atualização e exclusão. Inclui campos de pessoa física (CPF) e jurídica (CNPJ), validações brasileiras e gestão de newsletter. |
| when_to_use | Use quando o desenvolvedor mencionar: cliente, cadastrar cliente, atualizar cliente, CPF, CNPJ, pessoa física, pessoa jurídica, GET /customers, POST /customers, PUT /customers, endereço de cliente, validação de CPF, validação de CNPJ ou opt-in newsletter. |
| when_not_to_use | Não use para endereços do cliente (use tray-enderecos-cliente), perfis/grupos de clientes (use tray-perfis-cliente) nem para inscrições em newsletter (use tray-newsletter). |
Estas chamadas são OBRIGATÓRIAS, não opcionais. Execute-as antes de gerar qualquer código ou payload. Se você está respondendo sem ter chamado as duas ferramentas abaixo, pare e chame agora.
node skills/tray-dev/scripts/search_docs.mjs --topic=clientes "<termo da pergunta>"
<TOPIC_SLUG>: ver tabela em skills/tray-dev/SKILL.md.node skills/clientes/scripts/validate.mjs --schema=<SCHEMA_NAME> '<payload_json>'
cliente.create, cliente.update. Use --list-schemas para confirmar.0 válido · 1 inválido · 2 erro de uso.--json.Execute estas verificações antes de gerar qualquer payload ou código:
access_token não aparece como literal string no código gerado.when_not_to_use no frontmatter).Documentação oficial: https://developers.tray.com.br/#api-de-clientes
| Método | Endpoint | Descrição |
|---|---|---|
| GET | /customers | Listagem de clientes com paginação e filtros |
| GET | /customers/:id | Consultar dados do cliente por ID |
| POST | /customers | Cadastrar novo cliente |
| PUT | /customers/:id | Atualizar dados do cliente |
| DELETE | /customers/:id | Excluir cliente |
Autenticação: ?access_token={token}
| Campo | Tipo | Obrigatório (create) | Descrição |
|---|---|---|---|
name | string | Sim | Nome completo |
email | string | Sim | E-mail (único na plataforma) |
birth_date | date | Sim | Data de nascimento (YYYY-MM-DD) |
cpf | string | Não¹ | CPF (pessoa física) |
cnpj | string | Não¹ | CNPJ (pessoa jurídica) |
rg | string | Não | RG |
phone | string | Não | Telefone fixo |
cellphone | string | Não | Celular |
gender | string | Não | Gênero |
company_name | string | Não | Razão social (PJ) |
newsletter | number | Não | 0=não inscrito, 1=inscrito na newsletter |
created_at | datetime | — | Data de cadastro (retornado pela API) |
⚠️
birth_dateé obrigatório na criação (POST /customers). Omitir resulta em HTTP 400 — é a causa #1 de falha ao cadastrar cliente.¹
cpf(PF) oucnpj(PJ) conforme o tipo de cliente; informe o que corresponder à pessoa.
{
"Customer": {
"name": "João Silva",
"email": "joao@exemplo.com",
"birth_date": "1990-05-20",
"cpf": "12345678901",
"phone": "1133334444",
"cellphone": "11999998888",
"newsletter": 1
}
}
limit (máximo 50, padrão 30), page.
tray-enderecos-clientetray-perfis-clientenewsletter: 1 apenas com consentimentocustomer para receber notificações de alteraçõesCustomer e validação de CPF/CNPJemail, cpf, newsletter) para buscas específicas{"Customer": {...}} e campos obrigatóriosnewsletter)access_token configuradoAPI de Informações da Loja da Tray. Utilize quando o desenvolvedor precisar consultar dados de configuração da loja como nome, razão social, CNPJ, endereço, contatos, URLs (domínio) e status interno da loja.
API de Produtos da Tray. Utilize quando o desenvolvedor precisar listar, consultar, cadastrar, atualizar ou excluir produtos no catálogo de uma loja Tray. Inclui todos os campos do produto (nome, preço, estoque, EAN, NCM, dimensões, SEO), filtros de listagem, paginação, ordenação e exclusão de kits.
API completa de cupons de desconto da Tray (recurso `discount_coupons`). Cobre criar, editar, listar, consultar e excluir cupons (CRUD) e gerenciar os relacionamentos do cupom com clientes, produtos, categorias, marcas, fretes e cupom-presente, além da geração de cupom de troca a partir de um pedido. Total de 21 endpoints. DISAMBIGUATION: o endpoint base é `/discount_coupons` (NÃO `/coupons`) e o wrapper de payload/resposta é `DiscountCoupon` (NÃO `Coupon`). Cupom é desconto por CÓDIGO aplicado no checkout — não confundir com preço permanente por grupo de cliente (lista de preço B2B).
API de Endereços de Clientes da Tray. Utilize quando o desenvolvedor precisar gerenciar os endereços cadastrados dos clientes, incluindo listagem, consulta individual, criação e exclusão. Suporta endereços de entrega e cobrança, com campos completos do padrão brasileiro (CEP, bairro, cidade, estado, complemento).
API de Marcas da Tray. Utilize quando o desenvolvedor precisar gerenciar as marcas (fabricantes) dos produtos da loja, incluindo listagem, consulta individual, criação, atualização e exclusão. Inclui os campos da marca (brand, slug), paginação e filtros.
API de Newsletter da Tray. Utilize quando o desenvolvedor precisar gerenciar assinaturas de newsletter da loja, incluindo listagem de assinantes, inscrição e confirmação de cadastro.
SOC 職業分類に基づく
