# Errores y solución de problemas

Referencia rápida de los códigos de error HTTP que puede recibir y cómo resolverlos.

## Errores de cliente (4xx)

`400 Bad Request`

La solicitud tiene un formato inválido o faltan parámetros requeridos. Casos comunes: omitir `include` en el detalle, omitir `nombre` y `ruc` en la búsqueda, o enviar un código de producto inválido.

`401 Unauthorized`

No se envió el header `Authorization: Bearer pk_...`.

Solución: Envíe su llave API como Bearer token en cada solicitud.

`402 Payment Required`

No tiene saldo prepago suficiente para completar la solicitud.

Solución: [Recargue saldo](/credits) desde su panel.

`403 Forbidden`

La llave fue rechazada por la capa de autenticación.

Solución: Verifique que está usando una llave activa generada en su cuenta y que la copió completa.

`404 Not Found`

La entidad con el ID proporcionado no existe.

Solución: Verifique el `id` usando el endpoint de búsqueda.

## Errores de servidor (5xx)

`500 Internal Server Error`

Error interno del servidor. Si persiste, contáctenos. Estas solicitudes **no se cobran**.

`503 Service Unavailable`

El servicio está temporalmente fuera de línea. Reintente en unos minutos.

Anterior: [← Sandbox vs API](/docs/guias/sandbox-vs-api)