Use o identificador correto
Um ID de produto, SKU ou ID de variante de loja não é automaticamente um ID de peça SPREEAI. Mantenha um mapeamento criado por meio de seu fluxo de trabalho de ingestão ou sincronização Shopify. A peça deverá pertencer ao parceiro autenticado e estar disponível para experimentação.
Mapeie uma seleção de produtos
TypeScript
import type { RenderTryOnButtonOptions } from "@spreeai/web-sdk";
export const productOptions: RenderTryOnButtonOptions = {
elementId: "spreeai-try-on",
garments: [{
garmentId: "SPREEAI_GARMENT_ID",
variant: { color: "blue", fit: "regular" },
availableSizes: ["S", "M", "L"],
price: "$59.00",
}],
showSizes: true,
showPrices: true,
};variant pode filtrar cor, ajuste, gênero e estilo. A correspondência documentada não diferencia maiúsculas de minúsculas. Combine a cor pelo nome, como blue, em vez de um valor hexadecimal.
Prontidão de vestuário
| Estado ou condição | Ação de integração |
|---|---|
| Não sincronizado/ingestão incompleta | Mantenha a experiência normal do produto; não prometa disponibilidade de teste. |
| Pronto, mas desativado em Shopify | Revise e ative explicitamente o produto pretendido. Pronto por si só não o faz viver. |
| Vestuário disponível e variante correspondente | Renderize o botão para essa seleção. |
| Nenhuma roupa correspondente disponível | Espere um retorno para a primeira peça de roupa da matriz. |
| A validação falha | Nenhum botão é renderizado; investigue o console e o mapeamento do produto. |
Mantenha os dados do produto atualizados
- Atualize o preço exibido e os tamanhos em estoque quando a seleção do produto mudar.
- Use IDs de contêiner exclusivos para botões de produtos separados.
- Ao renderizar novamente um botão, passe a seleção atual de roupa e variante.
- Revise os dados do carrinho retornados em relação ao seu próprio catálogo antes de criar uma mutação de carrinho.
Preparar ativos de vestuário
Use o atual padrões de imagem de vestuário para imagens e metadados suportados. Resolver problemas de processamento antes de habilitar produtos; não substitua IDs de vestuário de espaço reservado por dados de produção.