FREE

Buyer VAT number

Collect the buyer's VAT number at checkout or on the order screen, so business buyers get a ZATCA Tax Invoice.

When a buyer gives a VAT number, their invoice becomes a Tax Invoice (Standard, B2B) instead of a Simplified Tax Invoice (B2C). Vite Invoice adds the field for you as soon as ZATCA is switched on.

At checkout

While ZATCA Phase 1 is on, checkout shows a VAT number (optional) field. It works with both the classic checkout and the block checkout.

  • Leave it empty: the order gets a Simplified Tax Invoice.
  • Enter a valid VAT number: the order gets a Tax Invoice, and the buyer's VAT number is printed on it.

A VAT number must be 15 digits, starting and ending with 3. If the buyer enters something else, checkout shows "VAT number must be 15 digits, starting and ending with 3." For testing, use 399999999900003.

On the order screen

You can add or fix the VAT number yourself, for example for a phone order.

  1. Open the order in WooCommerce → Orders.
  2. Find the Buyer VAT number box on the right.
  3. Enter the number in VAT number (optional) and update the order.
  4. Generate the invoice.

Do this before the invoice is made. Once an invoice is issued, it keeps its type (Simplified or Tax Invoice) and its QR code. Changing the VAT number only affects documents issued afterwards. To correct an issued invoice, issue a credit note.

Tip: If business buyers often order by phone, choose a trigger status that gives you time to add the VAT number first, or turn off automatic creation and use Generate. See Invoices.

Extra address fields for Phase 2

ZATCA needs a full Saudi address on a Standard invoice. While Phase 1 and Phase 2 are both on, the billing address gets two more fields:

  • Building number: 4 digits.
  • District.

For a buyer in Saudi Arabia who enters a VAT number, checkout then requires:

  • a Building number of 4 digits ("Building number is required for a business invoice: enter 4 digits."),
  • a District ("District is required for a business invoice."),
  • a Postal code of 5 digits ("Postal code must be 5 digits for a business invoice.").

The same Building number and District fields appear in the billing address on the order screen, so you can fill them in for a phone order.

A store with only Phase 1 on sees no extra address fields.

What happens next

  • Phase 1: the Tax Invoice is issued at once, like any other invoice.
  • Phase 2: the Tax Invoice is sent to ZATCA for clearance and held from the buyer until it is cleared. See ZATCA Phase 2.

Note: Your ZATCA certificate must cover Standard invoices. If you onboarded with invoice type 0100 (B2C only), an order with a buyer VAT number is refused until you re-onboard with 1100 or 1000.

Need Help? Chat With Us