Guida pratica alle integrazioni
Integrazioni che trasferiscono la stessa configurazione prodotto a tutti i tuoi sistemi.
Collega il 3D interattivo e le regole prodotto a CRM, ERP, e-commerce, PIM, calcolo dei prezzi, preventivi, analytics e dati di produzione. Questa guida definisce quali dati vengono trasferiti, quale sistema ne è responsabile, come gestire gli errori e quali prove di collaudo ne confermano il funzionamento.
Mercato di vendita · Italia · EUR · IVA
L’integrazione inizia da responsabilità chiare
Collega i dati del prodotto, non una semplice schermata.
Una configurazione è una decisione sul prodotto con versione. Può includere identificatori di sistema e componenti, dimensioni, valori selezionati, quantità, contesto calcolato, identità del cliente e stato del ciclo di vita. Un'immagine o un PDF aiuta le persone a comprendere tale decisione, ma non è nemmeno un sostituto affidabile dei dati strutturati.
Prima di scegliere un prodotto API, webhook o middleware, indica la sistema di riferimento per ogni campo. Il configuratore può possedere compatibilità e geometria; PIM può possedere contenuti di prodotto localizzati; CRM possiede la relazione; il commercio possiede la cassa; ERP possiede l'ordine; e i sistemi di produzione possiedono i dati di produzione rilasciati. L’integrazione rende esplicite queste responsabilità.
La specifica più forte inizia con un evento aziendale e un risultato accettato: "una configurazione approvata crea la struttura dell'ordine prevista esattamente una volta e restituisce un riferimento dell'ordine visibile." Questo è più utile di "supporta l'integrazione ERP".
Architetture di integrazione
Sei modalità con cui un configuratore può scambiare dati.
Scegli per flusso. Una richiesta di prezzo visibile al cliente e un'importazione notturna del catalogo non dovrebbero ereditare gli stessi presupposti di latenza e disponibilità.
Esperienza integrata
Il configuratore viene eseguito all'interno di un sito web, portale o pagina commerciale esistente. L'applicazione madre e quella incorporata scambiano identità, contesto, dimensioni, eventi del ciclo di vita e azioni attraverso un'interfaccia definita.
Si adatta meglio
Sito Web brandizzato, portale del rivenditore o percorso della pagina del prodotto in cui il configuratore fornisce la propria interfaccia.
Prova:Navigazione, altezza reattiva, consenso, contesto di accesso, pulsante Indietro, collegamento diretto, analisi e ripristino dopo l'aggiornamento.
Guidato da API o headless
La logica, i dati o i prezzi del prodotto vengono esposti tramite API mentre l'interfaccia rivolta al cliente viene creata separatamente. Il contratto deve restituire le scelte consentite, i messaggi delle regole e lo stato autorevole dopo ogni modifica rilevante.
Si adatta meglio
Canali multipli o un frontend altamente personalizzato che deve condividere un motore di configurazione.
Prova:Contesto, identificatori, aggiornamenti parziali, localizzazione, latenza, concorrenza, controllo delle versioni e comportamento quando il motore non è disponibile.
Evento e webhook
Un'azione completata emette un evento e un altro sistema lo elabora in modo asincrono. Ciò disaccoppia i sistemi ma richiede verifica, gestione dei duplicati, strategia di ordinazione, tentativi e riconciliazione.
Si adatta meglio
Eventi di lead, preventivo, ordine, stato e catalogo in cui non è necessario il completamento sincrono immediato.
Prova:Eventi duplicati, ritardati, fuori ordine, rifiutati e mancanti; verifica della firma; percorso dei messaggi non recapitabili o dei tentativi; riconciliazione periodica.
Middleware o piattaforma di integrazione
Un livello condiviso mappa, convalida e instrada i dati tra diversi sistemi. Può ridurre l'accoppiamento punto-punto ma diventa un prodotto operativo con monitoraggio e proprietà propri.
Si adatta meglio
Diverse destinazioni, regole di trasformazione aziendale, orchestrazione o un iPaaS consolidato e un team di integrazione.
Prova:Versione di mappatura, errore parziale, osservabilità, riproduzione, promozione dell'ambiente e proprietà quando cambiano i contratti di origine o di destinazione.
Programmato o scambio di file
Cataloghi, prezzi, ordini o dati di produzione si spostano a intervalli definiti attraverso file, archiviazione di oggetti o endpoint batch. Spesso è appropriato quando il comportamento in tempo reale non aggiunge alcun valore aziendale.
Si adatta meglio
Sistemi legacy, set di dati di riferimento di grandi dimensioni o flussi di lavoro con elaborazione giornaliera o oraria controllata.
Prova:File completi e delta, importazioni duplicate, righe con formato errato, consegna in ritardo, accettazione parziale, rapporto di controllo e recupero da un'esecuzione mancata.
Architettura ibrida
Flussi diversi utilizzano modelli diversi: ricerca dei prezzi in tempo reale, 3D incorporato, lead CRM asincrono, catalogo PIM pianificato e rilascio degli ordini ERP controllato.
Si adatta meglio
Implementazioni più mature in cui ogni decisione segue i suoi effettivi requisiti di latenza, proprietà e affidabilità.
Prova:Correlazione end-to-end tra modelli e una vista operativa che mostra dove il progetto è in attesa o ha fallito.
Pianificatore interattivo delle integrazioni
Definisci il contratto dati completo per ogni sistema di destinazione.
Seleziona un sistema per visualizzare lo scopo, la direzione, il trigger, la proprietà, il test di fallimento e il risultato di accettazione che dovrebbero apparire nell'ambito.
CRM
Integrazione CRM
Trasforma una configurazione anonima o conosciuta in un lead, un contatto, un account, un'opportunità o un progetto utile senza ridurre il prodotto a un campo nota.
Verso Configurix
Identificatori del cliente e dell'account, proprietario, mercato, canale di vendita, contesto della campagna, fase dell'opportunità ed eventuali autorizzazioni necessarie per la determinazione dei prezzi o l'accesso al catalogo.
Da Configurix
ID e revisione della configurazione, famiglia di prodotti, riepilogo, opzioni selezionate, dimensioni, contesto del prezzo, collegamenti a immagini o documenti, consenso, origine e azione successiva del cliente.
Attivazione
Richiesta qualificata, salvataggio, richiesta di preventivo, trasferimento del venditore, interruzione del pagamento o altro evento del ciclo di vita esplicitamente definito.
Sistema di riferimento
CRM normalmente possiede la relazione e lo stato della pipeline; il configuratore possiede la configurazione strutturata e dovrebbe esporre un riferimento stabile anziché duplicare la logica del prodotto incontrollata.
Test fallito
Crea un rifiuto, un timeout e un invio duplicato del CRM. Mostra lo stato operativo, preserva il progetto, riprova in sicurezza e previeni molteplici opportunità da un'azione prevista.
Prova di collaudo
Una configurazione inviata crea o aggiorna la persona, l'account e l'opportunità corretti, allega la revisione del prodotto corretta e rimane tracciabile quando la configurazione cambia.
Matrice dei sistemi di riferimento
Definisci quale sistema è di riferimento per ogni dato.
La proprietà può variare in base al campo. Documenta l'autorità, il percorso di pubblicazione e la regola di riconciliazione invece di copiare tutto ovunque.
| Dominio dati | Sistema generalmente responsabile | Regola di integrazione |
|---|---|---|
| Nomi di prodotti, media e contenuti di mercato | PIM o catalogo regolamentato | Configurator utilizza ID pubblicati e contenuti localizzati; le relazioni di sola configurazione rimangono esplicite. |
| Compatibilità e regole geometriche | Configuratore o servizio di regole del prodotto | Ogni canale riceve gli stessi valori consentiti, messaggi e il prodotto strutturato risultante. |
| Prezzo e autorizzazioni commerciali | Determinazione dei prezzi denominata o motore CPQ | La richiesta include conto, mercato, valuta, data di validità e canale; il risultato include una revisione del calcolo. |
| Cliente e opportunità | CRM | Il CRM mantiene la relazione e lo stato della pipeline mentre si collega a una configurazione e revisione stabili. |
| Carrello, cassa e pagamento | E-commerce | Commerce possiede lo stato di pagamento transazionale; le linee configurate mantengono un riferimento di configurazione durevole. |
| Proposta emessa | CPQ, CRM o servizio documenti | Il sistema proprietario conserva la versione emessa e la collega all'esatta configurazione e revisione del prezzo. |
| Ordine, evasione e stato finanziario | ERP o sistema di gestione degli ordini | La configurazione accettata viene mappata a righe ordine stabili ed espone lo stato di elaborazione al progetto. |
| Distinta base di produzione o struttura dell'ordine configurata | ERP, PLM o sistema di produzione | L'ambito definisce ID, unità, gerarchia, revisione, approvazione e se l'output è pronto per la vendita, la progettazione o la produzione. |
Dossier di configurazione strutturato
Un payload utile trasporta identità e contesto, non soltanto le etichette delle opzioni.
Questo è un esempio di pianificazione, non un contratto API Configurarix fisso. Utilizza ID di sistema stabili, valori tipizzati, unità esplicite e schemi con versione concordati con ciascuna destinazione.
identityconfiguration_id · revision · external_project_id · correlation_idcontextmarket · channel · account · pricebook · currency · language · effective_atproductfamily_id · system_id · selected_components · option_ids · dimensions · quantitiescommercialcalculation_id · line_values · tax_context · total · approval_status · valid_untilcustomercustomer_id · contact_id · consent · owner · delivery_contextlifecyclestatus · event_type · occurred_at · source · destination · retry_countoutputquote_id · document_url · order_id · bom_revision · preview_urlPacchetto di collaudo delle integrazioni
Dieci test che vanno oltre una demo ideale riuscita.
Esegui gli stessi test su Configurarix e ogni alternativa. Sostituisci i valori del campione con il prodotto approvato, la destinazione e il risultato previsto.
Identità stabile
Salva, riapri, copia e rivedi un progetto. I record di configurazione, cliente, preventivo e downstream mantengono ID stabili distinti e una relazione tracciabile.
Contesto
Esegui lo stesso prodotto per due mercati, valute, listini prezzi, lingue e ruoli utente. Ogni sistema riceve e restituisce il contesto corretto.
Carico utile noto
Confronta una configurazione normale e di confine con la mappa del campo, i tipi, le unità, il comportamento nullo, i valori controllati e gli identificatori di destinazione concordati.
Invio duplicato
Fai doppio clic o riprova la stessa azione prevista. Viene creato esattamente un lead, un preventivo o un ordine oppure viene restituito un risultato di deduplicazione definito.
Rifiuto della destinazione
Invia un componente sconosciuto, un account non valido o un prezzo scaduto. Conserva i dati di origine e mostra uno stato utilizzabile con proprietà e ID di correlazione.
Timeout e riprovare
Interrompe la risposta di destinazione dopo aver eventualmente elaborato la richiesta. Riprova in sicurezza senza indovinare o creare un duplicato incontrollato.
Evento fuori servizio
Fornisce un evento precedente dopo una revisione più recente. La destinazione non deve sovrascrivere lo stato corrente senza regole di versione o timestamp.
Riconciliazione
Rimuovi o perdi un evento, quindi esegui il processo di riconciliazione concordato. Entrambi i sistemi convergono ed espongono lo stato corretto.
Modifica contratto
Aggiungi un campo, ritira un'opzione e modifica una versione dell'endpoint in un ambiente di test. Convalidare la compatibilità con le versioni precedenti e la proprietà della distribuzione.
Autorizzazione e privacy
Tentativo di accesso multiaccount, campi eccessivi e azione senza ambito. L'autorizzazione, la minimizzazione dei campi, la registrazione e il consenso si comportano come definito.
Affidabilità e sicurezza
Progetta anche per richieste ripetute e casi di errore.
Le integrazioni produttive necessitano di un modello operativo. Definisci chi vede gli errori, chi può riprodurli e in che modo i dati personali, di account e di prezzo rimangono entro i limiti previsti.
Autenticazione e autorizzazione
Utilizza il servizio appropriato o l'identità delegata, gli ambiti con privilegi minimi, i controlli di accesso ad account e oggetti, la rotazione dei segreti e la separazione degli ambienti.
Convalida del carico utile
Convalida campi esterni, tipi, valori consentiti, dimensioni e destinazione. Ridurre al minimo i dati personali e commerciali e definire la conservazione e la registrazione.
Idempotenza e tentativi
Assegna a un'operazione prevista una chiave stabile o una regola duplicata equivalente. Riprovare solo quando è possibile stabilire il risultato senza creare un altro effetto aziendale.
Gestione del webhook
Verifica le firme del mittente, registra l'identità dell'evento, gestisci i duplicati e la consegna fuori ordine, riconosci tempestivamente ed elabora in sicurezza in background.
Correlazione e osservabilità
Trasporta gli ID di configurazione, revisione, funzionamento e correlazione tramite registri e stati in modo che il supporto possa individuare un progetto tra i sistemi.
Riconciliazione
Confronta periodicamente lo stato autorevole e recupera gli eventi persi o i tempi di inattività. Webhook e code non eliminano la necessità di dimostrare la convergenza.
Sequenza di implementazione
Integra prima un ciclo di vita completamente collaudato, poi estendi agli altri sistemi.
Definire l'evento aziendale
Scegli un prodotto, un utente, una fonte, una destinazione e un risultato osservabile rappresentativi. Registra casi normali, limite e di fallimento.
Assegna la proprietà
Crea la matrice della sistema di riferimento per identificatori, catalogo, regole, prezzo, cliente, preventivo, ordine e dati di produzione.
Mappa il contratto
Definisci campi, tipi, unità, valori controllati, contesto, autenticazione, risposta, latenza e comportamento della versione.
Crea con ambienti di test
Utilizza dati di origine rappresentativi e sandbox di destinazione. Conserva la correlazione e lo stato del primo flusso di lavoro.
Accetta il fallimento così come il successo
Esegui scenari di duplicazione, timeout, rifiuto, fuori ordine, autorizzazione, privacy, nuovi tentativi e riconciliazione.
Operare e cambiare
Responsabilità di monitoraggio, supporto, replay, incidente, modifica del contratto, modifica del catalogo e rinnovata accettazione dei nomi.
Domande frequenti delle aziende
FAQ sulle integrazioni del configuratore prodotto.
Risposte dettagliate su CRM, ERP, e-commerce, configurazione headless, prezzi, distinta base, API, webhook, errori, sicurezza e implementazione.
Riferimenti tecnici
Documentazione principale alla base delle linee guida sull'architettura.
Queste fonti illustrano modelli generali di API, eventi, affidabilità e sicurezza. Non dimostrano un connettore Configurarix né sostituiscono le specifiche di origine e destinazione per il tuo progetto.
SAP: configuratore CPQ headless
Esempio ufficiale di un'API che separa la configurazione e la logica dei prezzi da e-commerce esterno, rivenditore, mobile e altre interfacce.
Fonte ufficiale apertaSalesforce: richieste REST composite
Documentazione ufficiale per operazioni API CRM dipendenti, ID di riferimento, stato della risposta e comportamento di rollback.
Fonte ufficiale apertaShopify: Webhook
Guida operativa ufficiale relativa a firme, consegne duplicate, ordinazione di eventi e riconciliazione dopo eventi persi.
Fonte ufficiale apertaIETF RFC 9110: semantica HTTP
La definizione della specifica HTTP di metodi e condizioni idempotenti relativi ai tentativi automatici.
Fonte ufficiale apertaTop 10 della sicurezza API OWASP
Un riferimento del settore per i rischi relativi all'autorizzazione API, alle risorse, al flusso aziendale e al consumo non sicuro.
Fonte ufficiale apertaMappa il tuo flusso reale
Porta un prodotto, un sistema di destinazione e un risultato atteso.
Configurarix può definire l'ambito del flusso completo, dalle scelte e regole del prodotto alla determinazione dei prezzi, ai preventivi, al CRM, all'ERP, all'e-commerce o all'output di produzione opzionale. Identificheremo la sistema di riferimento, il carico utile, il fattore scatenante, il comportamento di fallimento e i casi di accettazione prima di considerare l'integrazione completa.
Parliamo della tua integrazioneContinua la tua pianificazione
Collega l'architettura al prodotto, al flusso di lavoro e alle prove del fornitore.
Integrazione CRM configuratore prodotto
Collega progetti configurati a contatti CRM, aziende, opportunità, proprietari, attribuzioni, preventivi e continuazione delle vendite senza record duplicati.
Leggi la guidaIntegrazione PIM configuratore prodotto
Mappa famiglie di prodotti, varianti, attributi, traduzioni, supporti e revisioni delle pubblicazioni a regole eseguibili e stato di configurazione stabile.
Leggi la guidaConfiguratore prodotto Integrazione PLM
Collega le strutture di prodotto, le opzioni, le varianti, l'efficacia e le modifiche tecniche rilasciate a configurazioni di vendita tracciabili e output tecnici.
Leggi la guidaIntegrazione ERP configuratore prodotto
Definisci l'autorità ERP, i campi dell'ordine configurato, la responsabilità del prezzo, i trigger, le conferme, i tentativi e la riconciliazione rispetto a un ordine reale.
Leggi la guidaGestione ordini configuratore prodotto
Trasforma una configurazione accettata in un ordine e-commerce, ERP o OMS controllato con revisioni esplicite, righe d'ordine, approvazioni, modifiche e riconoscimenti.
Leggi la guidaConfiguratore prodotto SSO e identità
Definisci OpenID Connect o federazione SAML, provisioning SCIM o JIT, locazione del rivenditore, ruoli, sessioni, identità di servizio e test di accettazione dell'accesso.
Leggi la guidaConfiguratore di prodotto vs gemello digitale
Configurazione separata del prodotto governato, istanze configurate, trasferimento del thread digitale e gemelli digitali operativi con identità esplicita, sincronizzazione e autorità di sistema.
Leggi la guidaConfiguratore prodotto Integrazione MES
Collega le configurazioni accettate e gli ordini di produzione rilasciati a lavori MES, distinte base, cicli, istruzioni di lavoro, genealogia, feedback sulla qualità e sull'esecuzione.
Leggi la guidaSoftware di configurazione prodotto
Consulta il catalogo completo, regole, 3D, prezzi, preventivo e modello dati di progetto.
Leggi la guidaConfiguratore di prodotti headless
Progetta contratti canonici su stato, regole, prezzi, 3D, salvataggio, transazioni ed eventi per siti Web, commercio e canali multipli.
Leggi la guida