Retrieves all purchase orders, optionally filtered via OData query options.

Request Information

URI Parameters :

None.

Body Parameters :

None.

Response Information

Resource Description :

IHttpActionResult containing the list of purchase orders.

purchase_order
NameDescriptionTypeAdditional information
id

Primary Key

globally unique identifier
id2

Internal ID (numeric) automatically filled if empty

integer
jobs_id

Foreign key to Jobs

globally unique identifier

Optionally required : jobs_id, jobs_reference_back_office or jobs must be provided

supplier_company_id

Foreign key to company, contains the supplier

globally unique identifier
supplier_contact_id

Foreign key of the contact at the supplier company to reach about this purchase order.

globally unique identifier
user_id

Creator of the purchase order

globally unique identifier
description

Description of the purchase order

string

Max length: 4000

memo

Memo, remark

string
total_lines

Number of lines, automatically filled when adding/updating/deleting lines

integer
reference

Free-text reference for this purchase order (e.g. the supplier's order confirmation number).

string
date_create

Creation date

date
date_update

Last update date

date
date_delivery

Estimated date of delivery

date
confirmed_date_delivery

Date of the delivery

date
delivery_db_address_id

If Delivery and no picking, AddressID of the company (if not the main)

globally unique identifier
approved_by_user_id

If approval was needed, which user approves it

globally unique identifier
technical_user_id

User to contact if case of technical question about the purchase order

globally unique identifier
sent_by_email

Indicates this purchase order has been sent to the supplier by email.

boolean
sent_by_xml

Indicates this purchase order has been sent to the supplier via XML/EDI integration.

boolean
purchase_order_status_id

Foreign key to purchase_order_status

globally unique identifier

Optionally required : purchase_order_status_id or purchase_order_status_code must be provided

po_status

Display text of the purchase order status (denormalized copy of the status referenced by ).

string
article_stock_location_id

Stock location that will receive the articles

globally unique identifier
webshop_reference

Reference/order number from the supplier's webshop, when the purchase order was placed through one.

string
is_pickup

If pickup, the technician will go himself to the supplier to take the goods

boolean
reference_back_office

Field used for Embedded entity (store there your ERP PK)

string

Max length: 50

modified_dateutc

Readonly system field managed by database, filled with GetUtcDate when adding,updating

date

Response Formats

application/json, text/json

Sample:
{
  "id": "143e1bcf-b65f-4294-821b-f378b18f0d8f",
  "id2": 2,
  "jobs_id": "db53e463-2231-4eea-8772-53b6759e7cb2",
  "supplier_company_id": "e3118a6a-a83f-46de-9e78-3e12c252d07d",
  "supplier_contact_id": "dc831477-cd1a-4a3b-9316-a909f13241f1",
  "user_id": "94238d9c-54cd-4080-b1b5-b9cdb158e7bc",
  "description": "sample string 7",
  "memo": "sample string 8",
  "total_lines": 9,
  "reference": "sample string 10",
  "date_create": "2026-09-16T08:34:35.6359018+00:00",
  "date_update": "2026-09-16T08:34:35.6359018+00:00",
  "date_delivery": "2026-09-16T08:34:35.6359018+00:00",
  "confirmed_date_delivery": "2026-09-16T08:34:35.6359018+00:00",
  "delivery_db_address_id": "0856422d-137b-4ac6-a649-b0e480c9e645",
  "approved_by_user_id": "44859349-fa4c-4f2c-ab77-01f8fc93b071",
  "technical_user_id": "c7343eab-7e35-44ea-a5e4-7c51e3480090",
  "sent_by_email": true,
  "sent_by_xml": true,
  "purchase_order_status_id": "9dfe6f74-2af4-4ec5-b704-44ad93ad4026",
  "po_status": "sample string 21",
  "article_stock_location_id": "f1f2a742-bccc-49a8-8dc3-200c7ecdbc3f",
  "webshop_reference": "sample string 23",
  "is_pickup": true,
  "reference_back_office": "sample string 25",
  "modified_dateutc": "2026-09-16T08:34:35.6359018+00:00"
}

application/xml, text/xml

Sample:
<purchase_order xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
  <approved_by_user_id>44859349-fa4c-4f2c-ab77-01f8fc93b071</approved_by_user_id>
  <article_stock_location_id>f1f2a742-bccc-49a8-8dc3-200c7ecdbc3f</article_stock_location_id>
  <confirmed_date_delivery>2026-09-16T08:34:35.635Z</confirmed_date_delivery>
  <date_create>2026-09-16T08:34:35.635Z</date_create>
  <date_delivery>2026-09-16T08:34:35.635Z</date_delivery>
  <date_update>2026-09-16T08:34:35.635Z</date_update>
  <delivery_db_address_id>0856422d-137b-4ac6-a649-b0e480c9e645</delivery_db_address_id>
  <description>sample string 7</description>
  <id>143e1bcf-b65f-4294-821b-f378b18f0d8f</id>
  <id2>2</id2>
  <is_pickup>true</is_pickup>
  <jobs_id>db53e463-2231-4eea-8772-53b6759e7cb2</jobs_id>
  <memo>sample string 8</memo>
  <modified_dateutc>2026-09-16T08:34:35.635Z</modified_dateutc>
  <po_status>sample string 21</po_status>
  <purchase_order_status_id>9dfe6f74-2af4-4ec5-b704-44ad93ad4026</purchase_order_status_id>
  <reference>sample string 10</reference>
  <reference_back_office>sample string 25</reference_back_office>
  <sent_by_email>true</sent_by_email>
  <sent_by_xml>true</sent_by_xml>
  <supplier_company_id>e3118a6a-a83f-46de-9e78-3e12c252d07d</supplier_company_id>
  <supplier_contact_id>dc831477-cd1a-4a3b-9316-a909f13241f1</supplier_contact_id>
  <technical_user_id>c7343eab-7e35-44ea-a5e4-7c51e3480090</technical_user_id>
  <total_lines>9</total_lines>
  <user_id>94238d9c-54cd-4080-b1b5-b9cdb158e7bc</user_id>
  <webshop_reference>sample string 23</webshop_reference>
</purchase_order>