Identificadores de productos y variantes#
El target del storefront debe identificar el mismo producto que el catálogo del comerciante. La mayoría de los fallos de integración comienzan con una discrepancia entre esos dos valores.
Elegir un identificador estable#
Usa el productCode que se muestra para el producto preparado. En el tutorial de Shopify es la variante SKU. Los campos de solicitud de la Product Import API están definidos en la referencia de importación; no reemplaces esos nombres de campo por nombres de atributo del storefront.
Mantén los identificadores idénticos, incluido el uso de mayúsculas y minúsculas. No los generes a partir de nombres de visualización cambiantes ni supongas que un ID de producto interno de la plataforma es igual a un SKU.
Mapear la variante seleccionada#
| Estado del storefront | Comportamiento del target |
|---|---|
| Se selecciona una variante preparada | Establece su productCode exacto |
| Cambia la selección | Actualiza el target y limpia el estado obsoleto del SDK usando tu guía de integración |
| No hay SKU ni producto coincidente | Mantén el botón creado por el desarrollador oculto o deshabilitado |
| Una tarjeta de producto apunta a una variante predeterminada | Usa el identificador de esa variante de forma consistente |
Para Shopify, conecta el auxiliar de sincronización del tutorial al callback real de cambio de variante de tu tema. Para otros storefronts, sigue páginas dinámicas.
Validar el mapeo#
Elige dos variantes con productos visiblemente distintos. Registra sus códigos de catálogo, inspecciona cada data-product-code renderizado en las herramientas de desarrollador del navegador, luego abre el Viewer para cada uno. Repite tras navegar sin recargar la página completa.
Cuando un identificador cambie en tu sistema origen, coordina la importación del catálogo y el lanzamiento del storefront. Una respuesta de importación HTTP exitosa solo es aceptación; inspecciona el estado del trabajo y los fallos de los artículos antes de confiar en el nuevo código.