@Ankit.K.Tiwari , @idaoud , @Aturkistani
I have a few clarifications regarding the use of “Organization Unit Name (OU)” and Other Seller ID (CRN) in the context of onboarding clients and submitting invoices to ZATCA. Kindly help me confirm the correct approach in the following scenarios:
1. For a Tax Group client using the same invoicing software across all branches under the same TIN (with active CRNs):
- In this case, should we use the TIN number as the Organization Unit Name (OU) in the onboarding configuration?
- And include the respective branch CRN (of the issuing branch) in the invoice XML under “Other Seller ID”?
2. For a Tax Group client with multiple CRNs, but they are using this invoicing software only in one branch:
- Should the Organization Unit Name (OU) in this case be the TIN number or the name of the branch using the software?
- And in the invoice XML, we are including the CRN of the branch that is issuing the invoice – is that correct?
3. For a client that is not a Tax Group and does not have a TIN, only a single CRN (standalone branch):
- In this case, should we use the Branch Name as the Organization Unit Name (OU) in the config file?
- And continue using the same branch CRN in the invoice XML?
4. For a previously onboarded Tax Group client who is using the software in only one branch (but the OU was set as the TIN):
They received a notification from ZATCA stating:
“It has been noted that your invoices do not comply with the requirements of the second phase of electronic invoicing – linking and integration, which includes:
Commercial Records: When choosing the commercial record identifier and there are multiple commercial records, the supplier must enter the commercial record of the branch from which the tax invoice is issued. Therefore, all branches through which invoices are issued must be registered, and the correct entry of the identifier field for the commercial record must be verified, which is considered a violation of the provisions of the electronic invoicing regulations…”
In this case:
- Do we need to revoke the existing Device and re-onboard it using the Branch Name as the OU?
- Or can we continue using the current setup with OU as TIN without any technical or compliance issues, as they are issuing invoices only from one branch?
Please confirm if the above understanding is correct for these three onboarding scenarios, or let us know the appropriate guidelines as per ZATCA requirements.
1 Like
@Ankit.K.Tiwari , @idaoud , @Aturkistani
Any admins, please reply to this post. It has been a long time since it was posted. This issue needs to be resolved as we are continuously receiving emails from ZATCA. We urgently need assistance from the official admins to address this.
It is very bad support here. Admins are ignoring very important question as their documentation is completely not matching what their SDK is doing. We are building custom integration therefore we are noticing a lot of misalignments.
@idaoud @Ankit.K.Tiwari could you guys please help here?
1 Like
@arjun_tech24 @sergei.shishov it is a Developer Community Forum not an additional channel for tickets to be raised to ZATCA. Let me ask you, how many questions have you @arjun_tech24 and @sergei.shishov answered from other developers on this community forum? Should this be said as bad contribution to the community?
I’m not an expert, but I would like to help as much as I can.
To avoid confusion, always think of the OU field as the TIN (10-digit number) found on your VAT group registration certificate if the company is a member of a VAT group. Each member of the group has its own unique TIN. It’s that simple. No need to overthink it.
If the company is not a member of a VAT group, then the OU is simply a free text. You can enter any value you want, such as Main Office, Al-Manakh Factory, Jeddah Branch, etc. It’s a good idea to keep this value consistent across all your devices/CSIDs, even if it’s not strictly required — just for clarity and easier management.
Sorry @Ankit.K.Tiwari , did not want to offend you. Just sometime noticed that important questions which are bothering people, are not answered at all. At least we can answer, investigating or similar…
And today I am very surprised with the support, everything is fast and as expected.
To answer your question, I have helped maybe a dozen or two people on this forum. Just answering their question, or providing my insights or just debugging with them the issue.
And apologies again, your work is greatly appreciated, Ankit!
@sergei.shishov please do not say sorry, I genuinely intended to clarify the scope of this Forum that it is not an additional channel for ZATCA to receive tickets. It is actually intended for all developers to help each other. @arjun_tech24, with due respect, your questions first needs to be discussed with managers or directors in your organization as Forum cannot be expected to play that role. ZATCA teams will address your queries as none other developers responded, but you are requested to discuss your queries internally within your organization and not pass every day scenarios to Community Forum. Please do not take this forum to be a GPT to be giving you quick output on all your day to day scenarios, you are expected to go through published guidelines.
@sergei.shishov thank you for being a valued member of the community.
@Ankit.K.Tiwari
Sorry if my questions seemed like I was misusing the forum. I understand this is a developer community, not a place to raise tickets to ZATCA.
I did try to follow the guidance that ZATCA teams will respond when other developers don’t, and that we should handle day-to-day queries within our organization. But honestly, we don’t get clear answers from our clients or managers, so sometimes I have no choice but to ask here.
If anyone has any ideas or guidance on such cases, I’d really appreciate it. I’ll also try to be more helpful and contribute to the community more from my side.
I haven’t been able to find a solution yet — please help if you can.
Thanks for understanding.