Back

Search

Search

Methods

Inventory

Orders

PurchaseOrder /Add_PurchaseOrderItem

Response: Update_PurchaseOrderItemResponse



Method adds purchase order item to an existing PENDING order. Items can only be added to PENDING purchase orders. Returns class that represents modified/recalculated purchase order header and modified purchase order item line

Parameters

NameTypeDescription
addItemParameterAdd_PurchaseOrderItemParameterAdd purchase item parameter class

HTTP Endpoint

Server /PurchaseOrder / Add_PurchaseOrderItem

Permissions

GlobalPermissions.PurchaseOrder.EditPurchaseOrderNode

Example Code

Example Request

The following request format is required for this method.

POST https://eu-ext.linnworks.net//api/PurchaseOrder/Add_PurchaseOrderItem 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

addItemParameter={
  "pkPurchaseId": "0aece5a5-0a09-469e-86fc-38975e763fb6",
  "fkStockItemId": "5932b1cf-0b3d-4b38-a98b-68040f795d64",
  "Qty": 3,
  "PackQuantity": 4,
  "PackSize": 5,
  "Cost": 1.0,
  "TaxRate": 2.0
}

Response

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

{
  "NewPurchaseOrderItem": {
    "pkPurchaseItemId": "84bb9f35-89c2-4b07-a061-c089b8c1bfd8",
    "fkStockItemId": "275495e4-1e1f-4dd8-a2e6-e7cb1c62c2f9",
    "Quantity": 3,
    "Cost": 4.0,
    "Delivered": 5,
    "TaxRate": 6.0,
    "Tax": 7.0,
    "PackQuantity": 8,
    "PackSize": 9,
    "SKU": "sample string 10",
    "ItemTitle": "sample string 11",
    "InventoryTrackingType": 12,
    "IsDeleted": true,
    "SortOrder": 14,
    "DimHeight": 15.0,
    "DimWidth": 16.0,
    "DimDepth": 17.0,
    "BoundToOpenOrdersItems": 18,
    "BinRack": "sample string 19",
    "QuantityBoundToOpenOrdersItems": 20,
    "SupplierCode": "sample string 22"
  },
  "PurchaseOrderHeader": {
    "pkPurchaseID": "d7922033-231b-4cad-9398-e3e8d4f2bc9b",
    "fkSupplierId": "3a3fc339-ba36-4f55-b031-854925b3a0e2",
    "fkLocationId": "c3d8b5c1-1f04-4ffb-8c39-edcccfa72fcb",
    "ExternalInvoiceNumber": "sample string 4",
    "Status": 0,
    "Currency": "sample string 5",
    "SupplierReferenceNumber": "sample string 6",
    "Locked": true,
    "LineCount": 8,
    "DeliveredLinesCount": 9,
    "UnitAmountTaxIncludedType": 10,
    "DateOfPurchase": "2019-11-28T09:46:00.3274027Z",
    "DateOfDelivery": "2019-11-28T09:46:00.3274027Z",
    "QuotedDeliveryDate": "2019-11-28T09:46:00.3274027Z",
    "PostagePaid": 4.0,
    "TotalCost": 5.0,
    "taxPaid": 6.0,
    "ShippingTaxRate": 7.0,
    "ConversionRate": 8.0,
    "ConvertedShippingCost": 9.0,
    "ConvertedShippingTax": 10.0,
    "ConvertedOtherCost": 11.0,
    "ConvertedOtherTax": 12.0,
    "ConvertedGrandTotal": 13.0
  },
  "BatchInventoryId": 1
}