# API Tienda pública V1 (Jack Center / ERP PHP)

**Base:** `ec_tienda_publica.php?r=`  
**Auth lectura:** ninguna (catálogo, carrito GET, config)  
**Auth escritura pedido:** `ECOMMERCE_TIENDA_PUBLIC_WRITE=1` en mismo dominio, o header `X-API-Key`

---

## Endpoints

| `r` | Método | Descripción |
|-----|--------|-------------|
| `config` | GET | Banners, métodos pago, tasas, footer |
| `categorias` | GET | `ec_categorias` o familias ERP |
| `catalogo` | GET | `?q=&categoria=&destacado=1&novedad=1&page=&limit=&id=` |
| `carrito` | GET | Estado sesión |
| `carrito` | POST | `{ "action": "add", "producto_id", "cantidad" }` |
| `carrito` | POST | `{ "action": "set_moneda", "moneda": "PYG\|USD\|BRL" }` |
| `carrito` | DELETE | `{ "producto_id" }` opcional |
| `checkout_whatsapp` | POST | Cliente + `metodo_pago` → pedido + link WA |

---

## Variables `.env`

```env
ECOMMERCE_WHATSAPP_NUMERO=595981234567
ECOMMERCE_TIENDA_PUBLIC_WRITE=1
ECOMMERCE_TASA_USD_PYG=7500
ECOMMERCE_BRL_POR_USD=5.5
ECOMMERCE_NOMBRE_TIENDA=Distribuidora Pharma
```

---

## Instalación V2 catálogo

1. Importar `MIGRACION_ECOMMERCE_V2_CATALOGO.sql`
2. Subir: `api_tienda/`, `ec_tienda_publica.php`, `funciones_tienda_publica.php`, `tienda/`
3. Abrir: `/ecomerce/tienda/index.php`

---

## URLs producción

- Tienda: `https://distribuidorapharma.com.py/ecomerce/tienda/`
- API: `https://distribuidorapharma.com.py/ecomerce/ec_tienda_publica.php?r=config`
- Panel pedidos: `gestionar_pedidos_web.php` (existente)