Create Stock Hub quote for a set of product items

POST /V1/stock-hub/quotes/request

Create Stock Hub quote for a set of product items. Note: The billing address must specify the address of the person/entity that completes the payment to Winkelstraat.nl. For direct payments from 3rd party customers to Winkelstraat.nl, we need to specify the address of the 3rd party customer. For indirect payments from 3rd party customers to Winkestraat.nl, we need so specify the intermediate party that executes the payment. The shipping address must specify the address to which the quoted items need to be shipped. The correct address are required for fraud detection when conducted by Winkelstraat.nl's payment service provider.

Body

  • items array[object] Required
    Hide items attributes Show items attributes object
    • qty integer Required

      Number of quote items

    • sku string Required

      SKU

  • billingAddress object Required
    Hide billingAddress attributes Show billingAddress attributes object
    • first_name string

      Firstname

    • company_name string

      Company name

    • last_name string

      Lastname

    • email string

      Email

    • telephone string

      Telephone. Needs to be in international format +XXXXXXXXXXX.

    • street string

      Street. Needs to be "street name" and "house number"

    • house_number string Required

      House number with addition.

    • postcode string

      Postcode

    • city string

      City

    • region_code string

      Region code

    • country_id string

      Country id. Needs to a ALPHA-2 ISO 3166 country code.

  • shippingAddress object Required
    Hide shippingAddress attributes Show shippingAddress attributes object
    • first_name string

      Firstname

    • company_name string

      Company name

    • last_name string

      Lastname

    • email string

      Email

    • telephone string

      Telephone. Needs to be in international format +XXXXXXXXXXX.

    • street string

      Street. Needs to be "street name" and "house number"

    • house_number string Required

      House number with addition.

    • postcode string

      Postcode

    • city string

      City

    • region_code string

      Region code

    • country_id string

      Country id. Needs to a ALPHA-2 ISO 3166 country code.

  • payment object Required
    Hide payment attributes Show payment attributes object
    • method string

      Payment method

    • po_number string

      Purchase order number

Responses

  • 200

    200 Success.

  • 401

    401 Unauthorized

    Hide response attributes Show response attributes object
    • message string Required

      Error message

    • errors array[object]

      Error details

      Error details

      Hide errors attributes Show errors attributes object
      • message string

        Error message

      • parameters array[object]

        Error parameters item

        Error parameters item

        Hide parameters attributes Show parameters attributes object
        • resources string

          ACL resource

        • fieldName string

          Missing or invalid field name

        • fieldValue string

          Incorrect field value

    • code integer

      Error code

    • parameters array[object]

      Error parameters item

      Error parameters item

      Hide parameters attributes Show parameters attributes object
      • resources string

        ACL resource

      • fieldName string

        Missing or invalid field name

      • fieldValue string

        Incorrect field value

    • trace string

      Stack trace

  • default

    Unexpected error

    Hide response attributes Show response attributes object
    • message string Required

      Error message

    • errors array[object]

      Error details

      Error details

      Hide errors attributes Show errors attributes object
      • message string

        Error message

      • parameters array[object]

        Error parameters item

        Error parameters item

        Hide parameters attributes Show parameters attributes object
        • resources string

          ACL resource

        • fieldName string

          Missing or invalid field name

        • fieldValue string

          Incorrect field value

    • code integer

      Error code

    • parameters array[object]

      Error parameters item

      Error parameters item

      Hide parameters attributes Show parameters attributes object
      • resources string

        ACL resource

      • fieldName string

        Missing or invalid field name

      • fieldValue string

        Incorrect field value

    • trace string

      Stack trace

POST /V1/stock-hub/quotes/request
curl \
 --request POST 'https://magento2.winkelstraat.mac/rest/all/V1/stock-hub/quotes/request' \
 --data '{"items":[{"qty":42,"sku":"string"}],"billingAddress":{"first_name":"string","company_name":"string","last_name":"string","email":"string","telephone":"string","street":"string","house_number":"string","postcode":"string","city":"string","region_code":"string","country_id":"string"},"shippingAddress":{"first_name":"string","company_name":"string","last_name":"string","email":"string","telephone":"string","street":"string","house_number":"string","postcode":"string","city":"string","region_code":"string","country_id":"string"},"payment":{"method":"string","po_number":"string"}}'
Request examples
{
  "items": [
    {
      "qty": 42,
      "sku": "string"
    }
  ],
  "billingAddress": {
    "first_name": "string",
    "company_name": "string",
    "last_name": "string",
    "email": "string",
    "telephone": "string",
    "street": "string",
    "house_number": "string",
    "postcode": "string",
    "city": "string",
    "region_code": "string",
    "country_id": "string"
  },
  "shippingAddress": {
    "first_name": "string",
    "company_name": "string",
    "last_name": "string",
    "email": "string",
    "telephone": "string",
    "street": "string",
    "house_number": "string",
    "postcode": "string",
    "city": "string",
    "region_code": "string",
    "country_id": "string"
  },
  "payment": {
    "method": "string",
    "po_number": "string"
  }
}
Response examples (200)
42
Response examples (401)
{
  "message": "string",
  "errors": [
    {
      "message": "string",
      "parameters": [
        {
          "resources": "string",
          "fieldName": "string",
          "fieldValue": "string"
        }
      ]
    }
  ],
  "code": 42,
  "parameters": [
    {
      "resources": "string",
      "fieldName": "string",
      "fieldValue": "string"
    }
  ],
  "trace": "string"
}
Response examples (default)
{
  "message": "string",
  "errors": [
    {
      "message": "string",
      "parameters": [
        {
          "resources": "string",
          "fieldName": "string",
          "fieldValue": "string"
        }
      ]
    }
  ],
  "code": 42,
  "parameters": [
    {
      "resources": "string",
      "fieldName": "string",
      "fieldValue": "string"
    }
  ],
  "trace": "string"
}