Producten

Producten ophalen

Dit adres geeft de producten die voor jouw bedrijf beschikbaar zijn, met per product de gegevens, de status en de aanbiedingen van leveranciers. Het antwoord is een pagina met producten. Hoe je alle pagina's doorloopt, staat bij Synchroniseren.

# Zet je token in een omgevingsvariabele. Zet het nooit in een script dat je deelt.
export PIM_API_TOKEN='<jouw-token>'

# -g laat curl de blokhaken in filter[...] ongemoeid.
curl -sS -g "https://pim.internetservicebureau.nl/api/v1/products?per_page=2" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer $PIM_API_TOKEN"

// Alleen in code op je eigen server: zet het token nooit in browsercode.
// Top-level await werkt in een ES-module (een .mjs-bestand of "type": "module").
const token = process.env.PIM_API_TOKEN;

const response = await fetch('https://pim.internetservicebureau.nl/api/v1/products?per_page=2', {
  headers: {
    Accept: 'application/json',
    Authorization: `Bearer ${token}`,
  },
});

// Een fout is ook JSON: {"message": "..."}
console.log(response.status, await response.json());

<?php

// Het token komt uit de omgeving, niet uit de code.
$token = getenv('PIM_API_TOKEN');

$curl = curl_init('https://pim.internetservicebureau.nl/api/v1/products?per_page=2');
curl_setopt_array($curl, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Accept: application/json',
        "Authorization: Bearer {$token}",
    ],
]);

$body = json_decode(curl_exec($curl), true);

// Een fout is ook JSON: {"message": "..."}
echo curl_getinfo($curl, CURLINFO_RESPONSE_CODE), PHP_EOL;
print_r($body);

import json
import os
import urllib.error
import urllib.request

# Het token komt uit de omgeving, niet uit de code.
token = os.environ["PIM_API_TOKEN"]

request = urllib.request.Request(
    "https://pim.internetservicebureau.nl/api/v1/products?per_page=2",
    headers={
        "Accept": "application/json",
        "Authorization": f"Bearer {token}",
    },
)

try:
    with urllib.request.urlopen(request) as response:
        print(response.status, json.load(response))
except urllib.error.HTTPError as error:
    # Een fout is ook JSON: {"message": "..."}
    print(error.code, json.load(error))

Wanneer een product verschijnt

Een product staat in de lijst als dit allemaal klopt:

• Het product heeft een EAN.
• Je hebt een actief klantartikel voor dit product. Een verwijderd of op inactief gezet artikel telt niet. Is het artikel in je eigen kassa of ERP op inactief gezet, dan blijft het ook weg.
• Er is minstens één actief aanbod dat je mag gebruiken. Of dat aanbod voor jou geldt, hangt af van je abonnement, licenties en merkrechten, zie Hoe het werkt.

Er is één uitzondering. Heeft een artikel uit je eigen kassa of ERP een eigen voorraad groter dan nul, dan blijft het in de lijst staan, ook als het aanbod van de leverancier uitloopt of niet verkrijgbaar is. Dat aanbod moet je dan nog wel mogen gebruiken.

Valt een product uit de lijst, dan krijg je daar geen bericht van. Het is er gewoon niet meer. Meer daarover bij Synchroniseren.

Parameters

Het antwoord zegt niet hoeveel producten er in totaal zijn. Je weet dat je op de laatste pagina bent als links.next null is.

Filters

Gewijzigd sinds (updated_at)

Met dit filter vraag je alleen de producten op die zijn gewijzigd. Zet er een voorvoegsel voor, zoals >=, en daarachter een tijdstip.

De tekens >, < en = kunnen niet zomaar in een URL. Schrijf ze als %3E, %3C en %3D. Dus >= wordt %3E%3D. Functies als http_build_query, URLSearchParams en de params van requests doen dat voor je. Bij curl met -g schrijf je het zelf.

Het tijdstip mag in een van deze vormen:

• 2026-03-12T10:00:00
• 2026-03-12 10:00:00, met de spatie als %20 in de URL
• 2026-03-12, dat telt als middernacht aan het begin van die dag

Wat telt als wijziging? Een product komt mee als er iets veranderde in zijn inhoud: de naam, beschrijving, afbeeldingen, prijs of voorraad. Dat kan gaan om het product zelf, om een aanbod dat je mag gebruiken, of om je eigen klantartikel. Bij een artikel uit je eigen kassa of ERP tellen ook een wijziging van je eigen voorraad en een wijziging van de status van het aanbod mee.

Alle producten die sinds 12 maart 2026 om 10:00 uur zijn gewijzigd:

curl -sS -g "https://pim.internetservicebureau.nl/api/v1/products?filter[updated_at]=%3E%3D2026-03-12T10:00:00" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer $PIM_API_TOKEN"

Zonder voorvoegsel zoekt de PIM op precies dat tijdstip. Dat levert bijna altijd een lege lijst op. Gebruik daarom een voorvoegsel.

Eigen voorraad (stock)

Dit filter werkt op stock bovenaan het product: je eigen voorraad uit je kassa of ERP. Het gebruikt dezelfde voorvoegsels als hierboven. De voorraad van leveranciers telt niet mee. Producten zonder eigen voorraad komen er niet door, ook niet bij <=5.

De waarde moet een getal zijn, eventueel met een voorvoegsel. Anders krijg je 422, zie Foutmeldingen.

curl -sS -g "https://pim.internetservicebureau.nl/api/v1/products?filter[stock]=%3E%3D5" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer $PIM_API_TOKEN"

Eén product opzoeken (ean13)

curl -sS -g "https://pim.internetservicebureau.nl/api/v1/products?filter[ean13]=8710000000001" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer $PIM_API_TOKEN"

Een onbekend filter geeft een 400. Je kunt filters combineren: ze gelden dan allemaal tegelijk.

Het antwoord

Het antwoord is JSON met data, links en meta. Er is geen totaal. links.last is altijd null. Hieronder één product. De waarden zijn verzonnen.

{
  "data": [
    {
      "ean13": "8710000000001",
      "reference": "REF-1",
      "name": "Voorbeeldmerk Voorbeeld Vitamine C - 90cp",
      "original_name": "Voorbeeld Vitamine C",
      "nut_plas_number": null,
      "brand": "Voorbeeldmerk",
      "vat": 9,
      "category": null,
      "content": "90cp",
      "unit_value": 90,
      "unit_type": "cp",
      "short_description": null,
      "description": "<p>Voorbeeldomschrijving.</p>",
      "ingredients": [],
      "specifications": [],
      "attributes": [],
      "nutrition": [],
      "images": [
        "https://pim.internetservicebureau.nl/storage/img/voorbeeld.jpg"
      ],
      "status": "active",
      "eol_date": null,
      "field_sources": {
        "name": "Voorbeeldleverancier",
        "brand": "Voorbeeldleverancier",
        "content": "Voorbeeldleverancier",
        "short_description": "Voorbeeldleverancier",
        "description": "Voorbeeldleverancier",
        "images": "Voorbeeldleverancier"
      },
      "changed_at": {
        "name": "2026-03-01T09:00:00+01:00",
        "short_description": null,
        "description": null,
        "images": null,
        "price": "2026-03-12T11:30:00+01:00",
        "stock": "2026-03-12T11:30:00+01:00"
      },
      "stock": 7,
      "suppliers": [
        {
          "licence": "",
          "supplier": "Voorbeeldleverancier",
          "sku": "V-1",
          "name": "Voorbeeld Vitamine C",
          "nut_plas_number": null,
          "status": "active",
          "stock": 40,
          "price": 8.5,
          "price_incl": "9.27",
          "advice_price": 14.95,
          "wholesale_price": null,
          "category": null,
          "ingredients": [],
          "attributes": [],
          "nutrition": [],
          "description": null,
          "clean_description": null,
          "images": [
            "https://pim.internetservicebureau.nl/storage/img/voorbeeld.jpg"
          ]
        }
      ]
    }
  ],
  "links": {
    "first": "https://pim.internetservicebureau.nl/api/v1/products?page=1",
    "last": null,
    "prev": null,
    "next": null
  },
  "meta": {
    "current_page": 1,
    "current_page_url": "https://pim.internetservicebureau.nl/api/v1/products?page=1",
    "from": 1,
    "path": "https://pim.internetservicebureau.nl/api/v1/products",
    "per_page": 100,
    "to": 1
  }
}

Velden van een product

Velden van een aanbod in suppliers

Heeft een product voor een veld geen waarde, dan staat het veld er toch, met null of een lege lijst.