Key points
- By default, a won deal creates a draft invoice in Holded with the deal's line items, the customer and the numbering series from Settings.
- The Documents settings decide the document type, its status when created, whether it is emailed, its date, due date and notes with properties such as {{dealname}}.
- Rules change values for specific deals, for example pipeline “Online store” → invoice series “TO” and treasury account “Stripe”; for each value, the first matching rule wins.
- The app never picks the first series or account in a list: without one, the document isn't created and the reason is explained.
- Prices come from the deal's line items, which is what the salesperson sold, not from Holded price lists.
What happens when a deal is won
Retyping a won deal into Holded is slow and error-prone: the customer's tax ID, the line items, the discount, the series, the due date. Holded by Vexco does it with the “Won deal → document in Holded” flow, which you turn on in the Flows tab. It fires when the deal reaches the stage you choose in Settings → Documents: specific stages in any pipeline, any won stage or, if you change nothing, “Closed won” in the default pipeline. Then the app:
- Finds the customer in Holded through the existing link, the tax ID or the email, or creates it if your company flow allows it.
- Builds the document with the deal's line items: quantities, prices, discounts and taxes.
- Applies your Documents settings, your Holded defaults and any rule that matches the deal.
- Creates the document in Holded, by default as a draft invoice.
- Shows it on the deal's “Holded” tab and records every step in the activity log.
This flow has no initial load on purpose: loading old won deals would create numbered invoices for sales that were already invoiced. It only acts on deals won after activation.
Documents settings: type, status, date and due date
Settings → Documents controls how every document is created, whether it comes from a won deal, the deal card or a workflow. These are the options that matter most:
| Setting | Options | Tip |
|---|---|---|
| Document type | Invoice, estimate, proforma, sales order, waybill or none | The deal property “Document type to create in Holded” overrides it for a single deal. |
| Bill to | The deal's primary company, the contact, or automatic (the company, or the contact if there's no company) | For when the customer is a person even though the deal has a company. The deal property “Bill to (Holded)” overrides it for a single deal. |
| Status when created | Draft or issued | Start with drafts. An issued invoice gets its final number, goes to Verifactu and can no longer be edited. |
| Send to the customer | Don't send, or email it from Holded | It goes to the customer's billing email in Holded. |
| Document date | Today, or the deal's close date | Close date is useful when deals are marked won a few days late. |
| Due date | The customer's payment terms in Holded, or a fixed number of days | Customer terms keep finance's agreements in one place. |
| Description and notes | Free text with deal properties | For example “Project: {{dealname}}” or a purchase order reference. |
| Document language | The customer's language in Holded, or a fixed one | Useful when you invoice customers in several countries. |
| Lines and taxes | Prices before tax or tax included; tax per line; overall discount; IRPF withholding | Leave IRPF withholding at 0 unless your tax advisor confirms it applies to your invoices. |
| Missing data | What to do if a product doesn't exist in Holded or the deal has no line items | Options include a free-text line, creating the product, or not creating the document and sending an alert. |
Prices always come from the deal's line items. Holded price lists are not used on purpose: the invoice should match what the salesperson sold and the customer accepted.
Holded defaults: numbering series and treasury account
Settings → Holded defaults holds the values used when no rule says otherwise: the numbering series for each document type, the treasury account for payments, the payment method, the sales channel (which is also the income account on each line), the warehouse and the funnel for Holded CRM opportunities. The lists are read from your Holded account; “Refresh from Holded” reloads them after you create a new series.
If you connect several Holded companies, each one has its own defaults. Another company's values are never used. And the app never picks “the first in the list”: if a series or account is missing, the document isn't created and the activity log explains what to fix.
Rules for exceptions: series per pipeline and cash payments
Not every deal should be invoiced the same way. Settings → Rules lets you change values for specific deals. Each rule has a When part, with conditions on the deal, its company or its primary contact combined with ALL, ANY or NOT, and a Then part with the values to change: series, treasury account, issue, send, due date, notes and more.
- Online sales: when the pipeline is “Online store”, use invoice series “TO” and treasury account “Stripe”.
- Cash customers: when the company's payment method is “Cash”, record payments in the “Cash box” account.
- Small amounts: issue straight away when the amount is small, and keep drafts for everything else.
Rules are checked from top to bottom, and for each value the first rule that matches and sets it wins. Before saving, “Test with a deal” shows the resulting values and where each one comes from, without creating anything in Holded.
Manual alternatives: the deal tab, the “Holded action” property and workflows
Automatic creation on won deals suits most teams, but there are three other ways to create documents, all using the same settings and rules:
- The deal's “Holded” tab. The “Holded by Vexco” card has a “Create document” button for any type (estimate, proforma, sales order, waybill or invoice) with advanced options (series, date, due date, payment method, channel, warehouse, language, discount, tags, notes, issue or send on creation). Each document has a menu with View detail, Convert to invoice, Issue, Send by email, Record payment, Delete draft and Refresh.
- The “Holded action” deal property. Set it to create an estimate, proforma, sales order, waybill or invoice, convert the last document to an invoice, issue, send by email or refresh from Holded. You can set it in bulk from a deal list view.
- Workflows. With the Advanced automation module and HubSpot Professional or Enterprise, you can chain actions.
A common pair of workflows for proformas and advance payments:
- First workflow, triggered when the deal enters “Contract signed”: “Create document in Holded” with type proforma.
- Same workflow: “Send Holded document by email” to the customer, with the proforma attached.
- Second workflow, triggered when the deal is won: “Convert Holded document (to invoice or sales order)” to turn the proforma into an invoice.
- Same workflow: “Issue Holded document”, which checks the total before issuing.
The features page lists all 21 workflow actions.
Safety guarantees you can't switch off
Creating invoices automatically only works if finance trusts it. These protections are built in and cannot be disabled:
- The app never touches an issued invoice. Corrections go through a credit note, for example with the “Create credit note in Holded” action.
- It never creates a second invoice for the same deal: if the app already created one, it updates the draft or, once issued, points you to a credit note.
- It never converts the same document twice: if it was already converted into an invoice, it says so.
- “Delete draft” only removes drafts the app created, never an issued document and never an invoice draft that already has a number.
- Before issuing, it checks that the total matches, within the rounding tolerance set in Settings → Advanced.
A recommended setup to start with
Most teams start like this: drafts only, finance reviews each draft in Holded and issues it there, and the issued invoice comes back to HubSpot with its PDF and status. After a few weeks, add a rule to issue automatically for one simple pipeline, and keep drafts for the rest. When invoices start arriving, our guide to syncing Holded invoices and payments with HubSpot shows what sales will see.
The Invoicing bundle includes the invoice-on-won-deal flow; add Advanced automation if you want the workflow actions. Details are on the pricing page, and each setting is shown step by step in how it works. If your process needs more than settings and rules, Vexco's HubSpot implementation team can help configure it.
Holded by Vexco
Install it from the HubSpot Marketplace, connect your Holded company and start in read-only mode. Nothing syncs until you switch it on.
Try it freeFrequently asked questions
Does the app issue the invoice automatically?
No, not by default. A won deal creates a draft invoice in Holded, and it is only issued or emailed if your Documents settings or a rule say so. Finance can review and issue the draft in Holded as usual.
Can I create an estimate or a proforma instead of an invoice?
Yes. In Settings → Documents you choose invoice, estimate, proforma, sales order, waybill or none. The deal property “Document type to create in Holded” overrides that choice for individual deals.
Which prices are used, HubSpot line items or Holded price lists?
HubSpot line items. The document uses the prices, quantities and discounts on the deal, which is what the salesperson sold. Holded price lists are not used on purpose.
What happens if the deal has no line items?
It depends on your settings. You can choose to create one line with the deal amount, or not to create the document and send an alert instead. The activity log records the decision either way.
Can different pipelines use different numbering series?
Yes. Create a rule in Settings → Rules with a condition on the pipeline and the series you want, for example “Online store” → series “TO”. “Test with a deal” shows which series a given deal would get before anything is created.
What if something fails while the invoice is being created?
The app stops and explains the error in the activity log, with a Retry option. If it can't tell whether Holded saved the invoice, it never creates a second one, so you don't end up with duplicate numbered invoices.