From tray-api
Calculates Tray freight costs by destination CEP using product IDs, prices, quantities; lists available shipping methods via API endpoints.
npx claudepluginhub tray-tecnologia/tray-api-ai-plugin --plugin tray-apiThis skill uses the workspace's default tool permissions.
> Execute estas verificações antes de gerar qualquer payload ou código:
Monitors deployed URLs for regressions after deploys, merges, or upgrades by checking HTTP status, console errors, network failures, performance (LCP/CLS/INP), content, and API health.
Share bugs, ideas, or general feedback.
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-integracao-de-frete
| Método | Endpoint | Descrição |
|---|---|---|
| GET | /shippings/cotation/ | Calcular frete para um ou mais produtos por CEP |
| GET | /shippings/ | Listar formas de envio disponíveis na loja |
Autenticação: ?access_token={token} em todas as chamadas.
/shippings/cotation/)| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
zipcode | string | Sim | CEP de destino (apenas números, ex: "04001001") |
products[n][product_id] | number | Sim | ID do produto (índice n começa em 0) |
products[n][price] | decimal | Sim | Preço do produto |
products[n][quantity] | number | Sim | Quantidade do produto |
A rota aceita múltiplos produtos na mesma requisição usando índices
products[0],products[1], etc.
GET /shippings/cotation/?access_token={token}&zipcode=04001001&products[0][product_id]=123&products[0][price]=58.90&products[0][quantity]=2
{
"Shipping": [
{
"id": "1",
"name": "PAC",
"price": "25.90",
"delivery_time": "8",
"delivery_time_text": "8 dias úteis"
},
{
"id": "2",
"name": "SEDEX",
"price": "45.50",
"delivery_time": "3",
"delivery_time_text": "3 dias úteis"
}
]
}
| Campo | Tipo | Descrição |
|---|---|---|
id | number | ID do método de envio |
name | string | Nome do método (ex: "PAC", "SEDEX", "Transportadora") |
price | decimal | Valor do frete em reais |
delivery_time | number | Prazo de entrega em dias úteis |
delivery_time_text | string | Texto formatado do prazo de entrega |
{
"ShippingMethods": [
{
"ShippingMethod": {
"id": "1",
"name": "PAC",
"active": "1"
}
},
{
"ShippingMethod": {
"id": "2",
"name": "SEDEX",
"active": "1"
}
},
{
"ShippingMethod": {
"id": "3",
"name": "Retirada na Loja",
"active": "1"
}
}
]
}
A Tray suporta integração com gateways de frete como o Frete-X API para cotação automática com múltiplas transportadoras.
A configuração do gateway de frete é feita no painel administrativo da Tray ou via API de Configuração de Frete (consulte o skill tray-configuracao-frete).
free_shipping: 1 podem retornar frete zerado dependendo da configuração da lojatray-configuracao-frete (/shippings/method/gateway, /shippings/method/zipcode_table) para gerenciar métodos de envio e tabelas de CEPGET /shippings/cotation/ com os parâmetros indexadosproducts[0], products[1]... para múltiplos produtosGET /shippings/access_token configuradoproduct_id e price dos produtos disponíveis