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.
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.
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 devolvereceived, 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.