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 .csv con los campos source_slug;locale;titulo;slug;excerpt;description;parent_slug. Los obligatorios son source_slug, locale, titulo y slug.
  • source_slug es 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.
  • locale acepta en-US, de-DE y nl-NL. El idioma se guarda en _seo_locale (termmeta) y la nueva categoría product_cat se relaciona con su origen por seo_relations.relation_type = category_translation.
  • parent_slug señ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

  1. Subir trabajos: Añadir a pendientes, Añadir e iniciar.
  2. Estado: Iniciar / continuar, Pausar cola después del archivo actual, Detener importación actual, Procesar siguiente bloque adaptativo.
  3. 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:

  1. Seleccionar país US/DE/NL y categoría WooCommerce internacional existente.
  2. Introducir la ruta exacta categoryPath de VEVOR. La selección no toma automáticamente productos de otras categorías.
  3. Pulsar Previsualizar ofertas. Comprueba las primeras cinco ofertas aceptadas que no tengan producto enlazado.
  4. Confirmar y pulsar Crear hasta 5 fichas en borrador.
  5. Revisar fichas en WooCommerce → Productos → Borrador: categoría/país, texto disponible, imagen externa, enlace de afiliación, tipo de producto External y monedas.
  6. 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.