Simula que promociones aplican a una compra de ejemplo y por que

Time	Status	User Agent
Retrieving recent requests…

Time

Status

User Agent

Retrieving recent requests…

Corre el motor del POS en solo lectura (no asigna ni bloquea cupones, no consume usos ni stock, no registra compras) y explica regla por regla que condicion se cumple y cual no. Sin promociones evalua todos los beneficios activos. Con borrador simula cambios sin guardarlos. Un regalo solo aplica si el cliente presenta un cupon asignado (cupones). Montos en unidades monetarias.


Scope requerido	`promociones:read`
Método	`POST /ext/v3/promociones/simular`

Body

Parámetro	Tipo	Requerido	Descripción
`carrito`	array	sí
`sucursal`	string	no	tiendaId de la sucursal
`canal`	enum: pos \| ecommerce	no	ecommerce reproduce lo que manda la tienda en linea (tiendaId "1", sucursal en maquinaId, hora en UTC) Default `"pos"`.
`terminal`	string	no	maquinaId del POS
`cliente`	object	no	Cliente (uid o email). Omitir = compra sin cliente
`fechaHora`	string	no	YYYY-MM-DD HH:MM en la hora del negocio (solo afecta la condicion de horario 310)
`envio`	object	no
`pago`	object	no
`tipoOrden`	string	no
`tipoOrdenId`	integer	no
`cupones`	array	no	Codigos de cupones o codigos promocionales que presentaria el cliente (solo se leen asignaciones existentes)
`promociones`	array	no	Promociones a explicar (omitir = beneficios activos)
`borrador`	object	no	Cambios sin guardar a simular

Ejemplo

curl -X POST 'https://api3.clau.io/ext/v3/promociones/simular' \
  -H 'apikey: ck_1_...' \
  -H 'Content-Type: application/json' \
  -d '{"carrito":[{"sku":"MF20","cantidad":2,"precioUnitario":3.5}],"sucursal":"SUC-CENTRO","promociones":[{"clase":"beneficio","id":22}]}'

Respuesta 200

{
  "codigoRespuesta": 0,
  "msj": "Exito",
  "data": "…",
  "meta": {
    "requestId": "5f1c…",
    "appId": 1,
    "scope": "promociones:read"
  }
}

Errores: 401 key inválida (9501), 403 sin scope (9503, meta.requiredScope), 400 parámetros (details), 409 idempotencia, 422 regla de negocio (meta.legacy), 429 límite de tasa. Agregue ?help=true para la ayuda en texto plano.