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.

1. In the User field, enter the email address registered with Alegra.
2. Open the Manual Integration page in Alegra.
   (Make sure you're logged into Alegra before opening the link.)
3. In the User Data section, copy your Token.
4. Return to the Hotmart integration page.
5. Paste the token into the Token field.
6. Select the country associated with your Alegra account.

7. 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.

• Access the Alegra guide for Colombia.
• Access the Alegra guide for Mexico.
   

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.

1. Go to Settings > Taxes.
2. Click New Tax.
3. Select the tax type.
4. Enter the tax percentage.
5. Give the tax a name.

6. 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.

1. Go to Products and services.
2. Click New item (Colombia) or New Product/Service (Mexico).
3. Click Go to Advanced Form.
4. If your account is configured for Colombia, choose Product, Service, or Combo. If your account is configured for Mexico, disable the Inventory option.
5. Open your Hotmart account in another browser tab.
6. From the left menu, go to Products > My Products.
7. Copy your product name.
8. Return to Alegra and paste it into the Name field.
9. Go back to Hotmart and copy the product ID.
10. In the Reference field, enter the following format REF-ProductID-HM. Example: REF-4081003-HM.

For Mexico accounts only

11. In the Product Key field, choose the category that matches your product.

12. In Measurement Unit, enter the appropriate unit (in most cases, Service).
13. Enter the Base Price.
14. In Tax, select the tax rate you created previously.
15. 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.

1. Go to Products and services.
2. Wait until your first sale after the integration so the product is created automatically.
3. Click Edit on the desired product.
4. In the Tax field, select the appropriate tax rate.
5. 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:

1. Go to Invoice.
2. Open the sale you want to edit.
3. In the Tax field, replace None with the correct tax rate.
4. Scroll to the bottom of the page.
5. 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.