From 9fd0acc40ae437e43821249ec602448aae248616 Mon Sep 17 00:00:00 2001 From: "Victorien (viso)" Date: Fri, 30 Jan 2026 07:51:07 +0000 Subject: [PATCH] [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: 44040b9fd9acd4ba3ca780efea8ead7cc6f2acdb Signed-off-by: Audrey Vandromme (auva) Signed-off-by: Victorien Sonneville (viso) --- .../applications/finance/fiscal_localizations/saudi_arabia.rst | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/content/applications/finance/fiscal_localizations/saudi_arabia.rst b/content/applications/finance/fiscal_localizations/saudi_arabia.rst index ab533cfdee..d6f51a74fc 100644 --- a/content/applications/finance/fiscal_localizations/saudi_arabia.rst +++ b/content/applications/finance/fiscal_localizations/saudi_arabia.rst @@ -176,7 +176,8 @@ Company and contacts To ensure proper integration with :ref:`ZATCA `, the following fields are required on the :ref:`company record `: -- :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`