ClearTax Docs
Subscribe for Updates
  • Introduction to ClearTax APIs
  • โ˜๏ธClear Finance Cloud
    • Introduction to Clear Finance Cloud
    • Learn Clear Finance Cloud Basics
      • API client
      • Access token
      • FTP client
      • How to get Custom Upload Template ID?
    • CFC API Reference
      • Resources and Masters
        • Sale Document Line Object
        • Purchase Document Line Object
      • Generate Access Token API
      • Ingestion API
        • Ingest Documents via File
          • Get Pre-signed URL
          • Upload File to Storage
          • Trigger File Ingestion
          • Get File Ingestion Status
        • (Deprecated) Ingest Documents via JSON
    • Notifications
  • ๐Ÿ‡ฎ๐Ÿ‡ณGLS API
    • GLS API Reference
      • Resources and Masters
      • Advanced Ingestion API Reference
        • Get Pre-signed URL
        • Upload File to Storage
        • Create Ingestion Activity
        • Get Ingestion Activity Status
  • ๐Ÿ‡ฎ๐Ÿ‡ณGST API
    • Introduction to GST API
    • GST 2.0 API Reference
      • Upload Documents
    • GST FTP Magnet
  • ๐Ÿ‡ฎ๐Ÿ‡ณMax ITC API
    • Introduction to Max ITC API
    • Getting Started with Max ITC API
    • Max ITC API Reference
      • Resources and Masters
        • Input and output templates
        • Error Code Master
        • Learn Max ITC API Architecture
      • Max ITC APIs
        • Fetch Max ITC Configuration
        • Upload Purchase Documents
          • Ingest PR via File
          • (Deprecated) Ingest PR via JSON
        • Trigger Max ITC Workflow
        • Get Max ITC Results
        • Postman Collection
    • Max ITC FTP Magnet
  • ๐Ÿ‡ฎ๐Ÿ‡ณTDS API
    • Introduction to TDS API
    • TDS API Reference
      • Resources and Masters
        • Deduction Document Line Objects
        • Output Template(Error)
      • TDS APIs
        • Upload Deductions
          • Ingest Deductions via File
            • Get Pre-signed URL
            • Upload File to Storage
            • Trigger File Ingestion
            • Get File Ingestion Status
          • (Deprecated) Ingest Deductions via JSON
  • ๐Ÿ‡ฎ๐Ÿ‡ณE-Invoicing API
    • Introduction to E-Invoicing API
    • Learn E-Invoicing API Basics
      • How to get E-Invoicing User Auth Token?
      • How to scan the E-Invoice QR code?
      • How to add GSTIN to E-Invoicing?
        • Clear IRP API Credentials
    • Learn E-waybill API Basics
    • E-Invoicing API Reference
      • Setting up your account
      • Clear Schema
        • Generate IRN
        • Cancel IRN
        • Get E-Invoice PDF
        • Get E-Invoice by IRN
        • Generate E-Waybill by IRN
        • Generate E-Waybill for Non-IRN documents
        • Bulk Generate E-Waybill for Non-IRN documents
        • Cancel E-Waybill
        • Get E-Waybill PDF
        • Update E-Waybill Transporter ID
        • Update E-Waybill Part-B
        • Extend E-Waybill Validity
        • Generate/Regenerate Consolidated EWB
        • Get Consolidated EWB PDF
        • Initiate Multi-Vehicle E-Waybills
        • Update EWB Status from NIC
        • Download E-waybills by Others
        • Get E-Waybill Download Status
        • Get E-Waybills
        • Get latest E-Waybill status from Government
        • Generate B2C Payment QR Code
          • Generate B2C Payment QR Code (Lite)
        • Get Signed PDF
        • Sign PDF API Base 64 Encoded
        • Send an E-Invoice via Email
        • Get Invoice Details
      • Government Schema
        • Generate IRN
        • Cancel IRN
        • Get Invoice by IRN
        • Generate E-Waybill by IRN
      • Resources and Masters
        • E-Invoice Object
        • Country Code Master
        • State Code Master
        • Pincode Master
        • Pincode State Mapping Pattern
        • Port Code Master
        • Currency Code Master
        • UQC Master
        • Tax Rates
        • Error Codes
    • E-Invoicing FTP Magnet
  • ๐Ÿ‡ฎ๐Ÿ‡ณInvoicing API
    • Invoicing API Reference
      • Create an Invoice
      • Create Document (Non-Sale)
      • Download PDF of a Document
      • Get Document details
      • Resources and Master
        • Country Master
        • State Master
        • Pincode Master
        • Port Master
        • Currency Master
        • Unit Master
        • Document Types
        • Supply Types
  • ๐Ÿ‡ฒ๐Ÿ‡พE-INVOICING MALAYSIA API
    • E-Invoicing Malaysia API Reference
      • Resources and Masters
        • Error resolution guide
        • Frequently asked questions (FAQs)
        • E-Invoice Object
      • Generate Access Token API
      • Malaysia E-Invoicing APIs
        • Generate E-Invoice for a Document
        • Status Check for Submitted E-Invoice
        • Cancel E-Invoice
        • Upload E-Invoice
        • Get Documents
        • Get E-Invoice PDF
        • Get Document via UUID
        • Delete Invoice
        • Send Bulk Email
        • Search Taxpayer Tin API
  • E-Invoicing FTP Magnet (XML)
  • E-Invoicing FTP Magnet (Excel)
  • ๐Ÿ‡ธ๐Ÿ‡ฆE-Invoicing KSA API
    • Introduction to E-Invoicing KSA API
    • Learn E-Invoicing KSA API Basics
      • How to get E-Invoicing KSA Auth Token?
      • How to add a VAT number to KSA E-Invoicing Account?
      • How to add Branch for existing Vat to KSA E-Invoicing Account ?
      • How to register a device for a VAT?
      • How to generate OTP on ERAD Portal?
      • How to get Print Template ID?
      • KSA E-Invoicing Integration Architecture
    • E-Invoicing KSA API Reference
      • Resources and Masters
        • E-Invoice Object
        • Error Details Object
        • Data Types
        • Code Lists
        • Common Errors and Resolution
      • Authentication
      • Generate Access Token API
      • KSA E-Invoicing APIs
        • Generate E-Invoice
          • Additional Standard (B2B) E-Invoice Examples
          • Additional Simplified (B2C) E-Invoice Examples
        • Generate E-Invoice Async
        • Generate E-Invoice via XML
        • Send Signed E-Invoice XML To ZATCA
        • Get Bulk Invoice Lite
        • Get Invoice
        • Get E-Invoice PDF
        • Get E-Invoice PDF/A-3 with PDF API
        • Register Device
        • Get PCSID Generation Status
        • Renew PCSID
        • Generate E-Invoice (Phase I)
        • Generate QR Code (Phase I)
        • Generate Device ID
        • Generate CSID and PCSID
        • Send E-Invoice via Email
        • Add Business units API
    • E-Invoicing KSA FTP Magnet
    • E-Invoicing KSA XML reporting FTP Magnet
  • ๐ŸงฉAdd-ons and Extensions
    • SAP Add-on
      • SAP Connectivity Checklist
        • Steps to import SSL/TLS certificates in SAP
        • Steps to check ICM settings in SAP
        • Steps to test connectivity in SAP
        • Steps to troubleshoot connectivity issues in SAP
    • Tally Add-on
  • Microsoft Dynamics 365(F&O)
  • General
    • Go-Live Cutover Activity Checklist
    • How to check DNS resolution?
    • How to check hostname reachability?
    • How to check if hostname is trusted?
    • How to get the SSL certificate of a host?
  • โญGST GSP API
    • Introduction to GST GSP API
    • Getting Started with GST GSP API
    • GST GSP API Reference
      • Sample API
    • Migrating from Karvy GST GSP
  • โญE-Waybill GSP API
    • Introduction to E-Waybill GSP API
    • Getting Started with EWB GSP API
      • How to register EWB GSP on NIC?
      • Sandbox GSTIN for EWB GSP
    • E-Waybill GSP API Reference
      • Sample API
    • Migrating from Karvy EWB GSP
  • โญE-Invoicing GSP API
    • Introduction to E-Invoicing GSP API
    • Getting Started with EINV GSP API
      • How to register EINV GSP on IRP?
      • Sandbox GSTIN for EINV GSP
    • E-Invoicing GSP API Reference
      • Sample API
  • Subscribe for Updates
  • ๐Ÿšซ(Deprecated) GST 1.0 API
    • (Deprecated) Introduction to GST API
    • (Deprecated) Learn GST API Basics
    • (Deprecated) Getting Started with GST API
      • (Deprecated) How to set up ClearTax account?
      • (Deprecated) How to authenticate API requests?
      • (Deprecated) How to upload an invoice from File?
      • (Deprecated) How to create custom import template?
    • (Deprecated) GST 1.0 API Reference
      • Taxpayer Information
      • (Deprecated) Invoices
      • (Deprecated) Bills of Supply
      • (Deprecated) Credit Debit Notes (CDN)
      • (Deprecated) Advances
      • (Deprecated) Resources and Masters
        • (Deprecated) How to read GST error response
        • (Deprecated) Unit of Measurement master
        • (Deprecated) State master
        • (Deprecated) Document Classification/Section Name master
      • (Deprecated) Items
      • (Deprecated) Contacts
      • (Deprecated) GST File Upload API Reference
  • ๐ŸšซDeprecated E-Waybill API
    • (Deprecated) Introduction to E-Waybill API
    • (Deprecated) Learn E-Waybill API Basics
    • (Deprecated) Getting Started with E-Waybill API
    • (Deprecated) E-Waybill API Reference
      • (Deprecated) Resources and Masters
        • (Deprecated) Unit Master
        • (Deprecated) State Master
        • (Deprecated) Error Master
      • (Deprecated) E-Waybill JSON API Reference
        • (Deprecated) Generating E-Waybill
        • (Deprecated) Getting E-Waybill
        • (Deprecated) Updating E-Waybill
        • (Deprecated) Extending Validity of E-Waybill
        • (Deprecated) Multi-vehicle E-Waybill
        • (Deprecated) Printing E-Waybill
        • (Deprecated) Cancelling E-Waybill
        • (Deprecated) Generating Consolidated E-Waybill
        • (Deprecated) Getting Consolidated E-Waybill
        • (Deprecated) Regenerating Consolidated E-Waybill
        • (Deprecated) Printing Consolidated E-Waybill
      • (Deprecated) E-Waybill File Upload API Reference
        • (Deprecated) Creating or Updating Documents
        • (Deprecated) Getting Upload Status
        • (Deprecated) Getting Upload Validation
        • (Deprecated) Getting Upload History
        • (Deprecated) Rate Limiting & Best Practices
    • (Deprecated) E-Waybill FTP Magnet
Powered by GitBook
On this page
  • Introduction to E-Invoicing
  • What is E-Invoicing?
  • โ€‹โ€‹โ€‹โ€‹โ€‹โ€‹What is E-Invoicing (FATOORAH)?
  • What is an electronic invoice?
  • Tax Invoice
  • Simplified Tax Invoice
  • How does E-Invoicing (FATOORAH) work?
  • What are the required fields for the e-invoice in phase one (generation phase) and phase two (integration phase)? โ€‹
  • Roll-out phases
  • PHASE 1 (as of December 4th, 2021)
  • PHASE 2 โ€‹ (starting from January 1st, 2023)
  • Guidelines
  • Simplified Guidelines for E-Invoicing
  • Detailed Guidelines for E-Invoicing
  • Detailed Technical Guidelines for E-Invoicing
  • Laws & Regulations
  • โ€‹โ€‹E-Invoicing Bylaw
  • The Controls, Requirements, Technical Specifications, and Procedural Rules for implementing the provisions of the E-Invoicing Regulation (โ€‹โ€‹24 June 2022)
  • Systems Developers
  • QR Code Creation
  • E-Invoice Data Dictionary
  • E-invoice XML Implementation Standardโ€‹
  • Security Features Implementation Standardโ€‹
  • Fatoora Platform

Was this helpful?

  1. E-Invoicing KSA API

Introduction to E-Invoicing KSA API

Introduction to E-Invoicing

Electronic invoicing will be rolled out in two phases in KSA. For the first phase, enforceable as of December 4th, 2021, for all taxpayers (excluding non-resident taxpayers), and any other parties issuing tax invoices on behalf of suppliers subject to VAT, electronic invoice issuance will be very similar to today, with invoices issued through a compliant electronic solution and including additional fields depending on the type of the transaction.

What is E-Invoicing?

โ€‹โ€‹โ€‹โ€‹โ€‹โ€‹What is E-Invoicing (FATOORAH)?

Electronic invoicing is a procedure that aims to convert the issuing of paper invoices and notes into an electronic process that allows the exchange and processing of invoices, credit notes & debit notes in a structured electronic format between buyer and seller through an integrated electronic solution.

What is an electronic invoice?

A tax invoice that is generated in a structured electronic format through electronic means. A paper invoice that is converted into an electronic format through copying, scanning, or any other method is not considered an electronic invoice.

Tax Invoice

An invoice that is usually issued by a Business to another Business (B2B), and contains all tax invoice elements.โ€‹

Simplified Tax Invoice

An invoice that is usually issued by a Business to consumer (B2C) and contains all simplified tax invoice elements.โ€‹

How does E-Invoicing (FATOORAH) work?

E-Invoicing will be rolled out in two phases in KSA.

For the first phase, enforced as of December 4th, 2021, for all taxpayers (excluding non-resident taxpayers), and any other parties issuing tax invoices on behalf of suppliers subject to VAT, electronic invoice issuance will be very similar to invoices generated prior to 4 Dec 2021, with invoices issued through a compliant electronic solution and including additional fields depending on the type of the transaction.

For the second phase, enforceable starting Januaryโ€‹ 1st, 2023 in waves, the electronic solution must be integrated with ZATCA's systems, and e-invoices should be generated in the required format.

What are the required fields for the e-invoice in phase one (generation phase) and phase two (integration phase)? โ€‹

Tax Invoice Sample

Simplified Tax Invoice Sample

Roll-out phases

โ€‹ZATCA has published e-invoicing requirements that will be rolled out into two main phases in KSA:

PHASE 1 (as of December 4th, 2021)

Phase 1, known as the Generation phase, will require taxpayers to generate and store tax invoices and notes through electronic solutions compliant with Phase 1 requirements. Phase 1 is enforceable as of December 4th, 2021, for all taxpayers (excluding non-resident taxpayers), and any other parties issuing tax invoices on behalf of suppliers subject to VAT.

PHASE 2 โ€‹ (starting from January 1st, 2023)

Phase 2, known as the Integration phase and rolled out in waves by the targeted taxpayer group, will involve the introduction of Phase 2 technical and business requirements for electronic invoices and electronic solutions, and the integration of these electronic solutions with ZATCAโ€™s systems.

ZATCA will notify taxpayers of their Phase 2 wave at least six months in advance, and the enforcement date for the first target group will not be earlier than January 1st, 2023.

Guidelines

Simplified Guidelines for E-Invoicing

This guide contains the requirements for all taxpayers subject to the E-Invoicing Regulation to prepare and update their invoicing solutions for phase one (generation phase) and phase two (integration phase).

Detailed Guidelines for E-Invoicing

This guide contains requirements for E-Invoicing (FATOORAH) as well as technical and security requirements for taxpayers and E-Invoicing providers. It also includes detailed technical requirements such as invoice specifications, data dictionary, and security specifications for the E-Invoicing application.โ€‹โ€‹โ€‹โ€‹

Detailed Technical Guidelines for E-Invoicing

This guideline includes the technical requirements for the e-invoicing solutions.

Laws & Regulations

โ€‹โ€‹E-Invoicing Bylaw

The Authority announced that its Board of Directors has approved the e-invoicing regulations, which were published on Friday, December 4th, 2020. The regulation has become effective starting from the date of publication, providing that the implementation in terms of invoices generation will become mandatory for taxpayers by December 4th, 2021.

The Controls, Requirements, Technical Specifications, and Procedural Rules for implementing the provisions of the E-Invoicing Regulation (โ€‹โ€‹24 June 2022)

Zakat, Tax and Customs Authority on Friday, June 24th published the updated controls, requirements, technical specifications, and procedural rules necessary to implement the provisions of the E-Invoicing regulation.โ€‹โ€‹โ€‹

Systems Developers

QR Code Creation

E-Invoice Data Dictionary

This document contains names, definitions, and attributes for data elements.

E-invoice XML Implementation Standardโ€‹

This document contains technical requirements for the syntax and the business content of the electronic invoice that taxpayers need to meet to comply with the โ€œE-invoicingโ€ resolution published by the Authority.

Security Features Implementation Standardโ€‹

This document contains security requirements for electronic invoices that taxpayers need to meet to comply with the โ€œE-invoicingโ€ Resolution.

Fatoora Platform

Fatoora Portal User Manual โ€‹โ€‹โ€‹โ€‹This user manual contains the steps of using the Fatoora portal to onboard and integrate the e-invoicing solutions.

PreviousE-Invoicing FTP Magnet (Excel)NextLearn E-Invoicing KSA API Basics

Last updated 11 months ago

Was this helpful?

๐Ÿ‡ธ๐Ÿ‡ฆ
https://zatca.gov.sa/en/E-Invoicing/Introduction/Pages/Roll-out-phases.aspx
https://zatca.gov.sa/en/E-Invoicing/Introduction/Guidelines/Documents/Simplified%20guide_En.pdf
https://zatca.gov.sa/en/E-Invoicing/Introduction/Guidelines/Documents/E-invoicing_Simplified%20GL.pdf
https://zatca.gov.sa/en/E-Invoicing/Introduction/Guidelines/Documents/E-Invoicing_Detailed__Guideline.pdf
https://zatca.gov.sa/en/E-Invoicing/Introduction/Guidelines/Documents/E-invoicing-Detailed-Technical-Guideline.pdf
https://zatca.gov.sa/en/E-Invoicing/Introduction/LawsAndRegulations/Documents/E-invoicing%20Regulation%20EN.pdf
https://zatca.gov.sa/en/E-Invoicing/Introduction/LawsAndRegulations/Documents/E-Invoicing%20Implementation%20Resolution_EN.pdf
https://zatca.gov.sa/en/E-Invoicing/SystemsDevelopers/Documents/QRCodeCreation.pdf
https://zatca.gov.sa/ar/E-Invoicing/SystemsDevelopers/Documents/20230519_EInvoice_Data_Dictionary%20vF.xlsx
https://zatca.gov.sa/ar/E-Invoicing/SystemsDevelopers/Documents/20230519_ZATCA_Electronic_Invoice_XML_Implementation_Standard_%20vF.pdf
https://zatca.gov.sa/ar/E-Invoicing/SystemsDevelopers/Documents/20230519_ZATCA_Electronic_Invoice_Security_Features_Implementation_Standards_vF.pdf
https://zatca.gov.sa/en/E-Invoicing/Introduction/Guidelines/Documents/Fatoora_Portal_User_Manual_English.pdf
Zatca
Logo