# Documentation

**URL:** https://zatca1.discourse.group/c/documentation/14.md

[Latest](https://zatca1.discourse.group/latest.md) · [Categories](https://zatca1.discourse.group/categories.md)

---

## [About the Documentation category](https://zatca1.discourse.group/t/about-the-documentation-category/182)

<div class="topic-metadata">

**Author:** [@Ehab](https://zatca1.discourse.group/u/Ehab)\
**Replies:** 0

</div>

Create topics here that don’t fit into any other existing category.

---

## [Signing Process](https://zatca1.discourse.group/t/signing-process/354)

<div class="topic-metadata">

**Author:** [@Ehab](https://zatca1.discourse.group/u/Ehab)\
**Replies:** 0\
**Last updated:** [July 19, 2023, 11:11pm UTC](https://zatca1.discourse.group/t/signing-process/354 "2023-07-19T23:11:03Z")

</div>

In this section, step-by-step instructions will be demonstrated towards acquiring a Signed Invoice. SHA-256 Hash - Hashing algorithm The main reason for using SHA-256 is to strengthen the security and protect the data …

---

## [Legal Requirements](https://zatca1.discourse.group/t/legal-requirements/490)

<div class="topic-metadata">

**Author:** [@Ehab](https://zatca1.discourse.group/u/Ehab)\
**Replies:** 0\
**Last updated:** [August 13, 2023, 12:07am UTC](https://zatca1.discourse.group/t/legal-requirements/490 "2023-08-13T00:07:24Z")

</div>

The integration preparation should adhere to the following binding requirement Integration Requirement Purpose …

---

## [Charges and Advanced payments](https://zatca1.discourse.group/t/charges-and-advanced-payments/489)

<div class="topic-metadata">

**Author:** [@Ehab](https://zatca1.discourse.group/u/Ehab)\
**Replies:** 0\
**Last updated:** [August 12, 2023, 11:53pm UTC](https://zatca1.discourse.group/t/charges-and-advanced-payments/489 "2023-08-12T23:53:21Z")

</div>

Charges are any additional costs or fees that are not included in the unit price of the goods or services being invoiced, such as shipping costs, handling fees, taxes, and other applicable charges An advance payment …

---

## [Taxpayer Journey](https://zatca1.discourse.group/t/taxpayer-journey/488)

<div class="topic-metadata">

**Author:** [@Ehab](https://zatca1.discourse.group/u/Ehab)\
**Replies:** 0\
**Last updated:** [August 12, 2023, 11:38pm UTC](https://zatca1.discourse.group/t/taxpayer-journey/488 "2023-08-12T23:38:12Z")

</div>

1.2.a Onboarding & Invoice Sharing For Onboarding & Invoice Sharing, the following capabilities are offered in the core e-invoicing solution: Onboarding i. Generate CSR & private key ii. Generate OTP iii. Generate …

---

## [E-Invoicing API endpoints](https://zatca1.discourse.group/t/e-invoicing-api-endpoints/487)

<div class="topic-metadata">

**Author:** [@Ehab](https://zatca1.discourse.group/u/Ehab)\
**Replies:** 0\
**Last updated:** [August 12, 2023, 11:34pm UTC](https://zatca1.discourse.group/t/e-invoicing-api-endpoints/487 "2023-08-12T23:34:13Z")

</div>

A. FATOORA portal (production) ● Onboarding APIs: https://gw-fatoora.zatca.gov.sa/e-invoicing/core/compliance (Request a pre-compliance CSID) https://gw-fatoora.zatca.gov.sa/e-invoicing/core/compliance/invoices (Run c…

---

## [FATOORA simulation portal](https://zatca1.discourse.group/t/fatoora-simulation-portal/486)

<div class="topic-metadata">

**Author:** [@Ehab](https://zatca1.discourse.group/u/Ehab)\
**Replies:** 0\
**Last updated:** [August 12, 2023, 11:33pm UTC](https://zatca1.discourse.group/t/fatoora-simulation-portal/486 "2023-08-12T23:33:11Z")

</div>

FATOORA Simulation portal is an additional optional tool for end-to-end functional testing for taxpayers. It is not intended for load testing. A. Taxpayer accessing and logging into the FATOORA simulation portal The us…

---

## [The FATOORA portal](https://zatca1.discourse.group/t/the-fatoora-portal/485)

<div class="topic-metadata">

**Author:** [@Ehab](https://zatca1.discourse.group/u/Ehab)\
**Replies:** 0\
**Last updated:** [August 12, 2023, 11:24pm UTC](https://zatca1.discourse.group/t/the-fatoora-portal/485 "2023-08-12T23:24:37Z")

</div>

This portal aims to onboard the user’s EGS Unit through generating cryptographic stamp identifier or renewing the existing one or revoking it. In addition, the user can view the list of onboarded solutions and devices. A…

---

## [Developer Portal](https://zatca1.discourse.group/t/developer-portal/484)

<div class="topic-metadata">

**Author:** [@Ehab](https://zatca1.discourse.group/u/Ehab)\
**Replies:** 0\
**Last updated:** [August 12, 2023, 11:10pm UTC](https://zatca1.discourse.group/t/developer-portal/484 "2023-08-12T23:10:07Z")

</div>

The Developer Portal includes range of tools that can be used for the development of compliant e-invoicing solutions i. SDK ii. Web Based Validator for XML files iii. API integration Sandbox 1.1.a Confirming complian…

---

## [Structure of the QR code For Electronic Tax Invoices](https://zatca1.discourse.group/t/structure-of-the-qr-code-for-electronic-tax-invoices/483)

<div class="topic-metadata">

**Author:** [@Ehab](https://zatca1.discourse.group/u/Ehab)\
**Replies:** 0\
**Last updated:** [August 12, 2023, 11:01pm UTC](https://zatca1.discourse.group/t/structure-of-the-qr-code-for-electronic-tax-invoices/483 "2023-08-12T23:01:14Z")

</div>

Structure of the QR code For Electronic Tax Invoices It is mandatory to generate and print QR code encoded in Base64 format with up to 700 characters that must contain the fields specified in the below table as per Anne…

---

## [Reporting and Clearance of e-invoices](https://zatca1.discourse.group/t/reporting-and-clearance-of-e-invoices/482)

<div class="topic-metadata">

**Author:** [@Ehab](https://zatca1.discourse.group/u/Ehab)\
**Replies:** 0\
**Last updated:** [August 12, 2023, 10:37pm UTC](https://zatca1.discourse.group/t/reporting-and-clearance-of-e-invoices/482 "2023-08-12T22:37:04Z")

</div>

4.1. Introduction and Objectives of Reporting and Clearance The primary objective of the Reporting and Clearance functionalities is to allow all Taxpayers subject to e-invoicing in the Kingdom to submit their e-invoices…

---

## [Revocation of an existing CSID](https://zatca1.discourse.group/t/revocation-of-an-existing-csid/481)

<div class="topic-metadata">

**Author:** [@Ehab](https://zatca1.discourse.group/u/Ehab)\
**Replies:** 0\
**Last updated:** [August 12, 2023, 10:32pm UTC](https://zatca1.discourse.group/t/revocation-of-an-existing-csid/481 "2023-08-12T22:32:06Z")

</div>

Revocation of an existing CSID 3.1.1. Manual revocation of an existing CSID by the Taxpayer 3.1.1.1. Description Taxpayers may wish to revoke their existing CSID(s) for a number of reasons, including: ● If the Taxpay…

---

## [Onboarding and Renewal](https://zatca1.discourse.group/t/onboarding-and-renewal/480)

<div class="topic-metadata">

**Author:** [@Ehab](https://zatca1.discourse.group/u/Ehab)\
**Replies:** 0\
**Last updated:** [August 12, 2023, 10:19pm UTC](https://zatca1.discourse.group/t/onboarding-and-renewal/480 "2023-08-12T22:19:05Z")

</div>

Onboarding IMPORTANT: The Onboarding section acts as a guide for Taxpayers to help users operate the On- boarding ZATCA Portal in order to obtain the necessary Cryptographic Stamp Identifiers (CSID) and perform any oth…

---

## [Technical workshops](https://zatca1.discourse.group/t/technical-workshops/341)

<div class="topic-metadata">

**Author:** [@Ehab](https://zatca1.discourse.group/u/Ehab)\
**Replies:** 0\
**Last updated:** [July 18, 2023, 9:48pm UTC](https://zatca1.discourse.group/t/technical-workshops/341 "2023-07-18T21:48:05Z")

</div>

(Part 1 out of 4) - Technical Requirements (Part 2 out of 4) - Compliance and Enablement Toolbox and SDK (Part 3 out of 4) - API Integration Sandbox (Part 4 out of 4) - FATOORA Portal Other Workshops #E\_Invoicing P…

---

## [Taxpayer E-invoicing Journey](https://zatca1.discourse.group/t/taxpayer-e-invoicing-journey/190)

<div class="topic-metadata">

**Author:** [@Ehab](https://zatca1.discourse.group/u/Ehab)\
**Replies:** 0\
**Last updated:** [June 5, 2023, 12:46am UTC](https://zatca1.discourse.group/t/taxpayer-e-invoicing-journey/190 "2023-06-05T00:46:08Z")

</div>

The Taxpayer E-invoicing User Journey represents the key steps that Taxpayers can take in order to be able to fulfil their obligations for the Integration Phase of E-invoicing. It should be noted that some of these steps…

---

## [What is Reporting](https://zatca1.discourse.group/t/what-is-reporting/323)

<div class="topic-metadata">

**Author:** [@Ehab](https://zatca1.discourse.group/u/Ehab)\
**Replies:** 0\
**Last updated:** [July 16, 2023, 10:13pm UTC](https://zatca1.discourse.group/t/what-is-reporting/323 "2023-07-16T22:13:09Z")

</div>

Reporting: Taxable persons must report the Simplified Tax Invoices to the Authority. Reporting is a near-real time transaction model, where Simplified Tax Invoices and their associated Credit/Debit notes are uploaded to…

---

## [What is clearance](https://zatca1.discourse.group/t/what-is-clearance/322)

<div class="topic-metadata">

**Author:** [@Ehab](https://zatca1.discourse.group/u/Ehab)\
**Replies:** 0\
**Last updated:** [July 16, 2023, 10:11pm UTC](https://zatca1.discourse.group/t/what-is-clearance/322 "2023-07-16T22:11:05Z")

</div>

Clearance: Each Tax Invoice generated electronically must be cleared by the Authority as a prerequisite for sharing them with the buyers and for such Electronic Invoice to be regarded as legal and valid. Clearance is a …
