Skip to main content

Your first validation

The fastest way to confirm the install is working end-to-end.

Run the CLI​

bin/magento byte8:vat:validate GB123456789

You'll see something like:

Country:   GB
Number:    123456789
Status:    valid
Source:    hmrc
Name:      Acme Ltd
Address:   1 Main St, London, SW1A 1AA, GB
Ref:       CONS-2026-1234

Ref is the value you'd retain for §18 UStG qualified confirmation purposes (or HMRC's "consultation number" — same idea).

Confirm it landed in the log​

If you've left Persist Validations to DB enabled (default Yes):

SELECT entity_id, requested_at, country_code, vat_number, status, source, request_identifier
FROM byte8_vat_validator_log
ORDER BY entity_id DESC LIMIT 5;

Or in admin: Stores → Byte8 → VAT Validation Log.

Now hit the REST endpoint​

curl https://yourshop.test/rest/V1/byte8-vat-validator/validate/GB/123456789 | jq .

Same result, JSON-shaped:

{
  "country_code": "GB",
  "vat_number": "123456789",
  "status": "valid",
  "source": "hmrc",
  "name": "Acme Ltd",
  "address": "1 Main St, London, SW1A 1AA, GB",
  "request_identifier": "CONS-2026-1234"
}

Hit the cache-aware endpoint​

curl https://yourshop.test/rest/V1/byte8-vat-validator/lookup/GB/123456789 | jq .

Same shape, but cache-aware. If the persisted log row is fresh (within the configured Result Cache TTL), /lookup returns it immediately — no upstream call. If stale or missing, it queues an async revalidation and returns status=skipped while the consumer drains. See REST API for when to pick which.

Trigger the checkout observer​

Place an order as a logged-in B2B customer with a valid intra-EU VAT and a different billing country to your store. Watch var/log/vat_validator.log and the validation log table:

  • The sales_quote_address_save_before observer fires on every quote address save. It reads from the result cache and applies the right customer_group_id if a fresh row exists.
  • On a cache miss, the observer publishes to the byte8.vat.revalidate queue and returns immediately. Make sure the consumer is running (bin/magento queue:consumers:start byte8.vat.revalidate) — otherwise the row never gets written and the next checkout still sees a cache miss. See Async queue.