Retrieves all used parts, optionally filtered via OData query options.

Request Information

URI Parameters :

None.

Body Parameters :

None.

Response Information

Resource Description :

IHttpActionResult containing the list of used parts.

job_part_usage
NameDescriptionTypeAdditional 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

Sample: 
{
  "id": "11b2e6d0-c2dd-4dc3-bae0-e21f8765f64c",
  "jobs_id": "eb1e764d-ff2e-4e02-83a7-00a5f4afde6a",
  "job_approval_id": "a9983d0b-6f49-40d3-b60c-0f2f151f2a35",
  "article_stock_location_id": "4769dedb-3d56-46b7-86e5-80496da9f6df",
  "article_id": "6d2d99e6-da69-4480-9fe5-7d449ca097a8",
  "is_dummy": true,
  "article_code": "sample string 7",
  "article_name": "sample string 8",
  "article_description": "sample string 9",
  "working_date": "2026-09-16T08:33:33.1593973+00:00",
  "quantity": 11.0,
  "serial_number": "sample string 12",
  "price": 13.0,
  "is_under_warranty": true,
  "discount": 15.0,
  "purchase_order_details_id": "80fd3afd-164e-4073-87ab-05028926022e",
  "user_id": "e1624531-8e21-4596-9bf7-bf27b2cdec32",
  "remark": "sample string 18",
  "no_warranty_reason": "sample string 19",
  "db_unit_of_measure_id": "a5ec6c36-a1ce-414f-81f2-fd58b36b4dc1",
  "included_on_last_stock_compute": true,
  "signed_by_company": true,
  "company_vat_id": "8e3d4af8-5ace-4056-91b7-149459646f89",
  "vat_value": 24.0,
  "vat_rate": 25.0,
  "invoice_id": "def25223-6b25-4b14-a4ce-bcdfe1b158a3",
  "invoice_details_id": "f4624b7a-44fa-4330-b9e7-ff464130ecc6",
  "is_customized": true,
  "modified_dateutc": "2026-09-16T08:33:33.1764551+00:00"
}

application/xml, text/xml

Sample: 
<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>6d2d99e6-da69-4480-9fe5-7d449ca097a8</article_id>
  <article_name>sample string 8</article_name>
  <article_stock_location_id>4769dedb-3d56-46b7-86e5-80496da9f6df</article_stock_location_id>
  <company_vat_id>8e3d4af8-5ace-4056-91b7-149459646f89</company_vat_id>
  <db_unit_of_measure_id>a5ec6c36-a1ce-414f-81f2-fd58b36b4dc1</db_unit_of_measure_id>
  <discount>15</discount>
  <id>11b2e6d0-c2dd-4dc3-bae0-e21f8765f64c</id>
  <included_on_last_stock_compute>true</included_on_last_stock_compute>
  <invoice_details_id>f4624b7a-44fa-4330-b9e7-ff464130ecc6</invoice_details_id>
  <invoice_id>def25223-6b25-4b14-a4ce-bcdfe1b158a3</invoice_id>
  <is_customized>true</is_customized>
  <is_dummy>true</is_dummy>
  <is_under_warranty>true</is_under_warranty>
  <job_approval_id>a9983d0b-6f49-40d3-b60c-0f2f151f2a35</job_approval_id>
  <jobs_id>eb1e764d-ff2e-4e02-83a7-00a5f4afde6a</jobs_id>
  <modified_dateutc>2026-09-16T08:33:33.176Z</modified_dateutc>
  <no_warranty_reason>sample string 19</no_warranty_reason>
  <price>13</price>
  <purchase_order_details_id>80fd3afd-164e-4073-87ab-05028926022e</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>e1624531-8e21-4596-9bf7-bf27b2cdec32</user_id>
  <vat_rate>25</vat_rate>
  <vat_value>24</vat_value>
  <working_date>2026-09-16T08:33:33.159Z</working_date>
</job_part_usage>