Skip to content
Fulfilment
/
/
Adjust Stock

Adjust Stock

Request

Applies a manual correction to one bucket of one SKU. quantity_change is a delta, positive or negative, not a new total, and the change is recorded as an inventory movement.

Use it to write off damage found after receipt, to correct a count, or to move stock to QC hold. Do not use it to load opening stock: stock arrives through an inbound. The SKU must already have an inventory record, and a change that would take a bucket below zero is rejected.

Security
BearerAuth or OAuth2
Bodyapplication/json
bucketstringrequired

The bucket to adjust: available, damaged, reserved or qc_hold. Required.

Enum:"available""damaged""reserved""qc_hold"
notesstring

Free-text notes about the adjustment. Optional.

quantity_changeinteger, (int64)required

The change to apply, positive to add and negative to remove. Not a new total. Required, not 0.

reasonstringrequired

Why: damage, correction, write_off, qc_fail or other. Required.

Enum:"damage""correction""write_off""qc_fail""other"
skustringrequired

The SKU to adjust. Required.

curl -i -X POST \
  https://platform-api.quiqup.com/api/fulfilment/inventory/adjustments \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "bucket": "damaged",
    "notes": "Three units destroyed after inspection",
    "quantity_change": -3,
    "reason": "write_off",
    "sku": "TSHIRT-BLK-M"
  }'

Responses

Success response

Bodyapplication/json
availableinteger, (int64)required

Available quantity after the adjustment.

damagedinteger, (int64)required

Damaged quantity after the adjustment.

qc_holdinteger, (int64)required

Quantity on QC hold after the adjustment.

reservedinteger, (int64)required

Reserved quantity after the adjustment.

skustringrequired

The SKU.

totalinteger, (int64)required

Sum of the four buckets after the adjustment.

Response
{
  "available": 180,
  "damaged": 2,
  "qc_hold": 0,
  "reserved": 10,
  "sku": "TSHIRT-BLK-M",
  "total": 192
}