Skip to main content

Documentation Index

Fetch the complete documentation index at: https://help.kwentra.com/llms.txt

Use this file to discover all available pages before exploring further.

​
What is ZATCA, and what do they do?

ZATCA, or Zakat, Taxes and Customs Authority, was created in Saudi Arabia by merging the General Authority of Zakat and Tax with the General Customs Authority. It collects Zakat, taxes, and customs duties, aiming for high taxpayer compliance through best practices.
  • Ensure Compliance with KSA Regulations – Integration with ZATCA is mandatory for legal operation in Saudi Arabia.
  • Automated Invoice Submission – All folios, receipts, and manual charges are sent to ZATCA for validation and storage.
  • System-Wide Tax Integration – Tax and discount department mappings ensure the correct classification of transactions.
  • Credit & Debit Notes Processing – Canceled folios generate a credit note; manual charges create a debit note linked to the original invoice.

​
How does kwentra work with ZATCA?

Simply, kwentra integrates directly with ZATCA to generate the QR code directly on kwentra’s final invoices to quickly validate it with the government. Front Office → Settings Gear Sign → Integrations → ZATCA → Integration Setup → Integration Type: Direct Important Note: this integration is only available for hotels in Saudi Arabia, and their Country in Property Settings is Saudi Arabia. Please contact support@kwentra.com to be with you step by step in activating ZATCA for your kwentra system.

​
Step 1: Onboarding the EGS Machine in the Fatoora Portal

Before integrating with Kwentra, businesses must register their EGS (Electronic Generation System) on ZATCA’s portal.

​
1.1 Access the Fatoora Portal

​
1.2 Create an EGS Machine

  • Click “Onboard New Solution Unit/Device.”
  • Enter the required details in the form:
    • Common Name → Device name or tracking number (Free text).
    • EGS Serial Number → Manufacturer, model/version, and serial number (Free text).
    • Organization Identifier → 15-digit VAT registration number.
    • Organization Unit Name → Branch name or 10-digit TIN (for VAT groups).
    • Organization Name → Company name (Free text).
    • Invoice Type (Functionality Map) → Binary format (e.g., 1000 for standard tax invoices).
    • Location → Branch address or website (for e-commerce).
  • Click Submit to register the EGS machine.

​
1.3 Generate OTP for the EGS Machine

  • Select “Generate OTP Codes”.
  • Choose Single or Multiple EGS Units.
  • Click “Generate OTP”.
  • Copy or download the OTP (valid for 1 hour).
  • Enter the OTP in your EGS unit before it expires to authenticate the device.
📌 Note:
  • OTP is valid for a limited time and must be requested when performing authentication with kwentra.

​
Step 2: Configure kwentra/ZATCA Integration Settings

Now that the client has the required credentials, they must configure the ZATCA settings in kwentra.
  • Other Seller ID: Commercial Registration Number if it exists.
  • Street, building number, city, postal code, and district fields are the property’s info, and can be similar to the main property info in settings.
  • Save.
Under the integration type, enter the data obtained after the EGS registration:
  • Common Name → Device name or tracking number (Free text).
  • EGS Serial Number → Manufacturer, model/version, and serial number (Free text).
  • Organization Identifier → 15-digit VAT registration number.
  • Organization Unit Name → Branch name or 10-digit TIN (for VAT groups).
  • Organization Name → Company name (Free text).
  • Invoice Type (Functionality Map) → 1100 fixed for both invoice types.
  • Location → Branch address or website.
  • OTP: provided from the ZATCA portal.
  • Authenticate.

​
Step 3: Configure VAT Tax Departments

Mapping the VAT department code is essential for the integration to run correctly. Front Office → Settings Gear Sign → Integrations → ZATCA → Tax Department Setup
  • All Tax Codes are automatically populated here.
  • Mark on the code for VAT tax.
  • Save.
This guide ensures your hotel is ready for seamless ZATCA integration with minimal downtime.