Simulation API OutOfMemoryError for a Specific Invoice (Payload < 1 MB)

Clearance and Reporting
1

Hello ZATCA Team,

We are encountering an Internal-Error while reporting a specific invoice using ZATCA e-invoicing APIs. This issue is observed in both Simulation and Production environments.

The error being received is as below:
{
“Message”: “System failed to process your request”,
“Code”: “Internal-Error”,
“Reason”: “Handler dispatch failed: java.lang.OutOfMemoryError: Java heap space”
}

Details:
The issue occurs only for a specific invoice.

  1. Other invoices are processed successfully using the same integration and flow.
  2. The failing invoice:

    • Passes schema and local validations.

    • Has a payload size well below 1 MB.

    • Consistently fails with the same error on retries.

  3. The error is a JVM heap space exception, returned directly from the ZATCA backend, with no business or validation error details.

Since the issue occurs in Production, this blocks reporting of a valid invoice and cannot be mitigated via retries. There is no actionable feedback to correct or adjust the invoice from the client side.

Clarification Requested:

  1. Are there invoice-structure-specific constraints (other than payload size) that could trigger this error like Invoice line count, length of individual text fields, tax or allowance/charge structures?
  2. Is this a known issue affecting certain invoice patterns?
  3. Is there any recommended way to pre-validate or detect unsupported invoice structures before submission?
  4. How should such failures be handled from a compliance perspective when they occur in Production?

Any guidance on resolution or escalation would be appreciated, as this directly affects production reporting.

Thank you.

2

Morning @anand.singh

Thanks for reaching out.

To provide comprehensive support as usual, can I kindly ask you to share the following via the email below for our investigation:

  1. When did you start facing this issue?
  2. What is the size of the invoices themselves?
  3. How many invoice lines?
  4. What is the submission time?
  5. Did you face the same on clearance API?

Additionally, kindly share samples of these XMLs along with the API request and response.

SP mail: sp_support@zatca.gov.sa

Please share the email you will use to reach out from here in this post so the team can check your email ASAP.

Thanks,
Ibrahem Daoud.

1 Like
3

Morning @idaoud

Thank you for the response.

We have shared the requested details and sample XMLs with the SP team via email for further investigation.

We have reached out from the following email address: anandmohan@mastersindia.co
The mail header is : Simulation API OutOfMemoryError for a Specific Invoice (Payload < 1 MB)

Please let us know if any additional information is required from our side.

Regards,
Anand

4

@idaoud Following up on the above thread.

We shared all the requested details and sample XMLs with the SP team via sp_support@zatca.gov.sa as advised.
The communication was sent from anandmohan@mastersindia.co with the subject:

“Simulation API OutOfMemoryError for a Specific Invoice (Payload < 1 MB)”

At this point, we have not yet received an acknowledgement or response from the SP team.

Since this issue also impacts Production reporting and blocks submission of a valid invoice, we would appreciate any update on the investigation status or confirmation that the case is being reviewed.

Please let us know if any additional inputs are required from our side.

Thank you for your support.

Regards,
Anand