Skip to content

You are reading version v1.1, which is archived. See the current version

Insufficient stock

When the API answers 409 insufficient_stock, and how to fix it.

Version v1.1, updated

On this page

A stock adjustment takes more than the warehouse holds of the product, in that unit. Stock never goes below zero.

At a glance

  • Status: 409 Conflict

  • Code: insufficient_stock

  • Retry: No. Fix the cause first: the same request gets the same answer.

Causes and fixes

Likely cause

How to fix it

The quantity in BIRP is lower than in your system.

Read the level with GET /v1/stock/levels, then send what the warehouse really lost or used.

The adjustment names the wrong warehouse.

Check the warehouse reference of the body.

Example

409 insufficient_stockJSON
{
  "code": "insufficient_stock",
  "detail": "The warehouse does not hold enough stock of the product in this unit.",
  "errors": [
    {
      "field": "quantity",
      "message": "exceeds the stock of the warehouse in this unit"
    }
  ],
  "instance": "/v1/stock/adjustments",
  "request_id": "a1b2c3d4-0000-4000-8000-0000000000ee",
  "status": 409,
  "title": "Insufficient stock",
  "type": "https://birp.io/developers/errors/insufficient_stock"
}
  • stock-levels
  • warehouses-and-stock
  • errors-overview