Skip to main content

Common errors when working with remittances

Fix the most common issues when generating or uploading a remittance in Holded

Written by Javier Gonzalez

When you create or manage a remittance, errors can appear because of missing data in Holded or bank requirements. Here are the most common ones and how to fix them.


You can't continue when creating the remittance

What happens. In the New remittance wizard, the Continue button is greyed out and you can't move on to the next step.

How to fix it. Holded highlights the fields and invoices with errors and tells you what to check, for example "2 details are missing in the configuration" or "1 invoice has no IBAN". Review the following:

  • Details missing in the configuration: check the concept, the account's IBAN and the creditor identifier (collections) or originator identifier (payments). To avoid typing the creditor identifier in every remittance, save it in the bank account: ⋮ menu › Edit account information, Remittances section.

  • An invoice has no IBAN: click Complete IBAN next to the invoice. The contact record opens. When you come back, you'll be able to include it.

  • Invalid amount: the amount in the To remit column must be greater than 0 and can't exceed the invoice's outstanding amount. If it isn't, you'll see "Amount greater than 0" or "Maximum €X".


An invoice has the Overdue warning

What happens. In the Warnings column, an invoice shows the Overdue warning.

Why it happens. The invoice has a due date that has already passed. The bank can't charge a receipt on a past date and may reject it.

How to fix it. Check the remittance's collection date before saving it:

  • Click Change date on the invoice and enter a later date.

  • Or choose A single date for all in the remittance configuration.

Leave 1 or 2 business days of margin from the day you plan to upload the file to your bank.


You can't download the remittance file

What happens. When you click Download file, Holded shows a list of what is missing, for example "1 invoice from a customer without an IBAN".

Why it happens. Before generating the file, Holded checks that the remittance is still valid. A remittance that was correct when you saved it can stop being valid later. The most common causes are:

  • A contact's IBAN has been deleted, or their IBAN is not valid.

  • A customer's mandate reference is longer than 35 characters. Correct it in the contact record.

  • An invoice in the remittance has been deleted or cancelled.

  • The concept, the account's IBAN or an identifier is missing, or its format is not correct.

How to fix it.

  1. Click Review remittance. The remittance opens with the errors highlighted.

  2. Fix each error or remove the affected invoice.

  3. Click Save.

  4. Download the file again.


Error when uploading the remittance to the bank: BIC too short

What happens. When you upload the remittance file to your online banking, the bank rejects it with a message such as BIC too short, Invalid BIC or an error related to the SWIFT/BIC code. The exact text may vary depending on the bank.

Why it happens. The SWIFT/BIC code must have 11 characters. Some banks don't accept 8-character BIC codes, even though they are valid in other contexts.

How to fix it. Check the BIC/SWIFT field of the bank account and make sure it has 11 characters, including the branch identifier. Then download the file again and upload it to the bank.


You can't change the remittance status

What happens. When you try to mark the remittance as Collected or Paid, or to move it out of that status, Holded shows a message and the remittance doesn't change.

Why it happens. Holded checks your accounting before creating or deleting collections. If something fails, no change is made. It can be due to one of these causes:

Cause

How to fix it

The bank account has no ledger account

Assign it in the bank account settings.

A contact has no ledger sub-account

Holded asks you to confirm. Click Continue to use the general account (430 customers, 400 suppliers) or Review contacts to assign one.

The default customer or supplier account is missing

Set it in the accounting preferences.

The pending account is missing

Only if you use "a single entry per transaction". Set it in the reconciliation preferences.

Account 465 (pending remuneration) is missing

Only in payment remittances with payroll. Create it in your chart of accounts.

A collection falls in a closed period

Reopen the period (for example, a VAT quarter that has already been filed) and try again.

The error message tells you which account is missing and for which contact.

It can also be blocked if an invoice in the remittance belongs to a contact that has been deleted. Check that the contact exists and is active.


Remittance format error: object not found payroll

What happens. Holded shows a format error when generating or managing the remittance. This can happen if the remittance includes purchase invoices and payroll in the same remittance.

How to fix it. Create separate remittances: one for purchase invoices and another for payroll.


You can't edit a remittance

What happens. When you open the remittance, you can't change invoices, amounts or configuration. In the list, View appears instead of Edit.

Why it happens. The remittance is Collected or Paid. In that status it can only be viewed.

How to fix it.

  1. In the list, open the remittance's ⋮ menu, hover over Change status and choose Sent to bank.

  2. Confirm that the collections or payments the remittance registered will be deleted.

  3. Edit the remittance and save the changes.


Invoices appear over-collected

What happens. The invoices in the remittance have the collection registered twice.

Why it happens. There are two common causes:

  • You manually marked the remittance as Collected and also reconciled the bank transaction with the remittance. These are two ways of recording the same collection.

  • The invoice was already collected, fully or partially, when you marked the remittance as Collected.

How to fix it. Change the remittance to Sent to bank to delete the collections it registered. Then record the collection in only one way: reconcile the transaction or manually mark it as Collected, not both.


The bank collects a remittance you deleted

What happens. You deleted a remittance in Holded, but the bank carried out the collections or payments anyway.

Why it happens. Deleting the remittance in Holded doesn't cancel the order your bank already has. If you already uploaded the file, the money will come in anyway and you'll have a deposit that doesn't match anything.

How to fix it. If you already uploaded the file, cancel the order in your online banking first. Then edit or delete the remittance in Holded.


The bank has an old file of the remittance

What happens. You changed invoices or amounts in a remittance that is Sent to bank, but you didn't upload the new file.

Why it happens. The file the bank holds no longer matches the remittance in Holded.

How to fix it. Cancel the order at your bank, download the new file and upload it.


The creditor identifier comes up empty again

What happens. You corrected the creditor identifier in a remittance, but in the next remittance it appears empty or incorrect again.

Why it happens. What you correct in the remittance only applies to that remittance. It isn't saved in the bank account.

How to fix it. Correct it in the bank account: in Treasury › Accounts, open the account, click the ⋮ menu and choose Edit account information. The identifier is in the Remittances section.


Does the error persist?

Contact support and include:

  • The exact error message.

  • The type of remittance (collection or payment) and its status.

  • The bank where you upload the file, if the error comes from the bank.

Did this answer your question?