Import Export - distribuidordeherramientases-wq/seo-taxonomy GitHub Wiki
Import / Export
Manual operativo
Ruta: TaxoCommerce SEO → Herramientas → Import / Export
Pestañas
Importación individual, Importación por lotes, Clonador PRO → STAGING, Catálogo semántico, Inventarios comerciales, Importar proveedor, Importar Amazon, Conexiones con proveedores, Catálogo de proveedores, Sincronización V2.
Importación individual
Cuando hay proceso activo: Reintentar cola, Detener importación, Liberar importación bloqueada y diagnóstico.
Productos: Exportar productos, Exportar inventario reducido portable. Categorías: Exportar e Importar.
Exportar productos genera únicamente fichas reales WooCommerce (publicadas, borrador, pendientes o privadas, según filtros). Las ofertas VEVOR regionales aceptadas en el catálogo intermedio de proveedores no pasan a ser productos WooCommerce por el hecho de aprobarlas. Para revisar país, idioma, enlace de afiliación y relación con WooCommerce, usar la exportación separada de Catálogo de proveedores → Exportar productos de proveedores.
Los selectores de categorías del exportador WooCommerce incluyen también las categorías que todavía no están asignadas a un hub SEO, como las de en-US, de-DE y nl-NL: dejar cluster y hubs en «Todos» para seleccionarlas. Cuando una exportación encuentra cero fichas con los filtros elegidos, lo indica explícitamente y no descarga un CSV vacío de forma automática.
Importar traducciones de categorías (PR #914)
El nuevo bloque Importar traducciones de categorías se encuentra junto a Importar categorías en la pestaña Importación individual una vez que el PR #914 esté fusionado y desplegado. Admite un CSV UTF-8 separado por ;, con 100 filas como máximo y 8 MB como máximo.
- Archivo CSV: selecciona un archivo
.csvcon los campossource_slug;locale;titulo;slug;excerpt;description;parent_slug. Los obligatorios sonsource_slug,locale,tituloyslug. source_sluges el slug actual de la categoría española de referencia; no se obtiene de un ID de STAGING/PRO ni por coincidencia aproximada del título. Debe existir en el entorno donde se importa.localeaceptaen-US,de-DEynl-NL. El idioma se guarda en_seo_locale(termmeta) y la nueva categoríaproduct_catse relaciona con su origen porseo_relations.relation_type = category_translation.parent_slugseñala una categoría padre del mismo mercado; para categorías nuevas se debe resolver una raíz internacional o la traducción del padre español, en ningún caso copiar automáticamente el ID de padre español.- Botón Importar traducciones de categorías: crea o actualiza la categoría traducida, guarda el contenido SEO en
seo_nodes, registra la relación auditada y redirige a la pantalla mostrando cuántas categorías se crearon, actualizaron o vincularon y qué filas fallaron.
El servicio no traduce textos automáticamente, no cambia la categoría española, no asigna productos, no crea 301 y no debe utilizarse para importar las categorías internacionales ya existentes sin verificar su source_slug español. Una nueva importación con el mismo slug e idioma reutiliza la ficha; las relaciones existentes no se duplican. Ver guía multidioma y PR #914.
Importar productos V2: checkboxes de Contenido, WooCommerce, Categorías, Etiquetas, Marca/proveedor, Ámbito, Atributos SEO, Atributos WooCommerce e Imágenes. Seguridad: Simular primero, Crear productos simples, Mantener nuevos como borrador, Las celdas vacías eliminan el dato. Analizar / importar productos ejecuta.
Páginas y Entradas tienen exportación por estado, modo de importación, checkboxes de bloques de datos y Simular primero. La exportación incluye Papelera (trash) cuando se marca ese estado. En importación, estado=trash envía a la papelera una página o entrada ya existente mediante el flujo nativo de WordPress; también se aceptan papelera y basura como alias. Un CSV con trash nunca crea un objeto nuevo en la papelera y nunca realiza borrado definitivo. Si WordPress tiene la papelera desactivada (EMPTY_TRASH_DAYS=0), la operación se bloquea para evitar una eliminación permanente. Si un objeto existente está en papelera y el CSV indica otro estado válido, se restaura antes de aplicar el nuevo estado. También existen Exportar/Importar FAQs y Redirects.
Importación por lotes
- Subir trabajos: Añadir a pendientes, Añadir e iniciar.
- Estado: Iniciar / continuar, Pausar cola después del archivo actual, Detener importación actual, Procesar siguiente bloque adaptativo.
- Gestor de archivos: A pending y Borrar.
Clonador PRO → STAGING
Por conexión: checkbox Activar esta conexión, campos de BBDD, Contraseña, checkbox Eliminar la contraseña guardada, Guardar conexión, Probar conexión. STAGING puede reconstruirse de forma destructiva desde PRO; no usar como flujo de producción.
Catálogo semántico
Exportar catálogo semántico, Descargar paquete JSON, selector de archivo/modo, Simular importación, checkbox de confirmación y Aplicar paquete simulado.
Inventarios comerciales
Configuración por canal, Guardar configuración, Iniciar generación, Parar generación, tabla URLs e historial.
Importar proveedor
Seleccionar Receta y Archivo, Leer archivo y mostrar relaciones, revisar columnas/transformaciones, seleccionar política y modo de imágenes. Checkboxes Usar también este modo al actualizar y Este archivo contiene el catálogo completo. Crear CSV e importar al catálogo intermedio ejecuta. En crawler: Catálogo completo, Iniciar obtención, Detener todos y vaciar rastreos.
Importar Amazon
Partner Tag, checkbox para eliminarlo, Client ID, Secret, versión, Search Index y productos por llamada. Guardar configuración, Explorar Amazon, Explorar y Probar conexión OAuth.
VEVOR internacional: convertir ofertas aceptadas en productos revisables
Importación y aprobación no equivalen a publicación. Los CSV Goods_Export de VEVOR US/DE/NL se incorporan al catálogo intermedio seo_proveedores_productos con país, idioma, nombre, categoría original, precio, imagen externa y enlace afiliado. La aprobación comercial marca estado_seleccion=aceptado sin crear un producto WooCommerce.
Tras el PR #950, al aceptar individualmente una oferta US/DE/NL se intenta crear una ficha WooCommerce external en draft y asociarla a una categoría del mismo país solo si categoryPath identifica una categoría inequívoca. Si no hay coincidencia segura, la aceptación se rechaza con un mensaje; no se asigna a una categoría española ni genérica. El flujo individual también reutiliza una ficha antigua del mismo mercado sin sobrescribirla.
La aceptación masiva heredada sigue siendo una validación del catálogo intermedio y no crea productos WooCommerce: procesar decenas de miles de fichas dentro de una petición bloquearía el hosting. El panel VEVOR muestra el recuento de ofertas anteriormente aceptadas y sin producto, desglosadas por mercado.
En Importar / Exportar → Catálogo de proveedores, el bloque VEVOR internacional: crear fichas de producto para revisar permite recuperar esas ofertas antiguas de forma controlada:
- Seleccionar país US/DE/NL y categoría WooCommerce internacional existente.
- Introducir la ruta exacta
categoryPathde VEVOR. La selección no toma automáticamente productos de otras categorías. - Pulsar Previsualizar ofertas. Comprueba las primeras cinco ofertas aceptadas que no tengan producto enlazado.
- Confirmar y pulsar Crear hasta 5 fichas en borrador.
- Revisar fichas en WooCommerce → Productos → Borrador: categoría/país, texto disponible, imagen externa, enlace de afiliación, tipo de producto External y monedas.
- Publicar únicamente fichas revisadas. La publicación no es automática.
Seguridad del piloto
- Cada alta usa un SKU WooCommerce diferenciado por país; conserva la referencia original VEVOR. Repetir la acción reutiliza productos previos en vez de duplicarlos.
- Si ya existe una ficha del piloto de ese mismo mercado, se vincula sin sobrescribirla; nunca se actualiza una ficha española.
- Se exige URL HTTPS VEVOR del país, los parámetros de afiliación y moneda esperada, título e imagen externa.
- El producto se crea como externo para enviar a VEVOR, no al carrito español.
- El precio original se conserva en metadatos con su moneda; no se representa erróneamente USD como EUR en WooCommerce.
- No crea hubs, clusters ni categorías; estas deben existir antes de vincular.
- No se debe ejecutar ningún alta masiva hasta probar esta fase en STAGING y contrastar el catálogo intermedio real.
Referencias: Importador multidioma; diagnóstico del flujo VEVOR US/DE/NL.
Catálogo de proveedores
Checkboxes de columnas visibles, filtros, checkboxes de selección y selector de acción masiva. Acciones por fila: Aceptar, Descartar, Actualizar, Aplicar baja, Reactivar, Reintentar actualización.
Sincronización V2
Ejecuta sincronización de catálogo intermedio/proveedor según las reglas V2. Los controles de inicio/parada modifican procesos, no deben ejecutarse sin revisar alcance y entorno.