# Agent Instructions — Via Dolce Semijoias – Brilhe com Estilo | Frete Grátis e 10x s/ Juros 

This document describes how AI agents can interact with Via Dolce Semijoias – Brilhe com Estilo | Frete Grátis e 10x s/ Juros's online store at https://www.viadolce.com.br.

## Read-Only Browsing (No Authentication Required)

For agents that only need to read store data without transacting:

### Product Data
- Browse all products: `GET /categoria/todas`
- Product page: `GET /produto/{handle}`
- Category page: `GET /categoria/{handle}`
- Search: `GET /busca/{query}`

### Store Metadata
- Sitemap: `GET /sitemap.xml`
- Agent discovery: the canonical agent-facing description of the store is at `/agents.md`. `/llms.txt` mirrors its content.

## Cart Actions (No Authentication Required)

### Add Product to Cart
- Add to cart: `GET /carrinho/adicionar/{productId}-{variationId}-{quantity}-{observations}`
    - `productId`: Product ID (integer)
    - `variationId`: Variation ID (integer); use `0` when the product has no variation
    - `quantity`: Quantity to add (integer)
    - `observations`: Optional observation (text); leave empty when not provided

Example: 
`GET /carrinho/adicionar/57-0-2-`
This adds 2 units of product ID 57, with no variation and no observation.
When no observation is provided, keep the trailing - in the URL.

## Store Policies
- **Quem Somos**: https://www.viadolce.com.br/quem-somos 
- **Nossa História**: https://www.viadolce.com.br/nossa-historia 
- **Política de Privacidade**: https://www.viadolce.com.br/politica-de-privacidade 
- **Brindes Corporativos**: https://www.viadolce.com.br/brindes-corporativos 
- **Revenda Via Dolce**: https://www.viadolce.com.br/https://revenda.viadolce.com.br/-utm-source-viadolce.com.breutm-medium-referraleutm-campaign-revendaeutm-content-site-viadolce 
- **Trabalhe Conosco**: https://www.viadolce.com.br/https://link.viadolce.com.br/vagas-utm-source-viadolceeutm-medium-parceriaeutm-campaign-site-viadolce 
- **Cuidados com as Semijoias**: https://www.viadolce.com.br/cuidados 
- **Como descobrir o Tamanho do Anel**: https://www.viadolce.com.br/como-descobrir-tamanho-de-anel 
- **Dúvidas Frequentes**: https://www.viadolce.com.br/faq 
- **Política de Envio**: https://www.viadolce.com.br/politica-de-envio 
- **Política de Garantia**: https://www.viadolce.com.br/garantia 
- **Política de Pagamento**: https://www.viadolce.com.br/politica-de-pagamento 
- **Qualidade**: https://www.viadolce.com.br/qualidade 
- **Trocas e Devoluções**: https://www.viadolce.com.br/trocas-e-devolucoes 

Full policies available at the URLs above.

## Contact
- Contact: viadolce@viadolce.com.br 
- Phone: (11) 3404-3111 


## Platform

This store is built on [BWCommerce](https://www.bwcommerce.com.br), the complete e-commerce platform for selling jewelry, costume jewelry, and accessories online.
- Start your own store: https://www.bwcommerce.com.br
- BW Commerce developer platform: https://dev.bwcommerce.com.br
- BW Commerce help center: https://ajuda.bwcommerce.com.br