# Create DeliveryNote

Create a new deliveryNote.

Endpoint: POST /api/v1/deliveryNote
Version: 1.0

## Request fields (application/json):

  - `number` (integer)
    Unique serial number of the document header.
    Example: 1050

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

  - `quantityTotal` (number)
    Total quantity of all document lines.
    Example: 120.5

  - `observations` (string)
    Free text for header observations.
    Example: "Deliver to warehouse B"

  - `lines` (array)
    List of document lines. For structure, see ApiBaseLineWriteDto.java

  - `lines.id` (integer)
    Unique identifier of the line.
    Example: 1001

  - `lines.articleCombination` (integer)
    Identifier of the related article combination.
    Example: 200

  - `lines.sizeRange` (integer)
    Identifier of the size range associated with the article.
    Example: 15

  - `lines.assortment` (integer)
    Identifier of the assortment to which the article belongs.
    Example: 8

  - `lines.lineNumber` (integer)
    Sequential number of the line within the document.
    Example: 1

  - `lines.articleDescription` (string)
    Description of the article in the line.
    Example: "Cotton T-shirt - Blue"

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

  - `lines.quantityPerPackage` (number)
    Quantity of items per package.
    Example: 12

  - `lines.price` (number)
    Unit price of the article.
    Example: 19.99

  - `lines.lineObservations` (string)
    Additional observations or comments about this line.
    Example: "Special discount applied."

  - `lines.details` (array)
    Gets the list of line details. See ApiBaseLineDetailWriteDto for structure.

  - `lines.details.id` (integer)
    Internal identifier for this line detail.
    Example: 200

  - `lines.details.sizeRangeDetail` (integer)
    Identifier for the size range detail.
    Example: 15

  - `lines.details.width` (integer)
    Width identifier.
    Example: 12

  - `lines.details.quantityPerPackage` (number)
    Quantity per package for this detail.
    Example: 9.3

  - `lines.packaging` (integer)
    Packaging article identifier
    Example: 1001

  - `lines.assortedPackages` (boolean)
    Indicates if packages are assorted
    Example: true

  - `lines.discount` (number)
    Discount percentage applied to this line
    Example: 10.5

  - `lines.rsp` (number)
    Recommended selling price
    Example: 25.99

  - `lines.reference` (string)
    Reference code for the line
    Example: "REF-2024-001"

  - `lines.picture` (string)
    Picture filename
    Example: "product_image_001.jpg"

  - `lines.warehouse` (integer)
    Warehouse identifier
    Example: 3

  - `lines.noAccumulateWarehouse` (boolean)
    Indicates if warehouse accumulation is disabled

  - `lines.brand` (integer)
    Brand identifier
    Example: 5

  - `lines.returnReason` (integer)
    Return reason identifier if applicable
    Example: 1

  - `lines.received` (boolean)
    Indicates if the line has been received
    Example: true

  - `lines.accepted` (boolean)
    Indicates if the line has been accepted
    Example: true

  - `lines.freeDescription1` (string)
    First free description field
    Example: "Special handling required"

  - `lines.freeDescription2` (string)
    Second free description field
    Example: "Custom packaging"

  - `lines.freeDescription3` (string)
    Third free description field
    Example: "Priority delivery"

  - `lines.freeDescription4` (string)
    Fourth free description field
    Example: "Gift wrap"

  - `lines.freeDescription5` (string)
    Fifth free description field
    Example: "Express shipping"

  - `lines.customCommission` (boolean)
    Indicates if custom commission is applied

  - `lines.representative1` (integer)
    First representative identifier
    Example: 2

  - `lines.commissionType1` (string)
    First commission type
    Example: "PERCENTAGE"

  - `lines.commission1` (number)
    First commission value
    Example: 5

  - `lines.representative2` (integer)
    Second representative identifier
    Example: 3

  - `lines.commissionType2` (string)
    Second commission type
    Example: "PERCENTAGE"

  - `lines.commission2` (number)
    Second commission value
    Example: 3

  - `lines.representative3` (integer)
    Third representative identifier
    Example: 4

  - `lines.commissionType3` (string)
    Third commission type
    Example: "FIXED"

  - `lines.commission3` (number)
    Third commission value
    Example: 25

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

  - `lines.vatPercentage` (number)
    VAT percentage applied to this line
    Example: 21

  - `lines.surchargePercentage` (number)
    Surcharge percentage applied to this line
    Example: 5.2

  - `lines.grossAmount` (number)
    Gross amount before discounts
    Example: 1000

  - `lines.grossAmountCompanyCurrency` (number)
    Gross amount in company currency
    Example: 1000

  - `lines.netAmount` (number)
    Net amount after discounts
    Example: 900

  - `lines.netAmountCompanyCurrency` (number)
    Net amount in company currency
    Example: 900

  - `lines.totalLine` (number)
    Total line amount
    Example: 1089

  - `lines.totalLineCompanyCurrency` (number)
    Total line amount in company currency
    Example: 1089

  - `lines.batches` (array)
    Gets the list of outbound batch items. See ApiBaseLineBatchOutboundWriteDto for structure.

  - `lines.batches.id` (integer)
    Internal identifier for this outbound batch line.
    Example: 21

  - `lines.batches.batch` (integer)
    Batch ID or code for outbound batch.
    Example: 102

  - `lines.batches.quantity` (number)
    Quantity for this outbound batch.
    Example: 40

  - `lines.batches.packages` (integer)
    Number of packages assigned to this outbound batch.
    Example: 3

  - `lines.serialNumbers` (array)
    Gets the list of serial number items. See ApiBaseLineSerialNumberWriteDto for structure.

  - `lines.serialNumbers.id` (integer)
    Internal identifier for this serial number line.
    Example: 8

  - `lines.serialNumbers.serialNumber` (integer)
    ID of the serial number.
    Example: 202

  - `lines.concept` (string)
    Concept description for the line
    Example: "Product delivery"

  - `lines.disbursement` (boolean)
    Indicates if this line involves disbursement

  - `id` (integer)
    Unique identifier of the delivery note
    Example: 1001

  - `billingSeries` (integer)
    Billing series identifier
    Example: 5

  - `valueDate` (string)
    Value date for the delivery note
    Example: "2024-08-08"

  - `customerAddress` (integer)
    Customer address identifier
    Example: 15

  - `reference` (string)
    Reference number for the delivery note
    Example: "DN-2024-001"

  - `rateCode` (integer)
    Rate code identifier
    Example: 101

  - `agency` (integer)
    Agency identifier for shipping
    Example: 10

  - `locked` (boolean)
    Indicates if the delivery note is locked for modifications

  - `paymentMethod` (integer)
    Payment method identifier
    Example: 3

  - `firstTerm` (integer)
    First payment term in days
    Example: 30

  - `daysTerm` (integer)
    Subsequent payment term in days
    Example: 30

  - `terms` (integer)
    Number of payment terms
    Example: 3

  - `proximityType` (string)
    Type of proximity for the delivery
    Enum: "NEARBY", "PREVIOUS", "LATER"

  - `discount1` (number)
    First discount percentage
    Example: 10

  - `discount2` (number)
    Second discount percentage
    Example: 5

  - `discount3` (number)
    Third discount percentage
    Example: 2

  - `discount4` (number)
    Fourth discount percentage
    Example: 1

  - `discountPp` (number)
    Prompt payment discount percentage
    Example: 3

  - `withholding` (number)
    Withholding percentage
    Example: 15

  - `currency` (integer)
    Currency identifier
    Example: 1

  - `change` (number)
    Exchange rate for currency conversion
    Example: 1

  - `iban` (string)
    International Bank Account Number
    Example: "ES9121000418450200051332"

  - `customerVatType` (integer)
    Customer VAT type identifier
    Example: 1

  - `noAccumulateRisk` (boolean)
    Indicates if risk accumulation is disabled

  - `packages` (integer)
    Total number of packages
    Example: 5

  - `grossWeight` (number)
    Total gross weight
    Example: 125.5

  - `netWeight` (number)
    Total net weight
    Example: 120

  - `volume` (number)
    Total volume
    Example: 2.35

  - `billingObservations` (string)
    Billing observations
    Example: "Handle with care"

  - `shippingTerm` (integer)
    Shipping term identifier
    Example: 2

  - `shippingAmount` (number)
    Shipping amount
    Example: 25.5

  - `shippingVatType` (string)
    VAT type for shipping costs
    Enum: "SUPER_REDUCED", "REDUCED", "GENERAL", "EXEMPT"

  - `shippingVatPercentage` (number)
    VAT percentage applied to shipping
    Example: 21

  - `shippingSurchargePercentage` (number)
    Surcharge percentage applied to shipping
    Example: 5.2

  - `phytosanitaryAuthorizedPerson` (integer)
    Phytosanitary authorized person identifier
    Example: 1

  - `tags` (array)
    Tags associated with the delivery note
    Example: ["urgent","fragile"]

  - `invoiceEditObservations` (string)
    Invoice editing observations
    Example: "Delivery note reviewed and approved"

  - `salesAccount` (integer)
    Sales account identifier
    Example: 7001

## 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.packaging` (object)
    Packaging article information

  - `lines.packaging.code` (string, required)
    Code of the article
    Example: "ART123"

  - `lines.packaging.description` (string)
    Description of the article
    Example: "Premium leather jacket"

  - `lines.packaging.description2` (string)
    Secondary description of the article
    Example: "Available in multiple colors"

  - `lines.packaging.warehouse` (string, required)
    Warehouse associated with the article
    Example: "MAIN"

  - `lines.packaging.category1` (string)
    Primary category of the article
    Example: "Clothing"

  - `lines.packaging.category2` (string)
    Secondary category of the article
    Example: "Jackets"

  - `lines.packaging.category3` (string)
    Tertiary category of the article
    Example: "Leather"

  - `lines.packaging.category4` (string)
    Quaternary category of the article
    Example: "Premium"

  - `lines.packaging.vatType` (string, required)
    VAT type of the article
    Enum: "SUPER_REDUCED", "REDUCED", "GENERAL", "EXEMPT"

  - `lines.packaging.season` (string)
    Season associated with the article
    Example: "FALL2023"

  - `lines.packaging.family` (string)
    Family of the article
    Example: "OUTDOOR"

  - `lines.packaging.baseCombination` (object)
    Base combination of the article

  - `lines.packaging.tags` (array)
    List of tags associated with the article
    Example: ["premium","leather","fashion"]

  - `lines.packaging.showAttribute1` (boolean)
    Indicates if attribute 1 should be displayed
    Example: true

  - `lines.packaging.showAttribute2` (boolean)
    Indicates if attribute 2 should be displayed

  - `lines.packaging.showAttribute3` (boolean)
    Indicates if attribute 3 should be displayed

  - `lines.packaging.showAttribute4` (boolean)
    Indicates if attribute 4 should be displayed

  - `lines.packaging.showAttribute5` (boolean)
    Indicates if attribute 5 should be displayed

  - `lines.assortedPackages` (boolean)
    Indicates if packages are assorted
    Example: true

  - `lines.discount` (number)
    Discount percentage applied to this line
    Example: 10.5

  - `lines.rsp` (number)
    Recommended selling price
    Example: 25.99

  - `lines.reference` (string)
    Reference code for the line
    Example: "REF-2024-001"

  - `lines.status` (string)
    Status of the delivery note line
    Enum: "INVOICED"

  - `lines.picture` (string)
    Picture filename
    Example: "product_image_001.jpg"

  - `lines.pictureToken` (string)
    Picture access token
    Example: "abc123def456"

  - `lines.warehouse` (object)
    Warehouse information

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

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

  - `lines.noAccumulateWarehouse` (boolean)
    Indicates if warehouse accumulation is disabled

  - `lines.brand` (object)
    Brand information

  - `lines.brand.code` (string, required)
    Unique brand code.
    Example: "NIKE"

  - `lines.returnReason` (object)
    Return reason information

  - `lines.returnReason.code` (string, required)
    Unique code for the return reason
    Example: "DAMAGED"

  - `lines.returnReason.description` (string)
    Description of the return reason
    Example: "Product Damaged"

  - `lines.received` (boolean)
    Indicates if the line has been received
    Example: true

  - `lines.accepted` (boolean)
    Indicates if the line has been accepted
    Example: true

  - `lines.freeDescription1` (string)
    First free description field
    Example: "Special handling required"

  - `lines.freeDescription2` (string)
    Second free description field
    Example: "Custom packaging"

  - `lines.freeDescription3` (string)
    Third free description field
    Example: "Priority delivery"

  - `lines.freeDescription4` (string)
    Fourth free description field
    Example: "Gift wrap"

  - `lines.freeDescription5` (string)
    Fifth free description field
    Example: "Express shipping"

  - `lines.customCommission` (boolean)
    Indicates if custom commission is applied

  - `lines.representative1` (object)
    First representative information

  - `lines.representative1.name` (string)

  - `lines.representative1.cif` (string)

  - `lines.representative1.population` (string)

  - `lines.representative1.country` (string)

  - `lines.representative1.state` (string)

  - `lines.representative1.phone1` (string)

  - `lines.representative1.phone2` (string)

  - `lines.representative1.email` (string)

  - `lines.representative1.commission` (number)

  - `lines.representative1.commissionType` (string)
    Defines the types of commission calculations.
    Enum: "PERCENTAGE", "AMOUNT_PER_UNIT", "FIXED"

  - `lines.representative1.irpfPercentage` (number)

  - `lines.representative1.vatPercentage` (number)

  - `lines.representative1.subAgentOf` (string)

  - `lines.representative1.userB2bMobility` (string)

  - `lines.representative1.enableB2bMobility` (boolean)

  - `lines.commissionType1` (string)
    First commission type
    Enum: "PERCENTAGE", "AMOUNT_PER_UNIT", "FIXED"

  - `lines.commission1` (number)
    First commission value
    Example: 5

  - `lines.representative2` (object)
    Second representative information

  - `lines.commissionType2` (string)
    Second commission type
    Enum: "PERCENTAGE", "AMOUNT_PER_UNIT", "FIXED"

  - `lines.commission2` (number)
    Second commission value
    Example: 3

  - `lines.representative3` (object)
    Third representative information

  - `lines.commissionType3` (string)
    Third commission type
    Enum: "PERCENTAGE", "AMOUNT_PER_UNIT", "FIXED"

  - `lines.commission3` (number)
    Third commission value
    Example: 25

  - `lines.vatPercentage` (number)
    VAT percentage applied to this line
    Example: 21

  - `lines.surchargePercentage` (number)
    Surcharge percentage applied to this line
    Example: 5.2

  - `lines.grossAmount` (number)
    Gross amount before discounts
    Example: 1000

  - `lines.grossAmountCompanyCurrency` (number)
    Gross amount in company currency
    Example: 1000

  - `lines.netAmount` (number)
    Net amount after discounts
    Example: 900

  - `lines.netAmountCompanyCurrency` (number)
    Net amount in company currency
    Example: 900

  - `lines.totalLine` (number)
    Total line amount
    Example: 1089

  - `lines.totalLineCompanyCurrency` (number)
    Total line amount in company currency
    Example: 1089

  - `lines.orderId` (integer)
    Related order identifier
    Example: 1501

  - `lines.orderNumber` (integer)
    Related order number
    Example: 10025

  - `lines.invoiceId` (integer)
    Related invoice identifier
    Example: 2001

  - `lines.invoiceNumber` (integer)
    Related invoice number
    Example: 10030

  - `lines.availability` (number)
    Product availability quantity
    Example: 85.5

  - `lines.invoiceDocumentDate` (string)
    Related invoice document date
    Example: "2024-08-05"

  - `lines.invoiceBillingSeriesCode` (string)
    Related invoice billing series code
    Example: "A"

  - `lines.customerId` (integer)
    Customer identifier
    Example: 1001

  - `lines.customerName` (string)
    Customer name
    Example: "ABC Company S.A."

  - `lines.batches` (object)
    List of batches for this 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 this 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"

  - `lines.purchaseDeliveryNoteLine` (object)
    Purchase delivery note line information

  - `lines.purchaseDeliveryNoteLine.purchaseOrderServedQuantity` (number)
    Quantity served from the purchase order
    Example: 25.5

  - `lines.purchaseDeliveryNoteLine.purchaseOrderId` (integer)
    Related purchase order identifier
    Example: 1501

  - `lines.purchaseDeliveryNoteLine.purchaseOrderNumber` (integer)
    Related purchase order number
    Example: "PO-2024-001"

  - `lines.purchaseDeliveryNoteLine.purchaseOrderTotal` (number)
    Total amount of the related purchase order
    Example: 5000

  - `lines.purchaseDeliveryNoteLine.purchaseOrderLineId` (integer)
    Related purchase order line identifier
    Example: 3001

  - `lines.purchaseDeliveryNoteLine.purchaseOrderLineLineNumber` (integer)
    Line number in the related purchase order
    Example: 1

  - `lines.purchaseDeliveryNoteLine.supplierId` (integer)
    Supplier identifier
    Example: 1001

  - `lines.purchaseDeliveryNoteLine.supplierCommercialName` (string)
    Commercial name of the supplier
    Example: "ABC Suppliers Ltd."

  - `lines.purchaseDeliveryNoteLine.disbursement` (boolean)
    Indicates if this line involves disbursement

  - `lines.purchaseDeliveryNoteLine.concept` (string)
    Concept description for the line
    Example: "Product purchase"

  - `lines.purchaseDeliveryNoteLine.investment` (boolean)
    Indicates if this line is an investment

  - `lines.purchaseDeliveryNoteLine.deductible` (boolean)
    Indicates if this line is deductible
    Example: true

  - `lines.deliveryNoteReturnedQuantity` (number)
    Quantity returned from delivery note
    Example: 2.5

  - `lines.orderServedQuantity` (number)
    Quantity served from order
    Example: 15

  - `lines.returnedQuantity` (number)
    Total returned quantity
    Example: 5

  - `change` (number)
    Change applied to the invoice or document
    Example: 0.5

  - `discount1` (number)
    First discount percentage
    Example: 5

  - `discount2` (number)
    Second discount percentage
    Example: 2

  - `discountAmountTotal` (number)
    Total discount amount
    Example: 100

  - `discountAmountTotalCompanyCurrency` (number)
    Total discount amount in company currency
    Example: 95

  - `discountPp` (number)
    Prompt payment discount percentage
    Example: 3

  - `discountPpAmountTotal` (number)
    Total prompt payment discount amount
    Example: 15

  - `discountPpAmountTotalCompanyCurrency` (number)
    Total prompt payment discount amount in company currency
    Example: 14

  - `grossAmountTotal` (number)
    Gross total amount
    Example: 1200

  - `grossAmountTotalCompanyCurrency` (number)
    Gross total amount in company currency
    Example: 1150

  - `netAmountTotal` (number)
    Net total amount
    Example: 1100

  - `netAmountTotalCompanyCurrency` (number)
    Net total amount in company currency
    Example: 1080

  - `vatAmountTotal` (number)
    Total VAT amount
    Example: 230

  - `vatAmountTotalCompanyCurrency` (number)
    Total VAT amount in company currency
    Example: 225

  - `surchargeAmountTotal` (number)
    Total surcharge amount
    Example: 20

  - `surchargeAmountTotalCompanyCurrency` (number)
    Total surcharge amount in company currency
    Example: 18

  - `withholding` (number)
    Withholding percentage
    Example: 2

  - `withholdingAmountTotal` (number)
    Total withholding amount
    Example: 22

  - `withholdingAmountTotalCompanyCurrency` (number)
    Total withholding amount in company currency
    Example: 21

  - `total` (number)
    Total document amount
    Example: 1300

  - `totalCompanyCurrency` (number)
    Total document amount in company currency
    Example: 1280

  - `disbursementAmountTotal` (number)
    Total disbursement amount
    Example: 50

  - `disbursementAmountTotalCompanyCurrency` (number)
    Total disbursement amount in company currency
    Example: 48

  - `billingSeries` (object, required)
    Billing series information

  - `billingSeries.type` (string, required)
    Type of the billing series. See ApiBillingSeriesTypeEnum for possible values.
    Enum: "PURCHASE", "PURCHASE_TICKET", "SALE", "SALE_TICKET", "INVOICE_DRAFT"

  - `billingSeries.code` (string, required)
    Billing series code.
    Example: "SER2025"

  - `billingSeries.description` (string)
    Description of the billing series.
    Example: "Main invoice series"

  - `billingSeries.deposit` (boolean)
    Indicates if this is the default series.
    Example: true

  - `billingSeries.corrective` (boolean)

  - `valueDate` (string)
    Value date
    Example: "2024-01-20"

  - `customerAddress` (object)
    Customer address information

  - `customerAddress.code` (integer, required)
    Address code.
    Example: 101

  - `customerAddress.customerCode` (string)
    Customer string code.
    Example: "C10001"

  - `customerAddress.customerName` (string)
    Name of the customer.
    Example: "Acme S.A."

  - `customerAddress.customerPostalCode` (string)
    Postal code of the customer.
    Example: "03001"

  - `customerAddress.customerAddress` (string)
    Street address of the customer.
    Example: "Avenida de la Estación, 5"

  - `customerAddress.customerCity` (string)
    City of the customer.
    Example: "Alicante"

  - `customerAddress.customerState` (string)
    Customer state code.
    Example: "A"

  - `customerAddress.customerStateDescription` (string)
    Description of the customer state.
    Example: "Alicante"

  - `customerAddress.customerCountry` (string)
    Country code of the customer.
    Example: "ES"

  - `customerAddress.customerCountryDescription` (string)
    Country description of the customer.
    Example: "Spain"

  - `customerAddress.customerFirstPhoneNumber` (string)
    First customer phone number.
    Example: "+34965123456"

  - `customerAddress.customerSecondPhoneNumber` (string)
    Second customer phone number.
    Example: "+34965111111"

  - `customerAddress.customerEmail` (string)
    Customer email address.
    Example: "cliente@acme.es"

  - `customerAddress.customerCif` (string)
    Customer CIF or NIF.
    Example: "B12345678"

  - `customerAddress.customerId` (integer)
    Customer identifier (numeric).
    Example: 10001

  - `customerAddress.customerCommercialName` (string)
    Customer commercial name.
    Example: "Acme España"

  - `customerAddress.name` (string)
    Address name or label.
    Example: "Warehourse"

  - `customerAddress.city` (string)
    City for this address.
    Example: "Alicante"

  - `customerAddress.state` (string)
    State (code).
    Example: "A"

  - `customerAddress.stateDescription` (string)
    State description.
    Example: "Alicante"

  - `customerAddress.postalCode` (string)
    Postal code for the address.
    Example: "03001"

  - `customerAddress.country` (string)
    Country code for this address.
    Example: "ES"

  - `customerAddress.countryDescription` (string)
    Country description for this address.
    Example: "Spain"

  - `customerAddress.address` (string)
    Street address.
    Example: "Street Example, 14"

  - `customerAddress.firstPhoneNumber` (string)
    First phone number.
    Example: "+34965123456"

  - `customerAddress.secondPhoneNumber` (string)
    Second phone number.
    Example: "+34965111111"

  - `customerAddress.email` (string)
    Email for this address.
    Example: "direccion@acme.es"

  - `customerAddress.cif` (string)
    CIF/NIF for this address.
    Example: "B12345678"

  - `customerAddress.activity` (string)
    Activity for this address.
    Example: "Wholesale"

  - `customerAddress.brand` (string)
    Brand associated to this address.
    Example: "Acme Main Brand"

  - `customerAddress.brandId` (string)
    Brand id for this address.
    Example: 5010

  - `customerAddress.customerIsActive` (boolean)
    True if the customer is active.
    Example: true

  - `customerAddress.isActive` (boolean)
    True if this address is active.
    Example: true

  - `reference` (string)
    Reference number
    Example: "ALB-2024-001"

  - `rateCode` (object)
    Exchange rate code information

  - `rateCode.taxesIncluded` (boolean)

  - `agency` (object)
    Agency information

  - `agency.code` (string, required)
    Agency code.
    Example: "AG001"

  - `agency.name` (string, required)
    Name of the agency.
    Example: "Fast Transport Agency"

  - `locked` (boolean)
    Flag indicating if the document is locked

  - `paymentMethod` (object, required)
    Payment method information

  - `paymentMethod.code` (integer, required)
    Código único del método de pago
    Example: 1

  - `paymentMethod.description` (string, required)
    Descripción del método de pago
    Example: "Transferencia bancaria"

  - `paymentMethod.document` (string)
    Documento asociado al método de pago
    Example: "Contrato"

  - `paymentMethod.firstTerm` (integer)
    Primer plazo de pago en días
    Example: 30

  - `paymentMethod.terms` (integer)
    Número total de plazos
    Example: 3

  - `paymentMethod.daysTerms` (integer)
    Días entre plazos
    Example: 30

  - `paymentMethod.remittance` (boolean)
    Indica si es una remesa
    Example: true

  - `paymentMethod.addToCustomerBase` (boolean)
    Indica si se debe añadir a la base de clientes
    Example: true

  - `paymentMethod.serveFullPrePaid` (boolean)
    Indica si sirve como pago anticipado completo

  - `paymentMethod.observations` (string)
    Observaciones adicionales
    Example: "Requiere verificación bancaria"

  - `paymentMethod.icon` (string)
    Icono representativo del método de pago
    Example: "fa-credit-card"

  - `paymentMethod.facturaECode` (string)
    Código de factura electrónica asociado
    Enum: "NOT_SPECIFIED", "CASH", "DOMICILED_RECEIPT", "RECEIPT", "TRANSFER", "ACCEPTED_LETTER", "LETTER_OF_CREDIT", "CONTRACT_AWARD", "BILL_OF_EXCHANGE", "PROMISORY_NOTE_IN_ORDER", "PROMISORY_NOTE_NOT_IN_ORDER", "CHECK_NOTE", "REPLACEMENT", "SPECIALS", "COMPENSATION", "POSTAL_ORDER", "FORMED_CHECK", "BANK_CHECK", "CASH_ON_DELIVERY_PAYMENT", "PAYMENT_BY_CARD"

  - `firstTerm` (integer)
    First payment term in days
    Example: 30

  - `daysTerm` (integer)
    Payment term in days
    Example: 30

  - `terms` (integer)
    Number of payment terms
    Example: 3

  - `proximityType` (string)
    Type of proximity
    Enum: "NEARBY", "PREVIOUS", "LATER"

  - `discount3` (number)
    Third discount percentage
    Example: 3

  - `discount4` (number)
    Fourth discount percentage
    Example: 2

  - `currency` (object, required)
    Currency information

  - `currency.nomenclature` (string)

  - `currency.isoCode` (string)
    Defines the ISO currency codes.
    Enum: "AED", "AFA", "ALL", "AMD", "ANG", "AOA", "ARS", "AUD", "AWG", "AZM", "BAM", "BBD", "BDT", "BGL", "BHD", "BIF", "BMD", "BND", "BOB", "BRL", "BSD", "BTN", "BWP", "BYR", "BZD", "CAD", "CDF", "CHF", "CLP", "CNY", "COP", "CRC", "CUP", "CVE", "CYP", "CZK", "DJF", "DKK", "DOP", "DZD", "EEK", "EGP", "ERN", "ETB", "EUR", "FJD", "FKP", "GBP", "GEL", "GGP", "GHC", "GIP", "GMD", "GNF", "GTQ", "GYD", "HKD", "HNL", "HRK", "HTG", "HUF", "IDR", "ILS", "IMP", "INR", "IQD", "IRR", "ISK", "JEP", "JMD", "JOD", "JPY", "KES", "KGS", "KHR", "KMF", "KPW", "KRW", "KWD", "KYD", "KZT", "LAK", "LBP", "LKR", "LRD", "LSL", "LTL", "LVL", "LYD", "MAD", "MDL", "MGF", "MKD", "MMK", "MNT", "MOP", "MRO", "MTL", "MUR", "MVR", "MWK", "MXN", "MYR", "MZM", "NAD", "NGN", "NIO", "NOK", "NPR", "NZD", "OMR", "PAB", "PEN", "PGK", "PHP", "PKR", "PLN", "PYG", "QAR", "ROL", "RUR", "RWF", "SAR", "SBD", "SCR", "SDD", "SEK", "SGD", "SHP", "SIT", "SKK", "SLL", "SOS", "SPL", "SRG", "STD", "SVC", "SYP", "SZL", "THB", "TJS", "TMM", "TND", "TOP", "TRL", "TTD", "TVD", "TWD", "TZS", "UAH", "UGX", "USD", "UYU", "UZS", "VEB", "VND", "VUV", "WST", "XAF", "XAG", "XAU", "XCD", "XDR", "XOF", "XPD", "XPF", "XPT", "YER", "YUM", "ZAR", "ZMK", "ZWD", "RUB", "TRY"

  - `currency.changeValue` (number)

  - `currency.significantDecimalsDocuments` (integer)

  - `currency.intermediateDecimalsDocuments` (integer)

  - `currency.decimalsCalculatePrices` (integer)

  - `currency.decimalsCalculateCosts` (integer)

  - `iban` (string)
    IBAN for payments
    Example: "ES9121000418450200051332"

  - `customerVatType` (object, required)
    Customer VAT type information

  - `customerVatType.code` (string, required)
    VAT type code. Example: GENERAL, REDUCED, EXEMPT, etc.
    Example: "GENERAL"

  - `customerVatType.description` (string)
    Description of the VAT type.
    Example: "General VAT type"

  - `phytosanitaryAuthorizedPerson` (object)
    Phytosanitary authorized person information

  - `phytosanitaryAuthorizedPerson.identificationNumber` (string)
    Authorized person's identification number.
    Example: "12345678A"

  - `phytosanitaryAuthorizedPerson.name` (string)
    Authorized person's full name.
    Example: "John Doe"

  - `phytosanitaryAuthorizedPerson.certificateExpirationDate` (string)
    Date of certificate expiration (yyyy-MM-dd).
    Example: "2025-12-31"

  - `phytosanitaryAuthorizedPerson.ropoCode` (string)

  - `representative1` (object)
    Primary representative information

  - `commissionType1` (string)
    Type of commission for primary representative
    Enum: "PERCENTAGE", "AMOUNT_PER_UNIT", "FIXED"

  - `commission1` (number)
    Commission amount for primary representative
    Example: 5

  - `representative2` (object)
    Secondary representative information

  - `commissionType2` (string)
    Type of commission for secondary representative
    Enum: "PERCENTAGE", "AMOUNT_PER_UNIT", "FIXED"

  - `commission2` (number)
    Commission amount for secondary representative
    Example: 100

  - `representative3` (object)
    Tertiary representative information

  - `commissionType3` (string)
    Type of commission for tertiary representative
    Enum: "PERCENTAGE", "AMOUNT_PER_UNIT", "FIXED"

  - `commission3` (number)
    Commission amount for tertiary representative
    Example: 2.5

  - `noAccumulateRisk` (boolean)
    Flag indicating no accumulation risk

  - `packages` (integer)
    Number of packages
    Example: 5

  - `grossWeight` (number)
    Gross weight in kilograms
    Example: 25.5

  - `netWeight` (number)
    Net weight in kilograms
    Example: 23

  - `volume` (number)
    Volume in cubic meters
    Example: 0.5

  - `billingObservations` (string)
    Billing observations
    Example: "Handle with care"

  - `shippingTerm` (object)
    Shipping terms information

  - `shippingTerm.customerPays` (boolean)

  - `shippingTerm.intrastatCode` (string)

  - `shippingAmount` (number)
    Shipping amount
    Example: 25.5

  - `shippingVatType` (string)
    VAT type for shipping
    Enum: "SUPER_REDUCED", "REDUCED", "GENERAL", "EXEMPT"

  - `shippingVatPercentage` (number)
    VAT percentage for shipping
    Example: 21

  - `shippingSurchargePercentage` (number)
    Surcharge percentage for shipping
    Example: 5

  - `tags` (array)
    Tags associated with the delivery note
    Example: ["urgent","fragile"]

  - `invoiceEditObservations` (string)
    Observations for invoice editing
    Example: "Special handling required"

  - `collectedAmount` (number)
    Collected amount
    Example: 1500

  - `collectedAmountCompanyCurrency` (number)
    Collected amount in company currency
    Example: 1500