Creates a new job part usage object
Request Information
URI Parameters :
None.
Body Parameters :
job_part_usage| Name | Description | Type | Additional information |
|---|---|---|---|
| id |
Primary Key |
globally unique identifier |
Required |
| jobs_id |
Foreign key of jobs |
globally unique identifier | |
| job_approval_id |
Job approval Id |
globally unique identifier | |
| article_stock_location_id |
In case of stock management enabled, the stock that has been used |
globally unique identifier | |
| article_id |
Foreign key of article. Can be empty if user keys in manually the object |
globally unique identifier | |
| is_dummy |
In case of dummy |
boolean | |
| article_code |
Article code |
string |
Max length: 255 |
| article_name |
Article name |
string |
Max length: 255 |
| article_description |
Article description |
string |
Max length: 255 |
| working_date |
Date when the part has been used |
date | |
| quantity |
Quantity |
decimal number | |
| serial_number |
When the article.use_serial then the serial should be saved here |
string |
Max length: 255 |
| price |
Unit price of the part. Computed with the price logic or filled via purchase_order_details.price |
decimal number | |
| is_under_warranty |
In case the logic detect that the parts was in warranty, this field will be set to true and the discount will be set equal to the price |
boolean | |
| discount |
Manual discount , in money, added by the technician |
decimal number | |
| purchase_order_details_id |
Foreign key of purchase_order_details, if the line was generated based on a purchase_order_details |
globally unique identifier | |
| user_id |
User Id |
globally unique identifier | |
| remark | string |
Max length: 255 |
|
| no_warranty_reason | string |
Max length: 255 |
|
| db_unit_of_measure_id | globally unique identifier | ||
| included_on_last_stock_compute | boolean | ||
| signed_by_company |
Needed for integration |
boolean | |
| company_vat_id | globally unique identifier | ||
| vat_value | decimal number | ||
| vat_rate | decimal number | ||
| invoice_id | globally unique identifier | ||
| invoice_details_id | globally unique identifier | ||
| is_customized | boolean | ||
| modified_dateutc |
Readonly system field managed by database, filled with GetUtcDate when adding,updating |
date |
Request Formats :
application/json, text/json
{
"id": "34b91fd5-1454-4fd3-b7ec-12c6897ea325",
"jobs_id": "1ab3c288-1a36-4020-b1b4-620bf6c82987",
"job_approval_id": "fcdad539-06b9-47db-82d6-ff5fdf6860a8",
"article_stock_location_id": "fd9d6369-cd47-4ffa-aac4-2fe19a2cbe2a",
"article_id": "161009eb-852e-4460-b7d1-86653e1ad33e",
"is_dummy": true,
"article_code": "sample string 7",
"article_name": "sample string 8",
"article_description": "sample string 9",
"working_date": "2026-01-11T20:57:30.7734966+00:00",
"quantity": 11.0,
"serial_number": "sample string 12",
"price": 13.0,
"is_under_warranty": true,
"discount": 15.0,
"purchase_order_details_id": "b5a9bb7e-0c04-4954-8ee2-f5824da314a9",
"user_id": "ec1d423f-9e4e-4531-9a97-f6201a05f1d4",
"remark": "sample string 18",
"no_warranty_reason": "sample string 19",
"db_unit_of_measure_id": "7d499b64-69d9-4b01-9385-f6be67200dfb",
"included_on_last_stock_compute": true,
"signed_by_company": true,
"company_vat_id": "93f8c30a-e811-4406-82f2-fdd35d45410a",
"vat_value": 24.0,
"vat_rate": 25.0,
"invoice_id": "9602ae02-b159-4ea6-862f-81005cf2678a",
"invoice_details_id": "4a76fc23-48a2-469c-8276-d5e6cba58cdf",
"is_customized": true,
"modified_dateutc": "2026-01-11T20:57:30.8047472+00:00"
}
application/xml, text/xml
<job_part_usage xmlns:i="http://www.w3.org/2001/XMLSchema-instance"> <article_code>sample string 7</article_code> <article_description>sample string 9</article_description> <article_id>161009eb-852e-4460-b7d1-86653e1ad33e</article_id> <article_name>sample string 8</article_name> <article_stock_location_id>fd9d6369-cd47-4ffa-aac4-2fe19a2cbe2a</article_stock_location_id> <company_vat_id>93f8c30a-e811-4406-82f2-fdd35d45410a</company_vat_id> <db_unit_of_measure_id>7d499b64-69d9-4b01-9385-f6be67200dfb</db_unit_of_measure_id> <discount>15</discount> <id>34b91fd5-1454-4fd3-b7ec-12c6897ea325</id> <included_on_last_stock_compute>true</included_on_last_stock_compute> <invoice_details_id>4a76fc23-48a2-469c-8276-d5e6cba58cdf</invoice_details_id> <invoice_id>9602ae02-b159-4ea6-862f-81005cf2678a</invoice_id> <is_customized>true</is_customized> <is_dummy>true</is_dummy> <is_under_warranty>true</is_under_warranty> <job_approval_id>fcdad539-06b9-47db-82d6-ff5fdf6860a8</job_approval_id> <jobs_id>1ab3c288-1a36-4020-b1b4-620bf6c82987</jobs_id> <modified_dateutc>2026-01-11T20:57:30.804Z</modified_dateutc> <no_warranty_reason>sample string 19</no_warranty_reason> <price>13</price> <purchase_order_details_id>b5a9bb7e-0c04-4954-8ee2-f5824da314a9</purchase_order_details_id> <quantity>11</quantity> <remark>sample string 18</remark> <serial_number>sample string 12</serial_number> <signed_by_company>true</signed_by_company> <user_id>ec1d423f-9e4e-4531-9a97-f6201a05f1d4</user_id> <vat_rate>25</vat_rate> <vat_value>24</vat_value> <working_date>2026-01-11T20:57:30.773Z</working_date> </job_part_usage>
Response Information
Resource Description :
IHttpActionResult
job_part_usage| Name | Description | Type | Additional information |
|---|---|---|---|
| id |
Primary Key |
globally unique identifier |
Required |
| jobs_id |
Foreign key of jobs |
globally unique identifier | |
| job_approval_id |
Job approval Id |
globally unique identifier | |
| article_stock_location_id |
In case of stock management enabled, the stock that has been used |
globally unique identifier | |
| article_id |
Foreign key of article. Can be empty if user keys in manually the object |
globally unique identifier | |
| is_dummy |
In case of dummy |
boolean | |
| article_code |
Article code |
string |
Max length: 255 |
| article_name |
Article name |
string |
Max length: 255 |
| article_description |
Article description |
string |
Max length: 255 |
| working_date |
Date when the part has been used |
date | |
| quantity |
Quantity |
decimal number | |
| serial_number |
When the article.use_serial then the serial should be saved here |
string |
Max length: 255 |
| price |
Unit price of the part. Computed with the price logic or filled via purchase_order_details.price |
decimal number | |
| is_under_warranty |
In case the logic detect that the parts was in warranty, this field will be set to true and the discount will be set equal to the price |
boolean | |
| discount |
Manual discount , in money, added by the technician |
decimal number | |
| purchase_order_details_id |
Foreign key of purchase_order_details, if the line was generated based on a purchase_order_details |
globally unique identifier | |
| user_id |
User Id |
globally unique identifier | |
| remark | string |
Max length: 255 |
|
| no_warranty_reason | string |
Max length: 255 |
|
| db_unit_of_measure_id | globally unique identifier | ||
| included_on_last_stock_compute | boolean | ||
| signed_by_company |
Needed for integration |
boolean | |
| company_vat_id | globally unique identifier | ||
| vat_value | decimal number | ||
| vat_rate | decimal number | ||
| invoice_id | globally unique identifier | ||
| invoice_details_id | globally unique identifier | ||
| is_customized | boolean | ||
| modified_dateutc |
Readonly system field managed by database, filled with GetUtcDate when adding,updating |
date |
Response Formats
application/json, text/json
{
"id": "5b96fe67-a9ec-482d-a2b9-4ae4548093db",
"jobs_id": "6d3dd34a-4142-469b-878b-dd036e6076c4",
"job_approval_id": "0f33098a-cd53-46f0-a8a3-20a9b0471530",
"article_stock_location_id": "56e0333a-827a-4337-998f-695857804303",
"article_id": "8be8dea0-27f2-43b7-b7bf-1e4cffd715c2",
"is_dummy": true,
"article_code": "sample string 7",
"article_name": "sample string 8",
"article_description": "sample string 9",
"working_date": "2026-01-11T20:57:30.9476155+00:00",
"quantity": 11.0,
"serial_number": "sample string 12",
"price": 13.0,
"is_under_warranty": true,
"discount": 15.0,
"purchase_order_details_id": "f3619a89-aa8a-43c4-bb3e-2e1625b6d6fd",
"user_id": "64004dab-b851-4de8-a7e7-3fa18f3a0934",
"remark": "sample string 18",
"no_warranty_reason": "sample string 19",
"db_unit_of_measure_id": "907d0456-331a-4312-8533-02ea1a5edf01",
"included_on_last_stock_compute": true,
"signed_by_company": true,
"company_vat_id": "c524052b-a85e-4982-9ee3-b6daf88449a8",
"vat_value": 24.0,
"vat_rate": 25.0,
"invoice_id": "f2ef839f-84a1-487c-bebd-00bfa89c0e2d",
"invoice_details_id": "b7edb02d-a5d8-4fca-81d3-ed00939f35f6",
"is_customized": true,
"modified_dateutc": "2026-01-11T20:57:30.9476155+00:00"
}
application/xml, text/xml
<job_part_usage xmlns:i="http://www.w3.org/2001/XMLSchema-instance"> <article_code>sample string 7</article_code> <article_description>sample string 9</article_description> <article_id>8be8dea0-27f2-43b7-b7bf-1e4cffd715c2</article_id> <article_name>sample string 8</article_name> <article_stock_location_id>56e0333a-827a-4337-998f-695857804303</article_stock_location_id> <company_vat_id>c524052b-a85e-4982-9ee3-b6daf88449a8</company_vat_id> <db_unit_of_measure_id>907d0456-331a-4312-8533-02ea1a5edf01</db_unit_of_measure_id> <discount>15</discount> <id>5b96fe67-a9ec-482d-a2b9-4ae4548093db</id> <included_on_last_stock_compute>true</included_on_last_stock_compute> <invoice_details_id>b7edb02d-a5d8-4fca-81d3-ed00939f35f6</invoice_details_id> <invoice_id>f2ef839f-84a1-487c-bebd-00bfa89c0e2d</invoice_id> <is_customized>true</is_customized> <is_dummy>true</is_dummy> <is_under_warranty>true</is_under_warranty> <job_approval_id>0f33098a-cd53-46f0-a8a3-20a9b0471530</job_approval_id> <jobs_id>6d3dd34a-4142-469b-878b-dd036e6076c4</jobs_id> <modified_dateutc>2026-01-11T20:57:30.947Z</modified_dateutc> <no_warranty_reason>sample string 19</no_warranty_reason> <price>13</price> <purchase_order_details_id>f3619a89-aa8a-43c4-bb3e-2e1625b6d6fd</purchase_order_details_id> <quantity>11</quantity> <remark>sample string 18</remark> <serial_number>sample string 12</serial_number> <signed_by_company>true</signed_by_company> <user_id>64004dab-b851-4de8-a7e7-3fa18f3a0934</user_id> <vat_rate>25</vat_rate> <vat_value>24</vat_value> <working_date>2026-01-11T20:57:30.947Z</working_date> </job_part_usage>