Contents
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