Importfouten

Dit document behandelt fouten, gedeeltelijke resultaten, gegevensproblemen en validatiestappen voor het voertuigimportproces in de ADP Car Market Hub plugin.

Wanneer u dit document moet gebruiken

Lees dit document wanneer:

• Een handmatige import of een automatische importrun is voltooid, maar er minder voertuigen dan verwacht verschijnen in WordPress.
• Voertuiggegevens (titel, prijs, beschrijving, velden) onjuist zijn of ontbreken na de import.
• Het importlogboek fouten toont voor specifieke advertenties.
• Voertuigen niet worden bijgewerkt, hoewel de advertentiegegevens zijn gewijzigd in AutoScout24.
• Voertuigen die zijn verwijderd uit AutoScout24 nog steeds aanwezig zijn in WordPress (of vice versa).

Als de import helemaal geen resultaten oplevert en het logboek authenticatie- of HTTP-fouten bevat, begin dan eerst met API-verbindingsfouten.

Overzicht

Het importproces haalt actieve voertuigadvertenties op uit de AutoScout24 API voor elke geconfigureerde Seller ID en maakt of werkt WordPress-berichten van het custom post type as24ci_car bij. Elke run rapporteert aantallen voor toegevoegde, bijgewerkte, overgeslagen en mislukte resultaten.

De importeur past automatisch de volgende filters toe:

• Statusfilter: alleen advertenties met status = activated worden geïmporteerd. Inactieve of gedeactiveerde advertenties worden overgeslagen.
• Live-filter: alleen advertenties met live = true (of waar het veld ontbreekt) worden geïmporteerd. Niet-live advertenties worden overgeslagen.

Wijzigingsdetectie wordt gebruikt om onnodige updates te voorkomen:

• Als de API-respons een lastModifiedDate-veld bevat en dit overeenkomt met de waarde die tijdens de laatste import is opgeslagen, wordt het voertuig overgeslagen (geteld als "overgeslagen").
• Als lastModifiedDate ontbreekt, valt de plugin terug op een inhoudshash. Als de hash ongewijzigd is, wordt het voertuig overgeslagen.

Afbeeldingen worden apart verwerkt. Als de afbeeldingswachtrij-modus is ingeschakeld (standaard ingeschakeld voor cron- en REST-runs), wordt alleen de eerste afbeelding per voertuig direct gedownload. De overige afbeeldingen worden in een asynchrone wachtrij geplaatst en door een achtergrondtaak gedownload. Zie Fouten bij het importeren van afbeeldingen voor afbeeldingsspecifieke problemen.

Systeemvereisten

• De API-verbinding werkt. Controleer dit op de pagina Systeemstatus voordat u importproblemen onderzoekt.
• Er is ten minste één Seller ID geconfigureerd in de plugin-instellingen.
• De importeur heeft toestemming om berichten te schrijven en media te uploaden. Zie Toestemmingsfouten als er toegangsfouten in het logboek verschijnen.

Diagnostische stappen

Stap 1: Controleer het resultaat van de laatste run

1. Ga naar het beheerdersdashboard van de plugin of het tabblad Systeem & Hulp.
2. Bekijk de tijd van de laatste importrun en de resultaten: toegevoegd, bijgewerkt, overgeslagen, fouten.
3. Een hoog aantal "overgeslagen" is normaal wanneer wijzigingsdetectie actief is en de meeste advertenties niet zijn gewijzigd sinds de laatste run.
4. Een aantal "fouten" groter dan nul geeft aan dat specifieke advertenties zijn mislukt. Ga door naar Stap 2.

Stap 2: Lees het importlogboek

Open het logbestand van de plugin op:

wp-content/uploads/as24ci-logs/adp-car-market-hub.log

Zoek naar regels die error, failed of de specifieke Listing ID bevatten die u onderzoekt. Handige patronen om naar te zoeken:

• get_listing_details error – de plugin kon de volledige details voor een specifieke advertentie niet ophalen.
• wp_insert/wp_update error – WordPress gaf een foutmelding bij het opslaan van het bericht.
• Import runner – samenvattingsregels aan het begin en einde van elke run.
• Hard delete FAILED – een verwijdering van een voertuig tijdens de volledige synchronisatie kon niet worden voltooid.
• Full sync skipped – de veiligheidsgrens voor volledige synchronisatie is geactiveerd omdat er geen externe advertenties zijn geretourneerd.

Als gedetailleerde logboekregistratie (verbose) is ingeschakeld (standaard), ziet u ook regels per voertuig, zoals:

Import vehicle {listing_id} (seller {seller_id}) begin.
Import vehicle {listing_id} result=inserted.
Import vehicle {listing_id} result=skipped.

Stap 3: Controleer de advertentiestatus in AutoScout24

Advertenties die door de importeur worden overgeslagen omdat ze inactief of niet live zijn, verschijnen niet als fouten in het importlogboek; ze worden geruisloos uitgesloten. Als een voertuig wel aanwezig is in AutoScout24 maar niet wordt geïmporteerd:

1. Bevestig dat de advertentiestatus activated is in de beheerinterface van AutoScout24.
2. Bevestig dat de advertentie als live is gemarkeerd.
3. Controleer of de advertentie hoort bij een Seller ID die is geconfigureerd in de plugin-instellingen.

Stap 4: Controleer de limiet voor het aantal voertuigen

Als automatische imports (via cron of REST) zijn geconfigureerd, kan er een maximaal aantal voertuigen per run zijn ingesteld. Wanneer deze limiet is bereikt, stopt de run en registreert het logboek de melding "voertuiglimiet bereikt". De resterende voertuigen worden bij de volgende run verwerkt.

Om dit te controleren:

1. Ga naar het tabblad Import & Limieten in de plugin-instellingen.
2. Controleer de instelling Max. aantal voertuigen per cron-run. Een waarde van 0 betekent onbeperkt.
3. Als de limiet lager is dan uw totale catalogusgrootte, verhoog deze dan of laat deze op 0 staan om onbeperkte verwerking toe te staan.

Let op: door wijzigingsdetectie worden in de praktijk de meeste voertuigen bij elke run overgeslagen. Een gematigde limiet is over het algemeen voldoende, tenzij u een zeer grote catalogus heeft met frequente wijzigingen in de advertenties.

Stap 5: Controleer de configuratie van de Seller ID

1. Ga naar het tabblad Instellingen van de plugin.
2. Controleer of het veld Seller ID(s) de juiste ID's bevat, één per regel of gescheiden door komma's.
3. Als er meerdere Seller ID's zijn geconfigureerd, controleer dan of elke ID actief en toegankelijk is met de geconfigureerde inloggegevens.

Stap 6: Controleer op een verlopen importblokkering

Een importblokkering-transient (as24ci_cron_import_running) voorkomt overlappende runs. Als een eerdere run is onderbroken zonder de blokkering vrij te geven, worden volgende runs maximaal 40 minuten geblokkeerd. Na die periode wordt de blokkering automatisch opgeheven en wordt de volgende run uitgevoerd.

Als u de blokkering onmiddellijk wilt opheffen:

• Gebruik een WordPress transient-beheerplugin of WP-CLI om de transient as24ci_cron_import_running te verwijderen.
• Of wacht tot de TTL van 40 minuten voor de blokkering is verstreken.

Stap 7: Onderzoek problemen met de gegevenskwaliteit

Als een voertuig is geïmporteerd maar de gegevens onjuist of onvolledig zijn:

1. Controleer het logboek op eventuele wp_insert/wp_update error-vermeldingen voor die Listing ID.
2. Controleer de ruwe API-respons voor de advertentie met behulp van de AutoScout24 API-documentatie of de ontwikkelaarstools van de API-provider.
3. Controleer of het betreffende veld door de plugin wordt gemapped. De plugin mapt standaard AutoScout24-advertentievelden naar WordPress post-meta. Aangepaste of niet-standaard velden worden mogelijk niet gemapped. Controleer dit gedrag in de huidige plugin-versie voordat u publiceert.
4. Als door AI gegenereerde inhoud is ingeschakeld en er een AI-blokkering (_as24ci_ai_locked = yes) op een bericht is ingesteld, zal de import post_content of post_excerpt voor dat voertuig niet overschrijven. Dit is zo ontworpen om handmatig beheerde beschrijvingen te behouden.

Configuratiereferentie

Operationele opmerkingen

• De importeur houdt de post-metawaarden _as24ci_last_modified en _as24ci_content_hash voor elk voertuig bij om wijzigingen te detecteren. Als deze metawaarden ontbreken of beschadigd zijn, behandelt de volgende run het voertuig als gewijzigd en voert een volledige update uit.
• De post-metawaarde _as24ci_listing_id wordt gebruikt om externe advertenties te koppelen aan lokale berichten. Als deze meta ontbreekt in een bericht, maakt de importeur een duplicaat aan in plaats van het bestaande bericht bij te werken.
• Volledige synchronisatie (verwijdering van verouderde voertuigen) wordt alleen uitgevoerd als er tijdens de run geen voertuiglimiet is bereikt. Als een limiet de run voortijdig stopt, wordt de volledige synchronisatie overgeslagen om te voorkomen dat voertuigen die simpelweg niet zijn bereikt in die run, ten onrechte worden verwijderd.
• Volledige synchronisatie bevat een veiligheidsgrens: als de set met externe advertenties die door de API wordt geretourneerd leeg is, wordt de verwijdering volledig overgeslagen om te voorkomen dat per ongeluk alle lokale voertuigen worden verwijderd.
• De import wordt uitgevoerd met een limiet voor de uitvoeringstijd van 300 seconden (5 minuten) wanneer deze wordt geactiveerd door WP-Cron of het REST-eindpunt. Op hostingomgevingen die set_time_limit beperken, heeft dit mogelijk geen effect. Zeer grote catalogi vereisen mogelijk uitvoering via een server-cron.

Probleemoplossing

Gerelateerde documenten

• Overzicht probleemoplossing
• API-verbindingsfouten
• Cron-fouten
• Fouten bij het importeren van afbeeldingen