BridgeSelect
📒

Xero CSV Export for Traders

Download your retailers' certificates as a Xero bill import file, with your own invoice numbers, account codes and tracking.

← Back to User & Technical Guides

If you use Xero, Bridge Select can build the import file for the certificates you buy from your retailers. Set up once how each certificate should appear in Xero, then download a CSV from the jobs list whenever you need it. Each certificate on a job becomes one line in the file, with the retailer as the contact.

All names, jobs and prices in this guide are demo data.

BEFORE YOU START: Only admins can turn on Xero and change its settings. Once Xero is enabled, everyone in your team can download the file. Bridge Select doesn't send anything to Xero for you: you download the CSV and import it into Xero as bills.

🔌 Turn on Xero

1

Go to Settings > API and Integrations, find the XERO card and click Configure.

XERO card on the API and Integrations page with the Configure button highlighted
2

Switch on Enable XERO, tick the Allowed Tabs you want a Download button on, and click Save. Once saved, the settings for each certificate appear below.

Xero Settings with Enable XERO switched on, Submitted and Waiting for approval ticked, and the Save button highlighted
Allowed TabAdds a Download button toInvoice Date in the file
SubmittedThe Completed tabThe date the job was completed
Waiting for approvalThe Waiting for approval tabThe date the certificate was processed
ApprovedThe Approved tabThe date the certificate was approved

⚙️ Set up your certificates

There is one block for each certificate your account trades. Each block is used by the Download button on that certificate's jobs list. Fill in the ones you use, then click Save at the bottom of the page.

Settings blockUsed when you download from
Solar PV STCsSTCs (Solar PV)
Solar PV VEECsVEECs (Solar PV)
Battery STCsBSTC
PRCS(BESS1), PRCS(BESS3), PRCS(BESS4) and PRCS(BESS5)PRCs (BESS 1, 3, 4, 5). One file, with each certificate using its own block.
PRCS(BESS2)PRCs (BESS2)
Hotwater STCsSTCs (Hot Water)
Hotwater VEECs, ESCs and REPSVEECs, ESCs and REPS (Hot Water)
Aircon VEECs and ESCsVEECs and ESCs (Aircon)
Solar PV STCs settings block with invoice number, description, item code, account code, tracking name and currency filled in

What each field does

FieldWhat it doesIf left blank
Invoice NumberThe bill number in Xero. Xero groups lines with the same number into one bill.Solar PV STCs, Battery STCs and BESS1, 3, 4 and 5: the PO number, or the customer name and address if there is no PO. Hot water STCs: the customer name and address. VEECs, ESCs, REPS and BESS2: for example "VEECs for customer - address".
DescriptionThe line description.The PO number. VEECs, ESCs and REPS use, for example, "VEECs for customer - address".
Inventory Item CodeYour Xero item code for this certificate.STC for Solar PV and hot water STCs, PRC for BESS1, 3, 4 and 5, otherwise empty.
Account CodeThe Xero account the line is coded to.Empty
Tracking Name 1 / Option 1Your first Xero tracking category and option.Option 1 is SPV or Non SPV for Solar PV STCs, and the certificate name (BSTC, BESS1 to BESS5) for battery certificates.
Tracking Name 2 / Option 2Your second tracking category and option.Empty
CurrencyThe currency code, for example AUD.Empty

ESC blocks: if you leave Account Code, a Tracking field or Currency empty in HOTWATER ESCS, ESC lines use the value from HOTWATER VEECS. Empty fields in AIRCON ESCS use AIRCON VEECS. Fill them in to give ESCs their own codes.

Tokens

Invoice Number and Description can include tokens, which are replaced with the job's details when you download. Click a token to add it where your cursor is.

TokenReplaced with
{Customer Name}The customer's first and last name
{Customer Address}The installation address
{Po Number}The job's PO number
{Crmid}The CRM ID on the job
{Retailer Name}The name of the retailer's Bridge Select account
{Current Date}The download date, as YYYYMMDD

⬇️ Download the Xero file

1

Open the jobs list for the certificate, for example STCs (Solar PV), and go to a tab you allowed. Pick the month, then click Download Xero.

Completed tab of the Solar PV STCs jobs list with the Download Xero button highlighted
2

Choose which jobs to include and click Download: Both paid and unpaid, only Paid, or only Unpaid. On the PRCs (BESS 1, 3, 4, 5) list this is checked for each certificate separately.

Confirmation window with Both, Paid Jobs and Unpaid Jobs options and a Download button
3

If a job has moved on since the list loaded (for example it shows in Completed but is now PROCESSED), you're asked whether to include it. On the PRCs (BESS 1, 3, 4, 5) list, the status shows which certificate it is, for example PROCESSED (BESS3). Click Yes to include it or No to leave it out. The pencil opens the job in a new tab.

Please confirm window listing one job with status PROCESSED, with Yes and No buttons

The file downloads as <number> - completed jobs - xero.csv (or processed / approved), ready to import into Xero.

The Bulk Checked Jobs Download page also has Download XERO buttons. They use the same settings and build the file from the completed jobs you've selected there.

📄 What's in the file

The file uses Xero's standard CSV import columns, with one line per certificate. Using the settings above, the demo jobs (with Jordan Demo left out) give:

Contact NameInvoice NumberInvoice DateDue DateDescriptionQtyUnit AmountTracking Option 1
Demo Solar Pty LtdPO-100113-10-202616-10-2026STCs for Sam Sample - 1 Demo Street Sydney NSW 20005238.20SPV
Demo Solar Pty LtdPO-100214-10-202623-10-2026STCs for Alex Example - 2 Demo Street Sydney NSW 20003838.20Non SPV
Sample Energy Pty LtdPO-100415-10-202626-10-2026STCs for Taylor Sample - 4 Demo Street Sydney NSW 20003037.90Non SPV

Every line also gets Item Code STC, Account Code 310, Tracking Name 1 Program and Currency AUD from the settings.

  • Contact Name: the retailer's name from your retailer list, so each retailer gets its own bills.
  • Invoice Date: depends on the tab, as shown in Turn on Xero.
  • Due Date: for STCs, Battery STCs, VEECs, ESCs and REPS, 3 business days after the invoice date for SPV jobs and 7 business days for other jobs. BESS1 to BESS5 are 3 business days.
  • Quantity: the number of certificates, rounded down to a whole number.
  • Unit Amount: the price per certificate on the job.
  • Tax Type: GST on Expenses when the job's owner is a business, otherwise GST Free Expenses.
  • The email and postal address columns are left empty.

Lines that are left out

  • Certificates waiting on a request for information (RFI).
  • Jobs outside the payment status you chose.
  • Jobs you said No to in the confirm window.
  • Jobs that aren't loaded in the tab, for example from another month.

❓ Common questions

I can't see the Download button.
An admin needs to switch on Enable XERO and tick that tab under Allowed Tabs. Try refreshing the page after saving.
Does the search box change what's in the file?
No. The file includes every job loaded in the tab for the month shown, filtered only by the payment status you choose.
Can I get all certificates for a job in one file?
Each jobs list has its own Download button, so download from each list you need. The PRCs (BESS 1, 3, 4, 5) list is the exception: its file has a line for each of BESS1, BESS3, BESS4 and BESS5, each using its own settings block.
My file looks different from this guide.
Some accounts have custom Xero rules set up with Bridge Select, for example fixed invoice numbers or tracking. Contact support if you're not sure which rules apply to you.
Can my team download the file?
Yes. Anyone in your team can download once Xero is enabled. Only admins can change the settings.

For platform support, please contact your Bridge Select representative.

Still need a hand?

If you have any questions, please do not hesitate to reach out to us.

Contact the BridgeSelect Support Team