Conector TikTok Shop y Catálogo Pinterest: instalación y configuración

Presentación

El módulo conecta su tienda PrestaShop 8 o 9 con dos canales:

• TikTok Shop: creación y actualización de anuncios con la API Partner, envío de stock y precios, importación de pedidos y envío de números de seguimiento.
• Pinterest: feed de catálogo TSV y, opcionalmente, actualizaciones en tiempo real con la API Catalogs.

También incluye un feed CSV para los catálogos de TikTok Ads. El módulo está en Catálogo > TikTok & Pinterest. La pestaña Resumen muestra una lista de puesta en marcha con los pasos pendientes.

Instalación

1. En Módulos > Gestor de módulos, pulse Subir un módulo y elija el archivo ZIP.
2. Abra Catálogo > TikTok & Pinterest.
3. En la pestaña Ajustes, compruebe el idioma, la moneda y el país usados para los precios (se envían con IVA de ese país) y el tamaño de imagen. TikTok Shop exige al menos 600 x 600 píxeles.

Pinterest

Solo el feed, sin app

1. Pestaña Pinterest: active Pinterest y copie la URL del feed.
2. En Pinterest Business Hub, abra Catálogos > Fuentes de datos, añada una fuente y pegue la URL. Pinterest importa el feed cada 24 horas.

Actualizaciones en tiempo real por la API

1. En developers.pinterest.com, cree una app y añada la URI de redirección que aparece en la pestaña Pinterest del módulo.
2. Introduzca el App ID y el App secret, deje Actualizaciones en tiempo real en Sí y pulse Guardar y conectar Pinterest.
3. Una vez conectado, pulse Crear la fuente de datos en Pinterest: el módulo registra el feed con la moneda y el país de los ajustes.

Los cambios de stock, de precio y las retiradas se envían entonces en pocos minutos. Dos minutos después de cada envío, el módulo lee el resultado de Pinterest. Un artículo rechazado aparece con error en la pestaña Productos con el mensaje de Pinterest.

TikTok Shop

Crear la app de TikTok Shop

1. En partner.tiktokshop.com, cree una app de vendedor personalizada o de servicio de terceros.
2. Active los scopes Product, Order, Fulfillment y Logistics.
3. Indique como URL de redirección la que aparece en la pestaña TikTok Shop del módulo.
4. Copie el App key, el App secret y, si la app lo tiene, el Service ID.

Conectar la tienda

1. Pestaña TikTok Shop: active TikTok, elija la región (Europa y resto del mundo, o Estados Unidos), introduzca las credenciales y pulse Guardar y conectar TikTok Shop.
2. Autorice la app en la página de TikTok. El módulo recupera la tienda y el almacén predeterminado.
3. Elija el almacén si tiene varios, y el fabricante y la persona responsable para la UE. Créelos primero en Seller Center si las listas están vacías y pulse Actualizar listas.
4. Pulse Cargar categorías para obtener el árbol de categorías de TikTok.

Ajustes de los anuncios

• Precio enviado: con los descuentos de PrestaShop, o precio normal si gestiona las promociones en TikTok.
• Paquete predeterminado: peso y dimensiones para los productos que no los tienen.
• Crear nuevos anuncios: desactivado, el módulo solo actualiza el stock y el precio de los anuncios ya publicados.

Anuncios que ya existen en TikTok Shop

Si ya vende en TikTok Shop, pulse Vincular los anuncios existentes en la pestaña TikTok Shop antes de la primera sincronización. El módulo vincula sus anuncios con sus productos por SKU de vendedor:

• referencia de la combinación;
• referencia del producto, para un producto sin combinaciones;
• formato PS12 o PS12-34 usado por el módulo.

Un anuncio vinculado conserva su título, imágenes y descripción de TikTok: el módulo solo gestiona su stock y su precio. Para aplicarle el contenido de PrestaShop, abra la vista previa del producto en la pestaña Productos y pulse Sustituir su contenido por los datos de PrestaShop. Un anuncio cuyos SKU apuntan a varios productos se indica como conflicto y no se vincula.

Asignación de categorías

La pestaña Categorías asocia cada categoría de PrestaShop con:

• una categoría de Google, usada por Pinterest y el feed de TikTok Ads: escriba unas palabras y elija en la taxonomía de Google integrada;
• una categoría de TikTok Shop: escriba para buscar, o pulse Sugerir para que TikTok proponga una a partir de sus productos.

Una subcategoría sin asignación propia hereda la de su padre, mostrada en gris. Los productos usan su categoría por defecto. Los cambios se guardan juntos con Guardar cambios.

El botón Atributos abre los atributos de la categoría de TikTok. Los marcados con asterisco son obligatorios y se aplican a todos los productos de la categoría. La asignación se exporta e importa en CSV (separador punto y coma).

Pedidos de TikTok

La pestaña Pedidos TikTok evita la sobreventa: sin importación, una venta en TikTok solo baja el stock en TikTok. Hay tres modos:

• Crear pedidos de PrestaShop: cada venta se convierte en un pedido al precio pagado en TikTok (descuento del vendedor deducido) y con el envío de TikTok. PrestaShop calcula el IVA y el stock baja. El pago aparece como «TikTok Shop», con el número de pedido de TikTok como transacción.
• Solo descontar el stock: para pedidos enviados desde Seller Center o por TikTok.
• Desactivado.

Los pedidos se importan con la tarea cron. Al activar la importación, se recogen los de las últimas 24 horas. Elija el estado de los nuevos pedidos y el transportista. El importe de envío es el pagado en TikTok, sea cual sea el transportista.

• Cancelaciones: una cancelación en TikTok pasa el pedido a «Cancelado», o devuelve el stock en el modo solo stock.
• Errores: un pedido con error (SKU sin vincular, moneda no activada) aparece con el motivo y se reintenta cada 15 minutos. El botón Reintentar lo vuelve a intentar en la próxima importación.
• Compradores: se crean como clientes invitados con una dirección @tiktokshop.invalid. TikTok prohíbe contactarlos fuera de la plataforma, así que el módulo bloquea cualquier correo dirigido a ellos.

La ficha del pedido muestra un bloque TikTok Shop con el número de TikTok, el estado y el seguimiento.

Números de seguimiento

Cuando se añade un número de seguimiento a un pedido importado, a mano o por un módulo de transporte, se envía a TikTok en 5 minutos y el pedido de TikTok pasa a enviado. Los pedidos gestionados por TikTok se omiten.

TikTok exige un proveedor de envío. En la pestaña TikTok Shop, sección Transportistas y proveedores de envío de TikTok, asocie cada transportista a un proveedor. Sin asociación, el módulo busca un proveedor con el mismo nombre. Si no lo encuentra, el error lista los proveedores disponibles.

Pestaña Productos

Cada fila muestra miniatura, precio, stock, estado en cada canal y una puntuación de calidad sobre 100 con el problema principal. Las causas posibles son:

• imagen ausente, precio cero o descripción corta;
• EAN no válido;
• categoría sin asignar;
• más de 3 grupos de atributos para TikTok.

Los filtros muestran productos con error, excluidos, sin categoría de Google o TikTok, o vinculados desde Seller Center. Marque productos para exportarlos o excluirlos en bloque, o para programar una sincronización completa. La vista previa muestra las variantes tal como se enviarán y permite definir un título por canal. Sincronizar ahora envía el producto de inmediato.

Ajustes avanzados

• Parámetros UTM: se añaden a los enlaces de los feeds y de los pines para la atribución en Google Analytics. Déjelos vacíos para desactivarlos.
• Etiquetas personalizadas: custom_label_0 = categoría, custom_label_1 = tramo de precio, custom_label_2 = promo o normal.
• Reglas de exclusión: categorías (subcategorías incluidas), marcas, precio mínimo con IVA, y variantes sin stock retiradas de los feeds y de Pinterest. Un producto excluido se retira de los feeds, se elimina de Pinterest y se desactiva en TikTok Shop. Cambiar una regla vuelve a poner todo el catálogo en cola.
• Momento del envío: justo después de cada cambio (alojamiento PHP-FPM o LiteSpeed), o solo por cron.

Tarea cron

Copie las dos líneas de la pestaña Resumen en el crontab de su alojamiento:

• cada 5 minutos, task=sync: cola, reintentos, pedidos de TikTok, seguimiento y resultados de Pinterest;
• cada hora, task=feeds: regeneración de los feeds.

El resumen indica si el cron se ejecutó en los últimos 20 minutos. Un error de la API se reintenta a los 2, 4, 8, 16 y 32 minutos.

Registros y solución de problemas

La pestaña Registros guarda 30 días de eventos, filtrables por canal: Pinterest, TikTok, pedidos de TikTok. Los errores de la API se guardan con la respuesta completa.

• Un producto no se envía a TikTok: revise su puntuación en la pestaña Productos. Una categoría de TikTok ausente o un producto virtual bloquean el envío.
• Un pedido de TikTok sigue con error: el SKU de vendedor debe coincidir con una referencia de PrestaShop, o el anuncio debe haberlo creado el módulo. Corrija y pulse Reintentar.
• Los cambios de un empleado no se envían: PrestaShop no ejecuta los hooks de un módulo para un perfil sin permiso «Ver» sobre él. Concédalo, o use Sincronizar ahora en la pestaña Productos.