Troubleshooting

”Recibo 401 Unauthorized”

1. ✅ Verifica que el header sea X-Api-Key (no Authorization).
2. ✅ La key completa, sin espacios al inicio/final.
3. ✅ Empieza con lxs_live_.
4. ✅ No está revocada (pregunta al admin).

”Recibo 403 Forbidden”

La key no tiene el scope. Pide al admin agregarlo:

• facturas:read para GET.
• facturas:write para POST.
• facturas:anular para DELETE.

”Recibo 400 con Producto X no encontrado”

El producto no existe en el catálogo del tenant. Soluciones:

1. Crear el producto en el POS.
2. Usar otro idProducto válido.
3. Verificar que estás apuntando al tenant correcto (prefijo de la key).

”Mi comprobante se queda en procesando por horas”

Causas posibles:

1. Hacienda saturada (cierre de mes, declaraciones).
2. Certificado P12 expirado en el tenant.
3. Credenciales Hacienda incorrectas.

Si pasa >30 min, escala a soporte.

”Hacienda rechaza con código 9015”

Es un fallo de validación contra los catálogos oficiales. Revisa que los siguientes campos estén dentro de los valores permitidos por Hacienda:

• condicionVenta.
• medioPago.
• tipoIdentificacion del cliente.

”Mi webhook no llega”

Revisa la sección de webhooks: verifica que el webhookUrl esté configurado, que tu endpoint responda 2xx rápidamente y que no esté bloqueado por firewall.

”Recibo 429 constantemente”

Excedes 120/min. Soluciones:

1. Implementa rate-limiting del lado tuyo.
2. Distribuye carga en múltiples keys (si tienes varios tenants).
3. Pide aumento del límite a soporte.