Guide

DPP Integration with ERP and PIM: Connecting the Digital Product Passport to Your Systems

Integrate the digital product passport with ERP and PIM through a REST API, batch sync and webhooks. Data ownership, security and the steps of an integration project.

DPP ERP integrationdigital product passport APIPIM integration product passport

Which system should own which data

Before integrating, agree on who owns what. The ERP or PIM usually remains the source of core data: name, SKU, GTIN, brand, model and descriptions. DPPC takes over what those systems typically do not handle well: material composition with share and origin, documents and certificates with review and expiry dates, supplier data, product approval and publication of the passport with a QR code. That way every piece of information has exactly one place where it is edited.

How integration with DPPC works

DPPC provides a REST API, version v1, with documentation and a downloadable OpenAPI schema. The API covers products, materials, documents, suppliers, certificates and industry field templates, as well as workflow actions: approving, rejecting, publishing and archiving a product. There are no ready-made plugins for specific ERP systems. The integration is built by your IT team or an integrator who knows your ERP or PIM, and the DPPC API is designed to make that integration simple and predictable.

Batch sync instead of individual calls

With large catalogs it is easier to send data in batches. Sync jobs accept up to 500 product, supplier or certificate records at once, create new records or update existing ones, and are processed in a background queue. The job status, the number of processed records and a description of errors can be checked through the API. Before saving, data can also be sent for preview validation, which returns warnings without changing anything in the system.

Webhooks: sending changes back to your systems

The integration works in both directions. DPPC sends webhooks when products, materials, documents, suppliers and certificates are created, updated or deleted, and when a passport is published. Every notification is signed with HMAC-SHA256, so the receiver can verify that it comes from DPPC. Failed deliveries are retried three times, after one, five and fifteen minutes, and a test event can be sent from the organization settings.

Integration security and reliability

Each system connects with its own API key and selected permissions, for example read-only access to products or write access to certificates, so the key used by an online store cannot change data. Write operations support the Idempotency-Key header: sending the same request again, for example after a dropped connection, does not create duplicates. The limits are 180 reads and 60 writes per minute per key.

DPP ERP integration step by step

Start by mapping fields: which data from the ERP or PIM goes into DPPC and into which fields, including the industry fields from the template available through the API. Then create an API key with minimal permissions and test preview validation on a few products. Next, run the first batch sync for one category and configure webhooks if other systems need to react to changes. Documents and certificates are usually completed in DPPC, because that is where they are reviewed.

FAQ

Frequently asked questions

Does DPPC have a ready-made connector for my ERP?

There are no ready-made connectors for specific systems. Integration works through a documented REST API, batch sync and webhooks, which lets you connect DPPC to any ERP or PIM that can call an API.

Do we have to integrate the ERP to start using product passports?

No. To start, data can be imported from CSV files using the templates. The integration is worth building once the process works on a pilot category and the data in the ERP changes often.

Where can I find the API documentation?

The API v1 documentation is public at /api-docs, together with a downloadable OpenAPI schema that can be imported into developer tools.

What happens if the integration sends the same data twice?

If a write request has an Idempotency-Key header, DPPC recognizes the repeat and returns the result of the first call instead of creating a duplicate. Sync jobs update existing records instead of creating new ones.

Can a product passport be published through the API?

Yes, the API provides approve, reject, publish and archive actions. Publishing through the API follows the same rules as in the application: the product must have all required data and documents.