# Create order from ecommerce

Create a new order from ecommerce platform.

Endpoint: POST /api/v1/ecommerce/order
Version: 1.0

## Query parameters:

  - `shopId` (integer, required)

## Request fields (application/json):

  - `cmsOrderId` (integer)
    CMS id

  - `payment` (string)
    Payment method description
    Example: "Transferencia"

  - `dateAdd` (string, required)
    Order date

  - `totalShippingTaxExcl` (number)
    Total shipping cost, tax excluded

  - `totalShippingTaxIncl` (number)
    Total shipping cost, tax included

  - `gift` (boolean)
    Order is a gift

  - `giftMessage` (string)
    Gift message

  - `cms` (string)
    Gift message

  - `reference` (string)
    Order reference from cms

  - `messageOrder` (string)
    Order observations

  - `totalDiscountsTaxExcl` (number)
    Order discounts, tax excluded

  - `totalDiscountsTaxIncl` (number)
    Order discounts, tax included

  - `customer` (object, required)
    Customer associated with the order

  - `customer.cmsCustomerId` (integer)

  - `customer.defaultGroup` (integer)

  - `customer.company` (string)

  - `customer.firstName` (string)

  - `customer.lastName` (string)

  - `customer.email` (string)

  - `customer.note` (string)

  - `addressDelivery` (object, required)
    Invoice address

  - `addressDelivery.cmsCustomerAddressId` (integer)

  - `addressDelivery.alias` (string)

  - `addressDelivery.address1` (string)

  - `addressDelivery.address2` (string)

  - `addressDelivery.dni` (string)

  - `addressDelivery.city` (string)

  - `addressDelivery.countryIso` (string)

  - `addressDelivery.stateIso` (string)

  - `addressDelivery.other` (string)

  - `addressDelivery.phone` (string)

  - `addressDelivery.phoneMobile` (string)

  - `addressDelivery.postCode` (string)

  - `addressInvoice` (object, required)
    Shipping address associated with the order

  - `orderCartRules` (array)
    Amount gifted or discounted

  - `orderCartRules.name` (string)

  - `orderCartRules.valueTaxExcl` (number)

  - `orderCartRules.valueTaxIncl` (number)

  - `orderCartRules.code` (string)

  - `orderDetails` (array, required)
    Order lines

  - `orderDetails.reference` (string)

  - `orderDetails.description` (string)

  - `orderDetails.quantity` (number)

  - `orderDetails.priceWithoutTax` (number)

  - `orderDetails.priceWithTax` (number)

  - `orderDetails.reduction` (number)

## 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.articleCombination.ean` (string)
    EAN code of the product variant
    Example: 8437000000012

  - `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.cancelledQuantityDetail` (number)
    Quantity that has been cancelled for this size
    Example: 5.5

  - `lines.details.quantitiesPerSize.servedQuantityDetail` (number)
    Quantity that has been served for this size
    Example: 18.5

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

  - `lines.details.cancelledQuantity` (number)
    Quantity that has been cancelled for this line detail
    Example: 5.75

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

  - `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
    Example: "STANDARD"

  - `lines.packaging.purchaseVatType` (string, required)
    Purchase VAT type of the article
    Example: "STANDARD"

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

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

  - `lines.packaging.subfamily` (string)
    Subfamily of the article
    Example: "WINTER"

  - `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.discount` (number)
    Discount percentage applied to this line
    Example: 10.5

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

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

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

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

  - `lines.status` (string)
    Status of the order line
    Enum: "INITIAL", "SHIPPED", "PARTIALLY_SHIPPED", "CANCELLED", "PARTIALLY_CANCELLED", "FINISHED", "OUT_OF_TIME", "RECEIVED", "PARTIALLY_RECEIVED", "PENDING"

  - `lines.inProduction` (string)
    Production status indicator
    Example: "IN_PROGRESS"

  - `lines.noProduce` (boolean)
    Indicates if the line should not be produced

  - `lines.noOrder` (boolean)
    Indicates if the line should not be ordered

  - `lines.cancelledQuantity` (number)
    Quantity that has been cancelled
    Example: 5

  - `lines.servedQuantity` (number)
    Quantity that has been served
    Example: 15

  - `lines.pendingQuantity` (number)
    Quantity that is still pending
    Example: 10

  - `lines.netAmountPending` (number)
    Net amount for pending quantity
    Example: 250

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

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

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

  - `lines.serviceDate` (string)
    Service date for this line
    Example: "2024-08-15"

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

  - `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.warehouse.population` (string)
    Population or city where the warehouse is located.
    Example: "Madrid"

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

  - `lines.brand` (object)
    Brand information

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

  - `lines.productionObservations` (object)
    Production observations

  - `lines.productionObservations.type` (string, required)
    Defines the observation types.
    Enum: "CLASSIFICATION", "PAYMENT_METHODS", "SHIPMENT", "PRODUCTION", "ORDERS", "BILLING", "DELIVERY_NOTE", "PACKING"

  - `lines.productionObservations.blockOrder` (boolean)

  - `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.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.totalLine` (number)
    Total line amount
    Example: 1500

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

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

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

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

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

  - `lines.manufacturer` (object)
    Manufacturer information

  - `lines.manufacturer.code` (integer, required)
    Supplier numeric code. Unique per company.
    Example: 20001

  - `lines.manufacturer.cif` (string, required)
    Tax identification code (CIF/NIF).
    Example: "B87654321"

  - `lines.manufacturer.commercialName` (string, required)
    Commercial name of the supplier.
    Example: "Supplier Corp"

  - `lines.manufacturer.name` (string)
    Legal name of the supplier.
    Example: "Supplier Corporation S.L."

  - `lines.manufacturer.address` (string)
    Postal address.
    Example: "Calle Mayor, 10"

  - `lines.manufacturer.country` (string)
    Country code.
    Example: "ES"

  - `lines.manufacturer.state` (string)
    State code.
    Example: "MAD"

  - `lines.manufacturer.postalCode` (string)
    Postal code.
    Example: 28001

  - `lines.manufacturer.city` (string)
    Supplier city.
    Example: "Madrid"

  - `lines.manufacturer.phone1` (string)
    First phone number.
    Example: "+34911222333"

  - `lines.manufacturer.phone2` (string)
    Second phone number.
    Example: "+34911444555"

  - `lines.manufacturer.currency` (string)
    Currency code.
    Example: "EUR"

  - `lines.manufacturer.currencyNomenclature` (string)
    Currency nomenclature.
    Example: "Euro"

  - `lines.manufacturer.currencyChangeValue` (number)
    Currency exchange rate value.
    Example: 1

  - `lines.manufacturer.active` (boolean)
    True if the supplier is active.
    Example: true

  - `lines.manufacturer.email` (string)
    Contact email address.
    Example: "contact@suppliercorp.com"

  - `lines.manufacturer.shippingTerm` (integer)
    Shipping term in days.
    Example: 15

  - `lines.manufacturer.tags` (array)
    List of supplier tags.
    Example: ["PREMIUM","INTERNATIONAL"]

  - `lines.manufacturer.vatDescription` (string)
    VAT type description.
    Example: "IVA General 21%"

  - `lines.manufacturer.discount1` (number)
    First discount rate (percentage).
    Example: 3.5

  - `lines.manufacturer.paymentMethodId` (integer)
    Payment method identifier.
    Example: 3

  - `lines.manufacturer.paymentMethod` (string)
    Payment method description.
    Example: "Bank Transfer"

  - `lines.manufacturer.currencyCode` (string)
    ISO currency code.
    Example: "EUR"

  - `lines.manufacturer.creationDate` (string)
    Date of supplier creation. Format: yyyy-MM-dd
    Example: "2021-03-15"

  - `lines.manufacturer.inactiveDate` (string)
    Date when supplier became inactive. Format: yyyy-MM-dd
    Example: "2024-10-01"

  - `lines.manufacturer.countryDescription` (string)
    Country full description.
    Example: "España"

  - `lines.manufacturer.stateDescription` (string)
    State full description.
    Example: "Madrid"

  - `lines.manufacturer.bankName` (string)
    Bank name for the supplier.
    Example: "BBVA"

  - `lines.manufacturer.account` (string)
    Bank account number.
    Example: "ES7921000813610123456789"

  - `lines.manufacturer.picture` (string)
    Picture or logo for the supplier.
    Example: "https://www.suppliercorp.com/logo.png"

  - `lines.manufacturer.pictureToken` (string)
    Token for accessing the picture.
    Example: "a1b2c3d4e5f6"

  - `lines.manufacturer.modifiedOn` (string)
    Last modification date and time. Format: yyyy-MM-dd'T'HH:mm:ssXXX
    Example: "2024-12-10T14:30:00+01:00"

  - `lines.manufacturer.web` (string)
    Supplier web site.
    Example: "https://www.suppliercorp.com"

  - `lines.claim` (boolean)
    Indicates if this line has a claim

  - `lines.hasOrderPacking` (boolean)
    Indicates if order packing exists
    Example: true

  - `lines.hasProductionOrder` (boolean)
    Indicates if production order exists

  - `lines.stockQuantity` (number)
    Available stock quantity
    Example: 100

  - `lines.specialPriceModified` (boolean)
    Indicates if special price was modified

  - `lines.jobDescription` (string)
    Job description for this line
    Example: "Custom manufacturing"

  - `lines.cancellationReason` (object)
    Cancellation reason information

  - `lines.cancellationReason.code` (string, required)
    Unique code for the cancellation reason
    Example: "CUST_REQ"

  - `lines.cancellationReason.description` (string)
    Description of the cancellation reason
    Example: "Customer Request"

  - `lines.cancellationDate` (string)
    Date when line was cancelled
    Example: "2024-08-10"

  - `lines.cancellationObservation` (string)
    Observation about the cancellation
    Example: "Product discontinued"

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

  - `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)
    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)
    Indicates if this is a corrective series.

  - `billingSeries.otherSIF` (boolean)
    Indicates if this series is for other SIF.

  - `serviceDate` (string)
    Service date
    Example: "2024-01-15"

  - `manufacturingDate` (string)
    Manufacturing date
    Example: "2024-01-10"

  - `season` (object)
    Season information

  - `season.isCurrent` (boolean)

  - `season.startDate` (string, required)

  - `season.endDate` (string, required)

  - `customerAddress` (object)
    Customer address information

  - `customerAddress.code` (integer, required)
    Address code (unique within the customer).
    Example: 101

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

  - `customerAddress.customerName` (string)
    Customer name.
    Example: "Acme S.A."

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

  - `customerAddress.customerVatTypeId` (integer)
    VAT Type Id for the customer.
    Example: 1

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

  - `customerAddress.customerEmail` (string)
    Email address of the customer.
    Example: "info@acme.es"

  - `customerAddress.name` (string)
    Name or label for the address.
    Example: "Headquarters"

  - `customerAddress.city` (string)
    City where the address is located.
    Example: "Alicante"

  - `customerAddress.stateId` (string)
    State identifier (string or code).
    Example: "A"

  - `customerAddress.state` (string)
    State for the address.
    Example: "Valencia"

  - `customerAddress.stateDescription` (string)
    State description.
    Example: "A full state description"

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

  - `customerAddress.countryId` (string)
    Country identifier (string or code).
    Example: "ES"

  - `customerAddress.country` (string)
    Country name or code.
    Example: "Spain"

  - `customerAddress.countryDescription` (string)
    Country description.
    Example: "España (Spain)"

  - `customerAddress.address` (string)
    Street or detailed address.
    Example: "Main Street, 22"

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

  - `customerAddress.cif` (string)
    CIF/NIF of the address (if available).
    Example: "B12345678"

  - `customerAddress.representative1` (string)
    First representative (string, name/code).
    Example: "John Smith"

  - `customerAddress.representative2` (string)
    Second representative.
    Example: "Mary Brown"

  - `customerAddress.representative3` (string)
    Third representative.
    Example: "Walter Doe"

  - `customerAddress.representative4` (string)
    Fourth representative.
    Example: "Ana White"

  - `customerAddress.representative5` (string)
    Fifth representative.
    Example: "Lucas Black"

  - `customerAddress.representative1Id` (integer)
    First representative ID.
    Example: 14

  - `customerAddress.representative2Id` (integer)
    Second representative ID.
    Example: 15

  - `customerAddress.representative3Id` (integer)
    Third representative ID.
    Example: 16

  - `customerAddress.representative4Id` (integer)
    Fourth representative ID.
    Example: 17

  - `customerAddress.representative5Id` (integer)
    Fifth representative ID.
    Example: 18

  - `customerAddress.activity` (string)
    Activity linked to the address.
    Example: "Wholesale"

  - `customerAddress.brand` (object)
    Brand object. See ApiBrandListReadDto.java for structure.

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

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

  - `customerAddress.classificationObservation` (object)
    Observation (classification). See ApiObservationListReadDto.java for structure.

  - `customerAddress.hasUnpaidReceipts` (boolean)
    True if customer has unpaid receipts for this address.

  - `customerAddress.defaultAddress` (boolean)
    True if this address is the default for the customer.

  - `customerAddress.shippingTermId` (integer)
    Shipping term identifier.
    Example: 1

  - `orderType` (object)
    Order type information

  - `orderType.noRiskAccumulation` (boolean)

  - `rateCode` (object)
    Exchange rate code information

  - `rateCode.taxesIncluded` (boolean)

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

  - `billingObservations` (string)
    Billing observations
    Example: "Special handling required"

  - `paymentMethod` (object)
    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)
    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)
    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"

  - `billingCompany` (object)
    Billing company information

  - `billingCompany.code` (string)
    Company code.
    Example: "C100"

  - `billingCompany.cif` (string)
    Tax identification code (CIF) of the company.
    Example: "B12345678"

  - `billingCompany.name` (string)
    Name of the company.
    Example: "Clavei S.L."

  - `billingCompany.phone1` (string)
    Indicates if this is the default company.
    Example: true

  - `billingCompany.logo` (string)

  - `billingCompany.logoToken` (string)

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

  - `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

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

  - `agency` (object)
    Agency information

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

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

  - `shippingTerm` (object)
    Shipping terms information

  - `shippingTerm.customerPays` (boolean)

  - `shippingTerm.intrastatCode` (string)

  - `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

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

  - `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

  - `noAccumulateWarehouse` (boolean)
    Flag indicating no warehouse accumulation

  - `cancelledQuantityTotal` (number)
    Total cancelled quantity
    Example: 5

  - `servedQuantityTotal` (number)
    Total served quantity
    Example: 20

  - `pendingQuantityTotal` (number)
    Total pending quantity
    Example: 10

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

  - `pendingAmountTotal` (number)
    Total pending amount
    Example: 500

  - `pendingAmountTotalCompanyCurrency` (number)
    Total pending amount in company currency
    Example: 500

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

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

  - `netAmountPendingTotal` (number)
    Total net amount pending
    Example: 500

  - `cmsOrderId` (integer)
    CMS id for order