Introduction
INVOICE MANAGEMENT (IM) works as a solution for CPOs to
-
rate ChargeDetailRecords (CDRs) - i.e. calculate the price of a charging session from the CDR and the tariff
-
produce invoices
You will be doing this in a designated portal that is to be reached via the HBS. Click on Invoice Management to reach the invoice management service.
As an integrated service of intercharge CPO, it will be available for all partners (pending availability). It is an optional service, which can either be used for rating and invoicing or only one of the options.
IM Portal
The IM Portal allows you to maintain and oversee the process with the following tabs:
-
Dashboard: This is your starting page. Here you can monitor rated CDRs as well as your new notifications
-
Account Configuration: Here you can configure your Bank Details (the bank details that are supposed to be shown on your invoice) as well as VAT and Invoice Settings. Also, you have the possibility to preview your invoice
-
Tax Configuration: A list of all your EMPs, sorted by country of your subsidiaries is shown here. You can configure the VAT for each EMP here
-
Invoice Overview: Here you have an overview of all invoices generated with Hubject Invoice Management; they are created in pdf format and you can download them in order to share them with your EMPs.
-
CDR Control Center: This tab gives you an insight into all Charge Detail Records (CDRs) as well as their rating status (including error messages if the rating was unsuccessful)
Preconditions
-
Tax configuration completed
-
Offers with Standard Pricing or Product Pricing
-
All price information needs to be available in a machine-readable format
Please note the following:
-
Any pricing information that is included as a PDF attachment is INCOMPATIBLE with this product
Tax Configuration
In the Tax Configuration, you can see all EMPs with an active subscription to one of your offers sorted by country. Click on Export to download your data. A .xls file with all EMPs from the selected country will be saved.
If you want to edit the tax configuration for one or more EMPs within a country, select those you want to change and click on Edit.
Make sure to save your changes.
In case you want to operate in several countries, you need to add a new country as a new subsidiary in Account Configuration first, then you can edit it in the Tax Configuration.
In case you have a new subscriber, he will be added to the list of EMPs. Then you need to configure the Tax Configuration for this new EMP manually.
Rating Methodology
Please note: this product does not contain any transfer of money - this function is exclusive to intercharge SETTLEMENT.
Examples of the rating process
CDR with Standard Pricing
If you defined Standard Pricing as your pricing methodology, the rating of a CDR could look like this:
Example without rounding:
| Price per Reference Unit: | 0.5 € |
| Reference Unit: | kWh |
CDR (not rated):
| Consumed Energy: | 50 kWh |
| Partner ID: | 123 |
| Country: | Germany |
Net Amount:
50 kWh*0.5€/kWh=25€
Tax defined with Partner 123 in Germany:
VAT ( % ) = 19%
VAT = 4,75€
Gross amount:
Net Amount + VAT = 25€ + 4,75€ = 29,75€
The value of this CDR is 29,75€
Example with rounding:
| Price per Reference Unit: | 0.33 € |
| Reference Unit | kWh |
CDR (not rated)
| Consumed Energy: | 57.344 kWh |
| Partner ID: | 123 |
| Country | Germany |
Net Amount:
57.344 kWh*0.3€/kWh=18.92352€ = 18.93€ (at this point, the rounding of the net amount takes place)
Tax defined with Partner 123 in Germany:
VAT ( % ) = 19%
VAT = 3.5967€ = 3.60€ (also this value is being rounded)
Gross amount:
Net Amount + VAT = 18.93€ + 3,60€ = 22.53€
The value of this CDR is 22.53€
CDR with Product Pricing
If you defined Product Pricing as your pricing methodology, the rating of a CDR could look like this:
| Price per Reference Unit: | 1 € |
| Reference Unit: | kWh |
| Price per Session: | 2 € |
CDR (not rated)
| Consumed Energy: | 100 kWh |
| Partner ID: | 111 |
| Country | Italy |
Net Amount:
2€ + 100 kWh + 1€/kWh = 102€
Tax defined with Partner 111:
VAT ( % ) = 22% (calculated on the session)
VAT = 0.44€
Energy ( % ) = 10% (calculated on the consumed energy)
Energy = 10€
Gross amount:
Net amount (Session) + VAT + Net amount (Energy) + Energy = 2€ + 0.44€ + 100€ + 10€ = 112.44€
The value of this CDR is 112.44€
Why could my CDR not be rated?
There are some reasons why your CDR was not rated:
-
If Product Pricing applies and the Product ID is not defined in the HBS or missing
-
If Product Pricing applies or a Charging Session Validity was defined and the Charging Time or Energy was smaller than the Charging Session Validity
(e.g Charging Session Validity: 100 Wh, Consumed Energy = 50 Wh) -
Subscription between CPO X and EMP Y is neither Standard Pricing nor Product Pricing based
-
The currency is not supported
-
EVSE data is missing in the HBS
-
Tax is not configured (subsidiary or partner or price component tax is not configured)
Error Handling: Rating
In case of an error, this table shows you how you could handle this:
|
Description of the Error |
Rating Status |
Rating Reason |
Handling |
Notification |
|
Only Standard Pricing |
Not Rated |
Only standard price possible |
This pricing methodology is not supported. If you want to use Hubject Invoice Management, please adapt it to product pricing or standard pricing. |
No |
|
Product Pricing is missing in the CDR Or is Product Pricing different from the one in the Service Offer |
Not Rated |
The product ID is missing in the CDR. Or The product ID which was provided does not exist in the HBS
|
The CDR that has been successfully sent cannot be sent again. Please invoice the CDR separately. |
No |
|
The Session was not valid |
Not Rated |
Session Duration was less than Charging Session Validity (Min) or the energy consumed was less than Charging Session Validity (kWh) |
No further actions. |
No |
|
The currency is not supported |
Not Rated |
Currency is not supported. |
In addition to Euro, the solution supports also these currencies: Bulgarian Lev, Czech Koruna, Danish Krone, Norwegian Krone, Romanian Leu, Swedish Krona, and Swiss Franks. Other currencies will be developed at a further stage |
No |
|
Tax is not configured |
Not Rated |
No tax configuration for this country, for this EMP, or for the price components configured |
Define the missing configuration for future CDRs and invoice the CDR in question separately. |
Yes to CPO |
|
No EVSEData |
Not Rated |
No EVSE Data is available |
The EVSE Data which was transmitted in the CDR does not exist in our system. Please update your EVSE Data Information to rate future CDRs on this charging point. |
Yes to CPO |
Invoice Overview
Here you can see and download every Invoice or Credit Note as well as the following details:
|
Name of the column |
Description |
|
Date |
The Date, on which this Invoice/ Credit Note was generated |
|
Invoice/ Credit note Nr. |
A ten-digit number(yymmddnnnn-EMP) combined with the invoiced EMP. |
|
Company Name |
The name of the invoiced company |
|
Type |
The type of the document, either Invoice or Credit Note |
|
Provider ID |
The ID from the Invoiced EMP |
|
Invoiced Month |
The month, for which the invoice/credit note counts |
|
Total Amount |
Total Amount of the Invoice |
1. Invoices are generated in pdf format and can be downloaded at any time: since EMPs have no access to the Invoice Overview tab, invoices should be sent to them via email or via post.
2. Downloading a Single Invoice/ Credit Note
In the table on the right, you can see a download button in each column. If you want to download a single invoice, just click on this icon. The download of a .zip file will start, containing the invoice as a .pdf and the associated CDR data as a .csv file. Please note that, if you are present in more than one country, there will be multiple invoice documents.
3. Downloading all Invoices and Credit Notes
By clicking on the Export Button in the right top over the table view, a Zip- download with all invoices and their CDRs will start. The invoices will be a .pdf file, and the CDR data a .csv file.
Please note: this product does not contain any possibility to contest a CDR yet. This feature is only available in intercharge SETTLEMENT.