Fatoora zatca sdk error

XML and business rules
1

fatoora -help
********** Welcome to ZATCA E-Invoice Java SDK 4.0.0 *********************
This SDK uses Java to call the SDK (jar) passing it an invoice XML file.
It can take a Standard or Simplified XML, Credit Note, or Debit Note.
It returns if the validation is successful or shows errors where the XML validation fails.
It checks for syntax and content as well.
You can use the command (fatoora -help) for more information.

java.lang.NullPointerException
at java.base/java.util.Objects.requireNonNull(Objects.java:233)
at java.base/sun.nio.fs.UnixFileSystem.getPath(UnixFileSystem.java:296)
at java.base/java.nio.file.Path.of(Path.java:148)
at java.base/java.nio.file.Paths.get(Paths.java:69)
at com.zatca.config.Config.readResourcesPaths(Config.java:32)
at com.zatca.config.ResourcesPaths.getInstance(ResourcesPaths.java:26)
at com.zatca.sdk.service.ArgumentHandlerService.(ArgumentHandlerService.java:27)
at com.zatca.sdk.MainApp.execute(MainApp.java:53)
at com.zatca.sdk.MainApp.main(MainApp.java:119)
2025-01-20 13:19:02,212 [ERROR] ArgumentHandlerService - an error to display thte usage from the file

2

Dear @natali

Thanks for reaching out, Welcome to our community.

To provide comprehensive support as usual, can I kindly ask you to mention the exact steps you followed, additionally what are the JDK version that you are using?

Thanks,
Ibrahem Daoud.

3

thank you for response , I just install JDK and run zatca-einvoice installation file then check if it is work or not using this command “fatoora -help”

java --version
openjdk 21.0.5 2024-10-15 LTS
OpenJDK Runtime Environment Temurin-21.0.5+11 (build 21.0.5+11-LTS)
OpenJDK 64-Bit Server VM Temurin-21.0.5+11 (build 21.0.5+11-LTS, mixed mode, sharing)

4

Morning @natali

Thanks for reaching out,

Please refer to this announcement SDK Upgrade (Beta): Version 4.0.0 Announcement - Announcements - Fatoora Developer Community for upgrading the JAVA version for SDK,

From the provided error it appears that you are missing some configuration in your environment variables as the beta version is working fine, kindly see the attached Beta_version.png

Beta_version
Beta_version1471Ă—770 55.4 KB

For any further support, do not hesitate to reach out to our support team via below mail:

SP mail: sp_support@zatca.gov.sa

Thanks,
Ibrahem Daoud.

5

fatoora -help
********** Welcome to ZATCA E-Invoice Java SDK 3.3.9 *********************
This SDK uses Java to call the SDK (jar) passing it an invoice XML file.
It can take a Standard or Simplified XML, Credit Note, or Debit Note.
It returns if the validation is successful or shows errors where the XML validation fails.
It checks for syntax and content as well.
You can use the command (fatoora -help) for more information.

java.lang.NullPointerException
at java.base/java.util.Objects.requireNonNull(Objects.java:233)
at java.base/sun.nio.fs.UnixFileSystem.getPath(UnixFileSystem.java:296)
at java.base/java.nio.file.Path.of(Path.java:148)
at java.base/java.nio.file.Paths.get(Paths.java:69)
at com.zatca.config.Config.readResourcesPaths(Config.java:28)
at com.zatca.config.ResourcesPaths.getInstance(ResourcesPaths.java:27)
at com.zatca.sdk.service.ArgumentHandlerService.(ArgumentHandlerService.java:25)
at com.zatca.sdk.MainApp.execute(MainApp.java:52)
at com.zatca.sdk.MainApp.main(MainApp.java:121)
2025-01-23 07:01:55,175 [ERROR] ArgumentHandlerService - an error to display thte usage from the file

got same issue when i change the version of production

6

Dear @natali

I hope this finds you well,

Can I kindly ask you to reach out to your RM and share your concerns through the below mail, to schedule a one to one meeting if needed.

SP mail: sp_support@zatca.gov.sa

Thanks,
Ibrahem Daoud.

1 Like
7

@natali can you mention which OS you are using ? if it is Linux/Mac, pls do check the same steps in windows also

8

linux: Ubuntu 18.04.6 LTS ,I did i follow all steps

9

Dear @natali

Did you manage to resolve this issue? I’m facing the same problem on Ubuntu 22.04 with JDK 11. Any tips would be greatly appreciated!

Thanks a lot!

10

Hi everyone,

I just wanted to let you know that I figured the cause of this issue.

It turns out you need to install ZATCA SDK on your Linux development or production machine. The validation functions rely on SDK_CONFIG variable from your bash profile.

To get the ZATCA SDK installed, just follow the instructions in the “Install/Update for Linux” section of the readme file. You can find this file in the readme folder under the ZATCA SDK folder.