arus-info/erpnext-australian-localisation

Purpose and platform

This is a Frappe/ERPNext v16 app that adds Australian accounting localisation: GST/BAS reporting, payment batching and ABA bank-file export, AU bank-statement CSV import, and ABN validation. It runs inside the ERPNext server and Desk UI; it is not a standalone service. Core app registration and lifecycle entry points are erpnext_australian_localisation/hooks.py, erpnext_australian_localisation/install.py, and erpnext_australian_localisation/boot.py.

Installation, schema, and ERPNext integration

Installation provisions localisation-specific custom fields, property setters, fixtures, and workspace data; uninstallation reverses app-owned setup. Versioned patches evolve existing ERPNext documents and configuration. This is the principal boundary with ERPNext’s persisted DocType model.

• erpnext_australian_localisation/setup/custom_fields.py

• erpnext_australian_localisation/setup/property_setters.py

• erpnext_australian_localisation/patches.txt

Server-side overrides extend or replace ERPNext behavior for companies, invoices, payment entries, bank import, and master-data validation. Desk-side bundles attach corresponding client behavior to standard forms.

• erpnext_australian_localisation/overrides/invoices.py

• erpnext_australian_localisation/overrides/payment_entry.py

• erpnext_australian_localisation/public/js/australian_localisation.bundle.js

Tax classification and GST determination

AU tax codes and determination records encode GST posting behavior based on customer/supplier classifications and transaction context. These records feed ERPNext invoice and expense/payment workflows rather than owning a separate ledger.

• erpnext_australian_localisation/erpnext_australian_localisation/doctype/au_tax_code/au_tax_code.py

• erpnext_australian_localisation/erpnext_australian_localisation/doctype/au_tax_determination/au_tax_determination.py

• erpnext_australian_localisation/overrides/purchase_invoice.py

BAS configuration and report pipeline

AU Localisation Settings selects reporting frequency and Full versus Simpler BAS mode. Full reporting maps transactional tax outcomes to BAS labels; Simpler reporting maps configured income accounts. Reporting periods and report-entry child records provide the persisted report structure. BAS creation/calculation is a server-side background-capable task boundary over ERPNext accounting data.

• erpnext_australian_localisation/erpnext_australian_localisation/doctype/au_localisation_settings/au_localisation_settings.py

• erpnext_australian_localisation/erpnext_australian_localisation/doctype/au_bas_report/au_bas_report.py

• erpnext_australian_localisation/tasks/bas_report.py

BAS presentation and outputs

BAS labels, entries, and report entries represent calculated values and underlying transactional detail. JSON DocType definitions and Desk JS provide the interactive report workflow; Frappe print formats/templates render printable BAS output.

• erpnext_australian_localisation/erpnext_australian_localisation/doctype/au_bas_label/au_bas_label.json

• erpnext_australian_localisation/erpnext_australian_localisation/print_format/au_full_bas_report_format/au_full_bas_report_format.json

• erpnext_australian_localisation/templates/includes/au_print_format.css

Payment proposal, batches, and ABA export

The Payment Proposal page selects payable supplier/employee documents and creates Payment Batch records. A batch owns invoice/item child rows and produces an Australian Banking Association (ABA) bulk-payment file for upload to a bank; the bank is an offline downstream endpoint, not a direct integration.

• erpnext_australian_localisation/erpnext_australian_localisation/page/payment_proposal/payment_proposal.py

• erpnext_australian_localisation/erpnext_australian_localisation/doctype/payment_batch/payment_batch.py

• erpnext_australian_localisation/erpnext_australian_localisation/doctype/payment_batch/aba_file_generator.py

External validation and bank-statement ingestion

ABN validation is an external Australian Business Register service boundary, using an organisation-provided GUID and applying results to Customer/Supplier data. Bank-statement import adapts bank-specific CSV formats into ERPNext Bank Reconciliation imports; supported format and mapping DocTypes isolate parsing configuration from standard ERPNext import behavior.

• erpnext_australian_localisation/overrides/abn_verification.py

• erpnext_australian_localisation/overrides/bank_statement_import.py

• erpnext_australian_localisation/erpnext_australian_localisation/doctype/au_bank_statement_format/au_bank_statement_format.py