马来西亚

Install <general/install> 以下模块以获取马来西亚本地化的全部功能：

名称 技术名称 描述
Malaysia - Accounting l10n_my 此模块包含默认的 财政本地化包 <fiscal_localizations/packages>。
Malaysia - Accounting Reports l10n_my_reports 此模块提供马来西亚的会计报表。
Malaysia - UBL PINT l10n_my_ubl_pint 此模块提供导出 PINT 格式发票所需的功能。
Malaysia - E-invoicing l10n_my_edi 此模块提供与 IRBM 下的 MyInvois 集成所需的功能。

要配置公司信息，请进入 Contacts 应用，搜索并选择您的公司，然后填写以下字段：

  • 名称

  • 地址（包括 城市、州/省、邮编、国家）

    • 在 Street（街道）字段中，输入街道名称、门牌号以及其他地址信息。
    • 在 Street 2（街道 2）字段中，输入所在社区或街区信息。

  • 税号：税务识别号码

  • SST：马来西亚销售与服务税号（如适用）

  • TTx：马来西亚旅游税号（如适用）

  • 电话

MyInvois 门户是由 IRBM（马来西亚国内税务局） 提供的一个平台，帮助马来西亚纳税人实现电子发票。Odoo 支持与 MyInvois 的集成，以提交在 Odoo 中生成的发票。

::: note 注意
必须安装 Malaysia - E-invoicing 模块才能向 MyInvois 提交发票。 :::

要向 MyInvois 发送电子发票，首先需要在 MyInvois 门户注册并登录，以授予 Odoo 作为贵公司中介的 开票权。

::: note 注意
首次登录 MyInvois 门户时，可在 MyTax 上点击 User Manual 了解注册流程。系统支持 预生产（用于在实际生产环境前测试功能）和 生产（实际提交电子发票）两种环境。 :::

  1. 登录 MyTax。选择 ID Type 并填写用于数字证书注册的 identification number。

  2. 在仪表盘右上角点击 fa-angle-down（向下箭头）图标，选择 View Taxpayer Profile（查看纳税人档案）。

  3. 在 Representatives（代表）部分，点击右上角的 Add Intermediary（添加中介）。

  4. 使用以下信息将 [ODOO S.A.] 添加为中介人：

    • TIN：C57800417080
    • BRN：BE0477472701
    • 名称：
      • Production（生产环境）：ODOO S.A.
      • Pre-production（预生产环境）：OXXX_XXXXA.

  5. 点击 fa-toggle-on（切换开启）图标，授予以下权限：

    • Representation From（代表权限）
    • Document - Submit（文档提交）
    • Document - Cancel（文档撤销）
    • Document - Request Rejection（文档请求拒绝）

    ::: note 注意

    • 如有需要，权限可在以后撤销。
    • Odoo 作为中介方，不会在代理服务器上存储代表客户发送的发票。 :::

  6. 点击 Save（保存）。此时 [ODOO S.A.] 的状态为 Active（已激活）。

公司 {#malaysia/myinvois/setup/odoo/einvoicing}

打开 Settings（设置）应用，进入 Companies（公司）章节，点击 Update Info（更新信息）。确保已填写 Tax ID（税号），并在 E-invoicing（电子发票）部分完成以下字段：

  • Identification（识别信息）：选择 ID Type 并填写用于数字证书注册的 Identification number。
  • Ind. Classification（行业分类）：输入表示企业性质和活动的 5 位数字代码。
电子发票

进入 Accounting → Configuration → Settings（会计 → 配置 → 设置），在 Malaysian Electronic Invoicing（马来西亚电子发票）章节，根据公司在 MyInvois 的注册环境选择相应的 MyInvois mode（模式）。

勾选允许 Odoo 处理电子发票的复选框后，点击 Register（注册）。

::: note 注意
若需更改 TIN（税号）引用，请先点击 Unregister（注销），修改公司信息，使 MyInvois 上的号码保持一致后再次 Register（注册）。 :::

::: important 重要
对于税号以 “IG” 开头且同时拥有 ROB（营业登记号）的纳税人，请在 Tax ID 字段中使用 TIN:ROB 的格式。完成注册后，可在 Tax ID 中去除 :ROB。此外，登录 MyTax 账户后，需要将 Type of Role（角色类型）设为 Business Owner（企业所有者）。 :::

联系人 {#malaysia/myinvois/setup/odoo/company}

在联系人表单中填写以下字段：

  • Country（国家）
  • State（州/省）
  • Phone（电话）
  • Tax ID（税号）
  • Identification：ID Type 与在 MyTax 上注册的对应 Identification number。
产品 {#malaysia/myinvois/setup/odoo/product}

所有需要开具电子发票的产品必须包含马来西亚分类代码。进入 Product（产品）表单的 General Information（通用信息）标签页，填写 Malaysian classification code（马来西亚分类代码）字段。

马来西亚税种

要配置税的 Malaysian Tax Type（马来西亚税种），进入 Accounting → Configuration → Accounting → Taxes，在税列表视图中打开相应税种。

当发票或账单的税种被设置为 Tax Exempt（免税）时，必须在 MyInvois 标签页中填写 Tax Exemption Reason（免税原因）后才能发送文档。

发票确认后即可点击 Send to MyInvois（发送至 MyInvois）进行提交。

当代表供应商开具电子发票时，需要发送账单至 MyInvois。账单确认后，点击 Send To MyInvois（发送至 MyInvois）。

::: note 注意

  • 在 MyInvois 中，这类供应商账单被归类为 Self-billed Invoice（自开票）。
  • 若 Bill Reference（账单参考）字段为空，系统将使用 Odoo 的供应商账单编号作为 MyInvois 编号；若填写了参考号，则使用该参考号。 :::
MyInvois 状态 {#malaysia/myinvois/workflow/sending/status}

发票或账单的当前 MyInvois 状态显示在 MyInvois State（MyInvois 状态）字段中：

  • Validation in Progress（验证中）：MyInvois 正在处理验证，页面会出现蓝色的 Processing（处理中）横幅。
  • Valid（已验证）：验证通过后，会自动更新 Submission UID、MyInvois 和 Validation Time（验证时间）等信息。

::: note 注意
Odoo 会每小时自动检查并更新状态。若需随时手动更新，点击 Update MyInvois Status（更新 MyInvois 状态）。 :::

已发送的发票在 Validation Time（验证时间）起 72 小时内可撤销。打开发票，点击 Request Cancel（请求撤销），在弹窗中填写撤销 Reason（原因），然后点击 Update Invoice（更新发票），状态将变为 cancelled（已撤销）。

发送冲减单前，原始发票必须已成功提交至 MyInvois，否则冲减单的 MyInvois State 将显示为 Invalid（无效）。

Odoo 只使用一种 credit note（冲减单）文档，而 MyInvois 会依据冲减单的对账方式区分为：

  • MyInvois Credit Note：当 Odoo 冲减单与原始发票对账时生成。
  • MyInvois Refund Note：当 Odoo 冲减单与全额付款对账时生成。

::: note 注意
如果冲减单在发送前仅与部分付款对账，仍会在 MyInvois 中归类为 credit note（冲减单）。 :::

::: tip 提示
若需对同一原始发票同时生成冲减单和退款单：

  1. 在 Odoo 中分别创建两个冲减单。
  2. 对于 MyInvois Refund Note：在发送前先登记付款。
  3. 对于 MyInvois Credit Note：发送前不要登记付款。 :::

::: note 注意
从账单生成的冲减单同理：若与全额付款对账，则为 Self-billed Refund Note（自开退款单），否则为 Self-billed Credit Note（自开冲减单）。 :::

从已有账单或发票 Issue a debit note（开具借项单）后，点击 Send To MyInvois。在 MyInvois 中，若来源于发票则显示为 Debit Note，若来源于供应商账单则显示为 Self-billed Debit Note（自开借项单）。

文档成功提交至 MyInvois 后，PDF 版会附加一个 QR 码。扫描该码即可直接打开 MyInvois 中已验证的文档。

下载 PDF 的步骤：

  1. 点击 fa-cog（齿轮）图标
  2. 选择 Download（下载）
  3. 选择 PDF 或 PDF without Payment（无付款信息的 PDF）

如果贵公司已经在使用 Employment Hero，可以通过我们的连接器将其作为马来西亚的替代薪资方案。

::: important 重要
配置 马来西亚 的 Employment Hero API 时，请将 Payroll URL 设置为：

https://apimy.yourpayroll.io/

:::