Voordat u begint

Maak in Shopify Admin een B2B-bedrijf aan met ten minste één vestiging en een contactpersoon gekoppeld aan een klantrecord. Koppel een bedrijfscatalogus aan die vestiging. De catalogus moet ACTIEF zijn, artikelen bevatten die de koper mag zien en een prijslijst bevatten met overeengekomen contractprijzen.

Controleer betalingsvoorwaarden en checkout-instellingen voor de vestiging. Volg Shopify's handleiding voor het testen van B2B-instellingen.

De Home-pagina van PunchRelay markeert de eerste stap als Complete zodra een bedrijf met vestiging en contact bestaat. Deze controle valideert de cataloguspublicatie pas zodra de koper de catalogus opent, inclusief tijdens de zelftest.

Volg de vier stappen op Home

Home met vier stappen en voortgangsbadges — De setup-kaart op Home met de statusbadges.

1. Shopify B2B-setup controleren

Controleer bedrijf, vestiging, contactpersoon en actieve catalogus in Shopify Admin. Herlaad Home in PunchRelay na eventuele aanpassingen.

2. Koperkoppeling aanmaken

Kies Create connection en doorloop de vier stappen van de wizard.

1 · Buyer (Koper)

Geef een herkenbare Connection name (optional) op. Vul bij Buyer identity de cXML From/Sender-identiteit in (bijv. een Ariba ANID) exact zoals verstrekt door de IT-afdeling van de koper. Ariba-testaccounts eindigen vaak op -T (bijv. AN01000000099-T).

Kies cXML only voor standaard punchout en inkooporders. Kies cXML + OCI alleen als de koper tevens OCI-winkelwagenoverdracht vereist. Klik op Continue.

Wizardscherm met koppelingsnaam, koperidentiteit en protocolselectie — Het koperscherm voor het invoeren van naam en identiteit.

2 · Shopify B2B mapping

Selecteer het Shopify B2B company, de Company location en het Company contact. De vestiging bepaalt de contractprijzen; orders worden geplaatst onder de geselecteerde contactpersoon. Klik op Continue.

B2B-koppeling met geselecteerd bedrijf, vestiging en contact — Voorbeeldkoppeling aan bedrijf, vestiging en contactpersoon.

3 · Protocol options

Gebruik Test zolang de koper test in een testomgeving en schakel pas bij livegang over naar Production. Laat Cart transfer field op cxml-urlencoded staan tenzij anders gevraagd. Klik op Continue.

Protocolinstellingen met testmodus en overdrachtsveld — Protocolopties voor een testkoppeling met cxml-urlencoded.

4 · Review

Controleer alle gegevens en klik op Create connection.

Overzichtstabel ter verificatie van de koppeling — Controleer de instellingen alvorens de koppeling definitief aan te maken.

3. Inloggegevens en eindpunten opslaan

Het dialoogvenster Connection created toont de inloggegevens eenmalig. Sla deze veilig op voordat u kiest voor I've saved these.

4. Zelftest uitvoeren

Open de koppelingskaart en kies Run self-test. De voortgangsbadges op Home worden automatisch bijgewerkt.

Wat u deelt met de IT-afdeling van de koper

Verstuur de volgende gegevens via een beveiligd kanaal, overgenomen van de kaart Endpoints:

Identity: De koperidentiteit van deze koppeling.
SharedSecret: Het secret voor cXML-authenticatie.
cXML setup URL: Het endpoint om een punchout-sessie te starten.
cXML order URL: Het endpoint dat cXML-inkooporders ontvangt.
OCI URL: Het endpoint voor OCI-winkelwagenretour.

Bij OCI levert u tevens OCI username en OCI password aan. Met Rotate credentials genereert u direct nieuwe geheimen.

Geïllustreerd dialoogvenster met identiteit, gemaskeerd secret en eindpunten — Illustratie van het dialoogvenster met inloggegevens en URL's.

Koppelingsoverzicht met cXML setup, order en OCI URL's — Het koppelingsdetail met de permanente URL's.

Zelftest uitvoeren

Klik op Run self-test in de koppelingskaart. De test duurt circa 30 seconden.

De zelftest voert een echte cXML-punchoutcyclus uit in de live app tegen je Shopify-winkel. Hij verstuurt een test-inkooporder en controleert of die in je inbox binnenkomt; er wordt geen Shopify-order aangemaakt.

Stap	Controle
PunchOutSetupRequest	Verstuurt identiteit en secret en controleert ontvangst van een StartPage-URL.
Open catalog	Opent de catalogus en controleert of er producten getoond worden.
Add to cart	Plaatst het eerste product in het winkelwagentje.
Cart transfer	Leest het teruggestuurde cXML-winkelwagentje uit.
OrderRequest ack	Verstuurt een testorder (SELFTEST-...) en controleert de ontvangstbevestiging.
Purchase order in inbox	Controleert of de test-inkooporder in je inbox Purchase orders staat met de status Awaiting your approval.
Earlier test purchase orders removed	Verwijdert test-inkooporders van eerdere zelftests op deze koppeling. De huidige blijft staan.

Na OrderRequest ack controleert de test of de test-inkooporder met de status Awaiting your approval in je inbox Purchase orders staat, en verwijdert daarna de test-inkooporders van eerdere runs. De huidige test-inkooporder blijft in de inbox staan tot je hem afwijst of de volgende zelftest hem verwijdert. Er wordt geen Shopify-order aangemaakt of verwijderd.

Bij succes toont het scherm Self-test passed met alle rijen op Passed.

Wanneer een stap mislukt

Open catalog: no catalog rows wijst op een ontbrekend of niet-gepubliceerd product in de gekoppelde B2B-catalogus.

Mislukt een stap na OrderRequest ack, lees dan de tekst onder Detail voor de oorzaak.

Bekijk onder Sessions het transactielogboek voor diepgaande analyse.

Sessieoverzicht met vier opgeschoonde testsessies — Afgeronde testsessies in het logoverzicht.

Volgende stap: acceptatie door koper

Een geslaagde zelftest bevestigt de werking aan leverancierszijde. Vervolgens test de koper vanuit de eigen omgeving (Ariba-testaccount, Coupa-testinstantie of OCI-testaanroep).

Laat de koper prijzen, eenheden en weergave in het eigen ERP accorderen voordat de koppeling definitief live gaat.

Wat PunchRelay niet dekt

Verplichte e-facturatie

PunchRelay verplaatst winkelwagens en inkooporders tussen het inkoopsysteem van de koper en Shopify. Het is geen oplossing voor e-facturatie. Een cXML-InvoiceDetailRequest is een bericht binnen het inkoopnetwerk, geen elektronische factuur volgens de Europese norm EN 16931. PunchRelay maakt geen EN 16931-, Factur-X-, XRechnung-, ZUGFeRD- of Peppol BIS Billing-documenten, koppelt niet met een Franse plateforme agréée en rapporteert geen factuurgegevens aan een belastingdienst.

Frankrijk: vanaf 1 september 2026 moet elk btw-plichtig bedrijf elektronische facturen kunnen ontvangen en moeten grote en middelgrote bedrijven ze versturen. Kleine en microbedrijven versturen vanaf 1 september 2027. Duitsland: ontvangen is verplicht sinds 1 januari 2025. Versturen is verplicht vanaf 1 januari 2027 voor bedrijven met een omzet boven 800.000 EUR in het voorgaande jaar en vanaf 1 januari 2028 voor iedereen. PunchRelay voldoet niet aan deze verplichtingen. Bronnen: impots.gouv.fr, Je passe à la facturation électronique en Bundesministerium der Finanzen, E-Rechnung FAQ, beide geraadpleegd op 16 september 2026.

Agentic Storefronts en publicatie van producten

Shopify sluit producten die alleen voor B2B zijn uit van AI-winkelkanalen als het ze via de ingebouwde B2B-functies kan herkennen. Shopify waarschuwt dat producten waarvan de toegang wordt beperkt door apps van derden of aangepaste themacode toch op Agentic Storefronts kunnen verschijnen. PunchRelay beperkt de toegang tot producten in je storefront niet: de punchout-catalogus wordt gehost door PunchRelay, leest je Shopify B2B-bedrijfscatalogus en publiceert, depubliceert of verbergt nooit producten in je winkel of in een verkoopkanaal. Welke producten op een Agentic Storefront verschijnen, bepalen alleen je publicatie-instellingen en je B2B-catalogus in Shopify. Bron: Shopify-helpcentrum, De Shopify Catalogus en productontdekking voor Agentic Storefronts, geraadpleegd op 24 september 2026.

Eerste koperkoppeling instellen