Odoo 秘鲁本地化模块及电子发票完整配置指南

作者： /

秘鲁

模块

Install <general/install> 以下模块以使用秘鲁本地化的全部功能。

名称技术名称描述
Peru - Accounting[l10n_pe]为秘鲁本地化添加会计功能，包含公司在秘鲁运营所需的最小配置，符合 SUNAT 规定。主要包括科目表、税种、单据类型等。
Peru - E-invoicing[l10n_pe_edi]包含生成和接收基于 SUNAT 规制的电子发票所需的全部技术和功能要求。
Peru - Accounting Reports[l10n_pe_reports]包含以下财务报告：
– 主财务报告集：
  – Registro de Ventas e Ingresos (RVIE) – 14.4
  – Registro de Compras Electrónico (RCE) – 8.4
  – Registro de Compras Electrónico – Información de Operaciones con Sujetos no Domiciliados (RCE) – 8.5
– 第二套报告：
  – PLE 5.1 General Journal
  – PLE 5.3 Chart of Accounts
  – PLE 6.1 General Ledger
– 第三套报告：
  – PLE 1.1 Libro de Caja
  – PLE 1.2 Libro de Bancos
Peruvian - Electronic Delivery Note[l10n_pe_edi_stock]添加送货单（Guía de Remisión），作为货物在 A 与 B 之间运输的凭证。仅在送货单验证后才能生成。
Peru - Stock Reports[l10n_pe_reports_stock]启用 PLE 报告 <peru/reports-ple>，用于永久库存记录（实物单位和计价库存）。
Peruvian eCommerce[l10n_pe_website_sale]在电商结算表单中加入身份类型字段，并支持生成电子发票。
Peruvian - Point of Sale with PE Doc[l10n_pe_pos]允许在 POS 会话中编辑税务信息，以生成电子发票和退款单。

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

  • Odoo 会根据数据库创建时选择的国家自动安装相应的本地化包。
  • 秘鲁电子送货指南 模块依赖已安装的 库存 应用。
    ::::

::: seealso

配置

安装秘鲁本地化模块

在 Apps 中搜索 Peru，点击 Peru EDI 安装。该模块依赖 Peru – Accounting，如果后者未安装，Odoo 会自动在安装 EDI 时一起装上。

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

从零新建数据库并选择 秘鲁 为国家时，Odoo 会自动安装基础模块 Peru – Accounting。
::::

配置公司

在公司设置中将 Country 设为 秘鲁，并填写 Address Type Code（SUNAT 为公司分配的机构代码），该字段对应 RUC 注册时的机构代码。

:::: tip
::: title
技巧
:::

如果不知道地址类型代码，可先填 0000 作为默认值；但若填写错误，电子发票验证会出错。
::::

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

NIF 必须采用 RUC 格式填写。
::::

科目表

本地化模块默认安装秘鲁最新的 PCGE (Plan Contable General Empresarial) 科目表，并自动映射到：

  • 税务
  • 默认应付科目
  • 默认应收科目

该科目表兼容 NIIF（国际财务报告准则）。

会计设置

模块安装完毕并完成公司基本信息后，进入 会计 → 设置 → 秘鲁本地化，配置电子发票所需的元素。

基本概念

  • EDI：电子数据交换，即电子发票。
  • SUNAT：秘鲁海关与税务监管机构。
  • OSE：电子服务运营商，SUNAT 官方定义见此处。
  • CDR：收据证书（Constancia de Recepción）。
  • SOL Credentials：SUNAT 在线操作系统的用户名/密码，由 SUNAT 提供。

签名提供商

公司必须选择签名提供商来完成文档签名并处理 SUNAT 的验证响应，Odoo 提供三种选项：

  1. IAP (Odoo In‑App Purchase) – 默认推荐，包含数字证书服务。
  2. Digiflow – 需自行购买数字证书并与 Digiflow 签订服务协议。
  3. SUNAT – 直接使用 SUNAT 官方证书。
IAP（Odoo 应用内购买）
  • Odoo 提供电子发票证书，无需自行采购。
  • 文档会先发送至 OSE（此处为 Digiflow），再返回 CDR。
  • 需要 Credits（积分）来处理每份文档。新库默认赠送 1000 积分，后续需购买：
-----------------
 Credits   EUR
-----------------
 1000      22
 5000      110
 10,000    220
 20,000    440
-----------------

每发送一次文档（包括重发）会消耗 1 积分。

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

若验证错误需重发，系统会再扣除 1 积分，请务必在发送前确认信息无误。
::::

使用步骤：

  • 在企业合同激活后，生产环境首次用完 1000 积分即需购买。
  • 在 SUNAT 网站上将 Digiflow 设为官方 OSE（参考[OSE 关联指南]）。
  • 在 SUNAT 网站登记 Digiflow 为授权 PSE（参考[PSE 关联指南]）。
Digiflow
  • 需自行购买数字证书（参考 SUNAT 官方数字证书列表）。
  • 与 Digiflow 签订服务协议并提供 SOL 凭证。
SUNAT
  • 直接使用 SUNAT 证书并提供 SOL 凭证。
  • SOL 用户名格式为 RUC + 用户ID（如 20121888549JOHNSMITH）。

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

使用 SUNAT 直连时，SOL 用户必须设为 公司 RUC + 用户ID。
::::

测试环境

Odoo 提供可在生产前激活的测试环境。使用 IAP 签名时，测试积分免费，无需额外购买。

:::: tip
::: title
技巧
:::

默认数据库为生产模式，若需测试请手动开启测试模式。
::::

证书

若不使用 IAP，需要自行上传 .pfx 格式的数字证书及密码。

多币种

SUNAT 提供官方汇率，Odoo 可直接同步获取（自动或手动）。

更多信息请参阅 multicurrencies <../accounting/get_started/multi_currency>。

主数据配置

税务

本地化模块自动创建税种并关联财务科目及电子发票配置。若自行创建税种，请填写以下 EDI 必填字段：

财务位置

默认包含两种财务位置：

  • Extranjero – Exportación（出口）
  • Local Peru（本地）

单据类型

秘鲁的发票、供应商账单等需使用 SUNAT 规定的单据类型，系统在安装本地化模块时已自动创建。

:::: warning
::: title
警告
:::

当前支持的客户发票单据类型包括：Factura、Boleta、Debit Note、Credit Note。
::::

日志（Journals）

创建销售日志时需填充：

  • Use Documents：指示该日志使用单据类型（仅对采购/销售日志有效）。
  • Electronic Data Interchange：选择 “Peru UBL 2.1”。

:::: warning
::: title
警告
:::

默认显示的 Factur‑X (FR) 需手动取消勾选。
::::

合作伙伴

在合作伙伴表单中出现 SUNAT 定义的 Identification Type 与 VAT，务必填写完整。

产品

产品表单新增 UNSPC Code（海关编码），为必填项。

使用与测试

客户发票

EDI 要素

创建发票时需额外填写：

  • Document type（默认 “Factura Electronica”，可改为 Boleta）。
  • Operation type（默认 “Internal Sale”，出口等场景需改为对应类型）。
  • EDI Affectation Reason（税务行的 EDI 影响原因，可手动调整）。

发票验证

点击 Validate 后，系统生成会计分录并触发电子发票工作流，发送至 OSE 与 SUNAT。

电子发票状态
  • To be Sent：待发送，可通过 cron 每小时自动发送，也可手动点击 Sent now。
  • Sent：已发送并成功验证，系统会下载 ZIP 并在 chatter 记录验证信息。

如出现验证错误，状态仍保持 To be Sent，可修正后重新发送。

:::: warning
::: title
警告
:::

每发送一次文档会消耗 1 积分；若因错误重发，则累计消耗 2 积分。
::::

常见错误

  • 主数据错误（如合作伙伴身份类型不匹配） → 修改后点击 Retry。
  • 发票行错误（如缺少操作类型） → 将发票恢复为 Draft，修改后重新发送。

详细错误列表请参考 [SUNAT 常见错误]。

发票 PDF 报告

验证通过后可打印包含 QR 码的 PDF 发票。

IAP 积分

免费赠送 1000 积分，耗尽后需在 Invoices 顶部提示中购买。价格以 EUR 计价。

特殊用例

  • 取消流程：已发送且验证通过的发票，可点击 Request Cancellation 并填写原因。状态会转为 To Cancel → Cancelled。每次取消消耗 1 积分。
  • 出口发票：客户需使用 Foreign ID，操作类型设为出口，税种使用 EXP。
  • 预付款：先创建预付款发票并付款 → 创建不含预付款的正式发票 → 为正式发票创建冲减信用票据 → 将信用票据与正式发票对账。
  • 扣缴发票：产品需配置扣缴字段，操作类型设为 1001。

信用票据

在已验证发票上点击 Add Credit Note，选择信用原因并设置 Credit Method: Partial Refund（可自定义序列）。

默认文档类型已设为 Credit Note。

借记票据

在已验证发票上点击 Add Debit Note，系统会自动使用相应的文档类型。

电子送货单 2.0

电子送货单（GRE）是用于证明货物转运的电子凭证，必须直接发送至 SUNAT。

送货单类型

  • Sender（发件方）：由货物所有者（发件人）在发货开始时开具，Odoo 支持。
  • Carrier（承运方）：由承运人开具，Odoo 暂不支持。

运输方式

  • Private：自有车辆运输，需使用 Sender 送货单。
  • Public：外部承运人运输，需要 Sender 与 Carrier 两张送货单（后者 Odoo 不支持）。

直接提交至 SUNAT

无论使用 IAP、Digiflow 还是 SUNAT，GRE 必须直接发送至 SUNAT。

必填信息

GRE 2.0 需要在 General Configuration、Vehicles、Contacts、Products 中补充额外信息，并在 SUNAT 门户获取 Client ID 与 Client Secret。

取消

发货单在未发运或收货人更换前均可取消；SUNAT 现将 “Anula” 改为 “Dar de baja”。每次取消消耗 1 积分。

测试

SUNAT 不提供测试环境，误生成的送货单会直接发送至正式系统，需在 SUNAT 门户手动删除。

配置步骤

  1. 安装 Peru - Electronic Delivery Note 2.0（l10n_pe_edi_stock_20）模块。
  2. 在 SUNAT 门户获取 Guide Client ID、Guide Client Secret、Guide SOL User（RUC+UsuarioSol）以及 Guide SOL Password。
  3. 前往 Inventory → Configuration → Settings，在 Peru Delivery Guide 区域填写上述字段。

![SUNAT 送货单 API 配置示例](peru

滚动至顶部