Beheerdersreferentie voor Import & Limieten

Dit document is een referentie voor het scherm Import & Limits van de ADP Car Market Hub-plugin (Car Market Hub → Import & Limits). Het behandelt de triggermethode, het automatische schema, de handmatige importwizard, de server-cron-installatie, limieten voor afbeeldingsverwerking, importstandaarden en de optie Full Sync in de gevarenzone.

Wanneer u dit document moet gebruiken

Gebruik deze referentie wanneer u voor het eerst automatische imports instelt, schakelt tussen WordPress Cron en een echte server-cronjob, de importprestaties afstemt voor grote voorraden, of Full Sync inschakelt om voertuigen te verwijderen die offline zijn gehaald.

Overzicht

Het scherm is georganiseerd in de volgende kaarten:

1. Huidige importstatus — een dynamische samenvattende zin die aangeeft of automatische imports actief zijn (via Server Cron of WP Cron) of uitgeschakeld, plus vier KPI-tegels: Geïmporteerde voertuigen, Geconfigureerde verkopers, Wachtende afbeeldingen en Fouten laatste run. Een schakelaar ID's tonen / ID's verbergen toont de geconfigureerde verkopers-ID's inline.
2. Laatste run + Handmatige import — statistieken van de laatste import en een begeleide wizard om op aanvraag een import te starten.
3. Automatiseringsinstellingen — kies de triggermethode (WordPress Cron of Server Cron) en configureer het schema.
4. Server Cron Setup — alleen zichtbaar in de Server Cron-modus; biedt de REST-trigger-URL, het geheime token en voorbeeld-cron-commando's.
5. Afbeeldingsverwerking en stabiliteit — limieten per run en schakelaar voor de afbeeldingswachtrij om PHP-timeouts te voorkomen.
6. Importstandaarden — standaarden die worden toegepast op nieuw geïmporteerde voertuigen, inclusief afbeeldingen en WebP-conversie.
7. Herplaatsingsdetectie — herkent voertuigen die zijn verwijderd en opnieuw zijn geplaatst onder een nieuwe AutoScout24 Listing ID (met hetzelfde VIN) om duplicaten te voorkomen, de openbare URL stabiel te houden en een prijsgeschiedenis bij te houden.
8. Gevarenzone — Full Sync-schakelaar, plus de optie voor zacht verwijderen / respijtperiode die bepaalt hoe verwijderde voertuigen worden afgehandeld.

Vereisten of randvoorwaarden

• Werkende API-inloggegevens en ten minste één Seller ID geconfigureerd in Settings.
• Voor de Server Cron-modus: de mogelijkheid om cronjobs toe te voegen aan uw hostingomgeving, plus de mogelijkheid om WordPress REST-URL's vanaf de server aan te roepen.
• Voor Full Sync: een recente back-up wordt ten zeerste aanbevolen.

Stapsgewijze instructies

Een handmatige import uitvoeren

1. Open Car Market Hub → Import & Limits.
2. Klik in de kaart Laatste run / Handmatige import op Nu import starten.
3. Het wizard-gebied verschijnt en toont een statusbericht, voortgangsbalk, geschatte resterende tijd (ETA) en een tabel met tellingen voor ingevoegd, bijgewerkt, overgeslagen, fouten en via full-sync verwijderd.
4. Gebruik Pauzeren, Doorgaan of Annuleren indien nodig. Als er bij een later bezoek een gepauzeerde wachtrij wordt gedetecteerd, wordt er een knop Hervatten getoond.

Schakelen naar WordPress Cron en automatische imports plannen

1. Selecteer in Automatiseringsinstellingen de optie WordPress Cron.
2. Schakel Imports automatisch uitvoeren via WordPress Cron in.
3. Kies een Importfrequentie uit de beschikbare WP-Cron-schema's.
4. Stel voor Dagelijks of Twee keer per dag een Starttijd in in 24-uurs HH:MM-indeling. Stel voor het aangepaste interval het Interval (minuten, min. 15) in.
5. Klik op Import & Limits-instellingen opslaan.

Schakelen naar Server Cron

1. Selecteer in Automatiseringsinstellingen de optie Server Cron. De plugin schakelt zijn WordPress-Cron-schema uit wanneer deze modus actief is.
2. De kaart Server Cron Setup verschijnt met twee stappen: - Stap 1: voeg define( 'DISABLE_WP_CRON', true ); toe aan wp-config.php. - Stap 2: voeg twee server-cronjobs toe — één om de REST-trigger-URL aan te roepen, en één om wp-cron.php actief te houden voor afbeeldingsverwerking.
3. Als er nog geen token bestaat, klikt u op Token genereren (in de Server Cron-modus wordt er meestal automatisch een aangemaakt). Kopieer vervolgens de REST-trigger-URL en het Geheime token van de kaart. Kopieer de URL meteen — deze wordt slechts ongeveer 15 minuten getoond, waarna deze wordt verborgen totdat u het token opnieuw genereert.
4. Gebruik de Voorbeeld-cron-commando's als uitgangspunt en pas de frequentie aan uw behoeften aan.
5. Klik op Import & Limits-instellingen opslaan.
6. Om het geheim te roteren, klikt u op Token opnieuw genereren en werkt u uw server-cron-item bij met de nieuwe URL.

Afbeeldingsverwerking configureren voor stabiliteit

1. Stel in Afbeeldingsverwerking en stabiliteit de optie Voertuigen per run in (0 betekent geen limiet; 50–80 wordt aanbevolen voor grote catalogi).
2. Houd Afbeeldingswachtrij inschakelen ingeschakeld, zodat alleen de eerste afbeelding onmiddellijk wordt geladen en de rest asynchroon wordt verwerkt.
3. Sla de wijzigingen op.

Standaardwaarden instellen voor nieuw geïmporteerde voertuigen

1. Kies in Importstandaarden de Standaard berichtstatus (Gepubliceerd of Concept).
2. Selecteer optioneel een Standaard auteur van bericht; kies (keep current user) om het bestaande gedrag te behouden.
3. Schakel Afbeeldingen importeren in of uit om te bepalen of afbeeldingsbijlagen worden gedownload.
4. Schakel optioneel Afbeeldingen converteren naar WebP in en kies een WebP-kwaliteit tussen 10% and 100% in stappen van 5% (aanbevolen 75–85%).
5. Stel Max. afbeeldingen per advertentie in (0 = geen limiet) om het aantal gedownloade afbeeldingen per voertuig te beperken.
6. Sla de wijzigingen op.

Herplaatsingsdetectie inschakelen

1. Open Car Market Hub → Import & Limits en zoek de kaart Herplaatsingsdetectie.
2. Houd Herplaatsingsdetectie inschakelen ingeschakeld (dit staat standaard aan).
3. Sla de wijzigingen op. Vanaf nu wordt een voertuig dat opnieuw wordt geplaatst onder een nieuwe AutoScout24 Listing ID maar met hetzelfde VIN, samengevoegd met het bestaande voertuig (geen duplicaat), wordt de nieuwe prijs toegepast, blijft de openbare URL behouden en worden een prijsgeschiedenis en een herplaatsingsteller geregistreerd.

Full Sync inschakelen en kiezen hoe verwijderde voertuigen worden afgehandeld (Gevarenzone)

1. Maak een back-up van uw database en de map met uploads.
2. Schakel in de Gevarenzone de optie Full Sync inschakelen in en bevestig de waarschuwingsdialoog.
3. Bepaal hoe verwijderde voertuigen worden afgehandeld: - Zacht verwijderen (aanbevolen, standaard): houd Verwijderde voertuigen vasthouden (zacht verwijderen) ingeschakeld. Een voertuig dat verdwijnt uit AutoScout24 wordt verborgen (ingesteld op concept) en bewaard gedurende de Respijtperiode (dagen) die u configureert (standaard 30). Als het binnen die periode opnieuw wordt geplaatst, wordt het op dezelfde plaats hersteld — met behoud van dezelfde pagina, URL en prijsgeschiedenis. Pas nadat de respijtperiode is verstreken, wordt het definitief verwijderd door een dagelijkse opschoning. - Onmiddellijk verwijderen: schakel Verwijderde voertuigen vasthouden (zacht verwijderen) uit. Een verwijderd voertuig wordt bij de volgende run definitief verwijderd, inclusief de geïmporteerde en uitgelichte afbeeldingen.
4. Sla de wijzigingen op.

Configuratiereferentie

Huidige importstatus

Bovenaan het scherm geeft een dynamische zin aan of automatische imports momenteel actief zijn (en of ze via Server Cron of WP Cron draaien) of uitgeschakeld. Daaronder bevinden zich vier KPI-tegels:

Laatste run

De samenvatting van de Laatste run rapporteert de statistieken van de meest recente import: ingevoegd, bijgewerkt, overgeslagen en fouten. Wanneer Full Sync is ingeschakeld, kan deze voor voertuigen die niet langer op AutoScout24 staan ook een teller In wachtstand rapporteren (voertuigen die als concept zijn verborgen tijdens hun respijtperiode wanneer zacht verwijderen aan staat) en een teller Verwijderd (voertuigen die definitief zijn verwijderd).

Triggermethode

WordPress Cron-instellingen (alleen zichtbaar als WordPress Cron is geselecteerd)

Server Cron-instellingen (alleen zichtbaar als Server Cron is geselecteerd)

Afbeeldingsverwerking en stabiliteit

Importstandaarden

Herplaatsingsdetectie

Gevarenzone

---

Hoe re-listingdetectie en prijsgeschiedenis werken

Sommige dealers verversen hun AutoScout24-ranking door een advertentie te verwijderen en opnieuw aan te maken. AutoScout24 geeft dan een nieuwe listing ID uit, vaak met een lagere prijs, terwijl de fysieke auto hetzelfde VIN (voertuigidentificatienummer) behoudt. Omdat de importer voertuigen normaal gesproken koppelt op basis van listing ID, zou zo'n re-listing anders een duplicaat aanmaken, of — bij Full Sync — de geschiedenis van de auto resetten.

Met Re-listingdetectie ingeschakeld werkt de import als volgt:

1. De importer probeert eerst de binnenkomende advertentie te koppelen op basis van de AutoScout24 listing ID (zoals voorheen).
2. Als er geen overeenkomst wordt gevonden, valt deze terug op het koppelen via het genormaliseerde VIN (in hoofdletters, niet-alfanumerieke tekens verwijderd). Een VIN dat leeg is of te kort om betrouwbaar te zijn, wordt genegeerd, zodat advertenties zonder VIN zich exact zo gedragen als voorheen.
3. Als exact één bestaand voertuig dat VIN heeft, wordt dit ter plekke bijgewerkt: de nieuwe listing ID en de nieuwe prijs worden toegepast, en de openbare slug/URL blijft ongewijzigd zodat links en SEO behouden blijven. Er wordt geen duplicaat aangemaakt.
4. Als het VIN ambigu is (al aanwezig op meer dan één voertuig), voert de plugin geen automatische samenvoeging uit — deze blijft aan de veilige kant en laat de records ongemoeid.

Wat er wordt vastgelegd bij een re-listed voertuig:

• Prijsgeschiedenis — elke prijswijziging (en de initiële prijs) wordt opgeslagen als een vermelding met datum, zodat een patroon van verwijderen-en-goedkoper-re-listen zichtbaar wordt.
• Eerdere AutoScout24 listing IDs — de keten van listing IDs die de auto heeft gehad.
• Eerst gezien — de oorspronkelijke importdatum blijft behouden (en wordt met terugwerkende kracht ingevuld voor bestaande voertuigen), zodat de standtijd (days-on-lot) nauwkeurig blijft.
• Re-listingteller en de nieuwste prijsdelta.

Waar u dit ziet:

• Kolom in voertuiglijst — een Re-listing-kolom toont een Re-listed n×-badge en de nieuwste prijswijziging (▼ prijsdaling / ▲ prijsstijging).
• Voertuigeditor — een box Re-listing & prijsgeschiedenis toont de eerst-gezien-datum, de eerdere listing IDs en de volledige prijsgeschiedenis.

Ontwikkelaars kunnen de as24ci_vehicle_relisted-actie ($post_id, $previous_listing_id, $current_listing_id, $delta) gebruiken om te integreren met andere systemen, en de volledige functionaliteit in- of uitschakelen met de as24ci_enable_relisting_detection-filter.

Hoe soft delete en de respijtperiode werken

Soft delete is alleen van toepassing wanneer Full Sync is ingeschakeld. Het verandert wat er gebeurt met een voertuig dat niet langer wordt geretourneerd door de AutoScout24 API:

1. Bij de eerste run waarbij het voertuig ontbreekt, wordt het verborgen — de status van het bericht wordt ingesteld op concept (verwijderd uit de openbare frontend) en de verwijderdatum wordt geregistreerd. Het wordt niet definitief verwijderd.
2. Het voertuig wordt bewaard gedurende de geconfigureerde respijtperiode (standaard 30 dagen).
3. Als hetzelfde voertuig binnen de respijtperiode opnieuw wordt geïmporteerd — gekoppeld op listing ID of op VIN (zie re-listingdetectie) — wordt het ter plekke hersteld: het oorspronkelijke bericht, de URL en de prijsgeschiedenis blijven behouden, en de status wordt teruggezet naar de vorige status.
4. Een dagelijkse opschoon-cron verwijdert definitief voertuigen waarvan de respijtperiode is verstreken (inclusief geïmporteerde en uitgelichte afbeeldingen), zodat er niets oneindig blijft opstapelen.

Dit overbrugt het gat waarin een voertuig in de ene synchronisatiecyclus wordt verwijderd en pas in een latere cyclus opnieuw wordt geadverteerd: bij een directe (harde) verwijdering zou het oorspronkelijke bericht al verdwenen zijn, maar met soft delete wordt het nog als concept bewaard en kan het worden hersteld.

De voertuigeditor toont een melding bij een vastgehouden voertuig, bijvoorbeeld “Verwijderd uit AutoScout24 op … — gepland voor definitieve verwijdering op … tenzij opnieuw geadverteerd.” Ontwikkelaars kunnen dit gedrag aanpassen met de as24ci_enable_soft_delete-filter.

Operationele opmerkingen

• Overstappen op Server Cron schakelt de WP-Cron-gebeurtenis van de plugin automatisch uit, zodat hetzelfde schema niet twee keer wordt uitgevoerd.
• Het cron-token wordt de eerste keer dat het scherm wordt geladen automatisch gegenereerd, alleen in de Server Cron-modus, zodat de trigger-URL direct klaar is voor gebruik. In de WP-Cron-modus wordt er niet automatisch een token gegenereerd en is de trigger-URL verborgen; schakel over naar Server Cron (of klik op Token genereren) om er een aan te maken.
• WebP-conversie vindt plaats op de server. Als de vereiste PHP-extensie niet aanwezig is, wordt de conversie geruisloos overgeslagen — controleer dit in de logs en op het scherm Systeem & Hulp.
• De afbeeldingswachtrij is onafhankelijk van de limiet voor het aantal voertuigen per run. Beide kunnen tegelijkertijd actief zijn.
• De limiet "Voertuigen per run" is van toepassing op geplande imports. De handmatige importwizard kan automatisch door batches heen lopen totdat de volledige voorraad is verwerkt.
• Het opslaan van een van de knoppen per kaart slaat het volledige formulier Import & Limits op (het formulier beslaat meerdere kaarten).
• Het cron-token, de REST-trigger-URL en de voorbeeld-cron-commando's die in de beheerdersinterface worden getoond, zijn omgevingsspecifiek. Kopieer geen waarden uit de documentatie; kopieer ze altijd van uw live scherm.
• Re-listingdetectie heeft een VIN nodig om een opnieuw geadverteerd voertuig samen te voegen. Advertenties zonder VIN worden alleen gekoppeld op listing ID en gedragen zich als voorheen.
• Soft delete werkt alleen wanneer Full Sync is ingeschakeld. Als Full Sync is uitgeschakeld, worden voertuigen die ontbreken in de API simpelweg behouden.
• De opschoning van de respijtperiode voor soft delete wordt eenmaal per dag uitgevoerd via de WordPress Cron. Op websites met zeer weinig verkeer (WP-Cron-modus) kunnen verlopen voertuigen iets later worden verwijderd dan de exacte verloopdatum.

Probleemoplossing

• Het schema wordt nooit uitgevoerd (WP-Cron-modus). De WordPress Cron start alleen wanneer de site wordt bezocht. Schakel op websites met weinig verkeer over naar Server Cron voor een betrouwbare uitvoering.
• De REST-trigger retourneert 401/403. Het token in de URL komt niet overeen. Kopieer de URL opnieuw uit het beheergedeelte of genereer het token opnieuw.
• PHP-timeouts tijdens de import. Verlaag Voertuigen per run (probeer 50), houd Afbeeldingswachtrij inschakelen ingeschakeld en overweeg om de serverlimieten voor max_execution_time en memory_limit te verhogen als uw host dit toestaat.
• Afbeeldingen worden niet gedownload. Controleer of Afbeeldingen importeren is ingeschakeld en of de uploads-map beschrijfbaar is. Controleer de Logs.
• WebP-conversie heeft geen effect. Controleer of PHP GD of Imagick WebP-ondersteuning heeft op de server. Controleer dit op het scherm Systeem & Hulp.
• Full Sync heeft onverwacht voertuigen verwijderd. Full Sync verwijdert alles wat ontbreekt in de API-respons. Als u ook handmatige bewerkingen uitvoert, herstel dan een back-up en schakel Full Sync uit.
• Handmatige import start niet. Controleer de browserconsole op AJAX-fouten en controleer of het Dashboard een gezonde API-verbinding meldt.
• Dezelfde auto verschijnt twee keer nadat een dealer deze opnieuw heeft geadverteerd. Schakel Re-listingdetectie in, zodat de nieuwe advertentie op basis van het VIN wordt samengevoegd met het bestaande voertuig. Let op: een voertuig waarvan de advertentie geen VIN heeft, kan niet automatisch worden samengevoegd.
• Een opnieuw geadverteerde auto is niet samengevoegd. De advertentie heeft geen VIN, of het VIN bestaat al op meer dan één voertuig (ambigu). In het geval van ambiguïteit voegt de plugin bewust niet automatisch samen; los het duplicaat handmatig op.
• Een verwijderde auto is er nog steeds als concept. Dat is de soft delete die het voertuig vasthoudt tijdens de respijtperiode. Het wordt automatisch hersteld als de auto opnieuw wordt geadverteerd, en definitief verwijderd na de respijtperiode. Om verwijderde voertuigen in plaats daarvan direct te verwijderen, schakelt u Verwijderde voertuigen vasthouden (soft delete) uit in de Danger Zone.
• Vastgehouden voertuigen worden nooit opgeruimd. De opschoning wordt dagelijks uitgevoerd via WP-Cron. Schakel op websites met weinig verkeer over naar Server Cron, of controleer of WP-Cron correct wordt uitgevoerd (Systeem & Hulp).

Gerelateerde documenten

• Settings Reference
• Beheerdersreferentie voor de Car Importer
• Logs Reference
• System And Help Reference
• Tools Reference