Bestellingen, tracking en retouren

Toon de voortgang van bestellingen van uw klant.

Toegang

Gebruik de klant-/bedrijfssleutel met orders:read voor bestellingen en tracking en, indien beschikbaar, rma:write voor retour- en serviceverzoeken. Toegang tot oude bestellingen in het portaal geeft op zichzelf geen recht op betaalde API-toegang.

Aanpak

Lees /commerce/v1/native/orders en bewaar de openbare bestelreferenties.
Lees /orders/{order} en /orders/{order}/tracking onder /commerce/v1/native.
Lees /orders/{order}/after-sales. Dien alleen toegestane verzoeken in voor de oorspronkelijke regels en aantallen.
Bewaar de dossierreferentie en lees de voortgang. Maak na een time-out niet direct een tweede verzoek.

Houd rekening met

Factuur- en creditlinks behouden hun eigen eigendomscontrole. Het huidige klantcontract bevat geen aparte binaire documentdownload of webhookbeheer voor native klanten. Account- en abonnementsbeheer en leveranciersorders zijn evenmin onderdeel van deze openbare Bearer-API. Gebruik het Producthandel-account voor beschikbare account- en documentfuncties.

Na een fout of time-out

Bewaar per bedoelde opdracht één Idempotency-Key waar vereist, de exacte aanvraag, het bedrijf en de teruggegeven referenties. Lees na een time-out eerst de bewaarde uitkomst. Een nieuwe sleutel kan een tweede handeling starten. Los revisieconflicten en onzekere uitkomsten op vóór een nieuwe opdracht.

401 / 403: herstel de juiste identiteit en bevoegdheid.
409: lees de actuele toestand en beoordeel het verschil.
429: respecteer de limiet en een eventuele Retry-After.
503: de koppeling kan ontbreken of tijdelijk gesloten zijn.

API-contract voor deze taak

/public/v1/openapi/customer-orders.json

Gebruik de volledige referentie voor de actuele modellen, vereiste headers en operationele beperkingen. Een schema lezen activeert geen betaling, leverancier of service.

Gebaseerd op het vastgelegde Bridge-contract. Controleer bij integratie altijd de actuele referentie en toegangsvoorwaarden.