Back

Search

Search

Methods

Inventory

Orders

Orders /AddOrderItem

Response: UpdateOrderItemResult



Add an item to a specific order.
Line pricing is optional with the default values being
- PricePerUnit: Stock item retail price
- DiscountPercentage: 0
- TaxRatePercentage: Stock item tax rate.
- TaxInclusive: true

Parameters

NameTypeDescription
orderIdGuidOrder id
itemIdGuidItem id to be added
channelSKUStringChannel SKU of the item
fulfilmentCenterGuidCurrent fulfilment center
quantityInt32Item quantity
linePricingLinePricingRequestItem pricing data

HTTP Endpoint

Server /Orders / AddOrderItem

Permissions


Example Code

Example Request

The following request format is required for this method.

POST https://eu-ext.linnworks.net//api/Orders/AddOrderItem HTTP/1.1
Host: eu-ext.linnworks.net
Connection: keep-alive
Accept: application/json, text/javascript, */*; q=0.01
Origin: https://www.linnworks.net
Accept-Language: en
User-Agent: Mozilla/5.0 (Windows NT 6.1; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/42.0.2311.90 Safari/537.36
Content-Type: application/x-www-form-urlencoded; charset=UTF-8
Referer: https://www.linnworks.net/
Accept-Encoding: gzip, deflate
Authorization: INSERT_YOUR_TOKEN_HERE

orderId=12a41af0-91e3-404f-b501-e2c699f765e6&itemId=d14f3dc7-1aa3-4325-9441-0996dc266585&channelSKU=sample string 1&fulfilmentCenter=61b2eb78-abc4-41b9-b4f8-f08b587b57e6&quantity=1&linePricing={
  "PricePerUnit": 1.1,
  "DiscountPercentage": 2.1,
  "TaxRatePercentage": 3.1,
  "TaxInclusive": true
}

Response

This is an example response. Results may vary depending on your data.

{
  "TotalsInfo": {
    "Subtotal": 1.1,
    "PostageCost": 2.1,
    "Tax": 3.1,
    "TotalCharge": 4.1,
    "PaymentMethod": "sample string 5",
    "PaymentMethodId": "0dc4806e-dd3a-4163-8488-b6453d8e5f35",
    "ProfitMargin": 7.1,
    "TotalDiscount": 8.1,
    "Currency": "sample string 9",
    "CountryTaxRate": 10.1,
    "ConversionRate": 11.1
  },
  "Item": {
    "ItemId": "b2283d65-d756-4da8-b702-1eb5a95681ae",
    "ItemNumber": "sample string 2",
    "SKU": "sample string 3",
    "ItemSource": "sample string 4",
    "Title": "sample string 5",
    "Quantity": 6,
    "CategoryName": "sample string 8",
    "CompositeAvailablity": 1,
    "StockLevelsSpecified": true,
    "OnOrder": 10,
    "OnPurchaseOrder": {
      "pkPurchaseItemId": "a5aee9f4-ad7d-492b-8a2f-0553a62d5ebb",
      "Rowid": "e11ccebe-4692-4361-8593-dd7c88cff0f2",
      "pkPurchaseId": "cd997ffb-e568-4bd4-824e-fe45e3c831e3",
      "ExternalInvoiceNumber": "sample string 4",
      "fkSupplierId": "957279b8-2464-461d-aa7b-0a159df0026c",
      "DateOfDelivery": "2019-11-28T09:46:00.9380836+00:00",
      "QuotedDeliveryDate": "2019-11-28T09:46:00.9380836+00:00",
      "SupplierName": "sample string 8",
      "fkLocationId": "f6c4604e-0d9f-4fb3-b39d-e11c47485685"
    },
    "InOrderBook": 1,
    "Level": 11,
    "MinimumLevel": 1,
    "AvailableStock": 12,
    "PricePerUnit": 13.1,
    "UnitCost": 14.1,
    "DespatchStockUnitCost": 15.1,
    "Discount": 16.1,
    "Tax": 21.1,
    "TaxRate": 17.1,
    "Cost": 18.1,
    "CostIncTax": 19.1,
    "CompositeSubItems": [
      {
      },
      {
      }
    ],
    "IsService": true,
    "SalesTax": 21.1,
    "TaxCostInclusive": true,
    "PartShipped": true,
    "Weight": 24.1,
    "BarcodeNumber": "sample string 25",
    "Market": 26,
    "ChannelSKU": "sample string 27",
    "ChannelTitle": "sample string 28",
    "DiscountValue": 10.806660973526899,
    "HasImage": true,
    "ImageId": "239a3918-6aff-41a2-af49-7323826ec208",
    "AdditionalInfo": [
      {
        "pkOptionId": "fbcdae2b-04d8-44f6-84d0-89a9f51b5574",
        "Property": "sample string 2",
        "Value": "sample string 3"
      },
      {
      }
    ],
    "StockLevelIndicator": 29,
    "BatchNumberScanRequired": true,
    "SerialNumberScanRequired": true,
    "BinRack": "sample string 32",
    "BinRacks": [
      {
        "Quantity": 1,
        "BinRack": "sample string 2",
        "Location": "1a7c2481-2c65-469f-bfd6-ce35bcbd7009",
        "BatchId": 1,
        "OrderItemBatchId": 1
      },
      {
      }
    ],
    "InventoryTrackingType": 33,
    "isBatchedStockItem": false,
    "IsWarehouseManaged": true,
    "HasPurchaseOrders": true,
    "CanPurchaseOrderFulfil": true,
    "IsUnlinked": false,
    "RowId": "b7b8dd00-4b5d-44d2-93ce-eed8099001c6",
    "OrderId": "066925a4-06d3-4fc4-a3f7-045e12ce9d90",
    "StockItemId": "560cf9bd-71c4-4288-9104-be27269ee47b"
  },
  "ItemWeight": 1.1,
  "TotalWeight": 2.1
}