Open source initiatief

OpenReturn

Een open protocol voor de e-commerce retourlevenscyclus.

Een machine-leesbare standaard waarmee elk e-commerceplatform, headless commerce tool of AI-agent kan integreren: gratis, open en zelf-hostbaar.

Apache 2.0REST API + MCPIn ontwikkeling

Bekijk op GitHub →openreturn.io ↗

Wat OpenReturn is

OpenReturn is een open standaard die definieert hoe e-commerce retouren programmatisch werken. Het dekt de volledige retourlevenscyclus: reden vastleggen, omruilkeuze, vervoerderoverdracht, tracking, notificatiegebeurtenissen en meerdere oplossingstypes: terugbetaling, omruiling, winkeltegoed of doorsturen naar een andere consument.

Het is geen product waarvoor je betaalt. Het is een specificatie die iedereen kan implementeren, een referentieportaal dat iedereen kan hosten en een MCP-server waarmee AI-agents retouren namens consumenten kunnen beheren. Gelicenseerd onder Apache 2.0.

Protocol-specificatie

Open standaard met REST API. Volledige OpenAPI 3.1-spec. Discovery via /.well-known/openreturn of UCP capability-advertentie.

MCP-server

Omvat de REST API zodat AI-agents retouren kunnen beheren via het Model Context Protocol. OAuth 2.1 token-delegatie voor de keten consument-agent-retailer.

Referentieportaal

Zelf-hostbare Next.js-applicatie. Volledige retour- en omruilflow. Transactionele e-mail inbegrepen. WCAG 2.1 AA toegankelijk. Open source.

Waarom dit moet bestaan

Het huidige model is structureel kapot.

Commerciële retourportalen opereren als verzendlabel-aggregators. Ze verdienen aan elke retourzending: hun prikkel is dus méér retouren, niet minder. Ze sluiten retailers op in propriëtaire systemen en behandelen retourdata als hun bezit, niet dat van de retailer. De consumentenervaring is gefragmenteerd: een ander portaal per retailer, geen continuïteit, geen overdraagbaarheid.

Er is geen open standaard.

Er bestaat geen open standaard voor hoe retouren programmatisch werken. Elk platform herimplementeert onafhankelijk dezelfde flows. Headless commerce-architecturen hebben geen schone interface om op aan te sluiten. AI-agents (die snel de primaire manier worden waarop consumenten taken afhandelen) hebben geen protocol te volgen wanneer zij retouren namens iemand afhandelen. Elke retailer is een eiland.

Wat OpenReturn verandert.

OpenReturn geeft retailers soevereiniteit over hun retourproces en hun data. Het geeft ontwikkelaars een stabiele interface om op te bouwen. Het geeft AI-agents een protocol om te volgen in elke winkel die de standaard implementeert. En het behandelt omruilingen (een verkoop behouden in plaats van verliezen) als een first-class flow, geen bijzaak. Nieuwe retourmodellen, zoals customer-to-customer forwarding, kunnen inpluggen via de uitbreidbare retourmethode-interface zonder het kernprotocol te wijzigen.

Hoe OpenReturn zich verhoudt tot Forwarding

Forwarding (het commerciële product van It Goes Forward) is één implementatie van een retourmethode die bovenop OpenReturn draait. Het is niet de enige. OpenReturn definieert het protocol; Forwarding is een plug-in die de peer-to-peer retourmethode via dat protocol implementeert.

Dit is dezelfde relatie als Vercel en Next.js, of Elastic en Elasticsearch: de infrastructuur is open, het commerciële product is erbovenop gebouwd. Wij open-sourcen de infrastructuur omdat wij geloven dat de industrie een gedeelde standaard nodig heeft, en omdat een open standaard een groter ecosysteem creëert dan een propriëtaire.

Als je Forwarding wilt gebruiken, hoef je OpenReturn niet apart te implementeren; het is inbegrepen. Als je iets anders bovenop OpenReturn wilt bouwen, kun je dat onafhankelijk doen.

Open standaard (Apache 2.0)

OpenReturn Protocol

REST API + MCP-server

Forwarding

IGF commercieel product

Jouw retourmethode / portaal

Implementaties van derden

Protocol-dekking

Volledige retourlevenscyclus

Reden vastleggen, conditiebeoordeling, omruilkeuze, vervoerderoverdracht, tracking events, notificatielevering en oplossing: terugbetaling, omruiling, winkeltegoed of forwarding.

Uitbreidbare retourmethodes

Retourmethodes van derden (zoals Forwarding) pluggen in via een gedefinieerde interface. Nieuwe oplossingstypes kunnen worden toegevoegd zonder het kernprotocol te wijzigen.

Dubbele discovery

Retailers adverteren OpenReturn-ondersteuning via /.well-known/openreturn-endpoint of UCP capability-advertentie. AI-agents kunnen het programmatisch ontdekken.

AI-agent ondersteuning

MCP-server omvat de REST API. OAuth 2.1 token-delegatie regelt de permissieketen consument-agent-retailer. A2A Agent Card-discovery is gepland.

GDPR by design

Geen tussenpartij raakt retailer- of consumentendata aan. Retailer-eigen API-sleutels overal. Dataminimalisatie-kader voor agent-bemiddelde flows.

Zelf-hostbaar

Het referentieportaal is een zelf-hostbare Next.js-applicatie. Geen afhankelijkheid van IGF-infrastructuur. Host zelf of gebruik de gehoste versie van IGF.

Gebouwd op open standaarden

UCP

Universal Capability Protocol: capability-advertentie en discovery

ucp.dev

MCP

Model Context Protocol: AI-agent integratie

modelcontextprotocol.io

OpenAPI

OpenAPI 3.1: REST API-specificatie

spec.openapis.org/oas/latest.html

Integraties

Vervoerders

PostNL
DHL
UPS
DPD
Budbee
+ community-adapters

Platformen

Shopify
WooCommerce
Magento
BigCommerce
Headless (generiek)
ERP (Exact, SAP, Microsoft Dynamics)

Betalingen

Stripe
Generieke adapter-interface (Mollie, Adyen, etc.)

Gepland (roadmap)

Klaviyo(gepland)
Zendesk(gepland)
Freshdesk(gepland)
Gorgias(gepland)
InPost(gepland)
DHL Packstations(gepland)
Vinted(gepland)
Refurbed(gepland)
WMS-integraties(gepland)
BORIS (retour in winkel)(gepland)
Grensoverschrijdende flows(gepland)
CO₂-rapportage (CSRD)(gepland)
A2A Agent Card-discovery(gepland)

Bestuur

De OpenReturn-protocolspecificatie wordt bestuurd via een open RFC-proces op GitHub. Elke partij kan wijzigingen voorstellen, beslissingen aanvechten of adapters bijdragen. Het bestuur is bedoeld om over te gaan naar The Commons Conservancy zodra het protocol v1.0-stabiliteit bereikt, waardoor It Goes Forward als enige beheerder wordt verwijderd en de standaard onder onafhankelijk non-profit bestuur wordt geplaatst.

Dit is een bewuste ontwerpkeuze. Een standaard die door één commercieel bedrijf wordt gecontroleerd, is geen standaard: het is een propriëtaire API met goede documentatie. Om zijn doel te vervullen, moet OpenReturn onafhankelijk worden bestuurd.

RFC-proces op GitHub →

Waarom It Goes Forward dit heeft geïnitieerd

Er zijn twee redenen.

De eerste is praktisch: het draaiboek werkt. Vercel open-sourcede Next.js en bouwde daarbovenop een hostingbedrijf. Elastic open-sourcede de zoekmachine en verkoopt managed Elasticsearch. GitLab open-sourct het platform en verkoopt enterprise-functies. Wij open-sourcen de retourinfrastructuur en verkopen Forwarding, de peer-to-peer methode die erop draait.

De tweede is oprecht: wij geloven dat de industrie een gedeelde standaard nodig heeft en wij zijn in de positie om deze te bouwen. Elk retourportaal dat dezelfde flows herimplementeert is verspilling. Elke retailer die opgesloten zit in een propriëtair systeem dat zijn retourdata beheert, is een onnodige beperking. Als OpenReturn de standaard wordt en IGF het bedrijf is dat deze heeft geïnitieerd, is dat een betere positie dan één van vele propriëtaire retourportaal-leveranciers zijn.