Skip to content

JustOn Upgrade Guidelines

This document outlines the path organizations must take to upgrade earlier versions of JustOn to a recent release. Navigate to the version you intend to install for information about how to proceed.

Info

Generally, JustOn recommends to delete all draft invoices before installing the new JustOn release in order to allow for a smooth transition to the new features.

2.52

Upgrading to JustOn 2.52 requires at least JustOn 2.51.

2.51.3

Upgrading to JustOn 2.51.3 requires at least JustOn 2.49.

Upgrade Information

JustOn 2.51 switches to Lightning Experience as the primary user interface.

JustOn 2.51 activates field history tracking for Item, PaymentEntry, Template, Transaction Detail and Transaction. If upgrading from a previous version, you may have to enable field history tracking manually for these objects for the upgrade to succeed.

JustOn 2.51 has moved the View remaining button to the Invoice Run Layout. If upgrading from a previous version, you may have to add the button manually to the layout (see Managing Pages).

For details, see JustOn 2.51 Release Notes.

2.49.1

Upgrading to JustOn 2.49.1 requires at least JustOn 2.43. If, unusually, upgrading from 2.43 to 2.49 fails, install JustOn 2.45.3 as an intermediate version.

Upgrade Information

JustOn 2.49 switches to Salesforce Files as the default location for storing

  • produced invoice and dunning reminder PDF files
  • exported invoice and bookkeeping data CSV files
  • exported SEPA XML files

Find the produced files on Salesforce's Files tab in the group Owned by me, if not configured otherwise (see File Distribution and Export Settings). For details, see Where do I find produced files? in the FAQ.

Make sure to adjust any custom integrations, configurations, templates, etc. that rely on the storage location for produced files and check them for proper operation.

For details, see JustOn 2.49 Release Notes.

2.43.1

Upgrading to JustOn 2.43.1 requires at least JustOn 2.38.

Upgrade Information

To install JustOn 2.43, you must enable the Salesforce feature My Domain.

To allow for a smooth transition to the rewritten tax support, you must delete all draft invoices before installing JustOn 2.43.

If you use the tenant configuration, make sure to add the tenant to your tax rules as well.

JustOn 2.43 does no longer create booking details by default. The booking detail creation must be enabled explicitly.

The following fields on the invoice line item have been marked as deprecated and can be deleted by a Salesforce admin:

  • UnitPriceNet__c (can be replaced by UnitPriceCalc)
  • UnitPriceTax__c
  • UnitPriceGross__c

Make sure to adjust any custom integrations, configurations, templates, etc. that rely on these fields and check them for proper operation.

For details, see JustOn 2.43 Release Notes.

2.38.3

Upgrading to JustOn 2.38.3 requires at least JustOn 2.26. If, unusually, upgrading from 2.26 to 2.38 fails, install JustOn 2.32.3 as an intermediate version.

Upgrade Information

With JustOn 2.38, the following business logic is no longer available via triggers.

Make sure to check any custom implementations whether they rely on these triggers. Rework your implementations as necessary to ensure correct functioning.

Business ProcessRemoved Trigger Functionality
Create invoiceSetting contact roles
Currency conversion date
Setting UUID
Finalize invoiceRendering text fields for invoice PDF incl. placeholders
Creating balances
Delete invoiceReset LastInvoiceRun on subscription
Remove balances
Create, edit, delete invoice line itemCalculated invoice balance (field)
Calculating rounding-item, delta-item
Setting service period dates
Calculating and setting invoice class
Calculating sequence
Assign, delete balancesCalculated invoice balance (field)
Setting and updating invoice status

With JustOn 2.38, setting the picklist field Status on an invoice to Open is no longer supported. That is, you can no longer finalize an invoice this way.

All business processes related to finalizing an invoice, like assigning an invoice number, creating the PDF, creating a balance, etc., need to be initiated via a custom action.

To this end, JustOn 2.38 introduces the button Finalize. You can add this button to the invoice layout (see Managing Buttons or Links). In addition, we recommend to set the field Status on the invoice to read-only (see Modifying Pages).

For details, see JustOn 2.38 Release Notes.

2.26.2

Upgrading to JustOn 2.26.2 requires at least JustOn 2.25.

Upgrade Information

JustOn 2.26.2 requires the Balance object (introduced with JustOn 2.25) to be available.

JustOn 2.26 deprecates and deletes the following fields in favor of new fields:

ObjectDeleted Fields
InvoiceCreditTemplate__c
DiscountAllowed__c
Dunning RunTemplate__c

Make sure to adjust your page layouts accordingly.

2.25.4

Upgrading to JustOn 2.25.4 requires at least JustOn 2.18.

Upgrade Information

JustOn 2.25 introduces the Balance object.

After installing JustOn 2.25.4, make sure to

  • Assign all JustOn users read/write access to the Balance object
  • Execute the balance migration job using the JustOn Upgrade page
  • Create a cancellation template detail