危地马拉 link

介绍 {#guatemala/intro} link

通过危地马拉本地化，您可以连接税务机关
超级行政税务局（SAT）来生成
带有 XML、税务编号和电子签名的电子文档。

支持的文档类型包括：

• FACT-Factura（发票）,
• FCAM-Factura Cambiaria（外汇发票）,
• FPEQ-Factura de Pequeño Contribuyente（小额纳税人发票）,
• NCRE-Credit Note（信用票据）,
• NDEB-Debit Note（借记票据）,
• NABN-Nota de Abono（付款票据）,
• FCAP-Factura Cambiaria Pequeño Contribuyente（小额纳税人外汇发票）,
• FACT-Factura with Export Complement（含出口补充的发票）。

该本地化需要一个 Infile 账户，
该账户使用户能够在 Odoo 中生成电子文档。要申请 Infile 账户，填写 Infile 注册表单。

::: seealso 危地马拉电子发票合法性与合规性文档 <../accounting/customer_invoices/electronic_invoicing/guatemala> :::

术语表 link

以下术语在危地马拉本地化中使用：

• SAT：Superintendencia de Administración Tributaria，负责在危地马拉执行税收支付的政府机构。
• FEL：Factura Electrónica en Línea，SAT 强制的电子发票系统，企业必须根据当地法规开具并管理电子文档。
• EDI：Electronic Data Interchange，指电子文档的发送。
• Infile：第三方机构，促进公司与危地马拉政府之间的电子文档交换。
• UUID：Universally Unique Identifier，SAT 为 FEL 系统中每份经过认证的电子文档分配的唯一字母数字代码，用于追踪和官方验证。
• 短语（Phrases）：带有特定情景代码的短语类型，用于满足 SAT 的要求。应根据发行人制度、接收人和操作类型添加，这些短语会出现在 XML 与 PDF 文档中。
• 建立代码（Establishment Code）：SAT 为每个企业分支机构分配的唯一标识符，电子开票时必需。
• Quetzal：危地马拉官方货币，符号为 GTQ，所有财务交易的基础货币。

配置 link

模块安装 link

安装 <general/install> 以下模块以获得危地马拉本地化的全部功能：

:::: note ::: title 注意 ::: 当在创建数据库时选择 危地马拉 为国家时，Odoo 会自动安装基础模块 危地马拉 - 会计。但若要启用电子发票，需要手动 安装 <general/install> 危地马拉会计 EDI（[l10n_gt_edi]）模块。 ::::

公司 link

要配置公司信息，打开 设置 应用，滚动到 公司 部分，点击 更新信息 并配置以下内容：

• 公司名称
• 地址（包括 街道、城市、州/省、邮编、国家）
• 税号：输入所选纳税人类型的识别号码。
• 增值税归属：选择公司所属的 VAT 制度类型。
• 法定名称：用于 XML 与 PDF 文档的公司法定名称。
• 建立代码：创建电子文档时 XML 必需的字段。若未设置，所有电子文档将被拒绝。
  在您的 SAT 账户 中，前往 FEL --> Administración de Establecimientos 可查看已注册的分支机构及其代码。

:::: important ::: title 重要 ::: 在数据库设置中配置公司后，进入公司联系人表单，确保 识别号码 的 类型 设置为 NIT。 ::::

电子发票凭证 link

在危地马拉，电子发票对大多数企业是强制性的。Odoo 通过授权供应商 Infile 生成并提交电子文档至 SAT（超级行政税务局） 进行验证。

在开具电子文档之前，必须配置并连接 Odoo 与 Infile，以确保文档得到正确验证并获得官方 UUID（唯一标识符）。

Infile link

直接与 Infile 签订服务协议。Infile 将提供在 Odoo 中输入的凭证信息。

:::: note ::: title 注意 ::: 要创建 Infile 账户并享受 Odoo 客户专属的 8% 折扣，请填写 Infile 注册表单。Infile 代理人会联系您，帮助完成入驻流程并签署服务协议。 ::::

Odoo link

在 Odoo 中完成 Infile 流程后，前往 会计 --> 配置 --> 设置，滚动到 危地马拉本地化 部分，按以下步骤操作：

1. 选择 Infile Web Services 环境（测试 或 生产）。
2. 输入 Infile 凭证：
   • Infile WS 用户名或前缀
   • Infile Token
   • Infile Key
3. 点击 保存。

:::: note ::: title 注意 ::: Infile 凭证 由 Infile 提供，测试与生产环境均需使用。如未获取，请联系 Infile 支持。 ::::

:::: tip ::: title 提示 ::: 演示环境仅用于测试，不会生成合法文档、UUID 或税务编号。使用演示环境无需 Infile 账户或凭证。 ::::

多币种 link

危地马拉官方汇率由危地马拉银行提供。Odoo 可直接连接其服务，自动或手动获取汇率。

::: seealso 多币种 <../accounting/get_started/multi_currency> :::

主数据 link

科目表 link

科目表 <../accounting/get_started/chart_of_accounts> 随本地化模块默认安装，科目会自动映射到税务、默认应付账款和默认应收账款。可根据公司需求增删科目。

联系人 link

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

• 公司名称
• 地址（包括 街道、城市、州/省、邮编、国家）
• 识别号码：
  • 类型：选择识别类型。
  • 号码：用于确认电子发票。

:::: note ::: title 注意 ::: 若需在每张电子发票的 XML 与 PDF 中自动加入特定短语，请在联系人表单的 销售与采购 标签页的 短语 字段中进行选择。 ::::

税务 link

危地马拉本地化模块会自动创建税务及其配置和关联的财务科目。

电子发票 link

数据库配置完成后，即可创建并发送电子文档。

在 客户发票 <../accounting/customer_invoices> 验证后，可通过 Infile 将其电子发送至 SAT（超级行政税务局），前提是填写以下字段：

• 客户：输入客户信息。
• GT 文档类型：选择要创建的文档类型，如 FACT - 电子发票 或 FCAM - 外汇发票。默认文档类型为 FACT。
• 到期日：用于计算发票是否已到期。
• 分录账簿：选择销售分录账簿。
• 产品：指定产品并关联正确税率。

完成后点击 确认。

:::: note ::: title 注意 ::: 如需根据交易添加特定短语，请在 其他信息 标签页的 GT 短语 中添加。短语会出现在 XML 与 PDF 中。 ::::

:::: note ::: title 注意 ::: 如需在发票中添加附录，可在 条款与条件 字段填写。附录会包含在 XML 文档中，用于提供额外信息或备注。 ::::

确认发票后，点击 发送。在弹出的向导中，确保勾选 发送至 SAT 与 通过电子邮件，以通过 Infile Web Service 将 XML 发送至 SAT，并将已验证的发票发送至客户邮箱，然后点击 发送。随后会发生以下过程：

• 创建 XML 文档。
• 生成 UUID（唯一标识符）。
• XML 由 Infile 同步处理。
  • 若被接受，文件会显示在聊天记录中，并向客户发送包含相应 pdf 与 xml 的邮件。
  • 若文件含错误，会显示警告信息并阻止邮件发送。

SAT 标签页随后显示：

• 日期时间：XML 创建的时间戳。
• GT 状态：SAT 响应中返回的状态结果。若文件含错误，会显示警告信息。
• UUID：SAT 为电子文档分配的唯一标识符。
• 下载证书：即使 SAT 结果被拒，也可下载已发送的 XML 文件。

借记与信用票据 {#localization/guatemala/credit-notes} link

若要向 Infile 发送借记或信用票据，先创建 借记单 <accounting/credit_notes/issue-debit-note> 或 信用票据 <accounting/credit_notes/issue-credit-note>。随后在 发送 窗口点击 发送至 SAT（危地马拉 EDI） 进行实时验证。验证成功后，Infile 的二维码会嵌入借记或信用票据的 PDF 中。

出口发票 link

出口发票必须满足以下条件：

• 客户的 识别类型 必须为 VAT、护照 或 外国身份证。
• 在客户发票的 其他信息 标签页的 会计 部分必须定义以下字段：
  • 贸易术语（Incoterm）
  • GT 短语：类型 4 代码 1
  • 托运公司
• 所有发票行的税率必须设为 0%。