# Agent Instructions — 21st Century This document describes how AI agents can interact with the online store 21st Century at https://www.21century.com.br. ## Read-Only Browsing (No Authentication Required) ### Product Data - All product URLs: https://www.21century.com.br/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.21century.com.br/busca.json?q={query} (UCP catalog format, paginated with `page` and `limit`) - Ready to fetch, nothing to assemble: https://www.21century.com.br/busca.json?q=In%C3%ADcio - 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 - [Início](https://www.21century.com.br/inicio) - [Tecnologia Inteligente](https://www.21century.com.br/tecnologia-inteligente?sort_by=best_sellers) - [Smartwatch e Wearables](https://www.21century.com.br/tecnologia-inteligente/smartwatch-wearables?sort_by=best_sellers) - [Acessórios para Celular](https://www.21century.com.br/tecnologia-inteligente/acessorios-celular?sort_by=best_sellers) - [Carregadores e Energia](https://www.21century.com.br/tecnologia-inteligente/carregadores-energia?sort_by=best_sellers) - [Gadgets Tecnológicos](https://www.21century.com.br/tecnologia-inteligente/gadgets-tecnologicos?sort_by=best_sellers) - [Suportes e Organização Tech](https://www.21century.com.br/tecnologia-inteligente/organizacao-tech?sort_by=best_sellers) - [Casa Inteligente](https://www.21century.com.br/casa-inteligente?sort_by=best_sellers) - [Automação Residencial](https://www.21century.com.br/casa-inteligente/automacao-residencial?sort_by=best_sellers) - [Iluminação Inteligente](https://www.21century.com.br/casa-inteligente/iluminacao-inteligente?sort_by=best_sellers) - [Limpeza Inteligente](https://www.21century.com.br/casa-inteligente/limpeza-inteligente?sort_by=best_sellers) - [Segurança Residencial](https://www.21century.com.br/casa-inteligente/seguranca-residencial?sort_by=best_sellers) - [Organização da Casa](https://www.21century.com.br/casa-inteligente/organizacao-casa?sort_by=best_sellers) - [Brinquedos Inteligentes](https://www.21century.com.br/brinquedos-inteligentes?sort_by=best_sellers) - [Brinquedos Educativos](https://www.21century.com.br/brinquedos-inteligentes/brinquedos-educativos?sort_by=best_sellers) - [Brinquedos Tecnológicos](https://www.21century.com.br/brinquedos-inteligentes/brinquedos-tecnologicos?sort_by=best_sellers) - [Construção e Criatividade](https://www.21century.com.br/brinquedos-inteligentes/brinquedos-construcao?sort_by=best_sellers) - [Brinquedos Montessori](https://www.21century.com.br/brinquedos-inteligentes/brinquedos-montessori?sort_by=best_sellers) - [Primeira Infância](https://www.21century.com.br/brinquedos-inteligentes/primeira-infancia?sort_by=best_sellers) - [Cozinha Moderna](https://www.21century.com.br/cozinha-moderna?sort_by=best_sellers) - [Eletroportáteis](https://www.21century.com.br/cozinha-moderna/eletroportateis?sort_by=best_sellers) - [Utensílios Inteligentes](https://www.21century.com.br/cozinha-moderna/utensilios-inteligentes?sort_by=best_sellers) - [Organização de Cozinha](https://www.21century.com.br/cozinha-moderna/organizacao-cozinha?sort_by=best_sellers) - [Preparação de Alimentos](https://www.21century.com.br/cozinha-moderna/preparo-alimentos?sort_by=best_sellers) - [Estilo & Bem-Estar](https://www.21century.com.br/estilo-bem-estar?sort_by=best_sellers) - [Relaxamento](https://www.21century.com.br/estilo-bem-estar/relaxamento?sort_by=best_sellers) - [Massageadores](https://www.21century.com.br/estilo-bem-estar/massageadores?sort_by=best_sellers) - [Aromaterapia](https://www.21century.com.br/estilo-bem-estar/aromaterapia?sort_by=best_sellers) - [Saúde e Bem-Estar](https://www.21century.com.br/estilo-bem-estar/saude-bem-estar?sort_by=best_sellers) - [Ofertas](https://www.21century.com.br/ofertas?sort_by=best_sellers) ### Store Metadata - Sitemap: https://www.21century.com.br/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 - [21st Century Blog](https://www.21century.com.br/atendimento/21st-century-blog) - [Avaliações de produtos](https://www.21century.com.br/atendimento/ver-avaliacoes-de-produtos) - [Perguntas Frequentes](https://www.21century.com.br/atendimento/perguntas-frequentes) - [Politica de Frete](https://www.21century.com.br/atendimento/politica-de-frete) - [Politica de Privacidade](https://www.21century.com.br/atendimento/politica-de-privacidade) - [Política de Reembolso](https://www.21century.com.br/atendimento/politica-de-reembolso) - [Quem somos?](https://www.21century.com.br/atendimento/quem-somos) - [Rastreio](https://www.21century.com.br/atendimento/rastreio) - [Termos de Serviço](https://www.21century.com.br/atendimento/termos-de-servico) ## Purchasing - Checkout requires explicit buyer approval. Agents must not complete a payment without the buyer's consent. - Who can buy: individuals (CPF) only - 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.21century.com.br/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 - Boleto Bancário - Credit card (Amex, Visa, Diners, Mastercard, Discover, Aura, Elo, Hiper): up to 12 interest-free installments, minimum installment R$ 5,00 - Pix - Pix Parcelado: 5% off ## Contact - Email: imports@21century.com.br - Phone: (11) 93298-5618 - WhatsApp: https://web.whatsapp.com/send?phone=5511932985618 ## 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