Integrating FreeAgent with Band Pencil

FreeAgent is under testing and development and is only open to certain users.

Band Pencil provides a user-friendly integration with FreeAgent that allows you to send invoices to FreeAgent with a single click. This removes the need for duplicate data entry. You can create and manage your invoice in Band Pencil, then post it directly to FreeAgent when you're ready.

FreeAgent is a flexible accounting platform used widely in the UK. Because of this, we recommend reviewing the invoice in FreeAgent after sending it to ensure everything appears exactly as expected. This connection has been tested for UK companies only.


Contents

  • Connecting & Disconnecting FreeAgent
  • How Band Pencil Creates FreeAgent Invoices
  • Sending an Invoice to FreeAgent
  • Sync Behaviour (Source of Truth)
  • Common Errors When Sending Invoices
  • Things FreeAgent Requires That Band Pencil Cannot Control

1. Connecting and disconnecting FreeAgent

Connecting FreeAgent

To connect Band Pencil to FreeAgent:

  1. Navigate to Settings → External Connections
  2. Click Connect with FreeAgent
  3. You will be redirected to FreeAgent to authorise the connection
  4. Approve access
  5. You will be redirected back to Band Pencil and the connection will be active

FreeAgent uses secure OAuth authentication. This means you may occasionally be asked to re-authenticate the connection.


Disconnecting FreeAgent

To disconnect FreeAgent:

  1. Go to Settings → External Connections
  2. Click Disconnect next to FreeAgent

Disconnecting the integration will not remove invoices that have already been created in FreeAgent.


2. How Band Pencil creates FreeAgent invoices

When an invoice is sent from Band Pencil to FreeAgent, several elements are transferred. These include:

  • General invoice information
  • Line item details
  • Taxes
  • Customer details

General invoice information

When an invoice is sent to FreeAgent we transmit:

  • Invoice issue date
  • Invoice due date*
  • Invoice reference (your Band Pencil invoice ID)**
  • Invoice notes
  • Invoice PO number

*FreeAgent uses payment terms (in days) rather than a due date. To convert our due date into payment terms we calculate the days between issue and due and send this as the payment term. This does mean we will always send at least 1 day due otherwise FreeAgent will reject the invoice.

**FreeAgent automatically assigns its own internal invoice ID when the invoice is created.

 


Line item details

Each line item on your Band Pencil invoice will be added to the FreeAgent invoice.

The integration sends:

  • Description
  • Amount
  • Quantity
  • Tax rate reference

Negative line items (discounts)

FreeAgent treats negitive line items the same as positive items (just like it's shown in Band Pencil). If your invoice contains negative values (e.g. discounts), all negative line items sent to FreeAgent as they show in Band Pencil.


Taxes

FreeAgent uses predefined tax rates (tax codes), while Band Pencil lets you enter tax as a percentage on each line item. Because these systems work differently, Band Pencil maps your percentages to two FreeAgent tax rates:

  • Default Tax Rate
  • No Tax Rate

Default tax rate

The default tax rate will be applied when the tax percentage entered on a line item matches the default tax percentage configured in your Band Pencil tax settings.

For example:

Line Item Tax Your Default Tax Applied FreeAgent Rate
20% 20% Default Tax Rate
0% 20% No Tax Rate
5% 20% No Tax Rate

No Tax Rate

The no-tax rate is applied whenever the tax percentage does not match the default tax percentage. If your business does not charge VAT, simply set both the default tax rate and no tax rate to the same no-tax option in FreeAgent. FreeAgent will ignore any tax information sent from Band Pencil if you do not have tax setup in FreeAgent.

Limitation

FreeAgent supports multiple VAT rates, however the Band Pencil integration currently maps only the default tax percentage and the no tax percentage If your invoice uses multiple VAT rates (for example 5% and 20%), you may need to edit the tax rate manually in QuickBooks after sending the invoice.


Customers

Before an invoice can be created in FreeAgent, a contact must exist. Band Pencil handles this automatically:

  • It checks for an existing contact using the client’s email address
  • If found, that contact is used
  • If not, a new contact is created automatically

We recommend checking the contact assigned to the invoice in FreeAgent to ensure it is correct.


3. Sending an invoice to FreeAgent

Once your FreeAgent account is connected, you can send invoices.

To send an invoice:

  1. Navigate to the Event
  2. Click the Finance tab
  3. Locate the invoice you wish to send
  4. Click Options
  5. Select Send to FreeAgent
  6. Confirm by clicking Send

If successful:

  • The FreeAgent invoice will be created
  • The FreeAgent invoice ID will be stored in Band Pencil
  • A link will appear allowing you to view the invoice in FreeAgent

4. Sync behaviour (source of truth)

Once an invoice has been sent to FreeAgent, FreeAgent becomes the source of truth for that invoice.

This means:

  • Changes made in Band Pencil will not update the invoice in FreeAgent
  • Changes made in FreeAgent will not update the invoice in Band Pencil

The integration is designed to create invoices in FreeAgent only, rather than continuously synchronising changes between both systems.


Payment status

Band Pencil monitors the payment status of invoices created in FreeAgent. When FreeAgent reports that the invoice has been fully paid (i.e. no remaining balance), Band Pencil will automatically mark the invoice as Paid. This allows you to track payment status in Band Pencil while managing payments inside FreeAgent.

This check isn't automatic so it may take a few hours for changes made in FreeAgent to sync with Band Pencil.


5. Common errors when sending invoices

If Band Pencil is unable to send an invoice to FreeAgent, the error returned will be displayed to help you resolve the issue.

  • Don't have an option to 'Send to FreeAgent' on the event page: We might be missing required information. Fix: Check your default and no tax codes have been defined on the connections page.
  • FreeAgent invoices must contain at least one positive line item: FreeAgent requires at least one positive line item. Fix: Ensure your invoice includes at least one charge greater than £0.
  • Invoice total is zero or negative: FreeAgent does not allow invoices with a total of zero or less. Fix: Ensure that discounts do not reduce the total below zero.
  • Contact creation failed: This usually occurs when required client details are missing. Fix: Ensure your client includes: a valid email address and aname (first/last or company name).
  • Tax not being correctly sent: FreeAgent will ignore any tax information sent from Band Pencil if you do not have tax setup in FreeAgent. Please also make sure your default and no tax codes have been correctly defined on your connections page.
  • API / authentication errors: These may occur if the FreeAgent connection has expired. Fix: Reconnect your FreeAgent account via Settings → External Connections.

6. Things FreeAgent requires that Band Pencil cannot control

FreeAgent has its own internal rules and configuration which may affect how invoices are created. Because of this, some behaviour is controlled entirely by FreeAgent.

Tax configuration

Tax rates available in FreeAgent are defined by your FreeAgent account. Band Pencil simply references the tax rates configured in your integration settings.

Invoice numbering

FreeAgent controls how invoice numbers are generated and stored. Band Pencil sends your invoice reference, but FreeAgent may apply its own internal numbering rules.


Ready to start with Band Pencil?

14-day free trial and no card needed to sign up.