From tray-api
Manages the complete Tray order lifecycle: list, filter, create, update, cancel orders and manage products within orders.
How this skill is triggered — by the user, by Claude, or both
Slash command
/tray-api:pedidosWhen to use
Use quando o desenvolvedor mencionar: pedido, order, status de pedido, cancelar pedido, atualizar pedido, GET /orders, POST /orders, ciclo de vida do pedido, fluxo de compra ou rastrear pedido.
The summary Claude sees in its skill listing — used to decide when to auto-load this skill
- **OBRIGATÓRIO:** `node skills/tray-dev/scripts/search_docs.mjs "<termo>"` — confirme o comportamento da API antes de gerar código.
node skills/tray-dev/scripts/search_docs.mjs "<termo>" — confirme o comportamento da API antes de gerar código.node skills/pedidos/scripts/validate.mjs '<payload_json>' — valide a estrutura do payload antes de retornar código ao usuário.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).node skills/pedidos/scripts/validate.mjs '<payload_json>'
para confirmar a estrutura do payload que vai gerar. O validador checa
apenas estrutura (campos obrigatórios, tipos e campos desconhecidos),
nunca valores reais — então monte um payload sintético com placeholders
sempre que os valores vierem de variáveis de ambiente, da entrada do
usuário ou de outras chamadas. Exemplo:
node skills/pedidos/scripts/validate.mjs '{"Order":{"client_id":"<id>"}}'.
Corrija todos os erros antes de retornar o código ao usuário. Até 3
tentativas — se persistir, explique o problema ao usuário.Documentação oficial: https://developers.tray.com.br/#apis-de-pedidos
| Método | Endpoint | Descrição |
|---|---|---|
| GET | /orders | Listagem de pedidos com paginação e filtros |
| GET | /orders/:id | Dados do pedido por ID |
| GET | /orders/:id/full | Dados completos (produtos, cliente, pagamento, frete) |
| POST | /orders | Cadastrar novo pedido |
| PUT | /orders/:id | Atualizar dados do pedido |
| PUT | /orders/:id/cancel | Cancelar pedido |
| POST | /orders/:id/products | Incluir produtos no pedido |
| DELETE | /orders/:id/products/:product_id | Excluir produto do pedido |
Autenticação: ?access_token={token}
| Campo | Tipo | Descrição |
|---|---|---|
id | number | ID do pedido |
store_id | number | ID da loja |
status_id | number | ID do status atual |
client_id | number | ID do cliente |
adm_user | string | Usuário administrativo |
total_amount | decimal | Valor total do pedido |
shipping_cost | decimal | Custo do frete |
shipping_method | string | Método de envio |
tracking_number | string | Código de rastreamento |
payment_method | string | Método de pagamento |
coupon_code | string | Código do cupom aplicado |
discount | decimal | Valor do desconto |
taxes | decimal | Impostos |
created_at | datetime | Data de criação |
updated_at | datetime | Data de atualização |
O endpoint GET /orders/:id/full retorna dados completos incluindo:
| Filtro | Descrição |
|---|---|
status | Filtrar por status do pedido |
created_at | Filtrar por data de criação |
updated_at | Filtrar por data de atualização |
customer_id | Filtrar por cliente |
payment_method | Filtrar por método de pagamento |
Para cancelar um pedido, use PUT /orders/:id/cancel. O cancelamento atualiza o status e pode disparar webhooks.
POST /orders/:id/products — adiciona produtos ao pedido existenteDELETE /orders/:id/products/:product_id — remove produto do pedidolimit (máximo 50, padrão 30), page.
Criação → Aguardando Pagamento → Pago → Em Separação → Enviado → Entregue
↘ Cancelado
/orders/:id/full — para obter todos os dados em uma única chamadaorder para receber notificações em tempo realtracking_number quando o pedido for enviado/orders/:id/full para consultas completas e /orders/:id para dados básicos/orders/:id/full com os dados completos do pedidoPUT /orders/:id/cancelaccess_token configuradoorder_id disponível para operações em pedidos específicosnpx claudepluginhub tray-tecnologia/tray-api-ai-plugin --plugin tray-apiProvides CDSS development patterns for drug interaction checking, dose validation, clinical scoring (NEWS2, qSOFA), and alert classification integrated into EMR workflows.