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.