与 BambooHR 集成

与 BambooHR 集成

Crystal Payroll 提供与 BambooHR 的全面集成，BambooHR 是一款全球人力资源管理软件，被超过 30,000 家不同规模的企业使用。该集成允许您只需点击一下即可获取员工信息、发送请假余额以及更新薪资。

Setting Up BambooHR

首先，请确保您已购买 BambooHR 的 Advantage 套餐，因为 Essentials 套餐不支持 Open API，而这是 Crystal Payroll 连接您的 HR 系统所必需的。您可以在此查看他们的套餐：BambooHR plans and pricing.

登录 BambooHR。点击页面右上角的姓名或头像，然后选择 "API Keys"。

点击 "Add New Key"。

输入任意名称作为 "API Key Name"，例如 "Crystal Payroll"。

点击 "Generate Key"。

点击 "Copy Key" 并将其保存在安全的位置。如果忘记了，可以重复此步骤。

点击 "Done"。

现在，请检查 "Time Off" 类别是否与 Crystal Payroll 中的完全一致。名称必须完全匹配 —— 不能有多余空格、不同字符或单位不一致。

应设置以下请假类别名称：

"Annual Leave" 表示年假，单位为小时。默认情况下其名称为 "Vacation Leave"，因此需要重命名或新建。

"Sick Leave" 表示病假，单位为天。

"Alternative Leave" 表示调休假，单位为天。

在 BambooHR 中管理这些假期最简单的方法是将其都设置为 "Manual Policy"，由 Crystal Payroll 完全控制假期累计。

最后一个步骤必须在新西兰时间周二至周六中午 12 点前完成，因为需要联系设于美国的 BambooHR 支持。如果在其他时间尝试，此选项将不可用。

点击 BambooHR 页面右上角的 "Question Mark" 图标。

选择 "Chat with us now"。

请不要自行创建这些字段，因为它们需要后台指定的 ID。

当聊天框打开并有客服人员响应时，请 原样复制并粘贴以下信息，不要更改任何内容，否则集成功能可能无法正常使用：

Dear BambooHR,

I am setting up an integration with my payroll system and have been provided the following letter for you.

Please add the following tab and fields under the "People" dashboard:

New custom tab: "Payroll | CP".

New custom text field: "IRD Number (000-000-000) | CP", background ID: customIRDNumberCP

New custom text field: "Tax Code (X or X XX or XX XX) | CP", background ID: customTaxCodeCP

New custom text field: "Withholding Tax Rate (%) (Optional) | CP", background ID: customWithholdingTaxRateCP

New custom text field: "Bank Account Number (00-0000-0000000-00) | CP", background ID: customBankAccountNumberCP

New custom text field: "Default Hours (M-T-W-T-F-S-S) | CP", background ID: customDefaultHoursCP

New custom text field: "KiwiSaver Employee Contribution (%) | CP", background ID: customKiwiSaverEmployeeContributionCP

New custom text field: "KiwiSaver Employer Contribution (%) | CP", background ID: customKiwiSaverEmployerContributionCP

New custom text field: "KiwiSaver ESCT Rate (%) | CP", background ID: customKiwiSaverESCTRateCP

New custom text field: "Casual Employee (Y or N) | CP", background ID: customCasualEmployeeCP

New custom text field: "Region for Anniversary Day (Optional) | CP", background ID: customRegionforAnniversaryDayCP

所有字段应为可选，必须为文本类型，并包括所有括号和字符。

Warm regards

客服设置完成后，您将在每位员工的资料页下看到一个新标签页和额外字段：

Setting Up Crystal Payroll

进入 "Company Settings"，然后点击 "Import/Export"。在 "API Settings" 下拉菜单中，选择 "BambooHR"，然后点击 "Save"。

输入您的 "Client ID"，它通常是您的 BambooHR 域名前缀。如果不确定，可在登录页面浏览器地址栏中查看，".bamboohr.com" 前的部分就是您的 Client ID。

输入您之前保存的 "API Key"。

点击 "Save"。

Using the Integration

在 "Employee Settings" 中进入 "Employee Details"，然后点击页面右上角的 "BambooHR"。

您将看到以下三项操作：

导入来自 BambooHR 的新员工

更新员工的薪资信息

更新员工的详细资料

除假期余额外，所有信息都从 BambooHR 拉取。这意味着您可在 BambooHR 中管理员工资料，并在需要时同步至 Crystal Payroll。

假期余额则反过来。当员工请假或获得新假期权益时，点击右上角 "Step 2: Update Leave Balances" 将更新的余额发送至 BambooHR。

如图所示，BambooHR 的集成简单高效，可节省时间，消除重复录入，让人事管理更高效。希望本指南对您有所帮助。