Install the following modules to get all the features of the Egyptian localization:
Egypt - Accounting
Default fiscal localization package
Egyptian E-invoice Integration
CoquiAPPs is compliant with the Egyptian Tax Authority (ETA) e-invoicing requirements.
Egyptian e-invoicing is available from CoquiAPPs 15.0. If needed, upgrade your database.
Register CoquiAPPs on your ETA portal¶
You must register your CoquiAPPs ERP system on your ETA portal to get your API credentials. You need these codes to configure your CoquiAPPs Accounting app.
Access your company profile on the ETA portal by clicking on View Taxpayer Profile.
Next, go to the Representatives section and then click on Register ERP.
Fill out the ERP Name (e.g.,
CoquiAPPs) and leave the other fields empty.
Once successfully registered, the website displays your API credentials:
Client Secret 1
Client Secret 2
ETA should give you a username and a password to access their online portal.
Ask ETA to provide you with preproduction portal access as well.
These codes are confidential and should be stored safely.
Configuration on CoquiAPPs¶
To connect your CoquiAPPs database to your ETA portal account, go to ETA Client ID and ETA Secret that you retrieved when you registered CoquiAPPs on your ETA portal. Set an invoicing threshold if needed., and set the
Test on your preproduction portal before starting to issue real invoices on the production ETA portal.
Credentials for preproduction and production environments are different. Make sure to update them on CoquiAPPs when you move from one environment to another.
If not done yet, fill out your company details with your company’s full address, country, and Tax ID.
E-invoicing works with a set of codes provided by the ETA. You can use the ETA documentation to code your business attributes.
Company Tax ID
- Branch IDIf you have only one branch, use
0as the branch code.
Activity type Code
- Product CodesYour company’s products should be coded and matched with their GS1 or EGS codes.
- Tax CodesMost of the taxes codes are already configured on CoquiAPPs in the ETA Code (Egypt) field. We advise you to make sure these codes match your company’s taxes.
Create a contact and a journal for each branch of your company and configure its ETA settings.
To do so, go to Create., then click on
Name the journal according to your company’s branch and set the Type as Sales. Next, open the tab and fill out the Egyptian ETA settings section:
In the Branch field, select the branch’s contact or create it.
Set the ETA Activity Code.
Set the ETA Branch ID (use
0if you have one branch only).
The contact selected in the Branch field must be set as a Company (not as an Individual), and the Address and Tax ID fields must be filled out.
Make sure your customers’ contact forms are correctly filled out so your e-invoices are valid:
contact type: Individual: or Company:
Tax ID: Tax ID or Company registry for companies. National ID for individuals.
You can edit your customers’ contact forms by going to.
Make sure your products are correctly configured so your e-invoices are valid:
Product Type: storable products, consumables, or services.
Unit of Measure: if you also use CoquiAPPs Inventory and have enabled Units of Measure.
Barcode: GS1 or EGS barcode
ETA Item code (under the tab): if the barcode doesn’t match your ETA item code.
You can edit your products by going to.
Each person who needs to electronically sign invoices needs a specific USB key to authenticate and send invoices to the ETA portal through an ERP.
You can contact the ETA or Egypt Trust to get these USB keys.
Install CoquiAPPs as a local proxy on your computer¶
An CoquiAPPs local server works as a bridge between your computer and your CoquiAPPs database hosted online.
Download the CoquiAPPs Community installer from the page https://coqui.cloud/page/download and start the installation on your computer.
Select Local Proxy Mode as the type of install.
This installation of CoquiAPPs only works as a server and does not install any CoquiAPPs apps on your computer.
Once the installation is complete, the installer displays your access token for the CoquiAPPs Local Proxy. Copy the token and save it in a safe place for later use.
Configure the USB key¶
Once the local proxy server is installed on your computer, you can link it with your CoquiAPPs database.
Go to Create.and click on
Input a Company name, the ETA USB Pin given to you by your USB key provider, and the Access Token provided at the end of the local proxy installation, then click on Save.
Click on Get certificate.