Deprecation Notice

Retrieve a draft invoice is now deprecated in favor of Retrieve a customer invoice.

For more details on this initiative, please refer to our documentation.

Breaking changes Notice

The account_id filter on the List transactions endpoint has been renamed into bank_account_id for consistency with the rest of the wording used on the API.

Filter transactions by date

On the List transactions endpoint, it's now possible to filter transactions by date using the date filter.

The structure of a transaction resource has been improved

The data structure of responses related to transactions has been unified and now contains more attributes.

• The List transactions and Retrieve a transaction endpoints are now returning the currency of the transaction and a journal object containing the id of the journal.
• The List matched transactions for a customer invoice and List matched transactions for a supplier invoice are now returning the outstanding_balance, archived_at and fee attributes of a transaction. A journal object containing the id of the journal was added. Abank_accountobject containing theidof the bank account as well as theurlof the API to fetch that bank account was added. Acategories array containing the categories of a transaction was added.

🎉 We are happy to announce that part of the Merge Project, it is now possible to list and upload appendices for credit notes. For more details on this initiative, please refer to our documentation.

List appendices for a customer invoice and Upload an appendix for a customer invoice endpoints previously returned a 404 response when the invoice was a credit note. There are now able to list and create appendices for credit notes, draft invoices and finalized invoices.

Deprecation Notice

The List invoice lines for a credit note and List invoice line sections for a credit note endpoints are now deprecated as part of the Merge Project. For more details on this initiative, please refer to our documentation.

List invoice lines for a customer invoice and List invoice line sections endpoints previously returned a 404 response when the invoice was a credit note. They are now able to request associated resources for credit notes, draft invoices and finalized invoices.

Breaking changes Notice

Mark a customer invoice as paid

Before, when the requested invoice was a draft the response status was 404.

Now, the following response is returned

{
  status: 422,
  error: "This endpoint is not applicable for draft invoices"
}

Before, when the requested invoice was a credit note the response status was 404.

Now, the following response is returned

{
  status: 422,
  error: "This endpoint is not applicable for credit notes"
}

Breaking changes Notice

Few changes on status code rendered due to the Merge Project for Customer Invoices Matched Transactions endpoints. For more details on this initiative, please refer to our documentation.

As a reminder it is not possible to match a transaction to a draft invoice.

List matched transactions for a customer invoice

Before, when the requested invoice was a draft, the response status code was 404.

Now this endpoint returns a 200 with an empty array.

Match a transaction to a customer invoice

Before, when the requested invoice was a draft, the response status code was 404.

Now this endpoint returns a 422 with following error message: "This endpoint is not applicable for draft invoices"

Unmatch a transaction to a customer invoice

Before, when the requested invoice was a draft, the response status code was 404.

Now this endpoint returns a 422 with following error message: "This endpoint is not applicable for draft invoices"

Breaking changes Notice

List payments for a customer invoice

Before, when the requested invoice was a draft or credit note, the response status was 404.

Now this endpoint returns a 200 with an empty array.

Deprecation Notice

Turn the draft invoice into a finalized invoice is now deprecated in favor of the new endpoint on the customer invoices resource.

For more details on this initiative, please refer to our documentation.

Deprecation Notice

The Update a draft invoice and Update a finalized invoice endpoints are now deprecated as part of the Merge Project. For more details on this initiative, please refer to our documentation.

New update endpoint

The 2 deprecated endpoints mentioned above will be replaced by a single update endpoint that works for both draft and finalized customer invoices.

The Retrieve a customer invoice endpoint is now able to retrieve both draft and finalized customer invoices.