tray-status-pedido

Manage custom Tray order statuses via API endpoints.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Many Tray stores require custom order statuses to reflect unique fulfillment workflows, but configuring, listing, and maintaining those statuses through the API can be repetitive and error-prone for developers and store admins. This Skill centralizes the knowledge needed to reliably create, update, list, and remove custom order statuses while preserving platform constraints.

Core Features & Use Cases

  • List and Inspect Statuses: Retrieve all order statuses or a single status by ID to audit or display available states.
  • Manage Lifecycle: Create, update, and delete custom statuses including name, description, background_color, font_color, and type (open/closed/cancelled).
  • Integration Scenarios: Use when customizing storefront tracking, mapping statuses to fulfillment systems, or triggering workflows via the order webhook after status changes.

Quick Start

Create a new custom order status named Em Separação with background color #3498DB, font color #FFFFFF and type open.

Frequently Asked Questions about tray-status-pedido

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

FAQPage Schema
How do I create custom order statuses in Tray ecommerce stores?

Create custom order statuses in Tray by sending a POST request to the /orders/statuses endpoint with an access_token, specifying the name, type, and display colors for the fulfillment workflow.

What can I customize when managing order statuses through the Tray API?

When managing order statuses through the Tray API, you can customize the name, description, background_color, font_color, and type (open, closed, or cancelled) to map to your fulfillment workflows.

Can I delete an order status from my Tray store using the API?

Yes, you can delete an order status from your Tray store by sending a DELETE request to the /orders/statuses/:id endpoint with your access_token to remove custom statuses.

How do I list all available order statuses for a Tray store?

List all available order statuses for a Tray store by making a GET request to the /orders/statuses endpoint using your access_token query parameter for authentication.

Do I need an access_token to update order statuses in Tray?

Yes, you need an access_token query parameter to authenticate PUT requests to the /orders/statuses/:id endpoint when updating custom order statuses in Tray stores.

Why map custom order statuses to webhooks in Tray?

Map custom order statuses to webhooks in Tray to trigger automated fulfillment workflows and notify external integration systems immediately after an order status changes.