Insights

OdooBot
OdooBot
8 min read

Odoo E-Receipt — Connecting Your Points of Sale to the Egyptian Tax Authority System

How to connect Odoo to Egypt's Tax Authority e-receipt system: who is legally required, the steps, the time, and how it differs from the e-invoice.

The direct answer: yes, you can connect Odoo to the e-receipt system in Egypt. The connection needs three things: registering your business with the Tax Authority, an electronic signature certificate, and giving every item you sell an approved code.

Before anything else, we will explain the words. Because most articles use them as if everyone already knows them.

What is an e-receipt? (explained from zero)

Imagine you bought medicine from a pharmacy. The pharmacist gives you a small piece of paper with the name of the medicine and the price. That paper is called a receipt.

An e-receipt is the same piece of paper. But one extra thing happens.

At the same moment the receipt is printed, the software sends a copy of it to the Egyptian Tax Authority over the internet. Automatically. Without the pharmacist doing anything.

So the idea is simple: every sale reaches the Tax Authority in the same second it happens.

And why does the state want this? To know the real size of sales in the market. This is the stated goal of the system: to connect the accounting software and the points of sale in shops to one central system that follows the transactions.

What does "system" mean? And what does "Odoo" mean?

Two words will keep coming back, so let's understand them:

The system means the big system that the Tax Authority owns. Imagine it as a giant mailbox at the Tax Authority. Every shop in Egypt sends its receipts to this mailbox.

Odoo is software for running companies. One program that follows the warehouse, the sales, the accounting, and the customers. Instead of ten separate Excel files, everything is in one place.

And "connecting" means making the two programs talk to each other. Odoo is on your side, and the system is at the Tax Authority. The connection is the road between them.

Who has to issue an e-receipt?

Not everyone, and not at the same time.

The Tax Authority works in stages. At each stage it issues a decision. The decision contains a list of the names of the shops and companies that are required to comply. If your name is on the list, you are required from the date written in the decision.

Real examples of decisions that were actually issued:

DecisionWho it coveredFrom what date
Decision No. 455 of 2024Taxpayers listed on the Authority's official page15 January 2025
Decision No. 281 of 2025Taxpayers of the 6th of October tax office and the Fifth Settlement tax office, listed in the annex to the decision15 September 2025

How do you know if you are required? Do not rely on a list written in an article. The lists change with every new stage. The right way: go to the Tax Authority's inquiry website and search for the name of your business.

An important practical tip: do not wait until your name appears.

Why? Imagine two cases. The first: a merchant who started getting ready before the decision reached him. He worked calmly, in his own time. The second: a merchant who suddenly got the decision, with only one month, and his shop works every day. This merchant will work under pressure, and he will make mistakes.

What is the difference between an e-receipt and an e-invoice?

This is the question that causes the most confusion. And the confusion here is costly. So let's make it clear with an example.

Imagine an electrical supplies shop.

A man comes in to buy a light bulb for his home. He is an ordinary consumer. He gets a receipt.

Then a contracting company comes in to buy 500 light bulbs for a project. This is a company. It gets an invoice.

So the basic difference is: who is the buyer?

E-invoiceE-receipt
The buyerA company or a government bodyAn ordinary person (a consumer)
Where is it issued from?From the accounting softwareFrom the cashier or the point of sale
Do we need the buyer's details?Yes, we need their tax numberNo, usually
When is it sent?It may be sent in batchesImmediately with every sale

And why does this matter to you?

Because many shops in Egypt sell to both types. The shop in the earlier example sells to the man and to the company. So it needs both systems, not one.

And here a common mistake happens: a shop sets up only the e-receipt, then finds out it is missing the e-invoice. And it pays twice.

Can Odoo connect to the system?

Yes. And it happens in three layers:

  1. The ready-made Egypt package in Odoo — Odoo provides settings specific to Egypt that deal with the e-invoice. This is the foundation.
  2. The e-receipt module — added on top of the foundation, to deal with selling to consumers from the cashier.
  3. Adjustments tailored to your business — because a pharmacy does not work like a restaurant, and a restaurant does not work like a clinic.

But notice something important:

The hard part of the project is not the programming. The hard part is preparing the item data.

We will explain what that means now, because it is the most important idea in the whole article.

What does "item coding" mean? And why is it the hardest step?

A code is an approved number or name for each product. Like the national ID number, but for products.

The Tax Authority does not accept that you write "paracetamol" on the receipt. It wants an approved code for this specific medicine. And it wants a unit of measure that matches its list (a box? a strip? a tablet?).

Now imagine a pharmacy. It has five thousand items. And the item names are written in different ways, because each employee wrote them in his own way. The same medicine is written three times with three names.

Before the connection can work, you must:

  • Give every item an approved code
  • Fix the duplicated names
  • Match the units of measure to the Authority's list

This is long human work, and it has nothing to do with programming. This is why the duration and the cost of projects differ so much. A shop with 100 items is not like a pharmacy with 5000.

The advice: start by coding the fastest-moving items first. Do not try to code everything from day one.

What are the connection steps, in order?

These are the steps in the order we actually carry them out:

Step 1 — Make sure you are required, and register your business Go to the inquiry website and check your name and the date. Then register your business on the system. You will get your own login details.

Step 2 — Get the electronic signature certificate The receipt must carry a "signature" that proves it is from you. This signature is not a signature by hand. It is a file or a small device installed on the computer, issued by an approved body.

Important: this is an administrative step. It takes time at the approved body, and it cannot be sped up with programming. Do not leave it to the end of the project.

Step 3 — Code the items and the units This is the longest step, as we explained.

Step 4 — Set up the settings inside Odoo Install the package and the module, and enter the login details. Then set up the branches, the cashiers, and the payment methods. And tell the software: when to issue a receipt, and when to issue an invoice.

Step 5 — Test on the test environment first The Authority provides a place for testing. Send test receipts. If the system rejects them, a message will appear explaining the reason. Fix it and try again.

Do not move to real operation before you test the hard cases: a customer returns a product, the cashier cancels a sale, a discount on the invoice, a customer who pays half in cash and half by Visa.

Step 6 — Go live, and watch the rejected ones every day After going live, check every day: were any receipts rejected? In the first two weeks especially. Repeated rejection is usually caused by a missing code or a unit that does not match.

Step 7 — Train the cashier Many people ignore this step, and it is a real cause of failure.

Imagine a long queue in a pharmacy. And issuing the receipt takes a long time. What will the employee do? He will find a way around it. Then after a month you discover that half of the sales were never sent.

A simple screen and good training are part of the project, not a luxury.

How long does it take and how much does it cost?

We will not write you a number. And this is on purpose.

Any number we write here, without seeing your case, would be a guess. And a guess hurts you.

But we can tell you honestly what raises the cost and the duration:

FactorWhy it matters
Number of itemsThe biggest factor. A hundred items is not like twenty thousand
The state of your current dataDuplicated and messy names = double the time
Number of branches and cashiersEvery branch needs setting up and testing
Do you already have Odoo?Connecting an existing program is faster than installing it from zero
How complex your selling isReturns, discounts, and mixed payments make testing longer
Do you need the invoice too?Anyone who sells to companies and to individuals needs both systems

The right way to price it: a short session in which we learn the number of your items, the state of your data, and the number of your branches. Then a written price offer.

A warning sign: any party that gives you a final price before it sees your data will either give you an incomplete solution, or raise the price later.

What is different in pharmacies, restaurants, and clinics?

The law is the same. But the implementation is different.

Pharmacies — the number of items is huge. And medicines have expiry dates and fixed prices. The challenge: coding thousands of items without stopping sales.

Restaurants — the item is made of parts. A sandwich is made of five ingredients. And the customer asks for a change: "no mayonnaise, extra cheese". And the receipt must come out immediately without stopping the kitchen.

Clinics and doctors — here we sell a service, not goods. And payment may be cash or insurance. And patient data is sensitive. So we must separate what is sent to the Tax Authority from what stays in the medical file.

Retail shops — they sell to consumers and wholesale. So they need both systems in one program.

Common mistakes that cost shop owners money

  1. They start programming before coding the items. The result: all receipts are rejected after going live.
  2. They set up only the e-receipt, then find out they are missing the invoice.
  3. They postpone the signature certificate to the end of the project, so everything stops waiting for paperwork.
  4. They ignore cashier training, so the employees get around the system at rush hour.
  5. They do not test returns and cancellations, which are the cases that get rejected most.
  6. They rely on an old list instead of a direct inquiry.

Frequently asked questions

Is the e-receipt mandatory for every shop? No, and not at the same time. The Tax Authority makes it mandatory in stages, and with each stage it issues a decision with the names of those required. Check with a direct inquiry on the Authority's website.

What is the difference between the receipt and the invoice? The receipt is for a sale to an ordinary person, and it comes out of the cashier immediately. The invoice is for a sale to a company or a government body, and it needs the buyer's tax number.

Can I connect without changing my current software? If you have Odoo, we add the connection to it without replacing it. And if you have another program, then either we connect it if it allows that, or you move to a program that supports both systems.

How long does the connection take? It depends on the number of your items, the state of your data, the number of your branches, and the time it takes to get the signature certificate. An accurate estimate needs a short session.

What if a receipt is rejected? The rejection is usually because of an item code that is not approved, a unit of measure that does not match, or missing data. The data is corrected and sent again. This is why we watch the rejected ones every day after going live.

What is the hardest step in the project? Coding the items. It is not a technical step, but long organizing work. And it is the reason the duration and the cost differ from one shop to another.

The next step

If your name is in a decision of obligation — or you expect it to be — then start coding your items now. It is the longest step, and the one that needs a programmer the least. Your team can start it today.

See the practical e-receipt demo from Mdarj to see how the receipt comes out of the cashier and reaches the Tax Authority.

And for anyone who needs Odoo installed or adjusted to support both systems: ERP and Odoo implementation and customization in Egypt.

Share:

Category: Odoo & ERP | أودو وأنظمة ERP

Social Media

How can we help you?

We are here to help you. Leave us a message and we will get in touch with you soon.

Recent Posts