POLINE: Purchase Order Line
The POLINE entity represents a line item on a purchase order, tracking a single component with quantity, pricing, and delivery progress.
Default definition. This article describes the default
POLINE definition shipped with DemandFlow. Administrators can add, remove, rename, or re-type fields, change which ones are required, and alter the layout from the Definitions screen in Settings. Your tenant's current schema may differ from what is shown here. To read the current definition at any time, GET the DEFINITION object whose id matches POLINE.Entity properties
| Property | Value |
|---|---|
| Entity code | POLINE |
| Display name | Purchase Order Line |
| Plural | Purchase Order Lines |
| Level | 800 |
Use cases
POLINE is a child entity of PO at level 800. The General panel uses a 33/33/34 three-column layout: left column for line item identification (name, description, COMP component objectLookup, part number); middle column for pricing (quantity, unit price with currency, readonly line total calculated as qty x unit price); right column for delivery tracking (status as Open/Partially Delivered/Fully Delivered/Cancelled with default open, readonly delivered qty updated via IDN goods receipt, required date, and notes).
Fields
General
| Field | Type | Required | Notes |
|---|---|---|---|
name | text | Yes | Name. |
description | text (multi-line) | Description. | |
componentId | reference → COMP | Yes | Component. |
partNo | text | Part Number. | |
bomId | reference → BOM | BOM. | |
perServerQty | number | Quantity of this component per server. Read-only. | |
isBomItem | boolean | Whether this line item is part of the server BOM. | |
qty | number | Yes | Quantity. |
unitPrice | number | Unit Price. | |
lineTotal | number | Quantity x Unit Price. Read-only. | |
status | enum | Status. Valid ids: open (Open), partiallyDelivered (Partially Delivered), fullyDelivered (Fully Delivered), cancelled (Cancelled). | |
deliveredQty | number | Updated when goods are received via IDN. Read-only. | |
requiredDate | date | Required Date. | |
notes | text (multi-line) | Notes. |
Relationships
- Lookups:
componentIdpoints atCOMPrecord;bomIdpoints atBOMrecord.
Creating a Purchase Order Line via the API
POST /v1/objects
Authorization: Bearer <your-pat>
Content-Type: application/json
{
"entity": "POLINE",
"level": 800,
"comboKey": "SUB:<your-sub-id>|ENT:",
"name": "Example",
"componentId": "",
"qty": 100,
"description": "Long description text."
} Listing POLINE records
# All purchase order lines in your tenant
GET /v1/entities/POLINE/SUB