Using generic tax labels (VAT/GST) in custom templates

Starting from Cakedesk version 1.25.0, Cakedesk now supports both VAT (Value Added Tax) and GST (Goods and Services Tax) terminology depending on the country of your business.

Countries that use GST terminology include Australia, New Zealand, Singapore, India, and Canada. All other countries default to VAT terminology.

If your custom template currently uses hard-coded references like t('vatID') or t('vat'), it will always display "VAT ID" and "VAT" regardless of your business location. For businesses in GST countries, this won't be accurate.

By using the new helper functions, your templates will automatically display the correct terminology based on the country.

#New helper function: 'getTaxIdLabel(party)'

The getTaxIdLabel() function returns the appropriate tax ID label based on the country of the passed party. For example "VAT ID" for Germany or "ABN" for Australia.

// ❌ Before: hard-coded VAT ID label
<%= t('vatID') %>: <%= invoice.buyer.vatId %>

// ✅ After: using getTaxIdLabel
<%= getTaxIdLabel(invoice.buyer) %>: <%= invoice.buyer.vatId %>

#New helper function: 'getTaxLabel()'

The getTaxLabel() function returns the label ('VAT' or 'GST') based on the country of the passed party.

// ❌ Before: hard-coded VAT label
<%= t('vat') %> (<%= taxSubtotal.vatPercentage %>%)

// ✅ After: using getTaxLabel
<%= getTaxLabel() %> (<%= taxSubtotal.vatPercentage %>%)

#Summary

To update your custom templates for GST support:

1. Replace t('vatID') with getTaxIdLabel(party) where party is the buyer or seller
2. Replace t('vat') with getTaxLabel(party) conditional rendering if required

For more details about these helper functions, see the helper functions documentation.