Integrating to Fatoora

XML and business rules
1

Dear Sir,

please find the attached image this is from our billing Application so i have question how to get this correct details like , Common Name, Organization Unit Name, EGS Serial Number, CRN etc..
please help which is mandetory required field and that details where i can see like VAT Number i Can see from VAT Certificate , CR Number From CR Copy Like that please help me

Common Name
**Organization Unit Name **
**Organization Name **
**EGS Serial Number **
VAT Name
**Business Category **
CRN
Plot Identification
Sub Division Name

image
image1623×671 25.8 KB

2

anyone can reply this .?

my confusion mainly I can see
Common Name

Organization Unit Name

Organization Name

What is this 3 all same or any different how to fix this if ONE CR or Multiple CR cases

**Business Category = where i can see this .??

EGS Serial Number = Keep it same as screenshot or if need to change Where to get this..?
VAT Name = Keep it same as screenshot or where to get it

if anything wrong this form what will happen..?**

3

@Shaaz please refer the Certificate Signing Request (CSR) field contents on page 15 of https://zatca.gov.sa/ar/E-Invoicing/SystemsDevelopers/Documents/20230519_ZATCA_Electronic_Invoice_Security_Features_Implementation_Standards_vF.pdf

4

Dear Sir,

Thank you very much for sharing the onboarding documentation.

I have a few questions related to specific CSR field entries, and I would be grateful for your clarification:

1. Common Name
The document mentions that this should be a unique identifier for the solution or device.
:white_check_mark: Could you please clarify what this exactly means? Is this a name we choose ourselves for our software/device? Should it be unique per integration? Also, does the meaning or usage of this field differ in the case of a single CR versus multiple CRs?

2. Organization Unit Name

  • For VAT groups: Enter the 10-digit TIN of the group member.

  • For regular taxpayers: Enter your branch name.

:white_check_mark: Can you kindly explain what VAT groups are?
:white_check_mark: How can we identify whether a customer falls under a VAT group or is a regular taxpayer?

3. VAT Name
“Enter the VAT name tied to your organization.”
:white_check_mark: Could you please clarify what is meant by “VAT name”? We understand VAT is 15%, but what specific name are we supposed to enter here?

4. Organization Name
“The full name of your company or taxpayer entity.”
:white_check_mark: If we have only one CR, should we simply enter that legal name here?
:white_check_mark: In the case of multiple CRs (e.g., multiple branches being onboarded), do we enter each branch’s CR name separately? Should this value be unique per CR/branch?

5. Business Category
“Specify the sector in which invoices are issued (e.g., Retail, Services).”
:white_check_mark: Where can we find the official list or standard reference for business categories? Is this available in any ZATCA documentation or portal?

6.Final Question:
:white_check_mark: If the customer has only one CR, then will the following fields be the same?

  • Common Name

  • Organization Name

  • Organization Unit Name

Is that correct in such cases?

Your assistance in answering these points will help ensure proper onboarding and configuration of our system.

Thank you for your continued support.

Once I receive clarification on the above points, I will be able to close this support ticket.

5

@Shaaz this is not a channel for creating support tickets. It is a community forum where developers discuss topics of interest and help each other. Your questions such as “what is VAT group”, what is “VAT name” must be discussed internally in your organization. Please do not expect this forum to provide you basic understanding about KSA VAT system.

6

I asked to sharing the documents.

I noticed that he have provided:

  • One Commercial Registration (CR)

  • One National Address

  • A VAT Certificate that includes 6 taxpayer branches, with each branch having its own CR number, name, and city listed.

To proceed correctly with the onboarding process (as per the screenshot shared earlier), I would like to confirm a few points:

  1. CR Number & Name for Each Branch:
    During onboarding, should we use the primary CR number and main CR name, or do we need to register each branch’s CR number along with its branch name?

  2. National Address Registration:
    Since you mentioned there is only one national address, please confirm:

    • Is it sufficient to use this single national address for all branches?

    • Or do we need to register a separate national address for each branch listed in the VAT certificate?

Once I receive clarification on these points, I’ll be able to complete the onboarding accordingly.