Skip to content

Insufficient stock

HTTP 409insufficient_stock

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

Version v1.1, updated

The type field of every insufficient_stock response links to this page.

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"
}

Related

  • stock-levels
  • warehouses-and-stock
  • errors-overview