Mandás el momento, el lugar y el contexto del comprador; vuelve una recomendación con los productos completos, listos para mostrar.

El pedido

Qué necesita cada momento: Los seis momentos.
RecommendationSurface
requerido
pdp, cart (al agregar al carrito), carousel (la página del carrito), checkout, in-checkout o success-page.
string
requerido
Una etiqueta que definís vos para saber de dónde salió el pedido. Es para tu trazabilidad; no cambia la recomendación.
string
El producto de partida. Obligatorio en , y, sin carrito, en .
CartItem[]
{ item_id, variant_id, quantity } por línea. Omitido es lo mismo que vacío. Obligatorio en los momentos de carrito.
Visitor | false
Un visitante sólo para este pedido, o false para no mandarlo. Por defecto, el de la instancia.
isShooterSurface(surface) dice si el momento parte de un producto.

Lo que vuelve

Vuelve la recomendación (en la API, Decision: la lista de productos recomendados para ese momento).
product trae ítem, categorías, variantes con precio y disponibilidad: alcanza para mostrarlo. Si no se pudo leer, no viene y ese resultado se omite. No hay puntaje: el orden es el ranking.
La descripción viaja como la manda la plataforma. Tiendanube manda HTML: sanitizalo antes de insertarlo.
Para un resultado sin product, o un producto fuera de la recomendación:
El título es por idioma, sellable es un texto y una cantidad ausente no es cero: Leer un ítem del catálogo.

Reportar señales

Lo que sigue después de mostrar la recomendación.

Los seis momentos

Qué necesita el pedido de cada momento.