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

# Entorno de prueba

> Un estudio de ejemplo con la configuración del real, para probar tu código sin tocar datos reales y sin escribirle a nadie.

Cada estudio tiene un **estudio de prueba**: una copia de su configuración, poblada con personas y
reservas de ejemplo. Una clave `crq_test_` lee de él; una clave `crq_live_`, del estudio real. Las
rutas, los permisos y las respuestas son los mismos en los dos.

Úsalo para escribir y probar tu integración sin ver datos de clientes reales.

## Qué tiene

**La configuración del estudio real**, copiada en el momento en que se preparó:

* el nombre del estudio, con " (prueba)" al final;
* su zona horaria, su país y su moneda;
* sus reglas de reserva;
* sus sedes y salones;
* sus disciplinas y sus clases activas, con su horario semanal;
* sus packs, sus planes de membresía y sus ofertas de bienvenida.

**Personas y movimientos de ejemplo:**

* tres instructores y dieciséis clientes ficticios;
* sesiones desde una semana antes hasta dos semanas después del día en que se preparó;
* reservas en esas sesiones: las pasadas con asistencia (y alguna ausencia), las futuras confirmadas, y
  una sesión llena con lista de espera;
* algunos packs y membresías de clientes, con sus cuotas, un pago y una cuota vencida.

**Lo que no se copia:** los clientes, los instructores, las reservas y los pagos reales; las
conexiones del estudio con otros servicios (WhatsApp, procesadores de pago, facturación electrónica,
calendarios). Lo que no está en la primera lista no se copia.

## No le escribe a nadie

El estudio de prueba no manda emails, ni WhatsApp, ni notificaciones, y no cobra nada:

* sus personas tienen contactos ficticios: emails de `example.com` (un dominio reservado que no es de
  nadie) y teléfonos del rango ficticio `+1` con central 555 y número del 0100 al 0199;
* no tiene conectado ningún canal de mensajes ni ningún procesador de pago;
* y, aunque algo intentara mandar un aviso, Craqui lo descarta para un estudio de prueba.

Una persona del estudio de prueba solo puede tener un contacto ficticio. Si una respuesta dice
[`sandbox_contact_not_allowed`](https://docs.craqui.com/errors/sandbox_contact_not_allowed) o
[`sandbox_account_reserved`](https://docs.craqui.com/errors/sandbox_account_reserved), es por esta regla.

## `livemode`

Todo objeto que devuelve la API trae `livemode`: `false` si viene del estudio de prueba, `true` si viene
del real. Si tu sistema guarda datos, guárdalo también: así nunca confundes un dato de prueba con uno
real.

## Se crea solo, y se restablece

El estudio de prueba se prepara la primera vez que la propietaria crea una clave de prueba. Para
empezar de nuevo, ella aprieta **Restablecer datos de prueba** en **Configuración → Integraciones →
API**, en la sección **Datos de prueba**.

Restablecer prepara un estudio de prueba **nuevo**, con la configuración que el estudio real tiene en ese
momento, y el anterior deja de estar disponible:

* **Todos los ids cambian**, también el del negocio (`biz_`). Un id guardado de antes responde
  [`not_found`](https://docs.craqui.com/errors/not_found).
* Un cursor de antes responde [`invalid_cursor`](https://docs.craqui.com/errors/invalid_cursor).
* Las claves de prueba siguen funcionando: no hace falta crear otras.

Si una clave de prueba responde [`sandbox_unavailable`](https://docs.craqui.com/errors/sandbox_unavailable), el estudio de prueba
no está listo: restablecerlo lo arregla.

## Prueba y producción no se cruzan

* Una clave de prueba nunca lee datos reales, y una de producción nunca lee el estudio de prueba.
* Un id del estudio real con una clave de prueba responde [`not_found`](https://docs.craqui.com/errors/not_found), y al revés.
* Un cursor de un entorno no sirve en el otro.

Los límites de pedidos, los permisos y el plan funcionan igual en los dos entornos: una clave de prueba
de un estudio cuyo plan no incluye la API responde [`plan_required`](https://docs.craqui.com/errors/plan_required).

## La propietaria ve tus pedidos

Cada pedido, de prueba o de producción, aparece en la actividad de la API del panel de la propietaria,
con su `request_id`. Los de prueba llevan la etiqueta **Prueba**.


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