Creates a new job approval.

Request Information

URI Parameters :

None.

Body Parameters :

job_approval
NameDescriptionTypeAdditional information
id

Primary Key

 globally unique identifier

Required
jobs_id

Foreign key of jobs

 globally unique identifier

Required
job_status_id

Job Status that will be used to alter the jobs (WaitingFurtherAction,Completed)

 globally unique identifier
is_daily_approval

Indicate if it's just a daily approval or a complete approval

 boolean
contact_id

The contact that confirm the job is done

 globally unique identifier
contact_name

The contact name

 string
customer_remarks

Additionnal remarks from the customer

 string

Max length: 4000
customer_signature

Captured image bytes of the customer's signature confirming the job is done.

 Collection of byte
technician_signature

Captured image bytes of the technician's signature confirming the job is done.

 Collection of byte
date_generated

Local datetime when it has been finished

 date
rating

Rating (0,5) the quality of the jobs

 integer
db_file_ids

List of file selected (checked) on the job approval

 string
email_notification_communication_id

Foreign key of the record generated for the completion email notification.

 globally unique identifier
email_notification_email_to

Mail to

 string
email_notification_email_cc

Mail cc

 string
email_notification_email_bcc

Mail bcc

 string
email_notification_email_subject

Mail subject

 string

Max length: 255
email_notification_email_body

Mail body

 string
user_id

Foreign key of the user (typically the technician) who recorded this approval.

 globally unique identifier
db_payment_method_id

Foreign key of the payment method used, when payment was collected on approval.

 globally unique identifier
ready_for_multi_approval

Indicate if it's just a daily approval or a complete approval

 boolean
customer_date_signed

Date signed of customer

 date
technican_date_signed

Date signed of technican

 date
sys_selected_items

Serialized list of the item ids that were selected (checked) for this approval.

 string
pdf_template_id

Foreign key of the PDF template used to generate the approval document.

 globally unique identifier
company_vat_id

Foreign key of the VAT regime applied on this approval.

 globally unique identifier
sys_nb_job_approval_list

Readonly: number of lines included in this approval.

 integer
db_language_id

Foreign key of the language used to generate the approval document/email.

 globally unique identifier
modified_dateutc

Readonly system field managed by database, filled with GetUtcDate when adding,updating

 date
dateutc_generated

UTC datetime when it has been finished

 date

Request Formats :

application/json, text/json

Sample: 
{
  "id": "7eb3da5a-4aa4-4d66-abe4-9012c21d4f5c",
  "jobs_id": "18e81e25-2c98-4db3-a956-26fc24bd609a",
  "job_status_id": "7e8cf53f-6d26-4527-bde8-e4c32b2a8faf",
  "is_daily_approval": true,
  "contact_id": "f0d1c2da-8003-4d7b-ac0f-1fb7ed910a24",
  "contact_name": "sample string 6",
  "customer_remarks": "sample string 7",
  "customer_signature": "QEA=",
  "technician_signature": "QEA=",
  "date_generated": "2026-09-16T09:23:32.1426453+00:00",
  "rating": 9,
  "db_file_ids": "sample string 10",
  "email_notification_communication_id": "0e4dccae-5729-4ee5-8884-9a908545e9a9",
  "email_notification_email_to": "sample string 12",
  "email_notification_email_cc": "sample string 13",
  "email_notification_email_bcc": "sample string 14",
  "email_notification_email_subject": "sample string 15",
  "email_notification_email_body": "sample string 16",
  "user_id": "0843fbcc-4c3e-4a64-a5b7-f9507fa11a45",
  "db_payment_method_id": "d8886e5c-cb20-4fdc-90ea-50fa6d4e964a",
  "ready_for_multi_approval": true,
  "customer_date_signed": "2026-09-16T09:23:32.1426453+00:00",
  "technican_date_signed": "2026-09-16T09:23:32.1426453+00:00",
  "sys_selected_items": "sample string 22",
  "pdf_template_id": "87735899-b6cf-4b4d-8faf-c51555a69fc2",
  "company_vat_id": "b80340af-34b1-4606-a3ec-8c0ac8ab2b82",
  "sys_nb_job_approval_list": 25,
  "db_language_id": "5ce05f1b-e886-4809-a96b-c149c7914330",
  "modified_dateutc": "2026-09-16T09:23:32.1426453+00:00",
  "dateutc_generated": "2026-09-16T09:23:32.1426453+00:00"
}

application/xml, text/xml

Sample: 
<job_approval xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
  <company_vat_id>b80340af-34b1-4606-a3ec-8c0ac8ab2b82</company_vat_id>
  <contact_id>f0d1c2da-8003-4d7b-ac0f-1fb7ed910a24</contact_id>
  <contact_name>sample string 6</contact_name>
  <customer_date_signed>2026-09-16T09:23:32.142Z</customer_date_signed>
  <customer_remarks>sample string 7</customer_remarks>
  <customer_signature>QEA=</customer_signature>
  <date_generated>2026-09-16T09:23:32.142Z</date_generated>
  <dateutc_generated>2026-09-16T09:23:32.142Z</dateutc_generated>
  <db_file_ids>sample string 10</db_file_ids>
  <db_language_id>5ce05f1b-e886-4809-a96b-c149c7914330</db_language_id>
  <db_payment_method_id>d8886e5c-cb20-4fdc-90ea-50fa6d4e964a</db_payment_method_id>
  <email_notification_communication_id>0e4dccae-5729-4ee5-8884-9a908545e9a9</email_notification_communication_id>
  <email_notification_email_bcc>sample string 14</email_notification_email_bcc>
  <email_notification_email_body>sample string 16</email_notification_email_body>
  <email_notification_email_cc>sample string 13</email_notification_email_cc>
  <email_notification_email_subject>sample string 15</email_notification_email_subject>
  <email_notification_email_to>sample string 12</email_notification_email_to>
  <id>7eb3da5a-4aa4-4d66-abe4-9012c21d4f5c</id>
  <is_daily_approval>true</is_daily_approval>
  <job_status_id>7e8cf53f-6d26-4527-bde8-e4c32b2a8faf</job_status_id>
  <jobs_id>18e81e25-2c98-4db3-a956-26fc24bd609a</jobs_id>
  <modified_dateutc>2026-09-16T09:23:32.142Z</modified_dateutc>
  <pdf_template_id>87735899-b6cf-4b4d-8faf-c51555a69fc2</pdf_template_id>
  <rating>9</rating>
  <ready_for_multi_approval>true</ready_for_multi_approval>
  <sys_nb_job_approval_list>25</sys_nb_job_approval_list>
  <sys_selected_items>sample string 22</sys_selected_items>
  <technican_date_signed>2026-09-16T09:23:32.142Z</technican_date_signed>
  <technician_signature>QEA=</technician_signature>
  <user_id>0843fbcc-4c3e-4a64-a5b7-f9507fa11a45</user_id>
</job_approval>

Response Information

Resource Description :

IHttpActionResult containing the created job approval.

IHttpActionResult

None.

Response Formats

application/json, text/json, application/xml, text/xml

Sample:

Sample not available.