Stock Hub Webhooks
POST https://reseller.server.com/api/v1/stockhub/invoice

The invoice webhook performs a POST in JSON format to a designated endpoint of the reseller.

Headers

  • x-version string Required

    Version of the webhook.

  • x-api-key string

    The API-key is a shared secret that can be used to authenticate the incomming request.

application/json

Body

  • increment_id string
  • created_at string(date-time)
  • updated_at string(date-time)
  • items array[object]
    Hide items attributes Show items attributes object
    • sku string
    • qty integer
    • item_price_inc_tax number(float)
    • row_total_inc_tax number(float)
    • parent_sku string | null
    • manufacturer string
    • size string
    • mpn string
  • billing_address object
    Hide billing_address attributes Show billing_address attributes object
    • first_name string | null
    • last_name string | null
    • email string
    • telephone string
    • street string
    • houseNumber string
    • postcode string
    • city string
    • region_code string | null
    • country_id string
    • company_name string | null
  • shipping_price number | null
  • grand_total number(float)
  • subtotal number(float)
  • currency string
  • order_increment_id string
  • po_number string

    The PO (Purchase order) number is the reference number to pay for approved purchases. The PO number is used to link the invoice to the order of the purchasing company.

Responses

  • 200

    Ok

  • 202

    Accepted

  • 406

    Not accepted

POST winkelstraat/stock-hub/v1/invoice
Request example 
{
  "items": [
    {
      "mpn": "3G1MXE1MXVZF982",
      "qty": 2,
      "sku": "wsnl199-5c9de5ad4681ed3eb551e7ee",
      "size": "L",
      "parent_sku": "381189",
      "manufacturer": "Emporio Armani",
      "row_total_inc_tax": 540,
      "item_price_inc_tax": 270
    }
  ],
  "currency": "EUR",
  "subtotal": 540,
  "po_number": "YOUR_ORDER_REFERENCE",
  "created_at": "2024-03-11T11:02:27.000+00:00",
  "updated_at": "2024-03-11T11:02:27.000+00:00",
  "grand_total": 545.95,
  "increment_id": "000000277",
  "shipping_price": 5.95,
  "billing_address": {
    "city": "Zonnewijk",
    "email": "jan.jansen@gwinkelstraat.nl",
    "street": "Edsger Dijkstraat",
    "postcode": "9012DE",
    "last_name": "Jansen",
    "telephone": "+31621510775",
    "country_id": "NL",
    "first_name": "Jan",
    "region_code": null,
    "company_name": null,
    "house_number": "12"
  },
  "order_increment_id": "000000568"
}