Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Binary file added assets/guides/sa-dashboard.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
14 changes: 14 additions & 0 deletions guides/sa-zatca-clearance-reporting.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -62,6 +62,20 @@ The send workflow claims the next ICV, builds and hashes the UBL document, signs

Issued invoices can't be cancelled or edited once cleared or reported. Corrections are made with **credit notes** (reduction) or **debit notes** (increase) that reference the original invoice. A note flows through the same clearance or reporting model as the document it corrects, using the same send workflow.

## Reading the chain

The ZATCA invoices dashboard lists every invoice the workspace has sent to ZATCA, newest first, so you can follow the cleared and reported chain at a glance.

Each row surfaces the chain values ZATCA mandates: the **ICV** and the document **Hash** (each invoice's hash seeds the next invoice's PIH, linking the documents into a tamper-evident chain), alongside the **Silo Entry** that holds the document, the supplier **Tax Code**, the invoice **ID** and its **Previous ID**, and the **Created at** timestamp. In sandbox, an extra **Environment** column separates Simulation from Developer invoices.

<Frame caption="ZATCA invoice dashboard">
<img src="/assets/guides/sa-dashboard.png" width="580" />
</Frame>

<Note>
Rows with an empty **Silo Entry** are the compliance sample invoices Invopop submits during [registration](/guides/sa-zatca-registration) to obtain the Production CSID. They advance the chain but are generated before any real document exists, so no silo entry backs them.
</Note>

## Example invoices

<SaAccordion />
Expand Down