Conceptos

• Negocio: cada llave pertenece a un solo negocio de papedir. No mandas el negocio en la petición: sale de la llave.

• Llave de API: pdk_live_<prefijo>_<secreto>. El prefijo es visible (sirve para reconocerla en el panel); el secreto solo se muestra al crearla. Una llave por sistema: si se filtra, el negocio la revoca sin afectar las demás.

• Scopes: lo que puede hacer la llave.

  Scope	Permite
  stock:write	Enviar existencias y cruzar productos
  catalog:read	Leer el catálogo
  orders:read	Leer y confirmar eventos de pedido

• Idempotencia: los envíos de existencia llevan Idempotency-Key. Repetir la misma llave (un reintento) no vuelve a aplicar nada.

• Versión: cada existencia puede traer version (un entero creciente de tu sistema). Lo que llega con una versión vieja se descarta, así el orden de llegada no importa.

• Módulo del negocio: el negocio debe tener activo el inventario externo; si no, la API responde MODULE_DISABLED.