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. |