API Documentatie | Producthandel AI Bridge

Beveiliging & Authenticatie

Om de veiligheid van uw orders en bedrijfsdata te garanderen, hanteert de Producthandel Bridge strikte authenticatie-protocollen. Geen enkel endpoint is openbaar toegankelijk.

1. X-API-Key

Elke request moet een geldige API-sleutel bevatten in de headers. Deze sleutel is cryptografisch gekoppeld aan uw specifieke bedrijfsaccount en prijsafspraken.

Header: X-API-Key: uw_unieke_geheime_sleutel

2. Idempotency (Anti-Dubbel)

Bij het aanmaken van orders stuurt u een unieke Idempotency-Key mee (bijv. uw eigen ordernummer). Als een netwerkstoring zorgt dat u de order per ongeluk 2x instuurt, herkent onze Bridge de sleutel en blokkeert de dubbele order. 100% zekerheid voor u.

Reseller Endpoints

Integreer Producthandel direct in uw eigen webshop (Shopify, WooCommerce, Magento, etc.).

POST

/api/v1/orders/create

Schiet een verkooporder veilig in. U kunt facturatie- en afleveradressen splitsen (bijv. voor white-label dropshipment direct naar uw consument). Gebruik de Idempotency-Key in de header om dubbele orders te voorkomen.

Request Payload

{
  "partner_reference": "ORD-2026-991",
  "dropshipment": true,
  "shipping_address": {
    "name": "Klant X",
    "street": "Hoofdstraat 1",
    "city": "Amsterdam",
    "zip": "1000AA",
    "country": "NL"
  },
  "lines": [
    { "sku": "PH-8820", "qty": 2 }
  ]
}

Succes Response (201 Created)

{
  "status": "success",
  "message": "Order succesvol ontvangen en in verwerking.",
  "producthandel_order_id": "SO-94821",
  "expected_dispatch": "2026-04-21"
}

GET

/api/v1/inventory/{sku}

Controleer real-time de voorraad. Dit endpoint is extreem snel ontworpen, speciaal om aan te roepen in de 'checkout' van uw webshop om backorders te blokkeren.

{
  "sku": "PH-8820",
  "available_stock": 12,
  "reservable": true
}

GET

/api/v1/catalog/export

Haal een actuele feed op van ons assortiment. Let op: Doordat u uw API-key meestuurt, berekent dit endpoint automatisch uw B2B-staffelkorting en toont het uw specifieke inkoopprijs, niet de consumentenprijs.

Leverancier Endpoints

Houd Producthandel automatisch op de hoogte van uw actuele voorraad en prijzen.

POST

/api/v1/supplier/catalog/update

Stuur periodiek (bijv. elk uur) een update van uw prijzen en voorraad. Onze AI vertaalt uw datastructuur veilig naar onze database. Hiermee voorkomt u dat wij producten verkopen die u niet meer heeft.

Payload

{
  "products": [
    {
      "your_sku": "ART-99",
      "stock_qty": 45,
      "wholesale_price": 245.50
    }
  ]
}

Response

{
  "status": "success",
  "items_processed": 1,
  "timestamp": "2026-04-20T13:45:00Z"
}

Enterprise & Legacy Systemen

Geen tijd of budget voor API-development? Laat onze AI het vertaalwerk doen.

POST

/api/v1/enterprise/upload

Bouw in uw logge ERP-systeem enkel een simpele export (dump) van uw XML of CSV bestanden en stuur deze rauw naar dit adres. U hoeft geen velden te hernoemen; onze lokale bridge leert uw layout eenmalig aan en mapt voortaan alles automatisch.

MAIL

bridge@producthandel.nl

Volledig geautomatiseerd bestellen via e-mail. Volledig veilig en zonder handmatig overtypen.

Stap 1: U stuurt (of uw systeem mailt automatisch) een inkooporder in PDF of Excel naar dit beveiligde e-mailadres.
Stap 2: De Bridge controleert of de afzender op de 'Whitelist' staat (ter voorkoming van fraude).
Stap 3: De AI extraheert de aantallen, SKU's en afleveradressen.
Stap 4: U ontvangt een automatische mail retour met daarin de definitieve orderbevestiging.