Demfilz ABN Validation For WooCommerce Wordpress Plugin - Rating, Reviews, Demo & Download
Plugin Description
Australian stores that sell to businesses need the buyer’s ABN: for tax invoices, for trade terms, and to know the buyer is a real, active business. A plain text field collects typos, made-up numbers and ABNs that were cancelled years ago. This plugin adds an ABN field that checks what is typed.
It works the minute you activate it. Every ABN carries two check digits, so a mistyped or invented number is caught without asking anyone. Add a free GUID from the Australian Business Register and each ABN is also looked up: you see whether it is active, who it belongs to and whether they are registered for GST.
At the checkout
- An ABN field in the checkout block (under the email address) and in the classic checkout (after Company).
- Optional, required, required only when a company name is given (for stores with both trade and retail customers), or switched off.
- For customers with an Australian billing address only (the default), or for everyone. For other countries the field is hidden and nothing is checked or saved.
- Live feedback under the field while the customer types: “That is not a valid ABN”, or “ACME PTY LTD. Active ABN, registered for GST.”
- The Company field is filled with the business name from the register when it is empty. A name the customer typed is never replaced.
- Returning customers get their saved ABN filled in, and can change it in My Account > Account details.
What you decide
- Look the ABN up and refuse ABNs that are cancelled or not on the register; or look it up, keep the answer and refuse nothing; or check the format only.
- Optionally treat an ABN that is not registered for GST like a cancelled one.
- If the register cannot be reached, the order always goes through and is marked “not checked”. A register outage never costs you a sale.
On the order
- The ABN is stored as 11 digits in the order meta
_billing_abnand the customer metabilling_abn, the names WooCommerce itself uses for a billing field, so stores that already collect an ABN in a field calledbilling_abnkeep their data. - An ABN check panel on the order screen: status, entity name, entity type, GST registration, state and postcode, when it was checked, a Check again button and a link to the public ABN Lookup record.
- The admin New order email says what the register answered.
- Optionally, the ABN is added as the last line of the billing address, which is what order emails and most PDF invoice and packing slip plugins print.
- Find orders by ABN in the order search.
- The ABN is included in WooCommerce’s personal data export and erasure.
Lookup tool
WooCommerce > Settings > ABN Validation > Lookup tool looks up an ABN, an ACN or a business name, for the customer on the phone.
Built to be safe
- Your GUID stays on your server. Customers’ browsers ask your store, and your store asks the register.
- Nothing is sent to the register unless the number passes the check digit test, and each ABN is asked about once per cache period (24 hours by default).
- The public checkout cannot be used to drain your GUID: live lookups are limited per IP address and per hour, and the check made when an order is placed has an allowance of its own, so using up the live lookups does not switch it off.
- The ABN is checked again on your server when the order is placed, whatever the browser sent.
- Works with WooCommerce High-Performance Order Storage (HPOS) and the cart and checkout blocks.
Works with Demfilz Trade Accounts for WooCommerce
If you use Demfilz Trade Accounts for WooCommerce, the trade account screen shows what the register says about the ABN the applicant gave.
Not affiliated with the Australian Government
This plugin is not affiliated with, endorsed by or supported by the Australian Business Register, the Australian Taxation Office or any other government agency. ABN Lookup data is supplied by the register “as is”; check the public record when a decision depends on it.
For developers
Functions: dabn_is_valid_abn(), dabn_format_abn(), dabn_lookup_abn(), dabn_get_order_abn(), dabn_get_order_abn_check(), dabn_get_customer_abn().
Filters: dabn_check, dabn_lookup_result, dabn_block_field, dabn_classic_field, dabn_rate_limit, dabn_rate_limit_site, dabn_rate_limit_orders, dabn_request_args. Action: dabn_order_synced.
Order meta: _billing_abn (11 digits) and _dabn_check (array: abn, result, name, type, code, names, gst, since, state, postcode, acn, checked, note, order). Customer meta: billing_abn. Orders created through the REST API with _billing_abn in their meta are tidied and checked too.
External services
This plugin can connect to ABN Lookup, the public web service of the Australian Business Register (Australian Government), to confirm that an ABN is registered and to read the public details of the business.
- It is used only when you have saved your own ABN Lookup GUID in WooCommerce > Settings > ABN Validation. Without a GUID the plugin contacts nothing.
- A request is made when a customer enters a well-formed ABN at the checkout or in My Account, when an order with an ABN is placed, saved in the admin or created through the REST API, when you click Check again on an order, when you use the lookup tool, and when you open the plugin’s settings page (to show whether your GUID works, by looking up the Australian Taxation Office’s own ABN; the answer is remembered for 12 hours, or 5 minutes after a failure). With Demfilz Trade Accounts for WooCommerce active, opening a trade account whose application gave an ABN looks that ABN up. Answers are cached, so the same ABN is not asked about again within the cache period.
- What is sent: the ABN, ACN or business name being looked up, and your GUID. Nothing else: no customer name, email address, postal address, IP address or order details.
- Requests go from your server to
https://abr.business.gov.au/json/AbnDetails.aspx,https://abr.business.gov.au/json/AcnDetails.aspxandhttps://abr.business.gov.au/json/MatchingNames.aspx.
Service information and registration: ABN Lookup web services. Terms of use: Web services agreement. Privacy: ABN Lookup privacy policies.
Screenshots
The ABN field in the checkout block, verified against the register.
A mistyped ABN is caught straight away.
The ABN check on the order screen.
WooCommerce > Settings > ABN Validation.
The lookup tool: an ABN, an ACN or a business name.
The ABN field in the classic checkout.
