tray-carrinho-compras

Manage shopping carts and kits via the Tray API.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Provides a concise, developer-friendly interface to manage shopping cart lifecycle for Tray-powered stores, removing friction around creating, retrieving, updating, and deleting cart sessions and kit-based carts.

Core Features & Use Cases

  • CRUD for Carts: Create, read, update, and delete carts by session_id to support both anonymous and authenticated checkout flows.
  • Kit Support: Create carts composed of kits (bundled products) and manage multi-item kit contents in a single operation.
  • Complete Cart Views: Retrieve full cart details including products, variants, subtotal, shipping cost, and applied coupons for accurate checkout calculations.
  • Use Case: Build a storefront feature that persists session_id, updates quantities with stock validation, and shows a complete cart summary before checkout.

Quick Start

Create a cart for customer 456 with two units of product 789 variant 101 using the Tray API and an access_token.

Frequently Asked Questions about tray-carrinho-compras

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

FAQPage Schema
How do I manage shopping carts and kits via the Tray API?

Manage shopping carts and kits via the Tray API by performing CRUD operations on /carts and /carts/kit endpoints. You handle creation, retrieval, update, and deletion of cart sessions using an access_token and session_id for storefront workflows.

What does a complete cart view include when retrieved from a Tray ecommerce session?

A complete cart view retrieved from a Tray ecommerce session includes products, variants, subtotal, shipping cost, and applied coupons. This provides accurate checkout calculations for both storefront displays and backend order processing.

Can I create a cart composed of bundled product kits in Tray?

Yes, you can create carts composed of bundled product kits in Tray. The API supports kit-based carts, allowing you to manage multi-item kit contents in a single operation via the /carts/kit endpoint.

How do I authenticate Tray API requests for shopping cart operations?

Authenticate Tray API requests for shopping cart operations by passing an access_token as a query parameter. This token validates your permissions to perform GET, POST, PUT, and DELETE operations on cart and kit endpoints.

Does Tray API shopping cart management support both anonymous and authenticated checkout flows?

Yes, Tray API shopping cart management supports both anonymous and authenticated checkout flows. You can create, read, update, and delete carts by persisting a session_id, allowing flexible customer checkout experiences.

What is the best way to handle shopping cart lifecycle for a Tray-powered store?

The best way to handle the shopping cart lifecycle for a Tray-powered store is using API endpoints to manage cart sessions. Create carts, update quantities with stock validation, and retrieve full summaries before checkout to ensure accurate order processing.