Idempotencia

La idempotencia evita que un reintento emita dos veces el mismo comprobante.

Si la red se corta después de enviar una venta, no sabés si Fixed llegó a emitir el CFE. Volver a mandar la misma venta, sin una clave, crea otro comprobante. Con idempotencyKey ese reintento es seguro: Fixed reconoce el mismo intento y te devuelve el resultado de la primera vez, sea éxito o error, en vez de facturar de nuevo.

La clave identifica el intento de emisión, no el contenido de la venta. Generala como UUID v4 justo antes de llamar, o usá el identificador único de esa venta en tu sistema. No la armes a partir de los importes o del cliente: dos ventas iguales compartirían la clave y la segunda no se emitiría.

Si repetís la misma clave con los mismos datos, Fixed devuelve el resultado original. Si la repetís con datos distintos, responde E23 y tenés que generar una clave nueva.

La usan Crear una venta y Devolver una venta.