Connecter des systèmes avec clés API, webhooks et EPCIS

Clés API

Une clé API sert à l'accès machine à machine. Le secret est affiché une fois et stocké sous forme hachée, avec un préfixe visible pour l'identification et une date de dernier usage qui distingue une intégration active d'une clé oubliée. Les clés expirent et peuvent être révoquées.

Les portées déterminent ce qu'une clé peut faire - lire ou écrire sur une ressource - et une clé agit comme le membre qui l'a créée pour l'attribution, sans hériter de son rôle. Si le propriétaire d'une clé a disparu, la clé ne peut pas agir : une piste d'audit qui ne nomme personne n'est pas une piste d'audit.

Webhooks sortants

Un webhook abonne votre point de terminaison à un ensemble d'événements. Chaque livraison est signée, réessayée avec attente croissante en cas d'échec, et consignée dans un journal de livraison avec le code de statut et l'erreur : vous pouvez donc dire à un partenaire que son point de terminaison a renvoyé une erreur au lieu de deviner.

Une livraison conservée peut être rejouée, ce dont vous avez besoin après avoir corrigé un point de terminaison. Supprimer un webhook supprime aussi son historique de livraison : exportez d'abord ce que vous devez conserver.

EPCIS 2.0

Un abonnement EPCIS est une requête permanente sur le flux d'événements de cycle de vie : quels types d'événements, étapes métier, dispositions, identifiants produit, catégories ou passeports vous voulez, et où les envoyer. Les événements correspondants sont diffusés comme événements objets standard.

Un abonnement est réalisé comme un webhook avec un filtre : il hérite donc de la signature, des reprises, du journal de livraison et du rejeu - et le filtre n'est jamais contourné. Utilisez l'action de test pour prouver un point de terminaison avant de vous y fier, et le rattrapage borné pour mettre un nouvel abonné au niveau de l'historique.

Qualité des données du flux

Les événements de cycle de vie viennent de vos propres fiches et des captures partenaires que vous importez. Un import est idempotent par identifiant d'événement : un partenaire qui relance un lot ne crée donc pas de doublons, et les événements appartenant au système, comme la mise en service, sont refusés car la plateforme les enregistre déjà.

Le corps de livraison est une enveloppe de plateforme ; l'événement objet standard se trouve à l'intérieur. Les destinataires doivent lire la charge plutôt que supposer un événement nu.

Avant la mise en production

Donnez une clé distincte à chaque intégration, afin que révoquer l'une ne casse pas les autres. Pointez d'abord les webhooks vers un point de terminaison de test et consultez le journal de livraison, car une signature non concordante se débogue bien plus facilement là qu'en production. Et gardez la clé hors du contrôle de version : la console ne l'affiche qu'une seule fois.

Hub d'intégration : mappings et flux

Le hub d'intégration aligne les passeports sur un export ERP, PIM ou PLM. Un mapping indique la colonne qui porte le SKU ou le GTIN et quelle colonne alimente quelle cible : un champ produit (product.brand) ou un chemin de données du passeport (data.materials.0.recycled_percent), avec conversion (nombre, unité, date, oui/non, code pays) et table de correspondance.

Téléversez un fichier CSV ou JSON et prévisualisez les écarts avant d'appliquer : seules les valeurs différentes sont écrites, dans une nouvelle version validée. Un flux https quotidien peut être configuré (jeton chiffré, jamais réaffiché). La provenance de chaque champ indique le mapping et l'exécution qui l'ont écrit.

Modèles, XML, SFTP, OAuth et envoi

Partez d'un modèle pour SAP S/4HANA (API Product ou IDoc MATMAS), SAP Business One, Dynamics 365 Business Central, NetSuite, Odoo, Akeneo, Pimcore, Salsify, Plytix ou une nomenclature PLM. Les sources peuvent être CSV, JSON ou XML.

Les flux se lisent en HTTPS (GET, ou POST avec un corps pour GraphQL, OData, SuiteQL) avec jeton, identifiants, clé dans un en-tête ou OAuth 2.0, ou en SFTP avec mot de passe ou clé et empreinte d'hôte épinglée, chaque heure ou chaque jour. Votre système peut aussi envoyer les enregistrements avec un jeton d'envoi, et un mapping peut créer les produits manquants. Un mapping de nomenclature tient à jour la structure des composants de chaque produit parent, sans toucher aux composants saisis à la main.

Export Asset Administration Shell (AAS)

Chaque passeport s'exporte en Asset Administration Shell au format JSON du métamodèle AAS V3 : bouton AAS export du passeport, ou GET /dpp/{id}/aas.json (version publiée par défaut). Un passeport publié propose aussi GET /public/dpp/{id}/aas.json avec exactement le contenu public.

Le shell contient un sous-modèle Nameplate (identifiant sémantique Digital Nameplate), un sous-modèle DigitalProductPassport avec toutes les données et un sous-modèle Components qui référence les shells des composants. Hors Nameplate, les sous-modèles utilisent des identifiants de la plateforme sans revendiquer la conformité à un modèle IDTA.

Référence page par page

Ces pages ont été vérifiées dans la console de l'organisation le 8 octobre 2026 avec une organisation de démonstration isolée. Les commandes varient selon le rôle, le forfait, l'état du dossier et les fournisseurs configurés. Les explications pratiques et les noms des commandes ci-dessous suivent l'interface anglaise vérifiée.

API keys (/settings/api-keys)

API keys give integrations scoped access to organization endpoints and can expire independently of a browser session.

Name a key for one integration and choose the smallest scope set that supports its specific endpoints. Copy the secret at creation into the intended secure system because the raw value is not displayed later. Use status and last-used information to retire unused credentials; a key cannot exceed its creator's current access.

The full secret is not retrievable after creation.

Commandes et options

• Give the key a name and optional expiry in days.
• Select only the scopes the integration needs, then Create key and copy the secret once.
• Inspect the key list for status and last use; revoke an unused or exposed key.
• A member-created key is limited by that member's current role and workspace access.

Webhooks (/settings/webhooks)

Event subscriptions send signed organization events to your HTTPS endpoint and keep delivery attempts for troubleshooting.

Subscribe an HTTPS receiver to only the event types it needs and store the signing secret in that receiver. After adding the endpoint, inspect delivery attempts and response codes to see whether it accepted events. Replaying a failed attempt may deliver a duplicate, so the receiver should deduplicate and verify signatures before processing.

A successful HTTP delivery means the endpoint accepted the event, not that its downstream processing succeeded.

Commandes et options

• Enter an HTTPS endpoint and signing secret, or let the system generate a secret.
• Choose the event types the receiver actually needs, then Add webhook.
• Inspect deliveries for response codes and retry history; replay a failed attempt after fixing the receiver.
• Rotate a compromised secret and confirm the receiver accepts the new signature.

EPCIS subscriptions (/settings/epcis)

An EPCIS subscription pushes matching lifecycle events to a standing partner endpoint.

Define a destination and narrow the subscription query so a partner receives only relevant GTINs, categories, steps, dispositions, or event types. Send a sample to confirm endpoint and signature handling, then inspect deliveries during live use. Backfill and replay can resend events, so the receiver must deduplicate by event identity.

Subscribers should deduplicate by event identity; delivery is retried.

Commandes et options

• Name the subscription, set Destination URL and optional signing secret.
• Limit the query by category, GTIN, event type, business step or disposition.
• Create the subscription and send a sample before depending on live delivery.
• Inspect the log, bounded backfill and replay controls when a receiver misses events.

Integration hub (/integration-hub)

Mappings translate ERP, PIM or PLM records into product fields, passport paths or component lines using a declared key and transforms.

Define how one source record identifies a product before mapping fields, then preview the transformation on a representative file. Record-to-field and bill-of-material mappings have different row meanings, so choose the kind that matches the source. Keep feed credentials in their dedicated fields and apply a run only after reviewing proposed writes and validation errors.

Applied differences pass schema validation and become audited passport versions.

Commandes et options

• Start from a template or blank mapping; choose records or BOM kind and CSV, JSON or XML source.
• Select SKU or GTIN key field and source column, then add source-to-target rules with transforms and optional value maps.
• Configure optional HTTPS or SFTP feed and manual, hourly or daily schedule; credentials are write-only.
• Save mapping, then preview a sample before any write.

Mapping detail (/integration-hub/[id])

A saved mapping has preview, execution, feed and push controls plus run history.

Preview a file or feed against the saved mapping and inspect record-level matches, proposed differences, and rejections. Run the mapping only when the preview matches the intended products; changed passport data creates audited revisions. After a run, compare applied and skipped counts, then use history to investigate a particular source row without editing earlier provenance.

Do not paste source credentials into support messages or free-text mapping fields.

Commandes et options

• Upload a source file and Preview changes to inspect per-record matches, errors and proposed writes.
• Run only after reviewing; changed passport fields create new versions, while unchanged values are skipped.
• Feed and push can fetch a scheduled source or issue a scoped push token for the source system.
• Edit rules and Save mapping with revision protection; inspect Run history for applied and rejected rows.
• Delete mapping requires confirmation and does not erase earlier run provenance.