Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Excerpt

In this page we are analyzing the two extra custom fields related to the Acronis Invoice Items for the Cloud Distributors, along with their utility in various tools and mechanisms.


There are two extra custom fields, called SKU and CustomerName which are utilized for every invoice item. These two custom fields are used so that you know, for each charge you receive from Acronis, which is the product code (SKU) of this charge and to which customer it corresponds.
These fields are available to both Acronis Service Managers, but on this page, we analyze only the custom fields for the Acronis Service Manager for SPs (cloud distributors). You can utilize them in four different means, namely, Reporting, Notifications, Invoice Print-outs, and API (GET) methods, which are analyzed further below.

💡 If you wish to also check the other custom fields of the Acronis Service Manager for MSPs (managed service providers), please continue on the … to the Extra Information For Acronis Invoice Items (Managed Service Providers) page.

Rw ui textbox macro
typenote

Adding the Acronis Extra Custom Fields (for Invoice Items) into your BSS Organization

To receive the extra custom fields SKU & CustomerName in your BSS organization via the Acronis Service Manager for SPs (cloud distributors) you must run successfully the Get Services Definition process for each active instance.

Also, please note that these fields have been created as custom Acronis Service Manager fields, and they are not shown in the general invoice items section but only after enabling the Service Manager Custom Fields from the Display More Fields section.

Locating the Acronis Custom Fields


Both custom fields can be found by navigating to BSS Setup Invoices Invoice Items Custom Fields and selecting the name of the Acronis Service Manager for SPs (cloud distributors) in orderto view them.

Image RemovedImage Added
Rw ui textbox macro
typenote

Please Double-Check the User Permissions

In order to be able to view and utilize these custom fields, you need to make sure that the user permissions are properly defined.

Utilizing the Acronis Custom Fields


The information and values that these two custom fields have are neither available inside the invoice view page nor inside the Storefront. Rather they are available via the following four elements, analyzed below. These custom fields can be added (or collected) and utilized in:

  • An email notification containing invoice items,

  • An invoice report containing invoice items,

  • An invoice print-out, meaning a PDF file or printable form views (if they have been added to the default invoice print-out template in the BSS),

  • An API (V.3) method, such as the two following ones:

    • GET /api/invoiceItems/{invoiceItemId}/customfieldsRetrieves the custom field values of an invoice item based on the given ID.

    • GET /api/invoices/{invoiceId}Retrieves a specific invoice based on the given ID, along with its invoice items.

Table of Contents


Table of Contents
maxLevel6
minLevel1
maxLevel6
include
outlinefalse
indent
excludeTable of Contents
typelist
classprintablefalse
class