This article explains the Qoyod warning that requires adding a seller additional ID (BT-29) before saving an Invoice, per the E-Invoicing requirements of the Zakat, Tax and Customs Authority (ZATCA).
What Is BT-29
BT-29 is the “Seller Additional Identifier” field in the e-invoice XML file. It is used to provide an alternative official seller ID other than the tax number (such as commercial registration, national ID, or residency number).
When the Warning Appears
When saving an Invoice while the seller’s additional ID is missing or not entered in the organization settings, Qoyod displays a warning requiring it to be added.
Adding It from Settings
- Open “Settings” then “General Settings”.
- In the tax and administrative identifiers section, enter one of the following identifiers:
- Commercial registration number.
- National ID.
- Residency number.
- The appropriate commercial license.
- Save.
The Warning When Saving the Invoice
If the identifiers are not complete, a warning appears when saving the Invoice showing:
- The reason: BT-29 is missing.
- The required action: add the identifier from General Settings.
You can complete the data and then retry saving.
Notes
- If the organization has a registered tax number, BT-29 is not mandatory in all cases.
- The warning ensures that the resulting XML file complies with the requirements of Phase Two of E-Invoicing.
