Changelog

We’ve introduced a new invoice status called "UNCOLLECTIBLE" to help you manage invoices deemed uncollectible. You can now set this status via the API. While the invoice will still show as outstanding, you’ll be able to filter these invoices separately for better tracking.

Why this feature matters

For merchants like you, who send your own reminders on outstanding invoices, it's necessary to have a way to mark invoices as uncollectible after multiple collection attempts, including by third-party agencies like Intrum. This status ensures you can stop sending reminders and better manage your tax refunds, as the tax has already been paid but the amount was never collected.

How it works

We’ve added a new argument to the UpdateInvoiceMutation called status. You can now set the status to:

• PAID: If the funds were collected outside of Firmhouse.

• UNCOLLECTIBLE: If the funds were deemed uncollectible.

You can update this status via the API. For now, you’ll mark invoices as uncollectible manually, but we’re considering further automation, such as automatically marking an invoice as uncollectible if a collection case closes unsuccessfully.

Example mutation:

mutation(
  $id: ID!,
  $externalUrl: String,
  $status: InvoiceUpdatableStatusEnum
) {
  updateInvoice(input: {
    id: $id,
    externalUrl: $externalUrl,
    status: $status
  }) {
    invoice {
      id
      externalUrl
    }
    errors {
      message
      attribute
    }
  }
}