Guatemala

# Guatemala

## Introduction

With the Guatemalan localization, you can connect to the tax authority Superintendencia de
AdministraciÃ³n Tributaria (SAT) to generate electronic documents with its XML, fiscal folio, and
electronic signature.
The supported documents are:
- FACT-Factura ,
- FCAM-Factura Cambiaria ,
FCAM-Factura Cambiaria ,
- FPEQ-Factura de PequeÃ±o Contribuyente ,
FPEQ-Factura de PequeÃ±o Contribuyente ,
- NCRE-Credit Note ,
- NDEB-Debit Note ,
- NABN-Nota de Abono ,
- FCAP-Factura Cambiaria PequeÃ±o Contribuyente ,
FCAP-Factura Cambiaria PequeÃ±o Contribuyente ,
- FACT-Factura with Export Complement .
FACT-Factura with Export Complement .
The localization requires an Infile account, which enables users to
generate electronic documents within Odoo.
Documentation on e-invoicingâs legality and compliance in Guatemala

### Glossary

The following terms are used throughout the Guatemalan localization:
- SAT : Superintendencia de AdministraciÃ³n Tributaria is the government entity responsible for
enforcing tax payments in Guatemala.
SAT : Superintendencia de AdministraciÃ³n Tributaria is the government entity responsible for
enforcing tax payments in Guatemala.
- FEL : Factura ElectrÃ³nica en LÃnea is the electronic invoicing system mandated by the SAT in
Guatemala, which requires businesses to issue and manage electronic documents in compliance with
local regulations.
FEL : Factura ElectrÃ³nica en LÃnea is the electronic invoicing system mandated by the SAT in
Guatemala, which requires businesses to issue and manage electronic documents in compliance with
local regulations.
- EDI : Electronic Data Interchange refers to the sending of electronic documents.
EDI : Electronic Data Interchange refers to the sending of electronic documents.
- Infile : is the third-party organization that facilitates the interchange of electronic
documents between companies and the Guatemalan government.
Infile : is the third-party organization that facilitates the interchange of electronic
documents between companies and the Guatemalan government.
- UUID : Universally Unique Identifier is a unique alphanumeric code assigned by the SAT to
each certified electronic document in the FEL system, used for traceability and official
validation.
UUID : Universally Unique Identifier is a unique alphanumeric code assigned by the SAT to
each certified electronic document in the FEL system, used for traceability and official
validation.
- Phrases : Type of Phrases with specific Scenario Codes are used in the Guatemalan localization
to comply with the requirements of the SAT. They should be added depending on the issuer regime,
receiver, and operation type. These phrases are used in the XML and PDF documents.
Phrases : Type of Phrases with specific Scenario Codes are used in the Guatemalan localization
to comply with the requirements of the SAT. They should be added depending on the issuer regime,
receiver, and operation type. These phrases are used in the XML and PDF documents.
- Establishment Code : A unique identifier assigned by the SAT to each business establishment,
which is required for electronic invoicing.
Establishment Code : A unique identifier assigned by the SAT to each business establishment,
which is required for electronic invoicing.
- Quetzal : The official currency of Guatemala, represented by the symbol GTQ. This is the base
currency for all financial transactions in the Guatemalan localization.
Quetzal : The official currency of Guatemala, represented by the symbol GTQ. This is the base
currency for all financial transactions in the Guatemalan localization.

## Configuration

### Modules installation

Install the following modules to get all the features of the Guatemalan
localization:
Guatemala - Accounting
`l10n_gt`
The default fiscal localization package . It adds accounting
characteristics for the Guatemalan localization, which represent the minimum configuration
required for a company to operate in Guatemala according to the guidelines set by the SAT .
The moduleâs installation automatically loads the chart of accounts and taxes.
Guatemala Accounting EDI
`l10n_gt_edi`
Includes all the technical and functional requirements to generate and validate Electronics Documents , based on
the technical documentation published by the SAT . The authorized documents are listed
above .
Odoo automatically installs the base module Guatemala - Accounting when a database is
installed with Guatemala selected as the country. However, to enable electronic invoicing, the Guatemala Accounting EDI ( l10n_gt_edi ) module needs to be manually installed .
`Guatemala`
`l10n_gt_edi`

### Company

To configure your company information, open the Settings app, scroll down to the Companies section, click Update Info , and configure the following:
- Company Name
- Address , including the Street , City , State , ZIP , and Country
Address , including the Street , City , State , ZIP , and Country
- Tax ID : Enter the identification number for the selected taxpayer type.
Tax ID : Enter the identification number for the selected taxpayer type.
- VAT Affiliation : Select the VAT affiliation for the company, which is the type of
Regime the company belongs to.
VAT Affiliation : Select the VAT affiliation for the company, which is the type of
Regime the company belongs to.
- Legal Name : The legal name of the company, which is used in the XML and PDF documents.
Legal Name : The legal name of the company, which is used in the XML and PDF documents.
- Establishment Code : A necessary part of the XML when creating an electronic document.
If this field is not set, all electronic documents will be rejected. To locate the Establishment Code in your SAT account ,
go to FEL â£ AdministraciÃ³n de Establecimientos . The list of registered
establishments is displayed along with their corresponding codes.
Establishment Code : A necessary part of the XML when creating an electronic document.
If this field is not set, all electronic documents will be rejected.
To locate the Establishment Code in your SAT account ,
go to FEL â£ AdministraciÃ³n de Establecimientos . The list of registered
establishments is displayed along with their corresponding codes.
After configuring the company in the database settings, navigate to the companyâs contact form
and verify that the Identification Number Type is set to NIT .

### Electronic invoicing credentials

In Guatemala, electronic invoicing is mandatory for most businesses. Odoo connects with the
authorized provider, Infile, to generate and submit electronic documents to the SAT for
validation.
Before issuing electronic documents, you must configure and connect Odoo to Infile to ensure they
are properly validated and assigned an official UUID .

#### Infile

Sign a service agreement directly with Infile . Infile will then provide
the necessary credentials to input in Odoo.

#### Odoo

In Odoo, once you have completed the Infile process, navigate to Accounting â£
Configuration â£ Settings , scroll down to the Guatemalan Localization section, then
follow these steps:
- Select the Infile Web Services environment, either Test or Production .
Select the Infile Web Services environment, either Test or Production .
- Enter the Infile Credentials : Infile WS Username or Prefix Infile Token Infile Key
Enter the Infile Credentials :
- Infile WS Username or Prefix
Infile WS Username or Prefix
- Infile Token
- Infile Key
- Click on Save .
The Infile Credentials are provided by Infile and are required for both test and
production environments. If they are not available, contact Infile support.
The demo environment is for testing only and does not generate legal documents, UUID keys, or
fiscal folios. No Infile account or credentials are needed to use the demo environment.

#### Multi-currency

The official currency exchange rate in Guatemala is provided by the Bank of Guatemala. Odoo can
connect directly to its services and get the currency rate either automatically or manually.

### Master data

#### Chart of accounts

The chart of accounts is installed by default
as part of the set of data included in the localization module, the accounts are mapped
automatically in taxes, default accounts payable, and default accounts receivable.
Accounts can be added or deleted according to the companyâs needs.

#### Contacts

The following fields must be completed on contact forms:
- Company Name
- Address , including the Street , City , State , ZIP , and Country
Address , including the Street , City , State , ZIP , and Country
- Identification Number : Type : Select an identification type. Number : Required to confirm an electronic invoice.
Identification Number :
- Type : Select an identification type.
Type : Select an identification type.
- Number : Required to confirm an electronic invoice.
Number : Required to confirm an electronic invoice.
To automatically include a specific phrase in the XML and PDF of every electronic invoice for a
contact, select it in Phrases field in the Sales & purchase tab of the
contact form.

#### Taxes

As part of the Guatemala localization module, taxes are automatically created with their configuration
and related financial accounts.

## Electronic invoices

Once the database has been configured successfully, electronic documents can be created and sent.
Once customer invoices are validated, they can be sent
electronically to SAT via Infile, provided the following fields are completed:
- Customer : Type the customerâs information.
Customer : Type the customerâs information.
- GT Document Type : Select the type of document you want to create, i.e., FACT - Factura ElectrÃ³nica or FCAM - Factura Cambiara . By default, the
document type is set to FACT .
GT Document Type : Select the type of document you want to create, i.e., FACT - Factura ElectrÃ³nica or FCAM - Factura Cambiara . By default, the
document type is set to FACT .
- Due date : To compute if the invoice is due now or later.
Due date : To compute if the invoice is due now or later.
- Journal : Select the sales journal.
Journal : Select the sales journal.
- Products : Specify the product(s) with the correct taxes.
Products : Specify the product(s) with the correct taxes.
When done, click Confirm .
If you need to add a specific phrase based on the transaction, go to the Other Info tab and add the corresponding phrase in GT Phrases . These phrases are used in the XML
and PDF documents.
If you need to add an addendum to the invoice, you can do so in the Terms and
Conditions field. The addendum will be included in the XML document and can be used to provide
additional information or notes related to the invoice.
After the invoice confirmation, click Send . In the wizard that appears, make sure to
enable the Send to SAT and by Email checkboxes to send the XML to the SAT through Infileâs web service and the validated invoice to the clientâs email, and click Send . Then, the following occurs:
- The XML document is created.
The XML document is created.
- The UUID is generated.
The UUID is generated.
- The XML is processed synchronously by Infile. If accepted, the file is displayed in the chatter, and the email to the client with the
corresponding pdf and xml file is sent. If the file contains errors, a warning message displays the reason(s) and the email is not sent.
The XML is processed synchronously by Infile.
- If accepted, the file is displayed in the chatter, and the email to the client with the
corresponding pdf and xml file is sent.
If accepted, the file is displayed in the chatter, and the email to the client with the
corresponding pdf and xml file is sent.
`pdf`
`xml`
- If the file contains errors, a warning message displays the reason(s) and the email is not sent.
If the file contains errors, a warning message displays the reason(s) and the email is not sent.
The SAT tab then displays the following:
- Datetime : Timestamp recorded of the XML creation.
Datetime : Timestamp recorded of the XML creation.
- GT Status : Status result obtained in the SAT response. If the file contains errors,
a warning message displays the reason(s) and the email is not sent.
GT Status : Status result obtained in the SAT response. If the file contains errors,
a warning message displays the reason(s) and the email is not sent.
- UUID : The unique identifier assigned by the SAT to the electronic document.
UUID : The unique identifier assigned by the SAT to the electronic document.
- Download Certificate : To download the sent XML file, even if the SAT result was
rejected.
Download Certificate : To download the sent XML file, even if the SAT result was
rejected.

### Debit and credit notes

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

### Export invoices

Exportation invoices must meet the following conditions:
- The customerâs Identification type must be VAT , Passport , or Foreign ID .
The customerâs Identification type must be VAT , Passport , or Foreign ID .
- The following fields must be defined in the customer invoiceâs Other Info tab, under
the Accounting section: Incoterm GT Phrases : Type 4 Code 1 Consignatory Company
The following fields must be defined in the customer invoiceâs Other Info tab, under
the Accounting section:
- Incoterm
- GT Phrases : Type 4 Code 1
GT Phrases : Type 4 Code 1
- Consignatory Company
- All invoice lines must include taxes set to 0%.
All invoice lines must include taxes set to 0%.

Introduction
Glossary
Configuration
Modules installation
Company
Electronic invoicing credentials
Master data
Electronic invoices
Debit and credit notes
Export invoices


Hong Kong

# Hong Kong

## Configuration

Install the following modules to get the latest features of the Hong Kong
localization:
Hong Kong - Accounting
`l10n_hk`
The base module to manage chart of accounting and localization for Hong Kong.
`l10n_hk_hr_payroll`
Enables payroll specific localization features for Odoo Payroll app. This module also installs Hong Kong - Payroll with Accounting and Documents - Hong Kong Payroll .
Hong Kong - Payroll with Accounting
l10n_hk_hr_payroll_account
`l10n_hk_hr_payroll_account`
Installs the link between Hong Kong payroll and accounting.
Documents - Hong Kong Payroll
documents_l10n_hk_hr_payroll
`documents_l10n_hk_hr_payroll`
Integrates employee ir56 forms in the Odoo Documents app.

## FPS QR codes on invoices

FPS is a payment service platform that allows customers to make
instant domestic payments to individuals and merchants in Hong Kong dollars or Renminbi via online
and mobile banking.

### Activate QR codes

Go to Accounting app â£ Configuration â£ Settings . Under the Customer
Payments section, tick the checkbox beside the QR Codes feature. Then, click Save .

### FPS bank account configuration

Go to Contacts app â£ Configuration â£ Bank Accounts section â£ Bank Accounts .
Then select the bank account for FPS activation. Proceed to set the Proxy Type and fill
in the Proxy Value field, depending on the type chosen.
Remember to include the invoice number in the QR code, by ticking the Include Reference checkbox.
- The account holderâs country must be set to Hong Kong on its contact form.
The account holderâs country must be set to Hong Kong on its contact form.
`HongKong`
- The account holderâs city is mandatory.
The account holderâs city is mandatory.
- You could also include the invoice number in the QR code by checking the Include
Reference checkbox.
You could also include the invoice number in the QR code by checking the Include
Reference checkbox.
Bank and cash accounts

### Bank journal configuration

Go to Accounting app â£ Configuration â£ Journals and open the bank journal.
Then, fill out the Account Number and Bank fields, located in the Journal Entries tab.

### Issue invoices with FPS QR codes

When creating a new invoice, open the Other Info tab and set the Payment
QR-code option to EMV Merchant-Presented QR-code .
Ensure that the Recipient Bank is configured, as Odoo uses this field to generate the
FPS QR code.

Configuration
FPS QR codes on invoices
Activate QR codes
FPS bank account configuration
Bank journal configuration
Issue invoices with FPS QR codes


India

# India

## Installation

Install the following modules to get all the features of the Indian
localization:
`l10n_in`
Default fiscal localization package
`l10n_in_edi`
Indian e-invoicing integration
`l10n_in_edi_ewaybill`
Indian E-way bill integration
Indian E-waybill Stock
l10n_in_ewaybill_stock
`l10n_in_ewaybill_stock`
E-waybill creation from the Inventory app
Indian - Check GST Number Status
`l10n_in_gstin_status`
Indian Check GST Number Status
Indian - GSTR India eFiling
`l10n_in_reports_gstr`
Indian GST Return filing
Indian - Accounting Reports
`l10n_in_reports`

## GSP configuration

To use the e-Invoicing , E-Way bill , and GST return filing services in Odoo, configure BVM IT Consulting
Services India Private Limited as the GSP . To do so,
follow these steps :
- Upgrade the Indian - Accounting ( l10n_in ) module.
Upgrade the Indian - Accounting ( l10n_in ) module.
`l10n_in`
- Go to Accounting â£ Configuration â£ Settings .
Go to Accounting â£ Configuration â£ Settings .
- Scroll down to the Select GSP Provider section, and set the GSP field to BVM IT Consulting .
Scroll down to the Select GSP Provider section, and set the GSP field to BVM IT Consulting .
- Log into the NIC e-invoice portal and NIC E-Way bill portal and create a new API user for each.
Log into the NIC e-invoice portal and NIC E-Way bill portal and create a new API user for each.
- Go to Accounting â£ Configuration â£ Settings , scroll down to
the Indian Integration section, and enter the new Username and Password for the e-Invoicing and E-Way bill features.
Go to Accounting â£ Configuration â£ Settings , scroll down to
the Indian Integration section, and enter the new Username and Password for the e-Invoicing and E-Way bill features.

## Indian Configuration

In Settings â£ Users & Companies â£ Companies , add your PAN and GSTIN . The PAN is essential for determining the type of taxpayer,
while GSTIN is required for generating e-Invoices and E-waybills.

## e-Invoice system

Odoo is compliant with the Indian Goods and Services Tax (GST) e-Invoice system requirements.

### Setup

#### NIC e-Invoice registration

You must register on the NIC e-Invoice portal to get your API credentials . You need these credentials to configure your Odoo Accounting app .
- Log in to the NIC e-Invoice portal by clicking Login and entering your Username and Password ; Note If you are already registered on the NIC portal, you can use the same login credentials.
Log in to the NIC e-Invoice portal by clicking Login and entering your Username and Password ;
If you are already registered on the NIC portal, you can use the same login credentials.
- From the dashboard, go to API Registration â£ User Credentials â£ Create API
User ;
From the dashboard, go to API Registration â£ User Credentials â£ Create API
User ;
- After that, you should receive an OTP code on your registered mobile
number. Enter the OTP code and click Verify OTP ;
After that, you should receive an OTP code on your registered mobile
number. Enter the OTP code and click Verify OTP ;
- Select Through GSP for the API interface, set BVM IT Consulting Services
India Private Limited as GSP, and type in a Username and Password for
your API. Once it is done, click Submit .
Select Through GSP for the API interface, set BVM IT Consulting Services
India Private Limited as GSP, and type in a Username and Password for
your API. Once it is done, click Submit .

#### Configuration in Odoo

To enable the e-Invoice service in Odoo, go to Accounting â£ Configuration â£
Settings â£ Indian Electronic Invoicing , and enter the Username and Password previously set for the API.
Additionally, make sure the GSP field is configured in the
Accounting settings.
To automatically send e-Invoices to the NIC e-Invoice portal, you must first configure your sales journal by going to Accounting â£ Configuration â£ Journals , opening your sales journal, and in the Advanced Settings tab, under Electronic Data
Interchange , enable E-Invoice (IN) and save.

### Workflow

#### Invoice validation

Once an invoice is validated, a confirmation message is displayed at the top. Odoo automatically
uploads the JSON-signed file of validated invoices to the NIC e-Invoice portal after some time. If
you want to process the invoice immediately, click Process now .
- You can find the JSON-signed file in the attached files in the chatter.
You can find the JSON-signed file in the attached files in the chatter.
- You can check the documentâs EDI status under the EDI Document tab or the Electronic invoicing field of the invoice.
You can check the documentâs EDI status under the EDI Document tab or the Electronic invoicing field of the invoice.

#### Invoice PDF report

Once an invoice is validated and submitted, the invoice PDF report can be printed. The report
includes the IRN , Ack. No (acknowledgment number) and Ack. Date (acknowledgment date), and QR code. These certify that the invoice is a valid
fiscal document.

#### e-Invoice cancellation

If you want to cancel an e-Invoice, go to the Other info tab of the invoice and fill out
the Cancel reason and Cancel remarks fields. Then, click Request
EDI cancellation . The status of the Electronic invoicing field changes to To
Cancel .
Doing so cancels both the e-Invoice and the E-Way bill .
- If you want to abort the cancellation before processing the invoice, then click Call
Off EDI Cancellation .
If you want to abort the cancellation before processing the invoice, then click Call
Off EDI Cancellation .
- Once you request to cancel the e-Invoice, Odoo automatically submits the JSON-signed file to
the NIC e-Invoice portal. You can click Process now if you want to process the
invoice immediately.
Once you request to cancel the e-Invoice, Odoo automatically submits the JSON-signed file to
the NIC e-Invoice portal. You can click Process now if you want to process the
invoice immediately.

#### Management of negative lines in e-Invoices

Negative lines are typically used to represent discounts or adjustments associated with specific
products or global discounts. The government portal prohibits the submission of data with negative
lines, which means they need to be converted based on the HSN code and GST rate. This is done
automatically by Odoo.
Consider the following example:
Discount on Product A
Hereâs the transformed representation:
In this conversion, negative lines have been transformed into positive discounts, maintaining
accurate calculations based on the HSN Code and GST rate. This ensures a more straightforward and
standardized representation in the E-invoice records.

#### GST e-Invoice verification

After submitting an e-Invoice, you can verify if the invoice is signed from the GST e-Invoice system
website itself.
- Download the JSON file from the attached files. It can be found in the chatter of the related
invoice;
Download the JSON file from the attached files. It can be found in the chatter of the related
invoice;
- Open the NIC e-Invoice portal and go to Search â£ Verify Signed Invoice ;
Open the NIC e-Invoice portal and go to Search â£ Verify Signed Invoice ;
- Select the JSON file and submit it; If the file is signed, a confirmation message is displayed.
Select the JSON file and submit it;
If the file is signed, a confirmation message is displayed.

## E-Way bill

### Setup

Odoo is compliant with the Indian Goods and Services Tax (GST) E-waybill system requirements.

#### API registration on NIC E-Way bill

You must register on the NIC E-Way bill portal to create your API credentials . You need these credentials to configure your Odoo Accounting app .
- Log in to the NIC E-Way bill portal by clicking Login and entering your Username and Password ;
Log in to the NIC E-Way bill portal by clicking Login and entering your Username and Password ;
- From your dashboard, go to Registration â£ For GSP ;
From your dashboard, go to Registration â£ For GSP ;
- Click Send OTP . Once you have received the code on your registered mobile number,
enter it and click Verify OTP ;
Click Send OTP . Once you have received the code on your registered mobile number,
enter it and click Verify OTP ;
- Check if BVM IT Consulting Services India Private Limited is already on the
registered GSP/ERP list. If so, use the username and password used to log in to the NIC portal.
Otherwise, follow the next step.
Check if BVM IT Consulting Services India Private Limited is already on the
registered GSP/ERP list. If so, use the username and password used to log in to the NIC portal.
Otherwise, follow the next step.
- Select Add/New , select BVM IT Consulting Services India Private Limited as your GSP Name, create a Username and a Password for your API, and
click Add .
Select Add/New , select BVM IT Consulting Services India Private Limited as your GSP Name, create a Username and a Password for your API, and
click Add .

#### Configuration in Odoo

To set up the E-Way bill service, go to Accounting â£ Configuration â£ Settings
â£ Indian Electronic WayBill â£ Setup E-Way bill , and enter your Username and Password .
Additionally, make sure the GSP field is configured in the
Accounting settings.

### Workflow

#### Send an E-Way bill

To send an E-Way bill, confirm the customer invoice/vendor bill and click Send E-Way
bill .

#### Invoice validation

Once an invoice/bill has been issued and sent via Send E-Way bill , a confirmation
message is displayed.
- You can find the JSON-signed file in the attached files in the chatter.
You can find the JSON-signed file in the attached files in the chatter.
- Odoo automatically uploads the JSON-signed file to the government portal after some time. Click Process now if you want to process the invoice/bill immediately.
Odoo automatically uploads the JSON-signed file to the government portal after some time. Click Process now if you want to process the invoice/bill immediately.

#### Invoice PDF report

You can print the invoice PDF report once you have submitted the E-Way bill. The report includes the E-Way bill number and the E-Way bill validity date .

#### E-Way bill cancellation

If you want to cancel an E-Way bill, go to the E-Way bill tab of the related
invoice/bill and fill out the Cancel reason and Cancel remarks fields. Then,
click Request EDI Cancellation .
Doing so cancels both the e-Invoice (if applicable) and the E-Way bill .
- If you want to abort the cancellation before processing the invoice, click Call Off
EDI Cancellation .
If you want to abort the cancellation before processing the invoice, click Call Off
EDI Cancellation .
- Once you request to cancel the E-Way bill, Odoo automatically submits the JSON-signed file to
the government portal. You can click Process Now if you want to process the invoice
immediately.
Once you request to cancel the E-Way bill, Odoo automatically submits the JSON-signed file to
the government portal. You can click Process Now if you want to process the invoice
immediately.

### E-waybill creation from receipts and delivery orders

Make sure the E-Way bill Stock module is installed and
the E-Way bill setup is complete.
To create E-Way bills from receipts and deliveries in the Inventory
app, follow these steps:
- Go to Inventory â£ Operations â£ Deliveries or Inventory â£
Operations â£ Receipts and select an existing delivery order/receipt or create a new one.
Go to Inventory â£ Operations â£ Deliveries or Inventory â£
Operations â£ Receipts and select an existing delivery order/receipt or create a new one.
- Click Create E-waybill/Challan . Note To create an E-way bill: A delivery order must be in the Done state (i.e., validated) A receipt must have the Ready or Done state.
Click Create E-waybill/Challan .
To create an E-way bill:
- A delivery order must be in the Done state (i.e., validated)
A delivery order must be in the Done state (i.e., validated)
- A receipt must have the Ready or Done state.
A receipt must have the Ready or Done state.
- Click Generate e-Waybill to validate the E-Way bill and send it to the NIC E-Way
bill portal. Tip To use the E-Way bill as a challan for goods deliveries without sending it to the NIC
E-Waybill portal, click Use as Challan .
Click Generate e-Waybill to validate the E-Way bill and send it to the NIC E-Way
bill portal.
To use the E-Way bill as a challan for goods deliveries without sending it to the NIC
E-Waybill portal, click Use as Challan .
To print the E-waybill or the challan, click the (gear) icon and select Ewaybill / Delivery Challan .

## Indian Check GSTIN Status

The Indian - Check GST Number Status module allows you to verify the status of a GSTIN directly from Odoo.
To verify the status of a contactâs GST number, access the customerâs/vendorâs form and click Check GSTIN Status next to the GSTIN field.
To verify the status of a GST number entered on an invoice/bill, access the invoice/bill and click
the ( refresh ) button next to the GST Status field.
A notification is displayed to confirm the status update and the GSTIN status and verification date
are logged in the contactâs chatter.

## Indian GST Return filing

### Enable API access

To file GST Returns in Odoo, you must first enable API access on the GST portal.
- Log into the GST portal by entering your Username and Password , and go to My Profile on your profile
menu ;
Log into the GST portal by entering your Username and Password , and go to My Profile on your profile
menu ;
- Select Manage API Access , and click Yes to enable API access;
Select Manage API Access , and click Yes to enable API access;
It is recommended to set the Duration to 30 days to avoid the need for
frequent token reauthentication.
- Doing so enables a Duration drop-down menu. Select the Duration of your
preference, and click Confirm .
Doing so enables a Duration drop-down menu. Select the Duration of your
preference, and click Confirm .

### Indian GST Service In Odoo

Once you have enabled the API access on the GST portal, you can set up the Indian GST Service in Odoo.
Go to Accounting â£ Configuration â£ Settings â£ Indian GST Service and enter
the GST Username . Click Send OTP , enter the code, and finally, Validate .
Additionally, make sure the GSP field is configured in the
Accounting settings.

### File-in GST Return

When the Indian GST Service is configured, you can file your GST return. Go to Accounting â£ Reporting â£ India â£ GST Return periods and create a new GST
Return Period if it does not exist. GST Return file-in is done in three steps in Odoo:
Tax Return Periodicity can be configured according to the userâs
needs.

#### Send GSTR-1

- Click GSTR-1 Report to verify the GSTR-1 report before
uploading it to the GST portal . Note The system performs basic validations to ensure compliance with the GST portalâs requirements.
Possible issues include: Incorrect Tax Application: The tax type does not match the Fiscal Position ( CGST/SGST applied instead of IGST for interstate transactions, or IGST applied instead of CGST/SGST for intrastate transactions). Missing HSN Code: No HSN Code is defined for the product. Invalid HSN Code for Services: The HSN Code for a service does not start with â99â or is
incorrect. Non-compliant UQC: The Unit Quantity Code (UQC) does not meet Indian GST standards. If any validation fails, the system alerts users with a warning, highlighting the
discrepancies and providing a direct link to the affected lines.
Click GSTR-1 Report to verify the GSTR-1 report before
uploading it to the GST portal .
The system performs basic validations to ensure compliance with the GST portalâs requirements.
Possible issues include:
- Incorrect Tax Application: The tax type does not match the Fiscal Position ( CGST/SGST applied instead of IGST for interstate transactions, or IGST applied instead of CGST/SGST for intrastate transactions).
Incorrect Tax Application: The tax type does not match the Fiscal Position ( CGST/SGST applied instead of IGST for interstate transactions, or IGST applied instead of CGST/SGST for intrastate transactions).
- Missing HSN Code: No HSN Code is defined for the product.
Missing HSN Code: No HSN Code is defined for the product.
- Invalid HSN Code for Services: The HSN Code for a service does not start with â99â or is
incorrect.
Invalid HSN Code for Services: The HSN Code for a service does not start with â99â or is
incorrect.
- Non-compliant UQC: The Unit Quantity Code (UQC) does not meet Indian GST standards.
Non-compliant UQC: The Unit Quantity Code (UQC) does not meet Indian GST standards.
If any validation fails, the system alerts users with a warning, highlighting the
discrepancies and providing a direct link to the affected lines.
- Click Generate to view the report in Spreadsheet view .
Click Generate to view the report in Spreadsheet view .
- If the GSTR-1 report is correct, then click Push to GSTN to send it to the GST
portal . The status of the GSTR-1 report changes to Sending .
If the GSTR-1 report is correct, then click Push to GSTN to send it to the GST
portal . The status of the GSTR-1 report changes to Sending .
- After a few seconds, the status of the GSTR-1 report changes to Waiting for
Status . It means that the GSTR-1 report has been sent to the GST Portal and is
being verified on the GST Portal ;
After a few seconds, the status of the GSTR-1 report changes to Waiting for
Status . It means that the GSTR-1 report has been sent to the GST Portal and is
being verified on the GST Portal ;
- Once more, after a few seconds, the status either changes to Sent or Error
in Invoice . The status Error in Invoice indicates that some of the invoices are not
correctly filled out to be validated by the GST portal ; If the state of the GSTR-1 is Sent , it means your GSTR-1 report is ready to
be filed on the GST portal . If the state of the GSTR-1 is Error in Invoice , invoices can be checked for
errors in the chatter. Once issues have been resolved, the user can click Push to GSTN to submit the file again on the GST portal .
Once more, after a few seconds, the status either changes to Sent or Error
in Invoice . The status Error in Invoice indicates that some of the invoices are not
correctly filled out to be validated by the GST portal ;
- If the state of the GSTR-1 is Sent , it means your GSTR-1 report is ready to
be filed on the GST portal .
If the state of the GSTR-1 is Sent , it means your GSTR-1 report is ready to
be filed on the GST portal .
- If the state of the GSTR-1 is Error in Invoice , invoices can be checked for
errors in the chatter. Once issues have been resolved, the user can click Push to GSTN to submit the file again on the GST portal .
If the state of the GSTR-1 is Error in Invoice , invoices can be checked for
errors in the chatter. Once issues have been resolved, the user can click Push to GSTN to submit the file again on the GST portal .
- Click Mark as Filed after filing the GSTR-1 report on the GST portal . The
status of the report changes to Filed in Odoo .
Click Mark as Filed after filing the GSTR-1 report on the GST portal . The
status of the report changes to Filed in Odoo .

#### Receive GSTR-2B

Users can retrieve the GSTR-2B Report from the GST portal . This automatically reconciles
the GSTR-2B report with your Odoo bills;
- Click Fetch GSTR-2B Summary to retrieve the GSTR-2B summary. After a few seconds,
the status of the report changes to Waiting for Reception . This means Odoo is trying
to receive the GSTR-2B report from the GST portal ;
Click Fetch GSTR-2B Summary to retrieve the GSTR-2B summary. After a few seconds,
the status of the report changes to Waiting for Reception . This means Odoo is trying
to receive the GSTR-2B report from the GST portal ;
- Once more, after a few seconds, the status of the GSTR-2B changes to the Being
Processed . It means Odoo is reconciling the GSTR-2B report with your Odoo bills;
Once more, after a few seconds, the status of the GSTR-2B changes to the Being
Processed . It means Odoo is reconciling the GSTR-2B report with your Odoo bills;
- Once it is done, the status of the GSTR-2B report changes to either Matched or Partially Matched ; If the status is Matched : If the status is Partially Matched , you can review and modify the bills by
clicking View Reconciled Bills . This will display categorized discrepancies, such
as bills missing in Odoo or GSTR-2. After making the necessary corrections, click re-match to update the reconciliation and ensure accuracy before finalizing the
report.
Once it is done, the status of the GSTR-2B report changes to either Matched or Partially Matched ;
- If the status is Matched :
If the status is Matched :
- If the status is Partially Matched , you can review and modify the bills by
clicking View Reconciled Bills . This will display categorized discrepancies, such
as bills missing in Odoo or GSTR-2. After making the necessary corrections, click re-match to update the reconciliation and ensure accuracy before finalizing the
report.
If the status is Partially Matched , you can review and modify the bills by
clicking View Reconciled Bills . This will display categorized discrepancies, such
as bills missing in Odoo or GSTR-2. After making the necessary corrections, click re-match to update the reconciliation and ensure accuracy before finalizing the
report.

#### GSTR-3 report

The GSTR-3 report is a monthly summary of sales and purchases .
This return is auto-generated by extracting information from GSTR-1 and GSTR-2 .
- Users can compare the GSTR-3 report with the GSTR-3 report available on the GST portal to verify if they match by clicking GSTR-3 Report ;
Users can compare the GSTR-3 report with the GSTR-3 report available on the GST portal to verify if they match by clicking GSTR-3 Report ;
- Once the GSTR-3 report has been verified by the user and the tax amount on the GST portal has been paid. Once paid, the report can be closed by clicking Closing Entry ;
Once the GSTR-3 report has been verified by the user and the tax amount on the GST portal has been paid. Once paid, the report can be closed by clicking Closing Entry ;
- In Closing Entry , add the tax amount paid on the GST portal using challan, and
click POST to post the Closing Entry ;
In Closing Entry , add the tax amount paid on the GST portal using challan, and
click POST to post the Closing Entry ;
- Once posted, the GSTR-3 report status changes to Filed .
Once posted, the GSTR-3 report status changes to Filed .

## Tax reports

### GSTR-1 report

The GSTR-1 report is divided into sections. It displays the Base amount, CGST , SGST , IGST , and CESS for each section.

### GSTR-3 report

The GSTR-3 report contains different sections:
- Details of inward and outward supply subject to a reverse charge ;
Details of inward and outward supply subject to a reverse charge ;
- Eligible ITC ;
- Values of exempt , Nil-rated , and non-GST inward supply;
Values of exempt , Nil-rated , and non-GST inward supply;
- Details of inter-state supplies made to unregistered persons.
Details of inter-state supplies made to unregistered persons.

### Profit and Loss (IN) report

This is a Profit and Loss report that displays the balances for Opening Stock and Closing Stock . It helps users using Continental accounting to accurately determine the cost of
goods (i.e Opening Stock + purchases during the period - Closing Stock ).

## TDS/TCS threshold alert

TDS and TCS are tax provisions
under Indian law, triggered when transaction amounts exceed specified thresholds. This alert
notifies users when the value of invoices or bills surpasses these limits, prompting the application
of the appropriate TDS/TCS.
To configure Odoo to advise you on when to apply TDS/TCS, set the TDS/TCS section field on the corresponding account in the chart of accounts. Odoo will display a banner suggesting
the TDS/TCS section under which tax might be applicable when recording an invoice or bill.

### Configuration

- Navigate to Accounting â£ Configuration â£ Settings .
Navigate to Accounting â£ Configuration â£ Settings .
- In the Indian Integration section, enable the TDS and TCS feature.
In the Indian Integration section, enable the TDS and TCS feature.
- Navigate to Accounting â£ Configuration â£ Chart of Accounts .
Navigate to Accounting â£ Configuration â£ Chart of Accounts .
- Click View on the desired account, and set the TDS/TCS Section field.
Click View on the desired account, and set the TDS/TCS Section field.
The TDS/TCS sections are pre-configured with threshold limits. If you need to modify these
limits, go to Accounting â£ Configuration â£ Taxes . In the Advanced
Options tab, click on the (internal link) icon of the Section field.

### Applying TCS/TDS on invoices and bills

Based on the account used on the customer invoice or vendor bill, Odoo checks the TCS/TDS threshold
limit. If the limit specified in the TCS/TDS Section of the account is exceeded, Odoo
displays an alert that suggests applying the appropriate TCS/TDS. The alert will disappear once the
TCS/TDS is applied.
TCS is directly applicable in the tax on the invoice lines. To apply TDS , click the TDS Entry smart button on the vendor bill/payment. The popup window allows specifying
the TDS details. Confirm the entry to apply the TDS.
In Odoo, the aggregate total is calculated for partners sharing the same PAN number, across all
company branches.
Transaction Amount (â¹)
- Aggregate total = 50,000 + 30,000 + 40,000 + 20,000 + 60,000 = â¹200,000
Aggregate total = 50,000 + 30,000 + 40,000 + 20,000 + 60,000 = â¹200,000
- The aggregate total for all customers (XYZ Enterprise - GJ, MH, DL) sharing the PAN number
ABCPX1234E across all branches is â¹200,000.
The aggregate total for all customers (XYZ Enterprise - GJ, MH, DL) sharing the PAN number
ABCPX1234E across all branches is â¹200,000.


Indonesia

# Indonesia

## Modules

The following modules related to the Indonesian localization are available:
Indonesian - Accounting
`l10n_id`
This module includes the default fiscal localization package.
`l10n_id_efaktur`
This module includes the features required to export invoices as e-Faktur.
Indonesia E-faktur (Coretax)
l10n_id_efaktur_coretax
`l10n_id_efaktur_coretax`
This module facilitates the generation of XML files for the Coretax system.

## Configuration

### Company

Open the Settings app, go to the Companies section,
and click Update Info .
Ensure the NPWP field contains the Tax Identification Number , as an e-Faktur cannot
be generated from an invoice otherwise.

### Contacts

To configure a partner for e-Faktur, go to their contact form
and fill in the following Indonesian-specific fields:
- Is PKP : Check this box to allow e-Faktur generation for the partner.
Is PKP : Check this box to allow e-Faktur generation for the partner.
- NPWP : Enter the partnerâs Tax Identification Number.
NPWP : Enter the partnerâs Tax Identification Number.
- NIK : If the partner does not have an NPWP , enter the NIK in
the Accounting tab under Indonesian taxes .
NIK : If the partner does not have an NPWP , enter the NIK in
the Accounting tab under Indonesian taxes .

### Products

To set a productâs E-Faktur product code, go to Accounting â£ Customers â£
Products and access the desired product form. In the Indonesian Localization section,
select a code in the E-Faktur Product code field. By default, the code is set to 000000 - Barang .
E-Faktur product codes are pre-generated by Odoo and cannot be edited. Select a code
from the available options.

#### E-Faktur UoM Code

Go to Inventory â£ Configuration â£ Settings to make sure the Units of Measure option has been enabled.
To configure the E-Faktur UoM code , go to Inventory â£ Configuration
â£ UoM Categories . Open a category and select the appropriate E-Faktur UoM Code from
the options.

## Accounting

### E-invoicing

#### Generate an E-Faktur XML

An e-Faktur can be created for an invoice if the customerâs country is Indonesia and the Is PKP checkbox is enabled on their contact form.
To generate an e-Faktur XML:
- Go to Accounting â£ Customers â£ Invoices and create an invoice .
Go to Accounting â£ Customers â£ Invoices and create an invoice .
- In the Other Info tab, under the Electronic Tax section, select a Kode Transaksi code. Note The Kode Transaksi codes are pre-generated by Odoo and cannot be edited.
In the Other Info tab, under the Electronic Tax section, select a Kode Transaksi code.
The Kode Transaksi codes are pre-generated by Odoo and cannot be edited.
- After confirming the invoice, click the (Actions) icon and select Download e-faktur .
After confirming the invoice, click the (Actions) icon and select Download e-faktur .
The downloaded XML file can then be uploaded to the Coretax system. After the file is generated,
the e-Faktur Document (Coretax) field in the invoiceâs Electronic Tax section is populated automatically.
To create a batch XML file for several invoices, select them in the invoice list view and
choose Download e-faktur from the Actions menu.
- The tax invoice number is generated by the Coretax system, not by Odoo.
The tax invoice number is generated by the Coretax system, not by Odoo.
- Once an e-Faktur XML file has been downloaded, it cannot be changed. Any subsequent download
will retrieve the original file.
Once an e-Faktur XML file has been downloaded, it cannot be changed. Any subsequent download
will retrieve the original file.

## QRIS QR code on invoices

QRIS is a digital payment system that allows customers to make
payments by scanning the QR code from their preferred e-wallet.
According to the QRIS API documentation ,
QRIS expires after 30 minutes. Due to this restriction, the QR code is not included in reports
sent to customers and is only available on the customer portal.

### Activate QR codes

Go to Accounting â£ Configuration â£ Settings . Under the Customer
Payments section, activate the QR Codes feature.

### QRIS bank account configuration

Go to Contacts â£ Configuration â£ Bank Accounts and select the bank account for
which you want to activate QRIS. Set the QRIS API Key and QRIS Merchant ID based on the information provided by QRIS.
The account holderâs country must be set to Indonesia on its contact form.
`Indonesia`
Bank and cash accounts

### Bank journal configuration

Go to Accounting â£ Configuration â£ Journals , open the bank journal, then fill
out the Account Number and Bank under the Journal Entries tab.

### Issue invoices with QRIS QR codes

When creating a new invoice, open the Other Info tab and set the Payment
QR-code option to QRIS .
Ensure that the Recipient Bank is the one you configured, as Odoo uses this field to
generate the QRIS QR code.

Modules
Configuration
Company
Contacts
Products
Accounting
E-invoicing
QRIS QR code on invoices
Activate QR codes
QRIS bank account configuration
Bank journal configuration
Issue invoices with QRIS QR codes


Italy

# Italy

## Modules

The following modules are installed automatically with the Italian localization:
`l10n_it`
Default fiscal localization package
`l10n_it_edi`
E-invoice implementation
Italy - Declaration of Intent
`l10n_it_edi_doi`
Support for the Declaration of Intent (Dichiarazione di Intento)
Italy - E-invoicing - Additional module to support the debit notes (nota di debito - NDD)
`l10n_it_edi_ndd`
Adds payment methods and document types for debit notes
Italy E-invoicing - Bridge module between Italy NDD and Account Debit Note
l10n_it_edi_ndd_account_dn
`l10n_it_edi_ndd_account_dn`
Adds debit note fields
Italy - Sale E-invoicing
`l10n_it_edi_sale`
Sale modifications for E-invoicing
Italy eCommerce eInvoicing
l10n_it_edi_website_sale
`l10n_it_edi_website_sale`
Italian eCommerce eInvoicing features
Italy - E-invoicing (Withholding)
l10n_it_edi_withholding
`l10n_it_edi_withholding`
E-invoice withholding
Italy - Point of Sale
`l10n_it_pos`
Integration of Odoo PoS with the Italian fiscal printer
Italy - Accounting Reports
`l10n_it_reports`
Italy - Bank Receipts (Ri.Ba.)
`l10n_it_riba`
Generation of Ri.Ba. files from batch payments in Odoo
`l10n_it_stock_ddt`
Transport documents - Documento di Trasporto (DDT)
Italy - Tax Report XML Export
`l10n_it_xml_export`
Export of the Italian monthly tax report to XML format
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 .
Documentation on e-invoicingâs legality and compliance in Italy

### Company

Configuring the companyâs information ensures your Accounting database is properly set up. To add
information, open the Settings app, navigate to the Companies section, and click Update info . Then, fill out the fields:
- Address : the address of the company;
Address : the address of the company;
- VAT : VAT of the company;
VAT : VAT of the company;
- Codice Fiscale : the fiscal code of the company;
Codice Fiscale : the fiscal code of the company;
- Tax System : the tax system under which the company falls;
Tax System : the tax system under which the company falls;

### Taxes configuration

Many of the e-invoicing features are implemented using Odooâs tax system. As such, taxes must be
properly configured to generate invoices correctly and handle other billing use cases.
The Italian localization contains predefined examples of taxes for various purposes.

#### Tax exemption

The use of sale taxes that amount to zero percent (0%) is required by Italian authorities to
keep track of the exact Tax Exemption Kind (Natura) and Law Reference that
justify the exemption operated on an invoice line.
The export tax in the EU can be used as reference ( 0% EU , invoice label 00eu ). It can be
found under Accounting â£ Configuration â£ Taxes . Exports are exempt from VAT,
and therefore, they require Exoneration kind and Law Reference filled in.
`0%EU`
`00eu`
There are many Tax Exemption Kind (Natura) and Law Reference codes. Make
sure you check the latest version available to get the latest information on:
- Italian authorities documentation
Italian authorities documentation
- Official guide on Tax exemption
Official guide on Tax exemption
If you need to use a different kind of exoneration, go to Accounting â£
Configuration â£ Taxes , select a similar tax, then click on the cog icon and select Duplicate . In the Advanced Options tab, add the Exoneration and Law Reference . To confirm click Save .
Rename your taxes in the Name field according to their Exoneration to
differentiate them easily.

## Reverse charge

The reverse charge mechanism is a VAT rule that shifts the liability to pay VAT from the
supplier to the customer. The customers pay the VAT themselves to the AdE instead. There are different types:
- Internal Reverse Charge (for domestic sales) The VAT responsibility is shifted to the buyer for certain categories of products and services.
- External Reverse Charge (for intra-EU sales) VAT is due in the country of the delivery or in the country where the service is performed. When
the buyer is itself an Italian business, then the EU offers a mechanism that allows the seller
to transfer his responsibility to the buyer.

### Invoices

Reverse-charged customer invoices show no VAT amount, but the AdE requires the seller to specify the Tax Exemption reason and the Law
Reference that enable the reverse-charge mechanism. Odoo provides a set of special 0% taxes that
can be assigned to each reverse-charged invoice lines, representing the most commonly used
configurations.

### Vendor bills

Italian companies subjected to Reverse Charge must send the information in the bill received to the AdE .
Self-reported VAT XML files must be issued and sent to the AdE for reverse charged bills.
When creating a vendor bill, reverse charge taxes are available to be added in the Taxes field. You can check which taxes are available by going to Accounting â£ Configuration â£ Taxes , you can see that the 10% Goods and 22%
Services taxes are activated, among others. Due to the automated configuration of the Italian fiscal
position, these are automatically activated in the tax list.

### Tax grids

The Italian localization has a specific tax grid section for reverse charge taxes. These tax grids are identifiable by the VJ tag, and can be
found by going to Accounting â£ Reporting â£ Tax Return .

## E-invoicing

Make sure all the Italian-specific e-invoicing modules are installed .
The SdI is the electronic invoicing system used in Italy. It enables the sending
and receiving of electronic invoices to and from customers. The documents must be in an XML EDI format called FatturaPA and formally validated by the
system before being delivered.
To be able to receive invoices and notifications, the SdI service
must be notified that the userâs files need to be sent to Odoo and processed on their behalf. To do
so, you must set up Odooâs Destination Code on the AdE portal.
- Go to Italian authorities portal and
authenticate;
Go to Italian authorities portal and
authenticate;
- Go to section Fatture e Corrispettivi ;
Go to section Fatture e Corrispettivi ;
- Set the user as Legal Party for the VAT number you wish to configure the electronic address;
Set the user as Legal Party for the VAT number you wish to configure the electronic address;
- In Servizi Disponibili â£ Fatturazione Elettronica â£ Registrazione
dellâindirizzo telematico dove ricevere tutte le fatture elettroniche , insert Odooâs Destination Code K95IV18 , and confirm.
In Servizi Disponibili â£ Fatturazione Elettronica â£ Registrazione
dellâindirizzo telematico dove ricevere tutte le fatture elettroniche , insert Odooâs Destination Code K95IV18 , and confirm.
`K95IV18`

### EDI Mode and authorization

Since the files are transmitted through Odooâs server before being sent to the SdI or received by your database, you need to authorize Odoo to process your files
from your database. To do so, go to Accounting â£ Configuration â£ Settings and
scroll to the Italian Electronic Invoicing section.
There are three modes available:
- Demo This mode simulates an environment in which invoices are sent to the government. In this mode,
invoices need to be manually downloaded as XML files and uploaded to the AdE âs website.
- Test (experimental) This mode sends invoices to a non-production (i.e., test) service made available by the AdE . Saving this change directs all companies on the database to
use this configuration.
- Official This is a production mode that sends your invoices directly to the AdE .
Once a mode is selected, you need to accept the terms and conditions by ticking Allow
Odoo to process invoices , and then Save . You can now record your transactions in Odoo
Accounting.
Selecting either Test (experimental) or Official is irreversible .
For example, once in Official mode, it is not possible to select Test
(experimental) or Demo . We recommend creating a separate database for testing
purposes only.
When in Test (Experimental) mode, all invoices sent must have a partner using one
of the following fake Destination Code given by the AdE : 0803HR0 - N8MIMM9 - X9XX79Z . Any real production Codice Destinario of your customers will not be recognized as valid by the test service.
`0803HR0`
`N8MIMM9`
`X9XX79Z`

### Process

The submission of invoices to the SdI for Italy is an electronic
process used for the mandatory transmission of tax documents in XML format between companies and the AdE to reduce errors and verify the correctness of operations.
You can check the current status of an invoice by the SdI State field. The XML file
is attached to the invoice.

#### XML Documents creation

Odoo generates the required XML files as attachments to invoices in the FatturaPA format required
by the AdE . Once the invoices needed are selected, click the Send button.
`FatturaPA`
When the pop-up window opens there is a selection of actions that can be taken. Generate
XML File generates the attachments.
The XML file as well as the PDF once can be found attached to the invoice.
After choosing the desired actions, click send .

#### Submission to SDI

The Send to Tax Agency sends the attachment to the Proxy Server , which
gathers all requests and then forwards them via a WebServices channel to the SdI . Check the sending status of the invoice through the Check Sending button at the top of the invoiceâs view.

#### Processing by SDI

The SdI receives the document and verifies for any errors. At this
stage, the invoice is in the SdI Processing state, as shown on the invoice. The invoice
also gets assigned a FatturaPA Transaction number that is shown in the Electronic Invoicing tab. The checks may take variable time, ranging from a few seconds
up to a day, depending on the queue of invoices sent throughout Italy.

#### Acceptance

If the document is valid, it is recorded and considered fiscally valid by the AdE , which will proceed with archiving in Substitute Storage (Conservazione
Sostitutiva) if explicitly requested on the Agencyâs portal.
Odoo does not offer the Conservazione Sostitutiva requirements. Other providers
and AdE supply free and certified storage to meet the
specifications requested by law.
The SdI Destination Code attempts to forward the
invoice to the customer at the provided address, whether it is a PEC email address or a SdI Destination Code for their ERPâs WebServices
channels. A maximum of 6 attempts are made every 12 hours, so even if unsuccessful, this process can
take up to three days. The invoice status is Accepted by SDI, Forwarding to Partner .
`PEC`

#### Possible Rejection

The SdI may find inaccuracies in the compilation, possibly even
formal ones. In this case, the invoice is in the SDI Rejected state. The SdI âs observations are inserted at the top of the Invoice tab. To resolve the
issue, it is sufficient to delete the attachments of the invoice, return the invoice to Draft , and fix the errors. Once the invoice is ready, it can be resent.
To regenerate the XML, both the XML attachment and the PDF report must be deleted, so that they
are then regenerated together. This ensures that both always contain the same data.

#### Forwarding Completed

The invoice has been delivered to the customer; however, you can still send a copy to the customer
in PDF via email or post. Its status is Accepted by SDI, Delivered to Partner .
If the SdI cannot contact your customer, they may not be
registered on the AdE portal. In this case, just make sure to send
the invoice in PDF via email or by mail. The invoice is then in the Accepted by SDI,
Partner Delivery Failed state.

### Tax Integration

When you receive a vendor bill, either from SdI , from paper or
from an imported XML file, the Tax Agency might request that you send some tax information
integration back to the SdI . It happens when a transaction that
was tax exempt becomes taxable for any reason.
Here is a non-exhaustive list:
- Reverse charge As a buyer, you have to pay taxes on what you buy and integrate tax information. Reverse Charge taxes.
- Split Payment As a PA business buyer, you have to pay taxes and integrate
tax information. Be sure that you replace the 0% Sale Taxes on the vendor bill
you received with the correct Split Payment taxes.
- Self Consumption When, as a business owner, you use an asset that you bought for business for personal reasons
instead, you have to pay those taxes you originally deducted as a business cost for it.
Odoo may detect that your vendor bill can be interpreted as a document of a type that needs tax
integration, as detailed in the Document Types section.
Be sure that you replace the 0% Sale Taxes on the vendor bill you received with the
ones youâre supposed to pay to the AdE . A button then appears on
the top of the single vendor bill form to send them.
When clicking on the Send Tax Integration button, an XML file of the appropriate Document Type is generated, attached to the bill, and sent as for invoices.

### Document Types

The SdI requires businesses to send customer invoices and other
documents through the EDI .
The following Document Type codes all technically identify different business use cases.

#### TD01 - Invoices

This represents the standard domestic scenario for all invoices exchanged through the SdI . Any invoice that doesnât fall into one of the specific special cases
is categorized as a regular invoice, identified by the Document Type TD01 .
`TD01`

#### TD02 - Down payments

Down payment invoices are imported/exported with a different Document Type code TDO2 than regular invoices. Upon import of the invoice, a regular vendor bill is created.
`TDO2`
Odoo exports transactions as TD02 if the following conditions are met:
`TD02`
- It is an invoice;
- All invoice lines are related to down payment sales order lines.
All invoice lines are related to down payment sales order lines.

#### TD04 - Credit notes

It is the standard scenario for all credit notes issued to domestic clients, when we need to
formally acknowledge that the seller is reducing or cancelling a previously issued invoice, for
example, in case of overbilling, incorrect items, or overpayment. Just like invoices, they must be
sent to the SdI , their Document Type TD04
`TD04`

#### TD07, TD08, TD09 - Simplified Invoicing

Simplified invoices ( TD07 ), credit notes ( TD08 ), and debit notes ( TD09 ) can be used to certify
domestic transactions under 400 EUR (VAT included). Its status is the same as that of a regular
invoice, but with fewer information requirements.
`TD07`
`TD08`
`TD09`
For a simplified invoice to be established, it must include:
- Customer Invoice reference: unique numbering sequence with no gaps ;
Customer Invoice reference: unique numbering sequence with no gaps ;
- Invoice Date : issue date of the invoice;
Invoice Date : issue date of the invoice;
- Company Info : the seller âs full credentials (VAT/TIN
number, name, full address);
Company Info : the seller âs full credentials (VAT/TIN
number, name, full address);
- VAT : the buyer âs VAT/TIN number (on the partner form);
VAT : the buyer âs VAT/TIN number (on the partner form);
- Total : the total amount (VAT included) of the invoice.
Total : the total amount (VAT included) of the invoice.
In the EDI , Odoo exports invoices as simplified if:
- It is a domestic transaction (i.e., the partner is from Italy);
It is a domestic transaction (i.e., the partner is from Italy);
- Your companyâs required fields ( VAT Number or Codice Fiscale , Fiscal Regime , and full address ) are provided;
Your companyâs required fields ( VAT Number or Codice Fiscale , Fiscal Regime , and full address ) are provided;
- The partnerâs address is not fully specified (i.e., it misses the City or the ZipCode);
The partnerâs address is not fully specified (i.e., it misses the City or the ZipCode);
- The total amount of VAT included is less than 400 EUR .
The total amount of VAT included is less than 400 EUR .
The 400 EUR threshold was defined in the decree of the 10th of May 2019 in the Gazzetta
Ufficiale . We advise you to
check the current official value.

#### TD16 - Internal Reverse Charge

Internal reverse charge transactions (see Tax exemption and Reverse charge ) are exported as TD16 if the following conditions are
met:
`TD16`
- It is a vendor bill;
- It has at least one tax on the invoice lines that targets one of these tax grids : VJ6 , VJ7 , VJ8 , VJ12 , VJ13 , VJ14 , VJ15 , VJ16 , VJ17
It has at least one tax on the invoice lines that targets one of these tax grids : VJ6 , VJ7 , VJ8 , VJ12 , VJ13 , VJ14 , VJ15 , VJ16 , VJ17
`VJ6`
`VJ7`
`VJ8`
`VJ12`
`VJ13`
`VJ14`
`VJ15`
`VJ16`
`VJ17`

#### TD17 - Buying services from abroad

When buying services from EU and non-EU countries, the foreign seller invoices a
service with a VAT-excluded price, as it is not taxable in Italy. The VAT is paid by the buyer in Italy.
- Within the EU: the buyer integrates the invoice received with the VAT information due in
Italy (i.e., vendor bill tax integration );
Within the EU: the buyer integrates the invoice received with the VAT information due in
Italy (i.e., vendor bill tax integration );
- Non-EU: the buyer sends themselves an invoice (i.e., self-billing ).
Non-EU: the buyer sends themselves an invoice (i.e., self-billing ).
Odoo exports a transaction as TD17 if the following conditions are met:
`TD17`
- It is a vendor bill;
- It has at least one tax on the invoice lines that targets the tax grid VJ3 ;
It has at least one tax on the invoice lines that targets the tax grid VJ3 ;
- All invoice lines either have Services as products , or a tax with the Services as tax scope .
All invoice lines either have Services as products , or a tax with the Services as tax scope .

#### TD18 - Buying goods from EU

Invoices issued within the EU follow a standard format , therefore only an integration of the
existing invoice is required.
Odoo exports a transaction as TD18 if the following conditions are met:
`TD18`
- It is a vendor bill;
- The partner is from an EU country;
The partner is from an EU country;
- It has at least one tax on the invoice lines that targets the tax grid VJ9 ;
It has at least one tax on the invoice lines that targets the tax grid VJ9 ;
- All invoice lines either have Consumable as products , or a tax with Goods as tax scope .
All invoice lines either have Consumable as products , or a tax with Goods as tax scope .

#### TD19 - Buying goods from VAT deposit

Buying goods from a foreign vendor, but the goods are already in Italy in a VAT
deposit .
- From the EU: the buyer integrates the invoice received with the VAT information due in
Italy (i.e., vendor bill tax integration );
From the EU: the buyer integrates the invoice received with the VAT information due in
Italy (i.e., vendor bill tax integration );
- Non-EU: the buyer sends an invoice to themselves (i.e., self-billing ).
Non-EU: the buyer sends an invoice to themselves (i.e., self-billing ).
Odoo exports a transaction as a TD19 if the following conditions are met:
`TD19`
- It is a vendor bill;
- It has at least one tax on the invoice lines that targets the tax grid VJ3 ;
It has at least one tax on the invoice lines that targets the tax grid VJ3 ;
- All invoice lines either have Consumables as products, or a tax with Goods as tax scope .
All invoice lines either have Consumables as products, or a tax with Goods as tax scope .

#### TD24 - Deferred invoices

The deferred invoice is an invoice that is issued at a later time than the sale of goods or
the provision of services. A deferred invoice has to be issued at the latest within the 15th
day of the month following the delivery covered by the document.
It usually is a summary invoice containing a list of multiple sales of goods or services carried
out in the month. The business is allowed to group the sales into one invoice , generally
issued at the end of the month for accounting purposes. Deferred invoices are default for wholesalers having recurrent clients.
If the goods are transported by a carrier , every delivery has an associated Documento di
Transporto (DDT) , or Transport Document . The deferred invoice must indicate the details of
all the DDTs information for better tracing.
E-invoicing of deferred invoices requires the l10n_it_stock_ddt module . In this case, a dedicated Document Type TD24 is
used in the e-invoice.
`l10n_it_stock_ddt`
`TD24`
Odoo exports transactions as TD24 if the following conditions are met:
`TD24`
- It is an invoice;
- It is associated with deliveries whose DDTs have a different date than the issue date of
the invoice.
It is associated with deliveries whose DDTs have a different date than the issue date of
the invoice.

#### TD28 - San Marino

San Marino and Italy have special agreements on e-invoicing operations. As such, invoices follow
the regular reverse charge rules. You can use the proper Document Type depending on
the invoice type: TD01 , TD04 , TD05 , TD24 , TD25 . Additional requirements are not enforced
by Odoo. However, the user is requested by the State to:
`TD01`
`TD04`
`TD05`
`TD24`
`TD25`
- Select a tax with the Tax Exemption Kind set to N3.3 ;
Select a tax with the Tax Exemption Kind set to N3.3 ;
`N3.3`
- Use the generic SdI Destination Code 2R4GTO8 .
Use the generic SdI Destination Code 2R4GTO8 .
`2R4GTO8`
The invoice is then routed by a dedicated office in San Marino to the correct business.
When a paper bill is received from San Marino, any Italian company must submit that invoice
to the AdE by indicating the e-invoiceâs Document Type field with the special value TD28 .
`TD28`
Odoo exports a transaction as TD28 if the following conditions are met:
`TD28`
- It is a vendor bill;
- It has at least one tax on the invoice lines that targets the tax grids VJ ;
It has at least one tax on the invoice lines that targets the tax grids VJ ;
- The country of the partner is San Marino .
The country of the partner is San Marino .

## Public Administration Businesses (B2G)

PA businesses are subjected to more control than private businesses
as they handle public money coming from taxpayers. The EDI process adds some steps to the regular one , as PA businesses can accept or refuse invoices.
PA businesses have a 6-digit long Destination Code ,
also called CUU , that is mandatory , PEC address cannot
be used in this case.
Complete list of businesses that belong to the Public Administration along with their
Destination Code

### CIG, CUP, DatiOrdineAcquisto

To ensure the effective traceability of payments by public administrations, electronic invoices
issued to public administrations must contain:
- The CIG , except in cases of exclusion from traceability
obligations provided by law n. 136 of August 13, 2010;
The CIG , except in cases of exclusion from traceability
obligations provided by law n. 136 of August 13, 2010;
- The CUP , in case of invoices related to public works.
The CUP , in case of invoices related to public works.
If the XML file requires it, the AdE can only proceed payments of
electronic invoices when the XML file contains a CIG and CUP .
The CUP and the CIG must
be included in one of the DatiOrdineAcquisto , DatiContratto , DatiConvenzione , DateRicezione , or DatiFattureCollegate XML tags.
`DatiOrdineAcquisto`
`DatiContratto`
`DatiConvenzione`
`DateRicezione`
`DatiFattureCollegate`
These correspond to the elements named CodiceCUP and CodiceCIG of the
electronic invoice XML file, whose table can be found on the government website .

### Split Payment

The Split Payment mechanism behaves much like Reverse charge .
When an Italian company bills a PA business - for example,
cleaning services for a public building - the PA business
self-reports the VAT to the Tax Agency themselves, and the vendor just has to select the
appropriate tax with the right Tax Exemption for their invoice lines.
The specific Scissione dei Pagamenti fiscal position is available to deal with partners
belonging to the PA .

### Process

#### Qualified electronic signature

Invoices and bills intended for the PA must include a qualified
electronic signature when submitted through the SdI . This
signature is automatically applied in the XAdES format
when the invoiceâs partner has a 6-digit long Destination Code (which indicates a PA business).
When such an invoice is transmitted to the Tax Agency, the generated .xml file is signed on the
Odoo servers, returned to the database, and attached to the invoice automatically.
`.xml`

#### Acceptance or Refusal

After receiving the invoice through the SdI , the PA business has 15 days to accept the invoice. If it does, then the process ends here.
If the PA business refuses the invoice, it is still considered valid
once it is accepted by the SdI . You then have to issue a credit
note to compensate and send it to the SdI .

#### Expired Terms

If the PA business doesnât reply within 15 days, you need to contact
the PA business directly, sending them both the invoice and the
received deadline notification by email. You can make an arrangement with them and manually set the
correct SdI State on your invoice.

## Point of Sale fiscal printers

Fiscal printers are distinct from ePOS printers . The IP address for a fiscal
printer should not be entered in the ePOS IP address settings.
Fiscal regulations mandate using certified RT devices, such as RT printers or RT servers, to ensure
compliant sales receipts and secure communication with the Tax Authority. These devices
automatically transmit fiscal data daily. RT printers, designed for individual POS terminals, handle
transactions, print receipts, and report to the authorities, ensuring data integrity and compliance.

### Simulation mode

Since the simulation mode sends data to the authorities, it should only be enabled at the very
start of the printerâs configuration process. Once the printer is switched to the production
mode, it cannot be reverted to the simulation mode.
To test the fiscal printer setup with Odoo, configure the fiscal printer in the simulation mode
as follows:
- Make sure the fiscal printer is set to its default state: printer on, start-up cycle complete,
and no transaction in progress.
Make sure the fiscal printer is set to its default state: printer on, start-up cycle complete,
and no transaction in progress.
- Type 3333 .
`3333`
- Press Chiave . The screen displays Scelta Funzione .
Press Chiave . The screen displays Scelta Funzione .
- Type 14 . The screen displays Apprendimento .
Type 14 . The screen displays Apprendimento .
`14`
- Type 62 . The screen displays Simulazione .
Type 62 . The screen displays Simulazione .
`62`
- To turn the no into a si , press X .
To turn the no into a si , press X .
- To confirm, press Contante .
To confirm, press Contante .
- Press Chiave .
To configure the printer for production, repeat the steps above.
To test the printer configuration, the physical device must first be obtained and registered with
the relevant authorities.

### Setting up the printer to work with Odoo

Fiscal printers are meant to work only in the local network. This means the printer and the
device running Odoo Point of Sale must be connected to
the same network.
Fiscal printers are typically configured to use HTTP by default. To ensure compatibility with Odoo,
the settings must be updated to enable HTTPS support on the printer. This can be done using either
the EpsonFPWizard configuration software or the keyboard connected to the printer.
To set up the fiscal printer using the keyboard, follow these steps:
- Make sure the fiscal printer is set to its default state: printer on, start-up cycle complete,
and no transaction in progress.
Make sure the fiscal printer is set to its default state: printer on, start-up cycle complete,
and no transaction in progress.
- Type 3333 .
`3333`
- Press Chiave . The screen displays Scelta Funzione .
Press Chiave . The screen displays Scelta Funzione .
- Type 34 . The screen displays Web Server .
Type 34 . The screen displays Web Server .
`34`
- Press Contante 3 times until the screen displays Web Server: SSL .
Press Contante 3 times until the screen displays Web Server: SSL .
- To turn the value 0 into a 1 , press X .
To turn the value 0 into a 1 , press X .
`0`
`1`
- To confirm, press Contante 3 times.
To confirm, press Contante 3 times.
- Press Chiave .
Then, log in to the printer with the device that runs Odoo Point of Sale so it recognizes the printerâs certificate.
To approve and install the printerâs certificate, follow these steps:
- Access the printer by opening a web browser and entering https://<ip-of-your-printer> in the
address bar. A Warning: Potential Security Risk Ahead security message appears.
Access the printer by opening a web browser and entering https://<ip-of-your-printer> in the
address bar. A Warning: Potential Security Risk Ahead security message appears.
`https://<ip-of-your-printer>`
- Click Advanced to show the certificate approval options.
Click Advanced to show the certificate approval options.
- Click Proceed to validate the certificate.
Click Proceed to validate the certificate.
Then, to ensure Odoo Point of Sale is configured with the
fiscal printer, go to Point of Sale â£ Configuration â£ Settings . In the Connected Devices section, add the IP address in the Italian Fiscal Printer
IP address and enable Use HTTPS .

## Ri.Ba. (Ricevuta Bancaria)

Ri.Ba. is a payment method widely used in Italy where vendors request
payments through their bank, which forwards the request to the customerâs own bank and takes
responsibility for the collection. This enables payment automation and reduces risks for the vendor.
The vendor generally uploads a fixed-format text file with the list of payments to the bankâs web
portal.
- Ri.Ba. are exclusively for domestic payments in Italy. For
recurring international payments, please use SEPA Direct Debt (SDD)
Ri.Ba. are exclusively for domestic payments in Italy. For
recurring international payments, please use SEPA Direct Debt (SDD)

### Configuration

- Check that the l10n_it_riba module is installed .
Check that the l10n_it_riba module is installed .
`l10n_it_riba`
- Go to Settings â£ Users & Companies â£ Companies and select the company that
will use Ri.Ba. .
Go to Settings â£ Users & Companies â£ Companies and select the company that
will use Ri.Ba. .
- Fill out the required SIA Code . Note The SIA Code identifies businesses within the Italian banking network and is used
to receive money through specific payment methods. It consists of one letter and four digits
(e.g., T1234) and can usually be found on the bankâs portal or obtained by contacting the
bank.
Fill out the required SIA Code .
The SIA Code identifies businesses within the Italian banking network and is used
to receive money through specific payment methods. It consists of one letter and four digits
(e.g., T1234) and can usually be found on the bankâs portal or obtained by contacting the
bank.
- Ensure the Companyâs bank account has an Italian IBAN. See also How to configure Bank Accounts
Ensure the Companyâs bank account has an Italian IBAN.
How to configure Bank Accounts

### Accept Ri.Ba. for your invoices

Payments of type Ri.Ba. can be registered from the Invoices ( Accounting â£ Customers â£ Invoices ).
Make sure that your invoice involves a Partner that has a bank account with an Italian IBAN.
Then, all Payments must be grouped in a Batch Payment .
- Batch Payments
- Create a Batch Payment
Create a Batch Payment
Once you press the Validate button for the Batch Payment, the Ri.Ba. file is generated and attached to the Batch Payment, so you can download it and upload it
through your bankâs web portal.


Jordan

# Jordan

## Modules

The following modules are installed automatically with the Jordanian localization:
`l10n_jo`
Jordanian fiscal localization package , complete with
the Jordanian chart of accounts, taxes, tax report, and fiscal positions
`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 .
Jordan Payroll localization documentation

## 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:
- Chart of accounts : a predefined structure tailored to Jordanian
accounting standards
Chart of accounts : a predefined structure tailored to Jordanian
accounting standards
- Taxes : pre-configured tax rates, including standard VAT, zero-rated,
and exempt options
Taxes : pre-configured tax rates, including standard VAT, zero-rated,
and exempt options
- Fiscal positions (tax and account mapping) : automated tax adjustments based on customer or
supplier registration status
Fiscal positions (tax and account mapping) : automated tax adjustments based on customer or
supplier registration status
- Tax reporting : detailed overview of your net tax liability
Tax reporting : detailed overview of your net tax liability
- E-invoicing (JoFotara) : integration for electronic invoicing
in line with Jordanian government requirements
E-invoicing (JoFotara) : integration for electronic invoicing
in line with Jordanian government requirements

### Taxes

The following taxes are available by default with the Jordanian
localization package:
- standard sales tax (16%): applied to most goods and services within Jordan.
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.
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.
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
generate compliant electronic invoices
- submit invoices in real time for validation
submit invoices in real time for validation
- track invoice statuses directly within Odoo
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.

### Configuration

#### 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 .
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 .
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
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)
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.
Enter the Taxpayer type :
- Unregistered in the sales tax : for businesses not registered for sales tax. No tax
on the invoice line is required.
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 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.
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.
- Click Save .
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.
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 . Important 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 .
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 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 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 .
The companyâs Currency must be set to JOD .
- Go to Accounting â£ Customers â£ Customers .
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 .
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.
Go to Accounting â£ Customers â£ Invoices and open a confirmed (posted)
invoice.
- Click Send .
- In the Send window, select JoFotara (Jordan EDI) and 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)
generates the invoice in the required format (UBL 1.2)
- submits the invoice to JoFotara for validation
submits the invoice to JoFotara for validation
- receives the QR code from JoFotara on the invoiceâs PDF
receives the QR code from JoFotara on the invoiceâs PDF
- Multiple invoices can be sent at once to JoFotara.
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.
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.
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 .
Install the Sanad app .
- Navigate to More .
- Click on Validate document and scan the QR code.
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.

Modules
Localization overview
Taxes
Tax reporting
E-invoicing with JoFotara
Configuration
Sending invoices to JoFotara via Odoo