Creates a new Contract object

Request Information

URI Parameters :

None.

Body Parameters :

contract
NameDescriptionTypeAdditional information
id

Primary key

globally unique identifier

Required

id2

id2

integer

Required

company_id

The company owner of this contract

globally unique identifier

Optionally required : company_id, company_code or company must be provided

company_code

Embedded entity "company" using ERP PK when adding/updating contract

string

Optionally required : company_id, company_code or company must be provided

company

Embedded entity "company" when adding/updating contract

company

Optionally required : company_id, company_code or company must be provided

reference

Reference

string
reference_back_office

Backoffice reference

string
reference_customer

Customer Reference

string
date_start

Start Date of the contract

date
date_end

Contract End date

date
date_cancel

Readonly , date +time when the contract goes in status Cancelled

date
date_last_invoiced

Readonly contains the last date an invoice has been generated for this contract

date
name

Name of the contract

string
description

Description of Contract

string
feelist_id

Feelist ID

globally unique identifier
article_price_label_id

Article Price Llabel Id

globally unique identifier
account_manager_user_id

FK of Account manager user

globally unique identifier
account_manager_user

Embedded entity "account_manager_user" using ERP PK when adding/updating account_manager_user

user
account_manager_user_code

Embedded entity "account_manager_user" using ERP PK when adding/updating account_manager_user

string
modified_dateutc

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

date
renewal_term_months

Renewal Term Months

integer

Range: inclusive between 0 and 1000000

feelist_warranty_discount

Feelist Warranty Discount

decimal number

Range: inclusive between 0 and 100

price_label_warranty_discount

Price Label Warranty Discount

decimal number

Range: inclusive between 0 and 100

driving_distance

Distance in km that are used to invoice the travel

decimal number
travel_fee_fix_discount

Discount applied when computing the fee for travel

decimal number

Request Formats :

application/json, text/json

Sample:
{
  "id": "fbff714e-1be4-4bb0-a8e4-2951b14292e9",
  "id2": 2,
  "company_id": "045a2a54-f237-4c31-9438-5544a11ce422",
  "company_code": "sample string 4",
  "reference": "sample string 5",
  "reference_back_office": "sample string 6",
  "reference_customer": "sample string 7",
  "date_start": "2026-08-09T03:59:20.1320881+00:00",
  "date_end": "2026-08-09T03:59:20.1320881+00:00",
  "date_cancel": "2026-08-09T03:59:20.1320881+00:00",
  "date_last_invoiced": "2026-08-09T03:59:20.1320881+00:00",
  "name": "sample string 12",
  "description": "sample string 13",
  "feelist_id": "8682b1a5-4778-45f5-8842-66f5f1c0982a",
  "article_price_label_id": "482e4efa-f289-4bfc-abf7-be7a8d08c2d7",
  "account_manager_user_id": "df00d39e-7a18-4bd8-9a99-a97828efeea9",
  "account_manager_user": {
    "id": "f1c1747f-6dd6-4428-8332-77ecc405458b",
    "db_language_id": "c32fca90-8901-4460-9d13-52a60685f3a0",
    "username": "sample string 3",
    "firstname": "sample string 4",
    "lastname": "sample string 5",
    "code": "sample string 6",
    "archived": true,
    "disabled": true,
    "emergency_contact": "sample string 9",
    "bankaccount": "sample string 10",
    "social_security": "sample string 11",
    "place_of_birth": "sample string 12",
    "nationality": "sample string 13",
    "functions": "sample string 14",
    "birthdate": "2026-08-09T03:59:20.1320881+00:00",
    "skype": "sample string 16",
    "notes": "sample string 17",
    "sales_organization_id": "12c3c040-4685-4db7-8355-8a778c7252f2",
    "sales_organization": {
      "id": "31d92bf3-4576-4a60-9eb1-c2853c560fb8",
      "code": "sample string 2",
      "name": "sample string 3",
      "description": "sample string 4",
      "db_country_id": "4ebeaeb2-2b1b-43e5-8d12-7dee23563b36",
      "db_currency_id": "2f1f5d0d-ac79-46d5-aef6-1fbae2e5fdf5",
      "db_language_id": "84568a5e-e049-4b63-b9de-2a0a0bf7f793",
      "accountancy_code": "sample string 8",
      "archived": true,
      "default_unit_of_measure_system_type": "sample string 10",
      "street": "sample string 11",
      "street2": "sample string 12",
      "street_number": "sample string 13",
      "zip": "sample string 14",
      "city": "sample string 15",
      "email": "sample string 16",
      "phone": "sample string 17",
      "fax": "sample string 18",
      "url": "sample string 19",
      "vat_reg_code": "sample string 20",
      "modified_dateutc": "2026-08-09T03:59:20.1320881+00:00"
    },
    "sales_organization_code": "sample string 19",
    "is_team_leader": true,
    "team_leader_user_id": "13959312-c805-44d7-bae5-b47bc9ea6d09",
    "email": "sample string 22",
    "phone": "sample string 23",
    "fax": "sample string 24",
    "mobile": "sample string 25",
    "private_email": "sample string 26",
    "private_phone": "sample string 27",
    "private_fax": "sample string 28",
    "private_mobile": "sample string 29",
    "private_street": "sample string 30",
    "private_street_number": "sample string 31",
    "private_city": "sample string 32",
    "private_zip": "sample string 33",
    "private_db_country_id": "6d2cf13a-7361-4abc-b58a-5d7eb237a5b5",
    "private_db_country_code": "sample string 35",
    "modified_dateutc": "2026-08-09T03:59:20.1320881+00:00",
    "allow_hero_app": true,
    "allow_sales_app": true,
    "allow_service_app": true,
    "user_group_id": "8715f6f6-9bb2-49ae-90f1-808ce6244b40"
  },
  "account_manager_user_code": "sample string 17",
  "modified_dateutc": "2026-08-09T03:59:20.1320881+00:00",
  "renewal_term_months": 19,
  "feelist_warranty_discount": 20.0,
  "price_label_warranty_discount": 21.0,
  "driving_distance": 22.0,
  "travel_fee_fix_discount": 23.0
}

Response Information

Resource Description :

IHttpActionResult

None.

Response Formats

application/json, text/json

Sample:

Sample not available.