Error: java.lang.NullPointerException in (ZATCA E-Invoice Java SDK 3.4.8)

General
1

hello every one, i have this error after installed (ZATCA E-Invoice Java SDK 3.4.8), how can i solved it, my system is: UBUNTU LINUX 24.04.4

root@vmi2954615:/home/zatca# /home/zatca/fatoora -help
********** Welcome to ZATCA E-Invoice Java SDK 3.4.8 *********************
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/sun.nio.fs.UnixPath.normalizeAndCheck(UnixPath.java:75)
at java.base/sun.nio.fs.UnixPath.(UnixPath.java:69)
at java.base/sun.nio.fs.UnixFileSystem.getPath(UnixFileSystem.java:279)
at java.base/java.nio.file.Path.of(Path.java:147)
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)
2026-03-12 13:53:40,707 [ERROR] ArgumentHandlerService - an error to display thte usage from the file

2

Hi Mohdadawe,

Missing or Corrupted Configuration Files: The SDK depends on specific configuration files (e.g., .properties or .xml files) to define paths to its internal resources. If these files are missing, misplaced, or contain empty or invalid path entries, the SDK will fail to initialize correctly. Please carefully check your /home/ZATCA directory and its subfolders for any configuration files. Open them and verify that all path-related entries are correctly set and point to existing locations. I recommend performing a clean reinstallation of the ZATCA E-Invoice Java SDK. (JAR) Make sure you follow ZATCA’s official installation instructions very carefully,

Please review the attached files

SigningProcessUpdated.pdf (927.7 KB)

E-invoicing-Detailed-Technical-Guideline.pdf (3.8 MB)

1 Like
3

i solved, thank you very much

4

If you require any support, please feel free to reach out.
Email: sp_support@zatca.gov.sa

1 Like