Partner Order API

De Partner Order API verwerkt dropshiporders en voorraadaanvragen via beveiligde, ondertekende HTTPS-verzoeken. Elke order wordt gevalideerd, geprijsd op basis van de gekoppelde catalogus en doorgezet naar het fulfilmentproces van Apex.

Endpoints

POST /v1/partner-orders
POST /v1/stock
GET  /v1/catalog

Je ontvangt de basis-URL en inloggegevens tijdens de onboarding.

Authenticatie

Elk verzoek bevat drie headers:

signingString = timestamp + "." + rawBody
signature     = hex( HMAC_SHA256( secret, signingString ) )

• Onderteken exact de onbewerkte request body die je verstuurt. Serialiseer de body niet opnieuw na het ondertekenen.
• De timestamp maakt deel uit van de ondertekende string.
• Verzoeken moeten binnen 5 minuten na de timestamp bij ons binnenkomen.

Request body van de order

{
  "partner_code": "your_partner_code",
  "external_order_number": "YOUR-ORDER-123",
  "order_date": "2026-07-27T10:15:00Z",
  "line_items": [
    { "sku": "APEX-SKU", "quantity": 2, "product_ref": "your-ref" }
  ],
  "delivery_address": {
    "first_name": "Jan",
    "last_name": "Jansen",
    "company": "Example B.V.",
    "street": "Voorbeeldstraat",
    "house_number": "12",
    "postal_code": "1011 AB",
    "city": "Amsterdam",
    "country": "NL",
    "email": "jan@example.com",
    "phone": "+31612345678"
  },
  "requested_delivery_date": "2026-08-05",
  "delivery_instructions": "Twee keer aanbellen"
}

Velden

Verzendkosten worden automatisch toegepast op basis van het land van bestemming. Je stuurt geen prijzen of verzendkosten mee; beide worden bepaald vanuit de partnerconfiguratie in Apex.

Leverdatumregels

Als je requested_delivery_date meestuurt, moet deze aan de volgende regels voldoen:

• Minimale doorlooptijd van 2 werkdagen vanaf de orderdatum.
• Cut-offtijd om 12:00 uur (Europe/Amsterdam). Orders die na 12:00 uur worden geplaatst, hebben een extra werkdag nodig.
• Weekenden zijn geen geldige leverdagen.
• Nationale feestdagen zijn geen geldige leverdagen.

Een datum die niet aan deze regels voldoet, wordt geweigerd met INVALID_DELIVERY_DATE. Laat het veld leeg om de eerst mogelijke geldige leverdatum te gebruiken.

Antwoorden

Bescherming tegen dubbele orders

Orders worden ontdubbeld op basis van external_order_number. Stuur je dezelfde order opnieuw, dan krijg je de originele order terug met 409. Opnieuw proberen na een time-out is dus veilig.

Voorraad

{ "skus": ["APEX-SKU-1", "APEX-SKU-2"] }

Geeft per SKU een eenvoudige in_stock true/false terug. Er worden geen aantallen gedeeld.

Catalogus

GET /v1/catalog geeft de producten terug die beschikbaar zijn in de catalogus die aan jouw partneraccount is gekoppeld. Ondertekend op dezelfde manier als andere verzoeken, met een lege body.

GET /v1/catalog?cursor=OPTIONELE_CURSOR

Resultaten worden gepagineerd, 50 producten per pagina:

{
  "products": [ ... ],
  "pagination": { "has_next_page": true, "next_cursor": "..." }
}

Geef next_cursor terug als de cursor query-parameter om de volgende pagina op te halen. Wanneer has_next_page op false staat, heb je het einde bereikt.