Errores específicos
Lista de los mensajes de error más comunes que devuelve la API, con su causa raíz y la acción recomendada.
| Mensaje | Causa | Solución |
|---|---|---|
"Producto X no encontrado." | idProducto no existe en el tenant. | Crear el producto en el POS, o corregir el ID. |
"Cliente X no encontrado." | idCliente no existe en el tenant. | Crear el cliente en el POS. |
"Factura electrónica requiere cliente." | Falta cliente en una FE, NC o ND. | Agregar el cliente al request. |
"Debe incluir al menos una línea." | El array lineas está vacío. | Agregar al menos una línea. |
"webhookUrl debe ser HTTPS." | El admin configuró un webhook con http://. | Usar URL https://. |
"Tipo no válido." | Valor de tipo no reconocido. | Usar un valor del enum TipoComprobanteApi. |
"Idempotency-Key reutilizada con body distinto." | Misma Idempotency-Key con un body diferente. | Generar una nueva key para el nuevo request. |
"Rate limit excedido." | Más de 120 req/min en una sola API key. | Aplicar backoff exponencial. |
"Scope insuficiente." | La API key no tiene el scope requerido. | Solicitar al admin una key con el scope correcto. |