Referencia de importación universal

Este documento es una referencia para la pantalla Universal Import (Importación universal) del plugin ADP Car Market Hub (CMH Center → Universal Import). Es el lugar central donde se conecta cada fuente de datos y donde se almacenan todas las credenciales de la API: AutoScout24, carcuro, un feed automático, una bandeja de entrada de correo electrónico o una subida de archivos única.

Cuándo usar este documento

Utilice esta referencia cuando desee incorporar vehículos al plugin, cuando necesite introducir o cambiar las credenciales de la API para una fuente de datos, o cuando desee comprobar si una fuente está conectada. Independientemente de la fuente, cada vehículo termina en el mismo inventario y es procesado por el mismo flujo de importación.

Descripción general

Universal Import presenta sus fuentes de datos como un único y ordenado acordeón. Cada fila es una fuente con su estado de conexión mostrado a la derecha:

• una etiqueta verde de Connected (Conectado) (AutoScout24, carcuro) o Active (Activo) (feed, correo electrónico) cuando la fuente está configurada, o
• una llamada a la acción Configure (Configurar) cuando no lo está.

Haga clic en una fila para expandirla y configurar esa fuente; al abrir una fila se contraen las demás, de modo que solo sea visible la fuente en la que está trabajando. Después de guardar una fuente, o de ejecutar una importación para ella, su fila permanece abierta para que pueda ver el resultado.

Las cinco fuentes son:

1. AutoScout24: sincronización de inventario en vivo a través de la API de AutoScout24.
2. carcuro: sincronización de inventario en vivo a través de su token de empresa de carcuro.
3. Importación automática (feed): una extracción programada desde una URL https://, una ubicación FTP/SFTP, una carpeta del servidor o un enlace compartido en la nube.
4. Importación por correo electrónico: recopile la exportación del inventario de un buzón de correo automáticamente.
5. Importar un archivo desde su software de concesionario (DMS): una subida única de un archivo CSV, XML, Excel o JSON (o un archivo ZIP con imágenes).

Todas las fuentes en vivo y programadas se ejecutan en la programación de importación central del plugin, configurada en Import & Limits (consulte la Referencia de importación y límites). Introduzca las credenciales una vez aquí; el plugin se encarga del resto según la programación que establezca de forma centralizada.

¿A dónde fueron las credenciales de la API? En versiones anteriores, la conexión de la API de AutoScout24 se configuraba en Settings (Ajustes). Todas las credenciales de las fuentes de datos ahora residen aquí, en la página Universal Import, en un solo lugar y con un estado de conexión visible. La pantalla Settings conserva únicamente las opciones generales (como la moneda predeterminada) y una tarjeta de Data sources & API connections (Fuentes de datos y conexiones API) que enlaza aquí.

Requisitos o prerrequisitos

• Acceso a CMH Center → Universal Import (requiere la capacidad de gestión del plugin).
• Una licencia válida del plugin: las importaciones y la sincronización programada requieren una licencia activa (consulte la Referencia de ajustes).
• Credenciales para cualquier fuente que utilice: credenciales de la API de AutoScout24, un token de empresa de carcuro, credenciales de feed/FTP/SFTP o credenciales de buzón IMAP. Estas son emitidas por su proveedor, no por el plugin.
• Para la importación por correo electrónico: la extensión PHP imap en el servidor.

Instrucciones paso a paso

1. Abra CMH Center → Universal Import.
2. Haga clic en la fila de la fuente que desea conectar.
3. Introduzca los detalles de esa fuente (consulte la referencia por fuente a continuación) y guarde. La etiqueta de estado de la derecha cambiará a Connected / Active.
4. Establezca la frecuencia con la que el plugin realiza la importación en CMH Center → Import & Limits; esta programación única gestiona cada fuente conectada.
5. Para importar de inmediato, utilice el botón de ejecución de la fuente (por ejemplo, Import from carcuro now) o ejecute una importación manual desde Import & Limits.
6. Compruebe el resultado en CMH Center → Car Importer y en el inventario de CMH Cars.

Referencia de configuración

AutoScout24

Conecte su inventario en vivo de AutoScout24 directamente a través de la API.

Cuando las credenciales están presentes, la fila muestra Connected y aparece un enlace Open Car Importer para que pueda ejecutar o gestionar la sincronización. Al guardar nuevas credenciales se borra el token de acceso en caché y el estado de conexión de la API en caché, de modo que la siguiente solicitud utilice los nuevos valores.

carcuro

Si su inventario reside en carcuro, conéctelo directamente, exactamente igual que AutoScout24. Solo proporciona un token; las columnas se mapean automáticamente, por lo que no hay nada que mapear manualmente.

Active Import and sync automatically para permitir que el plugin extraiga datos de carcuro en la programación de importación central. Utilice Import from carcuro now para ejecutar una importación de inmediato. Aparecen nuevos vehículos, los vehículos eliminados en carcuro se eliminan aquí; no hay diferencia entre usar AutoScout24 o carcuro.

Importación automática (feed)

En lugar de subir un archivo cada vez, permita que el plugin obtenga su inventario automáticamente.

El formato del archivo (CSV, XML o Excel) se detecta automáticamente y se reutiliza el mapeo de columnas que guardó en el paso de subida de archivos. Suba un archivo y guarde el mapeo una vez antes de activar el feed.

Importación por correo electrónico

Si su software de concesionario envía por correo electrónico la exportación del inventario, el plugin puede recopilarla automáticamente. Se conecta a un buzón de correo, toma el mensaje coincidente más reciente con un archivo adjunto CSV, XML, Excel o JSON y lo importa utilizando el mapeo de columnas guardado.

La importación por correo electrónico requiere la extensión PHP imap. Si no está instalada, la tarjeta muestra un aviso y puede utilizar en su lugar un feed https:// / FTP / SFTP o una carpeta del servidor.

Importar un archivo desde su software de concesionario (DMS)

Una subida única para cualquier exportación de software de concesionario (DMS).

• Formatos aceptados: CSV, TXT, TSV, XML, Excel (.xlsx) y JSON, o un archivo ZIP que contenga el archivo de datos junto con las imágenes de los vehículos (haga referencia a cada imagen por su nombre de archivo en su columna de imágenes).
• Mapee las columnas una vez. Después de la subida, asocie cada campo del plugin a una columna de su archivo. Solo se requieren Marca/Modelo (o versión) y un número de stock o VIN; deje en "not mapped" (no mapeado) todo lo que su exportación no contenga. Un paso opcional de Auto-map con IA puede sugerirle el mapeo para que lo revise.
• Vista previa antes de importar. Una simulación muestra cuántas filas son válidas, cuáles serían nuevas o actualizadas, y cualquier fila con problemas; no se escribe nada hasta que elija Import now (Importar ahora).
• El mapeo se guarda y se reutiliza para la siguiente subida y para las fuentes de feed automático y correo electrónico.
• La codificación se gestiona por usted: los archivos Windows-1252 se convierten a UTF-8 (se conservan las diéresis suizas y caracteres similares), y las celdas de varias líneas en los archivos CSV se leen correctamente.

Notas operativas

• Una programación para todo. AutoScout24 y carcuro no tienen una programación propia: se ejecutan en la programación de importación central en Import & Limits. Las fuentes de feed y correo electrónico ofrecen además su propio intervalo. Siempre se puede activar una importación manual.
• Un único flujo para todo. Independientemente de la fuente, cada vehículo pasa por el mismo procesamiento posterior: detección de duplicados basada en VIN, el período de gracia de eliminación suave para los vehículos que desaparecen, normalización de valores, importación de imágenes, generación de slugs y asignación de equipos. Cada ajuste se aplica a todo el inventario, independientemente de la fuente de la que provenga el vehículo.
• Los secretos se encriptan en reposo. El Client Secret de AutoScout24, el token de carcuro y las contraseñas de feed/buzón de correo se almacenan encriptados en la base de datos a través del almacén de secretos del plugin, no como texto plano.
• Los datos de demostración están disponibles en la página Tools (Herramientas) para realizar pruebas y se pueden eliminar de nuevo en cualquier momento.

Resolución de problemas

• Una fuente muestra "Configure" en lugar de "Connected". Faltan las credenciales o están incompletas. Abra la fila y vuelva a introducirlas. Para AutoScout24 necesita al menos un Client ID y un Client Secret; para carcuro necesita el token de empresa.
• carcuro respondió con un error HTTP / rechazó la solicitud. El token de empresa probablemente sea incorrecto. Cópielo de nuevo desde carcuro en Webseite › Fahrzeugliste › Integration.
• La fuente de feed o correo electrónico indica que no se ha guardado ningún mapeo de columnas. Suba un archivo una vez en el paso de subida de archivos y guarde primero el mapeo; las fuentes de feed y correo electrónico reutilizan ese mapeo.
• La importación por correo electrónico no está disponible. Al servidor le falta la extensión PHP imap. Utilice en su lugar una fuente de feed o de carpeta del servidor, o pida a su proveedor de hosting que active imap.
• No se importa nada según lo programado. Confirme que la fuente está activada, que hay una licencia válida activa y que la programación central en Import & Limits se está ejecutando (consulte Cron y procesamiento en segundo plano).

Documentos relacionados

• Referencia de ajustes
• Referencia del importador de vehículos
• Referencia de importación y límites
• Referencia de mapeo
• Flujo de trabajo de importación de vehículos
• External API Credentials