tray-configuracao-frete

Manage Tray shipping methods and ZIP-range pricing via authenticated API calls.

14|Updated Mar 21, 2026
One-click install
npx skills add https://github.com/tray-tecnologia/tray-api-claude-plugin --skill tray-configuracao-frete
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tray-configuracao-frete
Source: https://github.com/tray-tecnologia/tray-api-claude-plugin/tree/main/skills/configuracao-frete
Command: npx skills add https://github.com/tray-tecnologia/tray-api-claude-plugin --skill tray-configuracao-frete

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Centralizes the creation, update and removal of shipping methods and ZIP-code based pricing tables for Tray e-commerce stores, removing manual errors and ensuring consistent regional shipping rules and delivery estimates.

Core Features & Use Cases

  • Shipping method lifecycle: Create, update and delete shipping methods (gateway/custom) including activation, delivery time and free_shipping_value.
  • ZIP-range and weight-based pricing: Manage zipcode tables and weight ranges (ZipRange) with per-range price, delivery_time, and additional_price_per_kg.
  • Operational guidance and best practices: Avoid overlapping ZIP or weight ranges, test calculations with GET /shipping, and use access_token authentication for all calls.
  • Use case: Configure a regional carrier for São Paulo with multiple ZIP ranges and weight brackets to apply different prices and delivery times per region.

Quick Start

Create a shipping method named "Transportadora SP Interior" and add zipcode tables with weight ranges using the ShippingMethod and ZipRange JSON structures while including your access_token in each API request.

Frequently Asked Questions about tray-configuracao-frete

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I configure shipping methods with ZIP code ranges for my Tray e-commerce store?

Configuring shipping methods with ZIP code ranges for Tray involves creating ShippingMethod resources and adding ZipRange JSON payloads via authenticated API calls. You set per-region prices, delivery times, and weight brackets to establish regional delivery rules.

Can I set weight-based shipping rates and delivery times for specific postal zones?

Yes, you can set weight-based shipping rates and delivery times for specific postal zones using the ZipRange resource. It allows you to define per-range prices, delivery_time values, and additional_price_per_kg to calculate costs across different regions.

What's the best way to manage and update freight pricing tables for regional carriers?

The best way to manage freight pricing tables for regional carriers is centralizing CRUD operations through API JSON payloads. This removes manual errors and ensures consistent regional shipping rules, delivery estimates, and weight-based pricing updates across your store.

Do I need an access_token to create or delete custom shipping methods in Tray?

Yes, you need a valid access_token to create, update, or delete custom shipping methods in Tray. All API requests for ShippingMethod and ZipRange resources require this authentication parameter within the JSON payload to process successfully.

Why are my shipping rate calculations returning overlapping ZIP or weight range errors?

Shipping rate calculations return overlapping errors when ZIP or weight ranges intersect. Following operational best practices, you must ensure each ZipRange has distinct boundaries and test calculations using GET /shipping to verify correct regional pricing before deployment.