Guide · ERP integrations

How to integrate HubSpot with Defontana?

With Defontana's REST API and an app connected to HubSpot: clients and won deals travel from HubSpot to Defontana, and invoices come back to HubSpot with their number and their status with the SII, Chile's tax authority. Defontana always issues the electronic invoice; HubSpot does not create tax documents in Chile. Before coding, define which system owns each piece of data and how you will know, the same day, if the sync stopped.

  • 6 minute read
  • Defontana REST API
  • Electronic invoicing
  • Chile and Latin America
What syncs and in which direction
What syncs and in which direction
DataDirectionIn Defontana
Client: legal name, tax ID and line of businessHubSpot → DefontanaClient record
Products and pricesDefontana → HubSpotProducts and price lists
Won dealHubSpot → DefontanaOrder or sales document
Invoice: number, status and amountDefontana → HubSpotElectronic document issued
Credit notesDefontana → HubSpotAdjustment to the invoiced amount
Every piece of data has a single owning system. Defontana always issues the electronic invoice.

What does the Defontana API allow?

Defontana publishes a REST API with documentation for Chile and a test environment separate from production. It authenticates with the client and company IDs Defontana assigns, plus a user and password, and returns a token. Every new token invalidates the same user's earlier tokens, so all the integration's processes must share one.

It covers what a HubSpot integration needs: clients with tax ID and line of business, products, price lists and stock, quotes, orders and sales documents, including credit and debit notes.

What should sync and in which direction?

Usually HubSpot owns the sales stage and Defontana the accounting one. The client is born in HubSpot and, when the deal is won, it is looked up by tax ID in Defontana and created if it does not exist. Products and prices travel the other way, from Defontana, so HubSpot quotes use the same codes as the invoice.

The won deal triggers the order or the sale in Defontana with data already validated. On the way back, the invoice updates the deal and the company in HubSpot with the number, date, amount and SII status. Write these rules down before coding: that is what prevents duplicates.

What should you watch with electronic invoicing?

Defontana issues it: for electronic documents, the API assigns the invoice number automatically from the company's authorized number ranges and lets you query the document's status with the SII. HubSpot has its own invoices, but they are not electronic tax documents; it only shows what the ERP issued.

Typical errors are data errors: a mistyped tax ID, an empty line of business, an incomplete tax address, products without a code in Defontana or different payment terms. Validate those fields in HubSpot before the deal is won and test first in the test environment, with real documents from your operation in Chile.

How do you know the integration is still working?

Since Defontana does not notify through webhooks, the integration polls periodically and leaves a trail. In HubSpot, the Record Source property shows which records the integration created, and the app keeps a log of its calls. A daily report by source shows whether invoices keep arriving.

Define a silence alert: if no invoice arrives on a business day, someone gets a notice that same morning. And leave an owner with access to the code, the Defontana credentials and the documentation. In companies across Chile and Latin America, an invoice that never reaches the CRM is usually discovered when collections calls the wrong salesperson.

Step by step in HubSpot

How to integrate HubSpot with Defontana step by step

Six steps, from the data agreement to the alert.

  1. 01

    Confirm API access

    Ask Defontana for the API credentials and access to the sales modules you will use, and check that you have the test environment.

  2. 02

    Define which system owns each piece of data

    Client, product, price, deal, invoice and credit note: a table with the owner of each piece of data and when it travels.

  3. 03

    Prepare the properties in HubSpot

    On the company: tax ID, legal name, line of business and tax address. On the deal: payment terms, invoice number, SII status and invoiced amount. Require them in the stage before Closed won.

  4. 04

    Create access with just enough permissions

    HubSpot stops allowing new legacy private apps on October 26, 2026 in existing accounts; the alternative is Service Keys or a projects-based private app.

  5. 05

    Test with real documents

    In Defontana's test environment, with clients, products and terms from your operation: a won deal, an invoice and a credit note. Check every field in both systems.

  6. 06

    Turn on the alert and hand over the documentation

    An alert if no invoices arrive on a business day, a named owner, credentials and code in your company's name, and a document of what syncs, what does not and why.

What it looks like done right

What changes when sales and invoicing talk

  • Nobody types into Defontana a client that was already in HubSpot.
  • The salesperson sees on the deal whether the invoice was issued and its number.
  • The invoice uses the same product codes as the quote.
  • If the sync stops, someone knows that same morning.
A person coordinates a stand at a professional trade fair.
Common mistakes

What we see most often in portals across Chile and Latin America

  • Two processes with the same Defontana user invalidating each other's token.

  • Trying to issue the invoice from HubSpot instead of leaving it in Defontana.

  • Products with different codes in HubSpot and Defontana, which force manual fixes.

  • An integration without an alert: invoices stop arriving and nobody notices.

Want to know if this applies to your case?

30 minutes with Roberto. No demo and no access to your CRM.

Book a 30-minute diagnostic
How we solve it at Revenue Hub Latam

A Defontana integration with code in your name

We integrated HubSpot with Defontana for a trade-show and events company: clients, quotes and electronic invoicing from the won deal. Before committing, we classify each point as confirmed, conditional or unsupported based on your Defontana plan, and we hand over code, credentials and manual in your name, with the silence alert active.

  • HubSpot with Defontana

    Clients, quotes and invoices in sync, with Chilean tax authority safeguards.

    See the integration
  • Integrations with an owner

    ERP, invoicing, WhatsApp and APIs, at a fixed price and with code in your name.

    See Integrations
  • Monitoring in Operate

    The alert is reviewed weekly in Managed HubSpot and daily in Dedicated HubSpot.

    See operations plans

The guarantees that apply

  • Alerts.

    An automatic alert tells you if an integration or form stops bringing in data. You hear it from us first.

  • It’s yours.

    Workflows, integrations, code and keys documented and in your name. If you change partners, you lose nothing.

We put them in writing because they are what we control.

Straight answers

Frequently asked questions

Do I need anything special from Defontana to use the API?

You need to be a Defontana customer with access to the modules the integration uses, such as sales or inventory. That access is arranged with Defontana. Confirm what your plan includes before designing the integration.

Can HubSpot issue the electronic invoice?

HubSpot has its own invoices, but they are not SII electronic tax documents. Defontana issues the invoice with its numbering; HubSpot receives the number, status and amount so sales and collections can see them.

Does Defontana notify HubSpot when an invoice is issued?

Not through webhooks: its API does not document notifications for ERP events. The integration queries documents periodically and updates HubSpot, which is why an alert for days when nothing arrives is worth having.

Can quotes be synchronized?

The API documents quotes and orders, and an order can reference the quote. If you quote in HubSpot, the usual approach is to create the order in Defontana when the deal is won. Confirm what your plan offers.

How long does a Defontana integration take?

3 to 8 weeks depending on the objects synchronized, API access and data quality.

What happens to the integration if I change partners?

If the code, credentials and documentation are in your name, nothing: another team can maintain it. If they live on the provider's servers, ask for them before announcing the change.

Learn more

Roberto Guerra
Who writesRoberto GuerraFounder & Revenue Architect · Revenue Hub Latam

Designs the CRM architecture, integrations and operation of each account. He writes these guides from what he sees every week in HubSpot portals of B2B companies across Chile and Latin America.

Published on October 3, 2026

Meet the team
Roberto Guerra

30 minutes with Roberto.

We review one concrete problem, its impact and your starting point. No demo and no access to your CRM.

How to integrate HubSpot with Defontana | Revenue Hub Latam