API & integration
Nulla di tutto questo diventa un secondo posto in cui digitare dati
Il vostro PLM resta il master per le specifiche, l’ERP per le transazioni. Il passaporto è una vista su di essi che aggiunge le due cose che non possono contenere: una policy di accesso e una prova per ciascuna asserzione.
- Protocollo
- REST su HTTPS
- Push
- Webhook firmati
- Dati anagrafici
- Resta tuo
Definition
Come si integra una piattaforma di passaporto con un ERP o un PLM?
Si colloca sopra di essi anziché sostituirli. Le specifiche restano nel PLM, le transazioni nell’ERP, i calcoli dell’impronta nello strumento di contabilità. I dati confluiscono nel passaporto tramite un’API REST, export pianificati e invii dei fornitori, e i webhook avvisano i tuoi sistemi quando il passaporto cambia.
The part most integration plans underestimate is the third input. Tier-two composition and certification data usually exists in none of your systems, because until now nothing required you to hold it.
Responsabilità
Quale sistema presidia che cosa, dopo l’integrazione
| Data | System of record | What CirculeID adds |
|---|---|---|
| Product specification | PLM | The passport projection and its required-field gap report |
| Transactions and batches | ERP | Batch identity bound to a resolvable passport |
| Carbon footprint | LCA or carbon accounting tool | The figure held against the product with its methodology |
| Supplier evidence | The supplier | Signed credentials, so the claim carries its author |
| Supply chain events | WMS, MES and logistics partners | One EPCIS 2.0 history, queryable by object |
| Access policy | CirculeID | Who sees which field, evaluated at resolution time |
Interfacce
Come si muovono i dati
API REST
JSON su HTTPS per passaporti, eventi e credenziali, con chiavi delimitate per ambiente.
Import pianificato
Per sistemi che non possono chiamare verso l’esterno, mappati alla ricezione anziché rimodellati da te.
Invio del fornitore
La via per i dati che non possedete: firmati dal fornitore, non trascritti da voi.
Webhook firmati
Le modifiche di passaporti, eventi e credenziali sono inviate ai tuoi sistemi, con ritentativi e backoff.
Mappatura dei campi
Le vostre convenzioni sui campi mappate una sola volta sul modello normalizzato, poi applicate a ogni importazione.
Cronologia delle modifiche
Le modifiche rilevanti sono registrate come eventi datati, così due letture possono essere riconciliate.
Sequenza
Un ordine di integrazione realistico
- 01
Concordare il sistema di riferimento
Decidi quale sistema possiede ciascuna classe di dati prima di scrivere qualsiasi mappatura. Saltare questo passaggio è ciò che produce dati anagrafici duplicati.
- 02
Mappare un gruppo di prodotti
Importa un export reale e leggi il report dei gap. Ti dice che cosa l’atto delegato richiede e che oggi nessuno detiene.
- 03
Avviare l’onboarding dei fornitori
Comincia subito e in parallelo. È il percorso critico, ed è un esercizio di relazione più che tecnico.
- 04
Collegare le callback
Sottoscrivi i tuoi sistemi ai cambiamenti di passaporti e credenziali, così i processi a valle reagiscono anziché interrogare in continuo.
Risposte
Domande frequenti
Quale sistema resta il master dei dati di prodotto?
Vostri. Il PLM resta il master per le specifiche, l’ERP per le transazioni e il vostro strumento di contabilità del carbonio per i calcoli dell’impronta. CirculeID conserva il passaporto — la vista assemblata, con controllo degli accessi e portatrice di prove su quei sistemi — e non diventa un secondo posto in cui mantenere i dati sottostanti.
Come entrano davvero i dati?
In tre modi, di solito combinati: l’API REST per i sistemi che possono chiamare verso l’esterno, esportazioni pianificate per quelli che non possono, e l’invio da parte del fornitore per i dati che non possedete affatto. Il terzo è normalmente la parte più consistente del lavoro, perché i dati di composizione di secondo livello raramente esistono in un vostro sistema.
Che cosa succede quando i dati di origine cambiano?
Il passaporto si aggiorna. Quando la modifica è sostanziale — una correzione di composizione, una nuova certificazione — viene registrata come evento datato anziché sovrascrivere in silenzio il valore precedente, così che un passaporto letto l’anno scorso e quest’anno possa essere riconciliato.
Avete connettori pronti all’uso?
Per gli ERP e i PLM più diffusi sì, e accorciano la mappatura senza eliminarla: ogni installazione ha le proprie convenzioni sui campi e la propria storia di soluzioni tampone. Considera un connettore il punto di partenza della conversazione di mappatura, non un suo sostituto.
Come fanno i nostri sistemi a sapere che qualcosa è cambiato?
Webhook. Le modifiche a passaporti, eventi e credenziali emettono callback firmate a cui i vostri sistemi si iscrivono, così che un processo a valle reagisca a una nuova credenziale del fornitore senza polling. La consegna viene ritentata con backoff, e il registro degli errori è visibile anziché silenzioso.
Next step
Porta un export dal PLM
Lo mapperemo, produrremo il report delle lacune per il vostro gruppo di prodotto e vi daremo una visione realistica di dove sia davvero il lavoro.