Create Product Local Inventory

POST 
/products/:lookupkey/:key/inventory/local

This endpoint allows creating local inventory data for a product based on a lookup key.

Available fields

Name	Required
quantity (integer)	yes
warehouseId (integer)	no Default value is 0
company (InventoryCompanyUsergroupResource)	no
usergroup (InventoryCompanyUsergroupResource)	no
location (string)	no Default value is empty
costPrice (integer)	no Default value is product costprice
nextDeliveryDate (date)	no
notes (string)	no

dateModified is always updated with the current date and time.

On creating a record, inventory type local is matching the product on the lookup key. If the product is found, inventory record will be created.

If an inventory record is found, matching on: sku, warehouseId and location, error is thrown that duplicate record can't be created.

Request

Path Parameters

lookupkey stringrequired

Available lookup keys: id, sourceId, sku, supplierCode

key stringrequired

Lookup key value

application/json

Body

costPrice number
location string
nextDeliveryDate string
notes string
quantity number

usergroup

object

id number

Responses

201

Create Product Local Inventory - 201 / Create Product Local Inventory for a usergroup - 200

Response Headers

• Connection

  string

• Content-Length

  string

• Date

  string

• Keep-Alive

  string

• Return-Format

  string

application/json

Schema

Schema

data

object

companyId number

costPrice number

dateModified string

id number

location string

nextDeliveryDate string

notes string

productId number

quantity number

sku string

supplier string

supplierCode string

usergroupId number

warehouseId number
messages string[]
total number

Example (from schema)

{
  "data": {
    "companyId": 0,
    "costPrice": 11.31,
    "dateModified": "2022-03-11T11:04:29",
    "id": 16194,
    "location": "L5",
    "nextDeliveryDate": "2022-02-20T00:00:00",
    "notes": "",
    "productId": 38952,
    "quantity": 16,
    "sku": "AA 0635613",
    "supplier": "INTERN",
    "supplierCode": "AA 0635613",
    "usergroupId": 0,
    "warehouseId": 4
  },
  "messages": [
    "Inventory created"
  ],
  "total": 1
}

Create Product Local Inventory - 201

{
  "data": {
    "companyId": 0,
    "costPrice": 11.31,
    "dateModified": "2022-03-11T11:04:29",
    "id": 16194,
    "location": "L5",
    "nextDeliveryDate": "2022-02-20T00:00:00",
    "notes": "",
    "productId": 38952,
    "quantity": 16,
    "sku": "AA 0635613",
    "supplier": "INTERN",
    "supplierCode": "AA 0635613",
    "usergroupId": 0,
    "warehouseId": 4
  },
  "messages": [
    "Inventory created"
  ],
  "total": 1
}

Create Product Local Inventory for a usergroup - 200

{
  "data": {
    "companyId": 0,
    "costPrice": 11.31,
    "dateModified": "2023-10-02T15:08:39",
    "id": 16148,
    "location": "L5",
    "nextDeliveryDate": "2022-02-20T00:00:00",
    "notes": "",
    "productId": 227235,
    "quantity": 16,
    "sku": "9789006953374",
    "supplier": "INTERN",
    "supplierCode": "",
    "usergroupId": 143,
    "warehouseId": 0
  },
  "messages": [
    "Inventory created"
  ],
  "total": 1
}

400

Create Product Local Inventory - 400

Response Headers

• Alt-Svc

  string

• Via

  string

• alt-svc

  string

• content-length

  string

• date

  string

• return-format

  string

• server

  string

• x-request-id

  string

application/json

Schema

Schema

error

object

code number

messages string[]

moreInfo string

status number

type string

Example (from schema)

{
  "error": {
    "code": 13004,
    "messages": [
      "Inventory already exists"
    ],
    "moreInfo": "https://www.propel.us/docs/errors/13004",
    "status": 400,
    "type": "InventoryExists"
  }
}

Create Product Local Inventory - 400

{
  "error": {
    "code": 13004,
    "messages": [
      "Inventory already exists"
    ],
    "moreInfo": "https://www.propel.us/docs/errors/13004",
    "status": 400,
    "type": "InventoryExists"
  }
}

404

Create Product Local Inventory - 404

Response Headers

• Alt-Svc

  string

• Via

  string

• alt-svc

  string

• content-length

  string

• date

  string

• return-format

  string

• server

  string

• x-request-id

  string

application/json

Schema

Schema

error

object

code number

messages string[]

moreInfo string

status number

type string

Example (from schema)

{
  "error": {
    "code": 80006,
    "messages": [
      "Product with id [98952] not found"
    ],
    "moreInfo": "https://www.propel.us/docs/errors/80006",
    "status": 404,
    "type": "ProductNotFound"
  }
}

Create Product Local Inventory - 404

{
  "error": {
    "code": 80006,
    "messages": [
      "Product with id [98952] not found"
    ],
    "moreInfo": "https://www.propel.us/docs/errors/80006",
    "status": 404,
    "type": "ProductNotFound"
  }
}

Loading...