Skip to main content

Imports and processing

This section explains the import and processing of usage data. It also discusses the different methods for pricing of usage data.

Usage data imports

The first step is to create a new import for the corresponding supplier and import the usage data file. To do this, navigate to the Usage Data Suppliers page and then open the related Usage Data Imports using the action of the same name.

In addition to the data generated by the system, an (individual) description per import can be entered in the Description field. Furthermore, the current processing status can be read using the fields Processing Step, Processing Status and - in case of error - Reason (Preview).

The progress of processing can be viewed via this page. Invoicing takes place after the usage data has been processed.

Structure of the page Usage Data Imports

The page has the following action areas:

  • New
    • The New Import action is used to prepare a new import.
  • Process
    • Import file
      Opens a file dialog to add the import file to the selected import.
    • Process Data
      Processes the imported usage data, but without creating the invoices. The individual steps Create Imported Lines, Process Imported Lines, Create Usage Data Billing and Process Usage Data Billing are automatically run one after the other.
    • Create Customer Invoices
      Creates a Sales Invoice for all contract elements belonging to the selected import. This creates a separate invoice document for each Customer Contract. The generated contract invoices are posted directly if the Post documents indicator is set to YES in the dialog.
    • Create Vendor Invoices
      Creates a Purchase Invoice for all contract components belonging to the selected import. This creates a separate invoice document for each Vendor Contract. Since a Vendor Invoice No. is required for posting Purchase Invoices, the option to post the generated documents directly is not available here.
  • Manual Processing (via Related)
    As an alternative to automatic processing of usage data via Process Data, the individual steps can also be called up separately.
    • Create Imported Lines
      Generates the usage data as raw data based on the import file. The Data Exchange Definition is used, which is stored at the Usage Data Supplier (in the Settings page). The generated Imported Lines can be opened via the lookup in the No. of Imported Lines field.
    • Process Imported Lines
      When processing the Imported Lines, the system attempts to create a link between the usage data and the Service Commitments or Service Objects. If errors occur during processing, the erroneous data can be opened using the lookup in the No. of Imported Line Errors field. After correcting the causes of the errors, the processing step can be executed again.
    • Create Usage Data Billing
      Generates the data needed for actual billing based on the Imported Lines. Since usage data is often vendor or supplier data, this step - depending on the configuration - generates the data needed for customer billing.
    • Process Usage Data Billing
      In this step, the pricing for the usage data takes place. The respective method for pricing and the period to be billed are taken into account. If errors occur during processing, the incorrect data can be opened via the lookup in the No. of Usage Data Billing Errors field. After correcting the causes of the errors, the processing step can be executed again.
    • Remove Usage Data Lines & Billing
      This action can be used to delete the usage data generated on the basis of the import file and then generate it again. This is useful, for example, if errors occur during processing that can be solved by changing the Data Exchange Definition used.
  • Usage Data Billing (via Related)
    • Customer Contracts
      This action opens an overview of the Customer Contracts belonging to the import.
    • Customer Contract Invoices
      This action opens an overview of the Customer Contract Invoices created for the import, but not yet posted.
    • Posted Customer Contract Invoices
      This action opens an overview of the Customer Contract Invoices created and posted for the import.
    • Vendor Contracts
      This action opens an overview of the Vendor Contracts associated with the import.
    • Vendor Contract Invoices
      This action opens an overview of the Vendor Contract Invoices created for the import, but not yet posted.
    • Posted Vendor Contract Invoices
      This action opens an overview of the Vendor Contract Invoices created and posted for the import.

Methods for pricing

On the purchasing side, i.e. for Usage Data Billing with Partner=Vendor, the prices provided via the supplier are further used, as the supplier usually also provides an invoice for this that matches the usage data. Since with the vendor-side invoicing in the further process a Vendor Contract Invoice is created, this must likewise fit to the usage data and thus also to supplier invoice.
The Customer price calculation, on the other hand, depends mainly on two things:

  • the value in the Usage Based Pricing field of the Service Commitments belonging to the usage data and
  • the setting of the Unit Price from Import field at the Usage Data Supplier. If the indicator in the Unit Price from Import field is set at the supplier, the import file must contain this data. In addition, the Data Exchange Definition must take this information into account. In this case, price calculation does not take place because the supplier of the usage data includes the sales prices and this flag overrides price calculation.
    If the indicator is not set at the supplier, one of the following methods for customer pricing is used.

Usage Quantity

The price is calculated based on the quantity contained in the usage data. First, the Service Commitments are used to find the Service Object and thus the related item. If necessary, the appropriate price scale is determined via the quantity. Based on the period to be billed (fields Charge Start Date and Charge End Date), the partial period is calculated to the day (with a corresponding daily price) in the case of a pro-rata billing period.

Fixed Quantity

When processing usage data, the original quantity remains fixed. This means that the customer is always charged the original fixed quantity. There is no adjustment of quantities based on usage data.

Unit Cost Surcharge

Here, the imported usage quantity is also disregarded. However, the cost price plus the surcharge specified in the Service Commitments is charged to the customer. This option is often used for consumption-based billing. In this case, all individual prices of the usage data belonging to a subscription are added up and then the surcharge is calculated on the total.

Pricing for partial periods

In addition to the above methods, any partial periods are also taken into account when determining prices. First of all, the following notes apply:

  • Partial periods exist if the time span between Charge Start Date + Dateformula from Billing Base Period of the Service is different from the time span between Charge Start Date and (inclusive) Charge End Date. This can be the case, for example, if there are one or more quantity changes within a billing period or if it is just not a complete billing period.
  • Since the months have different numbers of days, the month in which the Charge Start Date (in Usage Data Billing) lies determines which daily price is used as the basis for calculating the partial period (see below).
  • Provided that it is a full billing period, it is irrelevant whether the billing period is congruent with a calendar month or overlapping.
    Usage data describing a change in quantity within a billing period usually contains several data records, with the periods matching the corresponding quantity in each case.

When calculating prices for partial periods, the system calculates with the respective valid day price. For this purpose, first the number of days of the Calculation Base Period (from the Service Commitments) is determined, in which the Charge Start Date lies. The (billing period) price is then multiplied - taking into account the quantity scale, if applicable - based on the ratio of the two time periods.
For the common billing period of 1 month (Billing Base Period=1M), the daily prices within a calendar month are always identical. Consequently, for two partial periods whose Charge Start Date is in two calendar months with different number of days, the daily price is also different.

Different daily prices

If the monthly price is the same, the daily price in a month with 31 days (e.g. January) is lower than in a month with only 28 days (e.g. February). However, this only applies if it is a partial period. The price of full billing periods, however, is always identical.

Examples partial periods

Partial periods within a calendar month

Charge Start DateCharge End DateNumber of daysUnit price monthQuantityPrice partial period
01.05.202210.05.20221035222,58
11.05.202231.05.202221355118,55

Total price for billing period: 141,13

Overlapping partial periods

Charge Start DateCharge End DateNumber of daysUnit price monthQuantityPrice partial period
11.01.202202.02.202223355129,84
03.02.202210.02.2022835880

Total price for billing period: 209,84

Process: Import usage data

  1. Via the Usage Data Suppliers page, the related Usage Data Imports are opened via the action of the same name.
  2. A new import is created via the New Import action. The supplier is set automatically.
  3. The Import file action opens a file dialog with which the import file can be added to the selected import.
  4. The file will be stored as a BLOB. The details can be viewed via the lookup in the No. of Usage Data Blobs field. Then the usage data is processed.

Process: Process usage data

The processing of usage data can be done in just one step via Process Data. This comprises several individual steps, which are explained in detail here for better understanding. After importing the reconciliation file, the raw data is generated as individual lines based on the import file via Create Imported Lines. The details can be viewed via the lookup in the Imported Lines field. 2. When processing the Imported Lines (Process Imported Lines), the imported usage data is merged with the Service Commitments and thus Service Objects. Subscriptions are used as a link for this purpose, and DYCE Usage Based Billing uses them to establish the connection. If required, these records can be created automatically. Specifically, the usage data contains the ID of the subscription to which it belongs. Each Subscription, in turn, has a reference associated with the Service Commitments (via the Supplier Reference Entry No. field). In the event of an error, the affected records can be viewed via the lookup in the No. of Imported Line Errors field.
If there is no connection between a Subscription and a Service Commitment, it can be established via the functionality Connect Subscription with Service Object, provided that the Service Commitment and the Service Object already exist. If this is not the case, they can be created using the Extend Contract functionality and automatically linked in the process. 3. Since usage data is often supplier-side data for which the data required for customer-side billing is (still) missing, customer-side partner data is created for each vendor usage data record when generating the Usage Data Billing (via Create Usage Data Billing) - depending on the configuration (see below) - which is later used for customer-side billing. The details can be viewed via the lookup in the No. of Usage Data Billing field.
The records in Usage Data Billing are vendor neutral, meaning all usage data read in is normalized to this table regardless of the original source. 4. When processing Usage Data Billing (via Process Usage Data Billing), the data in the respective Vendor or Customer Contract lines, in the Service Objects and in the Service Commitments are updated based on the new usage data (quantities and prices). In addition, the sales price is calculated for each data record with Partner=Customer (see methods for pricing). In case of error, the affected records can be viewed via the lookup in the No. of Usage Data Billing Errors field.
This step completes the actual processing of the usage data.

The next step is the invoicing. Ideally, first with the incoming invoice accompanying the usage data of the supplier and then with the further billing in the form of Customer Contract Invoices to the respective customers (although the order is arbitrary).

Vendor and/or customer usage data

In addition to the import of Vendor usage data already described in this section, it is also possible that only Customer usage data is available. This is usually the case when the Service Commitments to be billed are internal services. In such a constellation, both the Service Commitments at the item master data and the Service Commitments at the Service Objects are configured in such a way that there are only Service Commitments with Partner=Customer.
The connection between Subscriptions and Service Commitments is always made via the field Supplier Reference Entry No., whereby a Vendor Service Commitment is always prioritized. However, if there is only one Customer Service Commitment, the connection can also be made via this.
When processing usage data, the assignment is therefore made either via the Vendor Service Commitments or, if this is not available, via the Customer Service Commitments.

Only customer usage data

If only a Customer Service Commitment exists, only those with Partner=Customer are created when processing the related usage data.