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": "a4c9e9f0-13bc-493e-ac7a-07f9a1ca93ec",
"jobs_id": "7ef1b890-f79c-461f-b8da-420f147d6e83",
"job_approval_id": "12255632-02cb-42b5-96bc-cf68829ccebd",
"article_stock_location_id": "dc76feb1-d507-4893-86f5-b8e0d4924c15",
"article_id": "b48df778-f363-4fe2-bee0-956be93b3e82",
"is_dummy": true,
"article_code": "sample string 7",
"article_name": "sample string 8",
"article_description": "sample string 9",
"working_date": "2026-06-16T21:15:58.0908932+00:00",
"quantity": 11.0,
"serial_number": "sample string 12",
"price": 13.0,
"is_under_warranty": true,
"discount": 15.0,
"purchase_order_details_id": "79b62553-85b9-4ac6-bc39-ae49af82e837",
"user_id": "f7bc3818-ed52-449d-8b88-068d91f93626",
"remark": "sample string 18",
"no_warranty_reason": "sample string 19",
"db_unit_of_measure_id": "70ab5930-37c7-408a-8c74-6eab44a060c8",
"included_on_last_stock_compute": true,
"signed_by_company": true,
"company_vat_id": "94ba0d95-3b40-49ef-9ad4-60eb7df82056",
"vat_value": 24.0,
"vat_rate": 25.0,
"invoice_id": "aa032691-0bbc-43f8-9c15-09c3a37acea9",
"invoice_details_id": "ee03b387-a536-4161-9572-e95987ea89e1",
"is_customized": true,
"modified_dateutc": "2026-06-16T21:15:58.0908932+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>b48df778-f363-4fe2-bee0-956be93b3e82</article_id> <article_name>sample string 8</article_name> <article_stock_location_id>dc76feb1-d507-4893-86f5-b8e0d4924c15</article_stock_location_id> <company_vat_id>94ba0d95-3b40-49ef-9ad4-60eb7df82056</company_vat_id> <db_unit_of_measure_id>70ab5930-37c7-408a-8c74-6eab44a060c8</db_unit_of_measure_id> <discount>15</discount> <id>a4c9e9f0-13bc-493e-ac7a-07f9a1ca93ec</id> <included_on_last_stock_compute>true</included_on_last_stock_compute> <invoice_details_id>ee03b387-a536-4161-9572-e95987ea89e1</invoice_details_id> <invoice_id>aa032691-0bbc-43f8-9c15-09c3a37acea9</invoice_id> <is_customized>true</is_customized> <is_dummy>true</is_dummy> <is_under_warranty>true</is_under_warranty> <job_approval_id>12255632-02cb-42b5-96bc-cf68829ccebd</job_approval_id> <jobs_id>7ef1b890-f79c-461f-b8da-420f147d6e83</jobs_id> <modified_dateutc>2026-06-16T21:15:58.090Z</modified_dateutc> <no_warranty_reason>sample string 19</no_warranty_reason> <price>13</price> <purchase_order_details_id>79b62553-85b9-4ac6-bc39-ae49af82e837</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>f7bc3818-ed52-449d-8b88-068d91f93626</user_id> <vat_rate>25</vat_rate> <vat_value>24</vat_value> <working_date>2026-06-16T21:15:58.090Z</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": "114181ea-2d63-495f-876f-6d93a2e276ef",
"jobs_id": "672035f7-1025-4147-b715-56b6708b9967",
"job_approval_id": "ccc3454c-1a8e-4615-bae9-4c890bf612e4",
"article_stock_location_id": "3474ff3c-b59c-4bfd-86e8-b490db4d8e83",
"article_id": "53ccfb44-7bbf-4084-8a6c-2f66f6faa6f9",
"is_dummy": true,
"article_code": "sample string 7",
"article_name": "sample string 8",
"article_description": "sample string 9",
"working_date": "2026-06-16T21:15:58.0908932+00:00",
"quantity": 11.0,
"serial_number": "sample string 12",
"price": 13.0,
"is_under_warranty": true,
"discount": 15.0,
"purchase_order_details_id": "87b5cc58-1795-4be3-a6f5-6d2c7ca74929",
"user_id": "09c051f3-d341-4574-b40b-236f2ef8bdd5",
"remark": "sample string 18",
"no_warranty_reason": "sample string 19",
"db_unit_of_measure_id": "a32785db-6a6c-469b-8b5d-846d4fe40624",
"included_on_last_stock_compute": true,
"signed_by_company": true,
"company_vat_id": "39c15dda-d2be-4e0d-9748-44c303a9c943",
"vat_value": 24.0,
"vat_rate": 25.0,
"invoice_id": "24517286-4e18-4762-8d41-ac217a6efc74",
"invoice_details_id": "875dbbd9-07c0-4739-a0aa-22f1cb28be70",
"is_customized": true,
"modified_dateutc": "2026-06-16T21:15:58.0908932+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>53ccfb44-7bbf-4084-8a6c-2f66f6faa6f9</article_id> <article_name>sample string 8</article_name> <article_stock_location_id>3474ff3c-b59c-4bfd-86e8-b490db4d8e83</article_stock_location_id> <company_vat_id>39c15dda-d2be-4e0d-9748-44c303a9c943</company_vat_id> <db_unit_of_measure_id>a32785db-6a6c-469b-8b5d-846d4fe40624</db_unit_of_measure_id> <discount>15</discount> <id>114181ea-2d63-495f-876f-6d93a2e276ef</id> <included_on_last_stock_compute>true</included_on_last_stock_compute> <invoice_details_id>875dbbd9-07c0-4739-a0aa-22f1cb28be70</invoice_details_id> <invoice_id>24517286-4e18-4762-8d41-ac217a6efc74</invoice_id> <is_customized>true</is_customized> <is_dummy>true</is_dummy> <is_under_warranty>true</is_under_warranty> <job_approval_id>ccc3454c-1a8e-4615-bae9-4c890bf612e4</job_approval_id> <jobs_id>672035f7-1025-4147-b715-56b6708b9967</jobs_id> <modified_dateutc>2026-06-16T21:15:58.090Z</modified_dateutc> <no_warranty_reason>sample string 19</no_warranty_reason> <price>13</price> <purchase_order_details_id>87b5cc58-1795-4be3-a6f5-6d2c7ca74929</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>09c051f3-d341-4574-b40b-236f2ef8bdd5</user_id> <vat_rate>25</vat_rate> <vat_value>24</vat_value> <working_date>2026-06-16T21:15:58.090Z</working_date> </job_part_usage>