Prima di iniziare
Nel pannello amministratore di Shopify, predisponete un'azienda B2B con almeno una sede e un contatto collegato a una scheda cliente. Assegnate un catalogo aziendale a tale sede. Il catalogo deve essere ATTIVO, pubblicato con i prodotti desiderati e con un listino a prezzi contrattualizzati.
Definite i termini di pagamento della sede e verificate le opzioni di checkout. Seguite la guida di Shopify al test delle configurazioni B2B.
La schermata Home di PunchRelay contrassegna il primo passaggio come Complete non appena un'azienda dispone di sede e contatto. Questo controllo non valida i prodotti; PunchRelay verificherà la disponibilità effettiva del catalogo all'apertura della sessione acquirente o durante l'autotest.
I quattro passaggi sulla schermata iniziale
1. Verificare la configurazione B2B di Shopify
Controllate azienda, sede, contatto e catalogo attivo in Shopify Admin. Ricaricate Home su PunchRelay dopo le modifiche.
2. Creare la connessione acquirente
Selezionate Create connection e completate i 4 passaggi dell'assistente.
1 · Buyer (Acquirente)
Assegnate un Connection name (optional) chiaro. In Buyer identity, inserite l'identificativo From/Sender cXML dell'acquirente (es. ANID Ariba) esattamente come fornito dall'IT del cliente. Gli account di test Ariba terminano spesso in -T (es. AN01000000099-T).
Selezionate Protocol: cXML only per punchout e ordini cXML. Scegliete cXML + OCI solo se il cliente richiede anche il ritorno del carrello OCI. Cliccate su Continue.
2 · Shopify B2B mapping
Selezionate l'azienda Shopify B2B, la sede e il contatto. La sede determina i prezzi riservati; gli ordini verranno attribuiti al contatto selezionato. Cliccate su Continue.
3 · Protocol options
Impostate Deployment mode: Test finché il cliente effettua prove nel proprio ambiente di test, passando a Production per il live. Mantenete Cart transfer field su cxml-urlencoded salvo diversa richiesta. Cliccate su Continue.
4 · Review
Controllate i dati inseriti e finalizzate con Create connection.
3. Salvare credenziali ed endpoint
La finestra Connection created mostra le credenziali una sola volta. Salvatele in modo sicuro prima di cliccare su I've saved these.
4. Eseguire l'autotest
Accedete alla scheda della connessione e selezionate Run self-test. I badge di stato si aggiorneranno automaticamente.
Cosa trasmettere all'IT dell'acquirente
Inviate i seguenti parametri tramite un canale protetto, ricopiandoli dalla scheda Endpoints:
- Identity: L'identità acquirente registrata.
- SharedSecret: Il secret per autenticare le richieste cXML.
- cXML setup URL: L'endpoint di apertura sessione punchout.
- cXML order URL: L'endpoint di ricezione degli ordini d'acquisto cXML.
- OCI URL: L'endpoint di rientro carrello per connessioni OCI.
Se OCI è attivo, inviate anche OCI username e OCI password. Tramite Rotate credentials è possibile rigenerare i secret revocando immediatamente i precedenti.
Eseguire l'autotest
Cliccate su Run self-test nella scheda connessione e confermate. La verifica richiede circa 30 secondi.
L'autotest esegue un vero ciclo punchout cXML nell'app PunchRelay sul vostro negozio Shopify. Invia un ordine di acquisto di prova e verifica che arrivi nella vostra inbox; non viene creato alcun ordine Shopify.
| Fase | Verifica effettuata |
|---|---|
| PunchOutSetupRequest | Invia credenziali e verifica la ricezione di un URL StartPage. |
| Open catalog | Apre il catalogo e accerta la presenza di articoli. |
| Add to cart | Inserisce il primo prodotto nel carrello alla quantità minima. |
| Cart transfer | Valida il messaggio di ritorno carrello cXML nel formato configurato. |
| OrderRequest ack | Trasmette un ordine di prova (SELFTEST-...) e attende conferma. |
| Purchase order in inbox | Verifica che l'ordine di prova sia nella inbox Purchase orders con stato Awaiting your approval. |
| Earlier test purchase orders removed | Rimuove gli ordini di prova lasciati dagli autotest precedenti di questa connessione. Quello attuale resta. |
Dopo OrderRequest ack, il test verifica che l'ordine di prova sia nella vostra inbox Purchase orders con stato Awaiting your approval, poi rimuove gli ordini di prova lasciati dalle esecuzioni precedenti. L'ordine di prova attuale resta nella inbox finché non lo rifiutate o l'autotest successivo lo rimuove. Nessun ordine Shopify viene creato o cancellato.
In caso di esito positivo compare la dicitura Self-test passed con tutte le righe su Passed.
In caso di anomalie
Open catalog: no catalog rows indica che il catalogo B2B assegnato non presenta articoli pubblicati o prezzi validi per la sede selezionata.
Se una fase successiva a OrderRequest ack fallisce, leggete il testo in Detail per conoscerne la causa.
Consultate la sezione Sessions per ispezionare i log tecnici dettagliati.
Passaggio successivo: collaudo con l'acquirente
L'autotest positivo valida il funzionamento del flusso lato venditore. L'acquirente effettuerà poi il collaudo dal proprio sistema (account di test Ariba, ambiente di test Coupa o chiamata di test OCI).
Chiedete al buyer di confermare prezzi riservati, unità di misura e comportamento dell'iframe prima di autorizzare la messa in produzione.
Cosa non copre PunchRelay
Obblighi di fatturazione elettronica
PunchRelay trasferisce carrelli e ordini d'acquisto tra il sistema di procurement dell'acquirente e Shopify. Non è una soluzione di fatturazione elettronica. Un InvoiceDetailRequest cXML è un messaggio della rete di procurement, non una fattura elettronica secondo la norma europea EN 16931. PunchRelay non produce documenti EN 16931, Factur-X, XRechnung, ZUGFeRD o Peppol BIS Billing, non si collega a nessuna plateforme agréée francese e non trasmette dati di fatturazione ad alcuna autorità fiscale.
Francia: dal 1° settembre 2026 tutte le imprese soggette a IVA devono poter ricevere fatture elettroniche e le grandi e medie imprese devono emetterle. Le piccole imprese e le microimprese emettono dal 1° settembre 2027. Germania: la ricezione è obbligatoria dal 1° gennaio 2025; l'emissione è obbligatoria dal 1° gennaio 2027 per le imprese con fatturato dell'anno precedente superiore a 800.000 EUR e dal 1° gennaio 2028 per tutte. PunchRelay non soddisfa questi obblighi. Fonti: impots.gouv.fr, Je passe à la facturation électronique e Bundesministerium der Finanzen, E-Rechnung FAQ, consultate il 16 settembre 2026.
Agentic Storefront e pubblicazione dei prodotti
Shopify esclude dai canali di acquisto basati sull'IA i prodotti solo B2B quando può identificarli tramite le funzionalità B2B native. Shopify avverte che i prodotti il cui accesso è limitato da app di terze parti o da codice personalizzato del tema potrebbero comunque comparire sugli Agentic Storefront. PunchRelay non limita l'accesso ai prodotti sul vostro storefront: il catalogo punchout è ospitato da PunchRelay, legge il vostro catalogo aziendale Shopify B2B e non pubblica, ritira o nasconde mai prodotti nel vostro negozio o su un canale di vendita. Quali prodotti compaiono su un Agentic Storefront dipende solo dalle vostre impostazioni di pubblicazione e dal catalogo B2B in Shopify. Fonte: Centro assistenza Shopify, Shopify Catalog e scoperta del prodotto per gli Agentic Storefront, consultata il 24 settembre 2026.