Jordan

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

名称技术名称描述
Jordan - Accounting{.interpreted-text role=“guilabel”}[l10n_jo]Jordan 财政本地化包，包含约旦科目表、税种、税务报告和财政岗位。
Jordan E-Invoicing{.interpreted-text role=“guilabel”}[l10n_jo_edi]与 JoFotara 集成的模块，支持约旦电子发票需求。

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

在某些情况下（例如升级到带有额外模块的版本），模块可能未自动安装。可以手动 installed <general/install> 任何缺失的模块。 ::::

::: seealso Jordan 薪资本地化文档 <../../hr/payroll/payroll_localizations/jordan> :::

约旦本地化包确保遵守约旦财政和会计法规。它提供了管理税务、财政岗位、报表以及符合约旦标准的预设科目表的工具。

约旦本地化包的主要功能包括：

  • ../accounting/get_started/chart_of_accounts：符合约旦会计标准的预设科目结构
  • localizations/jordan/taxes：预配置的税率，包括标准增值税、零税率和免税选项
  • ../accounting/taxes/fiscal_positions：根据客户或供应商的登记状态自动调整税务
  • localizations/jordan/tax-reporting：详细的净税负概览
  • E-invoicing (JoFotara)<localizations/jordan/jofotara>：符合约旦政府要求的电子发票集成

约旦本地化默认提供以下 taxes <../accounting/taxes>：

  • 标准销售税（16%）：适用于约旦境内大多数商品和服务。
  • 免税交易：适用于不征收增值税的销售和服务，如金融服务或医疗保健。
  • 出口税（0%）：对出口至约旦境外的商品和服务实行零税率。

VAT summary <../accounting/reporting/tax_returns> 提供可税、零税率和免税交易的详细分解。与其他 financial reports <../accounting/reporting> 一样，VAT 汇总可按期间过滤、与其他期间比较，并可导出为 Excel 或 PDF，确保符合约旦税法。

JoFotara 电子发票已与 Odoo 集成，满足约旦政府对电子发票的技术和法律要求。通过 Odoo 的 JoFotara 集成，可：

  • 生成合规的电子发票
  • 实时提交发票进行验证
  • 在 Odoo 中直接跟踪发票状态

使用前需先在 JoFotara 创建账户，获取 API 凭证，并在 Odoo 数据库中填写这些凭证以实现关联。

政府手册 提供了创建账户和获取 API 凭证的说明。

  1. 若尚未拥有账户，访问 政府手册 页面，按照《约旦国家电子发票系统加入程序手册》创建账户。
  2. 通过同一页面的《约旦国家电子发票系统链接程序手册》生成 API 凭证（活动编号、密钥、客户端 ID）。
  3. 在 Odoo 数据库中，进入 Accounting --> Configuration --> Settings，在 Electronic Invoicing (Jordan) 区域填写刚才生成的凭证：
    • Activity Number（收入来源序号）
    • JoFotara Secret Key
    • JoFotara Client ID
  4. 选择 Taxpayer type（纳税人类型）：
    • Unregistered in the sales tax：未登记增值税的企业，发票行不需税额。
    • Registered in the sales tax：标准增值税登记企业，发票行按比例计算税额。
    • Registered in the special sales tax：特殊增值税企业，发票行需计算比例税额和固定税额。
  5. 点击 Save 保存。

:::: tip ::: title 提示 :::

如果在 Settings 中找不到 Electronic Invoicing (Jordan) 区域，请确认已 installed Jordan E-Invoicing 模块。 ::::

JoFotara 发票工作流需要公司和客户的地址信息：

  1. 前往 Settings --> Users & Companies --> Companies，选择将使用 JoFotara 的公司。

  2. 填写 Company Name、Tax ID（TIN）和 Country。如需，可补充 Street、City、State、ZIP 等可选字段。

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

    • Country 必须设为 Jordan。
    • Company Name 必须与收入与销售税部门（ISTD）登记的名称一致。
    • 公司 Currency 必须设为 JOD。
      :::

  3. 前往 Accounting --> Customers --> Customers。

  4. 对每个需通过 JoFotara 开票的客户，打开其表单，填写 Country 与 Tax ID，并可补充地址等可选信息。

在公司 已关联 JoFotara 且 公司与客户信息已正确配置 后，可按以下步骤发送发票：

  1. 前往 Accounting --> Customers --> Invoices，打开已确认（已记账）的发票。
  2. 点击 Send。
  3. 在弹出的 Send 窗口中选择 JoFotara (Jordan EDI)，然后点击 Send。

发送后，Odoo 将：

  • 按 UBL 1.2 格式生成发票文件
  • 将发票提交至 JoFotara 进行验证
  • 在发票 PDF 中嵌入 JoFotara 返回的二维码

:::: tip ::: title 提示 :::

  • 可一次 sent at once 多张发票（sent at once <accounting/invoice/sending>）。
  • 在发票列表视图中，可使用 localizations/jordan/jofotara-state 过滤已发送或未发送的发票。
  • 在 oi-settings-adjust（调整设置）菜单中，添加 JoFotara State 与 JoFotara Error 字段，以在列表中查看发送状态和错误信息。
    ::::

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

Odoo 与 ISTD 在数值精度上存在差异：Odoo 将 JOD 金额保留三位小数，而 ISTD 需要九位小数。因此，两者之间会出现 <0.001 的细微误差，这是不可避免的。
::::

已确认发票的 Other Info 标签页中显示的 JoFotara State 字段反映了该文档在 JoFotara 中的当前状态。如因技术错误或超时导致 Odoo 未能自动更新，可手动修改此字段以匹配实际状态。

要验证 JoFotara 在发票上返回的二维码：

  1. 安装 Sanad 应用。
  2. 进入 More。
  3. 点击 Validate document，扫描二维码。
  4. 查看验证结果。

若需向 JoFotara 发送借项单或贷项单，先创建相应的 debit 或 credit note（debit <accounting/credit_notes/issue-debit-note> / credit note <accounting/credit_notes/issue-credit-note>），在 Send 窗口选择 JoFotara (Jordan EDI) 即可实时验证。验证成功后，JoFotara 的二维码会嵌入借/贷项单 PDF。

:::: note ::: title 备注 :::

确保生成借/贷项单的 Reason（原因）符合 ISTD 规定。
::::

JoFotara 不支持发票行的负数量或负单价。因此，全局折扣和固定金额折扣功能不可用。折扣必须在每行发票上以百分比形式单独应用。

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

向 JoFotara 提交包含负数发票行的发票会导致验证错误。
::::

::: seealso Discount types <sales/discounts/discount-button> :::