Error messages for tax / VAT details modal are incorrect for Japan

[haszari]

Describe the bug

The error messages for invalid tax ID mention VAT specifically.

These error messages need to be localised to different countries with different names for "VAT", in particular, Japan. Spun off from:

• Use generic language for VAT/GST in VAT details form to reduce confusion in non-VAT regions (e.g. Japan) #8926

Note that WooPayments service now returns symbolic error codes, allowing the messages to be localised on client:

• https://github.com/Automattic/woocommerce-payments-server/pull/5647

To fix this bug, I suggest we map error code to error message in plugin client. However could also fix by returning different error messages from service.

To Reproduce

1. Onboard / set up a WooPayments account with country JP
2. Set up tax docs so you have a document to view at Payments > Documents. Fake one up with this CLI command:
   • wp wcpay add_document_for_account [account_id] vat_invoice --mode=test --period_from="2024-04-01 00:00:00" --period_to="2024-04-30 23:59:59"
   • Or can use wp wcpay backfill_merchant_vat_invoices
3. If you've added VAT id / tax information previously, clear it out so you can see the modal:
   • Delete company_vat_submitted company_vat_number company_name company_address from wcpay_account_meta table.
   • Side note:
     • https://github.com/Automattic/woocommerce-payments-server/issues/5915
4. Go to Payments > Documents.
5. Click Download for a tax doc row.
6. See modal.
7. Enter a bad corporate number, e.g. abc124, and click Continue

Actual behavior

Error message says bad VAT number.

Expected behavior

Error message should refer to corporate number (as appropriate for country).

While we're here, IMO that error message should be closer to the bad data, i.e. above the Continue button. @rogermattic is that aligned with design principles for error messages/components?

[rogermattic]

Hey @haszari ! Thanks for the ping! Yeah I think the validation message should be right below the input field, so I'd put it above the Continue button.

And of course it should refer to corporate number or whatever that field asks for!