[BR-KSA-98] - The simplified invoice should be submitted within 24 hours of issuing the invoice

Clearance and Reporting
1

Dear Support

How i fix this Warning B2C

{"validationResults":{"infoMessages":[{"code":"XSD_ZATCA_VALID","category":"XSD validation","message":"Complied with UBL 2.1 standards in line with ZATCA specifications","status":"PASS"}],"warningMessages":[{"category":"KSA","code":"BR-KSA-98","message":"[BR-KSA-98] - The simplified invoice should be submitted within 24 hours of issuing the invoice."}],"errorMessages":[],"status":"WARNING"},"reportingStatus":"REPORTED"}
3

@aymannagy you are receiving this warning as Simplified Invoices (B2C) must be reported to ZATCA within 24 hours of generation. System calculates the difference between current time and Invoice Issue Date & Time, if this exceeds 24 hours then a warning is issued for non compliance.

4

Hello @Ankit.K.Tiwari , I resubmitted the rejected invoices within 24 hours of their issue generation, but this warning still appeared. Could you please clarify why? Do I need to make any modifications to the invoices before resubmitting them?

Thank you for your support

{
    "validationResults": {
        "infoMessages": [
            {
                "type": "INFO",
                "code": "XSD_ZATCA_VALID",
                "category": "XSD validation",
                "message": "Complied with UBL 2.1 standards in line with ZATCA specifications",
                "status": "PASS"
            }
        ],
        "warningMessages": [
            {
                "type": "WARNING",
                "code": "BR-KSA-98",
                "category": "KSA",
                "message": "[BR-KSA-98] - The simplified invoice should be submitted within 24 hours of issuing the invoice.",
                "status": "WARNING"
            }
        ],
        "errorMessages": [],
        "status": "WARNING"
    },
    "reportingStatus": "REPORTED"
}
5

@CDAdeveloper ZATCA’s System calculates the difference between “current time” (at the time invoice is received by ZATCA via Reporting API) and Invoice Issue Date & Invoice Issue Time mentioned in XML, if the difference exceeds 24 hours then a warning is issued. Since there is no field obligating taxpayers to link the original invoice (rejected invoice) with the one that is re-submitted (after fixing error), system cannot identify which of the invoices are re-submitted in place of original and that original invoices was submitted within 24 hours.

In case ZATCA’s team enquire reasons for the warning BR-KSA-98, you can demonstrate with the logs that original submission was within 24 hours which fulfils the obligation to report B2C invoices within 24 hours.

6

Dear @Ankit.K.Tiwari/ ZATCA Tech team ,

Is the warning code [BR-KSA-98] with the message, “The simplified invoice should be submitted within 24 hours of issuing the invoice,” still active in ZATCA PROD?
Are you still sending this warning message from the ZATCA side in such a above explained cases?

7

Hi @Ankit.K.Tiwari, I have observed that over the last 3–4 days, the B2C Reporting API has been taking significantly longer to respond.

Our API timeout is configured to 15 seconds, but for many invoices the response time exceeds this limit, resulting in request timeouts. Since we process a large volume of invoices, these timeouts lead to a significant number of retries, which in turn causes invoice sync delays. In some cases, invoices are taking more than 24 hours to sync successfully.

Could you please check if there is any ongoing issue or recent change affecting the Reporting API performance? Please help

8

Dear @Ankit.K.Tiwari / ZATCA tech team,
Any update on the request? Thanks!

9

Dear @Ankit.K.Tiwari / ZATCA Tech team,
Any update on our request? Thanks!

10

Dear @Afrah @Aturkistani @Ankit.K.Tiwari @idaoud / ZATCA Tech Team,

Could you please confirm whether the warning code [BR-KSA-98] with the message, “The simplified invoice should be submitted within 24 hours of issuing the invoice,” is still active in the ZATCA Production environment?

if so, Is ZATCA still returning this warning message for cases such as those described above?

Many thanks in advance!

11

From my recent testing, this warning no longer appears in the Production environment. Even when submitting a simplified invoice more than 24 hours after its issue time, the response is PASS with no BR-KSA-98 warning.

12

Thanks @ezadeen for your response.
Yes, we have also observed the same behavior. Even when a simplified invoice is submitted more than 24 hours after its issue time, the response is returned as PASS without any BR-KSA-98 warning

This is the reason I posted my query here, hoping to receive clarification from the ZATCA technical team. Unfortunately, I have not yet received any response or guidance on this matter.

Dear @Afrah @Aturkistani @Ankit.K.Tiwari @idaoud / ZATCA Tech Team,

Could you please provide clarification on how delayed submissions should be identified or distinguished in such cases? Specifically, if no BR-KSA-98 warning is returned, what is the recommended approach to determine whether an invoice should be considered a delayed submission to ZATCA?

Thank you in advance for your support and clarification.