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

# Errores

> Códigos de error, códigos de estado HTTP y cómo solucionar problemas con IDs de solicitud.

Las respuestas GraphQL usan HTTP 200 tanto para éxitos como para errores a nivel de aplicación. Inspecciona el arreglo `errors` para saber qué ocurrió.

## Forma del error

```json theme={null}
{
  "errors": [
    {
      "message": "Offer out of stock",
      "extensions": {
        "code": "GC-0009",
        "path": ["purchaseGiftCard"],
        "requestId": "req_01H...Offer out of stock",
      "code": "GC-0009",
      "path": ["purchaseGiftCard"]
    }
  ]
}
```

Los códigos de error están organizados por área:

* `AUTH-*` — problemas de autenticación y tokens
* `BS-*` — errores generales de negocio / validación
* `GC-*` — operaciones de tarjetas de regalo
* `VC-*` — operaciones de tarjetas virtuales

## Códigos de error por dominio

Fluz usa códigos de error con prefijos para que puedas bifurcar según el subsistema que falló.

| Prefijo     | Dominio                      | Ejemplo                                                                         |
| ----------- | ---------------------------- | ------------------------------------------------------------------------------- |
| `AUTH-XXXX` | Autenticación y autorización | Token inválido, alcance faltante                                                |
| `VC-XXXX`   | Tarjetas virtuales           | `VC-0025` — dirección inválida o no admitida                                    |
| `GC-XXXX`   | Tarjetas de regalo           | `GC-0009` — oferta sin stock; `GC-0002` — monto no en denominaciones permitidas |
| `BS-XXXX`   | Saldos y compensación        | Fondos insuficientes, retenciones                                               |

Los códigos que no estén en esta lista aparecen como errores genéricos de validación o del servidor.

## Solución de problemas

1. **Revisa el alcance en `AUTH-*`.** Casi siempre significa que el token se generó sin el alcance requerido; genera un token nuevo.
2. `AUTH-0002`**Vuelve a consultar antes de reintentar `GC-*`.** Las ofertas y el stock cambian con frecuencia — obtén una oferta fresca y vuelve a intentar.
3. **Vuelve a consultar antes de reintentar errores de negocio.** `GC-0009` (stock) y similares significan que el mundo cambió — no vuelvas a intentar con datos obsoletos**No vuelvas a intentar errores de validación.** Los códigos `VC-*` y `BS-*` con intención tipo `4xx` fallarán de forma idéntica al reintentar hasta que corrijas la entrada o el saldo.
4. **Vuelve a intentar errores transitorios del servidor con backoff y jitterVuelve a intentar errores 5xx / de red con jitter.** Las mutaciones de movimiento de dinero son desduplicadas; consulta [Idempotencia](/concepts/idempotency).