---
title: "Create_PurchaseOrder_Initial"
method: POST
path: "/api/PurchaseOrder/Create_PurchaseOrder_Initial"
tags: ["PurchaseOrder"]
---

# Create_PurchaseOrder_Initial

`POST /api/PurchaseOrder/Create_PurchaseOrder_Initial`

Creates initial purchase order in pending status. Once PO is created you can add stock items to it.
<b>Permissions Required: </b> GlobalPermissions.Inventory.PurchaseOrder.EditPurchaseOrderNode
<b>Rate limit: </b><span style="background-color:#0272d9;color:white;padding:4px 8px;text-align:center;border-radius:5px; font-size: small;"><b>150</b></span> / minute

## Request body

- PurchaseOrderCreatePurchaseOrderInitialRequest
  - `createParameters` CreatePurchaseOrderInitialParameter — Class that represents entry parameters for creating new PENDING purchase order
    - `fkSupplierId` string, uuid — Supplier unique identifier. Use Inventory/GetSupplierList to get the supplier ids
    - `fkLocationId` string, uuid — Location id where the PO will be delivered to. Use Inventory/GetStockLocations to get the location ids
    - `ExternalInvoiceNumber` string — Purchase order reference
    - `Currency` string — Currency of the purchase order
    - `SupplierReferenceNumber` string — Supplier purchase order reference number
    - `UnitAmountTaxIncludedType` integer — Unit amount includes,excludes or no tax. 0 - Excludes Tax, 1 - Includes tax, 2 - No Tax
    - `DateOfPurchase` string, date-time — DateTime of the purchase order
    - `QuotedDeliveryDate` string, date-time — DateTime of the expected delivery date.
    - `PostagePaid` number, double — **DEPRECIATED** Use additional costs with Shipping flag to record shipping costs. This field remains available in the API for backward compatibility and acts pretty much like an additional cost item with type
    - `ShippingTaxRate` number, double — **DEPRECIATED** Use additional costs with Shipping flag to record shipping costs. This field remains available in the API for backward compatibility and acts pretty much like an additional cost item with type
    - `ConversionRate` number, double — Currency conversion rate, multiplier to change the purchase order currency into the system currecny

## Response `200`

OK

- string, uuid

---

[API](https://skmtc.net/linnworks/apis/authenticate-api.md) · [All operations](https://skmtc.net/linnworks/apis/authenticate-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/linnworks/authenticate-api/versions/0123569a22fb/schema)