BizKitHub
DocsAPI ReferenceWarehouse/bff/warehouse/reservation/create
postWarehouseAdmin BFF

/bff/warehouse/reservation/create

Reserve stock (Tier 1 #1)

WarehousepostBffWarehouseReservationCreate

Parameters

JSON body

Request body

application/json
warehouseIdnumberRequired
locationIdnumber | nullOptional
One of 2:
Variant 1
number
Variant 2
null
productCodestring | nullOptional

Human-readable product code (mutually exclusive with virtualItemSku).

One of 2:
Variant 1
string
Length: 064
Variant 2
null
productVariantCodestring | nullOptional

Variant code, requires productCode.

One of 2:
Variant 1
string
Length: 064
Variant 2
null
virtualItemSkustring | nullOptional

Free-form virtual SKU for non-catalogue items.

One of 2:
Variant 1
string
Length: 0100
Variant 2
null
quantitynumberRequired
Range: 1
mode"soft" | "hard"Optional
orderIdnumber | nullOptional
One of 2:
Variant 1
number
Variant 2
null
orderItemIdnumber | nullOptional
One of 2:
Variant 1
number
Variant 2
null
externalKeystring | nullOptional
One of 2:
Variant 1
string
Length: 0120
Variant 2
null
expiresAtstring | nullOptional
One of 2:
Variant 1
string

ISO datetime; required for soft reservations to be auto-released.

Variant 2
null
idempotencyKeystring | nullOptional
One of 2:
Variant 1
string
Length: 080
Variant 2
null
notestring | nullOptional
One of 2:
Variant 1
string
Variant 2
null
performedByMemberIdnumber | nullOptional
One of 2:
Variant 1
number
Variant 2
null

Response schema

1 status code documented

200Success
successbooleanRequired
reservationIdnumberRequired
movementIdnumberRequired
newQuantitynumberRequired
newReservednumberRequired
availablenumberRequired
dedupedbooleanRequired

Response example

application/json
{
  "success": false,
  "reservationId": 0,
  "movementId": 0,
  "newQuantity": 0,
  "newReserved": 0,
  "available": 0,
  "deduped": false
}

Request example

POST /bff/warehouse/reservation/create

post
curl -X POST "https://api.bizkithub.com/bff/warehouse/reservation/create" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
  "warehouseId": 0,
  "quantity": 0
}'

Need an API key?

All BizKitHub public API endpoints require authentication via API key.

Get API Key