秘鲁¶
模块¶
安装 以下模块以利用秘鲁本地化的所有当前功能。
名称 |
技术名称 |
描述 |
|---|---|---|
Peru - Accounting |
|
为秘鲁本地化添加会计功能，这些功能代表了公司在秘鲁运营并遵守 SUNAT 法规和指南所需的最低配置。此模块中包含的主要元素包括会计科目表、税种、单据类型。 |
秘鲁 - 电子发票 |
|
包括根据 SUNAT 法规生成和接收在线电子发票的所有技术和功能要求。 |
秘鲁 - 会计报告 |
|
包括以下财务报表：
|
秘鲁 - 电子交货单 |
|
添加了交货指南（Guía de Remisión），这是作为您在A和B之间发送货物的证明所需的。只有在交货单被验证后，交货指南才能被创建。 |
Peruvian eCommerce |
|
在电子商务结账表单中启用身份识别类型，并具备生成电子发票的能力。 |
秘鲁 - 带有 PE 文档的销售点 |
|
允许从 PoS 会话中编辑联系人的财务信息，以生成电子发票和退款。 |
注解
Odoo 会根据创建数据库时选择的国家自动为公司安装相应的软件包。
Peruvian - Electronic Delivery Guide 模块依赖于已安装的 Inventory 应用程序。
配置¶
安装秘鲁本地化模块¶
转到 应用 并搜索 Peru，然后在模块 Peru EDI 上点击安装。此模块依赖于 Peru - Accounting。如果此模块未安装，Odoo 会自动在 EDI 中安装。
注解
当您选择秘鲁作为国家安装数据库时，Odoo会自动安装基础模块：秘鲁 - 会计。
配置您的公司¶
除了公司的基本信息外，我们需要将秘鲁设置为国家，这对于电子发票的正常工作至关重要。字段 地址类型代码 表示SUNAT在公司注册其RUC（唯一贡献者注册）时分配的机构代码：
小技巧
如果地址类型代码未知，您可以将其设置为默认值：0000。请注意，如果输入了不正确的值，则电子发票验证可能会出现错误。
注解
NIF应按照RUC格式设置。
科目表¶
默认情况下，会安装账户表作为本地化模块中包含的数据集的一部分，账户会自动映射到以下位置：
税
默认应付账户。
默认应收账款账户
秘鲁的账户表基于最新版本的 PCGE ，它分为几个类别，并与NIIF会计兼容。
会计设置¶
一旦安装了模块并设置了公司的基本信息，您需要配置所需的电子发票元素。为此，请转到： 。
基本概念¶
以下是秘鲁本地化中必不可少的一些术语：
EDI: 电子数据交换，这里指的是电子发票。
SUNAT：是负责执行秘鲁的海关和税收的组织。
OSE: 电子服务运营商, OSE SUNAT’s 定义.
CDR：收据证明（Constancia de Recepción）。
SOL凭证：Sunat Operaciones en Línea。用户和密码由SUNAT提供，并授予对在线操作系统的访问权限。
签名提供者¶
作为秘鲁电子发票的要求之一，您的公司需要选择一个签名提供商来处理文档签名过程并管理SUNAT验证响应。Odoo提供了三个选项：
IAP（Odoo应用内购买）
迪吉流
SUNAT
请参考下面的章节，以检查每个选项的详细信息和注意事项。
IAP（Odoo应用内购买）¶
这是默认和建议的选项，考虑到数字证书已经作为服务的一部分包含在内。
什么是IAP？¶
这是Odoo直接提供的签名服务，该服务负责以下过程：
提供电子发票证书，您无需自行获取。
将文档发送给 OSE，在本例中为 Digiflow。
接收 OSE 验证和 CDR。
它是如何工作的？¶
该服务需要信用点才能处理您的电子文档。Odoo在新数据库中提供1000个免费信用点。使用完这些信用点后，您需要购买信用点套餐。
信用 |
欧元 |
|---|---|
1000 |
22 |
5000 |
110 |
10,000 |
220 |
20,000 |
440 |
每发送一份文件到 OSE，就会消耗一定数量的信用点数。
重要
如果您遇到验证错误，需要再次发送文件，则会收取额外的信用点。因此，在将文件发送给 OSE 之前，请务必验证所有信息是否正确。
你需要做什么？¶
在Odoo中，一旦您的企业合同被激活并开始生产，您需要在消耗前1000个信用点后购买信用点。
由于Digiflow是IAP中使用的OSE，您需要在SUNAT网站上将其作为您公司的官方OSE进行关联。这是一个简单的过程。有关更多信息，请查看 OSE关联指南。
将Digiflow注册为授权的PSE，请查看 PSE Affiliation guide.
迪吉流¶
您可以使用此选项作为替代方案，而不是使用IAP服务，您可以直接将您的文档验证发送到Digiflow。在这种情况下，您需要考虑以下事项：
购买您自己的数字证书：有关官方供应商列表的详细信息和获取过程，请参阅 SUNAT 数字证书。
与 Digiflow 直接签订服务协议。
提供您的SOL凭据。
SUNAT¶
如果您的公司想直接与SUNAT签署协议，您可以在配置中选择此选项。在这种情况下，您需要考虑：-获得SUNAT认证过程的批准。
购买您自己的数字证书：有关官方供应商列表的详细信息和获取过程，请参阅 SUNAT 数字证书。
提供您的SOL凭据。
重要
当使用与SUNAT的直接连接时，SOL用户必须设置为公司RUT +用户ID。示例： 20121888549JOHNSMITH
测试环境¶
Odoo提供了一个测试环境，可以在您的公司进入生产之前激活。
当使用测试环境和IAP签名时，您不需要购买测试信用额度来验证您的交易，因为它们都是默认验证的。
小技巧
默认情况下，数据库设置为在生产环境下工作，请确保如有需要启用测试模式。
证书¶
如果您不使用Odoo IAP，则需要一个扩展名为 .pfx 的数字证书来生成电子发票签名。请前往此部分加载您的文件和密码。
多币种¶
秘鲁的官方货币汇率由 SUNAT 提供。Odoo 可以直接连接到其服务，并自动或手动获取汇率。
请参考我们文档中的下一节，了解更多关于 多货币 的信息。
配置主数据¶
税¶
作为本地化模块的一部分，税收会自动创建，并配置其相关的财务账户和电子发票。
EDI 配置¶
作为税收配置的一部分，电子发票需要三个新字段，由默认创建的税收已包含这些数据，但如果您创建新的税收，请确保填写这些字段：
税务位置¶
在安装秘鲁本地化时，默认包含两个主要的财务职位。
Extranjero - Exportación：为出口交易在客户上设置此税务位置。
Local Peru：将此财政状况应用于本地客户。
文件类型¶
在一些拉丁美洲国家，包括秘鲁，在政府财政机构（在这种情况下是SUNAT）定义的文档类型中，一些会计交易，如发票和供应商账单被分类。
每种文档类型可以在其分配的日记帐中拥有唯一的序列。作为本地化的一部分，文档类型包括适用于文档的国家；当本地化模块安装时，数据会自动创建。
文档类型所需的信息已默认包含在内，因此用户无需在此视图中填写任何内容：
警告
目前客户发票支持的文档类型有：发票、Boleta、借记通知单和贷记通知单。
日记账¶
创建销售日记账时，除了日记账上的标准字段外，还必须填写以下信息：
使用文档¶
该字段用于定义日志是否使用文档类型。它仅适用于采购和销售日志，这些日志可以与秘鲁提供的不同文档类型集相关联。默认情况下，所有创建的销售日志都使用文档。
电子数据交换¶
本节指示发票中使用的 EDI 工作流，对于秘鲁，我们必须选择“Peru UBL 2.1”。
警告
默认情况下，始终显示Factur-X（FR）值，请确保您可以手动取消选中它。
合作伙伴¶
身份证类型和增值税¶
作为秘鲁本地化的一部分，SUNAT定义的身份证类型现在可以在合作伙伴表单上使用，这些信息对于大多数发件公司和客户的交易至关重要，请确保在您的记录中填写这些信息。
产品¶
除了产品的基本信息外，在秘鲁本地化中，产品的UNSPC代码是必须配置的值。
使用和测试¶
客户发票¶
EDI元素¶
一旦您配置好主数据，发票可以从销售订单或手动创建。除了基本发票信息外，还需要一些字段作为秘鲁EDI的一部分，有关发票流程的详细信息请参阅： 有关发票流程的页面。
文档类型：默认值为“Factura Electronica”，但如果需要，您可以手动更改文档类型并选择Boleta，例如。
操作类型：此值为电子发票所需，表示交易类型，默认值为“内部销售”，但在需要时可以手动选择其他值，例如“货物出口”。
EDI Affectation Reason: 在发票行中，除了税金之外，还有一个“EDI Affectation Reason”字段，该字段根据显示的SUNAT列表确定税收范围。默认加载的所有税收都与默认的EDI影响原因相关联，如果需要，您可以在创建发票时手动选择其他原因。
发票验证¶
确认发票信息无误后，您可以进行验证。此操作将注册账户移动并触发电子发票工作流程，将其发送到OSE和SUNAT。以下消息将显示在发票顶部：
异步意味着发票发布后文档不会自动发送。
电子发票状态¶
待发送：表示文档已准备好发送给 OSE，这可以通过 Odoo 每小时自动运行的 cron 任务来完成，或者用户可以通过点击“立即发送”按钮立即发送。
已发送：表示文档已发送到 OSE 并成功验证。作为验证的一部分，将下载一个 ZIP 文件，并在聊天中记录一条消息，指示正确的政府验证。
如果存在验证错误，则电子发票状态仍为“待发送”，以便进行更正并重新发送发票。
警告
每次发送文档进行验证时，将消耗一个信用点。如果在发票上检测到错误并再次发送它，则总共将消耗两个信用点。
常见错误¶
当 OSE 或 SUNAT 拒绝时，有多种原因，此时 Odoo 会在发票顶部发送一条消息，指示错误详细信息，并在大多数常见情况下提供修复问题的提示。
如果收到验证错误，您有两个选项：
如果错误与合作伙伴、客户或税收的主数据有关，则可以在记录上应用更改（例如客户身份证类型），完成后单击“重试”按钮。
如果错误与发票直接记录的某些数据有关（操作类型，发票行缺少数据），正确的解决方案是将发票重置为草稿状态，应用更改，然后再次将发票发送给SUNAT进行另一次验证。
更多详细信息，请参考 Common errors in SUNAT。
发票 PDF 报告¶
在发票被SUNAT接受和验证后，可以打印发票PDF报告。该报告包括一个QR码，表示该发票是有效的财务文件。
IAP积分¶
Odoo的电子IAP提供1000个免费积分，当这些积分在您的生产数据库中用尽后，您的公司必须购买新的积分才能处理您的交易。
当您的信用额度用尽时，发票顶部会显示一个红色标签，指示需要额外的信用额度，您可以通过访问消息中提供的链接轻松购买它们。
IAP服务包括不同价格的套餐，基于信用点数。IAP中的价格列表始终以欧元显示。
特殊用例¶
取消流程¶
有些情况需要取消发票，例如，当发票被错误地创建时。如果发票已经被发送并由SUNAT验证，正确的操作方式是点击“请求取消”按钮：
为了取消发票，请提供取消原因。
电子发票状态¶
取消: 表示取消请求已准备好发送给 OSE，这可以通过 Odoo 自动使用 cron 每小时运行，或者用户可以立即点击“立即发送”按钮发送。一旦发送，将创建一个取消票据，结果是下一条消息和 CDR 文件将记录在聊天中：
已取消：表示取消请求已发送到 OSE 并成功验证。作为验证的一部分，将下载一个 ZIP 文件，并在聊天中记录一条消息，指示正确的政府验证。
警告
每个作废请求将消耗一个信用点。
导出发票¶
创建出口发票时，请考虑以下事项：
您客户的身份证明类型必须为外国身份证。
发票中的操作类型必须是出口类型。
发票行中包含的税金应为出口税。
预付款¶
创建预付款发票并应用其相关付款。
创建最终发票时不考虑预付款。
创建一张贷项通知单，金额为预付款金额，针对最终发票。
将贷项通知单与最终发票进行对账。
最后一张发票上的剩余余额应该使用常规支付交易进行支付。
扣款发票¶
创建需要扣除的发票时，请考虑以下事项：
发票中包含的所有产品必须配置这些字段：
发票中的操作类型必须为
1001
贷项通知单¶
当需要对已验证的发票进行更正或退款时，必须生成贷项通知单，只需单击“添加贷项通知单”按钮，作为秘鲁本地化的一部分，您需要从列表中选择一个信贷原因。
小技巧
创建第一张贷项通知单时，请选择贷项方法：部分退款，这样可以定义贷项通知单序列。
默认情况下，贷项通知单设置在文档类型中：
要完成工作流，请按照 我们的页面关于信用票据的说明 进行操作。
注解
贷项通知单的EDI工作流程与发票相同。
借记通知单¶
作为秘鲁本地化的一部分，除了从现有文档创建贷记通知外，您还可以创建借记通知。只需使用“添加借记通知”按钮即可。
默认情况下，借记通知单已在文档类型中设置。
电子交货指南 2.0¶
电子运输指南 (GRE) 是由发货人生成的电子文件，用于支持货物从一个地方（如仓库或机构）运输或转移到另一个地方。在 Odoo 中，成功使用此功能之前需要完成多个配置步骤。
使用 guía de remisión electrónica 电子文档是强制性的，且由 SUNAT 要求，适用于需要转移产品的纳税人，但那些处于 单一简化制度 (régimen único simplificado 或 RUS) 下的纳税人除外。
交货指南类型¶
发送者¶
当进行销售、提供服务（包括处理）、分配货物使用或在同一公司和其他公司之间转移货物时，会发出 Sender 交付指南类型。
此送货指南由货物所有者（即发货人）在运输开始时签发。Odoo 支持发货人送货指南。
另请参阅
承运人¶
The Carrier delivery guide type justifies the transportation service the driver (or carrier) performs.
此送货指南由承运人签发，当货物通过公共运输时，必须向每个托运人签发。
重要
承运人交货指南在 Odoo 中 不 受支持。
另请参阅
运输类型¶
私人的¶
当货主使用自己的车辆运输货物时，使用 Private 运输类型选项。在这种情况下，必须签发发货人的交货指南。
公共¶
当外部承运人运输货物时，使用 公共 运输类型选项。在这种情况下，必须签发两份交货单：发货人的交货单和承运人的交货单。
直接提交至 SUNAT¶
在 Odoo 中创建 GRE 交货单 必须 直接发送至 SUNAT，无论电子文档提供商是 IAP、Digiflow 还是 SUNAT。
所需信息¶
电子交付指南的2.0版本要求在常规配置、车辆、联系人和产品方面提供额外信息。在常规配置中，需要添加新的凭证，您可以从 SUNAT 门户获取这些凭证。
Cancellations¶
发送方 和 承运方 都可以取消电子运单，只要满足以下条件：
The shipment has not been initiated.
如果货物已经发出，在到达最终目的地之前，接收人 必须 被更改。
重要
SUNAT 不再使用术语 “Anula”，而是现在使用术语 “Dar de baja” 来表示取消操作。
测试¶
SUNAT 不支持测试环境。这意味着任何错误生成的交货指南 将会 被发送到 SUNAT。
如果错误地在此环境中创建了运单，则必须从 SUNAT 门户中删除它。
配置¶
重要
Electronic sender’s GRE 是目前 Odoo 中唯一支持的运单类型。
交付指南依赖于 Odoo 库存 应用、l10n_pe_edi 和 l10n_pe 模块。
必须添加第二个用户以创建电子文档。
在按照步骤配置了 电子发票 和 主数据 之后，安装 Peruvian - Electronic Delivery Note 2.0 模块 (l10n_pe_edi_stock_20)。
接下来，您需要从 SUNAT 获取 client ID 和 client secret 。为此，请遵循 manual de servicios web plataforma nueva GRE 。
注解
在 SUNAT 门户中，启用正确的访问权限非常重要，因为它们可能与为电子发票设置的用户不同。
这些凭证应用于从 配置发货指南的常规设置。
注解
需要按照 RUC + UsuarioSol 的格式（例如 20557912879SOLUSER）填写 Guide SOL User 字段，具体取决于在 SUNAT 门户中生成 GRE API 凭证时选择的用户。
操作员¶
操作员 是在通过 私人 运输进行配送指导的情况下车辆的驾驶员。
要创建新运营商，请导航至 并填写联系信息。
首先，选择 Individual 作为 Company Type。然后，在联系表单的 Accounting 选项卡中添加 Operator License。
对于客户地址，请确保以下字段填写完整：
District
税号 (DNI/RUC)
Tax ID Number
承运人¶
当通过 公共 运输进行交付时，使用 承运人 。
要创建新的承运商，请导航至 并填写联系信息。
首先，选择 Company 作为 Company Type。然后，添加 MTC Registration Number、Authorization Issuing Entity 和 Authorization Number。
对于公司地址，请确保以下字段填写完整：
District
税号 (DNI/RUC)
Tax ID Number
车辆¶
要配置可用车辆，请导航至 并在车辆表格中填写车辆所需信息：
车辆名称
车牌
是 M1 还是 L？
特别授权签发实体
授权号
默认操作员
公司
重要
如果车辆的车轮少于四个或座位少于八个，则必须勾选 Is M1 or L? 复选框。
产品¶
要配置可用产品，请导航至 并打开要配置的产品。
确保产品表单中的适用信息已完全配置。需要填写 Partida Arancelaria （关税项目）字段。
生成 GRE¶
一旦在销售工作流程中创建了从库存发货，请确保填写了转移表右上角的 GRE 字段：
运输类型
转账原因
出发起始日期
还需要填写 车辆 和 操作员 选项卡下的 Guia de Remision PE 字段。
交付转移必须标记为 已完成，才能在转移表单的左侧菜单中显示 Generar Guia de Remision 按钮。
转移表经 SUNAT 正确验证后，生成的 XML 文件就会出现在沟通栏中。您现在可以打印快递单，上面显示转移详情和经 SUNAT 验证的二维码。
常见错误¶
不同产品的前缀不同（某些产品为 T001，其他产品为 T002）目前，Odoo 不支持产品前缀的自动化。可针对每个产品输出手动完成。非存储产品也可以这样做。但请注意，这将不具有可追溯性。
2325 - GrossWeightMeasure - 数据不符合规定的格式 "产品中缺少字段" "重量"当产品重量设置为
0.00时，会出现此错误。要解决这个问题，需要取消运单并重新创建。确保在创建新的运单之前，先确定产品的重量，否则会导致同样的错误。JSONDecodeError: 期望值：第 1 行第 1 列（字符 0）在创建 Delivery Guide 时该错误通常是由于 SOL 用户问题引起的。验证用户与 SUNAT 的连接；SOL 用户必须使用公司 RUT + 用户 ID 建立。例如
2012188549JOHNSMITH。与货物转移相关的文件编号不符合规定的格式：错误：相关文件Related Document Type 和 Related Document Number 字段仅适用于发票和收据。
400 客户端错误：URL 请求错误此错误无法通过 Odoo 解决；建议您联系 SUNAT 并验证用户。可能需要创建一个新用户。
从元素 'cac:BuyerCustomerParty' 开始发现了无效内容此错误发生在传输原因设置为 其他 时。请选择另一个选项。根据 SUNAT 的运单指南官方文档，传输原因 03（向第三方发货的销售） 或 12（其他） 在 Odoo 中不起作用，因为您不应有空白的客户。
客户疑难：使用 GRE 2.0 会消耗 IAP 信用额度对于使用 IAP 的实时客户，由于不经过 OSE，即这些文件直接发送到 SUNAT，因此（理论上）不会消耗信用额度。
GRE 2.0 证书格式错误（回溯错误）目前，Odoo 在数据库中未正确配置凭据时会抛出一个带有回溯的错误，而不是显示凭据配置不正确的消息。如果在您的数据库上发生这种情况，请验证您的凭据。
电子商务电子发票¶
首先，安装 Peruvian eCommerce (l10n_pe_website_sale) 模块。
The Peruvian eCommerce 模块启用了以下功能和配置：
允许客户为 电子商务 目的创建在线账户；
支持 eCommerce 应用中所需的财税字段；
在线接收销售订单的付款；
从 eCommerce 应用程序生成电子文档。
注解
Peruvian eCommerce 模块依赖于先前安装的 Invoicing 或 Accounting 应用，以及 Website 应用。
配置¶
配置完秘鲁的 电子发票 流程后，请完成以下 电子商务 流程的配置：
自动发票；
产品：将 开票政策 设置为 订购数量 并定义所需的 客户税。
在线支付;
送货方式: 对于每种配送方式，将 提供商 字段设置为 固定价格。然后，设置一个大于
0.00`（不为零）的 :guilabel:`固定价格金额，因为配送方式的价格会添加到发票行中。
注解
Mercado Pago 是 Odoo 支持的在线支付提供商，覆盖拉丁美洲的多个国家、货币和支付方式。
确保在运输方式的 配送产品 上定义 销售价格，以防止在使用 SUNAT 验证发票时出现错误。
为了提供免费配送，请手动移除 配送产品，或者至少使用 `$0.01`（一分钱）以便发票能够通过 SUNAT 验证。
电子商务的发票流程¶
一旦 配置 全部设置完成，登录客户在结账过程中将可以使用税务输入字段。
当客户在结账时输入其财务数据并成功完成购买后，发票将生成并包含相应的 EDI 元素。文档类型（Boleta/Factura）根据其税号（RUC/DNI）进行选择。然后，发票必须 发送到 OSE 和 SUNAT。默认情况下，所有发布的发票每天通过计划任务发送一次，但如果需要，您也可以手动发送每张发票。
一旦发票通过 SUNAT 验证，客户可以通过点击 下载 按钮直接从客户门户下载包含 CDR、XML 和 PDF 文件的 .zip 。