Universal Import-referentie

Dit document is een referentie voor het scherm Universal Import van de ADP Car Market Hub-plugin (CMH Center → Universal Import). Het is de centrale plek waar elke gegevensbron wordt gekoppeld en waar alle API-inloggegevens worden opgeslagen — AutoScout24, carcuro, een automatische feed, een e-mailinbox of een eenmalige bestandsupload.

Wanneer u dit document moet gebruiken

Gebruik deze referentie wanneer u voertuigen in de plugin wilt importeren, wanneer u de API-inloggegevens voor een gegevensbron moet invoeren of wijzigen, of wanneer u wilt controleren of een bron is gekoppeld. Wat de bron ook is, elk voertuig komt in dezelfde voorraad terecht en wordt verwerkt door dezelfde importpijplijn.

Overzicht

Universal Import presenteert uw gegevensbronnen als een enkele, overzichtelijke accordeon. Elke rij is één bron waarvan de verbindingsstatus aan de rechterkant wordt weergegeven:

• een groene Connected-badge (AutoScout24, carcuro) of Active-badge (feed, e-mail) wanneer de bron is ingesteld, of
• een Configure-knop wanneer dit niet het geval is.

Klik op een rij om deze uit te klappen en die bron te configureren; het openen van één rij activeert het inklappen van de andere, zodat alleen de bron waaraan u werkt zichtbaar is. Nadat u een bron hebt opgeslagen — of er een import voor hebt uitgevoerd — blijft de rij openstaan zodat u het resultaat kunt zien.

De vijf bronnen zijn:

1. AutoScout24 — live synchronisatie van de voorraad via de AutoScout24 API.
2. carcuro — live synchronisatie van de voorraad via uw carcuro-bedrijfstoken.
3. Automatische import (feed) — een geplande import vanaf een https://-URL, een FTP/SFTP-locatie, een servermap of een cloud-deellink.
4. E-mailimport — verzamel de voorraadexport automatisch uit een mailbox.
5. Importeer een bestand uit uw dealersoftware (DMS) — een eenmalige upload van een CSV-, XML-, Excel- of JSON-bestand (of een ZIP-archief met afbeeldingen).

Alle live en geplande bronnen draaien op het centrale importschema van de plugin, geconfigureerd onder Import & Limieten (zie Beheerdersreferentie voor Import & Limieten). U voert de inloggegevens hier eenmalig in; de plugin regelt de rest op basis van het schema dat u centraal instelt.

Waar zijn de API-inloggegevens gebleven? In eerdere versies werd de AutoScout24 API-verbinding geconfigureerd onder Instellingen. Alle inloggegevens voor gegevensbronnen staan nu hier op de Universal Import-pagina, op één plek, met een zichtbare verbindingsstatus. Het Instellingen-scherm bevat alleen nog algemene opties (zoals de standaardvaluta) en een kaart Gegevensbronnen & API-verbindingen die naar deze pagina linkt.

Vereisten of voorwaarden

• Toegang tot CMH Center → Universal Import (hiervoor is de beheersbevoegdheid van de plugin vereist).
• Een geldige plugin-licentie — voor imports en geplande synchronisatie is een actieve licentie vereist (zie Beheerdersreferentie voor Instellingen).
• Inloggegevens voor de bron die u gebruikt: AutoScout24 API-inloggegevens, een carcuro-bedrijfstoken, feed-/FTP-/SFTP-inloggegevens of IMAP-mailboxgegevens. Deze worden verstrekt door uw provider, niet door de plugin.
• Voor e-mailimport: de PHP-extensie imap op de server.

Stapsgewijze instructies

1. Open CMH Center → Universal Import.
2. Klik op de rij voor de bron die u wilt koppelen.
3. Voer de gegevens van die bron in (zie de referentie per bron hieronder) en sla ze op. De statusbadge aan de rechterkant verandert in Connected / Active.
4. Stel in hoe vaak de plugin importeert onder CMH Center → Import & Limieten — dit enkele schema stuurt elke gekoppelde bron aan.
5. Om direct te importeren, gebruikt u de startknop van de bron (bijvoorbeeld Nu importeren uit carcuro) of voert u een handmatige import uit via Import & Limieten.
6. Controleer het resultaat in CMH Center → Car Importer en in de CMH Cars-voorraad.

Configuratiereferentie

AutoScout24

Koppel uw live AutoScout24-voorraad rechtstreeks via de API.

Wanneer de inloggegevens aanwezig zijn, toont de rij Connected en verschijnt er een link Car Importer openen zodat u de synchronisatie kunt uitvoeren of beheren. Het opslaan van nieuwe inloggegevens wist het gecachte toegangstoken en de gecachte API-verbindingsstatus, zodat de volgende aanvraag de nieuwe waarden gebruikt.

carcuro

Als uw voorraad in carcuro staat, koppelt u deze rechtstreeks — net als AutoScout24. U hoeft alleen een token op te geven; de kolommen worden automatisch voor u gekoppeld, dus er hoeft niets handmatig te worden toegewezen.

Schakel Automatisch importeren en synchroniseren in om de plugin carcuro te laten ophalen volgens het centrale importschema. Gebruik Nu importeren uit carcuro om direct een import uit te voeren. Nieuwe voertuigen verschijnen, voertuigen die in carcuro zijn verwijderd worden hier verwijderd — het maakt geen verschil of u AutoScout24 of carcuro gebruikt.

Automatische import (feed)

In plaats van telkens handmatig een bestand te uploaden, kunt u de plugin uw voorraad automatisch laten ophalen.

Het bestandsformaat (CSV, XML of Excel) wordt automatisch gedetecteerd en de kolomkoppeling die u bij de bestandsupload-stap hebt opgeslagen, wordt hergebruikt. Upload eenmalig een bestand en sla de koppeling op voordat u de feed inschakelt.

E-mailimport

Als uw dealersoftware de voorraadexport per e-mail verzendt, kan de plugin deze automatisch verzamelen. Deze maakt verbinding met een mailbox, pakt het nieuwste overeenkomende bericht met een CSV-, XML-, Excel- of JSON-bijlage en importeert dit met behulp van de opgeslagen kolomkoppeling.

Voor e-mailimport is de PHP-extensie imap vereist. Als deze niet is geïnstalleerd, toont de kaart een melding en kunt u in plaats daarvan een https://- / FTP- / SFTP-feed of een servermap gebruiken.

Importeer een bestand uit uw dealersoftware (DMS)

Een eenmalige upload voor elke export uit dealersoftware (DMS).

• Geaccepteerde formaten: CSV, TXT, TSV, XML, Excel (.xlsx) en JSON — of een ZIP-archief dat het gegevensbestand bevat samen met de voertuigafbeeldingen (verwijs naar elke afbeelding met de bestandsnaam in uw afbeeldingskolom).
• Koppel kolommen eenmalig. Na het uploaden koppelt u elk plugin-veld aan een kolom uit uw bestand. Alleen Merk/Model (of uitvoering) en een voorraadnummer of VIN zijn verplicht; laat alles wat uw export niet bevat op "niet gekoppeld" staan. Een optionele stap Automatisch koppelen met AI kan een koppeling voorstellen die u kunt controleren.
• Voorbeeld bekijken voor het importeren. Een proefrun laat zien hoeveel rijen geldig zijn, welke nieuw of bijgewerkt zouden worden, en eventuele rijen met problemen — er wordt niets weggeschreven totdat u kiest voor Nu importeren.
• De koppeling wordt opgeslagen en hergebruikt voor de volgende upload en voor de automatische feed- en e-mailbronnen.
• Codering wordt voor u afgehandeld: Windows-1252-bestanden worden geconverteerd naar UTF-8 (Zwitserse umlauten en soortgelijke tekens blijven behouden) en cellen met meerdere regels in CSV-bestanden worden correct gelezen.

Operationele opmerkingen

• Eén schema voor alles. AutoScout24 en carcuro hebben geen eigen schema — ze draaien op het centrale importschema onder Import & Limieten. De feed- en e-mailbronnen bieden daarnaast hun eigen interval. Een handmatige import kan altijd handmatig worden gestart.
• Eén pijplijn voor alles. Ongeacht de bron doorloopt elk voertuig dezelfde verdere verwerking: op VIN gebaseerde detectie van hernieuwde plaatsing, de respijtperiode voor soft-delete voor voertuigen die verdwijnen, waardenormalisatie, import van afbeeldingen, genereren van slugs en toewijzing aan teams. Elke instelling is van toepassing op de gehele voorraad, ongeacht uit welke bron een voertuig afkomstig is.
• Geheimen zijn versleuteld in rust. Het AutoScout24 Client Secret, het carcuro-token en de wachtwoorden voor feeds/mailboxen worden versleuteld in de database opgeslagen via de geheime opslag van de plugin, niet als platte tekst.
• Demogegevens zijn beschikbaar op de pagina Tools om dingen uit te proberen, en kunnen op elk moment weer worden verwijderd.

Problemen oplossen

• Een bron toont "Configure" in plaats van "Connected". De inloggegevens ontbreken of zijn onvolledig. Open de rij en voer ze opnieuw in. Voor AutoScout24 heeft u minimaal een Client ID en Client Secret nodig; voor carcuro heeft u het bedrijfstoken nodig.
• carcuro reageerde met een HTTP-fout / weigerde het verzoek. Het bedrijfstoken is waarschijnlijk onjuist. Kopieer het opnieuw uit carcuro onder Webseite › Fahrzeugliste › Integration.
• De feed- of e-mailbron meldt dat er geen kolomkoppeling is opgeslagen. Upload eenmalig een bestand bij de bestandsupload-stap en sla de koppeling eerst op — de feed- en e-mailbronnen hergebruiken die koppeling.
• E-mailimport is niet beschikbaar. Op de server ontbreekt de PHP-extensie imap. Gebruik in plaats daarvan een feed of servermap als bron, of vraag uw host om imap in te schakelen.
• Er wordt niets geïmporteerd volgens schema. Controleer of de bron is ingeschakeld, of er een geldige licentie actief is en of het centrale schema onder Import & Limieten actief is (zie Cron en achtergrondverwerking).

Gerelateerde documenten

• Beheerdersreferentie voor Instellingen
• Beheerdersreferentie voor de Car Importer
• Beheerdersreferentie voor Import & Limieten
• Mapping-referentie
• Voertuigimport-werkstroom
• Externe API-inloggegevens