Create quantity - ARUKZ ERP Docs

POST

/

admin

/

api

/

v1

/

inventories

/

quantities

Create quantity

curl --request POST \
  --url https://erp.arukz.com/admin/api/v1/inventories/quantities \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "location_id": 1,
  "product_id": 1,
  "counted_quantity": 25
}
'

import requests

url = "https://erp.arukz.com/admin/api/v1/inventories/quantities"

payload = {
    "location_id": 1,
    "product_id": 1,
    "counted_quantity": 25
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({location_id: 1, product_id: 1, counted_quantity: 25})
};

fetch('https://erp.arukz.com/admin/api/v1/inventories/quantities', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://erp.arukz.com/admin/api/v1/inventories/quantities",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'location_id' => 1,
    'product_id' => 1,
    'counted_quantity' => 25
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

{
  "data": {
    "id": 1,
    "quantity": -100,
    "reserved_quantity": 0,
    "counted_quantity": 0,
    "difference_quantity": 0,
    "inventory_diff_quantity": 100,
    "available_quantity": -100,
    "inventory_quantity_set": false,
    "scheduled_at": "2025-12-31T00:00:00.000000Z",
    "incoming_at": "2025-04-10T12:36:39.000000Z",
    "created_at": "2025-04-10T12:36:39.000000Z",
    "updated_at": "2025-04-10T12:36:39.000000Z"
  },
  "message": "Quantity created successfully."
}

{
  "message": "Unauthenticated."
}

{
  "message": "The given data was invalid.",
  "errors": {
    "location_id": [
      "The location id field is required."
    ]
  }
}

Authorizations

Authorization

string

header

required

An API token from Sign in, sent as Authorization: Bearer <token>. Tokens last 30 days.

Body

application/json

location_id

integer

required

Inventory location ID. The id of an existing record in the inventories_locations table.

Example:

1

product_id

integer

required

Product ID. Configurable products are not allowed; pass a variant product ID instead. The id of an existing record in the products_products table.

Example:

1

counted_quantity

number

required

Counted quantity entered during inventory adjustment. For serial-tracked products, this must be 0 or 1. Must be at least 0. Must not be greater than 99999999999.

Example:

25

storage_category_id

integer | null

Storage category ID. The id of an existing record in the inventories_storage_categories table.

Example:

1

lot_id

integer | null

Lot ID. Required for lot/serial tracked products and must belong to the selected product. The id of an existing record in the inventories_lots table.

Example:

1

package_id

integer | null

Package ID. Must belong to the selected location. The id of an existing record in the inventories_packages table.

Example:

1

partner_id

integer | null

Owner partner ID. The id of an existing record in the partners_partners table.

Example:

1

user_id

integer | null

Responsible user ID. The id of an existing record in the users table.

Example:

1

company_id

integer | null

Company ID. The id of an existing record in the companies table.

Example:

1

scheduled_at

string | null

Scheduled inventory date. Must be a valid date.

Example:

"2026-02-25"

Response

Created

⌘I

Create quantity

curl --request POST \
  --url https://erp.arukz.com/admin/api/v1/inventories/quantities \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "location_id": 1,
  "product_id": 1,
  "counted_quantity": 25
}
'

import requests

url = "https://erp.arukz.com/admin/api/v1/inventories/quantities"

payload = {
    "location_id": 1,
    "product_id": 1,
    "counted_quantity": 25
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({location_id: 1, product_id: 1, counted_quantity: 25})
};

fetch('https://erp.arukz.com/admin/api/v1/inventories/quantities', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://erp.arukz.com/admin/api/v1/inventories/quantities",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'location_id' => 1,
    'product_id' => 1,
    'counted_quantity' => 25
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

{
  "data": {
    "id": 1,
    "quantity": -100,
    "reserved_quantity": 0,
    "counted_quantity": 0,
    "difference_quantity": 0,
    "inventory_diff_quantity": 100,
    "available_quantity": -100,
    "inventory_quantity_set": false,
    "scheduled_at": "2025-12-31T00:00:00.000000Z",
    "incoming_at": "2025-04-10T12:36:39.000000Z",
    "created_at": "2025-04-10T12:36:39.000000Z",
    "updated_at": "2025-04-10T12:36:39.000000Z"
  },
  "message": "Quantity created successfully."
}

{
  "message": "Unauthenticated."
}

{
  "message": "The given data was invalid.",
  "errors": {
    "location_id": [
      "The location id field is required."
    ]
  }
}