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

The rma 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
  • order_increment_id string
  • date_requested string(date-time)
  • items array[object]
    Hide items attributes Show items attributes object
    • id integer
    • resolution string
    • reason string | null
    • qty_requested integer
    • qty_approved integer | null
    • qty_returned integer | null
    • manufacturer string | null
    • color string | null
    • size string | null
    • mpn string | null
    • merchant_product_reference string | null
    • merchant_resolution string | null
    • sku string
    • parent_sku string | null
    • item_return_fee number(float)
    • row_line_return_fee number(float)
    • status string

      Status of an RMA item. Value is either one of the following: 'pending', 'authorized', 'partially_authorized', 'received', 'received_on_item', 'approved', 'approved_on_item', 'rejected', 'rejected_on_item','denied', 'closed', 'processed_closed'

  • status string
  • track object | null
    Hide track attributes Show track attributes object | null
    • tracking_number string
    • carrier string
    • method string | null
    • tracking_url string | null
  • date_received string | null
  • date_processed string | null
  • currency 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 RMA to the order of the purchasing company.

Responses

  • 200

    Ok

  • 202

    Accepted

  • 406

    Not accepted

POST winkelstraat/stock-hub/v1/rma
Request example 
{
  "items": [
    {
      "id": 90,
      "mpn": "3G1MXE1MXVZF982",
      "sku": "wsnl199-5c9de5ad4681ed3eb551e7ee",
      "size": "S",
      "color": "Blauw",
      "reason": "no_reason",
      "status": "authorized",
      "parent_sku": "381189",
      "resolution": "refund",
      "manufacturer": "Emporio Armani",
      "qty_approved": null,
      "qty_returned": null,
      "qty_requested": 1,
      "item_return_fee": 2.95,
      "merchant_resolution": null,
      "row_line_return_fee": 2.95,
      "merchant_product_reference": "3G1MXE1MXVZF982"
    }
  ],
  "track": {
    "method": null,
    "carrier": "ups",
    "tracking_url": "https://wwwapps.ups.com/WebTracking/processInputRequest?loc=nl_NL&tracknum=1Z97W1436800867AAP",
    "tracking_number": "1Z97W143680086AAP"
  },
  "status": "authorized",
  "currency": "EUR",
  "po_number": "YOUR_ORDER_REFERENCE",
  "increment_id": "000000093",
  "date_received": null,
  "date_processed": null,
  "date_requested": "2024-03-08T13:25:19.000+00:00",
  "order_increment_id": "000000549"
}