[FIX] saudi_arabia: add warning about company name length

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".

closes odoo/documentation#16218

X-original-commit: 44040b9fd9
Signed-off-by: Audrey Vandromme (auva) <auva@odoo.com>
Signed-off-by: Victorien Sonneville (viso) <viso@odoo.com>
This commit is contained in:
Victorien (viso)
2026-01-30 07:51:07 +00:00
parent 6d096b1de9
commit 9fd0acc40a

View File

@@ -176,7 +176,8 @@ Company and contacts
To ensure proper integration with :ref:`ZATCA <localizations/saudi-arabia/zatca>`, the following
fields are required on the :ref:`company record <general/companies/company>`:
- :guilabel:`Company Name` (must match exactly VAT certificate)
- :guilabel:`Company Name`, limited to a maximum of 63 characters to comply with ZATCA
requirements.
- All relevant :guilabel:`Address` fields, including the :guilabel:`District`, :guilabel:`Building
Number`, and :guilabel:`Plot Identification`
- :guilabel:`Identification Scheme`