# 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… - Página: - Idioma: es - Actualizado el: 2026-09-24 - Otros idiomas: [fr](https://www.datafirefly.com/documentation/dftiktokpinterest/index.md), [en](https://www.datafirefly.com/en/documentation/dftiktokpinterest/index.md), [de](https://www.datafirefly.com/de/documentation/dftiktokpinterest/index.md), [it](https://www.datafirefly.com/it/documentation/dftiktokpinterest/index.md), [pl](https://www.datafirefly.com/pl/documentation/dftiktokpinterest/index.md), [nl](https://www.datafirefly.com/nl/documentation/dftiktokpinterest/index.md), [pt](https://www.datafirefly.com/pt/documentation/dftiktokpinterest/index.md) - Índice: ## 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. En multitienda, seleccione una tienda en el selector de contexto: los ajustes de los canales se guardan por tienda. ## 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](https://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](https://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. El token de seguridad protege las URL de los feeds y del cron. Si lo regenera, actualice el crontab y las URL de feed registradas en Pinterest y TikTok. ## 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.