# Get Stock Regularization

Get a specific stock regularizations.

Endpoint: GET /api/v1/stock-regularization/{id}
Version: 1.0

## Path parameters:

  - `id` (integer, required)

## Response 200 fields (application/json):

  - `id` (integer, required)
    Unique identifier of the entity
    Example: 1

  - `number` (integer, required)
    Unique serial number of the document header.
    Example: 1001

  - `documentDate` (string, required)
    Date of the document in ISO format (yyyy-MM-dd).
    Example: "2024-08-07"

  - `quantityTotal` (number)
    Total quantity for all document lines.
    Example: 200.5

  - `observations` (string)
    Free text field for any observations related to the document.
    Example: "Customer requested urgent delivery"

  - `lines` (array)
    List of detail lines for the document. For structure see: ApiBaseLineReadDto.java

  - `lines.lineNumber` (integer, required)
    Line number within the document.
    Example: 1

  - `lines.articleCombination` (object, required)
    Article combination info. See ApiArticleCombinationListReadDto.java for the structure.

  - `lines.articleCombination.article` (string)
    Article code
    Example: 123456

  - `lines.articleCombination.articleId` (integer)
    Internal article identifier
    Example: 876

  - `lines.articleCombination.articleType` (string)
    Type of article
    Enum: "PACKAGING", "EXPENSE", "RAW_MATERIAL", "MERCHANDISE", "OTHERS", "FINISHED_PRODUCT", "SEMI_FINISHED", "SERVICE", "ADVERTISING"

  - `lines.articleCombination.unitWarehouseId` (integer)
    Warehouse ID where the item is stored
    Example: 55

  - `lines.articleCombination.articleDescription` (string)
    Description of the article
    Example: "Blue cotton T-shirt"

  - `lines.articleCombination.attribute1` (object)
    First attribute of the article. See ApiAttributeListReadDto

  - `lines.articleCombination.attribute1.code` (string, required)
    Unique code for the attribute.
    Example: "COLOR"

  - `lines.articleCombination.attribute1.description` (string, required)
    Description of the attribute.
    Example: "Color of the item"

  - `lines.articleCombination.attribute2` (object)
    Second attribute of the article. See ApiAttributeListReadDto

  - `lines.articleCombination.attribute3` (object)
    Third attribute of the article. See ApiAttributeListReadDto

  - `lines.articleCombination.attribute4` (object)
    Fourth attribute of the article. See ApiAttributeListReadDto

  - `lines.articleCombination.attribute5` (object)
    Fifth attribute of the article. See ApiAttributeListReadDto

  - `lines.articleCombination.seasonId` (integer)
    Season identifier
    Example: 1

  - `lines.articleCombination.season` (string)
    Season name
    Example: "Summer 2025"

  - `lines.articleCombination.category1` (string)
    First article category
    Example: "Men"

  - `lines.articleCombination.category2` (string)
    Second article category
    Example: "Shirts"

  - `lines.articleCombination.category3` (string)
    Third article category
    Example: "Cotton"

  - `lines.articleCombination.category4` (string)
    Fourth article category
    Example: "Casual"

  - `lines.articleCombination.description` (string)
    Combination description
    Example: "Casual blue T-shirt, 100% cotton"

  - `lines.articleCombination.active` (boolean)
    Indicates if the article is active
    Example: true

  - `lines.articleCombination.articleVatType` (string)
    VAT type for the article
    Enum: "SUPER_REDUCED", "REDUCED", "GENERAL", "EXEMPT"

  - `lines.articleCombination.assortment` (object)
    Assortment information. See ApiAssortmentListReadDto

  - `lines.articleCombination.assortment.code` (string)
    Assortment code.
    Example: "ASRT123"

  - `lines.articleCombination.assortment.title` (string)
    Title of the assortment.
    Example: "Summer Collection"

  - `lines.articleCombination.assortment.sizeRange` (string)

  - `lines.articleCombination.sizeRange` (object)
    Size range information. See ApiSizeRangeListReadDto

  - `lines.articleCombination.sizeRange.code` (string, required)

  - `lines.articleCombination.sizeRange.description` (string, required)

  - `lines.articleCombination.serialNumberControl` (boolean)
    Indicates if serial number control is used

  - `lines.articleCombination.batchControl` (boolean)
    Indicates if batch control is used

  - `lines.attributesDescription` (string)
    Additional attributes description for the line.
    Example: "Color: Red, Size: L"

  - `lines.sizeRange` (object)
    Size range information. See ApiSizeRangeListReadDto.java for the structure.

  - `lines.assortment` (object)
    Assortment information. See ApiAssortmentListReadDto.java for the structure.

  - `lines.articleDescription` (string)
    Description of the article.
    Example: "Cotton T-Shirt"

  - `lines.packages` (integer)
    Number of packages in this line.
    Example: 3

  - `lines.quantityPerPackage` (number)
    Quantity per package for this line.
    Example: 5

  - `lines.quantityLine` (number)
    Total quantity for this line.
    Example: 15

  - `lines.price` (number)
    Unit price for this article line.
    Example: 12.95

  - `lines.lineObservations` (string)
    Observations for this document line.
    Example: "Deliver before 9 AM"

  - `lines.details` (array)
    List of line details. See ApiBaseLineDetailReadDto.java for the structure.

  - `lines.details.widthId` (integer)
    Width identifier.
    Example: 200

  - `lines.details.widthCode` (string)
    Width code.
    Example: "W-35"

  - `lines.details.quantitiesPerSize` (array)
    Quantities per size. For structure see ApiBaseLineDetailSizeReadDto.java

  - `lines.details.quantitiesPerSize.sizeRangeDetailId` (integer, required)
    Size detail identifier.
    Example: 15

  - `lines.details.quantitiesPerSize.sizeRangeDetailSize` (string, required)
    Size code within the range.
    Example: "M"

  - `lines.details.quantitiesPerSize.sizeRangeSizeOrder` (integer)
    Order value of the size in the range.
    Example: 2

  - `lines.details.quantitiesPerSize.quantityPerPackage` (number)
    Quantity per package for this size.
    Example: 8

  - `lines.details.quantitiesPerSize.quantityDetail` (number)
    Total quantity for this size.
    Example: 24

  - `lines.details.quantitiesPerSize.availability` (number)
    Available quantity for this size.
    Example: 10

  - `lines.details.quantitiesPerSize.sizeOrder` (integer)
    Order of the size in the detail
    Example: 1

  - `lines.details.quantitiesPerSize.quantityReal` (number)
    Real quantity for this size
    Example: 10

  - `lines.details.quantitiesPerSize.quantityAccumulated` (number)
    Accumulated quantity for this size
    Example: 8

  - `lines.articleCombinationDescription` (string)
    Description of the article combination
    Example: "Product X - Size L"

  - `lines.totalQuantityReal` (number)
    Total real quantity for regularization
    Example: 50

  - `lines.totalQuantityAccumulated` (number)
    Total accumulated quantity
    Example: 45

  - `lines.accumulateInto` (string)
    Type of accumulation
    Enum: "STOCK", "PURCHASES", "SALES", "CANCELLED", "IN_BOUNDS", "DIRECT_IN_BOUNDS", "OUT_BOUNDS", "DIRECT_OUT_BOUNDS", "IN_PRODUCCTION", "PRODUCED", "AVAILABLE", "NEEDS", "SUPPLIER_CANCELLATIONS", "PRODUCTION_OUT_BOUNDS", "PRODUCTION_RESERVED", "RETURN"

  - `lines.totalLine` (number)
    Total amount for the line
    Example: 100

  - `lines.batches` (object)
    List of batches for the line

  - `lines.batches.batchId` (integer)
    Batch identifier.
    Example: 101

  - `lines.batches.batchCode` (string)
    Batch code/label.
    Example: "LOT-2025A"

  - `lines.batches.quantity` (number)
    Quantity in the batch.
    Example: 50.25

  - `lines.batches.availability` (number)
    Availability in the batch.
    Example: 26

  - `lines.batches.packages` (integer)
    Amount of packages in this batch.
    Example: 2

  - `lines.serialNumbers` (object)
    List of serial numbers for the line

  - `lines.serialNumbers.serialNumberId` (integer)
    Serial number identifier.
    Example: 1500

  - `lines.serialNumbers.serialNumberCode` (string)
    Serial code.
    Example: "SN-A123XYZ"

  - `lines.serialNumbers.expirationDate` (string)
    Expiration date for the serial number, if any, in ISO format (yyyy-MM-dd).
    Example: "2026-12-31"

  - `stockRegularizatedDate` (string)
    Date when the stock regularization was completed
    Example: "2024-01-16"

  - `stockRegularizated` (boolean)
    Flag indicating if the stock regularization has been completed
    Example: true

  - `warehouse` (object)
    Warehouse information

  - `warehouse.code` (string, required)
    Warehouse code (unique per warehouse).
    Example: "ALM01"

  - `warehouse.description` (string, required)
    Warehouse description.
    Example: "Central warehouse"

  - `valuationType` (string)
    Type of valuation method used for regularization
    Enum: "AVERAGE_COST_PRICE", "GROSS_PRICE_CURRENT_COST", "NET_PRICE_CURRENT_COST"