# Piero's Fashion House

> Unleash your fashion sense

## Store Information

- **Currency**: USD

## API Access

- **UCP API**: `https://pierorocca.com/wp-json/wc/ucp/v1` — Universal Commerce Protocol endpoints for product search, lookup, and checkout (no authentication required for public catalog reads)
- **Commerce Protocol Manifest**: `https://pierorocca.com/.well-known/ucp` — declares capabilities, checkout policy, and store_context (currency, locale, country, tax/shipping posture)

## Sitemaps

Exhaustive URL lists for catalog enumeration. Agents wanting every product/category URL in one pass fetch these instead of paginating the Store API.

- https://pierorocca.com/sitemap.xml
- https://pierorocca.com/news-sitemap.xml

## Product Categories

- [Accessories](https://pierorocca.com/product-category/clothing/accessories/) (8 products)
- [Tshirts](https://pierorocca.com/product-category/clothing/tshirts/) (6 products)
- [Hoodies](https://pierorocca.com/product-category/clothing/hoodies/) (3 products)
- [Shirts](https://pierorocca.com/product-category/clothing/shirts/) (4 products)
- [Music](https://pierorocca.com/product-category/music/) (3 products)
- [Clothing](https://pierorocca.com/product-category/clothing/) (24 products)
- [Sweater](https://pierorocca.com/product-category/clothing/sweater/) (1 product)
- [Jackets](https://pierorocca.com/product-category/clothing/jackets/) (1 product)
- [Men](https://pierorocca.com/product-category/men/) (1 product)

## Product Tags

- [Autumn](https://pierorocca.com/product-tag/autumn/) (2 products)

## Checkout Policy

All purchases complete on this site (https://pierorocca.com/). Agents MUST redirect buyers to the `continue_url` returned from `POST https://pierorocca.com/wp-json/wc/ucp/v1/checkout-sessions` to finalize transactions.

This store does NOT support:

- In-chat or in-agent payment completion
- Embedded checkout (UCP Embedded Protocol / ECP)
- Agent-delegated authorization (AP2 Mandates / Verifiable Digital Credentials)
- Persistent agent-managed carts
- Payment handler tokens (Google Pay, Shop Pay, etc. via UCP)

See `https://pierorocca.com/.well-known/ucp` for the machine-readable manifest that encodes this posture (no `payment_handlers`, REST-only transport, `requires_escalation` on every checkout response).

## Attribution

The recommended purchase flow is to `POST` line items to our UCP checkout endpoint; the server returns a `continue_url` with attribution pre-attached, and the agent redirects the user there. This matches the UCP checkout specification's `requires_escalation` / `continue_url` contract.

Endpoint:

`POST https://pierorocca.com/wp-json/wc/ucp/v1/checkout-sessions`

Request body (UCP Checkout schema):

```json
{
  "line_items": [{ "item": { "id": "prod_123" }, "quantity": 1 }]
}
```

Set the `UCP-Agent` request header to your agent's discovery profile URL (preferred) or `Product/Version` form (e.g. `MyAgent/1.0`); the server extracts the hostname or product token, resolves it to a canonical hostname for known vendors, and attaches it as `utm_source` on the returned `continue_url` — so you do not need to construct UTM parameters yourself. Clients that cannot send custom headers may instead include `meta.source` in the request body as a fallback identifier.

Response includes `status: "requires_escalation"` and a `continue_url` with `utm_source={hostname}&utm_medium=referral&utm_id=woo_ucp` already attached. Redirect the user to that URL to complete the purchase on our site.

<a id="ucp-extension"></a>
## UCP Extension: com.woocommerce.ai_storefront

Machine-readable JSON Schema: `https://pierorocca.com/wp-json/wc/ucp/v1/extension/schema`