Prerequisiti, sequenza iniziale, ambienti di test e checklist per avviare un progetto cXML con F-Merchant.

Guida Rapida all’Integrazione

Questa pagina esiste per un obiettivo pratico: aiutare un team tecnico a capire da dove iniziare davvero quando deve attivare uno scambio cXML con F-Merchant.

Non sostituisce i capitoli di dettaglio sul protocollo. Li collega in una sequenza operativa utile per l’avvio del progetto.

1. Quando usare questa guida

Usa questa pagina se devi:

• attivare un nuovo cliente B2B con integrazione e-Procurement;
• impostare un progetto PunchOut o Catalog;
• allineare buyer, ERP team e fornitore sui prerequisiti;
• preparare test, collaudo e go-live.

2. Cosa chiarire prima di iniziare

Prima ancora di parlare di XML, servono alcune decisioni di contesto:

• Scenario di business: Catalogo statico, PunchOut, invio ordini, conferme, fatture o flusso completo.
• Ruoli dei sistemi: chi invia, chi riceve, quale piattaforma fa da buyer, quale sistema gestisce ERP e fulfillment.
• Standard di trasporto: endpoint HTTP/HTTPS, autenticazione richiesta, eventuali vincoli di rete o marketplace intermedi.
• Livello di supporto richiesto: solo shopping, shopping + ordine, oppure ciclo Procure-to-Pay completo.

Se questi punti non sono chiari, il progetto tende a bloccarsi più avanti su mapping, credenziali e responsabilità operative.

3. Prerequisiti minimi

Per partire con un’integrazione servono normalmente:

• URL degli endpoint da utilizzare in test e produzione;
• identificativi delle parti coinvolte (From, To, Sender);
• dominio delle credenziali e SharedSecret, se previsto;
• elenco dei documenti cXML da supportare;
• regole di mapping tra ERP, store e piattaforma procurement;
• un referente tecnico per ciascun lato dell’integrazione.

4. Sequenza consigliata di implementazione

Nella pratica, un avvio ordinato segue quasi sempre questa sequenza:

1. Fondamenti del protocollo Comprendi envelope, header, request/response e identificativi di base.
2. Sicurezza e profilo Definisci credenziali, endpoint e capacità supportate.
3. Catalogo o PunchOut Scegli il punto di ingresso del buyer nel processo di shopping.
4. Ordine Gestisci la ricezione o trasmissione del documento d’acquisto finale.
5. Conferme e stato Aggiungi visibilità post-ordine e aggiornamenti operativi.
6. Fatturazione Completa il flusso con la parte amministrativa, se inclusa nel progetto.

5. Percorso rapido consigliato

Se devi implementare un progetto standard, il percorso più utile è:

• Fondamenti di cXML
• Sicurezza e Autenticazione
• PunchOut Transaction
• Ordini di Acquisto (Purchase Orders)
• Conferme e Stato (Order Confirmations)
• Fatturazione (Invoices)

Se invece il progetto parte da cataloghi hosted:

• Gestione Cataloghi (Catalogs)
• Ordini di Acquisto (Purchase Orders)
• Fatturazione (Invoices)

6. Ambienti e collaudo

Per evitare regressioni o falsi errori, separa sempre:

• Ambiente di test: payload realistici, ma dati non produttivi;
• Ambiente di collaudo/UAT: verifica dei casi reali e dei flussi approvativi;
• Produzione: attivazione solo dopo validazione tecnica e business.

Nel test iniziale conviene validare almeno:

• autenticazione e raggiungibilità endpoint;
• correttezza del Header;
• gestione di un documento valido;
• gestione di un errore formale;
• riconciliazione dei riferimenti tra sistemi.

7. Errori comuni in avvio

Gli errori più frequenti non sono sintattici, ma di coordinamento:

• credenziali corrette in un ambiente e sbagliate in un altro;
• mismatch tra codici articolo ERP e codici esposti al buyer;
• documenti implementati in ordine sbagliato;
• assenza di casi di test condivisi;
• ambiguità su chi possiede la responsabilità del mapping.

8. Checklist pre go-live

Prima dell’attivazione finale verifica che:

• gli endpoint di produzione siano confermati;
• credenziali e certificati siano aggiornati;
• i mapping principali siano approvati;
• i casi di errore siano noti e gestiti;
• il team business sappia quali documenti verranno realmente scambiati;
• esista un piano di supporto per i primi giorni di esercizio.

9. Cosa leggere dopo

Se stai ancora inquadrando il protocollo, prosegui con i Fondamenti di cXML.

Se hai già chiaro il contesto tecnico, il passo successivo più frequente è Sicurezza e Autenticazione, perché quasi tutti i progetti si bloccano lì prima ancora di arrivare ai documenti di business.