Creates a new job part usage record.
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 |
Foreign key of the unit of measure is expressed in. |
globally unique identifier | |
| included_on_last_stock_compute |
Indicates this usage line was already accounted for in the most recent stock recomputation, to avoid double-counting. |
boolean | |
| signed_by_company |
Needed for integration |
boolean | |
| company_vat_id |
Foreign key of the VAT regime applied to this line. |
globally unique identifier | |
| vat_value |
VAT amount computed for this line. |
decimal number | |
| vat_rate |
VAT rate applied to this line (percentage). |
decimal number | |
| invoice_id |
Foreign key of the invoice this line was billed on, once invoiced. |
globally unique identifier | |
| invoice_details_id |
Foreign key of the invoice detail line this usage was billed on, once invoiced. |
globally unique identifier | |
| is_customized |
Indicates the article details on this line were manually customized rather than copied as-is from the article record. |
boolean | |
| modified_dateutc |
Readonly system field managed by database, filled with GetUtcDate when adding,updating |
date |
Request Formats :
application/json, text/json
{
"id": "10c86bdd-e74c-43d7-891b-5222bee4b2a7",
"jobs_id": "c5c9b772-54b4-4e93-9bbc-a8a594a1d074",
"job_approval_id": "d23bf483-8fed-4c06-b55e-3599b33c4087",
"article_stock_location_id": "86d8e883-75dd-45c1-b289-8a696faa7b24",
"article_id": "ee1b4914-c873-422c-abe5-2439dfaf6a7d",
"is_dummy": true,
"article_code": "sample string 7",
"article_name": "sample string 8",
"article_description": "sample string 9",
"working_date": "2026-09-16T10:59:26.7944675+00:00",
"quantity": 11.0,
"serial_number": "sample string 12",
"price": 13.0,
"is_under_warranty": true,
"discount": 15.0,
"purchase_order_details_id": "611fbdbc-8de4-410b-84bf-d16738cccb2d",
"user_id": "29c9d496-954d-41d2-8f3a-22c1deaa3744",
"remark": "sample string 18",
"no_warranty_reason": "sample string 19",
"db_unit_of_measure_id": "f0b40f6b-aedc-4d28-b90c-5fcf026adcc5",
"included_on_last_stock_compute": true,
"signed_by_company": true,
"company_vat_id": "f22eb78f-330d-4bae-a249-cfa7122f0d55",
"vat_value": 24.0,
"vat_rate": 25.0,
"invoice_id": "a6787e41-bb04-4dad-b47f-bb583af0c872",
"invoice_details_id": "0c66df6e-e46c-4048-9c71-72cc8cfe0530",
"is_customized": true,
"modified_dateutc": "2026-09-16T10:59:26.7944675+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>ee1b4914-c873-422c-abe5-2439dfaf6a7d</article_id> <article_name>sample string 8</article_name> <article_stock_location_id>86d8e883-75dd-45c1-b289-8a696faa7b24</article_stock_location_id> <company_vat_id>f22eb78f-330d-4bae-a249-cfa7122f0d55</company_vat_id> <db_unit_of_measure_id>f0b40f6b-aedc-4d28-b90c-5fcf026adcc5</db_unit_of_measure_id> <discount>15</discount> <id>10c86bdd-e74c-43d7-891b-5222bee4b2a7</id> <included_on_last_stock_compute>true</included_on_last_stock_compute> <invoice_details_id>0c66df6e-e46c-4048-9c71-72cc8cfe0530</invoice_details_id> <invoice_id>a6787e41-bb04-4dad-b47f-bb583af0c872</invoice_id> <is_customized>true</is_customized> <is_dummy>true</is_dummy> <is_under_warranty>true</is_under_warranty> <job_approval_id>d23bf483-8fed-4c06-b55e-3599b33c4087</job_approval_id> <jobs_id>c5c9b772-54b4-4e93-9bbc-a8a594a1d074</jobs_id> <modified_dateutc>2026-09-16T10:59:26.794Z</modified_dateutc> <no_warranty_reason>sample string 19</no_warranty_reason> <price>13</price> <purchase_order_details_id>611fbdbc-8de4-410b-84bf-d16738cccb2d</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>29c9d496-954d-41d2-8f3a-22c1deaa3744</user_id> <vat_rate>25</vat_rate> <vat_value>24</vat_value> <working_date>2026-09-16T10:59:26.794Z</working_date> </job_part_usage>
Response Information
Resource Description :
IHttpActionResult containing the created job part usage record.
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 |
Foreign key of the unit of measure is expressed in. |
globally unique identifier | |
| included_on_last_stock_compute |
Indicates this usage line was already accounted for in the most recent stock recomputation, to avoid double-counting. |
boolean | |
| signed_by_company |
Needed for integration |
boolean | |
| company_vat_id |
Foreign key of the VAT regime applied to this line. |
globally unique identifier | |
| vat_value |
VAT amount computed for this line. |
decimal number | |
| vat_rate |
VAT rate applied to this line (percentage). |
decimal number | |
| invoice_id |
Foreign key of the invoice this line was billed on, once invoiced. |
globally unique identifier | |
| invoice_details_id |
Foreign key of the invoice detail line this usage was billed on, once invoiced. |
globally unique identifier | |
| is_customized |
Indicates the article details on this line were manually customized rather than copied as-is from the article record. |
boolean | |
| modified_dateutc |
Readonly system field managed by database, filled with GetUtcDate when adding,updating |
date |
Response Formats
application/json, text/json
{
"id": "9f67dfd8-dc0e-4363-be33-ae8162e04e86",
"jobs_id": "53e35f81-4fd8-41d9-a53b-6914fe3b9b6a",
"job_approval_id": "5331ee43-3527-40aa-b708-978d16f12d54",
"article_stock_location_id": "e710f5e2-a55f-4959-93c6-1364e6269ef9",
"article_id": "ac069a40-cc7e-423a-ad28-7712bd5f7943",
"is_dummy": true,
"article_code": "sample string 7",
"article_name": "sample string 8",
"article_description": "sample string 9",
"working_date": "2026-09-16T10:59:26.8724328+00:00",
"quantity": 11.0,
"serial_number": "sample string 12",
"price": 13.0,
"is_under_warranty": true,
"discount": 15.0,
"purchase_order_details_id": "13d36e21-2d84-478c-938b-9b89e2206c46",
"user_id": "6346f4eb-cdf9-496d-99e8-249faabe025f",
"remark": "sample string 18",
"no_warranty_reason": "sample string 19",
"db_unit_of_measure_id": "ba2afc8c-2fa2-4e23-aff9-6614a6069d5a",
"included_on_last_stock_compute": true,
"signed_by_company": true,
"company_vat_id": "14fe9425-5048-4964-bce5-bd9959b5b791",
"vat_value": 24.0,
"vat_rate": 25.0,
"invoice_id": "3d4c2fb7-c61c-4118-81c5-9b2f5cf3330a",
"invoice_details_id": "65ff23ea-a686-407c-b814-5a497dd6d1db",
"is_customized": true,
"modified_dateutc": "2026-09-16T10:59:26.8724328+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>ac069a40-cc7e-423a-ad28-7712bd5f7943</article_id> <article_name>sample string 8</article_name> <article_stock_location_id>e710f5e2-a55f-4959-93c6-1364e6269ef9</article_stock_location_id> <company_vat_id>14fe9425-5048-4964-bce5-bd9959b5b791</company_vat_id> <db_unit_of_measure_id>ba2afc8c-2fa2-4e23-aff9-6614a6069d5a</db_unit_of_measure_id> <discount>15</discount> <id>9f67dfd8-dc0e-4363-be33-ae8162e04e86</id> <included_on_last_stock_compute>true</included_on_last_stock_compute> <invoice_details_id>65ff23ea-a686-407c-b814-5a497dd6d1db</invoice_details_id> <invoice_id>3d4c2fb7-c61c-4118-81c5-9b2f5cf3330a</invoice_id> <is_customized>true</is_customized> <is_dummy>true</is_dummy> <is_under_warranty>true</is_under_warranty> <job_approval_id>5331ee43-3527-40aa-b708-978d16f12d54</job_approval_id> <jobs_id>53e35f81-4fd8-41d9-a53b-6914fe3b9b6a</jobs_id> <modified_dateutc>2026-09-16T10:59:26.872Z</modified_dateutc> <no_warranty_reason>sample string 19</no_warranty_reason> <price>13</price> <purchase_order_details_id>13d36e21-2d84-478c-938b-9b89e2206c46</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>6346f4eb-cdf9-496d-99e8-249faabe025f</user_id> <vat_rate>25</vat_rate> <vat_value>24</vat_value> <working_date>2026-09-16T10:59:26.872Z</working_date> </job_part_usage>