Add

[POST] .../v1/orderfrompartneroperation/add

Adds item lines to a customer order document. Add one or more requested item lines to a DocOrderFromPartner customer order before the order is converted into a wholesale shipment. The request body is a JSON array batch; every operation must contain document_id, item_id, positive quantity up to 999999999, discounted price from 0 to 99999999999, non-negative price2, optional vat_value and optional description up to 300 characters and all array items must reference the same document_id. The parent DocOrderFromPartner must be locked by the current user and eligible for editing and the item must be an active non-compound leaf item; null, empty or oversized arrays, invalid values, mixed document_ids, denied access or document/item state conflicts are returned as HTTP 200 ErrorResult.

Request Parameters

Name Type Required Description
description String Optional Operation note. Maximum length is 300 characters.
document_id Int64 Required Order-from-partner document ID.
item_id Int64 Required Item ID.
order Int64 Optional Operation order inside the document. Null means not set and is stored as NULL in the database. Ignored for database versions earlier than 407.
price Decimal Required Discounted item price. Required; zero is allowed, negative values are rejected and the value must be no greater than 99999999999.
price2 Decimal Required Original item price before discount. Required; zero is allowed and negative values are rejected.
quantity Decimal Required Ordered item quantity. Must be greater than zero and no greater than 999999999.
vat_value Decimal Optional VAT rate value. If omitted, the API uses the item's VAT value; use -1 for no VAT.

Request Example

[
  {
    "document_id": 4601,
    "item_id": 1001,
    "quantity": 12,
    "price": 15,
    "price2": 18,
    "vat_value": 12,
    "description": "Customer order line"
  }
]

Response Parameters

Name Type Description
ok Boolean Indicates whether the request completed successfully.
result Update Update operation result.

Response Example

{
  "ok": true,
  "result": {
    "row_affected": 1,
    "ids": [
      8501
    ]
  }
}