AircoTool.nl

Product aanmaken of bijwerken

POST /api/v1/products

Maakt één of meerdere producten aan, of werkt ze bij (upsert). Een product wordt geïdentificeerd op basis van external_id: hetzelfde external_id versturen werkt als een update van het bestaande product.

Verzoek

De payload kan op drie manieren worden aangeleverd:

  • Een object met een products-array.
  • Een los object met een external_id (wordt automatisch in een array geplaatst).
  • Een JSON-array van productobjecten.

Optioneel kun je ?replace=1 meesturen om producten die niet in de payload voorkomen te verwijderen (volledige vervanging).

{
  "replace": false,
  "products": [
    {
      "external_id": "acme-001",
      "brand": "Acme",
      "model": "Cool 3000",
      "type": "single_split",
      "cooling_capacity_kw": 3.5,
      "price_incl_vat": 899.00,
      "in_stock": true,
      "is_available": true
    }
  ]
}

Velden

Veld Type Verplicht Beschrijving
external_id string ja Unieke id van het product binnen de partner.
brand string ja Merknaam.
model string ja Modelnaam.
type string ja single_split, multi_split_indoor of multi_split_outdoor.
cooling_capacity_kw number ja Koelvermogen in kW.
heating_capacity_kw number nee Verwarmingsvermogen in kW.
seer number nee Seasonale energie-efficiëntie (koelen).
scop number nee Seasonale energie-efficiëntie (verwarmen).
energy_label string nee Energielabel, bijvoorbeeld A+++.
indoor_noise_db number nee Geluidsniveau binnenunit in dB.
max_indoor_units integer nee Max. aantal binnenunits (multi-split).
refrigerant string nee Koudemiddel, bijvoorbeeld R32.
price_incl_vat number ja Prijs inclusief btw.
currency string nee Valuta, standaard EUR.
image_url string (url) nee Afbeeldings-URL.
product_url string (url) nee Product-URL.
in_stock boolean nee Fysiek op voorraad.
is_available boolean nee Beschikbaar voor verkoop.

Antwoord 201 Created

{
  "data": [ { "external_id": "acme-001", "...": "..." } ],
  "synced_at": "2026-08-24T12:00:00+00:00"
}