A sincronização inicial envia de uma vez seus produtos e seus pedidos históricos, para que a CrossUp comece sabendo o que você vende e o que já foi comprado junto. É feita uma única vez, com um snapshot por entidade: você abre, envia páginas e fecha.

O que você sincroniza

O mínimo: produtos e estoque

Produtos (item) e sua disponibilidade (availability). Com isso a CrossUp já recomenda nos cinco momentos.

Para recomendar melhor

Categorias e o último ano de pedidos, opcionais. Com os pedidos, a CrossUp aprende o que se compra com o quê desde o primeiro dia.
Você precisa do connection_id e da chave cct_… dos três passos. Nos exemplos usamos cn_4Kq9Xz e cct_sua_chave: troque pelos seus.

Os três passos

1

Abra o run

Um run por tipo de entidade. A resposta traz o run_id (snp_…).
2

Envie as páginas

Até 500 entidades por página, todas com upsert.
3

Feche

Ao fechar, o que não veio daquele tipo é removido. Na sincronização inicial não há nada a remover.
Se a carga cair no meio, não feche o run: removeria o que você ainda não enviou. Um run sem fechar expira sozinho em 24 horas, sem apagar nada.

Leia a resposta

Cada página devolve um resultado por posição, na mesma ordem em que você enviou as entidades.
Uma entidade em quarentena não trava as outras: o resto do lote entra igual. O que é uma revisão e por que reenviar é seguro está em Atualização diária.

Primeiro o catálogo, depois o histórico

Um run por entidade, nesta ordem: categorias (taxonomy_node), produtos (item), variantes (variant), disponibilidade (availability) e, no final, os pedidos históricos (order). Se um produto cita uma categoria que ainda não chegou, não falha: ela se resolve quando chegar. Há um único run aberto por conexão e entidade. Com dois, o fechamento do primeiro removeria o que o segundo trouxe.

O que você vai ver

O fechamento devolve received, deleted e quarantined. Numa sincronização inicial limpa, deleted e quarantined dão zero. Depois, sua loja pode ler um produto pelo seu próprio id com GET /v1/catalog/items/by-external/{external_id} e a chave de storefront.

Se não aparecer

Atualização diária

Cada mudança depois da sincronização inicial.

O modelo canônico

Os campos de cada entidade.