Skip to main content
Skip to main content

Purchase Order Line Export

What the Purchase Order Line export contains and the meaning of each field.

Overview

The Purchase Order Line export contains the individual lines of purchase orders that have been sent to you by your customers. Each row represents one purchase order line addressed to your supplier team, including the ordered item, quantities, pricing, delivery and shipping addresses, and the status of the parent purchase order.

Use this export for order fulfilment, delivery planning, and reconciling purchase order lines against your own order management or ERP systems.

Generating the Export

Navigate to Settings → Files → Exports and create a new export with the type Purchase Order Line.

You can optionally set a row limit to cap the size of the export.

Fields

The export includes Client Id, Client Name, Store Id and Store Name because it is generated for your supplier team. The same export requested by a client for a specific store contains Supplier Id and Supplier Name in their place.

ColumnDescription
Header LinkIdentifier of the purchase order this line belongs to.
Human Po IdentifierHuman-readable purchase order number of the parent purchase order.
Unique Line Primary KeyUnique identifier of the purchase order line.
Line Reference On PoLine reference (line number) of this line within the purchase order.
Item Polymorphic TypeType of the record the ordered item refers to.
Item IdIdentifier of the ordered item record.
Ordered QtyQuantity ordered on this line.
Price Per UnitPrice per unit, as a decimal in the currency shown in Currency Code.
Tax Total Per LineTotal tax amount for the line, as a decimal in the currency shown in Currency Code.
Line Grand TotalTotal price of the line including tax, as a decimal in the currency shown in Currency Code.
Currency CodeCurrency code of the line's monetary values.
Requested DeliveryDate and time the customer requested delivery by (ISO 8601), or empty if not set.
Upstream Order Reference Identifier of the order the parent purchase order was created from.
Client IdIdentifier of the customer (client) the purchase order line came from.
Client NameName of the customer (client) the purchase order line came from.
Store IdIdentifier of the store the purchase order line was placed through.
Store NameName of the store the purchase order line was placed through.
Cross-Po LinkIdentifier of a related purchase order this line is linked to, if any.
External Line Item IdExternal line item identifier for the line, if any.
Deliver To Address NameName on the deliver-to address.
Deliver To Address Line OneFirst line of the deliver-to address.
Deliver To Address Line TwoSecond line of the deliver-to address.
Deliver To Address CityCity of the deliver-to address.
Deliver To Address ProvinceProvince or state of the deliver-to address.
Deliver To Address Postal CodePostal code of the deliver-to address.
Deliver To Address Country CodeCountry code of the deliver-to address.
Ship To Address NameName on the ship-to address.
Ship To Address Line OneFirst line of the ship-to address.
Ship To Address Line TwoSecond line of the ship-to address.
Ship To Address CityCity of the ship-to address.
Ship To Address ProvinceProvince or state of the ship-to address.
Ship To Address Postal CodePostal code of the ship-to address.
Ship To Address Country CodeCountry code of the ship-to address.
Ship From Address NameName on the ship-from address.
Ship From Address Line OneFirst line of the ship-from address.
Ship From Address Line TwoSecond line of the ship-from address.
Ship From Address CityCity of the ship-from address.
Ship From Address ProvinceProvince or state of the ship-from address.
Ship From Address Postal CodePostal code of the ship-from address.
Ship From Address Country CodeCountry code of the ship-from address.
Convenience NameName of the ordered item, taken from the line's item details.
Convenience DescriptionDescription of the ordered item, taken from the line's item details.
Free-Form MetadataAdditional free-form data stored against the line, as a JSON object.
Item Details PayloadFull details of the ordered item, as a JSON object.
Header StatusStatus of the parent purchase order. One of draft, sent, acknowledged, confirmed, invoiced, rejected, cancelled.
Line Created TimestampDate and time when the line was created (ISO 8601).
Line Updated TimestampDate and time when the line was last updated (ISO 8601).