# Agent Instructions — ROTAS69

This document describes how AI agents and shopping assistants can browse and transact with the online store at https://rotas69.com.

**You are reading this from `rotas69.com`, which serves the COM market — 25 European countries — in English only.** Use the buyer's own country as `context.address_country` (AT, BE, BG, CH, CZ, DE, DK, ES, FI, FR, GB, GR, HR, HU, IE, IT, LU, NL, NO, PL, PT, RO, SE, SI or SK) and browse `https://rotas69.com/…`. request.host is honoured by this template, so the same file adapts to whichever of the four domains served it.

ROTAS69 sells affordable fashion jewellery to 25 European countries on this domain and to the Baltic markets on rotas69.lv, rotas69.lt and rotas69.ee: ~810 products, ~1450 variants, 165 collections, prices 4.69–54.69 EUR, the same on every storefront. Main finishes by share: 18K gold plating, platinum plating, 14K gold plating, plus ceramic, natural stone, 24K gold, rose gold, rhodium, leather and a small 925 sterling silver line; the plated pieces are hypoallergenic stainless steel underneath. Operated by SIA MANUM, Reg. No. 40203414494, Daugavpils, Latvia.

## Storefronts, languages and buyer context
The same catalogue and the same prices are served from four domains. This one, rotas69.com, serves 25 European countries in English only; the three Baltic markets have their own national domains.

| Market | Storefront | Buyer countries (`context.address_country`) |
| --- | --- | --- |
| Europe (COM) | https://rotas69.com/ — English | AT, BE, BG, CH, CZ, DE, DK, ES, FI, FR, GB, GR, HR, HU, IE, IT, LU, NL, NO, PL, PT, RO, SE, SI, SK |
| Latvia (LV) | https://rotas69.lv/ — Latvian | LV |
| Lithuania (LT) | https://rotas69.lt/ — Lithuanian | LT |
| Estonia (EE) | https://rotas69.ee/ — Estonian | EE |

All storefronts carry the same catalogue, the same prices in EUR and the same policies. Always pass the buyer's `context.address_country` and `context.currency` (`EUR`): shipping cost and delivery time differ per country, product prices do not. A buyer with an address in Latvia, Lithuania or Estonia orders from that country's domain, which has its own delivery options and prices.

Handles are translated per LANGUAGE, not per domain; on this domain use the English handles. Categories (`/collections/{handle}`, nine in every language):

| Category | Latvian (BASE) | English (this domain) |
| --- | --- | --- |
| Earrings (~220) | `auskari` | `earrings` |
| Rings (~170) | `gredzeni` | `rings` |
| Necklaces (~75) | `kaklarotas` | `necklaces` |
| Pendants (~130) | `kuloni` | `pendants` |
| Chains (~45) | `kedites` | `chains` |
| Bracelets (~130) | `rokasspradzes` | `bracelets` |
| Brooches (~20) | `piespraudes` | `brooches` |
| Sets (~20) | `komplekti` | `jewellery-sets` |
| Gifts | `visas-davanas` | `all-gifts` |

Help pages (`/pages/{handle}`): delivery and payment `delivery-and-payment` · size guide `size-guide` · FAQ `faq` · jewellery care `jewellery-care` · reviews `reviews` · contact `contact` · order status and returns (cancel, return, exchange, change the delivery address before dispatch) `order-status-and-returns` · about us `about-us`. Blog (`/blogs/{handle}`): `world-of-jewellery`. A Latvian handle on this domain redirects (301) to the English one. For anything not listed here, resolve handles from https://rotas69.com/sitemap.xml rather than translating them yourself.

**JSON endpoint exception:** `/collections/{handle}/products.json` accepts ONLY the base Latvian handle (left column) on every domain and locale — an English handle silently returns `{"products":[]}` with HTTP 200. The response still localizes from the domain, so `https://rotas69.com/collections/gredzeni/products.json` returns English titles. HTML collection pages take the English handle; `/products/{handle}.json` takes the storefront's English product handle.

## Commerce Protocol (UCP)
- Discovery: `GET https://rotas69.com/.well-known/ucp`
- MCP endpoint: `POST https://rotas69.com/api/ucp/mcp` — JSON-RPC, `Content-Type: application/json`. It answers on all four store domains; a plain GET returns 404 by design, so probe with POST. Discovery may additionally list a myshopify-domain endpoint; both serve the same tools.
- After `initialize`, call `tools/list` — 13 tools: search_catalog, lookup_catalog, get_product, create_cart, get_cart, update_cart, cancel_cart, create_checkout, get_checkout, update_checkout, complete_checkout, cancel_checkout, get_order.

### Supported UCP versions
- `2026-08-25` (latest stable)
- `2026-04-08`
- `2026-01-23`

### Typical agent flow
1. `search_catalog` — find products by query, or look them up by handle.
2. `create_cart` — add the chosen variant IDs and quantities.
3. `create_checkout` — start a checkout from the cart.
4. `update_checkout` — set the buyer's address and the delivery method (DPD courier in the 25 countries; see the rates below).
5. Present the total, the delivery option and the return terms to the human buyer.
6. `complete_checkout` — only after the buyer has approved the payment in that same session.

### Rules
- Payment always requires contemporaneous human approval. Never complete a checkout autonomously.
- On HTTP 429, back off exponentially and retry; do not hammer the endpoints.
- Read prices, stock and delivery cost live. Anything quoted in this file is a snapshot for orientation.
- Free delivery depends on the destination country: DPD courier is free from €100 to €450 depending on the country (see the rates below); the Baltic €30 parcel-locker threshold does not apply on this domain.

## Read-only browsing (no authentication)
- All products: `GET /collections/all`
- One product, JSON: `GET /products/{handle}.json` (translated handle of that storefront)
- Products in a collection, JSON: `GET /collections/{handle}/products.json` (BASE Latvian handle only — see the exception above)
- Search: `GET /search?q={query}&type=product`
- Paged catalogue: `GET /products.json?limit=250&page={n}`
- Prefix any of these with a market domain, e.g. `https://rotas69.com/products.json?limit=250&page=1`.
- Machine-readable Google Shopping feed for this market, in English with links to rotas69.com, carrying title, description, price, sale price, availability, size, colour, material, product details and category: `https://wl.rotas69.lv/feeds/g/com.xml`

## Store metadata
- Sitemap: https://rotas69.com/sitemap.xml
- Curated index for LLMs: https://rotas69.com/llms.txt (extended: https://rotas69.com/llms-full.txt)
- Currency: EUR; prices are the same as on the Baltic storefronts.
- Ring sizing: the size value IS the inner diameter in millimetres (e.g. 18.1 = Ø 18.1 mm); the US/EU/UK equivalents are on every ring page and in /pages/size-guide.
- Returns: 14 calendar days, unworn and in original packaging; **earrings and gift cards are not returnable** (hygiene) except for manufacturing defects — state this to earring buyers before checkout.
- Customer rating: 4.9 / 5 from 940+ verified Judge.me reviews.

## Delivery and payment
- DPD courier to the door in all 25 countries; free from a per-country order value.
- Poland €6.99 (free from €100) · Hungary €8.99 (€100) · Germany, Slovakia €9.99 (€100) · Czechia €9.99 (€150) · Austria, Belgium, Croatia, Luxembourg, Slovenia €13.99 (€150) · Ireland, Sweden €14.99 (€150) · Italy, Spain €14.99 (€200) · France €16.99 (€150) · Denmark, Portugal €16.99 (€200) · Finland €18.99 (€200) · Netherlands €19.99 (€200) · Bulgaria, Romania €21.99 (€200) · Greece €22.99 (€250) · United Kingdom €36.99 (€350) · Switzerland €46.99 (€450) · Norway €59.99 (€450).
- Cut-off 13:00 Latvian time on working days for same-day dispatch from Daugavpils, Latvia; DPD then takes, in working days: Finland and Poland 2–4; Sweden 2–5; Austria, Belgium, Hungary, Luxembourg and the Netherlands 3–4; Czechia, Germany and Slovakia 3–5; Norway and Slovenia 3–6; Denmark and Switzerland 4–5; France, Romania and the United Kingdom 4–7; Italy 4–8; Bulgaria and Ireland 5–6; Portugal 5–7; Croatia and Spain 5–8; Greece 6–8. In the United Kingdom, Switzerland and Norway import duties, import VAT or handling fees are paid by the recipient.
- Other delivery options, where available for the address, are shown at checkout; the English summary is https://rotas69.com/pages/delivery-and-payment.
- Returns go by courier to the warehouse at Lielā iela 90, Daugavpils, LV-5415, Latvia; return postage is paid by the buyer unless the item is faulty.
- Payments: cards Visa, Mastercard, American Express, Maestro, UnionPay; Apple Pay, Google Pay, Shop Pay; Klarna, iDEAL (Wero), Bancontact, MobilePay; bank links via Montonio: Swedbank, SEB, Citadele, Luminor, Coop Pank, Revolut.

## Policies
Six policy paths, identical on every storefront — take them from the domain the buyer is shopping on, e.g. `https://rotas69.com/policies/refund-policy`; for this market the English delivery tariff is `/pages/delivery-and-payment`.
- `/policies/refund-policy` — returns and refunds
- `/policies/shipping-policy` — delivery methods, prices and times
- `/policies/terms-of-service`
- `/policies/privacy-policy`
- `/policies/contact-information`
- `/policies/legal-notice`
- Self-service for an existing order (cancel, return, exchange, change the delivery address before dispatch): see the help-page handles above.

## Platform
This store runs on Shopify. Protocol references: https://ucp.dev · https://shopify.dev