From tray-api
Manages Tray API for shipping methods and CEP range tables: create, update, delete custom freight rules by region, weight ranges, prices, and delivery times.
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-configuracao-de-forma-de-frete
| Método | Endpoint | Descrição |
|---|---|---|
| POST | /shippings/method/gateway | Cadastrar forma de envio com integração externa |
| PUT | /shippings/method/gateway/:id | Atualizar forma de envio |
| DELETE | /shippings/method/gateway/:id | Excluir forma de envio |
| Método | Endpoint | Descrição |
|---|---|---|
| POST | /shippings/method/zipcode_table | Cadastrar tabela de CEP |
| PUT | /shippings/method/zipcode_table/:id | Atualizar tabela de CEP |
| DELETE | /shippings/method/zipcode_table/:id | Excluir tabela de CEP |
Autenticação: ?access_token={token} em todas as chamadas.
| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
id | number | — | ID do método de envio (retornado pela API) |
name | string | Sim | Nome do método (ex: "PAC", "SEDEX", "Motoboy") |
active | number | Não | 1 = ativo, 0 = inativo |
type | string | Não | Tipo do método (ex: "correios", "custom", "gateway") |
delivery_time | number | Não | Prazo padrão de entrega em dias úteis |
additional_delivery_time | number | Não | Dias adicionais ao prazo de entrega |
free_shipping_value | decimal | Não | Valor mínimo do pedido para frete grátis |
| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
id | number | — | ID da faixa de CEP (retornado pela API) |
zip_start | string | Sim | CEP inicial da faixa (ex: "01000000") |
zip_end | string | Sim | CEP final da faixa (ex: "09999999") |
weight_start | number | Sim | Peso inicial da faixa em gramas |
weight_end | number | Sim | Peso final da faixa em gramas |
price | decimal | Sim | Valor do frete para esta faixa |
delivery_time | number | Não | Prazo de entrega em dias úteis para esta faixa |
additional_price_per_kg | decimal | Não | Valor adicional por kg excedente |
{
"ShippingMethod": {
"name": "Transportadora Regional",
"active": 1,
"type": "custom",
"delivery_time": 5,
"additional_delivery_time": 2,
"free_shipping_value": "299.90"
}
}
{
"ShippingMethod": {
"name": "Transportadora Regional - Atualizado",
"active": 1,
"delivery_time": 4
}
}
{
"ZipRange": {
"zip_start": "01000000",
"zip_end": "09999999",
"weight_start": 0,
"weight_end": 5000,
"price": "15.90",
"delivery_time": 5,
"additional_price_per_kg": "2.50"
}
}
{
"ZipRange": {
"price": "18.90",
"delivery_time": 4
}
}
| Operação | Código | Mensagem |
|---|---|---|
| Criação | 201 | {"message": "Created", "id": 10, "code": 201} |
| Atualização | 200 | {"message": "Saved", "id": 10, "code": 200} |
| Exclusão | 200 | {"message": "Deleted", "id": 10, "code": 200} |
POST /shippings/method/gateway com nome e configurações geraisPOST /shippings/method/zipcode_tableactive esteja como 1Método: "Transportadora SP Interior"
├── Faixa CEP: 13000000 - 13999999 (Campinas)
│ ├── 0g - 5000g → R$ 12,90 (3 dias)
│ └── 5001g - 30000g → R$ 25,90 (4 dias)
├── Faixa CEP: 14000000 - 14999999 (Ribeirão Preto)
│ ├── 0g - 5000g → R$ 18,90 (5 dias)
│ └── 5001g - 30000g → R$ 35,90 (6 dias)
GET /shipping) para validar que o cálculo retorna resultados corretosfree_shipping_value para incentivar pedidos de maior valoradditional_delivery_time para incluir tempo de manuseio/embalagemtray-frete (GET /shippings/cotation/) para calcular frete e o skill tray-multicd para configuração de múltiplos centros de distribuiçãoShippingMethod e ZipRange corretosPOST /shippings/method/gatewayaccess_token configurado