Update Stock Movement - Plugixa Inventory

PUT /plugixa-inventory/v1/stock-movements/{id}

Change a draft stock movement, or replace its lines. PATCH does the same.

The user needs the plugixa_inventory_edit capability (administrators have every inventory capability). With Pro Roles and permissions enforcing, their role must also allow editing this stock movement.

Note. Only the fields you send change, but lines is all or nothing: sending it deletes the existing lines and writes the new list.

A finalized document is frozen. Only reference, details and assigned_user_id can still change. Anything else, including the lines, is refused with 409: post a reversing document instead.

Changing movement_type on a draft that has lines needs new lines in the same request, since the old ones were picked for the old type.

Request

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

Path parameters

Request body

Content type: application/json

Lines take the same fields as in Create Stock Movement.

{
  "lines": [
    {
      "item_id": 42,
      "quantity": 120,
      "cost_per_unit": 4.2,
      "notes": "Delivery note 4471"
    },
    {
      "item_id": 43,
      "quantity": 6,
      "cost_per_unit": 18
    }
  ],
  "modified_at": "2026-11-12 09:30:00"
}

Responses

200 OK. data is the stock movement 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": 2,
    "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 10:15:00",
    "deleted_at": null,
    "lines": [
      {
        "id": 211,
        "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 10:15:00",
        "modified_at": "2026-11-12 10:15:00",
        "deleted_at": null,
        "item_name": "Printer paper A4",
        "item_sku": "PAP-A4",
        "item_type": "consumable",
        "unit_code": null
      },
      {
        "id": 212,
        "movement_id": 57,
        "item_id": 43,
        "unit_id": null,
        "quantity": 6.0,
        "weight": 0.0,
        "weight_unit": "",
        "weight_base": 0.0,
        "cost_per_unit": 18.0,
        "total_cost": 0.0,
        "transaction_id": 0,
        "notes": "",
        "position": 2,
        "created_by": "1",
        "modified_by": "1",
        "created_at": "2026-11-12 10:15:00",
        "modified_at": "2026-11-12 10:15:00",
        "deleted_at": null,
        "item_name": "Toner cartridge",
        "item_sku": "TON-HP26",
        "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 PUT "https://your-site.example/wp-json/plugixa-inventory/v1/stock-movements/57" \
  -u "admin:$WP_APP_PASSWORD" \
  -H "Content-Type: application/json" \
  -d '{"lines":[{"item_id":42,"quantity":120,"cost_per_unit":4.2,"notes":"Delivery note 4471"},{"item_id":43,"quantity":6,"cost_per_unit":18}],"modified_at":"2026-11-12 09:30:00"}'

<?php
$ch = curl_init('https://your-site.example/wp-json/plugixa-inventory/v1/stock-movements/57');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST  => 'PUT',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_USERPWD        => 'admin:' . getenv('WP_APP_PASSWORD'),
    CURLOPT_HTTPHEADER     => ['Content-Type: application/json'],
    CURLOPT_POSTFIELDS     => json_encode([
        'lines'       => [
            [
                'item_id'       => 42,
                'quantity'      => 120,
                'cost_per_unit' => 4.2,
                'notes'         => 'Delivery note 4471',
            ],
            [
                'item_id'       => 43,
                'quantity'      => 6,
                'cost_per_unit' => 18,
            ],
        ],
        'modified_at' => '2026-11-12 09:30:00',
    ]),
]);
$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/57', {
  method: 'PUT',
  headers: { 'Authorization': auth, 'Content-Type': 'application/json' },
  body: JSON.stringify({
    lines: [
      {
        item_id: 42,
        quantity: 120,
        cost_per_unit: 4.2,
        notes: 'Delivery note 4471',
      },
      {
        item_id: 43,
        quantity: 6,
        cost_per_unit: 18,
      },
    ],
    modified_at: '2026-11-12 09:30:00',
  }),
});
const { data } = await response.json();