秘鲁¶
介绍¶
秘鲁语本地化已得到改进和扩展，在此版本中，可以使用以下模块：
l10n_pe：为秘鲁本地化添加会计功能，这些功能表示公司在秘鲁运营所需的最低配置，并符合 SUNAT 法规和准则。该模块中包含的主要元素是：会计科目表，税收，单据类型。
l10n_pe_edi：包括生成和验证电子开票的所有技术和功能要求，基于 SUNAT 规范创建和处理有效的电子文档，有关更多技术详细信息，您可以访问“SUNAT EDI 规范 <https://cpe.sunat.gob.pe/node/88/>”_，跟踪新的更改和更新。该模块的功能基于在“SUNAT立法 <https://www.sunat.gob.pe/legislacion/general/index.html/>”上发布的决议。
配置¶
安装秘鲁语本地化模块¶
转到 应用 并搜索秘鲁，然后在 Peru EDI 模块中点击安装。此模块依赖于 Peru - Accounting。如果后者未安装，Odoo 会在 EDI 中自动安装。
Note
当您从头开始安装数据库并选择秘鲁作为国家/地区时，Odoo会自动安装基本模块：秘鲁 - 会计。
配置公司的基本参数¶
除了公司的基本信息外，我们还需要将秘鲁设置为国家/地区，这对于电子开票的正常工作至关重要。“地址类型代码”字段表示 SUNAT 在公司注册其 RUC（唯一贡献者注册）时分配的机构代码：
Tip
如果地址类型代码未知，可以将其设置为默认值：0000。请注意，如果输入的值不正确，则电子开票验证可能会有错误。
Note
NIF 应按照 RUC 格式进行设置。
科目表¶
默认情况下，会计科目表作为本地化模块中包含的数据集的一部分进行安装，账户将自动映射到：
税率
Default Account Payable.
默认应收科目(PoS)
秘鲁的会计科目表基于最新版本的 PCGE（Plan Contable General Empresarial），分为多个类别，并与 NIIF 会计准则兼容。
会计设置¶
安装模块并设置公司的基本信息后，您需要配置电子开票所需的元素。为此，请转到 。
基本概念¶
以下是秘鲁本地化中必不可少的一些术语：
EDI：电子数据交换，此处指电子开票。
SUNAT：是在秘鲁执行海关和税收的组织。
OSE：电子服务运营商，OSE SUNAT 的定义。
CDR： 收据证书 （Constancia de Recepción）.
SOL Credentials： Sunat Operaciones en Línea.用户和密码由 SUNAT 提供，并授予对在线操作系统的访问权限。
签名提供程序¶
作为秘鲁电子开票要求的一部分，您的公司需要选择一个签名提供商，负责文档签名过程并管理 SUNAT 验证响应。Odoo提供三个选项：
IAP （Odoo 应用内营销）
数字流
苏纳特
请参阅以下部分，查看每个选项的详细信息和注意事项。
IAP （Odoo 应用内营销）¶
这是默认和建议的选项，考虑到数字证书作为服务的一部分包含在内。
什么是IAP？¶
这是Odoo直接提供的签名服务，该服务负责下一个过程：
提供电子开票证书，因此您无需自己获取。
将文档发送到 OSE，在本例中为 Digiflow。
接收 OSE 验证和 CDR。
工作原理是什么?¶
该服务需要积分才能处理您的电子文档。Odoo在新数据库中免费提供1000个积分。消耗这些积分后，您需要购买积分包。
信用 |
欧元 |
|---|---|
1000 |
22 |
5000 |
110 |
10,000 |
220 |
20,000 |
440 |
配额是针对发送到 OSE 的每个文档消耗的。
Important
如果您遇到验证错误，并且需要再次发送文档，则将收取一个额外的信用额度。因此，在将文档发送到 OSE 之前，请务必验证所有信息是否正确。
您需要做什么？¶
在Odoo中，一旦您的企业合同被激活并开始在生产中工作，您需要在消耗前1000个积分后购买积分。
由于Digiflow是IAP中使用的OSE，因此您需要在SUNAT网站上将其作为您公司的官方OSE进行关联。这是一个简单的过程。有关更多信息，请查看“OSE 联盟指南 <https://drive.google.com/file/d/1BkrMTZIiJyi5XI0lGMi3rbMzHddOL1pa/view?usp=sharing>”_。
将 Digiflow 注册为授权的 PSE，请查看“PSE 联盟指南 <https://drive.google.com/file/d/1QZoqWvtQERpS0pqp6LcKmw7EBlm9EroU/view?usp=sharing>”_。
数字流¶
此选项可以用作替代方案，而不是使用IAP服务，您可以将文档验证直接发送到Digiflow。在这种情况下，您需要考虑：
购买您自己的数字证书：有关官方供应商列表的更多详细信息以及获取它的过程，请参阅“SUNAT Digital Ceritifcates <https://cpe.sunat.gob.pe/informacion_general/certificados_digitales/>”_。
直接与“Digiflow <https://www.digiflow.pe/>”签订服务协议。
提供您的 SOL 凭据。
苏纳特¶
如果您的公司想要直接使用 SUNAT 签名，则可以在配置中选择此选项。在这种情况下，您需要考虑： - 接受 SUNAT 认证流程。
购买您自己的数字证书：有关官方供应商列表的更多详细信息以及获取它的过程，请参阅“SUNAT Digital Ceritifcates <https://cpe.sunat.gob.pe/informacion_general/certificados_digitales/>”_。
为您提供 SOL 凭据。
Important
与 SUNAT 使用直接连接时，SOL 用户必须设置为公司 RUT + 用户 ID。示例：“20121888549JOHNSMITH”
测试环境¶
Odoo提供了一个可以在公司投入生产之前激活的测试环境。
使用测试环境和 IAP 签名时，您无需为交易购买测试积分，因为默认情况下，所有这些积分都会经过验证。
Tip
默认情况下，数据库设置为在生产环境中工作，请确保根据需要启用测试模式。
证书¶
如果您不使用Odoo IAP，为了生成电子开票签名，需要扩展名为“.pfx”的数字证书。继续执行此部分并加载您的文件和密码。
多币种¶
秘鲁的官方货币汇率由秘鲁银行提供。Odoo可以直接连接到其服务，并自动或手动获取货币汇率。
有关 multicurrency 的更多信息，请参阅我们说明文档的下一部分。
Configure Master data¶
税率¶
作为本地化模块的一部分，税后将自动创建税收及其相关的财务账户和电子开票配置。
EDI 配置¶
作为税收配置的一部分，电子开票需要三个新字段，默认情况下创建的税收包含此数据，但如果您创建新税收，请确保填写这些字段：
税务规则¶
默认情况下，在安装秘鲁本地化时包括两个主要的税务规则。
Extranjero - Exportación：为出易记录的客户设置此税务规则。
秘鲁当地：对当地客户设置此税务规则。
Document Types¶
在一些拉丁美洲国家，包括秘鲁，一些会计交易（如开票和供应商账单）按单据类型分类，由政府财政当局定义，在本例中由SUNAT定义。
每个文档类型在分配的每个日记帐中都可以有一个唯一的序列。作为本地化的一部分，文档类型包括文档适用的国家/地区;安装本地化模块时会自动创建数据。
默认情况下，包含文档类型所需的信息，因此用户无需在此视图上填写任何内容：
Warning
目前，客户开票上支持的文档是：开票，Boleta，借方通知单和贷方通知单。
日记账¶
创建销售日记帐时，除了日记帐上的标准字段外，还必须填写以下信息：
使用文档¶
此字段用于定义日记帐是否使用文档类型。它仅适用于采购和销售日记帐，这些日记帐可以与秘鲁可用的不同单据类型集相关联。默认情况下，创建的所有销售日记帐都使用单据。
电子数据交换¶
本节指示开票中使用了哪个EDI工作流程，对于秘鲁，我们必须选择“秘鲁UBL 2.1”。
Warning
默认情况下，始终显示值 Factur-X （FR），请确保可以手动取消选中它。
往来账¶
Identification Type and VAT¶
作为秘鲁本地化的一部分，SUNAT定义的标识类型现在可以在合作伙伴表单上找到，此信息对于发件人公司和客户中的大多数交易都是必不可少的，请确保您在记录中填写此信息。
产品¶
除了产品中的基本信息外，对于秘鲁语本地化，产品上的 UNSPC 代码是需要配置的值。
用法和测试¶
客户结算单¶
EDI 元素¶
配置好主数据后，可以根据销售订单或手动创建发票。除了在 我们的发票开具流程页面 中描述的基本发票信息外，Peru EDI 还需要几个字段：
文档类型：默认值为“Factura Electronica”，但您可以根据需要手动更改文档类型，例如选择Boleta。
操作类型：此值对于电子开票是必需的，指示交易记录类型，默认值为“内部销售”，但可以在需要时手动选择另一个值，例如货物出口。
EDI 影响原因：在开票行中，除了税金之外，还有一个字段“EDI 影响原因”，该字段根据显示的 SUNAT 列表确定税税范围。默认情况下加载的所有税款都与默认的EDI影响原因相关联，如果需要，您可以在创建开票时手动选择另一个原因。
Invoice validation¶
检查开票中的所有信息是否正确后，您可以继续对其进行验证。此操作将注册账户移动并触发电子开票工作流以将其发送到 OSE 和 SUNAT。以下消息显示在开票的顶部：
异步意味着在开票过帐后不会自动发送单据。
电子开票状态¶
待发送： 表示文档已准备好发送到 OSE，这可以由 Odoo 通过每小时运行一次的 cron 自动完成，也可以由用户点击 “立即发送” 按钮立即发送。
已发送：指示文档已发送到 OSE 并已成功验证。作为验证的一部分，将下载一个 ZIP 文件，并在聊天中记录一条消息，指示正确的政府验证。
如果出现验证错误，电子开票状态将保持在“待发送”状态，以便可以进行更正并再次发送开票。
Warning
每次发送文档进行验证时都会消耗一个信用额度，从这个意义上说，如果在开票上检测到错误并且您再发送一次，则总共消耗两个信用额度。
Common Errors¶
OSE或SUNAT拒绝的原因有很多，当发生这种情况时，Odoo会在开票顶部发送一条消息，指示错误详细信息，并在最常见的情况下发送解决问题的提示。
如果收到验证错误，您有两种选择：
如果错误与合作伙伴、客户或税金的主数据相关，您只需在记录上应用更改（例如客户标识类型），完成后单击“重试”按钮。
如果错误与直接记录在开票上的某些数据（操作类型，开票行上缺少数据）有关，正确的解决方案是将开票重置为Draft，应用更改，然后再次将开票发送到SUNAT进行另一次验证。
有关更多详细信息，请参阅“SUNAT <https://www.nubefact.com/codigos-error-sunat/>中的常见错误”_。
Invoice PDF Report¶
SUNAT 接受并验证开票后，可以打印开票 PDF 报告。该报表包含一个 QR 码，指示开票是有效的会计凭证。
IAP 积分¶
Odoo的电子IAP免费提供1000个积分，在您的生产数据库中消耗这些积分后，您的公司必须购买新的积分才能处理您的交易。
一旦您的积分用完了，开票顶部会显示一个红色标签，指示需要额外的积分，您可以通过访问消息中提供的链接轻松购买它们。
在IAP服务中，包括根据信用额度数量具有不同定价的软件包。IAP 中的价目表始终以欧元显示。
Special Use cases¶
取消流程¶
某些方案需要取消开票，例如，当错误地创建开票时。如果开票已由 SUNAT 发送并验证，则正确的方法是单击“请求取消”按钮：
要取消开票，请提供取消原因。
电子开票状态¶
取消：表示取消请求已准备好发送到OSE，这可以由Odoo使用每小时运行的 cron 自动完成，或者用户可以通过单击“立即发送”按钮立即发送。发送后，将创建取消票证，因此下一条消息和CDR文件将记录在聊天中：
已取消：指示取消请求已发送到 OSE 并已成功验证。作为验证的一部分，将下载一个 ZIP 文件，并在聊天中记录一条消息，指示正确的政府验证。
Warning
每个取消请求都会消耗一个积分。
取消流程¶
创建导出开票时，请考虑以下注意事项：
客户的身份证明类型必须是“外国身份证”。
开票中的操作类型必须是导出类型。
开票行中包含的税款应为 EXP 税。
从客户收到的预付款¶
创建预付款开票并应用其相关付款。
在不考虑预付款的情况下创建最终开票。
使用预付款金额为最终开票创建贷方通知单。
将贷方通知单与最终开票进行对帐。
最终开票上的余额应通过定期付款交易支付。
减损开票¶
创建受减损影响的开票时，请考虑以下注意事项：
开票中包含的所有产品都必须配置以下字段：
开票中的操作类型必须为“1001”
退款通知¶
当需要对经过验证的开票进行更正或退款时，必须生成贷方通知单，只需单击“添加贷方通知单”按钮，这是秘鲁本地化的一部分，您需要证明信用原因，选择列表中的选项之一。
Tip
创建第一个贷方通知单时，选择贷方方法：部分退款，这允许您定义贷方通知单序列。
默认情况下，贷方通知单在单据类型中设置：
要完成工作流程，请按照 关于冲销凭证页面 的说明进行操作。
Note
贷方通知单的 EDI 工作流的工作方式与开票相同。
借记单¶
作为秘鲁本地化的一部分，除了从现有单据创建贷方通知单外，您还可以创建借方票据。为此，只需使用“添加借方通知单”按钮即可。
默认情况下，借方通知单在单据类型中设置。
电子发货指南 2.0¶
Guía de Remisión Electrónica （GRE）是托运人生成的电子文件，用于支持将货物从一个地方运输或转移到另一个地方，例如仓库或场所。在 Odoo 中，需要执行几个配置步骤才能成功使用此功能。
根据 SUNAT 的规定，需要转让产品的纳税人必须使用 guía de remisión electrónica 电子文件，但 单一简化制度 （régimen único simplificado 或 RUS）下的纳税人除外。
发货指南类型¶
发送者¶
在进行销售、提供服务（包括加工）、分配货物使用或在同一公司与其他公司之间转让货物时，将签发 发货人 交货指南类型。
该发货指南由货主（即发货人）在发货开始时发布。Odoo 支持发件人发货指南。
承运商¶
承运人 发货指南类型说明了司机（或承运人）所提供的运输服务。
这份交货指南由承运人签发，在货物通过公共运输时，必须发给每个托运人。
Important
Odoo 暂未 支持承运商交付指南。
运输类型¶
私密¶
若货主使用自己的车辆转移货物，请使用 私人 运输类型选项。在这种情况下，必须发出发件人的发货指南。
公开¶
由外部承运商移动货物时，请使用 公共 运输类型选项。 在这种情况下，必须发出两个发货指南：发件人的投递指南，以及承运人的投递指南。
直接提交至 SUNAT¶
在 Odoo 中创建的 GRE 发货指南 必须 直接发送到 SUNAT，无论电子文档提供商是谁：IAP、Digiflow 或 SUNAT。
必须提供的信息¶
电子发货指南 2.0 版需要关于一般配置、车辆、联系人和产品的更多信息。在一般配置中，有必要添加可从 SUNAT 门户获取的新凭证。
取消¶
只要满足以下条件，发件方和承运方 双方 都可以取消电子运单：
货物尚未开始运输。
如果运输已经开始，则 必须 在到达最终目的地之前更改收货方。
Important
SUNAT 不再使用“Anula”这一术语，现在改用“Dar de baja”表示取消。
测试¶
SUNAT 不支持测试环境。这意味着任何误生成的交货指南 都会 被发送到 SUNAT。
如果误在此环境中创建了运单，则需要从 SUNAT 门户中将其删除。
配置¶
Important
电子发件方 GRE 是目前 Odoo 唯一支持的运单类型。
交付指南依赖于 Odoo 库存 应用程序、 l10n_pe_edi 和 l10n_pe 模块。
必须 添加第二个用户才能创建电子文档。
按照步骤完成 电子开票 和 主数据 的配置后，请 安装 Peruvian - Electronic Delivery Note 2.0 模块（l10n_pe_edi_stock_20）。
接下来，您需要从 SUNAT 获取 客户端 ID 和 客户端密码。为此，请按照 manual de servicios web plataforma nueva GRE 进行操作。
Note
在 SUNAT 门户中，必须启用正确的访问权限，因为它们可能与电子发票的用户设置不同。
应使用这些凭证从 配置交付指南常规设置。
Note
在 Guide SOL User 字段中，必须遵循 RUC + UsuarioSol （例如，20557912879SOLUSER）格式，这取决于在 SUNAT 门户中生成 GRE API 凭证时所选择的用户。
操作员¶
在通过 私人 运输工具提供发货指南的情况下，操作员 是车辆的司机。
要创建新操作员，请导航至 并填写联系人信息。
首先，选择 个人 作为 公司类型 。然后，在联系表单的 会计 选项卡中添加 操作员许可证 。
关于客户地址，请确保以下字段完整：
地区
税务识别码 （ DNI/RUC）
税务识别号码
承运商¶
发货指南使用 公共 交通工具时，会使用 承运人 。
要创建新联系人，请导航至 并填写联系人信息。
首先，选择 公司 作为 公司类型 。然后，添加 MTC 注册号 、 授权签发实体 和 授权编号 。
对于公司地址，请确保以下字段完整：
地区
税务识别码 （ DNI/RUC）
税务识别号码
车辆¶
要配置可用车辆，请导航至 并在车辆表格中填写车辆所需信息：
车辆名称
车牌
是否为 M1 或 L 类？
特别授权签发实体
授权号
默认操作员
公司
Important
如果车辆少于四个车轮或少于八个座位，请务必勾选 是否为M1或L类？ 复选框。
产品¶
要配置可用产品，请导航至 并打开要配置的产品。
确保产品表单中的适用信息已完全配置。需要填写 Partida Arancelaria （关税项目）字段。
正在生成 GRE¶
一旦在销售工作流程中创建了从库存发货，请确保填写了转移表右上角的 GRE 字段：
运输类型
转移原因
出发起始日期
还需要填写 车辆 和 操作员 选项卡下的 Guia de Remision PE 字段。
交货转移必须标记为 完成， Generar Guia de Remision 按钮才会出现在转移表格的左侧菜单上。
转移表经 SUNAT 正确验证后，生成的 XML 文件就会出现在沟通栏中。您现在可以打印快递单，上面显示转移详情和经 SUNAT 验证的二维码。
Common errors¶
Diferente prefijo para productos (T001 en algunos, T002 en otros)目前，Odoo 不支持产品前缀的自动化。可针对每个产品输出手动完成。非存储产品也可以这样做。但请注意，这将不具有可追溯性。
2325 - GrossWeightMeasure - El dato no cumple con el formato establecido "Hace falta el campo" "Peso"" en el producto当产品重量设置为
0.00时，会出现此错误。要解决这个问题，需要取消运单并重新创建。确保在创建新的运单之前，先确定产品的重量，否则会导致同样的错误。JSONDecodeError：创建交货指南时的期望值：第 1 行第 1 列（字符 0）该错误通常是由于 SOL 用户问题引起的。验证用户与 SUNAT 的连接；SOL 用户必须使用公司 RUT + 用户 ID 建立。例如
2012188549JOHNSMITH。El número de documento relacionado al traslado de mercancía no cumple con el formato establecido: error: documento relacionado相关文件类型 和 相关文件编号 字段只适用于发票和收据。
400 客户端错误：URL 请求错误此错误无法通过 Odoo 解决；建议您联系 SUNAT 并验证用户。可能需要创建一个新用户。
发现以元素 'cac:BuyerCustomerParty' 开头的无效内容当转移原因设置为 其他 时会出现此错误。请选择其他选项。根据 SUNAT 的运单指南官方文档，转移原因 03（销售并发货给第三方） 或 12（其他） 在 Odoo 中无法使用，因为您不应该有一个空的或空白的客户。
客户疑难：使用 GRE 2.0 会消耗 IAP 信用额度对于使用 IAP 的实时客户，由于不经过 OSE，即这些文件直接发送到 SUNAT，因此（理论上）不会消耗信用额度。
GRE 2.0 证书格式错误（回溯错误）目前，Odoo 在数据库中未正确配置凭据时会抛出一个带有回溯的错误，而不是显示凭据配置不正确的消息。如果在您的数据库上发生这种情况，请验证您的凭据。
