Documentación · Referencia del administrador
Referencia de conexiones
Este documento es una referencia para la pantalla Conexiones del plugin ADP Car Market Hub (CMH Center → Connections). Es el lugar central donde se conecta cada fuente de datos y donde se almacenan todas las credenciales de la API: AutoScout24, mobile.de, carcuro, un feed automático, una bandeja de entrada de correo electrónico o una subida de archivos única.
Cuándo utilizar 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. Sea cual sea la fuente, cada vehículo termina en el mismo inventario y es procesado por el mismo flujo de importación.
Descripción general
Conexiones 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 Conectado (AutoScout24, mobile.de, carcuro) o Activo (feed, correo electrónico) cuando la fuente está configurada, o
- una llamada a la acción de Configurar cuando no lo está.
Haga clic en una fila para expandirla y configurar esa fuente; al abrir una fila se colapsan las demás, de modo que solo es 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 seis fuentes son:
- AutoScout24: sincronización de inventario en vivo a través de la API de AutoScout24.
- mobile.de: sincronización de inventario en vivo a través de sus credenciales de la API de vendedor de mobile.de.
- carcuro: sincronización de inventario en vivo a través de su token de empresa de carcuro.
- Importación automática (feed): una extracción programada desde una URL
https://, una ubicación FTP/FTPS/SFTP, una carpeta de servidor o un enlace compartido en la nube. - Importación por correo electrónico: recopila la exportación del inventario de un buzón de correo de forma automática.
- Importar un archivo desde su software de concesionario (DMS): una subida única de un archivo CSV, TXT, TSV, XML, Excel (
.xlsx) 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 Importación y límites (consulte la Referencia de importación y límites). Introduce 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 Ajustes. Todas las credenciales de las fuentes de datos ahora residen aquí, en la página Conexiones, en un solo lugar y con un estado de conexión visible. La pantalla de Ajustes conserva únicamente las opciones generales (como la moneda predeterminada) y una tarjeta de Fuentes de datos y conexiones API que enlaza aquí.
Requisitos o prerrequisitos
- Acceso a CMH Center → Conexiones (requiere la capacidad de gestión del plugin).
- Una licencia de plugin válida: las importaciones y la sincronización programada requieren una licencia activa (consulte la Settings Reference).
- Credenciales para cualquier fuente que utilice: credenciales de la API de AutoScout24, credenciales de la API de vendedor de mobile.de, 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
imapen el servidor.
Instrucciones paso a paso
- Abra CMH Center → Conexiones.
- Haga clic en la fila de la fuente que desea conectar.
- 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 Conectado / Activo.
- Establezca la frecuencia con la que el plugin realiza las importaciones en CMH Center → Importación y límites; esta programación única gestiona cada fuente conectada.
- Para importar de inmediato, utilice el botón de ejecución de la fuente (por ejemplo, Importar desde carcuro ahora) o ejecute una importación manual desde Importación y límites.
- Compruebe el resultado en CMH Center → Referencia del importador de vehículos y en el inventario de CMH Cars.
Configuration reference
AutoScout24
Conecte su inventario activo de AutoScout24 directamente a través de la API.
| Campo | Tipo | Notas |
|---|---|---|
| API Base URL | URL | URL completa incluyendo https://. Validada; se eliminan las barras diagonales finales. Una URL no válida se rechaza y se mantiene el valor anterior. |
| Seller ID | Texto | Uno o más Seller IDs, separados por comas. Solo se conservan letras, dígitos, guiones bajos y guiones tras la desinfección. |
| Client ID | Texto | Identificador de cliente de tipo OAuth proporcionado por AutoScout24. |
| Client Secret | Contraseña | Almacenado encriptado en reposo a través del almacén de secretos del plugin. Deje el campo vacío para mantener el secreto actual; introduzca un nuevo valor para reemplazarlo. |
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.
mobile.de
Conecte su inventario activo de mobile.de directamente a través de la API de vendedor; al igual que con carcuro, las columnas se mapean automáticamente, por lo que no hay nada que mapear manualmente.
| Campo | Tipo | Notas |
|---|---|---|
| API user name | Texto | Su nombre de usuario de la API de mobile.de. |
| API password | Contraseña | Almacenado encriptado en reposo. Deje el campo vacío para mantener la contraseña actual; introduzca un nuevo valor para reemplazarla. |
| Customer number | Texto | Opcional. |
| Sandbox (test environment) | Interruptor | Cuando está activado, las solicitudes van al entorno de pruebas de mobile.de en lugar de al de producción. |
Estas credenciales provienen del área de distribuidores de mobile.de: abra su nombre de cuenta › "mobile.de Konto" › "Inserats-Einbindung" (Integración de anuncios) para encontrar el nombre de usuario y la contraseña de la API.
Utilice Save mobile.de settings para guardar la conexión, e Import from mobile.de now para ejecutar una importación de inmediato. Las importaciones y sincronizaciones de mobile.de se realizan en la programación central de importación del plugin con mapeo automático de columnas, exactamente igual que carcuro.
carcuro
Si su inventario se encuentra en carcuro, conéctelo directamente, exactamente igual que AutoScout24. Solo tiene que proporcionar un token; las columnas se mapean automáticamente, por lo que no hay nada que mapear manualmente.
| Campo | Tipo | Notas |
|---|---|---|
| carcuro company token | Contraseña | Su company_token de carcuro. Almacenado encriptado en reposo. Se encuentra en carcuro en Webseite › Fahrzeugliste › Integration. Deje vacío para mantener el token almacenado; marque Remove stored token para borrarlo. |
| Which vehicles | Selección | Available vehicles (por defecto), All vehicles o Sold vehicles. |
| Complete inventory | Interruptor | Cuando está activado, carcuro se trata como su inventario completo: los vehículos que ya no se devuelvan se eliminarán inmediatamente en la siguiente ejecución, imitando el comportamiento de AutoScout24. |
Habilite Import and sync automatically para permitir que el plugin extraiga datos de carcuro en la programación central de importación. Utilice Import from carcuro now para ejecutar una importación de inmediato. Aparecerán nuevos vehículos y se eliminarán los vehículos retirados en carcuro; no hay ninguna diferencia entre usar AutoScout24 o carcuro.
Importación automática (feed)
En lugar de subir un archivo cada vez, deje que el plugin obtenga su inventario automáticamente.
| Campo | Tipo | Notas |
|---|---|---|
| Enable automatic import | Interruptor | Obtener e importar según la programación de abajo. |
| Feed location | Texto | Una URL https://, una ubicación ftp:// o sftp://, o una ruta de archivo absoluta del servidor. Se aceptan enlaces compartidos en la nube (Dropbox, Google Drive, OneDrive, Google Sheets); pegue el enlace compartido tal cual. |
| Interval | Selección | Cada hora, dos veces al día o diariamente. |
| Authentication | Selección + campos | None, HTTP Basic (también usado para FTP/SFTP) o Bearer token. La contraseña/token se almacena encriptada en reposo. |
| Complete inventory | Interruptor | Tratar el feed como su inventario completo (retener/eliminar los vehículos que ya no estén en él). |
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 habilitar 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.
| Campo | Tipo | Notas |
|---|---|---|
| Enable e-mail import | Interruptor | Comprobar el buzón de correo según la programación de abajo. |
| IMAP server / Port / Encryption | Texto / Número / Selección | Host del buzón, puerto y SSL / STARTTLS / None. |
| Username / Password | Texto / Contraseña | Credenciales del buzón de correo. La contraseña se almacena encriptada en reposo. |
| Folder | Texto | Carpeta del buzón a leer (por defecto INBOX). |
| Only from sender | Texto | Opcional. Solo procesar correos electrónicos de esta dirección. |
| Subject contains | Texto | Opcional. Solo procesar correos electrónicos cuyo asunto contenga este texto. |
| Attachment filename | Texto | Opcional. Coincidir el archivo adjunto por nombre (comodines * y ?). Vacío = primer archivo adjunto compatible. |
| Interval | Selección | Cada hora, dos veces al día o diariamente. |
| Complete inventory | Interruptor | Tratar el archivo adjunto como su inventario completo. |
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 paquete 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 "no mapeado" todo lo que su exportación no contenga. Un paso opcional de Auto-map con AI 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.
- 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 de forma automática: 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 sola planificación para todo. AutoScout24, mobile.de y carcuro no tienen una planificación propia; se ejecutan bajo la planificación de importación central en Importación y límites. Las fuentes de feed y correo electrónico ofrecen adicionalmente su propio intervalo. Siempre se puede activar una importación manual.
- Un único flujo de trabajo para todo. Independientemente de la fuente, cada vehículo pasa por el mismo procesamiento posterior: detección de republicación basada en VIN, 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, sin importar de qué fuente provenga el vehículo.
- Las credenciales secretas se cifran en reposo. El Client Secret de AutoScout24, la contraseña de la API de mobile.de, el token de carcuro y las contraseñas de feed/buzón de correo se almacenan cifrados en la base de datos a través del almacén de secretos del plugin, no como texto plano.
- Datos de demostración están disponibles desde la página de Herramientas para realizar pruebas, y se pueden eliminar de nuevo en cualquier momento.
Resolución de problemas
- Una fuente muestra "Configurar" en lugar de "Conectado". Las credenciales faltan 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 la empresa.
- carcuro respondió con un error HTTP / rechazó la solicitud. El token de la 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 solicite a su proveedor de hosting que habiliteimap. - No se importa nada según la planificación. Confirme que la fuente está habilitada, que hay una licencia válida activa y que la planificación central en Referencia de importación y límites se está ejecutando (consulte Cron y procesamiento en segundo plano).