Get purchase order item details

Get details for an item on a purchase order.

Required permissions: PURCHASE_ORDER

get

/tenants/{tenantUid}/stores/{storeUid}/purchase-orders/{purchaseOrderUid}/purchase-order-items/{purchaseOrderItemUid}

Authorizations

AuthorizationstringRequired

Access token recevied after user login with a deviceToken

Path parameters

storeUidstringRequired

Reference to a Store.

Pattern: ^[A-Za-z0-9-_]+

purchaseOrderUidstringRequired

Reference to a PurchaseOrder.

Pattern: ^[A-Za-z0-9-_]+

purchaseOrderItemUidstringRequired

Reference to an item on a purchase order

Pattern: ^[A-Za-z0-9-_]+

tenantUidstringRequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+

Responses

200

Example response

application/json

createdAtstring · date-timeRequired

createdBystringRequired

expectedDeliveryDatestring · dateRequired

externalIdstringRequired

lastModifiedAtstring · date-timeRequired

lastModifiedBystringRequired

productUidstringRequiredPattern: ^[A-Za-z0-9-_]+

productNamestringRequired

productSerialNoRequiredstring · enumRequired

ENUM	Description
NO	No Serial number required
ON_SALE	Can register serial number when selling a product (Serial number is optional)
ON_RECEIVE	Must register serial number when receiving and selling product (Serial number is required)

Possible values:

productSkustringRequired

purchaseOrderItemUidstringRequiredPattern: ^[A-Za-z0-9-_]+

quantityOrderedintegerRequired

quantityReceivedintegerRequired

quantityReservedintegerRequired

supplierSkustringRequired

unitPriceintegerRequired

unitPrice is in purchase price in order currency before discounts

discountAmountintegerRequired

The discount amount pr unit

freightAmountintegerRequired

The portion of the shipping cost pr unit.

unitCostintegerRequired

The price pr unit including discount and freight. This is what will be used as cost price during receivement.

totalLinePriceintegerRequired

Total price for all the items including discounts and freight amount.

notestringRequired

sortOrderintegerRequired

get/tenants/{tenantUid}/stores/{storeUid}/purchase-orders/{purchaseOrderUid}/purchase-order-items/{purchaseOrderItemUid}

GET /v2/tenants/{tenantUid}/stores/{storeUid}/purchase-orders/{purchaseOrderUid}/purchase-order-items/{purchaseOrderItemUid} HTTP/1.1
Host: api.flowretail.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200

Example response

{
  "createdAt": "2026-01-01T00:00:00.000Z",
  "createdBy": "text",
  "expectedDeliveryDate": "2026-01-01",
  "externalId": "text",
  "lastModifiedAt": "2026-01-01T00:00:00.000Z",
  "lastModifiedBy": "text",
  "productUid": "text",
  "productName": "text",
  "productSerialNoRequired": "NO",
  "productSku": "text",
  "purchaseOrderItemUid": "text",
  "quantityOrdered": 1,
  "quantityReceived": 1,
  "quantityReserved": 1,
  "supplierSku": "text",
  "interStoreSalesOrder": {
    "orderUid": "text",
    "orderNumber": "text",
    "orderState": "OPEN",
    "storeUid": "text",
    "storeName": "text",
    "orderItemUid": "text",
    "reservationType": "NONE",
    "reservationDetails": {
      "warehouse": {
        "warehouseName": "text"
      },
      "purchaseOrder": {
        "purchaseOrderUid": "text",
        "purchaseOrderItemUid": "text",
        "expectedDeliveryDate": "2026-01-01T00:00:00.000Z",
        "purchaseOrderNumber": "text",
        "quantityOrdered": 1,
        "externalId": "text"
      },
      "receivement": {
        "receivementUid": "text",
        "receivementItemUid": "text",
        "expectedArrival": "2026-01-01T00:00:00.000Z",
        "expectedDispatch": "2026-01-01T00:00:00.000Z",
        "quantity": 1,
        "supplierOrderReference": "text",
        "receivedAt": "2026-01-01T00:00:00.000Z"
      },
      "interStorePurchaseOrder": {
        "storeUid": "text",
        "storeName": "text",
        "purchaseOrderUid": "text",
        "purchaseOrderNumber": "text",
        "purchaseOrderItemUid": "text"
      },
      "interStorePurchaseOrderReceivement": {
        "receivementUid": "text",
        "receivementItemUid": "text",
        "expectedArrival": "2026-01-01T00:00:00.000Z",
        "expectedDispatch": "2026-01-01T00:00:00.000Z",
        "quantity": 1,
        "supplierOrderReference": "text",
        "receivedAt": "2026-01-01T00:00:00.000Z"
      }
    }
  },
  "unitPrice": 1,
  "receivementItems": [
    {
      "receivementUid": "text",
      "receivementStatus": "RECEIVED",
      "invoiceApproval": {
        "approvedAt": "2026-01-01T00:00:00.000Z",
        "tenantUserUid": "text",
        "tenantUserDisplayName": "text"
      },
      "createdAt": "2026-01-01T00:00:00.000Z",
      "createdBy": "text",
      "externalId": "text",
      "lastModifiedAt": "2026-01-01T00:00:00.000Z",
      "lastModifiedBy": "text",
      "product": {
        "productUid": "text",
        "name": "text",
        "sku": "text"
      },
      "purchaseOrderItemUid": "text",
      "quantity": 1,
      "unitCost": 1,
      "receivementItemUid": "text",
      "serialnumber": "text",
      "status": "text",
      "note": "text",
      "tenantUserUid": "text",
      "tenantUserDisplayName": "text",
      "reservations": [
        {
          "orderUid": "text",
          "orderItemUid": "text",
          "orderNumber": "text",
          "quantity": 1,
          "reservationType": "NONE"
        }
      ]
    }
  ],
  "discountAmount": 1,
  "freightAmount": 1,
  "unitCost": 1,
  "totalLinePrice": 1,
  "localCurrency": {
    "unitPrice": 1,
    "discountAmount": 1,
    "freightAmount": 1,
    "unitCost": 1,
    "totalLinePrice": 1
  },
  "reservations": [
    {
      "orderUid": "text",
      "orderItemUid": "text",
      "orderNumber": "text",
      "quantity": 1,
      "reservationType": "NONE"
    }
  ],
  "note": "text",
  "sortOrder": 1,
  "purchaseOrderItemLinks": [
    {
      "purchaseOrderItemUid": "text",
      "type": "PACKAGE"
    }
  ]
}