currently integrating the ZATCA E-Invoicing Java SDK into our project and encountered an issue while implementing the “invoice hash generation” based on the instructions provided in the SDK README.
According to the README documentation, the process for generating the invoice hash requires declaring objects from the HashGenerationService and SigningService classes and then calling the generateInvoiceHash function with the XML file path as a parameter.
However, when we attempted to implement this in our project, we faced the following issues:
-
We declared the objects as instructed in the documentation (please refer to Screenshot 2 attached).
-
After declaring the objects, we were unable to call any functions from the HashGenerationService object. The IDE does not show any available methods.
-
When we attempted to open the class definition from the IDE (Design Studio / Eclipse), it shows “Source not found” for the SDK JAR file, even though the ZATCA SDK JAR has already been included in the project dependencies.
-
We also noticed that it is technically possible to extend SigningServiceImpl and override the generateInvoiceHash function, as shown in Screenshot 4. However, this approach would require implementing the method ourselves. Our intention is to use the ready-made implementation provided in the SDK, not to override or re-implement the function.
For reference, I have attached the following screenshots:
- Screenshot 1: Section from the README explaining the invoice hash generation process.
-
Screenshot 2: The code where the service objects are declared but no methods are available to call.
-
Screenshot 3: The class editor showing the “Source not found” message for the SDK JAR.
Could you please advise on:
-
The correct way to instantiate and use HashGenerationService to call the generateInvoiceHash method?
-
Whether additional dependencies or source files are required for the SDK?
-
If there is an updated version of the SDK or documentation available?
Your assistance in resolving this issue would be greatly appreciated.
Thank you for your support.

