Idempotencia y reintentos
Cada comprobante lleva un Idempotency-Key que vos generás (por ejemplo un UUID guardado junto al cobro).
- Repetir el POST con la misma key devuelve el mismo comprobante: nunca emite dos veces.
- Ante 503 o timeout, reintentar SIEMPRE con la misma
Idempotency-Key; nunca con una nueva. Un 503 no significa que la factura no exista: ARCA pudo aprobarla y la respuesta perderse. La API reservó el número y, al reintentar, lo verifica en ARCA: si existe, devuelve ese CAE; si no, emite una sola vez. - Usar una key nueva después de un 503 puede generar dos facturas por el mismo cobro.
- Una key nueva solo corresponde cuando corregiste los datos tras un rechazo (400/422 de validación o
COMPROBANTE_RECHAZADO). - Backoff sugerido: 1 min → 5 min → 15 min → 1 h. La ventana de idempotencia es de 48 h.