> ## Documentation Index
> Fetch the complete documentation index at: https://docs.erp.arukz.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Create quantity

> Create a new product quantity count



## OpenAPI

````yaml /api-reference/openapi.json post /admin/api/v1/inventories/quantities
openapi: 3.0.3
info:
  title: ARUKZ ERP API
  version: v1
  description: >-
    The REST API of ARUKZ ERP: sales, purchases, inventory, products, partners,
    accounts, projects and reference data. Every call acts as the user whose
    token it carries and sees only that user's company.
servers:
  - url: https://erp.arukz.com
    description: ARUKZ ERP (hosted)
security:
  - bearerAuth: []
tags:
  - name: Authentication
    description: Sign in for a token and sign out.
  - name: Sales
    description: Quotations, sales orders and their lines, deliveries and invoices.
  - name: Purchases
    description: Purchase orders, receipts, bills, agreements and vendor price lists.
  - name: Inventory
    description: >-
      Warehouses, locations, lots, stock quantities, receipts, deliveries,
      transfers and scrap.
  - name: Products
    description: 'The product catalogue: categories, attributes, variants and packaging.'
  - name: Partners
    description: Customers, vendors, contacts, addresses and bank accounts.
  - name: Accounts
    description: >-
      Invoices, bills, credit notes, refunds, taxes, journals and the chart of
      accounts.
  - name: Projects
    description: Projects, tasks, stages and milestones.
  - name: Reference data
    description: Currencies and rates, banks, countries, states and units of measure.
paths:
  /admin/api/v1/inventories/quantities:
    post:
      tags:
        - Inventory
      summary: Create quantity
      description: Create a new product quantity count
      operationId: inventory-quantities-create-quantity
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                location_id:
                  type: integer
                  description: >-
                    Inventory location ID. The `id` of an existing record in the
                    inventories_locations table.
                  example: 1
                product_id:
                  type: integer
                  description: >-
                    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
                storage_category_id:
                  type: integer
                  description: >-
                    Storage category ID. The `id` of an existing record in the
                    inventories_storage_categories table.
                  nullable: true
                  example: 1
                lot_id:
                  type: integer
                  description: >-
                    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.
                  nullable: true
                  example: 1
                package_id:
                  type: integer
                  description: >-
                    Package ID. Must belong to the selected location. The `id`
                    of an existing record in the inventories_packages table.
                  nullable: true
                  example: 1
                partner_id:
                  type: integer
                  description: >-
                    Owner partner ID. The `id` of an existing record in the
                    partners_partners table.
                  nullable: true
                  example: 1
                user_id:
                  type: integer
                  description: >-
                    Responsible user ID. The `id` of an existing record in the
                    users table.
                  nullable: true
                  example: 1
                company_id:
                  type: integer
                  description: >-
                    Company ID. The `id` of an existing record in the companies
                    table.
                  nullable: true
                  example: 1
                counted_quantity:
                  type: number
                  description: >-
                    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
                scheduled_at:
                  type: string
                  description: Scheduled inventory date. Must be a valid date.
                  nullable: true
                  example: '2026-02-25'
              required:
                - counted_quantity
                - location_id
                - product_id
      responses:
        '201':
          description: Created
          content:
            application/json:
              example:
                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.
        '401':
          description: Unauthenticated
          content:
            application/json:
              example:
                message: Unauthenticated.
        '422':
          description: Validation error
          content:
            application/json:
              example:
                message: The given data was invalid.
                errors:
                  location_id:
                    - The location id field is required.
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        An API token from [Sign in](/api-reference/authentication), sent as
        `Authorization: Bearer <token>`. Tokens last 30 days.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.