qr_code_2

id.codes

id.codes — push products as Digital Product Passports via an idempotent upsert (matched on GTIN / URI / dpp_id).

A full written guide for this connector is on the way. In the meantime, here's the live technical reference — always generated from the connector itself, so it's never out of date.

checklist

What it does

checkWrites / receives data (use as a target) checkAuto-discovers the field schema

tune

What you'll need to set it up

Base URL required

Base URL of the id.codes API (https://dev.id.codes for dev, https://view.id.codes at go-live). Point at this app's /api/mock/id-codes for local testing.

API key required kept secret

Your id.codes API key (Admin → Configuration → API Keys). Needs the config:read and products:write scopes. Stored encrypted — never leaves this server.

Passport identity required

How id.codes tells one passport from another. It finds a passport by its GTIN plus its batch, and treats the same GTIN with and without a batch as two passports. Every pipeline sending here must map each part, all of them the same way, and a row with a part empty is refused, not sent. Choose "GTIN and batch" when every product carries a batch (a season code, for example).

api

Technical reference — endpoints

auto — always current

Operation	Direction	Call
POST /api/v1/products (upsert)	Write (target)	POST /api/v1/products

Connection check: GET /api/v1/config

Ready to connect id.codes?

Set it up inside Smart Data Studio in a few minutes.

Open the app arrow_forward