Idempotencia

El contrato declara la cabecera Idempotency-Key en dos operaciones:

Operación	Requisito
`PATCH /api/v1/productos`	Opcional. Sincroniza stock por SKU.
`POST /api/v1/ordenes`	Obligatoria. Crea una venta externa.

La clave admite entre 1 y 200 caracteres y debe cumplir este patrón:

^[A-Za-z0-9._~:+-]+$

Usá una clave nueva y estable para cada operación lógica. Un ejemplo ficticio:

Idempotency-Key: order-pos-2026-000042

Replay y conflictos

Al crear una orden, una repetición completada puede devolver la respuesta original con:

Idempotent-Replayed: true

El cuerpo también informa meta.idempotent_replay. La API puede responder 409 si una clave se reutiliza con otro body o si la operación sigue en proceso. En la creación de órdenes, 409 también puede representar referencia duplicada o stock insuficiente.