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": "a0f95fe8-5018-43a8-a788-79da9b2b4362",
  "jobs_id": "d6522aa4-45b8-450e-82ec-c296dcd79721",
  "job_status_id": "3b114da8-3609-4f74-ad37-40f924a10216",
  "is_daily_approval": true,
  "contact_id": "12277dc8-2222-48b7-aaf4-44003a06c8eb",
  "contact_name": "sample string 6",
  "customer_remarks": "sample string 7",
  "customer_signature": "QEA=",
  "technician_signature": "QEA=",
  "date_generated": "2026-11-12T14:28:07.2283693+00:00",
  "rating": 9,
  "db_file_ids": "sample string 10",
  "email_notification_communication_id": "bd5d0353-1243-41dc-819c-b771c5e40038",
  "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": "a80ec3dd-fa1d-4437-a7d5-f84cc218f3f8",
  "db_payment_method_id": "8f5fa7ca-cc77-4410-8ced-7d16938dab1f",
  "ready_for_multi_approval": true,
  "customer_date_signed": "2026-11-12T14:28:07.2283693+00:00",
  "technican_date_signed": "2026-11-12T14:28:07.2283693+00:00",
  "sys_selected_items": "sample string 22",
  "pdf_template_id": "71d1fe34-b5d9-45d0-b0c3-9b13223c9e9a",
  "company_vat_id": "f1e654a6-19c1-4929-b010-cefd0f9c00e8",
  "sys_nb_job_approval_list": 25,
  "db_language_id": "1fb73e82-8ea7-475a-b137-3aec4673d0f0",
  "modified_dateutc": "2026-11-12T14:28:07.2283693+00:00",
  "dateutc_generated": "2026-11-12T14:28:07.2283693+00:00"
}

application/xml, text/xml

Sample: 
<job_approval xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
  <company_vat_id>f1e654a6-19c1-4929-b010-cefd0f9c00e8</company_vat_id>
  <contact_id>12277dc8-2222-48b7-aaf4-44003a06c8eb</contact_id>
  <contact_name>sample string 6</contact_name>
  <customer_date_signed>2026-11-12T14:28:07.228Z</customer_date_signed>
  <customer_remarks>sample string 7</customer_remarks>
  <customer_signature>QEA=</customer_signature>
  <date_generated>2026-11-12T14:28:07.228Z</date_generated>
  <dateutc_generated>2026-11-12T14:28:07.228Z</dateutc_generated>
  <db_file_ids>sample string 10</db_file_ids>
  <db_language_id>1fb73e82-8ea7-475a-b137-3aec4673d0f0</db_language_id>
  <db_payment_method_id>8f5fa7ca-cc77-4410-8ced-7d16938dab1f</db_payment_method_id>
  <email_notification_communication_id>bd5d0353-1243-41dc-819c-b771c5e40038</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>a0f95fe8-5018-43a8-a788-79da9b2b4362</id>
  <is_daily_approval>true</is_daily_approval>
  <job_status_id>3b114da8-3609-4f74-ad37-40f924a10216</job_status_id>
  <jobs_id>d6522aa4-45b8-450e-82ec-c296dcd79721</jobs_id>
  <modified_dateutc>2026-11-12T14:28:07.228Z</modified_dateutc>
  <pdf_template_id>71d1fe34-b5d9-45d0-b0c3-9b13223c9e9a</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-11-12T14:28:07.228Z</technican_date_signed>
  <technician_signature>QEA=</technician_signature>
  <user_id>a80ec3dd-fa1d-4437-a7d5-f84cc218f3f8</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.