Skip to content

Refurbisher Onboarding

Deze pagina beschrijft het volledige onboardingproces voor het aansluiten van een nieuwe Refurbisher op het iUsed Refurbisher Portal (IRP). Het proces is opgedeeld in drie fasen: Discovery, Realisatie en Delivery.

  • Discovery

    Wensen en eisen ophalen, technische haalbaarheid evalueren en afstemmen over de connector inrichting.

  • Realisatie

    De Refurbisher Connector implementeren in het IRP (offer feed, order API, shipment webhook).

  • Delivery

    De volledige flow end-to-end testen en aftekenen voor go-live.

Checklist per fase

Refurbisher kerngegevens verzamelen

  • Refurbisher interne (unieke) naam
  • Refurbisher publieke naam
  • Refurbisher ID
  • Supplier ID
  • Attribute ID (PrestaShop Attribute ID)
  • Delivery promise
  • Reviews platform
  • Average of all reviews (scale 1–10)
  • Quantity threshold
  • Offers met het Keurmerk Refurbished (ja/nee) + impact op SKU
  • Marge offers zonder BTW (ja/nee) + impact op SKU
  • Condities + impact op SKU

Refurbisher Connector voorbereidingen

  • Technische documentatie gedeeld met de Refurbisher via de iUsed Partner Documentation — door het iUsed Team
  • Technische mogelijkheden en haalbaarheid gedeeld met het iUsed Team — door de Refurbisher
  • Evaluatie en beoordeling van de technische mogelijkheden vanuit de Refurbisher — door het iUsed Team in samenwerking met het Flooris Team
  • Gedetailleerde en concrete afstemming van de Refurbisher Connector tussen de Refurbisher en het IRP — door het iUsed Team in samenwerking met het Flooris Team
  • Begroting afgeven — door het Flooris Team
  • GO voor de realisatie

Refurbisher offers evalueren

  • Handmatig de Refurbisher offer feed ophalen en delen met het iUsed Team — door het Flooris Team
  • Offer SKU opbouw afstemmen met de Refurbisher — door het iUsed Team
  • Andere offer details evalueren en verder afstemmen met de Refurbisher — door het iUsed Team

Eerste doelstelling van de Discovery

Het delen van informatie zodat onderzocht kan worden hoe de Refurbisher connectie opgezet kan worden en of dit praktisch en financieel haalbaar is.

TO-DO

Splitsen per omgeving: eerst op Test of Acceptatie, daarna op Productie.

  • Supplier aanmaken in het IRP — door het Flooris Team
  • Refurbisher aanmaken in het IRP — door het Flooris Team
  • Technische implementatie Refurbisher offer feed met behulp van de Refurbisher Connector config — door het Flooris Team

Cache

Na het aanmaken van de Refurbisher: IRP cache legen vanwege de Refurbisher filter op de Refurbisher Offer index pagina.

  • Refurbisher mapping console command draaien om de Refurbisher aan te maken in de gekoppelde Shopware omgevingen — door het Flooris Team
  • Technische implementatie Refurbisher order API endpoint met behulp van de Refurbisher Connector config — door het Flooris Team

Let op: order implementatie

Deze stap is relatief veel werk omdat iedere Refurbisher specifieke berichtgeving hanteert voor het Order JSON bericht.

  • Aanmaken van een Secure Token voor de Refurbisher shipment API endpoint en deze beveiligd (via 1Password) delen met de Refurbisher — door het Flooris Team
Console command — Secure Token aanmaken
# supplier:create-shipment-token {supplier_id} {--f|--force}
php artisan supplier:create-shipment-token 18
  • Technische implementatie Refurbisher shipment API endpoint — door de Refurbisher
  • Refurbisher offers evalueren — door het iUsed Team
  • Refurbisher offers koppelen aan bestaande ProductVariants in het IRP, of nieuwe ProductVariants aanmaken — door het iUsed Team
  • Testen van het aanbod in de diverse (relevante) webshops door de PDP's te evalueren
  • Testen van een nieuwe Refurbisher Order door een bestelling te plaatsen in één van de webshops
  • Testen van het aanmelden van een Refurbisher Order naar de Refurbisher via de Refurbisher order API endpoint — door het Flooris Team
  • Testen van het ontvangen van een shipment met serienummer en track & trace informatie voor de test Refurbisher Order — door de Refurbisher in samenwerking met het Flooris Team
  • Acceptatie — go voor de ingebruikname van de Refurbisher i.c.m. de Refurbisher Connector — door het iUsed Team
Optioneel: boekhoudkundige verwerking (FileMaker)

Alleen van toepassing wanneer orders ook boekhoudkundig verwerkt moeten worden door iUsed.

  • iUsed / NeG: FileMaker — Refurbisher als Crediteur aanmaken

    Warning

    De naam moet exact overeenkomen met de Refurbisher interne (unieke) naam.

  • Flooris / Menno van Beek: FileMaker — Refurbisher kerngegevens aanleveren (crediteurnaam + crediteurnummer)

Technische documentatie Refurbisher Connector

Deze sectie wordt gedeeld met de Refurbisher ter voorbereiding en implementatie van de Refurbisher Connector met het IRP.

iUsed Partner Documentation

De volledige technische documentatie voor externe Refurbishers is gepubliceerd op het iUsed Partner Documentation portaal:

https://partner-docs.refurbishedcompany.com

Toegang is beveiligd via Cloudflare Access op basis van e-mail whitelisting. Neem contact op met het iUsed team om je e-mailadres te laten toevoegen aan de whitelist.

Toegang verlenen aan een nieuwe partner

  1. Open allowed-emails.json in de root van deze repository
  2. Voeg het e-mailadres van de partner toe aan de array
  3. Commit en push — het Cloudflare Access beleid wordt automatisch gesynchroniseerd bij iedere deploy via ./scripts/sync-access-policy.js
[
  "existing-partner@example.com",
  "new-partner@example.com"
]

De partner ontvangt een eenmalige pincode per e-mail bij het eerste bezoek aan de site.

Om toegang in te trekken: verwijder het e-mailadres uit de lijst en push.