Referencia de herramientas

Este documento es una referencia para la pantalla Herramientas del plugin ADP Car Market Hub (Car Market Hub → Tools). Cubre las exportaciones, la gestión de caché, la sincronización de taxonomías, la prueba de conexión de la API, los datos de demostración y el centro de diagnóstico.

Cuándo utilizar este documento

Lea esto si necesita:

• Exportar datos de vehículos importados para copias de seguridad, auditorías o migración.
• Forzar al plugin a volver a obtener datos actualizados de la API de AutoScout24.
• Volver a asociar términos de taxonomía (marca, modelo, combustible, color...) a los vehículos importados.
• Verificar que las credenciales de la API funcionan correctamente.
• Instalar o eliminar datos de demostración para una demostración de ventas o un entorno de pruebas.
• Realizar diagnósticos específicos en una publicación de vehículo individual o generar una captura del sistema para soporte técnico.

Descripción general

La pantalla de Herramientas es la caja de herramientas operativas para los administradores. Agrupa las acciones de mantenimiento en tarjetas independientes para que puedan activarse sin salir de la página:

• Asistente de configuración — abre el Asistente de primera configuración opcional de seis pasos. Disponible en cualquier momento, incluso después de haber completado o saltado el asistente. Ejecutarlo de nuevo le permite reconfigurar el modo de configuración, el perfil del concesionario, la conexión con AutoScout24, las páginas predeterminadas y los valores predeterminados de las funciones del frontend; los ajustes existentes se conservan a menos que los cambie explícitamente.
• Exportar vehículos — descarga en CSV o JSON de los datos de los vehículos importados. Esta tarjeta solo aparece cuando la función de exportación está habilitada; se puede ocultar.
• Limpiador de caché — borra la caché del token OAuth2 y la caché de modelos.
• Sincronización de taxonomías — vuelve a aplicar los términos de taxonomía a partir de los valores almacenados para cada vehículo importado.
• Prueba de conexión de la API — realiza una solicitud en vivo contra AutoScout24 con las credenciales actuales.
• Datos de demostración — instala o elimina un conjunto etiquetado de vehículos de demostración, leads, alertas y analíticas.
• Centro de diagnóstico — diagnósticos de una sola publicación, vista previa de simulación (dry run) y una captura del sistema en JSON.

Requisitos o prerrequisitos

• Un usuario con la capacidad de gestión del plugin.
• Para que la prueba de conexión de la API y el limpiador de caché sean útiles: credenciales de API válidas configuradas en los Ajustes.
• Para diagnósticos en una sola publicación: el ID de publicación de WordPress de un vehículo importado.

Instrucciones paso a paso

Exportar vehículos importados

1. Abra Car Market Hub → Tools.
2. En la tarjeta Exportar vehículos, haga clic en Exportar CSV para flujos de trabajo con hojas de cálculo, o en Exportar JSON para datos estructurados y uso de desarrolladores.

Borrar cachés

1. En la tarjeta Limpiador de caché, haga clic en: - Borrar caché de tokens — elimina el token de acceso OAuth2 almacenado en caché. La siguiente solicitud a la API obtendrá un nuevo token. - Borrar caché de modelos — elimina los datos de búsqueda de vehículos y modelos almacenados en caché para que se vuelvan a generar bajo demanda.
2. La línea de estado indica si hay un token almacenado en caché actualmente.

Utilícelo después de realizar cambios en las credenciales, tras cambiar de entorno de API o cuando se requieran datos nuevos de la API.

Sincronizar taxonomías

1. En la tarjeta Sincronización de taxonomías, haga clic en Ejecutar sincronización de taxonomías.
2. El plugin recorre todas las publicaciones de vehículos importados y vuelve a aplicar las relaciones de términos de taxonomía (marca, modelo, combustible, color y otros atributos del vehículo) a partir de los valores almacenados en la tabla de vehículos.
3. El número de publicaciones procesadas se muestra después de la ejecución.

Utilícelo cuando parezca que faltan términos de filtrado, que están desactualizados o desincronizados (por ejemplo, después de una migración de base de datos o una reactivación del plugin).

Probar la conexión de la API

1. En la tarjeta Prueba de conexión de la API, haga clic en el botón de prueba.
2. El plugin realiza una solicitud en vivo a la API de AutoScout24 con las credenciales actuales e informa del resultado.

Ejecute esto después de actualizar las credenciales o cuando las importaciones comiencen a fallar inesperadamente.

Instalar o eliminar datos de demostración

1. En la tarjeta Datos de demostración, haga clic en Instalar datos de demostración.
2. El plugin instala 10 vehículos de demostración: 8 se publican inmediatamente y 2 aparecen como anuncios aún no importados en la página del Importador de vehículos para que pueda probar el flujo de trabajo de importación. También crea leads y alertas de búsqueda de ejemplo, así como analíticas sintéticas que cubren 30 días.
3. Para revertir el proceso, haga clic en Eliminar datos de demostración. Solo se eliminarán los registros creados por el instalador de demostración; los datos reales de los clientes no se verán afectados.

La tarjeta muestra un resumen en vivo de lo actualmente instalado (vehículos importados, anuncios pendientes del importador, leads, alertas y eventos de analíticas) o No hay datos de demostración instalados cuando no hay nada presente. Después de instalar o eliminar datos de demostración, un panel de resumen del último estado informa de lo que se ha creado o limpiado.

Utilícelo para demostraciones de productos, revisiones internas y pruebas en el frontend sin necesidad de una conexión en vivo con AutoScout24.

Diagnosticar una publicación de vehículo individual

1. En el Centro de diagnóstico, busque Diagnosticar una publicación de vehículo.
2. Introduzca el ID de publicación de WordPress de un vehículo importado y envíe el formulario.
3. El plugin devuelve los metadatos de la publicación, las referencias de las imágenes, la carga útil (payload) sin procesar de AutoScout24 (si está presente) y las respuestas de la API en vivo para los endpoints de anuncios y equipamiento.

Ejecutar una simulación (dry run)

1. En el Centro de diagnóstico, busque Simulación (dry run).
2. Envíe el formulario. El plugin previsualiza los datos que importaría de AutoScout24 sin escribir ningún cambio en la base de datos. La vista previa está limitada a aproximadamente 25 filas y se muestra como una vista previa en JSON.

Utilícelo para verificar la estructura de datos de la API antes de realizar una importación completa.

Compartir una captura del sistema

1. En el Centro de diagnóstico, despliegue Mostrar captura del sistema.
2. Copie el contenido JSON y adjúntelo a un ticket de soporte o compártalo con su equipo de operaciones.

La captura incluye la versión del plugin, la URL del sitio, las versiones de WordPress y PHP, el nombre del tema, el estado de los registros y una vista redactada de los ajustes clave del plugin (solo indicadores como Client ID configurado: sí/no; los secretos sin procesar no se exportan).

Referencia de configuración

La pantalla de Herramientas no almacena sus propios ajustes. Es un lanzador para operaciones puntuales.

Notas operativas

• Todas las acciones de esta pantalla son operaciones directas y puntuales. No hay programación de tareas aquí.
• El indicador de estado de la caché de tokens (Caché de tokens activa / Sin caché de tokens) refleja el token OAuth2 almacenado actualmente en el almacenamiento transitorio de WordPress.
• Los datos de demostración se identifican mediante una etiqueta interna para que su eliminación sea segura y no afecte a los registros reales de los clientes. Verifique este comportamiento en la versión actual del plugin antes de publicarlo si opera en un sitio de producción.
• Las exportaciones pueden ser de gran tamaño según el número de vehículos importados. El CSV se genera como un flujo de datos (stream); el JSON se genera en memoria.
• La búsqueda de diagnóstico de publicaciones realiza una llamada a la API en vivo a AutoScout24 para los endpoints de anuncios y equipamiento. La sección de resultados muestra cualquier error devuelto por la API.
• La captura del sistema omite intencionadamente los secretos sin procesar. Trátela como información de baja sensibilidad pero aun así interna.

Resolución de problemas

• La descarga de la exportación está vacía. Aún no se han importado vehículos, o bien otro plugin intercepta las solicitudes de admin-post.php. Confirme que el importador se ha ejecutado correctamente en la Referencia del importador de vehículos.
• La sincronización de taxonomías informa de cero publicaciones procesadas. Aún no existen publicaciones de vehículos. Ejecute una importación primero.
• La prueba de conexión de la API informa de un fallo. Vuelva a comprobar el Client ID, el Client Secret y la URL base en los Ajustes, luego haga clic en Borrar caché de tokens e inténtelo de nuevo.
• El diagnóstico devuelve "Faltan metadatos listingid o sellerid en esta publicación." La publicación no es un vehículo importado, o bien la publicación es anterior al diseño actual de almacenamiento de vehículos. Vuelva a importar el vehículo.
• Los datos de demostración no se instalan. Confirme que el usuario tiene la capacidad de gestión y que la base de datos puede escribir los registros de demostración. Consulte los Logs para obtener más detalles.
• La captura del sistema muestra client_id_set: no. Las credenciales no están almacenadas. Guárdelas en Ajustes antes de realizar la prueba.

Documentos relacionados

• Referencia de ajustes
• Referencia del importador de vehículos
• Referencia de importación y límites
• Referencia de Logs
• Referencia de sistema y ayuda
• Referencia de soporte