# Set up XFM
URL: https://support.starshipit.com/articles/1794355200001-set-up-xfm
Canonical: https://support.starshipit.com/articles/1794355200001-set-up-xfm
Markdown: https://support.starshipit.com/articles/1794355200001-set-up-xfm.md
Updated: 2026-11-10

> For the complete documentation index, see [llms.txt](https://support.starshipit.com/llms.txt).

> Connect your XFM account, configure its services, and check rates and shipping documents for Australian domestic freight.

Connect XFM to Starshipit to request account rates and create labels and consignment notes for Australian domestic packages and pallets.

## Before you begin

Have the following ready:

- An active XFM account approved for the services and collection locations you use.
- Your TransVirtual authorization credential, customer name and customer code, supplied for your account.
- The service codes and service names XFM has approved for your account.
- Complete Australian sender and delivery addresses, plus a positive weight and dimensions for every physical package or pallet.

Arrange collections directly with XFM. Creating a label does not request a pickup, and Starshipit does not submit a carrier manifest to XFM.

## Connect XFM

1. In UI 2.0, go to **Settings > Couriers > [Add a new courier](https://next.starshipit.com/settings/couriers/add)** and select **Australia > XFM**.
2. Turn on **Enable XFM**. It is off until you enable it.
3. Enter the **TransVirtual authorization credential** XFM supplied, in the format `AccountNumber|AuthToken`.
4. Enter your **Customer name** and **Customer code** exactly as supplied by XFM.
5. Add your approved services under **Product codes**, using the code and name supplied for each service.
6. Click **Save**, then reopen [XFM settings](https://next.starshipit.com/settings/couriers/setup/xfm) and check the account details and services.

The saved credential is not displayed when you reopen settings. Leave that field blank to keep the existing credential, or enter the replacement supplied by XFM.

## Check rates and your first shipment

Use your next planned shipment or a test shipment explicitly approved by XFM. Creating a label books freight with the carrier.

1. Open the saved order and check the Australian sender and delivery addresses.
2. Add each physical package or pallet with its actual weight and dimensions. Select the same XFM service for every package in the consignment.
3. Review the rate returned for your account, service, addresses and packages. A missing or failed quote is not a free shipping rate.
4. Create the label when you are ready to book the shipment.
5. Check the saved consignment number and open the returned PDF. Confirm it includes the labels and consignment note, and that the addresses and package count match your shipment.

XFM does not support international shipments, returns, dangerous goods, insurance, signature required, authority to leave or Saturday delivery through this integration. Arrange collection requirements with XFM before handing over freight. Cancellation and proof-of-delivery downloads are not available through Starshipit.

## Troubleshooting

### Settings or rates are rejected

Check the account credential, customer details and approved service codes with XFM. Check that both addresses are in Australia and every package has a positive weight and dimensions. Remove unsupported delivery options before requesting a rate or label.

### The booking result is unclear

Check whether the order has a saved XFM consignment number. If it does, reprint to retrieve the existing documents. Reprinting uses that consignment without creating another booking.

If no consignment number is saved or the result is uncertain, confirm the booking with XFM or [Starshipit support](/ticket) before trying again. Repeating a booking can create duplicate freight.

### The PDF is missing or incomplete

Reprint the existing shipment to retrieve its labels and consignment note. If the documents are still unavailable, contact XFM or Starshipit support with the saved consignment number.