Understanding Errors

The following table lists the error codes, descriptions, and causes. Most of these errors are logged in the E-Document Audit Trail on the E-Document subtab of a transaction record.

Error Codes

Description and Cause

error_more_than_one_ksa_cnf_rec

Only one active Saudi Arabia E-Invoicing Configuration record can be present in an account.

error_no_active_configuration

An active Saudi Arabia E-Invoicing Configuration record must be present in an account.

error_ksa_not_configured_in_account

The Saudi Arabia E-Invoicing Configuration does not exist. Create a new record.

error_item_not_supported

Description, Subtotal, Payment, Item Group, and Gift Certificate item types are not supported for e-invoicing transactions.

error_different_parent_taxcode

The tax code of discount or markup items must be the same as the parent item's tax code.

error_no_more_than_two_linecharge

Multiple markups cannot be applied to one item.

error_no_more_than_two_discount

Multiple discounts cannot be applied to one item.

error_ksa_tax_code_not_set

Enter the Saudi Arabia Tax Category on the Tax Code record.

error_tax_cal_in_base_curr

Error in processing Tax Calculation in Base currency. Please contact your administrator or NetSuite support.

error_nonsupported_first_itemtype

A discount or markup item as the first line item is not supported.

error_buyer_name_not_present

Enter the Buyer Name.

error_header_discount_cant_be_positive

The value of the Rate field for the header Discount must be negative.

error_address_not_set_for_invoice

Enter the Billing Address.

error_subsidiaryvat_not_valid

The VAT registration number for this subsidiary is not valid.

error_process_sub_details

Error in processing subsidiary details. Please contact your administrator or NetSuite support.

error_issuername_ksa_cnf_rec

Enter the Issuer Name.

error_serialnumber_ksa_cnf_rec

Enter a Serial Number.

error_certificatestr_ksa_cnf_rec

Enter a Production Binary Security Token and Production Secret.

error_certificateid_ksa_cnf_rec

Enter the Certificate ID.

error_when_subtype_not_selected

Transaction Subtype must be selected.

error_instruction_note_not_present

Enter an Instruction Note.

error_exemption_reason_not_present_for_e

Invoice with Tax Category having tax code "E" should have Tax Exemption Reason.

error_exemption_reason_not_present_for_z

Invoice with Tax Category having tax code "Z" should have Tax Exemption Reason.

error_no_nvat_header_disc

Invoice should not have Tax Category "O" clubbed with any other Tax Category and also have a header discount.

error_no_subsidiary_legal_name

Subsidiary must have a Legal Name.

error_not_valid_sub_build_num

Subsidiary must have a valid Building Number.

error_not_valid_sub_plot_iden

Subsidiary must have a valid Additional Building Number.

error_not_valid_postal

Subsidiary must have a valid Postal Code.

error_not_val_address_fields

Subsidiary must have a valid District, City, and Street Name.

error_not_valid_cus_plot_iden

Customer must have a valid Additional Building Number.

error_not_valid_cust_postal

Customer must have a valid Postal Code.

error_not_val_cust_address

Customer must have a valid District, City, and Street Name.

error_cust_no_country

Customer must have a valid Country Code.

error_certified_e_doc_not_found

Certified e-document not found.

error_recipient_email_not_found

The e-document recipient has no email address. Enter a valid email address on the customer record.

error_sender_email_not_found

The e-document sender {1} has no email address. Enter a valid email address on the employee record.

error_private_key_missing

Please check the private key.

error_process_cnf

Error while processing request.

error_https_internal

ZATCA unable to process request. Please check the input field values.

error_https_unauthorized

ZATCA was unable to process this request due to an unauthorized transaction. Please restart the configuration process by creating a new record.

error_not_val_sub_plot_iden

Enter a valid 4 digit Subsidiary Plot Identification number.

error_not_val_cus_plot_iden

Enter a valid 4 digit Customer Plot Identification Number.

error_not_val_sub_build_num

Enter a valid 4 digit Subsidiary Building Number.

error_not_val_cus_build_num

Enter a valid 4 digit Customer Building Number.

error_signature_ksa_cnf_rec

Enter the ECDSA signature of the Binary Security Token.

error_ecdsapubkey_ksa_cnf_rec

Enter the public key generated from the Binary Security Token.

Related Topics

Setting Up Saudi Arabia E-Invoicing
Working with Outbound e-Documents Using Saudi Arabia E-Invoicing

General Notices