> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cucu.bo/llms.txt
> Use this file to discover all available pages before exploring further.

# Ambientes

> Sandbox y producción: diferencias, requisitos para producción y cómo cambiar de ambiente.

Dos ambientes aislados con los mismos endpoints, validaciones y formato de respuesta. Cambian solo la URL base y la API Key.

| | Sandbox | Producción |
| - | - | - |
| **URL base** | `https://sandbox.cucu.bo` | `https://api.cucu.bo` |
| **API Key** | `sk_test_...` | `sk_live_...` |
| **SIAT** | Piloto (ambiente `2`) | Producción (ambiente `1`) |
| **Validez fiscal** | No | Sí, reportadas al SIN |
| **Certificado digital** | Demo preconfigurado | Emitido por el SIN, lo cargás vos |
| **NIT emisor** | NIT demo | NIT real de tu empresa |
| **Datos y base** | Aislados | Aislados |
| **PDF** | Marca de agua "SIN VALOR LEGAL" (también en notas) | Sin marca |
| **Correos** | Se envían (para probar el flujo) | Se envían al cliente real |
| **Anulaciones** | Sin consecuencia fiscal | Irreversibles ante el SIN |
| **Costo** | Incluido en tu plan | Según plan |
| **Rate limit** | Relajado | Según plan |

> [!WARNING]
>
> En producción cada factura es un registro fiscal permanente: solo se anula (con motivo del catálogo), nunca se borra.

## Cambiar de ambiente

Leé URL base y key desde variables de entorno; el código no cambia:

```bash theme={"system"}
# .env.development
CUCU_BASE_URL=https://sandbox.cucu.bo
CUCU_API_KEY=sk_test_...

# .env.production
CUCU_BASE_URL=https://api.cucu.bo
CUCU_API_KEY=sk_live_...
```

En MCP es lo mismo: URL `/mcp` y header `X-API-Key` ([producción y doble ambiente](https://docs.cucu.bo/mcp/advanced.md)).

## Requisitos para producción

1. **NIT activo** en el SIN, habilitado para facturación electrónica.
2. **Certificado digital** del SIN (`.p12`, vigencia 1 año; se renueva antes del vencimiento). Se obtiene en [impuestos.gob.bo](https://impuestos.gob.bo).
3. **Sistema registrado en el SIAT**: CUCU se registra como tu sistema delegado.
4. **Token de delegación** del SIN que autoriza a CUCU a emitir por tu empresa; se configura en tu cuenta.
5. **CUIS y CUFD**: se generan solos una vez registrado el sistema y cargado el certificado.
6. **Plan de producción** activo ([precios](https://docs.cucu.bo/pricing)).

Con los requisitos del SIN listos, la activación toma 1-2 días hábiles; el certificado del SIN suele tardar 3-5 días. Onboarding con el equipo: **[api@cucu.bo](mailto:api@cucu.bo)**.

## SIAT Piloto

* Puede tener mantenimientos sin aviso: ante `503` o código `99999` en sandbox, esperá unos minutos y reintentá. No afecta a producción.
* Datos precargados (NITs de prueba, catálogos demo); algunas validaciones son menos estrictas que en producción.
* Sin límite de facturas de desarrollo; solo protección básica contra abuso.
* Si el Piloto está caído podés abrir [contingencia](https://docs.cucu.bo/api/events.md) igual que en producción.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.