Idempotencia

La regla#

Manda siempre Idempotency-Key en POST /facturas y POST /notas-credito, con un valor estable por pedido: el número de pedido de tu sistema, no un valor aleatorio nuevo en cada intento.

La clave tiene de 8 a 128 caracteres: letras, números, punto, guion, guion bajo o dos puntos. Por ejemplo, pedido-00184 o anula-00184.

Qué pasa si reintentas#

Si tu sistema reintenta porque se cayó la red, Conta360 devuelve la respuesta de la primera vez, con el encabezado Idempotent-Replay: true, y la DIAN no recibe la factura dos veces.

1. Tu sistema manda el pedido 184 con Idempotency-Key: pedido-00184.
2. Se cae la red y no recibes respuesta. Conta360 sí emitió la factura.
3. Reintentas con la misma clave.
4. Recibes la respuesta original con Idempotent-Replay: true. No hay factura duplicada.

Las claves se conservan 30 días.

Misma clave, otro contenido#

Si mandas una clave que ya usaste con un cuerpo distinto, la API responde 409 conflict. Una clave identifica un solo documento.