HubSpot transactions sync

Modified on: 06 Nov 2026

HubSpot allows you to manage your sales pipeline and opportunities. Erplain retrieves these deals to automatically convert them into sales documents and update your inventory accordingly.

Golden rule: A HubSpot deal creates a single document in Erplain. As the opportunity advances through your pipeline stages, this same document is updated and transformed (for example, from an estimate to a sales order, then to an invoice).

Sales pipeline configuration


Go to Integrations > HubSpot > Deals and click Add a pipeline:

  1. Select the HubSpot pipeline to sync.
  2. Set the Location for this pipeline (mandatory): this warehouse will be assigned to product lines for inventory reservation or depletion.
  3. Check Apply discount rules if you want Erplain pricing rules to take precedence over the line prices of the HubSpot deal.
  4. Configure the action associated with each stage of the pipeline, then click save.

Historical date: The field “Import deals created on or after” lets you restrict synchronization to recent opportunities. Leave this field empty to import the entire history.

Stage actions and transformation rules

The first stage configured with an active action creates the document. Subsequent stages transform it. The “Do nothing” action ignores the stage.
You can configure multiple pipelines simultaneously, each following its own specific workflow.

First possible action (Creation)Possible transformations in subsequent stages
Create a pending estimateAccept estimate → Convert to sales order (pending or confirmed) → Convert to draft invoice.
Create an accepted estimateConvert to sales order (pending or confirmed) → Convert to draft invoice.
Create a pending sales orderConfirm sales order.
Create a confirmed sales orderConvert to draft invoice.
Create a draft invoiceNo further transformation (or Cancel document).
Important: Stages in the document lifecycle cannot be skipped. For example, a pending sales order must be confirmed before it can be converted to an invoice.


Numbering, pricing, discounts, and taxes

  • Numbering: Your numbering sequences are maintained in Erplain. The HubSpot deal name is recorded in the document's External reference field.
  • Deal selling price: A HubSpot deal does not dictate its line unit price. Erplain recalculates the price based on the customer's price tier and discount rules.
  • Taxes: Determined according to your configuration (customer taxes, product taxes, or default tax).
  • Notes and attachments: Notes from the HubSpot deal are automatically copied to the internal notes of the Erplain document, along with their attachments.

Specific case: HubSpot estimates

Unlike standard deals, an estimate generated in HubSpot retains its specific pricing:

  • Line prices and taxes: The unit amounts and tax rates set on the HubSpot estimate are accurately reflected on the Erplain estimate.
  • Line discount calculation rule:
    • If the discount is specified as a percentage, this percentage is applied directly in Erplain.
    • If the discount is entered as an amount in HubSpot, it is treated as a discount per unit. Erplain therefore multiplies it by the total line quantity (e.g., a $5 discount per unit on 4 items = a $20 total discount on the Erplain line).
  • Location: An estimate linked to a deal uses the location of the pipeline. A standalone estimate uses the default location set in HubSpot settings.
  • Priority: As soon as a HubSpot estimate is issued for a deal, that takes control of future updates to the Erplain document.

Note: A deal does not create any document if:

  • It does not include any products or any associated contact/company.
  • Its pipeline is not configured in Erplain or its current stage is set to “Do nothing”.
  • Its creation date is earlier than the date threshold defined in your settings.

Check the Sync status (deal) card in HubSpot to find the exact reason.

Was this article helpful?

That’s Great!

Thank you for your feedback

Sorry! We couldn't be helpful

Thank you for your feedback

Let us know how can we improve this article!

Select at least one of the reasons
CAPTCHA verification is required.

Feedback sent

We appreciate your effort and will try to fix the article