API & integration
Niets hiervan wordt een tweede plek om data in te voeren
Uw PLM blijft de master voor specificaties, uw ERP voor transacties. Het paspoort is een weergave daarvan die de twee dingen toevoegt die zij niet kunnen bevatten: een toegangsbeleid en bewijs bij elke claim.
- Protocol
- REST over HTTPS
- Push
- Ondertekende webhooks
- Stamdata
- Blijft van u
Definition
Hoe integreert een paspoortplatform met een ERP of PLM?
Het staat erboven in plaats van ze te vervangen. Specificaties blijven in PLM, transacties in ERP, voetafdrukberekeningen in het boekhoudpakket. Data stroomt het paspoort in via een REST-API, geplande exports en leveranciersinzendingen, en webhooks waarschuwen uw systemen wanneer het paspoort verandert.
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.
Verantwoordelijkheid
Welk systeem waar eigenaar van is, na integratie
| 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 |
Interfaces
Hoe data zich verplaatst
REST-API
JSON over HTTPS voor paspoorten, gebeurtenissen en credentials, met sleutels begrensd per omgeving.
Geplande import
Voor systemen die niet naar buiten kunnen bellen, in kaart gebracht bij ontvangst in plaats van door u omgevormd.
Inzending door de leverancier
De route voor data die u niet zelf houdt — ondertekend door de leverancier, niet overgetikt door u.
Ondertekende webhooks
Wijzigingen in paspoorten, gebeurtenissen en credentials worden naar uw systemen gepusht, met retries en backoff.
Veldmapping
Uw veldconventies één keer op het normenmodel afgebeeld, daarna per import toegepast.
Wijzigingshistorie
Wezenlijke wijzigingen worden vastgelegd als gedateerde gebeurtenissen, zodat twee leesmomenten met elkaar te rijmen zijn.
Volgorde
Een realistische integratievolgorde
- 01
Het bronsysteem vaststellen
Bepaal welk systeem elke dataklasse bezit voordat u ook maar één mapping schrijft. Dit overslaan is wat dubbele stamdata oplevert.
- 02
Eén productgroep in kaart brengen
Importeer een echte export en lees het gaprapport. Het vertelt u wat de gedelegeerde handeling vraagt en wat op dit moment niemand heeft.
- 03
Leveranciersonboarding starten
Begin meteen en parallel. Dit is het kritieke pad, en het is eerder een relatie- dan een technische oefening.
- 04
De callbacks aansluiten
Abonneer uw systemen op paspoort- en credentialwijzigingen, zodat processen stroomafwaarts reageren in plaats van te pollen.
Antwoorden
Veelgestelde vragen
Welk systeem blijft de master voor productdata?
Van u. PLM blijft de master voor specificaties, ERP voor transacties en uw CO₂-boekhoudtool voor voetafdrukberekeningen. CirculeID houdt het paspoort — de samengestelde, toegangsgestuurde, bewijsdragende weergave over die systemen — en wordt geen tweede plek waar de onderliggende data onderhouden moet worden.
Hoe komt de data er eigenlijk in?
Op drie manieren, meestal gecombineerd: de REST-API voor systemen die naar buiten kunnen aanroepen, geplande exports voor systemen die dat niet kunnen, en leveranciersinzending voor data die u helemaal niet hebt. De derde is normaal het grootste deel van het werk, omdat samenstellingsdata van de tweede schakel zelden in enig systeem van u bestaat.
Wat gebeurt er wanneer de brondata verandert?
Het paspoort wordt bijgewerkt. Waar de wijziging wezenlijk is — een correctie van de samenstelling, een nieuwe certificering — wordt zij vastgelegd als gedateerde gebeurtenis in plaats van de vorige waarde stilzwijgend te overschrijven, zodat een vorig jaar en dit jaar gelezen paspoort te verzoenen zijn.
Hebt u kant-en-klare connectoren?
Voor de gangbare ERP- en PLM-systemen wel, en zij verkorten de mapping in plaats van haar te vervangen: elke implementatie heeft eigen veldconventies en een eigen geschiedenis van workarounds. Behandel een connector als startpunt van het mappinggesprek, niet als vervanging ervan.
Hoe komen onze systemen erachter dat er iets is veranderd?
Webhooks. Wijzigingen aan paspoort, gebeurtenis en credential sturen ondertekende callbacks waarop uw systemen zich abonneren, zodat een stroomafwaarts proces reageert op een nieuw leverancierscredential zonder te pollen. Aflevering wordt opnieuw geprobeerd met backoff, en het foutlogboek is zichtbaar in plaats van stil.
Next step
Neem één PLM-export mee
Wij brengen het in kaart, draaien het gap-rapport voor uw productgroep en geven u een realistisch beeld van waar het werk werkelijk zit.