Create order
Create a new order with line items
POST
/
admin
/
api
/
v1
/
sales
/
orders
Create order
curl --request POST \
--url https://erp.arukz.com/admin/api/v1/sales/orders \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"partner_id": 1,
"payment_term_id": 1,
"date_order": "2026-02-18",
"lines": [
{
"product_id": 10,
"product_qty": 2,
"product_uom_id": 1,
"price_unit": 120.5,
"discount": 5,
"customer_lead": 0,
"product_packaging_id": null,
"product_packaging_qty": 0,
"taxes": [
1,
2
]
}
]
}
'import requests
url = "https://erp.arukz.com/admin/api/v1/sales/orders"
payload = {
"partner_id": 1,
"payment_term_id": 1,
"date_order": "2026-02-18",
"lines": [
{
"product_id": 10,
"product_qty": 2,
"product_uom_id": 1,
"price_unit": 120.5,
"discount": 5,
"customer_lead": 0,
"product_packaging_id": None,
"product_packaging_qty": 0,
"taxes": [1, 2]
}
]
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
partner_id: 1,
payment_term_id: 1,
date_order: '2026-02-18',
lines: [
{
product_id: 10,
product_qty: 2,
product_uom_id: 1,
price_unit: 120.5,
discount: 5,
customer_lead: 0,
product_packaging_id: null,
product_packaging_qty: 0,
taxes: [1, 2]
}
]
})
};
fetch('https://erp.arukz.com/admin/api/v1/sales/orders', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://erp.arukz.com/admin/api/v1/sales/orders",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'partner_id' => 1,
'payment_term_id' => 1,
'date_order' => '2026-02-18',
'lines' => [
[
'product_id' => 10,
'product_qty' => 2,
'product_uom_id' => 1,
'price_unit' => 120.5,
'discount' => 5,
'customer_lead' => 0,
'product_packaging_id' => null,
'product_packaging_qty' => 0,
'taxes' => [
1,
2
]
]
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}{
"data": {
"id": 1,
"name": "SO/1",
"state": "sale",
"invoice_status": "invoiced",
"client_order_ref": null,
"origin": null,
"reference": null,
"date_order": "2026-01-07",
"validity_date": "2026-02-06",
"commitment_date": null,
"currency_rate": 0,
"amount_untaxed": 2440,
"amount_tax": 366,
"amount_total": 2806,
"locked": true,
"require_signature": false,
"require_payment": false,
"signed_by": null,
"signed_on": null,
"prepayment_percent": 0,
"note": "<p></p>",
"access_token": null,
"partner_id": 33,
"partner_invoice_id": 33,
"partner_shipping_id": 33,
"user_id": 1,
"team_id": null,
"company_id": 1,
"currency_id": 1,
"payment_term_id": 2,
"fiscal_position_id": null,
"journal_id": null,
"campaign_id": null,
"utm_source_id": null,
"medium_id": null,
"warehouse_id": 5,
"created_at": "2026-01-07T11:12:56+00:00",
"updated_at": "2026-01-08T12:59:31+00:00",
"deleted_at": null,
"partner": {
"id": 33,
"account_type": "individual",
"sub_type": "customer",
"name": "Lyle Holman",
"email": "lyle@example.com",
"phone": "12121221212",
"mobile": "1212121215294",
"avatar": null,
"avatar_url": null,
"job_title": "Itaque ratione dicta tenetur omnis reiciendis quidem consequatur",
"website": "https://www.zecikapuleze.mobi",
"tax_id": "Esse dolorum quo vel animi fugiat ipsum dicta et",
"company_registry": "TEST COMPANY",
"reference": "Ea aliquid debitis m",
"is_active": true,
"color": null,
"street1": "Street 69",
"street2": "Reprehenderit eos saepe deserunt ut eu ea aliquam magnam saepe reprehenderit cum alias dicta amet ducimus saepe excepturi facere qui",
"city": "California",
"zip": "90006",
"country_id": 233,
"state_id": 13,
"parent_id": 18,
"title_id": 1,
"company_id": null,
"industry_id": null,
"user_id": 2,
"creator_id": null,
"created_at": "2025-04-10T10:45:51.000000Z",
"updated_at": "2025-12-09T11:12:13.000000Z",
"deleted_at": null,
"country": {
"id": 233,
"name": "United States",
"code": "US",
"phone_code": "1",
"state_required": true,
"zip_required": true,
"currency_id": 1,
"created_at": "2025-04-07T12:34:34.000000Z",
"updated_at": "2025-04-07T12:34:34.000000Z"
},
"state": {
"id": 13,
"name": "California",
"code": "CA",
"country_id": 233,
"created_at": "2025-04-07T12:34:34.000000Z",
"updated_at": "2025-04-07T12:34:34.000000Z"
}
},
"lines": [
{
"id": 1,
"sort": 1,
"name": "Big Vision 4K Action Camera - Fisheye Lens",
"display_type": null,
"product_uom_qty": 5,
"product_qty": 5,
"qty_delivered": 5,
"qty_invoiced": 5,
"qty_to_invoice": 0,
"product_packaging_qty": 0.5,
"price_unit": 210,
"technical_price_unit": 210,
"discount": 0,
"price_subtotal": 1050,
"price_tax": 157.5,
"price_total": 1207.5,
"price_reduce_taxexcl": 210,
"price_reduce_taxinc": 241.5,
"purchase_price": 100,
"margin": 0,
"margin_percent": 0,
"untaxed_amount_invoiced": 0,
"untaxed_amount_to_invoice": 1050,
"state": "sale",
"invoice_status": "invoiced",
"qty_delivered_method": "stock_move",
"virtual_id": null,
"linked_virtual_id": null,
"is_downpayment": false,
"is_expense": false,
"customer_lead": 0,
"analytic_distribution": null,
"order_id": 1,
"product_id": 2,
"linked_sale_order_sale_id": null,
"product_uom_id": 1,
"product_packaging_id": 1,
"currency_id": 1,
"order_partner_id": 33,
"salesman_id": 1,
"warehouse_id": 5,
"route_id": null,
"company_id": 1,
"created_at": "2026-01-07T11:12:56+00:00",
"updated_at": "2026-01-08T12:59:31+00:00"
},
{
"id": 2,
"sort": 2,
"name": "Bass Blaze Waterproof Bluetooth Speaker - Blue",
"display_type": null,
"product_uom_qty": 4,
"product_qty": 4,
"qty_delivered": 4,
"qty_invoiced": 4,
"qty_to_invoice": 0,
"product_packaging_qty": 0.2,
"price_unit": 60,
"technical_price_unit": 60,
"discount": 0,
"price_subtotal": 240,
"price_tax": 36,
"price_total": 276,
"price_reduce_taxexcl": 60,
"price_reduce_taxinc": 69,
"purchase_price": 45,
"margin": 0,
"margin_percent": 0,
"untaxed_amount_invoiced": 0,
"untaxed_amount_to_invoice": 240,
"state": "sale",
"invoice_status": "invoiced",
"qty_delivered_method": "stock_move",
"virtual_id": null,
"linked_virtual_id": null,
"is_downpayment": false,
"is_expense": false,
"customer_lead": 0,
"analytic_distribution": null,
"order_id": 1,
"product_id": 12,
"linked_sale_order_sale_id": null,
"product_uom_id": 1,
"product_packaging_id": 2,
"currency_id": 1,
"order_partner_id": 33,
"salesman_id": 1,
"warehouse_id": 5,
"route_id": null,
"company_id": 1,
"created_at": "2026-01-07T11:12:56+00:00",
"updated_at": "2026-01-08T12:59:31+00:00"
},
{
"id": 3,
"sort": 3,
"name": "Flim Rocket Mini Projector - Telecentric Lens",
"display_type": null,
"product_uom_qty": 5,
"product_qty": 5,
"qty_delivered": 5,
"qty_invoiced": 5,
"qty_to_invoice": 0,
"product_packaging_qty": 0.5,
"price_unit": 230,
"technical_price_unit": 230,
"discount": 0,
"price_subtotal": 1150,
"price_tax": 172.5,
"price_total": 1322.5,
"price_reduce_taxexcl": 230,
"price_reduce_taxinc": 264.5,
"purchase_price": 120,
"margin": 0,
"margin_percent": 0,
"untaxed_amount_invoiced": 0,
"untaxed_amount_to_invoice": 1150,
"state": "sale",
"invoice_status": "invoiced",
"qty_delivered_method": "stock_move",
"virtual_id": null,
"linked_virtual_id": null,
"is_downpayment": false,
"is_expense": false,
"customer_lead": 0,
"analytic_distribution": null,
"order_id": 1,
"product_id": 8,
"linked_sale_order_sale_id": null,
"product_uom_id": 1,
"product_packaging_id": 1,
"currency_id": 1,
"order_partner_id": 33,
"salesman_id": 1,
"warehouse_id": 5,
"route_id": null,
"company_id": 1,
"created_at": "2026-01-07T11:12:56+00:00",
"updated_at": "2026-01-08T12:59:31+00:00"
}
]
},
"message": "Order created successfully."
}{
"message": "Unauthenticated."
}{
"message": "The given data was invalid.",
"errors": {
"partner_id": [
"The partner id field is required."
],
"lines": [
"The lines field is required."
]
}
}Authorizations
An API token from Sign in, sent as Authorization: Bearer <token>. Tokens last 30 days.
Body
application/json
Array of order line items with writable fields from the quotation form. Must have at least 1 items.
Show child attributes
Show child attributes
Example:
[ { "product_id": 10, "product_qty": 2, "product_uom_id": 1, "price_unit": 120.5, "discount": 5, "customer_lead": 0, "product_packaging_id": null, "product_packaging_qty": 0, "taxes": [1, 2] } ]
Response
Created
⌘I
Create order
curl --request POST \
--url https://erp.arukz.com/admin/api/v1/sales/orders \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"partner_id": 1,
"payment_term_id": 1,
"date_order": "2026-02-18",
"lines": [
{
"product_id": 10,
"product_qty": 2,
"product_uom_id": 1,
"price_unit": 120.5,
"discount": 5,
"customer_lead": 0,
"product_packaging_id": null,
"product_packaging_qty": 0,
"taxes": [
1,
2
]
}
]
}
'import requests
url = "https://erp.arukz.com/admin/api/v1/sales/orders"
payload = {
"partner_id": 1,
"payment_term_id": 1,
"date_order": "2026-02-18",
"lines": [
{
"product_id": 10,
"product_qty": 2,
"product_uom_id": 1,
"price_unit": 120.5,
"discount": 5,
"customer_lead": 0,
"product_packaging_id": None,
"product_packaging_qty": 0,
"taxes": [1, 2]
}
]
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
partner_id: 1,
payment_term_id: 1,
date_order: '2026-02-18',
lines: [
{
product_id: 10,
product_qty: 2,
product_uom_id: 1,
price_unit: 120.5,
discount: 5,
customer_lead: 0,
product_packaging_id: null,
product_packaging_qty: 0,
taxes: [1, 2]
}
]
})
};
fetch('https://erp.arukz.com/admin/api/v1/sales/orders', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://erp.arukz.com/admin/api/v1/sales/orders",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'partner_id' => 1,
'payment_term_id' => 1,
'date_order' => '2026-02-18',
'lines' => [
[
'product_id' => 10,
'product_qty' => 2,
'product_uom_id' => 1,
'price_unit' => 120.5,
'discount' => 5,
'customer_lead' => 0,
'product_packaging_id' => null,
'product_packaging_qty' => 0,
'taxes' => [
1,
2
]
]
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}{
"data": {
"id": 1,
"name": "SO/1",
"state": "sale",
"invoice_status": "invoiced",
"client_order_ref": null,
"origin": null,
"reference": null,
"date_order": "2026-01-07",
"validity_date": "2026-02-06",
"commitment_date": null,
"currency_rate": 0,
"amount_untaxed": 2440,
"amount_tax": 366,
"amount_total": 2806,
"locked": true,
"require_signature": false,
"require_payment": false,
"signed_by": null,
"signed_on": null,
"prepayment_percent": 0,
"note": "<p></p>",
"access_token": null,
"partner_id": 33,
"partner_invoice_id": 33,
"partner_shipping_id": 33,
"user_id": 1,
"team_id": null,
"company_id": 1,
"currency_id": 1,
"payment_term_id": 2,
"fiscal_position_id": null,
"journal_id": null,
"campaign_id": null,
"utm_source_id": null,
"medium_id": null,
"warehouse_id": 5,
"created_at": "2026-01-07T11:12:56+00:00",
"updated_at": "2026-01-08T12:59:31+00:00",
"deleted_at": null,
"partner": {
"id": 33,
"account_type": "individual",
"sub_type": "customer",
"name": "Lyle Holman",
"email": "lyle@example.com",
"phone": "12121221212",
"mobile": "1212121215294",
"avatar": null,
"avatar_url": null,
"job_title": "Itaque ratione dicta tenetur omnis reiciendis quidem consequatur",
"website": "https://www.zecikapuleze.mobi",
"tax_id": "Esse dolorum quo vel animi fugiat ipsum dicta et",
"company_registry": "TEST COMPANY",
"reference": "Ea aliquid debitis m",
"is_active": true,
"color": null,
"street1": "Street 69",
"street2": "Reprehenderit eos saepe deserunt ut eu ea aliquam magnam saepe reprehenderit cum alias dicta amet ducimus saepe excepturi facere qui",
"city": "California",
"zip": "90006",
"country_id": 233,
"state_id": 13,
"parent_id": 18,
"title_id": 1,
"company_id": null,
"industry_id": null,
"user_id": 2,
"creator_id": null,
"created_at": "2025-04-10T10:45:51.000000Z",
"updated_at": "2025-12-09T11:12:13.000000Z",
"deleted_at": null,
"country": {
"id": 233,
"name": "United States",
"code": "US",
"phone_code": "1",
"state_required": true,
"zip_required": true,
"currency_id": 1,
"created_at": "2025-04-07T12:34:34.000000Z",
"updated_at": "2025-04-07T12:34:34.000000Z"
},
"state": {
"id": 13,
"name": "California",
"code": "CA",
"country_id": 233,
"created_at": "2025-04-07T12:34:34.000000Z",
"updated_at": "2025-04-07T12:34:34.000000Z"
}
},
"lines": [
{
"id": 1,
"sort": 1,
"name": "Big Vision 4K Action Camera - Fisheye Lens",
"display_type": null,
"product_uom_qty": 5,
"product_qty": 5,
"qty_delivered": 5,
"qty_invoiced": 5,
"qty_to_invoice": 0,
"product_packaging_qty": 0.5,
"price_unit": 210,
"technical_price_unit": 210,
"discount": 0,
"price_subtotal": 1050,
"price_tax": 157.5,
"price_total": 1207.5,
"price_reduce_taxexcl": 210,
"price_reduce_taxinc": 241.5,
"purchase_price": 100,
"margin": 0,
"margin_percent": 0,
"untaxed_amount_invoiced": 0,
"untaxed_amount_to_invoice": 1050,
"state": "sale",
"invoice_status": "invoiced",
"qty_delivered_method": "stock_move",
"virtual_id": null,
"linked_virtual_id": null,
"is_downpayment": false,
"is_expense": false,
"customer_lead": 0,
"analytic_distribution": null,
"order_id": 1,
"product_id": 2,
"linked_sale_order_sale_id": null,
"product_uom_id": 1,
"product_packaging_id": 1,
"currency_id": 1,
"order_partner_id": 33,
"salesman_id": 1,
"warehouse_id": 5,
"route_id": null,
"company_id": 1,
"created_at": "2026-01-07T11:12:56+00:00",
"updated_at": "2026-01-08T12:59:31+00:00"
},
{
"id": 2,
"sort": 2,
"name": "Bass Blaze Waterproof Bluetooth Speaker - Blue",
"display_type": null,
"product_uom_qty": 4,
"product_qty": 4,
"qty_delivered": 4,
"qty_invoiced": 4,
"qty_to_invoice": 0,
"product_packaging_qty": 0.2,
"price_unit": 60,
"technical_price_unit": 60,
"discount": 0,
"price_subtotal": 240,
"price_tax": 36,
"price_total": 276,
"price_reduce_taxexcl": 60,
"price_reduce_taxinc": 69,
"purchase_price": 45,
"margin": 0,
"margin_percent": 0,
"untaxed_amount_invoiced": 0,
"untaxed_amount_to_invoice": 240,
"state": "sale",
"invoice_status": "invoiced",
"qty_delivered_method": "stock_move",
"virtual_id": null,
"linked_virtual_id": null,
"is_downpayment": false,
"is_expense": false,
"customer_lead": 0,
"analytic_distribution": null,
"order_id": 1,
"product_id": 12,
"linked_sale_order_sale_id": null,
"product_uom_id": 1,
"product_packaging_id": 2,
"currency_id": 1,
"order_partner_id": 33,
"salesman_id": 1,
"warehouse_id": 5,
"route_id": null,
"company_id": 1,
"created_at": "2026-01-07T11:12:56+00:00",
"updated_at": "2026-01-08T12:59:31+00:00"
},
{
"id": 3,
"sort": 3,
"name": "Flim Rocket Mini Projector - Telecentric Lens",
"display_type": null,
"product_uom_qty": 5,
"product_qty": 5,
"qty_delivered": 5,
"qty_invoiced": 5,
"qty_to_invoice": 0,
"product_packaging_qty": 0.5,
"price_unit": 230,
"technical_price_unit": 230,
"discount": 0,
"price_subtotal": 1150,
"price_tax": 172.5,
"price_total": 1322.5,
"price_reduce_taxexcl": 230,
"price_reduce_taxinc": 264.5,
"purchase_price": 120,
"margin": 0,
"margin_percent": 0,
"untaxed_amount_invoiced": 0,
"untaxed_amount_to_invoice": 1150,
"state": "sale",
"invoice_status": "invoiced",
"qty_delivered_method": "stock_move",
"virtual_id": null,
"linked_virtual_id": null,
"is_downpayment": false,
"is_expense": false,
"customer_lead": 0,
"analytic_distribution": null,
"order_id": 1,
"product_id": 8,
"linked_sale_order_sale_id": null,
"product_uom_id": 1,
"product_packaging_id": 1,
"currency_id": 1,
"order_partner_id": 33,
"salesman_id": 1,
"warehouse_id": 5,
"route_id": null,
"company_id": 1,
"created_at": "2026-01-07T11:12:56+00:00",
"updated_at": "2026-01-08T12:59:31+00:00"
}
]
},
"message": "Order created successfully."
}{
"message": "Unauthenticated."
}{
"message": "The given data was invalid.",
"errors": {
"partner_id": [
"The partner id field is required."
],
"lines": [
"The lines field is required."
]
}
}