约旦¶

模块¶

The following modules are installed automatically with the Jordanian localization:

名称	技术名称	说明
Jordan - Accounting	`l10n_jo`	Jordanian fiscal localization package, complete with the Jordanian chart of accounts, taxes, tax report, and fiscal positions
Jordan E-Invoicing	`l10n_jo_edi`	Integration module for JoFotara to support Jordanian e-invoicing requirements

注解

In some cases, such as when upgrading to a version with additional modules, it is possible that modules may not be installed automatically. Any missing modules can be manually installed.

Localization overview¶

The Jordanian localization package ensures compliance with Jordanian fiscal and accounting regulations. It includes tools for managing taxes, fiscal positions, reporting, and a predefined chart of accounts tailored to Jordan’s standards.

The Jordanian localization package provides the following key features to ensure compliance with local fiscal and accounting regulations:

会计科目表: a predefined structure tailored to Jordanian accounting standards
税率: pre-configured tax rates, including standard VAT, zero-rated, and exempt options
财政状况（税项和科目映射）: automated tax adjustments based on customer or supplier registration status
Tax reporting: detailed overview of your net tax liability
E-invoicing (JoFotara): integration for electronic invoicing in line with Jordanian government requirements

税率¶

The following taxes are available by default with the Jordanian localization package:

standard sales tax (16%): applied to most goods and services within Jordan.
exempt transactions: for sales and services not subject to VAT, such as financial services or healthcare.
export tax (0%): zero-rated tax applied to goods and services exported outside Jordan.

Tax reporting¶

The VAT summary provides a detailed breakdown of taxable, zero-rated, and exempt transactions. Like other financial reports, the VAT summary can be filtered by period, compared against other periods, and exported in Excel and PDF formats, ensuring compliance with Jordanian tax laws.

E-invoicing with JoFotara¶

E-invoicing with JoFotara is integrated with Odoo, ensuring compliance with Jordanian government’s technical and legal requirements for electronic invoicing. The JoFotara integration in Odoo directly connects with the Jordanian e-invoicing platform, allowing companies to:

generate compliant electronic invoices
submit invoices in real time for validation
track invoice statuses directly within Odoo

The integration requires first creating an account with JoFotara, then generating API credentials, and finally entering those credentials in your Odoo database to link the two.

Government manuals provide instructions for creating an account and generating the API credentials.

配置¶

Link Odoo to JoFotara¶

If you don’t already have an account, create one by going to the government manuals page and following the steps in the Procedure Manual for Joining the Jordanian National Electronic Invoicing System.
Generate API credentials (Activity Number, Secret Key, and Client ID) by going to the government manuals page and following the steps in Procedure Manual for Linking to the Jordanian National Electronic Invoicing System.
In your Odoo database, go to Accounting ‣ Configuration ‣ Settings. In the Electronic Invoicing (Jordan) section, enter the API credentials generated previously:
- Activity Number (income source sequence)
- JoFotara Secret Key
- JoFotara Client ID
Enter the Taxpayer type:
- Unregistered in the sales tax: for businesses not registered for sales tax. No tax on the invoice line is required.
- Registered in the sales tax: for businesses registered under the standard sales tax system. One tax computed as a percentage is required per invoice line.
- Registered in the special sales tax: for businesses subject to special sales tax regulations. One tax computed as a percentage and one fixed tax per invoice line are required per invoice.
点击:guilabel:保存。

小技巧

If the Electronic Invoicing (Jordan) section is missing from the Settings, make sure the Jordan E-Invoicing module is installed.

Company and customers¶

The JoFotara invoicing workflow requires address information related to the company that sends the invoices and the customers who receive them:

Go to Settings ‣ Users & Companies ‣ Companies and select the company that will use JoFotara.
Fill in the Company Name, Tax ID (TIN), and Country. If desired, fill in additional optional fields such as Street, City, State, and ZIP.
重要
- The Country must be set to Jordan.
- The Company Name must match the name that is registered with the Income and Sales Tax Department (ISTD).
- The company’s Currency must be set to JOD.
Go to Accounting ‣ Customers ‣ Customers.
For each customer whose invoices will be sent to JoFotara, click on the customer to open the form view, and complete the Country and Tax ID. If desired, fill in additional optional fields such as Street, City, State, and ZIP.

Sending invoices to JoFotara via Odoo¶

Once the company has been linked with JoFotara and the company and customers have been properly configured, invoices can be sent to JoFotara via Odoo:

Go to Accounting ‣ Customers ‣ Invoices and open a confirmed (posted) invoice.
Click Send.
In the Send window, select JoFotara (Jordan EDI) and click Send.

When an invoice is sent to JoFotara, Odoo does the following:

generates the invoice in the required format (UBL 1.2)
submits the invoice to JoFotara for validation
receives the QR code from JoFotara on the invoice’s PDF

小技巧

Multiple invoices can be sent at once to JoFotara.
From the Invoices list view, filter the invoices by their JoFotara State to see the invoices that have either been sent or not been sent to JoFotara.
In the (adjust settings) menu, add the JoFotara State and JoFotara Error fields to see the sending state and any errors in the list view, respectively.

重要

There is an inherent difference in how values are approximated in Odoo and ISTD due to the differing system architectures. JOD values in Odoo are stored and approximated to three decimals, whereas ISTD expects values to have nine decimals. As a result, an insignificant difference is inevitable and arises between the values stores in Odoo and the values reported to ISTD, which can have an error margin of <0.001.

JoFotara State¶

The JoFotara State field in the Other Info tab of confirmed invoices reflects the current state of the document in JoFotara. It can be changed manually to reflect the actual state of the invoices in cases where a technical error or timeout prevents Odoo from updating it automatically.

Validating QR codes (Sanad app)¶

To validate the QR code received from JoFotara on the invoice, follow these steps:

Install the Sanad app.
Navigate to More.
Click on Validate document and scan the QR code.
Review results.

Debit and credit notes¶

To send a debit or credit note to JoFotara, first create the debit or credit note. In the Send window, click JoFotara (Jordan EDI) to submit it for real-time validation. Upon successful validation, the QR code from JoFotara is embedded in the debit or credit note PDF.

注解

Ensure that the Reason for generating a debit/credit note aligns with ISTD regulations.

Discounts¶

JoFotara does not support negative quantities or negative prices on invoice lines. As a result, global discount and fixed amount discount functionality are not supported.

Discounts must be applied per invoice line as a percentage instead of as a global discount or fixed amount.

警告

Attempting to submit invoices to JoFotara with negative invoice lines will result in validation errors.