Riferimento Universal Import

Questo documento rappresenta un riferimento per la schermata Universal Import del plugin ADP Car Market Hub (CMH Center → Universal Import). È il punto centrale in cui viene collegata ogni sorgente di dati e dove vengono memorizzate tutte le credenziali API — AutoScout24, 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. Qualunque sia la sorgente, ogni veicolo finisce nello stesso inventario e viene elaborato dalla stessa pipeline di importazione.

Panoramica

Universal Import 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, 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 cinque sorgenti sono:

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

Tutte le sorgenti in tempo reale e programmate vengono eseguite sulla pianificazione centrale delle importazioni del plugin, configurata in Importazione e limiti (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 di AutoScout24 veniva configurata in Impostazioni. Tutte le credenziali delle sorgenti di dati ora risiedono qui nella pagina Universal Import, in un unico posto, con uno stato di connessione visibile. La schermata delle Impostazioni conserva solo le opzioni generali (come la valuta predefinita) e una scheda Sorgenti dati e connessioni API che rimanda a questa pagina.

Requisiti o prerequisiti

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

Istruzioni passo dopo passo

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

Riferimento per la configurazione

AutoScout24

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

Quando le credenziali sono presenti, la riga mostra Connesso e appare un link Apri Car Importer 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.

carcuro

Se il tuo inventario risiede in carcuro, collegalo 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. Utilizza Importa da carcuro ora per eseguire un'importazione immediata. Appariranno i nuovi veicoli e quelli rimossi su carcuro verranno rimossi anche 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 il tuo inventario automaticamente.

Il formato del file (CSV, XML o Excel) viene rilevato automaticamente e la mappatura delle colonne salvata nella fase di caricamento del file viene riutilizzata. 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 collega 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 da 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 sola 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 AI può suggerire la mappatura da sottoporre a revisione.
• Anteprima prima dell'importazione. Una simulazione mostra quante righe sono valide, quali sarebbero nuove o aggiornate e le eventuali righe con problemi — nulla viene scritto finché non scegli Importa ora.
• La mappatura viene salvata e riutilizzata per il caricamento successivo e per le sorgenti di feed automatici ed e-mail.
• La codifica viene gestita automaticamente: i file Windows-1252 vengono convertiti in UTF-8 (le dieresi svizzere e caratteri simili vengono preservati) e le celle multilinea nei file CSV vengono lette correttamente.

Note operative

• Un'unica pianificazione per tutto. AutoScout24 e carcuro non hanno una pianificazione propria — vengono eseguiti sulla pianificazione centrale delle importazioni in Importazione e limiti. Le sorgenti feed ed e-mail offrono in aggiunta il 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 di reinserimento basato su VIN, periodo di tolleranza per l'eliminazione logica dei veicoli che scompaiono, 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 un veicolo.
• I dati sensibili sono crittografati a riposo. Il Client Secret di AutoScout24, il token carcuro e le password di feed/caselle postali sono memorizzati crittografati nel database tramite l'archivio sicuro del plugin, non come testo in chiaro.
• I dati demo sono disponibili nella pagina Strumenti per effettuare prove e possono essere rimossi nuovamente in qualsiasi momento.

Risoluzione dei problemi

• Una sorgente mostra "Configura" invece di "Connesso". Le credenziali sono mancanti o incomplete. Apri la riga e reinseriscile. Per AutoScout24 hai bisogno almeno di un Client ID e di un Client Secret; per carcuro hai bisogno del token aziendale.
• carcuro ha risposto con un errore HTTP / ha rifiutato la richiesta. Il token aziendale è probabilmente errato. Copialo nuovamente da carcuro in Webseite › Fahrzeugliste › Integration.
• La sorgente feed o e-mail indica che non è salvata alcuna mappatura delle colonne. Carica un file una volta nella fase di caricamento file e salva prima la mappatura — le sorgenti feed ed e-mail riutilizzano tale mappatura.
• L'importazione via e-mail non è disponibile. Sul server manca l'estensione PHP imap. Utilizza invece una sorgente feed o una cartella del server, oppure chiedi al tuo provider di hosting di abilitare imap.
• Nulla viene importato secondo la pianificazione. Verifica che la sorgente sia abilitata, che sia attiva una licenza valida e che la pianificazione centrale in Importazione e limiti sia in esecuzione (vedi Cron e elaborazione in background).

Documenti correlati

• Riferimento impostazioni
• Riferimento Car Importer
• Riferimento a importazione e limiti
• Riferimento Mapping
• Flusso di lavoro per l'importazione dei veicoli
• External API Credentials