Si algo falla
Los errores que puede ver tu agente y qué hacer con cada uno.
| Lo que ves | Qué significa | Qué hacer |
|---|---|---|
401 al conectar | Falta la API key, está mal escrita o la revocaste | Revisa el encabezado Authorization o crea otra API key |
| El agente no tiene una herramienta | El permiso de la API key no la permite, o es de otro ambiente | Usa una API key con el permiso que necesitas |
key_not_permitted | Lo mismo, cuando la llamada llega a la API | Igual que arriba |
confirmation_required | El agente pidió emitir o cambiar un comprobante en Producción y falta tu confirmación | Revisa el resumen que te muestra y dile si sí |
preview_mismatch | El comprobante cambió después de la vista previa | Que lo previsualice otra vez |
invalid_request con errors | Un campo del comprobante está mal | El agente lo corrige solo; cada error dice qué campo y por qué |
idempotency_key_reused | Se reusó la clave de un reintento para otro comprobante | Cada comprobante nuevo lleva una clave nueva |
rate_limited | Demasiadas solicitudes seguidas | Espera los segundos que indica retry_after_seconds |
Un reintento con el mismo idempotency_key nunca emite dos veces: devuelve el comprobante del primer intento. Así, si la conexión se cae justo al emitir, el agente puede volver a intentarlo sin miedo.