Skip to content

Conversation

@fw-bot
Copy link
Collaborator

@fw-bot fw-bot commented Jan 30, 2026

We have had lots of tickets recently about failed ZATCA onboarding. One of the most common reasons is that the company or branch name is too long compared to the strict limits imposed by zatca.

As for the limits, they are technical, imposed by the QR code generated for every invoice.

The limit itself is 127 bytes, which depending on the exact arabic characters used can range from 42 to 63 arabic characters. 63 is in the best-case scenario where we can encode all characters on 2 bytes.
42 characters is the worst-case scenario where special characters requiring 3 bytes are used.

In an effort to keep our documentation concise and clear, we chose to stick to the best-case scenario of 63 characters, assuming that would be the most common scenario.
Pull requests have been made in the main codebase to make the error messages clearer upon failed onboarding, which should cover the "42 characters edge cases".

Forward-Port-Of: #16196

@robodoo
Copy link
Collaborator

robodoo commented Jan 30, 2026

Pull request status dashboard

@fw-bot
Copy link
Collaborator Author

fw-bot commented Jan 30, 2026

@viso-odoo @auva-odoo cherrypicking of pull request #16196 failed.

stdout:

Auto-merging content/applications/finance/fiscal_localizations/saudi_arabia.rst
CONFLICT (content): Merge conflict in content/applications/finance/fiscal_localizations/saudi_arabia.rst

Either perform the forward-port manually (and push to this branch, proceeding as usual) or close this PR (maybe?).

In the former case, you may want to edit this PR message as well.

⚠️ after resolving this conflict, you will need to merge it via @robodoo.

More info at https://github.com/odoo/odoo/wiki/Mergebot#forward-port

@viso-odoo viso-odoo force-pushed the 19.0-17.0-enforce-company-name-length-zatca-viso-495257-fw branch 2 times, most recently from 496dc7e to d96092a Compare February 2, 2026 09:07
We have had lots of tickets recently about failed ZATCA onboarding.
One of the most common reasons is that the company or branch name
is too long compared to the strict limits imposed by zatca.

As for the limits, they are technical, imposed by the QR code
generated for every invoice.

The limit itself is 127 bytes, which depending on the exact arabic
characters used can range from 42 to 63 arabic characters.
63 is in the best-case scenario where we can encode all characters
on 2 bytes.
42 characters is the worst-case scenario where special characters
requiring 3 bytes are used.

In an effort to keep our documentation concise and clear, we chose
to stick to the best-case scenario of 63 characters, assuming that
would be the most common scenario.
Pull requests have been made in the main codebase to make the error
messages clearer upon failed onboarding, which should cover the
"42 characters edge cases".

X-original-commit: 44040b9
@viso-odoo viso-odoo force-pushed the 19.0-17.0-enforce-company-name-length-zatca-viso-495257-fw branch from d96092a to 467e1f9 Compare February 2, 2026 09:07
@C3POdoo C3POdoo requested a review from a team February 2, 2026 09:07
@viso-odoo
Copy link
Contributor

@auva-odoo since the doc page changed, i had to adapt a bit the modif. Could you check if it makes sense or not before i merge? :)

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants