Documentatie · Gebruikershandleiding

Voertuigimport-werkstroom

Dit document beschrijft hoe u voertuigadvertenties importeert vanuit de AutoScout24 API naar WordPress met behulp van de ADP Car Market Hub plugin. Het behandelt zowel handmatige importmethoden als de automatische geplande import, evenals importopties, wijzigingsdetectie, afbeeldingsverwerking en Full Sync.

Wanneer u dit document moet gebruiken

Lees dit document als u:

Voor de eerste keer of op aanvraag een voertuigimport moet uitvoeren of controleren.
Het verschil wilt begrijpen tussen handmatige import, de Batch-Wizard en geplande (automatische) import.
Problemen met mislukte imports of onverwachte resultaten wilt oplossen.
Wilt begrijpen hoe de plugin omgaat met bijgewerkte advertenties, afbeeldingen en verwijderde voertuigen.

Zie Dagelijkse werkstromen voor een beknopte dagelijkse controle van de importstatus.

Overzicht

De plugin haalt voertuigadvertenties op uit de AutoScout24 API voor alle geconfigureerde Seller IDs en slaat elke advertentie op als een WordPress post van het custom post type as24ci_car. Voertuigmetadata (prijs, kilometerstand, specificaties, uitrusting, afbeeldingen) wordt opgeslagen in post meta en een speciale aangepaste database-tabel.

Er zijn drie manieren om een import te starten:

Individuele voertuigimport — importeer of herimporteer één advertentie via het tabblad Car Importer.
Batch-Wizard — voer handmatig een volledige import van alle advertenties uit met live voortgangsbewaking. Geschikt voor de eerste import of een geforceerde volledige verversing.
Automatische geplande import — draait met een geconfigureerd interval via WP-Cron of een externe server-cron. De aanbevolen methode voor doorlopende synchronisatie.

Alle drie de paden gebruiken dezelfde onderliggende importlogica: verbinding maken met de API, advertenties ophalen voor elke geconfigureerde verkoper, vergelijken met de lokale kopie met behulp van inhoudshashes, en WordPress posts maken of bijwerken waar nodig.

Vereisten of randvoorwaarden

Geldige API-inloggegevens (API Base URL, Seller ID(s), Client ID, Client Secret, Token URL en Audience) moeten worden ingevoerd en opgeslagen in ADP Car Market Hub → Settings voordat er een import kan worden uitgevoerd.
De WordPress site moet uitgaande HTTPS-verbindingen kunnen maken naar het geconfigureerde API-eindpunt.
Voor het importeren van afbeeldingen moet de WordPress uploads-map schrijfbaar zijn.
Er moet minimaal één Seller ID zijn geconfigureerd. De plugin leest de as24ci_seller_ids optie (een door komma's gescheiden lijst met ID's).

Stapsgewijze instructies

Een individueel voertuig importeren

Navigeer naar ADP Car Market Hub → Car Importer.
De tabel Pending vehicles toont advertenties die beschikbaar zijn via de API maar nog niet zijn geïmporteerd in WordPress.
Zoek het voertuig dat u wilt importeren.
Klik op Import naast de advertentie.
De pagina wordt opnieuw geladen en het voertuig verschijnt in de bovenstaande tabel Imported vehicles.
Om een reeds geïmporteerd voertuig te verversen (bijvoorbeeld na een prijswijziging op AutoScout24), zoekt u het op in de tabel Imported vehicles en klikt u op Re-import.

De Batch-Wizard uitvoeren (handmatige volledige import)

De Batch-Wizard is de aanbevolen methode voor de eerste volledige import van alle advertenties en voor het uitvoeren van een geforceerde verversing buiten het reguliere schema om.

Navigeer naar ADP Car Market Hub → Import & Limits.
Klik op de knop Trigger now.
De Batch-Wizard start en toont een live voortgangsbalk met: - Totaal aantal te verwerken voertuigen. - Tot nu toe verwerkte voertuigen. - Geschatte resterende tijd. - Huidige actie (invoegen, bijwerken of overslaan).
De wizard verwerkt standaard één voertuig tegelijk (adaptieve batchgrootte: 1–5 voertuigen per stap). Dit voorkomt PHP-time-outfouten op gedeelde hosting.
Gebruik de knop Pause om de import tijdelijk te onderbreken. Klik op Resume om door te gaan.
Gebruik de knop Abort om de import te stoppen. Voertuigen die al zijn verwerkt in de huidige run blijven behouden in WordPress.
Nadat de wizard klaar is, toont een samenvatting het aantal ingevoegde, bijgewerkte en overgeslagen voertuigen, evenals eventuele fouten.

Automatische geplande imports configureren en uitvoeren

Schakel de automatische planner in voor doorlopende synchronisatie:

Navigeer naar ADP Car Market Hub → Import & Limits.
Schakel Automatic import in (het selectievakje of de schakelaar op het tabblad).
Kies het importinterval: - Elk uur - Elke 6 uur - Tweemaal per dag - Dagelijks - Aangepast (minimaal 15 minuten — configureer de minutenwaarde in het veld voor het aangepaste interval)
Stel voor dagelijkse en tweemaal daagse schema's optioneel de starttijd in.
Sla de automatiseringsinstellingen op.
WordPress WP-Cron zal nu imports starten met het geconfigureerde interval telkens wanneer de site verkeer ontvangt.

Voor productiesites wordt server-cron aanbevolen:

Stel Cron mode in op Server cron op het tabblad Import & Limits.
Kopieer de weergegeven cron-eindpunt-URL (de URL bevat een beveiligingstoken).
Voeg een cron-job aan de serverzijde toe (bijvoorbeeld via crontab) die de eindpunt-URL aanroept met behulp van curl of wget op het door u gewenste interval.
Als u het token opnieuw genereert (Import & Limits → Regenerate token), werk dan uw cron-job bij met de nieuwe URL.

Hoe imports werken

Wijzigingsdetectie

De importeur berekent en slaat een content hash en een image hash op voor elk geïmporteerd voertuig. Bij volgende importruns wordt een voertuig overgeslagen als geen van beide hashes is gewijzigd. Dit houdt importruns snel, vooral voor grote voorraden waarvan de meeste voertuigen ongewijzigd zijn.

Wanneer een advertentie wordt bijgewerkt op AutoScout24 (bijvoorbeeld een prijswijziging of nieuwe afbeeldingen), komen de hashes niet meer overeen en wordt het voertuig bijgewerkt in WordPress.

Resultaatcodes van de import

Elk voertuig dat tijdens een importrun wordt verwerkt, wordt in een van de vier categorieën geteld:

Resultaat	Betekenis
Inserted	Nieuwe voertuigpost aangemaakt in WordPress
Updated	Bestaande voertuigpost ververst met nieuwe gegevens
Skipped	Voertuiggegevens ongewijzigd; geen actie vereist
Error	Er is een probleem opgetreden voor dit voertuig (zie tabblad Logs)

De importsamenvatting op het tabblad Import & Limits en de Batch-Wizard tonen deze aantallen na elke run.

Afbeeldingsimport en de afbeeldingswachtrij

Wanneer Import images is ingeschakeld in de instellingen, downloadt de importeur voertuigafbeeldingen van de API en koppelt deze aan de WordPress post.
Max images per vehicle (instellingen) beperkt het aantal afbeeldingen dat per advertentie wordt gedownload (0 = onbeperkt).
Image queue mode (standaard ingeschakeld voor cron-/REST-imports): tijdens geplande imports wordt alleen de eerste afbeelding per voertuig direct gedownload. Alle overige afbeeldingen worden toegevoegd aan een permanente achtergrondwachtrij en asynchroon verwerkt door de image queue worker, die ongeveer elke 5 minuten draait. Dit voorkomt PHP-time-outfouten tijdens grote imports.
De image queue worker verwerkt maximaal 30 afbeeldingen per batch.
De huidige wachtrijgrootte en de status van de worker zijn zichtbaar op het tabblad System & Help.
Om de afbeeldingswachtrij direct te verwerken, klikt u op Run image queue now op het tabblad System & Help.
WebP-conversie: indien ingeschakeld in de instellingen en GD of Imagick beschikbaar is, worden afbeeldingen bij het downloaden geconverteerd naar WebP-indeling. Het kwaliteitsniveau is configureerbaar (1–100, standaard 80).

Importvergrendeling

De plugin gebruikt een op transients gebaseerde run-lock met een TTL van ongeveer 40 minuten. Als er al een importrun actief is wanneer een tweede trigger binnenkomt (van WP-Cron, server-cron of een handmatige knop), wordt de tweede trigger overgeslagen en wordt er een melding "already in progress" gelogd. Als de vergrendeling verouderd is (ouder dan de TTL), wordt deze automatisch gewist zodat de volgende run kan doorgaan.

Full Sync

Wanneer Full Sync is ingeschakeld op het tabblad Import & Limits, vergelijkt de importeur de lijst met advertentie-ID's die door de API wordt geretourneerd met alle voertuigposts in WordPress. Elke lokale post waarvan het advertentie-ID niet in de huidige externe lijst voorkomt, wordt permanent verwijderd — inclusief alle bijbehorende afbeeldingen.

Schakel Full Sync alleen in als u wilt dat de WordPress voorraad exact overeenkomt met de live AutoScout24 advertenties.
Full Sync-verwijderingen worden in het plugin-logboek geregistreerd met sync_deleted tellingen.
Wanneer Full Sync is uitgeschakeld, blijven voertuigen die uit AutoScout24 zijn verwijderd in WordPress staan totdat ze handmatig worden verwijderd.

Status van voertuigpost

Geïmporteerde voertuigen worden aangemaakt met de post-status die is geconfigureerd in Settings → Default post status (publish of draft). Wanneer een voertuig wordt bijgewerkt door een volgende importrun, wordt de post-status niet gewijzigd — een gepubliceerde post blijft gepubliceerd.

Configuratiereferentie

Instelling	Locatie	Beschrijving
API Base URL	Settings	AutoScout24 API-eindpunt (moet `https://` bevatten)
Seller ID(s)	Settings	Door komma's gescheiden verkopers-/dealeridentificaties
Client ID	Settings	OAuth Client ID voor de API
Client Secret	Settings	OAuth Client Secret voor de API
Default post status	Settings	Post-status toegepast op nieuw geïmporteerde voertuigen (`publish` of `draft`)
Import images	Settings	Schakel het downloaden van afbeeldingen tijdens imports in of uit
Max images per vehicle	Settings	Maximaal aantal gedownloade afbeeldingen per advertentie (0 = onbeperkt)
Convert to WebP	Settings	Converteer gedownloade afbeeldingen naar WebP (vereist GD of Imagick)
WebP quality	Settings	Compressiekwaliteit voor WebP-conversie (1–100)
Auto import enabled	Import & Limits	Schakel het automatische importschema van WP-Cron in
Import interval	Import & Limits	Frequentie van het schema (elk uur, 6u, tweemaal per dag, dagelijks, aangepast)
Cron mode	Import & Limits	WP-Cron (standaard) of server-cron
Max vehicles per cron run	Import & Limits	Beperk het aantal verwerkte voertuigen per geplande run (0 = onbeperkt)
Image queue (cron)	Import & Limits	Schakel de achtergrondafbeeldingswachtrij in voor cron-/REST-imports
Full Sync	Import & Limits	Verwijder lokale voertuigen die niet in de huidige externe lijst zijn gevonden

Operationele opmerkingen

Meerdere Seller IDs: de importeur draait afzonderlijk voor elk geconfigureerd Seller ID. Een fout bij de ene verkoper stopt de imports voor andere verkopers niet.
Robuustheid van cron: de import-runner verhoogt de PHP-uitvoeringstijdlimiet naar 300 seconden tijdens runs die door cron/REST worden geactiveerd. Op hostingomgevingen die set_time_limit() beperken, heeft dit mogelijk geen effect.
Batchgrootte van Batch-Wizard: de wizard past zijn batchgrootte aan (1–5 voertuigen per stap) om binnen veilige grenzen van de uitvoeringstijd te blijven.
Handmatige trigger tijdens actieve cron: als de automatische cron actief is wanneer u op Trigger now klikt, wordt de handmatige trigger overgeslagen vanwege de run-lock. Wacht tot de huidige run is voltooid of wis de vergrendeling.
Importlogboek: alle importgebeurtenissen (API-aanroepen, ingevoegd/bijgewerkt/overgeslagen/fout per voertuig, downloads van afbeeldingen) worden naar het plugin-logboek geschreven. Raadpleeg ADP Car Market Hub → Logs voor details.
Uitgebreide logboekregistratie (verbose): indien ingeschakeld, bevat het logboek details per voertuig en per afbeelding. Schakel dit uit in productie om de groei van het logboek te beperken.

Probleemoplossing

Symptoom	Waarschijnlijke oorzaak	Controle
Er verschijnen geen voertuigen in de Car Importer	API-inloggegevens zijn onjuist of het API-eindpunt is onbereikbaar	Controleer de inloggegevens in de Instellingen; voer de verbindingstest uit op Systeem & Hulp
Import start maar er verschijnen geen nieuwe voertuigen	Standaard berichtstatus is `draft`, of alle voertuigen waren al geïmporteerd en ongewijzigd	Controleer de berichtstatus in de Instellingen; controleer de importsamenvatting op het aantal "overgeslagen" items
Afbeeldingen worden niet gedownload	Afbeeldingen importeren is uitgeschakeld, de uploads-map is niet schrijfbaar, of de image queue worker is niet actief	Controleer Instellingen → Afbeeldingen importeren; controleer Systeem & Hulp voor de uploadstatus en de wachtrijgrootte
Geplande import start niet	WP-Cron is uitgeschakeld of de site heeft geen verkeer	Schakel over naar server-cron of controleer of het cron-eindpunt bereikbaar is
Import toont veel fouten	API-snelheidslimiet (rate limiting), netwerkproblemen of misvormde voertuiggegevens	Bekijk het tabblad Logboeken voor foutdetails; controleer de API-status bij uw integratiepartner
Voertuigen verdwijnen onverwacht	Volledige synchronisatie (Full Sync) is ingeschakeld en de voertuigen zijn verwijderd uit AutoScout24	Controleer de Logboeken op `sync_deleted`-vermeldingen; schakel Volledige synchronisatie uit indien dit onbedoeld is
Batch-Wizard stopt of krijgt een time-out	PHP-uitvoeringstijdlimiet is te laag	Controleer Systeem & Hulp voor de waarde van de uitvoeringstijd; neem contact op met uw hostingprovider
Importvergrendeling (import lock) voorkomt uitvoeringen	Een eerdere importtaak is vastgelopen zonder de vergrendeling vrij te geven	Wacht maximaal 40 minuten totdat de vergrendeling automatisch verloopt, of controleer de Logboeken voor details