Add new contract record

This interface is used to add a new contract to a worker. If worker has an available contract in required country, it can't be added. If the worker is an expat staff, the worker may have up to two active contracts.

After the new contract is added, the country of the worker may be updated based on the country of the new contract.

Add worker's contract

POST /add-ee-contract

Headers

Name	Value
Content-Type	application/json
Authorization	Bearer <token>

Body

Name	Type	Required	Description
customer_id	number		The unique Marco identifier for your company
email	string		Account email of the user
country	string		Contract's country
contract_start_date	date		Contract's effective date
contract_end_date	date		Contract's end date
home_host	string		Is this a Home or Host Country for this person? Valid value: Home/Host
is_local	boolean		Is the person a Local or a Foreigner in this country?
staff_type	string		How is this person engaged for work in this country? Valid value: Internal/EOR/IC
contract_type	string		Contract Type Valid value: Fixed-term/Permanent
file	file resource		Contract file

Parameter Example

{
  "customer_id": "1",
  "email": "[email protected]",
  "country": "SG",
  "contract_start_date": "2024-09-01",
  "contract_end_date": null,
  "home_host": "Home",
  "is_local": false,
  "staff_type": "IC",
  "contract_type":"Fixed-term",
  "file":""
}

Response

200

{
    "id": 5055,
    "customer_id": 1,
    "country": 15,
    "is_local": false,
    "home_host": "Home",
    "staff_type": "IC",
    "ec_vendor": 0,
    "ec_entity": 0,
    "ec_type": "Fixed-term",
    "ec_copy": {
        "id": 21230,
        "file_name": "qrcode_for_gh_d210e8409f6d_860.jpg",
        "file_type": "jpg",
        "file_url": "https://marcopayroll-production.s3.ap-southeast-1.amazonaws.com/img/d92c8c4c-2017-4fbe-9cc3-98fa4245e13a-1729154903627.jpg?X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAR7OVYMK3MWXZDBXJ%2F20241017%2Fap-southeast-1%2Fs3%2Faws4_request&X-Amz-Date=20241017T084823Z&X-Amz-SignedHeaders=host&X-Amz-Expires=600&X-Amz-Signature=cbe19d5403e5555edc9df9eeea46b777335c97631b6fb54bc43fcd20c6b52109"
    },
    "start_date": "2024-09-11",
    "end_date": "2025-11-09",
    "ic_type": "",
    "ic_entity": 0,
    "user": 2232,
    "platform_email": "[email protected]"
}

400