tray-produtos-vendidos

Queries product sales history and analytics from the Traceless API.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Provides a straightforward way to query historical product sales and basic analytics from a Tray store using the read-only products-sold API, removing manual aggregation of order data for reporting and dashboards.

Core Features & Use Cases

  • Read-only product sales queries: Access the GET /products-sold endpoint to retrieve sold items and associated metadata.
  • Filtering and pagination: Support for date-based filtering (created) and product-level filtering (product_id) with pagination (limit, page).
  • Use Cases: Generate top-selling product reports, build time-series product sales dashboards, and extract per-product sales history for analytics or exports.

Quick Start

Query the products-sold endpoint for the last 30 days to generate a ranked list of top-selling products including quantities and revenue.

Frequently Asked Questions about tray-produtos-vendidos

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

FAQPage Schema
How do I get product sales history from a Tray ecommerce store?

To get product sales history from a Tray ecommerce store, query the read-only GET /products-sold endpoint using your access_token. You can filter results by date and product_id, and use pagination parameters to retrieve the full dataset.

What is the best way to build a top-selling products report for Tray?

The best way to build a top-selling products report for Tray is to query the products-sold endpoint with date filters. This retrieves sold item metadata including quantities and revenue, enabling you to generate a ranked top-selling product list.

Does the Tray products-sold API support pagination for large sales datasets?

Yes, the Tray products-sold API supports pagination for large sales datasets. You can use the limit and page query parameters alongside date and product_id filters to retrieve sales data in manageable chunks.

Can I filter Tray sales analytics queries by a specific product_id?

Yes, you can filter Tray sales analytics queries by a specific product_id. The GET /products-sold endpoint accepts product_id and date parameters, allowing you to extract per-product historical sales data for targeted reporting.

Do I need an access_token to query Tray product sales data?

Yes, you need an access_token to query Tray product sales data. The GET /products-sold endpoint requires a valid access_token query parameter to authenticate and authorize read-only access to your store's sales history.

What are the limitations of using read-only product sales queries for Tray reporting?

The main limitation of using read-only product sales queries for Tray reporting is that data cannot be modified or aggregated server-side. You must handle data aggregation, dashboard generation, and export formatting on the client side after retrieval.