Create Stock Movement - Plugixa Inventory

POST /plugixa-inventory/v1/stock-movements

Create a draft stock movement: stock in, stock out, or an asset checked in or out.

The user needs the plugixa_inventory_create capability (administrators have every inventory capability). With Pro Roles and permissions enforcing, their role must also allow creating stock movements.

Request

POST https://your-site.example/wp-json/plugixa-inventory/v1/stock-movements

Request body

Content type: application/json

Lines

Lines with neither an item nor a quantity are skipped. Lines are kept in the order sent, numbered from 1 in position. A new document is always a draft: a status you send is ignored. Nothing reaches stock until you finalize it. If a line is refused, nothing is saved.

The type decides which items a line may carry, checked when the document is finalized: check_in and check_out take assets only, add_stock and remove_stock take any type. Movement Types returns the same rules.

{
  "movement_type": "add_stock",
  "warehouse_id": 1,
  "movement_date": "2026-11-12 10:30",
  "lines": [
    {
      "item_id": 42,
      "quantity": 120,
      "cost_per_unit": 4.2,
      "notes": "Delivery note 4471"
    }
  ]
}

Responses

201 Created. data is the new draft with its lines.

{
  "success": true,
  "data": {
    "id": 57,
    "reference": "",
    "movement_type": "add_stock",
    "warehouse_id": 1,
    "recipient_id": null,
    "recipient": "",
    "movement_date": "2026-11-12 10:30:00",
    "status": "draft",
    "finalized_at": null,
    "finalized_by": null,
    "batch_id": "",
    "line_count": 1,
    "total_quantity": 0.0,
    "total_cost": 0.0,
    "details": "",
    "attachments": null,
    "assigned_user_id": null,
    "created_by": 1,
    "modified_by": 1,
    "created_at": "2026-11-12 09:30:00",
    "modified_at": "2026-11-12 09:30:00",
    "deleted_at": null,
    "lines": [
      {
        "id": 210,
        "movement_id": 57,
        "item_id": 42,
        "unit_id": null,
        "quantity": 120.0,
        "weight": 0.0,
        "weight_unit": "",
        "weight_base": 0.0,
        "cost_per_unit": 4.2,
        "total_cost": 0.0,
        "transaction_id": 0,
        "notes": "Delivery note 4471",
        "position": 1,
        "created_by": "1",
        "modified_by": "1",
        "created_at": "2026-11-12 09:30:00",
        "modified_at": "2026-11-12 09:30:00",
        "deleted_at": null,
        "item_name": "Printer paper A4",
        "item_sku": "PAP-A4",
        "item_type": "consumable",
        "unit_code": null
      }
    ],
    "warehouse_name": "Main warehouse",
    "recipient_name": null
  }
}

Errors

Plus the errors every endpoint can return.

Examples

curl -s -X POST "https://your-site.example/wp-json/plugixa-inventory/v1/stock-movements" \
  -u "admin:$WP_APP_PASSWORD" \
  -H "Content-Type: application/json" \
  -d '{"movement_type":"add_stock","warehouse_id":1,"movement_date":"2026-11-12 10:30","lines":[{"item_id":42,"quantity":120,"cost_per_unit":4.2,"notes":"Delivery note 4471"}]}'

<?php
$ch = curl_init('https://your-site.example/wp-json/plugixa-inventory/v1/stock-movements');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST  => 'POST',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_USERPWD        => 'admin:' . getenv('WP_APP_PASSWORD'),
    CURLOPT_HTTPHEADER     => ['Content-Type: application/json'],
    CURLOPT_POSTFIELDS     => json_encode([
        'movement_type' => 'add_stock',
        'warehouse_id'  => 1,
        'movement_date' => '2026-11-12 10:30',
        'lines'         => [
            [
                'item_id'       => 42,
                'quantity'      => 120,
                'cost_per_unit' => 4.2,
                'notes'         => 'Delivery note 4471',
            ],
        ],
    ]),
]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);

const auth = 'Basic ' + btoa(`admin:${process.env.WP_APP_PASSWORD}`);
const response = await fetch('https://your-site.example/wp-json/plugixa-inventory/v1/stock-movements', {
  method: 'POST',
  headers: { 'Authorization': auth, 'Content-Type': 'application/json' },
  body: JSON.stringify({
    movement_type: 'add_stock',
    warehouse_id: 1,
    movement_date: '2026-11-12 10:30',
    lines: [
      {
        item_id: 42,
        quantity: 120,
        cost_per_unit: 4.2,
        notes: 'Delivery note 4471',
      },
    ],
  }),
});
const { data } = await response.json();