Skip to main content

Manage country-specific configurations for Saudi Arabia

Zuora

Manage country-specific configurations for Saudi Arabia

  1. Last updated
  2. Save as PDF

If you are a business provider selling products and services in Saudi Arabia, you can configure the E-Invoicing feature to generate e-invoice files for the mandates of invoice clearance.

As a taxpayer, you must have a unique Tax Identification Number (TIN), to be able to issue invoices. For more information on the TIN for Saudi Arabia, see Saudi Arabia TIN.

The Zuora E-Invoicing feature supports the following document types that are currently supported by Saudi Arabia:

  • Electronic invoices
    Electronic invoices (e-invoices) are a form of issuance of sales invoices electronically and are stipulated by the government of Saudi Arabia.
  • Credit notes
    A credit note allows taxable persons to amend previously issued valid invoices by adjusting the amounts payable.
  • Debit notes
    A debit note allows taxable persons to amend previously issued valid invoices by adjusting the amounts against any payment changes.

Configure e-invoicing in Sovos for Saudi Arabia

To configure e-invoicing for invoice clearance for Saudi Arabia, you must require the creation of a company in Sovos. After obtaining authentication keys from Sovos, and retrieving your organization ID from Sovos, you can call a dedicated configuration endpoint to create a company and assign a product.

For more information about how to register your company, see Sovos eInvoice configuration steps.

Manage field mapping for e-invoice file templates

In the e-invoicing clearance process in Saudi Arabia, ensure the field mapping for e-invoice file templates.

Specify Business Number fields on business regions and account e-invoicing profiles

In the e-invoicing clearance process in Saudi Arabia, both the Seller and the Buyer must provide their TIN (Tax Identification Number) numbers.

  • You must specify the TIN number for the Seller in the Business Number field of the business region.
  • You must specify the TIN number for the Buyer in the Business Number field of the account e-invoicing profile.

Specify building numbers on contacts and business regions

In the e-invoicing clearance process in Saudi Arabia, both the Seller and the Buyer must provide their address building numbers.

  • The building number is mandatory for the business region, which holds the business details of the Seller, and mandatory for the bill-to contact, which contains the address of the Buyer.
  • It is best practice to use the address line 2 of the business region and bill-to contact to store the building number. The addressLine2 field is mandatory for the business region, which holds the address building number of the Seller, and for the Bill To Contact, which contains the address building number of the Buyer.
  •  If you store the building number in either a standard field or custom field, you must change the template accordingly.

Create custom fields specific to e-invoicing

You must create and manage custom fields to store country-specific information for mapping to Sovos. The e-invoicing in Saudi Arabia requires an identifier for the referenced document for credit memos and debit memos.

  • For memos generated from subscriptions or invoices, the default referenced document is the associated invoice number.
  • For standalone memos created from product rate plan charges, the default referenced document is the purchase order number on the account.

You can change this mapping if you prefer to use different values.

Retrieve e-invoicing results

You can use the "Retrieve e-invoicing results" operation to retrieve e-invoice results according to the ID of a billing document. The document ID can be the ID of an invoice, a credit memo, or a debit memo.

The e-invoicing result fields might be different by country.

The e-invoicing result fields on EInvoiceData include the following fields for Saudi Arabia:

  • QrCode: This field stores the QR code data that has been Base64 decoded. In Saudi Arabia, this field stores the QR code data that is Base64-encoded Tag, Length, Value (TLV). For more information, see QR Code of Saudi Arabia.
  • ReferenceNumber: This field stores a unique number generated by the tax authority. In Saudi Arabia, it is a unique identifier assigned to each electronically submitted invoice by the Saudi Arabian tax authority, known as the Zakat, Tax, and Customs Authority (ZATCA). The information is obtained from the UUID field in the cleared document.
  • DocumentId: This field stores the ID of the billing document, for which the e-invoice file is generated.
  • DocumentType: This field indicates the type of the billing document, for which the e-invoice file is generated.

The eInvoiceFileId field on the Invoice object stores the ID of the Base64-encoded e-invoice file, a cleared document in the format of UBL- XML.