# Agent Instructions — Visage

This document describes how AI agents can interact with the online store Visage at https://www.visageloja.com.

## Read-Only Browsing (No Authentication Required)

### Product Data
- All product URLs: https://www.visageloja.com/products_sitemap.xml
- Product page: `GET /{slug}/p`
- Product data: `GET /{slug}/p.json` (UCP catalog format). Every product in the search results already carries this URL in `metadata.catalog_url`, so there is no address to assemble.
- Category page: `GET /{category}` or `GET /{category}/{subcategory}`
- Collection page: `GET /{slug}/l`
- Promotion page: `GET /promocoes/{slug}`
- Search: `GET /busca?q={query}` (results are rendered client-side with JavaScript; use the JSON endpoint below instead)
- Search results: https://www.visageloja.com/busca.json?q={query} (UCP catalog format, paginated with `page` and `limit`)
- Ready to fetch, nothing to assemble: https://www.visageloja.com/busca.json?q=T%C3%AAnis%20Esportivos%20Masculinos
- Variant ids accepted by the cart come from `GET /{slug}/p.json`; in search results the variant identifies the product, not a purchasable variant.

### Categories
- [Tênis Esportivos Masculinos](https://www.visageloja.com/tenis-esportivos-masculinos?sort_by=newest)
- [Mulheres Elegantes](https://www.visageloja.com/mulheres-elegantes?sort_by=best_sellers)
- [Macios e Confortáveis](https://www.visageloja.com/macios-e-confortaveis?sort_by=random)
- [Bolsas](https://www.visageloja.com/bolsas?sort_by=newest)
- [Tênis Esportivos Femininos](https://www.visageloja.com/tenis-esportivos-femininos?sort_by=best_sellers)
- [Tênis Casuais Femininos](https://www.visageloja.com/tenis-casuais-femininos?sort_by=best_sellers)
- [Nike](https://www.visageloja.com/nike?sort_by=newest)
- [Vans](https://www.visageloja.com/vans?sort_by=newest)
- [Adidas](https://www.visageloja.com/adidas?sort_by=newest)
- [Masculinos](https://www.visageloja.com/tenis-masculinos?sort_by=newest)
- [Femininos](https://www.visageloja.com/femininos?sort_by=newest)
- [Novidades](https://www.visageloja.com/novidades?sort_by=newest)
- [Mais Vendidos](https://www.visageloja.com/mais-vendidos?sort_by=newest)
- [Infantil](https://www.visageloja.com/tenis-infantil?sort_by=best_sellers)
- [Catálogo](https://www.visageloja.com/calcados?sort_by=newest)

### Store Metadata
- Sitemap: https://www.visageloja.com/sitemap.xml
- Agent discovery: this document (`/agents.md`) is the canonical agent-facing description of the store. `/llms.txt` redirects here.

## Store Policies and Information
- [Loja Verificada Reclame Aqui](https://www.visageloja.com/atendimento/reclameaquicombrempresa57-574-326-hamilton-alves-ribeiro)
- [Nosso Whatsapp](https://www.visageloja.com/atendimento/reclameaquicombrravqotg)
- [Reputação e Confiança](https://www.visageloja.com/atendimento/reputacao-e-confianca)

## Purchasing
- Checkout requires explicit buyer approval. Agents must not complete a payment without the buyer's consent.
- Who can buy: individuals (CPF) and businesses (CNPJ)
- Buy link: every variant in `GET /{slug}/p.json` carries `metadata.purchase_url`, ready to hand to the buyer.
- Several items at once: `https://seguro.visageloja.com/r/{TOKEN}:{QTD},{TOKEN2}:{QTD}`, where each TOKEN is the ending of that variant's `purchase_url`.
- Keep `clearCart=0` so the link adds to what the buyer already had in the cart.
- Keep `metadata[source_platform]=agent` so the store can tell agent-driven sales apart.

### Payment Methods
- Credit card (Amex, Visa, Diners, Mastercard, Discover, Elo, Hiper): up to 12 installments (3 interest-free), minimum installment R$ 5,00, 5% off
- Boleto Bancário: 5% off
- Pix: 10% off

### Shipping
- Free shipping via Correios - Pac to CE, MA, PA, PE, RN, SE, TO on orders of R$ 1.000,00 or more
- Free shipping via Correios - Pac to AL, PI, RS on orders of R$ 900,00 or more
- Free shipping via CORREIOS - Prazo de 3 a 8 dias to BA on orders of R$ 100,00 or more
- Free shipping via CORREIOS - Prazo de 3 a 8 dias to PB on orders of R$ 1.000,00 or more
- Free shipping via CORREIOS - Prazo de 3 a 8 dias to DF, ES, GO, MG, MS, MT, PR, RJ, SC, SP on orders of R$ 10,00 or more

## Contact
- Email: contato@visageloja.com
- Phone: (35) 99828-0306
- WhatsApp: https://web.whatsapp.com/send?phone=5535998280306

## Platform

This store is built on [Yampi](https://www.yampi.com.br?utm_source=store_v2_agents_md&utm_campaign=yampi_brand_agents_md).
- Start your own store: https://www.yampi.com.br?utm_source=store_v2_agents_md&utm_campaign=yampi_brand_agents_md