---
# Employment Hero 薪资模块

[Employment Hero](https://employmenthero.com/) 模块可自动将工资单会计分录（如费用、社保费用、负债、税金）从 Employment Hero 同步至 Odoo。工资单的管理仍在 Employment Hero 中完成，但 **分录** 在 Odoo 中生成。

:::: important
::: title
重要
:::

KeyPay 已于 2023 年 3 月重新品牌为 **Employment Hero**。  
::::

## 配置 {#employment_hero/configuration}

1.  `Activate <general/install>` **Employment Hero 薪资模块** (`[l10n_employment_hero]`)。

2.  前往 `会计 --> 配置 --> 设置` 配置 **Employment Hero API**。点击 `启用 Employment Hero 集成` 后会出现更多字段。

    ![在 Odoo 会计中启用 Employment Hero 集成后，设置页面出现新字段](employment_hero/employment-hero-integration.png)

    - API Key 可在 Employment Hero 平台的 **我的账户** 页面找到。

      ![Employment Hero 仪表盘的“账户详情”栏目](employment_hero/employment-hero-myaccount.png)

    - **Payroll URL** 默认留空，以免产生混淆。请根据对应本地化文档填写。

      :::: note
      ::: title
      注
      :::

      Employment Hero 支持以下地区：

      - `澳大利亚 <payroll/l10n_au/employment-hero>`
      - `马来西亚 <malaysia/employment-hero>`
      - `新西兰 <new-zealand/employment-hero>`
      - `新加坡 <singapore/employment-hero>`
      - `英国 <localization/united-kingdom/employment-hero>`
      ::::
      
    - **Business ID** 可在 Employment Hero 的 URL 中找到（例如 `[189241]`）。

      ![Employment Hero 的 Business ID 位于 URL 中](employment_hero/employment-hero-business-id.png)

    - 选择任意 Odoo 分录账簿用于记录工资单分录。

3.  前往 `会计 --> 配置 --> 税务` 配置税务。为 Employment Hero 的工资单分录创建相应税种，并在 `匹配 Employment Hero 税务` 字段填写 Employment Hero 提供的税码。

## API 如何工作？

API 将 Employment Hero 的分录同步至 Odoo，并保持为草稿状态。分录的参考信息中会在括号内标注 Employment Hero 的工资单分录 ID，便于用户在两系统中快速对应。

![在 Odoo 会计中显示的 Employment Hero 分录示例（澳大利亚）](employment_hero/employment-hero-journal-entry.png)

默认情况下，同步每周执行一次。也可以手动抓取记录，路径为 `会计 --> 配置 --> 设置`，在 `启用 Employment Hero 集成` 选项下点击 `手动获取工资批次`。

Employment Hero 的工资单分录同样遵循复式记账原则。

Employment Hero 使用的账户在 `工资设置` 部分定义。

![Employment Hero 中的科目表菜单](employment_hero/employment-hero-chart-of-accounts.png)

为使 API 正常工作，需要在 Odoo 中创建与 Employment Hero 默认账户**同名同码**的账户，并选择正确的账户类型，以生成精准的财务报表。

# Employment Hero 薪资模块
## 功能概述
- 自动同步工资单会计分录至 Odoo
- Odoo 负责凭证记账
## 重要信息
- KeyPay 改名为 Employment Hero（2023 年 3 月）
## 配置步骤
### 1. 激活模块
- `Activate <general/install>` Employment Hero 薪资模块
### 2. 配置 API
- 前往 会计 → 配置 → 设置 → 启用 Employment Hero 集成
- 获取 API Key（My Account）
- 填写 Payroll URL（依据本地化文档）
- 获取 Business ID（URL 中）
- 选择 Odoo 分录账簿
### 3. 配置税务
- 会计 → 配置 → 税务
- 创建对应税种并填写 Matching Employment Hero Tax
## API 工作原理
- 同步分录至 Odoo，保持草稿状态
- 参考信息含 Employment Hero 分录 ID
- 默认每周同步，可手动抓取
- 采用复式记账，账户需与 Employment Hero 同名同码
## 支持地区
- 澳大利亚、马来西亚、新西兰、新加坡、英国