La sincronización inicial sube de una vez tus productos y tus órdenes históricas, para que CrossUp arranque sabiendo qué vendés y qué ya se compró junto. Se hace una sola vez, con un snapshot por entidad: lo abrís, mandás páginas y lo cerrás.

Qué sincronizás

Lo mínimo: productos y stock

Productos (item) y su disponibilidad (availability). Con esto CrossUp ya recomienda en los cinco momentos.

Para recomendar mejor

Categorías y el último año de órdenes, opcionales. Con las órdenes, CrossUp aprende qué se compra con qué desde el primer día.
Necesitás el connection_id y la clave cct_… de los tres pasos. En los ejemplos usamos cn_4Kq9Xz y cct_tu_clave: cambialos por los tuyos.

Los tres pasos

1

Abrí el run

Un run por tipo de entidad. La respuesta trae su run_id (snp_…).
2

Mandá las páginas

Hasta 500 entidades por página, todas con upsert.
3

Cerralo

Al cerrar, lo que no vino de ese tipo se da de baja. En la sincronización inicial no hay nada que dar de baja.
Si la carga se corta a la mitad, no cierres el run: daría de baja lo que todavía no mandaste. Un run sin cerrar expira solo a las 24 horas, sin borrar nada.

Leé la respuesta

Cada página devuelve un resultado por posición, en el mismo orden en que mandaste las entidades.
Una entidad en cuarentena no frena a las demás: el resto del lote entra igual. Qué es una revisión y por qué reentregar es seguro está en Actualización diaria.

Primero el catálogo, después el historial

Un run por entidad, en este orden: categorías (taxonomy_node), productos (item), variantes (variant), disponibilidad (availability) y, al final, las órdenes históricas (order). Si un producto nombra una categoría que todavía no llegó, no falla: se resuelve cuando llega. Hay un solo run abierto por conexión y entidad. Con dos, el cierre del primero daría de baja lo del segundo.

Qué vas a ver

El cierre devuelve received, deleted y quarantined. En una sincronización inicial limpia, deleted y quarantined dan cero. Después, tu tienda puede leer un producto por tu propio id con GET /v1/catalog/items/by-external/{external_id} y su clave de storefront.

Si no lo ves

Actualización diaria

Cada cambio después de la sincronización inicial.

El modelo canónico

Los campos de cada entidad.