# Create Adjustment by Updating Inventory

Create an inventory adjustment by setting available quantities.

Requires one of the following roles: "ADD" in the "Adjustment" module or "EDIT" in the "Global" module.

Products with type "Composite" and "Non Inventory" cannot be adjusted.

When the InventoryAdjustment Approval config is enabled, newly created adjustments will be assigned StateID 1 (Draft) or StateID 2 (Pending).

Endpoint: POST /api/v3/Adjustment/Set
Version: 3.1.0
Security: OAuth2_clientCredentials

## Header parameters:

  - `CreateWhenQuantityMatch` (boolean)
    when true, even though the quantity submitted matches an inventory
adjustment will be created (200 returned) when false no adjustment is
created (202 returned)
    Enum: false, true

  - `Auto-Approve` (boolean)
    when true, the adjustment will be Accepted when false the
adjustment will be created based on value in State
    Enum: false, true

## Request fields (application/json):

  - `Outlet` (string, required)
    The name of the outlet that made the adjustment

  - `Date` (string, required)
    Date of adjusment.(yyyy/mm/dd)

  - `Number` (string, required)
    Number of invoice adjusment. This is primary key for the object

  - `StateID` (number)
    State of Adjustment. it will be required if config with Approval is turned on. 1= Draft, 2= Pending

  - `State` (string)
    State of Adjustment. it will be required if config with Approval is turned on.
    Enum: "Draft", "Pending", "Accepted", "Rejected"

  - `PIC` (string)
    The name of the PIC that made the adjustment

  - `Note` (string)
    Note of adjustment

  - `CategoryID` (string)
    The unique-identifier of the Category in the form of GUID. When specified if any of the variants submitted is not in the category Bad Request will be returned
    Example: "3fa85f64-5717-4562-b3fc-2c963f66afa6"

  - `CategoryName` (string)
    Category Name of variant. When specified if any of the variants submitted is not in the category Bad Request will be returned

  - `ExpectedMethod` (string)
    Data source of adjustment. None = data not shown, Counted = Counted by user, All = All variants can be adjusted
    Enum: "None", "Counted", "All"

  - `CountMethod` (string)
    Source of adjustment creation
    Enum: "web", "csv", "barcode", "rfid"

  - `Variants` (array, required)

  - `Variants.Code` (string, required)
    Code of variant

  - `Variants.Quantity` (number, required)
    Variant's adjusted quantity

  - `Variants.Note` (string)
    Note of variant adjustment

  - `Variants.TID` (array)
    Tag ID for RFID (This property is used only for product Standard type and adjustment type Count)

  - `Variants.Serial` (array)
    Use this property only for product type Serialized

  - `Variants.Serial.Number` (string, required)
    Serial Number

  - `Variants.Serial.Quantity` (integer, required)
    Quantity of Serial Number specified

## Response 200 fields (application/json):

  - `ID` (string)
    Inventory Adjustment created successfully

## Response 202 fields (application/json):

  - `Message` (string)
    Example: "Adjustment number 2020.07.0002 created, no product inventory changed!"

  - `ID` (string)
    Example: "ac614f2b-db57-4244-a082-114f5f04b9d4"

## Response 400 fields (application/json):

  - `Message` (string)

## Response 500 fields (application/json):

  - `Message` (string)

  - `ExceptionMessage` (string)

  - `ExceptionType` (string)

  - `StackTrace` (string)