Beheerdersreferentie voor Verbindingen

Dit document is een referentie voor het scherm Connections van de ADP Car Market Hub-plugin (CMH Center → Connections). Het is de centrale plek waar elke gegevensbron wordt gekoppeld en waar alle API-inloggegevens worden opgeslagen — of het nu gaat om AutoScout24, mobile.de, carcuro, een automatische feed, een e-mailbox 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

Connections 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, mobile.de, carcuro) of Active-badge (feed, e-mail) wanneer de bron is ingesteld, of
• een Configure-oproep tot actie wanneer dat niet het geval is.

Klik op een rij om deze uit te klappen en die bron te configureren; het openen van één rij klapt de andere in, 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 zes bronnen zijn:

1. AutoScout24 — live synchronisatie van de voorraad via de AutoScout24 API.
2. mobile.de — live synchronisatie van de voorraad via uw mobile.de-dealer-API-inloggegevens.
3. carcuro — live synchronisatie van de voorraad via uw carcuro-bedrijfstoken.
4. Automatische import (feed) — een geplande import vanaf een https://-URL, een FTP/FTPS/SFTP-locatie, een servermap of een cloud-deellink.
5. E-mailimport — verzamel de voorraadexport automatisch uit een mailbox.
6. Een bestand importeren uit uw dealersoftware (DMS) — een eenmalige upload van een CSV-, TXT-, TSV-, XML-, Excel- (.xlsx) 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 Connections-pagina, op één plek, met een zichtbare verbindingsstatus. Het scherm Instellingen bevat alleen nog algemene opties (zoals de standaardvaluta) en een kaart Gegevensbronnen & API-verbindingen die naar deze pagina linkt.

Vereisten of randvoorwaarden

• Toegang tot CMH Center → Connections (hiervoor is de beheersbevoegdheid van de plugin vereist).
• Een geldige plugin-licentie — voor import en geplande synchronisatie is een actieve licentie vereist (zie Settings Reference).
• Inloggegevens voor de bron die u gebruikt: AutoScout24 API-inloggegevens, mobile.de-dealer-API-inloggegevens, een carcuro-bedrijfstoken, feed-/FTP-/SFTP-inloggegevens of IMAP-mailboxinloggegevens. 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 → Connections.
2. Klik op de rij van de bron die u wilt koppelen.
3. Voer de gegevens van die bron in (zie de referentie per bron hieronder) en sla deze 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.

---

Configuration reference

AutoScout24

Verbind uw live AutoScout24-voorraad rechtstreeks via de API.

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

mobile.de

Verbind uw live mobile.de-voorraad rechtstreeks via de dealer-API — net als bij carcuro worden de kolommen automatisch voor u gekoppeld, dus er hoeft niets handmatig te worden gekoppeld.

Deze inloggegevens zijn afkomstig uit het mobile.de-dealergedeelte: open uw accountnaam › "mobile.de Konto" › "Inserats-Einbindung" (Ad-Integration) om de API-gebruikersnaam en het wachtwoord te vinden.

Gebruik Save mobile.de settings om de verbinding op te slaan, en Import from mobile.de now om direct een import uit te voeren. mobile.de importeert en synchroniseert op het centrale importschema van de plugin met automatische kolomkoppeling, exact zoals carcuro.

carcuro

Als uw voorraad zich in carcuro bevindt, verbind deze dan rechtstreeks — exact zoals AutoScout24. U hoeft alleen een token op te geven; de kolommen worden automatisch voor u gekoppeld, dus er hoeft niets handmatig te worden gekoppeld.

Schakel Import and sync automatically in om de plugin carcuro te laten ophalen volgens het centrale importschema. Gebruik Import from carcuro now 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 een bestand en sla de koppeling eenmalig op voordat u de feed inschakelt.

E-mailimport

Als uw dealersoftware de voorraadexport per e-mail verzendt, kan de plugin deze automatisch ophalen. 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.

E-mailimport vereist de PHP imap-extensie. 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.

Een bestand importeren 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-pakket dat het databestand 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.

---

---

Operational notes

• Eén schema voor alles. AutoScout24, mobile.de 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 worden geactiveerd.
• Eén pijplijn voor alles. Ongeacht de bron doorloopt elk voertuig dezelfde downstream-verwerking: op VIN gebaseerde her-listingdetectie, waardenormalisatie, afbeeldingenimport, slug-generatie en teamtoewijzing. Elke instelling is van toepassing op de gehele voorraad, ongeacht uit welke bron een voertuig afkomstig is.
• Inloggegevens zijn versleuteld in rust. Het AutoScout24 Client Secret, het mobile.de API-wachtwoord, het carcuro-token en de feed-/mailboxwachtwoorden worden versleuteld opgeslagen in de database via de secret store 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.

Probleemoplossing

• Een bron toont "Configureren" in plaats van "Verbonden". 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 / heeft het verzoek geweigerd. Het bedrijfstoken is waarschijnlijk onjuist. Kopieer het opnieuw uit carcuro onder Webseite › Fahrzeugliste › Integration.
• De feed- of e-mailbron geeft aan dat er geen kolommapping is opgeslagen. Upload eenmalig een bestand in de stap voor het uploaden van bestanden en sla de mapping eerst op — de feed- en e-mailbronnen hergebruiken die mapping.
• E-mailimport is niet beschikbaar. Op de server ontbreekt de PHP imap-extensie. Gebruik in plaats daarvan een feed- of servermapbron, 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 Beheerdersreferentie voor 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