Saltar al contenido principal

Idempotencia y reintentos

Una caída de red puede dejarte sin saber si un comprobante se emitió. Para reintentar sin riesgo, toda operación que crea algo acepta el encabezado Idempotency-Key.

Idempotency-Key: 9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d
  • Mismo contenido, misma clave: la API devuelve el resultado original; no crea otro comprobante.
  • Otro contenido, misma clave: 409 IDEMPOTENCY_CONFLICT.
  • Genera una clave nueva (UUID v4) por cada comprobante distinto y guárdala junto al comprobante hasta confirmar la respuesta.

Además, la API rechaza con 409 CONFLICT un e-NCF que ya usó otro comprobante vigente del mismo contribuyente y ambiente.

Cuándo reintentar​

Respuesta¿Reintentar?
Error de red o tiempo agotadoSí, con la misma Idempotency-Key.
503 SIGNER_UNAVAILABLE o DGII_UNAVAILABLESí, con espera creciente. El documento no se guardó.
422 VALIDATION_FAILEDNo. Corrige el comprobante.
409 CONFLICTNo. El e-NCF ya está usado: consulta ese comprobante.