Is punchout nieuw voor je? Begin dan met hoe punchout werkt. Deze pagina helpt je bepalen welk protocol jouw project nodig heeft. De korte samenvatting: je klant beslist. Ariba, Coupa, Jaggaer, Oracle en Workday vereisen cXML. SAP SRM, S/4HANA en veel Europese organisaties gebruiken OCI. Hier lees je wat elke keuze praktisch betekent.
Welk protocol heb je nodig?
- Noord-Amerikaanse & wereldwijde enterprises (Ariba, Coupa, Oracle): Je hebt cXML nodig met een elektronische inkooporderterugkoppeling.
- Europese SAP-inkopers (SRM, ECC, S/4HANA): Je hebt OCI nodig voor winkelwagenoverdracht via HTML-formulier.
- Internationale leveranciers: Uiteindelijk heb je beide nodig. Beide voeden vanuit één centrale Shopify B2B-catalogus voorkomt fouten.
Twee vormen van hetzelfde principe
cXML is gebaseerd op documenten. Elke stap is een formeel XML-document: PunchOutSetupRequest om de sessie te openen, PunchOutOrderMessage voor de winkelwagen en OrderRequest voor de definitieve inkooporder. Het grote voordeel is de structuur: UNSPSC-codes, ISO-eenheden, belastingtarieven en kostenplaatsen worden strikt gevalideerd.
OCI (Open Catalog Interface) werkt met een HTML-formulier. Het ERP van de inkoper roept de catalogus aan met een HOOK_URL. Bij afronding stuurt je shop een onzichtbaar HTML-formulier met NEW_ITEM-*-velden terug. Het is snel te bouwen, maar mist een formeel validatieschema voor aanvullende velden.
| Dimensie | cXML (Commerce XML) | OCI (Open Catalog Interface) |
|---|---|---|
| Architectuur | XML-documentuitwisseling via HTTP POST | HTML-formulierpost via browser (HOOK_URL) |
| Winkelwagenoverdracht | PunchOutOrderMessage (cxml-urlencoded of cxml-base64) | Automatisch verzendend HTML-formulier met NEW_ITEM-*-velden |
| Orderterugkoppeling (PO) | Rechtstreekse cXML OrderRequest naar endpoint | Alleen winkelwagen. Order komt separaat (EDI, e-mail, cXML of handmatig) |
| Schemavalidatie | Strikte DTD/XSD-validatie aan beide zijden | Geen. Veldnamen en lengtes verschillen per koper |
| UNSPSC & Eenheden | Verplichte XML-elementen voor classificatie en UOM | Optionele velden NEW_ITEM-MATGROUP en NEW_ITEM-UNIT |
| Belangrijkste systemen | SAP Ariba, Coupa, Jaggaer, Oracle, Workday | SAP SRM, SAP ERP (ECC, S/4HANA), Europese industrie |
| Aandachtspunten | Ontbrekende UOM-koppeling (stuks vs EA/PCE), auxiliary ID-stripping | Sessie verloren in iframe (gebruik returntarget), inloggegevens in GET-URL |
Het werkelijke verschil: de orderterugkoppeling
cXML-orders worden betrouwbaar vastgelegd, gevalideerd tegen de oorspronkelijke winkelwagen en in de inbox ‘Purchase orders’ van de PunchRelay-app gezet. In Shopify ontstaat niets tot iemand van je team de PO controleert en op ‘Create Shopify order’ klikt. Dan wordt de order onbetaald aangemaakt, met openstaande betaling, klaar om te verzenden. OCI stopt standaard bij de winkelwagen; de verwerking van inkooporders moet per klant worden afgestemd.
Het OCI-ordervacuüm
Omdat OCI geen standaard kent voor inkooporders, stoppen veel traditionele punchout-koppelingen bij de winkelwagen. De merchant moet orders alsnog overtypen uit PDF's. In PunchRelay is de cXML OrderRequest standaard aanwezig. OCI-kopers die cXML-orders kunnen sturen, volgen dezelfde route: de inkooporder komt in je inbox en je team maakt de Shopify-order aan.
Praktijkervaringen
- Winkelwagenoverdracht in cXML gebruikt bij de ene klant
cxml-urlencodeden bij de anderecxml-base64; dit moet configureerbaar zijn per koppeling. - cXML vereist ISO-eenheden en UNSPSC-classificaties; een vertaaltabel is vereist vóór de eerste test.
- cXML heeft geen standaardveld om de order aan de sessie te koppelen; dit loopt via
SupplierPartAuxiliaryID, mits het ERP dit veld behoudt. - OCI heeft geen ingebouwd koppelingsveld; OCI 4.0 biedt
NEW_ITEM-CUST_FIELD1t/m 5. - SAP opent de catalogus vaak in een iframe; het retourformulier moet de parameter
returntargetrespecteren om te voorkomen dat de winkelwagen vastloopt. - OCI-aanroepen kunnen binnenkomen via GET, wat gegevens in de URL toont. Zorg voor veilige logging en stimuleer kopers om POST te gebruiken.
Eerst je markt, daarna beide
In Noord-Amerika voert cXML de boventoon (Ariba, Coupa, Oracle). In Europa is OCI wijdverbreid bij SAP-gebruikers.
PunchRelay ondersteunt beide protocollen vanuit je Shopify B2B-catalogus. Lees meer op onze specifieke pagina's: Ariba, Coupa of OCI voor SAP.