tray-enderecos-cliente

Manage customer addresses via the Tray API with pagination and Brazilian validation.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Provides a clear, developer-oriented interface to manage customer addresses via the Tray API, removing uncertainty about endpoints, required fields, and Brazilian address validation rules.

Core Features & Use Cases

  • List and paginate addresses: Retrieve all addresses for a given customer with limit and page parameters.
  • Retrieve, create and delete: Get a single address by ID, create addresses with full Brazilian fields (CEP, UF, city, neighborhood), and delete addresses when needed.
  • Validation guidance: Enforce CEP numeric format and two-letter state codes, explain absence of PUT (update via delete + create), and show expected request/response payloads for integrations and migrations.

Quick Start

List all addresses for customer 50 using the Tray API with an access_token in the query string.

Frequently Asked Questions about tray-enderecos-cliente

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

FAQPage Schema
How do I manage customer addresses in the Tray ecommerce API?

You can manage customer addresses in the Tray ecommerce API by using endpoints that list, retrieve, create, and delete delivery and billing addresses. An OAuth access_token is required in the query string for authorization.

How do I list and paginate customer addresses using the Tray API?

List and paginate customer addresses using the Tray API by supplying limit and page parameters in your request. This retrieves all delivery and billing addresses associated with a specific customer ID.

What Brazilian address validation rules does the Tray API enforce for CEP and UF fields?

The Tray API enforces Brazilian address validation by requiring a strictly numeric CEP format and two-letter UF state codes. When creating addresses, you must also provide valid city and neighborhood fields.

Can I update an existing customer address using the Tray API?

You cannot directly update an existing customer address because the Tray API lacks a PUT endpoint. To modify an address, you must delete the existing record and then create a new address with the updated details.

Does the Tray API support syncing Brazilian addresses for data migration and checkout?

Yes, the Tray API supports syncing and validating Brazilian-style addresses during checkout, profile management, and data migration. It processes standard creation and deletion response codes to keep backend systems synchronized.