Release Notes

Bookkeep after create & credit invoices (deal properties) New Feature Fix

From a HubSpot deal you can optionally bookkeep a newly created Fortnox invoice, or create a kreditfaktura by crediting an existing debit invoice—without building line items for the credit path.

• Fortnox bookkeep after invoice create (fortnox_bookkeep_after_create) — When Yes, after a successful new invoice create from the deal, the app calls Fortnox to book that invoice. When No, the document is left unbooked (same as before).
• Fortnox kreditfaktura (fortnox_kreditfaktura, values NEJ / JA) — NEJ: create a normal invoice from deal line items. JA: create a credit invoice in Fortnox by crediting the debit document given in the reference field (deal line items are not used for this flow). Values are matched case-insensitively.
• Fortnox document to credit (invoice number) (fortnox_credit_invoice_reference) — Fortnox document number of the debit invoice to credit. Required when kreditfaktura is JA. The resulting document number is written to Invoice number in Fortnox (invoice_number_in_fortnox) after success.

• New invoice: POST /3/invoices as today; optional PUT …/invoices/{id}/bookkeep when bookkeep after create is enabled.
• Credit invoice: PUT …/invoices/{debitDocumentNumber}/credit — Fortnox creates the credit document from the referenced debit invoice.

Fortnox may return error 1000031 if bookkeep or credit requests omit a JSON content type. The app now sends Content-Type: application/json (with an empty JSON body) for those PUT calls.

📚 Get Started — Create an Invoice

Fortnox PaymentWay (deal property) New Feature

Control which payment method Fortnox uses when creating an invoice—directly from HubSpot deals.

• Fortnox betalsätt (PaymentWay) (fortnox_payment_way) — Kontant (CASH), Kort (CARD), or Autogiro (AUTOGIRO) sets Fortnox PaymentWay. Use Kort for card (e.g. Diners) instead of default cash. Default/unset omits PaymentWay.

📚 Get Started — Create an Invoice

HubSpot Quotes ↔ Fortnox Orders (two-way) & CRM webhook compatibility New Feature

End-to-end flow between HubSpot Quotes, Fortnox Orders, and HubSpot Order records: create a Fortnox order from a Quote, store the document number on the Quote, embed the Deal id in Fortnox Remarks for traceability, then optionally sync Fortnox orders back into HubSpot Orders and associate them to the Deal. CRM property webhooks are aligned with HubSpot’s current object.propertyChange payload shape.

• App setting: Enable HubSpot quote to Fortnox order so queued jobs are allowed to run.
• Quote properties: create_order_in_fortnox (trigger) and fortnox_order_document_number (filled after a successful create).
• Trigger: A CRM subscription to POST /hubspot_event_subscriptions when create_order_in_fortnox becomes Yes (same endpoint as for companies and deals).
• Data: The app loads the Quote with line items, resolves the linked Deal and primary Company (fortnox_id), and builds a Fortnox Order (rows mirror the invoice-from-deal logic: article, quantity, price, discount, VAT, etc.).
• Remarks: Fortnox Order Remarks include HUBSPOT_DEAL_ID:<dealId> so the return path can link the Fortnox order to the right HubSpot Deal.

• App setting: Enable Fortnox orders to HubSpot orders so background jobs may create or update HubSpot Order records from Fortnox.
• Scheduled fetch: Optional env REPEATABLE_JOB_ORDERS_TO_HUBSPOT_PATTERN registers a repeatable job (same pattern as other REPEATABLE_JOB_* cron variables) to list orders from Fortnox.
• Matching: For each Fortnox order, the app looks up or creates a HubSpot Order by hs_external_order_id (Fortnox document number) and sets name, currency, total, etc.
• Association: If Remarks contain HUBSPOT_DEAL_ID:<id> (as set when the order was created from a Quote), the HubSpot Order is associated to that Deal and related records; otherwise the HubSpot Order is still synced but not linked to a Deal.

• HubSpot often sends subscriptionType: "object.propertyChange" with objectTypeId (e.g. 0-14 for Quotes) instead of legacy quote.propertyChange / deal.propertyChange / company.propertyChange. The app now accepts both normalized event keys (e.g. objectPropertyChangeCreateOrderInFortnox alongside quotePropertyChangeCreateOrderInFortnox).
• Deals & companies: The same compatibility applies to objectPropertyChangeCreateInvoiceInFortnox and objectPropertyChangeCreateCustomerInFortnox.
• Property values: propertyValue may be JSON boolean true or string "true" for checkbox-style properties.

• Re-authenticate status page: The checklist now includes quotes (e.g. Create order in Fortnox, Fortnox order document number), not only companies and deals.
• Post-install property creation: Missing HubSpot custom properties can be created for quotes together with companies and deals where applicable.

📚 Get Started — CRM webhooks · Quote → Fortnox Order · Fortnox Orders → HubSpot Orders

Cost Center Uppercase Normalization Enhancement

The Fortnox Cost Center field now automatically normalizes input to uppercase for Fortnox compatibility, preventing errors when cost center codes are entered in lowercase.

• The "Fortnox Cost Center" company property (fortnox_cost_center) – input is now normalized to uppercase when creating customers and invoices in Fortnox.
• Case-insensitive input: You can enter values in any case (e.g. "avd1", "Avd1", "AVD1") – the app converts them to uppercase before sending to Fortnox.
• Fortnox expects cost center codes in uppercase; previously, lowercase could cause errors (e.g. "Kunde inte hämta/hitta valuta" or similar).

1. On the HubSpot company, set Fortnox Cost Center to any cost center code (e.g. "avd1" or "AVD1").
2. When creating a customer or invoice in Fortnox, the app automatically converts the value to uppercase (e.g. "AVD1").
3. This applies to both customer creation and invoice creation from deals.

📚 See Get Started Guide for cost center field mappings.

Amounts Include VAT (Deal property) Enhancement

Opt in to treat HubSpot deal amounts as VAT-inclusive when creating Fortnox invoices, preventing double VAT when your amounts already include VAT.

• A new HubSpot deal property "Amounts include VAT" (amounts_include_vat) is created and managed by the app.
• Default behavior is unchanged – the app does not send VATIncluded, so Fortnox uses its default (amounts treated as VAT-exclusive, VAT added on top).
• When your HubSpot amounts are VAT-inclusive, set the property to Yes – the app will send VATIncluded: true so Fortnox does not add VAT on top, preventing double VAT.

1. On the HubSpot deal, set Amounts include VAT to:
   • No or empty (default) – Original behavior. The app does not send VATIncluded; Fortnox treats amounts as VAT-exclusive and adds VAT.
   • Yes – HubSpot amounts include VAT. The app sends VATIncluded: true so Fortnox does not add VAT on top.
2. When an invoice is created in Fortnox from the deal, the app only sends VATIncluded: true when you explicitly set the property to Yes.

📚 See Get Started Guide for field mappings between deals and Fortnox invoices.

Invoice vs Delivery Note & Cash Invoice (Deal controls) New Feature

Control whether Fortnox creates a regular invoice, a delivery note, or a cash invoice (kontantfaktura) directly from the HubSpot deal.

• A new HubSpot deal property "Fortnox document type (print template)" (fortnox_print_template) is created and managed by the app.
• The property lets you choose between Faktura and Följesedel when creating a Fortnox document from a deal.
• The property is optional – if you leave it empty, Fortnox uses its own default template (normally invoice).
• A second HubSpot deal property "Fortnox invoice type" (fortnox_invoice_type) lets you explicitly request a cash invoice (kontantfaktura) when needed.

1. On the HubSpot deal, set Fortnox document type to:
   • Faktura (value: st) – standard invoice.
   • Följesedel (value: ps) – delivery note.
2. Optionally, set Fortnox invoice type:
   • Standard invoice (Fortnox default) (value: INVOICE) – normal invoice type, handled as today.
   • Kontantfaktura (cash invoice) (value: CASHINVOICE) – Fortnox creates a cash invoice instead of a standard invoice.
3. When an invoice is created in Fortnox from the deal:
   • If the value is ps, the app sets Invoice.PrintTemplate = "ps" so Fortnox creates a delivery note.
   • For any other value (including empty), the app does not send PrintTemplate at all – Fortnox then applies its own default template (normally invoice).
   • If fortnox_invoice_type is set to CASHINVOICE, the app sets Invoice.InvoiceType = "CASHINVOICE" so Fortnox creates a cash invoice.
   • For INVOICE or when the field is empty, the app does not send InvoiceType – Fortnox uses its own default (standard invoice).

📚 See Get Started Guide for field mappings between deals and Fortnox invoices.

Product Status Sync from Fortnox New Feature

HubSpot product Status (Active/Inactive) is now automatically synced from the Fortnox product registry

• Product Status Mapping: The HubSpot product Status property (hs_status, values: active/inactive) is now synced from Fortnox articles during product sync
• Fortnox Fields: Uses the Active and Expired flags from Fortnox article details
• Automatic Sync: Works with the existing 30-minute product sync - no configuration needed
• Active products in Fortnox appear as Active in HubSpot; inactive or expired articles appear as Inactive

The app maps Fortnox article status to HubSpot's product Status property (hs_status):

• Active in HubSpot: When Fortnox article has Active = true and Expired = false
• Inactive in HubSpot: When Fortnox article has Active = false or Expired = true

This ensures that product availability is consistent between Fortnox and HubSpot. Inactive products in Fortnox will no longer appear as available when creating line items in HubSpot.

📚 See Get Started Guide for product sync field mappings

Order Number Mapping and Price Handling Improvements New Feature Enhancement

Enhanced invoice and product sync with order number mapping from Fortnox invoices and improved null price handling

• Order Number Mapping: Customer order numbers from Fortnox invoices are now automatically synced to HubSpot deals in the order_number field
• Null Price Handling: Products with null or missing sales prices from Fortnox now default to 0 instead of undefined
• Pipeline Recovery: Improved error handling when creating HubSpot pipelines - automatically recovers from duplicate pipeline errors

When Fortnox invoices are synced to HubSpot deals, the YourOrderNumber field from Fortnox is now automatically mapped to the order_number property on the HubSpot deal.

Product sync from Fortnox now handles missing or null sales prices more gracefully by defaulting them to 0.

• Better order tracking with customer reference numbers flowing from Fortnox to HubSpot
• More reliable product data with consistent price values
• Enhanced data integrity across both systems

📚 See Get Started Guide for more details on invoice and product sync

VAT Support for Line Items New Feature

Automatically include VAT codes for line items when creating Fortnox invoices from HubSpot deals, with automatic enrichment from Fortnox articles

• VAT codes from HubSpot line items are now automatically included in Fortnox invoice rows
• Automatic enrichment: If a line item doesn't have a VAT code, the app automatically fetches it from the Fortnox article (when the line item has a SKU)
• The app uses the tax property on line items, which contains the VAT code synced from Fortnox articles
• VAT is only included when present - if a line item doesn't have a VAT code and the Fortnox article also doesn't have one, the invoice row is created without VAT
• VAT values are automatically trimmed of whitespace for clean data

1. When products are synced from Fortnox to HubSpot, the VAT code from the Fortnox article is stored in the product's tax property
2. When you add a product to a deal, the VAT code is available on the line item's tax property
3. When creating an invoice in Fortnox from a HubSpot deal, the app checks each line item for a VAT code
4. If the line item has a tax property: It uses that VAT code directly
5. If the line item doesn't have a tax property but has an SKU: The app automatically fetches the Fortnox article and uses its VAT code
6. If a VAT code is present (and not empty/null), it's automatically included in the invoice row
7. The VAT code is set directly on the invoice row in Fortnox

📚 See Get Started Guide for more details on invoice creation and field mappings

Remarks Field Enhancements New Feature

Enhanced Fortnox invoice Remarks field with agreement dates, featuring automatic localization based on deal currency

• Agreement Dates: Two new custom properties added to all HubSpot deals: "Agreement Start date" and "Agreement End date"
• Agreement dates are automatically formatted and added to the Remarks field in Fortnox invoices
• Localized formatting: Agreement dates are automatically localized based on the deal's currency code
• Swedish (SEK): "Avtalsstartdatum {date} och slutdatum {date}" - Dates formatted as YYYY-MM-DD
• English (other currencies): "Agreement start date {date} and end date {date}" - Dates formatted as MM/DD/YYYY
• Smart ordering: The Remarks field is built in this order: Agreement Dates → Description
• All fields are automatically created when the app is installed or updated

1. Agreement Dates: Add agreement start and/or end dates to any HubSpot deal using the new custom properties
2. The system automatically determines the locale based on the deal's currency code
3. When you create an invoice in Fortnox from that deal, the content is formatted and included in the Remarks field
4. If both start and end dates are provided, they appear together in one text string
5. If only one date is provided, only that date is included
6. Agreement dates appear before the deal description in the Remarks field

📚 See Get Started Guide for more details on invoice creation and Remarks field structure

Order Number Sync to Fortnox Invoices New Feature

Sync order numbers from HubSpot deals to Fortnox invoices for better order tracking and reference management

• A new "Order number" custom property has been added to all HubSpot deals
• Order numbers from HubSpot deals are automatically synced to the YourOrderNumber field in Fortnox invoices
• The field is automatically created when the app is installed or updated
• Perfect for maintaining order references between HubSpot and Fortnox

1. Add an order number to any HubSpot deal using the new "Order number" custom property
2. When you create an invoice in Fortnox from that deal, the order number is automatically included
3. The order number appears in the YourOrderNumber field in Fortnox

📚 See Get Started Guide for more details on invoice creation

Billing Email for Fortnox Invoices New Feature

Automatically set billing email addresses on invoices created in Fortnox from HubSpot deals, with automatic sync from Fortnox customers

• A new "Fortnox Billing Email" field has been added to all HubSpot companies
• Automatic sync: Billing email is now automatically synced from Fortnox customers to HubSpot companies every 2 hours
• The app prioritizes the EmailInvoice field from Fortnox, falling back to the Email field if EmailInvoice is not available
• Billing email from the company is automatically included when creating invoices
• Email is set directly on each invoice - perfect for ensuring the right person receives it

1. Automatic: Ensure your Fortnox customers have EmailInvoice or Email set - it will sync automatically
2. Manual: Open any company in HubSpot, find the "Fortnox Billing Email" field (in Company Information section), and add the customer's billing email address
3. When you create an invoice from a deal with that company, the email is automatically set on the invoice

Enhanced Line Item Description Mapping Enhancement Superseded

Major enhancement to improve invoice creation with richer line item descriptions

This release introduced the ability to combine both name and description fields in line items. The feature was later simplified to use only product names for cleaner, more consistent invoices.

During this period, the app combined both name and description fields to create rich, contextual descriptions.

Intelligent Handling:

Based on user feedback and to align with standard invoice practices, the feature was simplified in December 2025 to use only product names. This provides cleaner, more readable invoices with consistent formatting.

📚 See Get Started Guide for more details on invoice creation

Deal Owner Information in Fortnox Invoices New Feature

Automatically include HubSpot Deal Owner information in Fortnox invoices for better tracking

The HubSpot Deal Owner's name is now automatically included in the "Our Reference" field when creating invoices in Fortnox. This makes it easier to track which team member is responsible for each deal.

• When a deal is converted to a Fortnox invoice, the system looks up the deal owner in HubSpot
• The owner's full name (First Name + Last Name) is added to the invoice's "Our Reference" field
• If there's no deal owner assigned, the invoice is created normally without the reference

1. Re-install the app in your HubSpot portal to grant the new permission
2. The new permission is crm.objects.owners.read (read-only access to owner information)
3. Once re-authorized, the feature works automatically for all new invoices

• Better invoice tracking and accountability
• Automatic owner information without manual entry
• Seamless integration between HubSpot and Fortnox
• No disruption to existing functionality