Creates a new purchase order

Request Information

URI Parameters :

None.

Body Parameters :

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

jobs_reference_back_office

Embedded entity "jobs" using ERP PK when adding/updating

string

Optionally required : jobs_id, jobs_reference_back_office or jobs must be provided

jobs

Embedded entity "jobs" using ERP PK when adding/updating

jobs

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_company_code

Embedded entity "company" for the supplier using ERP PK when adding/updating

string
supplier_company

Embedded entity "company" for supplier using ERP PK when adding/updating

company
user_id

Creator of the purchase order

globally unique identifier
user_code

Embedded entity "user" for creator using ERP PK when adding/updating purchase_order

string
user

Embedded entity "user" for creator using node when adding/updating purchase_order

user
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
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
approved_by_user_code

Embedded entity "user" for approver using ERP PK when adding/updating purchase_order

string
approved_by_user

Embedded entity "user" for approver using node when adding/updating purchase_order

user
technical_user_id

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

globally unique identifier
technical_user_code

Embedded entity "user" for technical user using ERP PK when adding/updating purchase_order

string
technical_user

Embedded entity "user" for technical user using node when adding/updating purchase_order

user
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

purchase_order_status_code

Foreign key to purchase_order_status using code. Use "Approved","SentToSupplier","Cancelled" or "Delivered"

string

Optionally required : purchase_order_status_id or purchase_order_status_code must be provided

article_stock_location_id

Stock location that will receive the articles

globally unique identifier
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

Request Formats :

application/json, text/json

Sample:
{
  "id": "97b420ee-1434-4837-a7d4-33214f1b7827",
  "id2": 2,
  "jobs_id": "f9d3dfbe-deee-483e-9af4-0d204997e10d",
  "jobs_reference_back_office": "sample string 4",
  "supplier_company_id": "c2b56fe3-5228-43aa-95df-2b6cf5415c5c",
  "supplier_company_code": "sample string 6",
  "user_id": "27b643d9-23c3-40d2-8a8c-a6faf31ec9ee",
  "user_code": "sample string 8",
  "description": "sample string 9",
  "memo": "sample string 10",
  "total_lines": 11,
  "date_create": "2025-09-14T07:34:09.8475914+00:00",
  "date_update": "2025-09-14T07:34:09.8475914+00:00",
  "date_delivery": "2025-09-14T07:34:09.8475914+00:00",
  "confirmed_date_delivery": "2025-09-14T07:34:09.8475914+00:00",
  "delivery_db_address_id": "a0553bf3-ee61-4b0b-9ce8-5185b08541f1",
  "approved_by_user_id": "71219d79-c65c-493c-afa1-94ddd2c427f4",
  "approved_by_user_code": "sample string 18",
  "technical_user_id": "3ca0ec6e-cf61-4fe9-865d-7456a9888535",
  "technical_user_code": "sample string 20",
  "purchase_order_status_id": "40ed5cb1-4e33-4ef3-9b95-fd9f97d2dd87",
  "purchase_order_status_code": "sample string 22",
  "article_stock_location_id": "2aa006f0-bd1a-4ac4-94fa-faf81d87ea19",
  "is_pickup": true,
  "reference_back_office": "sample string 25",
  "modified_dateutc": "2025-09-14T07:34:09.8788394+00:00"
}

Response Information

Resource Description :

IHttpActionResult

None.

Response Formats

application/json, text/json

Sample:

Sample not available.