API Process Status

Na een verzoek waarbij gegevens worden aangepast, zoals het aanpassen van een prijs van een artikel of het behandelen van een bestelling, is het belangrijk dat er altijd een process status wordt opgevraagd. Een process status geeft aan of zo’n type verzoek (POST, PUT of DELETE request) daadwerkelijk goed is verwerkt in het bol.com landschap. Oftewel, de process status geeft aan of je aanpassing is behandeld.

Toelichting van het proces

Wanneer je vanuit je eigen systeem bijvoorbeeld een bol.com bestelling bevestigt, betekent dit niet dat de bestelling ook direct goed is verwerkt bij bol.com. Verzoeken, ofwel requests, waarbij gegevens worden aangepast, worden namelijk eerst in een wachtrij geplaatst. De Retailer API werkt constant vanuit de wachtrij om alle requests af te handelen. Afhankelijk van het aantal requests in de wachtrij, kan de tijd die nodig is om een request te verwerken afwisselen. Wanneer een request als eerste in de wachtrij staat, sturen we deze door naar een andere interne service. Een process status geeft aan of een request daadwerkelijk goed is verwerkt door onze interne services.

Wanneer je een process status opvraagt, geven wij een van de volgende statussen terug: SUCCES, FAILURE, PENDING of TIMEOUT. Hieronder lichten we kort de verschillende statussen toe:

• SUCCES geeft aan dat een request goed bij ons is verwerkt, je hoeft geen verdere actie te ondernemen.
• FAILURE geeft aan dat het request niet goed is verwerkt. Wij geven altijd een toelichting terug waarom de aanpassing niet is geslaagd. Gebruik de toelichting in de foutmelding van een FAILURE om, indien nodig, het request aan te passen.
• PENDING geeft aan dat het request nog verder moet worden verwerkt. Vraag de process status van het request op een wat later moment opnieuw op om de definitieve status te ontvangen.
• Wanneer het systeem een request niet binnen een bepaald tijdsbestek heeft kunnen verwerken, geven we de status TIMEOUT Bij een TIMEOUT dien je het oorspronkelijke request op een later moment nogmaals te sturen.

Meer informatie over de process status vind je hier.