Referencia de importación y límites

Este documento es una referencia para la pantalla Import & Limits del plugin ADP Car Market Hub (Car Market Hub → Import & Limits). Cubre el método de activación, la programación automática, el asistente de importación manual, la configuración del cron del servidor, los límites de procesamiento de imágenes, los valores predeterminados de importación y la opción de la zona de peligro Full Sync.

Cuándo usar este documento

Utilice esta referencia cuando configure las importaciones automáticas por primera vez, cuando cambie entre el cron de WordPress y una tarea cron real del servidor, al ajustar el rendimiento de la importación para inventarios grandes, o al activar Full Sync para eliminar los vehículos que se han retirado de la venta.

Descripción general

La pantalla está organizada en las siguientes tarjetas:

1. Current Import Status — un resumen dinámico que indica si las importaciones automáticas están activas (a través de Server Cron o WP Cron) o desactivadas, además de cuatro tarjetas de KPI: Imported Vehicles, Configured Sellers, Pending Images y Last Run Errors. Un interruptor Show IDs / Hide IDs revela los ID de vendedor configurados en la misma línea.
2. Last Run + Manual Import — métricas de la última importación y un asistente guiado para iniciar una importación bajo demanda.
3. Automation Settings — elija el método de activación (cron de WordPress o Server Cron) y configure la programación.
4. Server Cron Setup — visible solo en el modo Server Cron; proporciona la URL de activación REST, el token secreto y ejemplos de comandos cron.
5. Image Processing and Stability — límites por ejecución e interruptor de cola de imágenes para evitar tiempos de espera de PHP.
6. Import Defaults — valores predeterminados aplicados a los vehículos recién importados, incluyendo las imágenes y la conversión a WebP.
7. Re-listing detection — reconoce vehículos que fueron eliminados y vueltos a publicar bajo un nuevo ID de anuncio de AutoScout24 (mismo VIN) para evitar duplicados, mantener estable la URL pública y realizar un seguimiento del historial de precios.
8. Danger Zone — interruptor de Full Sync, además de la opción de eliminación suave / período de gracia que controla cómo se gestionan los vehículos eliminados.

Requisitos o prerrequisitos

• Credenciales de API operativas y al menos un Seller ID configurado en Settings.
• Para el modo Server Cron: la capacidad de añadir tareas cron en su entorno de hosting, además de la capacidad de llamar a URLs REST de WordPress desde el servidor.
• Para Full Sync: se recomienda encarecidamente realizar una copia de seguridad reciente.

Instrucciones paso a paso

Ejecutar una importación manual

1. Abra Car Market Hub → Import & Limits.
2. En la tarjeta Last Run / Manual Import, haga clic en Start Import Now.
3. Aparecerá el área del asistente, mostrando un mensaje de estado, una barra de progreso, el tiempo estimado restante (ETA) y una tabla de recuentos de elementos insertados, actualizados, omitidos, errores y eliminados por Full Sync.
4. Utilice Pause, Continue o Cancel según sea necesario. Si se detecta una cola pausada en una visita posterior, se mostrará un botón Resume.

Cambiar al cron de WordPress y programar importaciones automáticas

1. En Automation Settings, seleccione WordPress Cron.
2. Active Run imports automatically via WordPress Cron.
3. Elija una Import Frequency de las programaciones disponibles de WP-Cron.
4. Para Daily o Twice Daily, establezca una Start Time en formato de 24 horas HH:MM. Para el intervalo personalizado, establezca Interval (Minutes, min. 15).
5. Haga clic en Save Import & Limits settings.

Cambiar a Server Cron

1. En Automation Settings, seleccione Server Cron. El plugin desactiva su programación de cron de WordPress cuando este modo está activo.
2. Aparecerá la tarjeta Server Cron Setup con dos pasos: - Paso 1: añada define( 'DISABLE_WP_CRON', true ); a wp-config.php. - Paso 2: añada dos tareas cron en el servidor: una para llamar a la URL de activación REST y otra para mantener wp-cron.php en funcionamiento para el procesamiento de imágenes.
3. Si aún no existe ningún token, haga clic en Generate Token (en el modo Server Cron normalmente se crea uno automáticamente). A continuación, copie la REST Trigger URL y el Secret Token de la tarjeta. Copie la URL de inmediato: solo se muestra durante unos 15 minutos, tras los cuales se oculta hasta que vuelva a generar el token.
4. Utilice los Example Cron Commands como punto de partida y ajuste la frecuencia a sus necesidades.
5. Haga clic en Save Import & Limits settings.
6. Para rotar el secreto, haga clic en Regenerate Token y actualice la entrada del cron de su servidor con la nueva URL.

Configurar el procesamiento de imágenes para mayor estabilidad

1. En Image Processing and Stability, establezca Vehicles per Run (0 significa sin límite; se sugiere entre 50 y 80 para catálogos grandes).
2. Mantenga activado Enable Image Queue para que solo la primera imagen se cargue inmediatamente y el resto se procese de forma asíncrona.
3. Guarde los cambios.

Establecer valores predeterminados para los vehículos recién importados

1. En Import Defaults, elija el Default Post Status (Publish o Draft).
2. Opcionalmente, seleccione un Default Post Author; elija (keep current user) para conservar el comportamiento existente.
3. Active o desactive Import Images para controlar si se descargan los archivos adjuntos de imagen.
4. Opcionalmente, active Convert Images to WebP y elija una WebP Quality entre el 10% y el 100% en pasos del 5% (se recomienda entre el 75% y el 85%).
5. Establezca Max Images per Listing (0 = sin límite) para limitar el número de imágenes descargadas por vehículo.
6. Guarde los cambios.

Activar la detección de nuevas publicaciones (re-listing)

1. Abra Car Market Hub → Import & Limits y busque la tarjeta Re-listing detection.
2. Mantenga activado Enable re-listing detection (está activado por defecto).
3. Guarde los cambios. A partir de este momento, cuando un vehículo se vuelva a publicar bajo un nuevo ID de anuncio de AutoScout24 pero con el mismo VIN, se fusionará con el vehículo existente (sin duplicados), se aplicará el nuevo precio, se conservará la URL pública y se registrará un historial de precios junto con un contador de nuevas publicaciones.

Activar Full Sync y elegir cómo se gestionan los vehículos eliminados (Danger Zone)

1. Cree una copia de seguridad de su base de datos y del directorio de subidas (uploads).
2. En la Danger Zone, active Enable Full Sync y confirme el cuadro de diálogo de advertencia.
3. Decida cómo se gestionarán los vehículos eliminados: - Eliminación suave (recomendado, por defecto): mantenga activado Hold removed vehicles (soft delete). El vehículo que desaparezca de AutoScout24 se ocultará (se establecerá como draft) y se conservará durante el Grace period (days) que configure (por defecto 30). Si se vuelve a publicar dentro de ese plazo, se restaurará en su lugar: misma página, URL e historial de precios. Solo después de que expire el período de gracia se eliminará de forma permanente mediante una limpieza diaria. - Eliminación inmediata: desactive Hold removed vehicles (soft delete). El vehículo retirado se eliminará de forma permanente en la siguiente ejecución, incluyendo sus imágenes importadas y destacadas.
4. Guarde los cambios.

Referencia de configuración

Current Import Status

En la parte superior de la pantalla, una frase dinámica indica si las importaciones automáticas están actualmente activas (y si se ejecutan a través de Server Cron o WP Cron) o desactivadas. Debajo se muestran cuatro tarjetas de KPI:

Last Run

El resumen de Last Run informa de las métricas de la importación más reciente: insertados, actualizados, omitidos y errores. Cuando Full Sync está activado, también puede informar, para los vehículos que ya no están en AutoScout24, de un contador Held (vehículos ocultos como borradores durante su período de gracia cuando la eliminación suave está activada) y un contador Deleted (vehículos eliminados de forma permanente).

Trigger Method

Configuración del cron de WordPress (visible solo cuando se selecciona el cron de WordPress)

Configuración de Server Cron (visible solo cuando se selecciona Server Cron)

Image Processing and Stability

Import Defaults

Re-listing detection

Danger Zone

---

Cómo funcionan la detección de republicación y el historial de precios

Algunos concesionarios actualizan su posicionamiento en AutoScout24 eliminando un anuncio y volviéndolo a crear. AutoScout24 emite entonces un nuevo ID de anuncio, a menudo con un precio más bajo, mientras que el coche físico conserva el mismo VIN (número de bastidor). Dado que el importador normalmente asocia los vehículos por el ID de anuncio, dicha republicación crearía de otro modo un duplicado o, con la Sincronización Completa (Full Sync), restablecería el historial del coche.

Con la Detección de republicación activada, la importación funciona de la siguiente manera:

1. El importador primero intenta asociar el anuncio entrante por su ID de anuncio de AutoScout24 (como antes).
2. Si no encuentra ninguna coincidencia, recurre a la asociación por VIN normalizado (en mayúsculas y sin caracteres no alfanuméricos). Un VIN que esté vacío o sea demasiado corto para ser fiable se ignora, por lo que los anuncios sin VIN se comportan exactamente igual que antes.
3. Si exactamente un vehículo existente tiene ese VIN, se actualiza directamente: se aplican el nuevo ID de anuncio y el nuevo precio, y el slug/URL público se mantiene sin cambios para preservar los enlaces y el SEO. No se crea ningún duplicado.
4. Si el VIN es ambiguo (ya está presente en más de un vehículo), el plugin no realiza una fusión automática; actúa de forma segura y deja los registros intactos.

Qué se registra en un vehículo republicado:

• Historial de precios: cada cambio de precio (y el precio inicial) se almacena como una entrada con fecha, de modo que el patrón de eliminar y volver a publicar más barato se vuelve visible.
• IDs de anuncios de AutoScout24 anteriores: la cadena de IDs de anuncios que ha tenido el coche.
• Visto por primera vez: se conserva la fecha de importación original (y se rellena retroactivamente para los vehículos existentes), por lo que los días en stock (days-on-lot) siguen siendo precisos.
• Contador de republicaciones y la última variación de precio (price delta).

Dónde se puede ver:

• Columna de la lista de vehículos: una columna Republicación muestra una insignia Re-listed n× y el último cambio de precio (▼ bajada de precio / ▲ subida de precio).
• Editor de vehículos: un cuadro de Republicación e historial de precios muestra la fecha en que se vio por primera vez, los IDs de anuncios anteriores y el historial completo de precios.

Los desarrolladores pueden engancharse a la acción as24ci_vehicle_relisted ($post_id, $previous_listing_id, $current_listing_id, $delta) para integrarse con otros sistemas, y activar o desactivar toda la función con el filtro as24ci_enable_relisting_detection.

Cómo funcionan el borrado suave y el periodo de gracia

El borrado suave (soft delete) solo se aplica mientras la Sincronización Completa (Full Sync) está activada. Cambia lo que sucede con un vehículo que ya no es devuelto por la API de AutoScout24:

1. En la primera ejecución en la que falta el vehículo, este se oculta: el estado de su entrada se establece en borrador (se elimina del frontend público) y se registra la fecha de eliminación. No se elimina de forma definitiva.
2. El vehículo se conserva durante el periodo de gracia configurado (por defecto, 30 días).
3. Si el mismo vehículo se vuelve a importar dentro del periodo de gracia —asociado por ID de anuncio o por VIN (ver detección de republicación)—, se restaura directamente: se conservan la entrada original, la URL y el historial de precios, y se vuelve a establecer en su estado anterior.
4. Un cron de limpieza diario elimina de forma permanente los vehículos cuyo periodo de gracia ha expirado (eliminando las imágenes importadas y destacadas), para que nada se acumule indefinidamente.

Esto soluciona el problema de que un vehículo sea eliminado en un ciclo de sincronización y solo se vuelva a publicar en uno posterior: con la eliminación inmediata (definitiva), la entrada original ya habría desaparecido, pero con el borrado suave se mantiene como borrador y se puede restaurar.

El editor de vehículos muestra un aviso en un vehículo retenido, por ejemplo: “Eliminado de AutoScout24 el … — programado para eliminación permanente el … a menos que se vuelva a publicar.” Los desarrolladores pueden alternar este comportamiento con el filtro as24ci_enable_soft_delete.

Notas de funcionamiento

• Al cambiar a Cron del servidor, el evento WP-Cron del plugin se desactiva automáticamente, por lo que la misma programación no se ejecutará dos veces.
• El token de cron se genera automáticamente la primera vez que se carga la pantalla solo en el modo Cron del servidor, de modo que la URL de activación esté lista cuando la necesite. En el modo WP-Cron no se genera ningún token automáticamente y la URL de activación permanece oculta; cambie a Cron del servidor (o haga clic en Generar token) para crear uno.
• La conversión a WebP se realiza en el servidor. Si la extensión de PHP requerida no está presente, la conversión se omite silenciosamente; verifíquelo en los registros y en la pantalla de Sistema y ayuda.
• La cola de imágenes es independiente del límite de vehículos por ejecución. Ambos pueden estar activos al mismo tiempo.
• El límite de "Vehículos por ejecución" se aplica a las importaciones programadas. El asistente de importación manual puede iterar a través de los lotes automáticamente hasta que se procese todo el inventario.
• Al guardar cualquiera de los botones de cada tarjeta, se guarda todo el formulario de Importación y límites (el formulario abarca varias tarjetas).
• El token de cron, la URL de activación REST y los comandos de cron de ejemplo que se muestran en la interfaz de administración dependen del entorno. No copie valores de la documentación; cópielos siempre de su pantalla activa.
• La Detección de republicación necesita un VIN para fusionar un vehículo republicado. Los anuncios sin VIN se asocian únicamente por el ID de anuncio y se comportan como antes.
• El Borrado suave solo tiene efecto mientras la Sincronización Completa (Full Sync) está activada. Con la Sincronización Completa desactivada, los vehículos que faltan en la API simplemente se conservan.
• La limpieza del periodo de gracia del borrado suave se ejecuta una vez al día a través del cron de WordPress. En sitios con muy poco tráfico (modo WP-Cron), los vehículos caducados pueden eliminarse un poco más tarde de la fecha exacta de expiración.

Resolución de problemas

• La programación nunca se ejecuta (modo WP-Cron). El cron de WordPress solo se activa cuando se visita el sitio. En sitios con poco tráfico, cambie a Cron del servidor para una ejecución fiable.
• El activador REST devuelve un error 401/403. El token de la URL no coincide. Copie la URL de la administración de nuevo o regenere el token.
• Tiempos de espera de PHP (timeouts) durante la importación. Reduzca los Vehículos por ejecución (pruebe con 50), mantenga activada la opción Activar cola de imágenes y considere aumentar los valores max_execution_time y memory_limit del servidor si su proveedor de hosting lo permite.
• Las imágenes no se descargan. Confirme que la opción Importar imágenes está activada y que el directorio de subidas tiene permisos de escritura. Revise los Registros.
• La conversión a WebP no tiene efecto. Confirme que PHP GD o Imagick tienen soporte para WebP en el servidor. Verifíquelo en la pantalla de Sistema y ayuda.
• La Sincronización Completa eliminó vehículos de forma inesperada. La Sincronización Completa elimina cualquier elemento que falte en la respuesta de la API. Si también realiza ediciones manuales, restaure desde una copia de seguridad y desactive la Sincronización Completa.
• La importación manual no se inicia. Revise la consola del navegador en busca de errores AJAX y verifique que el Dashboard informe de una conexión de API correcta.
• El mismo coche aparece dos veces después de que un concesionario lo haya vuelto a publicar. Active la Detección de republicación para que el nuevo anuncio se fusione con el vehículo existente mediante el VIN. Tenga en cuenta que un vehículo cuyo anuncio no tenga VIN no se puede fusionar automáticamente.
• Un coche republicado no se ha fusionado. El anuncio no tiene VIN, o el VIN ya existe en más de un vehículo (ambiguo). En el caso ambiguo, el plugin decide deliberadamente no realizar la fusión automática; resuelva el duplicado manualmente.
• Un coche eliminado sigue apareciendo como borrador. Se trata del borrado suave que lo retiene durante su periodo de gracia. Se restaura automáticamente si el coche se vuelve a publicar, y se elimina de forma permanente tras el periodo de gracia. Para eliminar los vehículos retirados de forma inmediata, desactive Retener vehículos eliminados (borrado suave) en la Zona de peligro.
• Los vehículos retenidos nunca se limpian. La limpieza se ejecuta diariamente a través de WP-Cron. En sitios con poco tráfico, cambie a Cron del servidor o confirme que WP-Cron se está ejecutando (Sistema y ayuda).

Documentos relacionados

• Referencia de configuración
• Referencia del importador de vehículos
• Referencia de registros
• Referencia de sistema y ayuda
• Referencia de herramientas