How do I integrate my Hotmart account with Alegra?
If you use Alegra to manage your invoices, you can integrate it with your Hotmart account to automatically send sales made through the platform. This allows your transaction data to be available in Alegra so you can configure and issue invoices according to your country's tax regulations.
In this article, you'll learn how to connect your Hotmart account to Alegra, set up your company, register your products, and prepare the platform to issue invoices.
Note: the Hotmart integration with Alegra is available for accounts configured in Mexico and Colombia. Since Alegra is available only in Spanish and English, the button and menu names used throughout this article follow the platform's original language.
How do I integrate my account with Alegra?
The integration between Hotmart and Alegra takes only a few minutes. Before you begin, we recommend keeping this article open so you can follow each step.
❯ How do I create an Alegra account?
If you don't have an Alegra account yet, go to the sign-up page and create one. If you already have an account, continue to the next section.
|
❯ How do I enter my integration information?
Access the Hotmart–Alegra integration page here.
-
In the User field, enter the email address registered with Alegra.
-
Open the Manual Integration page in Alegra.
(Make sure you're logged into Alegra before opening the link.)
-
In the User Data section, copy your Token.
-
Return to the Hotmart integration page.
-
Paste the token into the Token field.
-
Select the country associated with your Alegra account.
-
Click Integrate.
Once the integration is complete, all new sales made through Hotmart will be automatically sent to your Alegra account.
|
How do I set up my company in Alegra?
After integrating your account, you must complete your company registration in Alegra and enable electronic invoicing with your country's tax authority before issuing invoices.
Alegra provides step-by-step guides for this process.
How do I set up my products in Alegra?
Once your company is authorized to issue invoices, the next step is to configure the products you'll sell through Hotmart.
This process has two stages:
❯ Prepare your tax rates
Alegra already includes some tax rates, but it's important to verify that they match the type of products you sell.
-
Go to Settings > Taxes.
-
Click New Tax.
- Select the tax type.
- Enter the tax percentage.
- Give the tax a name.
-
Click Save.
Your new tax will now be available for your products.
|
❯ Register your products
Alegra offers two ways to register products.
-
Register products manually (recommended)
Manual registration lets you configure all product information
before your first sale. This ensures that invoices are
generated using the correct tax and classification settings.
This procedure is available only for accounts configured in Colombia or Mexico.
-
Go to
Products and services.
-
Click New item (Colombia) or
New Product/Service (Mexico).
-
Click Go to Advanced Form.
-
If your account is configured for Colombia, choose
Product, Service,
or Combo. If your account is configured
for Mexico, disable the Inventory
option.
- Open your Hotmart account in another browser tab.
-
From the left menu, go to
Products > My Products.
- Copy your product name.
-
Return to Alegra and paste it into the Name
field.
- Go back to Hotmart and copy the product ID.
-
In the Reference field, enter the
following format REF-ProductID-HM.
Example: REF-4081003-HM.
For Mexico accounts only
-
In the Product Key field, choose
the category that matches your product.
-
In Measurement Unit, enter the appropriate
unit (in most cases, Service).
-
Enter the Base Price.
-
In Tax, select the tax rate you
created previously.
-
Click Save.
Done! Every sale of this product will now be automatically
associated with the selected tax rate. Repeat this process
for all products you sell through Hotmart.
-
Register products via integration
You can also let Hotmart create your products automatically
through the integration. In this case, the product will
be created in Alegra after the first sale made following
the integration.
Only the product's basic information is sent automatically.
Tax rates, categories, and other settings must be completed
manually.
-
Go to
Products and services.
-
Wait until your first sale after the integration
so the product is created automatically.
-
Click Edit on the desired product.
-
In the Tax field, select the appropriate
tax rate.
-
Click Save.
Done! Future sales of this product will use the configured
tax rate.
|
How do I associate tax rates with previous sales?
If some sales occurred before your tax settings were configured, they may appear without an associated tax.
To update those sales:
- Go to Invoice.
- Open the sale you want to edit.
- In the Tax field, replace None with the correct tax rate.
- Scroll to the bottom of the page.
- Click Save.
Repeat this process for all sales that still don't have a tax rate assigned.
Frequently asked questions
❯ Do I need an Alegra account before integrating with Hotmart?
Yes. To integrate both platforms, you need an active
Alegra account and must use the email address and token
associated with that account during the integration process.
|
❯ Will sales made before the integration be sent to Alegra?
No. Only sales completed after the integration is finished
will be automatically sent to Alegra.
|
❯ Can I issue invoices immediately after completing the integration?
No. Before issuing invoices, you must complete your company
registration in Alegra and enable electronic invoicing
with your country's tax authority. Then, configure your
tax rates and products.
|
❯ Why don't my products appear in Alegra?
If you're using product registration via integration,
the product will only appear in Alegra after the first
sale made following the integration with Hotmart.
If you'd like to configure products before your first
sale, use manual product registration instead.
|
❯ Does the integration automatically configure my product taxes?
No. The integration sends only the basic sales and product
information. Tax rates, tax settings, and fiscal classifications
must be configured manually in Alegra according to your
country's regulations.
If you're unsure how to configure them, consult an accountant
or tax advisor.
|
❯ What should I do if a sale appears without a tax in Alegra?
Go to Invoice, open the corresponding
sale, select the correct tax rate in the Tax
field, and click Save.
|
❯ What should I do if my Alegra token doesn't work?
Make sure you're using the token available under
Manual Integration, that you're entering
the email address associated with your Alegra account,
and that you've selected the correct country.
If the issue persists, generate or copy a new token in
Alegra and repeat the integration process.
|
