越南

以下模块会随越南本地化一起自动安装：

名称技术名称描述
Vietnam - Accounting[l10n_vn]该模块包含默认的 财政本地化包 <fiscal_localizations/packages>。
Vietnam - E-invoicing[l10n_vn_edi_viettel]该模块包含与 SInvoice <localizations/vietnam/sinvoice> 集成所需的功能。

:::: note ::: title 注意 ::: 在某些情况下，例如升级到包含额外模块的版本时，模块可能不会自动安装。任何缺失的模块都可以手动 installed <general/install>。 ::::

要使用此财政本地化的全部功能，company record </applications/general/companies> 上必须填写以下字段：

  • 名称

  • 地址，包括 城市、州/省、邮编 和 国家。

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

  • 税号：税务识别号码。

SInvoice 是越南最大电子发票服务提供商之一 Viettel 提供的电子发票平台。Odoo 支持与 SInvoice 集成，以提交在 Odoo 中生成的发票。

要向 SInvoice 发送电子发票，需要在 SInvoice 上创建以下内容：

  • SInvoice 账户 <localizations/vietname/sinvoice-registration>
  • 发票模板 <localizations/vietname/sinvoice-template>
  • 发票符号 <localizations/vietname/sinvoice-symbol>
  • 开票通知 <localizations/vietname/sinvoice-notice>
SInvoice 注册 {#localizations/vietname/sinvoice-registration}

前往 SInvoice 注册所需套餐，填写弹出表单以便 SInvoice 与您联系并创建账户。

拥有账户后，使用 用户名 与 密码 登录 SInvoice。

发票模板创建 {#localizations/vietname/sinvoice-template}
  1. 在概览页左侧的 Release management（发布管理）菜单中，点击 Create business information（创建业务信息）。
  2. 在 Update key information（更新关键信息）步骤中，填写 单位名称、地址、联系人、代表文件类型 等必填及可选信息。
  3. 点击 Update（更新）。
  4. 在 Look up digital certificate（查找数字证书）步骤中，点击 Add new（新增）添加数字证书。
  5. 选择 分支/企业 与 数字证书类型，并根据类型填写必填字段，例如：
    • 供应商：CloudCA
    • 签名人 ID：CloudCA
    • 数字证书：CloudCA
    • 下载方式：HSM
    • 文件上传：HSM、USB‑TOKEN
  6. 点击 Generate key pair（生成密钥对）生成用于认证的加密密钥，然后 Save（保存）。
  7. 在 Manage invoice templates（管理发票模板）步骤中，新增 Invoice template（发票模板）。
  8. 选择 Invoice type（发票类型），填写 Invoice template code（模板代码）、Invoice template name（模板名称）以及其他可选信息。
  9. 点击 Update（更新）。

::: seealso SInvoice 电子发票模板创建文档 :::

发票符号创建 {#localizations/vietname/sinvoice-symbol}

在主界面左侧的 Release management 菜单中，点击 Invoice symbol（发票符号），按以下步骤操作：

  1. 点击 Add new（新增），选择对应的 Invoice template（发票模板）。
  2. 将 Status（状态）设为 Active（激活），并填写 Invoice symbol（发票符号）。
  3. 根据需要启用 Stop automatic sending to tax authorities（停止自动发送至税务机关）和 Default for built-in API（默认内建 API）。
  4. 点击 Save（保存）。
开票通知 {#localizations/vietname/sinvoice-notice}

在主界面左侧的 Release management 菜单中，点击 Create issuance notice（创建开票通知），按以下步骤操作：

  1. 点击 Add new，选择 业务单元名称 与 税务机关名称。系统会自动填入不可编辑的 税号、地址、电话、分隔符 等信息。
  2. 点击 Select the invoice type for issuance（选择开票类型），并填写以下信息：
    • Invoice type（发票类型）
    • Invoice template（发票模板）
    • Symbol（符号）
    • Quantity（数量）——系统会根据所选模板自动填入，可手动修改。
    • Start date of use（使用起始日期）
  3. 点击 Save（保存），如需添加更多发票类型，重复上述步骤。完成后再次点击 Save。
  4. 点击 Send to tax authorities（发送至税务机关）进行审批。审批通过后，通知的 Status（状态）会变为 Active（激活）。
将 Odoo 链接至 SInvoice

进入 Accounting --> Configuration --> Settings（会计 → 配置 → 设置），在 Vietnamese Integration（越南集成）区块填写 SInvoice 的 Username（用户名）和 Password（密码）。如有需要，可添加 Default symbol（默认符号）作为 SInvoice 管理的发票编号前缀。

发票模板

在 Accounting --> Configuration --> Templates（会计 → 配置 → 模板）中新建模板，填写 Template code（模板代码）和 Template Invoice Type（模板发票类型）。模板代码是 SInvoice 分配的编号前缀，例如发票模板 [1/001 - Hóa đơn GTGT - ND123] 的代码为 [1/001]。Odoo 中的 SInvoice 模板必须与 SInvoice 平台保持一致。

如需添加 Invoice Symbols（发票符号），点击 Add a new line（添加新行）。

发票确认后即可发送至 SInvoice，操作步骤与 invoice sending <accounting/invoice/sending> 相同。在 Send（发送）弹窗中勾选 Send to SInvoice（发送至 SInvoice），然后点击 Send & Print（发送并打印）。

成功提交后，发票的 SInvoice 标签页会显示 SInvoice Status（状态）为 Sent（已发送），并同步更新 SInvoice Number（编号）、Issue Date（开票日期）、Secret Code（密钥码）以及 eInvoice Number（电子发票编号），这些信息在 SInvoice 平台也可查询。

  • 替换发票：用于纠正尚未进行税务申报的发票。
  • 调整发票：用于纠正已完成税务申报的发票。

操作步骤：

  1. 打开发票，点击 Credit Note（红字冲销）。
  2. 在弹窗中填写 Reason displayed on Credit Note（冲销原因）、Adjustment type（调整类型）、Agreement Name（协议名称）、Agreement Date（协议日期）、Journal（日记账）以及 Reversal date（冲销日期）。
  3. 若要生成替换发票，点击 Reverse and Create Invoice（冲销并创建发票）；若仅做调整，点击 Reverse（冲销）。

对应的 SInvoice Status 会更新为 Replaced（已替换）或 Adjusted（已调整）。

若需作废发票：

  1. 打开发票，点击 Request Cancel（请求作废）。
  2. 在弹窗中填写作废 Reason（原因）、Agreement Name（协议名称）和 Agreement Date（协议日期），然后点击 Request Cancellation（请求作废）。

作废后，SInvoice 标签页的状态会变为 Canceled（已作废）。

越南 QR 银行码是一种支付服务平台，允许客户通过线上或移动银行，以越南盾即时向个人或商户付款。

在 Accounting --> Configuration --> Settings（会计 → 配置 → 设置）中，启用 Customer Payments（客户付款）区块的 QR Codes（二维码）功能。

为银行账户启用 QR 银行码：

  1. 前往 Contacts --> Configuration --> Bank Accounts（联系人 → 配置 → 银行账户），选择对应的银行账户。
  2. 填写 Bank Identifier Code（银行标识码）、Proxy Type（代理类型）以及 Proxy Value（代理值），这些字段用于标识 Merchant Account（商户账户），如卡号或银行账户号。
  3. 启用 Include Reference（包含引用），将在二维码中嵌入发票号码。

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

  • 账户持有人的 Country（国家）必须设置为 Vietnam（越南），且在联系人表单中填写 City（城市）。
  • 必须在 Bank（银行）日记账中设置 account number（账号）和对应的银行。 ::::

::: seealso ../accounting/bank :::

创建新发票时，打开 Other Info（其他信息）标签页，在 Payment QR-code（付款二维码）字段中选择 EMV Merchant-Presented QR-code（EMV 商户呈现二维码）。

:::: note ::: title 注意 ::: 确保已配置 Recipient Bank（收款银行），Odoo 会使用该字段生成二维码。 ::::