Option Set

The Marco Option Set defines standardized, pre-configured values used across the Marco Global Payroll API. Use these values when creating or updating records to ensure consistency in your data.

General Options

Option Set Name	Valid Values	Description
Country	US, CN, MY, SG, etc.	Based on ISO 3166 Alpha-2.
State/Province	US-CA, US-AL, etc.	Follows the same ISO 3166 Alpha-2 code format for the subnational divisions.
Language (lang)	EN, ZH	Currently supports English (EN) and Chinese (ZH).
Currency	USD, MYR, SGD, CNY etc.	Standard ISO 4217 currency codes.

---

User & Employment Options

Option Set Name	Valid Values	Description
User Profile Type	Manager Only Staff Only Manager & Staff	Determines access level and responsibilities within the system.
User Gender	Male Female	Used for employee demographic information.
User Status	Regular Probation Onboarding Offboarded	Indicates the current employment stage of a user.
User Offboarding Reason	Voluntary Involuntary Service Deactivation	Specifies the nature of employee termination or departure.
Contract Country Type	Home Host	Choose between home or host country.
Contract Staff Type	Internal EOR IC	Identifies the staff type under contract.
Contract Type	Fixed Term Permanent	Classifies employment contract structure.

---

Payroll Options

Option Set Name	Valid Values	Description
Pay Item Frequency	Hourly Daily Weekly Bi-weekly Semi-Monthly Monthly Quarterly Half-Yearly Yearly One-Time	Frequency of payroll item application.
Pay Item Category	Salary Overtime Allowance Bonus Deduction Reimbursement	Categorization of payroll items for reporting and calculation.
Pay Item Type	Gross Net CTC	Defines how pay items are calculated and displayed.
Bank Account Type	Personal Company	Type of account linked to the user for payroll disbursement.
Bank Account Payment Type	Local Swift	Method used for fund transfer.

---

Time & Leave Options

Option Set Name	Valid Values	Description
Leave Type Balance Type	Days Hours	Unit of measurement for leave balance.
Leave Day Type	Working Calendar	Defines how leave days are calculated. Working: Counts only business or working days, excluding weekends and holidays. Calendar: Counts all consecutive days, including weekends and holidays.
Time Off Unit Type	Days Hours	Input method for submitting time-off requests.
Time Off Day Type	Full First Half Second Half	Specifies the duration of leave taken within a day.
Decision	Pending Approval Rejected	Used for approval workflows (e.g: leave, expense)
Expense Status	Submitted, Approved, Rejected, Processing, Processed	Tracks the current state of an expense claim.