Riferimento Connessioni

Questo documento rappresenta un riferimento per la schermata Connections del plugin ADP Car Market Hub (CMH Center → Connections). È il luogo centrale in cui viene collegata ogni sorgente di dati e in cui vengono memorizzate tutte le credenziali API — AutoScout24, mobile.de, carcuro, un feed automatico, una casella di posta elettronica o un caricamento di file una tantum.

Quando utilizzare questo documento

Utilizza questo riferimento quando desideri importare veicoli nel plugin, quando hai bisogno di inserire o modificare le credenziali API per una sorgente di dati o quando vuoi verificare se una sorgente è connessa. Indipendentemente dalla sorgente, ogni veicolo finisce nello stesso inventario e viene elaborato dalla stessa pipeline di importazione.

Panoramica

Connections presenta le tue sorgenti di dati come un unico e ordinato menu a fisarmonica (accordion). Ogni riga rappresenta una sorgente con il relativo stato di connessione mostrato sulla destra:

• un badge verde Connesso (AutoScout24, mobile.de, carcuro) o Attivo (feed, e-mail) quando la sorgente è configurata, oppure
• un invito all'azione Configura quando non lo è.

Fai clic su una riga per espanderla e configurare quella sorgente; l'apertura di una riga comprime le altre, in modo che sia visibile solo la sorgente su cui stai lavorando. Dopo aver salvato una sorgente — o aver eseguito un'importazione per essa — la sua riga rimane aperta in modo da poterne vedere il risultato.

Le sei sorgenti sono:

1. AutoScout24 — sincronizzazione dell'inventario in tempo reale tramite l'API AutoScout24.
2. mobile.de — sincronizzazione dell'inventario in tempo reale tramite le tue credenziali API venditore di mobile.de.
3. carcuro — sincronizzazione dell'inventario in tempo reale tramite il tuo token aziendale carcuro.
4. Importazione automatica (feed) — un recupero pianificato da un URL https://, una posizione FTP/FTPS/SFTP, una cartella del server o un link di condivisione cloud.
5. Importazione e-mail — raccoglie automaticamente l'esportazione dell'inventario da una casella di posta elettronica.
6. Importa un file dal tuo software gestionale (DMS) — un caricamento una tantum di un file CSV, TXT, TSV, XML, Excel (.xlsx) o JSON (o un pacchetto ZIP con immagini).

Tutte le sorgenti in tempo reale e pianificate vengono eseguite sulla pianificazione centrale delle importazioni del plugin, configurata in Import & Limits (vedi Riferimento a importazione e limiti). Inserisci le credenziali una sola volta qui; il plugin gestisce il resto in base alla pianificazione impostata centralmente.

Dove sono finite le credenziali API? Nelle versioni precedenti, la connessione API AutoScout24 veniva configurata in Impostazioni. Tutte le credenziali delle sorgenti di dati ora risiedono qui nella pagina Connections, in un unico posto, con uno stato di connessione visibile. La schermata delle Impostazioni mantiene solo le opzioni generali (come la valuta predefinita) e una scheda Sorgenti di dati e connessioni API che rimanda qui.

Requisiti o prerequisiti

• Accesso a CMH Center → Connections (richiede la funzionalità di gestione del plugin).
• Una licenza del plugin valida — le importazioni e la sincronizzazione pianificata richiedono una licenza attiva (vedi Settings Reference).
• Credenziali per qualsiasi sorgente utilizzi: credenziali API AutoScout24, credenziali API venditore mobile.de, un token aziendale carcuro, credenziali feed/FTP/SFTP o credenziali della casella di posta IMAP. Queste vengono rilasciate dal tuo provider, non dal plugin.
• Per l'importazione via e-mail: l'estensione PHP imap sul server.

Istruzioni passo dopo passo

1. Apri CMH Center → Connections.
2. Fai clic sulla riga della sorgente che desideri connettere.
3. Inserisci i dettagli di quella sorgente (vedi il riferimento per singola sorgente qui sotto) e salva. Il badge di stato sulla destra diventa Connesso / Attivo.
4. Imposta la frequenza di importazione del plugin in CMH Center → Import & Limits — questa singola pianificazione gestisce ogni sorgente connessa.
5. Per importare immediatamente, utilizza il pulsante di esecuzione della sorgente (ad esempio Importa da carcuro ora) o esegui un'importazione manuale da Import & Limits.
6. Verifica il risultato in CMH Center → Car Importer e nell'inventario CMH Cars.

---

Configuration reference

AutoScout24

Connetti il tuo inventario live di AutoScout24 direttamente tramite l'API.

Quando le credenziali sono presenti, la riga mostra Connesso e appare un link Apri importatore veicoli per consentirti di eseguire o gestire la sincronizzazione. Il salvataggio di nuove credenziali cancella il token di accesso memorizzato nella cache e lo stato della connessione API memorizzato nella cache, in modo che la richiesta successiva utilizzi i nuovi valori.

mobile.de

Connetti il tuo inventario live di mobile.de direttamente tramite l'API del venditore — proprio come carcuro, le colonne vengono mappate automaticamente per te, quindi non c'è nulla da mappare manualmente.

Queste credenziali provengono dall'area rivenditori di mobile.de: apri il tuo nome account › "mobile.de Konto" › "Inserats-Einbindung" (Integrazione annunci) per trovare il nome utente e la password dell'API.

Usa Salva impostazioni mobile.de per memorizzare la connessione e Importa da mobile.de ora per eseguire immediatamente un'importazione. Le importazioni e le sincronizzazioni di mobile.de avvengono sulla pianificazione centrale delle importazioni del plugin con mappatura automatica delle colonne, esattamente come carcuro.

carcuro

Se il tuo inventario risiede in carcuro, connettilo direttamente — esattamente come AutoScout24. Devi solo fornire un token; le colonne vengono mappate automaticamente per te, quindi non c'è nulla da mappare manualmente.

Abilita Importa e sincronizza automaticamente per consentire al plugin di recuperare i dati da carcuro in base alla pianificazione centrale delle importazioni. Usa Importa da carcuro ora per eseguire immediatamente un'importazione. Appaiono i nuovi veicoli, i veicoli rimossi su carcuro vengono rimossi qui — non fa alcuna differenza se utilizzi AutoScout24 o carcuro.

Importazione automatica (feed)

Invece di caricare un file ogni volta, consenti al plugin di recuperare automaticamente il tuo inventario.

Il formato del file (CSV, XML o Excel) viene rilevato automaticamente e viene riutilizzata la mappatura delle colonne salvata nella fase di caricamento del file. Carica un file e salva la mappatura una volta prima di abilitare il feed.

Importazione via e-mail

Se il tuo software gestionale invia l'esportazione dell'inventario tramite e-mail, il plugin può raccoglierla automaticamente. Si connette a una casella di posta, preleva il messaggio corrispondente più recente con un allegato CSV, XML, Excel o JSON e lo importa utilizzando la mappatura delle colonne salvata.

L'importazione via e-mail richiede l'estensione PHP imap. Se non è installata, la scheda mostra un avviso ed è possibile utilizzare invece un feed https:// / FTP / SFTP o una cartella del server.

Importa un file dal tuo software gestionale (DMS)

Un caricamento una tantum per qualsiasi esportazione di software gestionale (DMS).

• Formati accettati: CSV, TXT, TSV, XML, Excel (.xlsx) e JSON — oppure un pacchetto ZIP che contiene il file di dati insieme alle immagini dei veicoli (fai riferimento a ciascuna immagine tramite il relativo nome file nella colonna delle immagini).
• Mappa le colonne una volta. Dopo il caricamento, mappi ogni campo del plugin a una colonna del tuo file. Sono richiesti solo Marca/Modello (o versione) e un numero di stock o VIN; lascia su "non mappato" tutto ciò che la tua esportazione non contiene. Un passaggio opzionale di Mappatura automatica con IA può suggerire la mappatura da esaminare.
• Anteprima prima dell'importazione. Una simulazione mostra quante righe sono valide, quali sarebbero nuove o aggiornate e le eventuali righe con problemi — non viene scritto nulla finché non scegli Importa ora.
• La mappatura viene salvata e riutilizzata per il caricamento successivo e per le sorgenti automatiche di feed ed e-mail.
• La codifica viene gestita per te: i file Windows-1252 vengono convertiti in UTF-8 (le umlaut svizzere e caratteri simili vengono preservati) e le celle multilinea nei file CSV vengono lette correttamente.

---

Note operative

• Un'unica pianificazione per tutto. AutoScout24, mobile.de e carcuro non hanno una pianificazione propria — vengono eseguiti sulla pianificazione di importazione centrale in Importazione e limiti. Le sorgenti feed ed e-mail offrono inoltre un proprio intervallo. È sempre possibile avviare un'importazione manuale.
• Un'unica pipeline per tutto. Indipendentemente dalla sorgente, ogni veicolo passa attraverso lo stesso processo a valle: rilevamento del reinserimento basato sul VIN, normalizzazione dei valori, importazione delle immagini, generazione dello slug e assegnazione al team. Ogni impostazione si applica all'intero inventario, indipendentemente dalla sorgente da cui proviene il veicolo.
• I segreti sono crittografati a riposo. Il Client Secret di AutoScout24, la password dell'API di mobile.de, il token di carcuro e le password del feed/casella di posta sono memorizzati crittografati nel database tramite l'archivio dei segreti del plugin, non come testo in chiaro.
• I dati demo sono disponibili nella pagina Strumenti per effettuare prove e possono essere rimossi in qualsiasi momento.

Risoluzione dei problemi

• Una sorgente mostra "Configura" invece di "Connesso". Le credenziali sono mancanti o incomplete. Aprire la riga e reinserirle. Per AutoScout24 sono necessari almeno un Client ID e un Client Secret; per carcuro è necessario il token aziendale.
• carcuro ha risposto con un errore HTTP / ha rifiutato la richiesta. Il token aziendale è probabilmente errato. Copiarlo nuovamente da carcuro in Webseite › Fahrzeugliste › Integration.
• La sorgente feed o e-mail indica che non è salvata alcuna mappatura delle colonne. Caricare un file una volta nel passaggio di caricamento file e salvare prima la mappatura — le sorgenti feed ed e-mail riutilizzano tale mappatura.
• L'importazione via e-mail non è disponibile. Nel server manca l'estensione PHP imap. Utilizzare invece una sorgente feed o cartella del server, oppure chiedere al proprio host di abilitare imap.
• Non viene importato nulla secondo la pianificazione. Verificare che la sorgente sia abilitata, che sia attiva una licenza valida e che la pianificazione centrale in Riferimento a importazione e limiti sia in esecuzione (vedere Cron e elaborazione in background).

Documenti correlati

• Riferimento impostazioni
• Riferimento importatore veicoli
• Riferimento a importazione e limiti
• Riferimento Mapping
• Flusso di lavoro per l'importazione dei veicoli
• Credenziali API esterne