Get pay item by country

Marco system will provide pay items as required by country law. And Marco system also supports customers to use customized pay items. This interface can be use to get legal required pay items or all pay items that customers can use.

Each pay item contains:

  • Country

  • Pay item name

  • Pay item notes

  • Category - Salary / Allowance / Bonus / ER Contribution / EE Contribution / EE Tax

Get pay item

GET /pay-item

Gets all default pay items for a given country.

Headers

Name
Value

Content-Type

application/json

Authorization

Bearer <token>

Body

Name
Type
Required
Description

country

string

Pay item country Country Code Format: "US" (use ISO 3166 Alpha-2 code)

lang

string

Pay item language format as "EN"/"ZH"

customer_id

number

The unique Marco identifier for your company.

Parameter Example:

{
  "country": "US",
  "lang": "EN",
  "customer_id":"1"
}

Response

[
    {
        "id": 354,
        "country": "CN",
        "customer": 0,
        "category": "Salary",
        "pay_item_name": "Basic Salary",
        "pay_item_notes": "Basic Salary"
    },
    {
        "id": 355,
        "country": "CN",
        "customer": 0,
        "category": "Allowance",
        "pay_item_name": "Transportation Allowance",
        "pay_item_notes": "Transportation Allowance"
    },
    {
        "id": 2167,
        "country": "CN",
        "customer": 1,
        "category": "Bonus",
        "pay_item_name": "Test Pay Item 1",
        "pay_item_notes": "Test Pay Item 1"
    },
    {
        "id": 2550,
        "country": "CN",
        "customer": 1,
        "category": "Bonus",
        "pay_item_name": "Test Pay Item 2",
        "pay_item_notes": "Test Pay Item 2"
    },
    {
        ...
    }
]

Last updated