Skip to main content
POST /documents acepta un campo idempotency_key en el body. Si reenvías la misma emisión con la misma key, Factio devuelve el documento existente en lugar de crear otro.

​
Cuándo usarla

Siempre que exista riesgo de reenvío:
  • Timeouts de red o del cliente HTTP.
  • Reintentos automáticos de tu sistema o de tu cola de trabajos.
  • Reintentos de Zapier, Make u otras integraciones.

​
Cómo funciona

Incluye idempotency_key en el body del request (texto de hasta 255 caracteres):
Factio no lee un header Idempotency-Key. La key va en el body. Si la envías como header, se ignora y un reenvío crea un comprobante nuevo.
Si reenvías el request con una key que ya usaste:
  • No se reserva un secuencial nuevo.
  • No se crea un comprobante nuevo.
  • Recibes 200 OK con el documento existente:
En esta respuesta status puede venir con un valor interno (por ejemplo RECEIVED_BY_SRI). Para el estado público y el detalle completo, consulta GET /documents/{document_id}.

​
Reglas

  • La key es única por emisor y ambiente del SRI: el mismo emisor puede reusar una key en pruebas y en producción sin conflicto.
  • Las keys no expiran.
  • Usa un valor estable y único por comprobante. El identificador de la factura en tu sistema es una buena opción (por ejemplo erp-factura-000123). Genera una key nueva solo cuando quieras emitir un comprobante distinto.