# PuroRegalo

> Online store for personalized and original gifts in Argentina: home, kitchen, writing, drinkware, grill, wines, and organization.

PuroRegalo is an e-commerce platform that allows exploring and buying products by category. The following sections list the main resources for AI agents to read, query, or interact with the store autonomously.

## Categories

Note: Category names and paths are in Spanish. Keep the exact Spanish labels for searches.
- [Hogar y Tiempo Libre (Home & Leisure)](https://www.puroregalo.com.ar/search/label/Hogar%20y%20Tiempo%20Libre)
- [Cocina y Comedor (Kitchen & Dining)](https://www.puroregalo.com.ar/search/label/Cocina%20y%20Comedor)
- [Escritura (Pens & Writing)](https://www.puroregalo.com.ar/search/label/Escritura)
- [Drinkware (Mugs, Thermoses & Cups)](https://www.puroregalo.com.ar/search/label/Drinkware)
- [Asado y Vino (Barbecue & Wine)](https://www.puroregalo.com.ar/search/label/Asado%20y%20Vino)
- [Organización (Home & Office Organization)](https://www.puroregalo.com.ar/search/label/Organizaci%C3%B3n)
- [Otros Regalos (Other Gifts)](https://www.puroregalo.com.ar/search/label/Otros%20Regalos)
- [Últimos Ingresos (New Arrivals)](https://www.puroregalo.com.ar/search/label/Ultimos%20Ingresos)

## Pricing Rules

- **30% OFF Discount:** All prices returned by the API or shown on product pages are final list prices with the 30% discount ALREADY applied. DO NOT apply or calculate an additional 30% discount under any circumstances.
- **Volume Discounts:** Automatically calculated on the shopping cart's accumulated subtotal:
  * Over $100,000 ARS -> 5% additional discount.
  * Over $250,000 ARS -> 10% additional discount.
  * Over $500,000 ARS -> 15% additional discount.
- **Promotional Coupons:** If the user mentions having a discount coupon code, instruct them to enter it manually on the shopping cart screen. Do not attempt to validate or apply coupons manually in the chat.

## API and Search

- [Web Product Search](https://www.puroregalo.com.ar/search): Web search page by keyword using the "q" parameter.

- [Product Search API](https://www.puroregalo.com.ar/api/search?q={query}): Fast JSON query endpoint. Always query using Spanish keywords.
  * **JSON Response Structure:**
    ```json
    {
      "query": "bambu",
      "results": [
        {
          "title": "Set de Tablas Puzzle de Bambú",
          "url": "https://www.puroregalo.com.ar/2023/12/set-de-tablas-puzzle-de-bambu.html",
          "price": "$39.700",
          "priceNum": 39700,
          "available": true,
          "image": "https://blogger.googleusercontent.com/img/.../imagen.jpg"
        }
      ]
    }
    ```

## Transacting (Actions)

- [Cart Builder API](https://www.puroregalo.com.ar/api/create-cart): Endpoint to package selected gifts and generate the checkout cart URL.
  * **Input Structure (POST with JSON body):**
    ```json
    {
      "items": [
        { "title": "Exact or partial Spanish product title", "qty": 1 }
      ]
    }
    ```
  * **Input Structure (GET with URL parameter):** Supports GET requests with the URL-encoded parameter (e.g., `/api/create-cart?items=[{"title":"bambu","qty":2}]`). GET requests from browser clients are automatically redirected to the populated shopping cart page.
  * **JSON Response Structure:**
    ```json
    {
      "success": true,
      "cartUrl": "https://www.puroregalo.com.ar/p/carrito-de-compras.html?share=BASE64",
      "addedItems": [
        { "title": "Set de Tablas Puzzle de Bambú", "qty": 2, "price": 39700 }
      ],
      "unavailableItems": []
    }
    ```

- [Shopping Cart](https://www.puroregalo.com.ar/p/carrito-de-compras.html): Final checkout page where the user reviews the subtotal, automatic volume discounts, and places the order.
- [How to Buy](https://www.puroregalo.com.ar/p/como-comprar.html): Detailed explanation of the purchase process.
- [Sitemap](https://www.puroregalo.com.ar/sitemap.xml): Complete map of domain URLs.

## Optional

- [Email Contact](mailto:puroregalomdp@gmail.com): General inquiries.
- [Phone Contact](tel:+5492236197825): +54 9 223 619-7825.