Generate PDF/A-3 Format

This technical process enables businesses to transform standard PDF invoices into ZATCA-compliant PDF/A-3 documents with embedded QR code certification

It's not mandatory to generate a PDF/A-3 format. For storage convenience, you can opt or keep only the XML generated in the last step. However, if you need to embed the system-generated PDF invoice/credit note/debit note with the XML as a PDF/A-3, you may follow these steps.

1. QR Code Placement Preparation

   • Determine the precise X and Y coordinates on the page where you want to insert the QR code

   • Include these coordinates in your JSON payload along with size of QR. sample JSON payload given below

         "Stackcue": {
             "documentType": "StandardInvoice",
             "stackcueComplianceIdentifier": "1a05b34a-096c-4d00-affd-95c56e7ad2db",
             "stackcueProductionIdentifier": "490d97cf-8638-44bd-b1b1-a12337e19f90",
             "qrX": 85,
             "qrY": 120,
             "qrSize": 150,
     
         },

2. JSON Payload Conversion

   • Convert the entire payload to Base64 format

   • Tag the converted payload as "data"

   • Include your PDF file in the JSON payload, tagged as "file"

   Given below a sample postman request with these changes

   
3. Request Submission

   • Submit the request with the prepared payload

That's it! Your PDF will now be converted to PDF/A-3 format with the QR code integrated at the specified location after successful submission to zatca.

Note: The response also delivered through stackcue-Header (see example below).