Contents
On this page

List Stock Adjustments - Plugixa POS for WooCommerce

GET /plugixa-pos/v1/stock-adjustments

Stock corrections, newest first, with a summary per reason for the same filters.

Needs a user with the plugixa_pos_manage_settings capability (signed in with an Application Password, or the login cookie with an X-WP-Nonce header). Administrators hold it; other roles only when you grant it.

Request

GET https://your-site.example/wp-json/plugixa-pos/v1/stock-adjustments?reason=damaged&per_page=1

Query parameters

Field Type Required Description
product_id integer No One product.
outlet_id integer No One store.
reason string No One of count, damaged, expired, theft, lost, internal_use, found, received or other.
from string No From this date, YYYY-MM-DD.
to string No To this date.
page integer No Page to return, from 1. Defaults to 1.
per_page integer No Rows per page, 1 to 200. Defaults to 50.

Responses

200 OK.

{
  "success": true,
  "data": [
    {
      "id": 1,
      "product_id": 3753,
      "product": "Soy candle Fig",
      "sku": "HOM-CNDL-FIG",
      "outlet_id": 1,
      "delta": -2,
      "quantity_before": 14,
      "quantity_after": 12,
      "reason": "damaged",
      "note": "Dropped in the stockroom",
      "unit_cost": "8.5000",
      "value": "-17.00",
      "user": "admin",
      "created_at": "2026-11-18T16:30:38+00:00"
    }
  ],
  "meta": {
    "total": 1,
    "pages": 1,
    "summary": {
      "damaged": {
        "count": 1,
        "units": -2,
        "value": "-17.00"
      }
    },
    "outlets": {
      "1": "Maison Plugixa Marais",
      "2": "Maison Plugixa Lyon"
    }
  }
}
Field Type Meaning
data[].delta integer Units added (positive) or removed
data[].value string delta times the cost price
meta.summary object Per reason: count, units, value
meta.outlets object Store names by id

Errors

This endpoint has no errors of its own.

Plus the errors every endpoint can return.

Examples

curl -s "https://your-site.example/wp-json/plugixa-pos/v1/stock-adjustments?reason=damaged&per_page=1" \
  -u "$WP_USER:$WP_APP_PASSWORD"
<?php
$ch = curl_init('https://your-site.example/wp-json/plugixa-pos/v1/stock-adjustments?reason=damaged&per_page=1');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_USERPWD        => getenv('WP_USER') . ':' . getenv('WP_APP_PASSWORD'),
]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);
const response = await fetch('https://your-site.example/wp-json/plugixa-pos/v1/stock-adjustments?reason=damaged&per_page=1', {
  headers: {
    'Authorization': `Basic ${btoa(`${process.env.WP_USER}:${process.env.WP_APP_PASSWORD}`)}`,
  },
});
const { data } = await response.json();

Quick Links

Share