tray-listas-preco-b2b

name	tray-listas-preco-b2b
description	API de Lista de Preço B2B da Tray. Utilize quando o desenvolvedor precisar gerenciar tabelas de preço diferenciadas para clientes B2B e atacado, incluindo criação de listas, gestão de valores por produto/variação.
when_to_use	Use quando o desenvolvedor mencionar: lista de preço B2B, tabela de preço, preço atacado, price_list, GET /price_lists, POST /price_lists, preço diferenciado, cliente B2B, preço por perfil ou preço para revendedor.
when_not_to_use	Não use para cupons de desconto por código (use tray-cupons). Use para preços diferenciados permanentes por grupo ou segmento de cliente.

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=listas-preco-b2b "<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 Lista de Preço B2B — Tray

Documentação oficial: https://developers.tray.com.br/#api-de-lista-de-preco-b2b

Endpoints de Listas de Preço

Método	Endpoint	Descrição
GET	/price-lists	Listar todas as listas de preço
GET	/price-lists/:id	Retorna uma lista de preço
POST	/price-lists	Criar lista de preço
PUT	/price-lists/:id	Atualizar lista de preço
DELETE	/price-lists/:id	Excluir lista de preço

Endpoints de Valores

Método	Endpoint	Descrição
GET	/price-lists/:id/values	Listar valores de uma lista
GET	/price-lists/:id/values/:value_id	Retorna um valor
POST	/price-lists/:id/values	Criar valor na lista
PUT	/price-lists/:id/values/:value_id	Atualizar valor
DELETE	/price-lists/:id/values/:value_id	Excluir valor

Autenticação: ?access_token={token}

Campos da Lista de Preço

Campo	Tipo	Descrição
name	string	Nome da lista de preço
description	string	Descrição
active	boolean	Se a lista está ativa
customer_group_id	number	ID do grupo de clientes associado

Campos do Valor

Campo	Tipo	Descrição
product_id	number	ID do produto
variant_id	number	ID da variação (opcional)
price	decimal	Preço diferenciado
cost_price	decimal	Preço de custo
active	boolean	Se o valor está ativo

Exemplo de Criação

{
  "PriceList": {
    "name": "Atacado Premium",
    "description": "Preços para clientes atacadistas",
    "active": 1
  }
}

Exemplo de Valor

{
  "PriceListValue": {
    "product_id": 123,
    "price": "79.90",
    "active": 1
  }
}

Paginação

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

Como Usar no Claude Code

Exemplos de Prompt

• "cria uma lista de preço Atacado Premium com preços específicos por produto"
• "adiciona o produto 123 com preço R$ 79,90 à lista de preço ID 5"
• "lista todas as listas de preço B2B disponíveis"
• "implementa preços diferenciados para clientes atacadistas"

O que o Claude faz

1. Gera o código de criação da lista com wrapper PriceList
2. Gera o código de adição de valores por produto com wrapper PriceListValue
3. Explica o fluxo: criar lista → adicionar valores → associar ao perfil de cliente
4. Orienta sobre a combinação com tray-perfis-cliente para segmentação B2B

O que você recebe

• Código de criação de lista de preço com nome e configuração
• Código de adição de valores por product_id e variant_id
• Fluxo completo de configuração B2B: lista → valores → perfil
• Orientação sobre associação com grupos de clientes

Pré-requisitos

• access_token configurado
• Produtos já cadastrados com product_id disponível
• Perfis de cliente configurados via tray-perfis-cliente (para associação)