ETIM-classificatie in één API-call

Stuur ruwe productdata op, precies zoals die in je eigen systeem staat. Je krijgt de ETIM-klasse met alle kenmerken, waarden en eenheden terug, klaar voor je PIM, ERP of webshop.

Binnenkort Binnenkort ook classificeren naar je eigen datastandaard.
POST /api/v1/etim/classify
Authorization: Bearer upk_…
{
  "name": "Knipex zijsnijtang 160 mm",
  "data": {
    "merk": "Knipex",
    "categorie": "Handgereedschap",
    "typenummer": "70 02 160",
    "artikelnaam": "Knipex zijsnijtang 160 mm",
    "omschrijving": "Zijsnijtang, gepolijste kop",
    "prijs": "24.95"
  }
}

Wat je met de API kunt

Dezelfde classificatie die in het Upshift-platform draait, nu aan te roepen vanuit je eigen software.

Klasse en kenmerken in één call

Upshift bepaalt de ETIM-klasse en vult de kenmerken met waarden en eenheden. Je hoeft je data niet eerst om te zetten: vrije key/value-velden zijn genoeg.

Klasse al bekend? Alleen kenmerken

Geef een ETIM-klassecode mee en Upshift slaat de klassebepaling over. Handig als je assortiment al geclassificeerd is, maar de kenmerken nog leeg zijn.

JSON of ETIM xChange 2.0

Kies het formaat dat bij je proces past: overzichtelijke JSON voor je eigen code, of een schemageldig xChange 2.0-document om in te lezen in je PIM.

Herleidbaar per kenmerk

Elk kenmerk vermeldt uit welk veld van je data de waarde komt, en elke classificatie krijgt een zekerheidsscore. Zo zie je direct wat je kunt vertrouwen en wat je wilt controleren.

In drie stappen aan de slag

1

API-sleutel aanmaken

Maak in Upshift een sleutel aan via Instellingen, API-sleutels. De ETIM-groepen die je voor je account hebt ingesteld, gelden ook voor de API.

2

Productdata versturen

Stuur een product naar het classify-endpoint. Alleen de productdata is verplicht; naam, bekende klasse en outputformaat zijn optioneel.

3

Resultaat verwerken

Je krijgt direct antwoord met klasse, groep, kenmerken en eenheden. Het product wordt niet aan je Upshift-catalogus toegevoegd.

Voor wie is de API?

Eigen PIM of ERP

Classificeer nieuwe artikelen op het moment dat ze binnenkomen, zonder dat iemand eerst een export hoeft te maken.

Softwarepartners en integrators

Bouw ETIM-classificatie in je eigen product in, zonder zelf een classificatiemodel te ontwikkelen en bij te houden.

AI-agents en automatisering

Laat een AI-agent of workflowtool een product classificeren als één stap in een groter proces.

Nu ETIM, binnenkort je eigen standaard

We breiden de API stap voor stap uit. Dit is wat er nu kan en wat eraan komt.

Beschikbaar

ETIM

Classificeer naar de actuele ETIM DYNAMIC-release, inclusief kenmerken, waarden en metrische eenheden. Klasse- en kenmerknamen zijn Nederlandstalig, de codes zijn taalonafhankelijk.

Binnenkort

Je eigen datastandaard

Werk je met een eigen categorieboom en eigen kenmerken in plaats van ETIM? Binnenkort classificeer je via dezelfde API ook naar je eigen datastandaard. Wil je hier als eerste mee werken? Laat het ons weten.

Laat het ons weten

Wat kost de API?

Inbegrepen in je abonnement

De API zit standaard in ieder Upshift-abonnement. Heb je een account, dan maak je direct een API-sleutel aan en ga je aan de slag.

Bekijk de prijzen

Alleen de API

Wil je alleen de API gebruiken, zonder het volledige platform? Dan zijn de kosten lager. Neem contact op, dan kijken we samen wat past bij jouw gebruik.

Neem contact op

Goed om te weten

Alle endpoints, velden, voorbeelden en foutcodes staan in de API-documentatie.

  • Synchroon: het resultaat staat direct in de response
  • Tot 32.000 tekens productdata per request
  • Maandelijks quotum per account, alleen verwerkte requests tellen mee
  • Numerieke waarden altijd in de metrische eenheid van het kenmerk
  • Foutmeldingen met een vaste, voorspelbare structuur
  • Authenticatie met een Bearer-token per klantaccount

Aan de slag met
de Upshift API

De API zit standaard in je Upshift-abonnement: maak een API-sleutel aan en probeer het direct. Wil je alleen de API gebruiken, of heb je vragen over jouw toepassing? Neem contact op, dan denken we graag mee.