Versions Compared

Key

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

...

Screenshot: Import button

Image Removed

Note
titleNote

The button will only be active when you filter the rates by the rate table.

Image Added

Step 1. Selecting a File and Specifying Additional Parameters

The first thing you need to do in the import configurations view is to select select a rate table (the import template will autocomplete if existentit exists). Then, drag-and-drop or upload an import file. Additionally, you can specify the following parameters:

Screenshot: Step 1. File Settings

Image AddedImage Removed

FieldDescription
Rate TableThis field will be autocompleted with the name of a rate table if the rates are filtered in the Rates section. If not applicable, select a target rate table(s)
Import TemplateSelect a target template for rates importing if available

You can also save the importing file settings as a template for further usage during import. To do so, click the Image Added button next to the Import Template field, specify the name, and click the Save Template button.

Screenshot: Saving a Template

Image Added

You can update the working Template by clicking the Image Added button.

Panel
borderColor#FFBABA
bgColor#FFBABA
borderWidth2px
borderStylesolid

Warning

  1. It's not possible to import a file into the Rate Table with the Min Time and Interval = 0. These fields must have at least 1 second.
  2. While specifying the Effective Date and End Date, keep in mind that Timezone is UTC (+0000) by default.
  3. Please DO NOT import duplicates of the same Code in one import file.

...

Screenshot: Step 2. Import Settings

Image RemovedImage Added

Starting from VCS 3.17.0, the user has a possibility to specify a type for each sheet of an imported file. Each sheet type has its own list of columns.Currently, there are 3 sheet types:

...

Starting from JeraSoft Billing v3.18.0, the user has an the option to select the Skip this sheet option for the system to ignore the respective sheet during import. More about sheet types type configuration here.

Screenshot: Sheet types

Image Removed

On the second step, you can also save the importing rate table as a template for further usage during import. To do so, specify a template title in the bottom left corner of the tab, and click the Save Template button (see screenshot above).

Image Added

To To open advanced configurations, click on a grey downwards arrow  icon next to Step 2: Import Settings. Advanced settings contain the following fields:

...

FieldDescription
If Unchanged

Determines system behavior if it detects rates in the imported file with all the same settings as the ones already present in the Rate Table but Effective Date. Has two options:

  • Save rows
  • Skip rows
On Warnings

Manages alerts from the Analysis Settings section. If any, you'll have the option to:

  • Save rows
  • Skip rows
  • Abort import
On Errors

Determines billing behavior if inconsistency or error was found in the importing file (data inconsistency, incorrect symbols, etc.)

  • Import correct rows and show all found errors - import error-free rows and display the list of errors, if any
  • If errors are found, abort import and show all errors - if any error is found, stop the import and display a list of errors
Datetime Format

Specify the date format of an imported file. Please note, the auto-detection of date and time can be performed with files that contain one of the date and time formats, listed below:

  • DD-MM-YYYY (%d-%m-%Y) = 28-12-2018
  • YYYY-MM-DD (%Y-%m-%d) = 2018-12-28
  • MM/DD/YYYY (%m/%d/%Y) = 12/28/2018
  • DD.MM.YYYY (%d.%m.%Y) = 28.12.2018
  • YYYY/MM/DD (%Y/%m/%d) = 2018/12/28
  • YYYYMMDD (%Y%m%d) = 20181228
  • YYYY-MM (%Y-%m) = 2018-12
Billing Increment

Billing Increment defines the way events are billed and combines two parameters: minimum volume and tariffication interval or three parameters: minimum volume,tariffication interval and grace volume. Indicate the order of parameters recognition in the Billing Increment column:

  • Min Volume/Interval
  • Interval/Min Volume
  • Min Volume/Interval/Grace Volume
  • Interval/Min Volume/Grace Volume

For example, if the Billing Increment column in your import file is 1, 5, and you selected Min Volume/Intervalvalue in this field, the system will recognize 1 as Minimum Volume and 5 as a Tariffication Interval for a target rate.

Skip dash in codes

Select whether a dash in codes must be skipped or not:

  • Enabled - codes, written as 1201-1205, will be imported as a single 12011205 code
  • Disabled- 1201-1205 codes will be imported as separate 1201, 1202, 1203, 1204, 1205 codes
Split Src Code Name

This option is used only in case source code names contain an underscore symbol. Choose one of the following:

  • Disabled - if an Src Code Name is, for instance, USA_Columbia, it will be preserved as it is after import.
  • By underscore - if selected, a USA_Columbia Code Name will be changed to Columbia after import.
Blocked keywordsList words here for the system to recognize blocked destinations. The prefilled value is block. These words are recognized in the Rate and Changes columns.
Closed keywordsList words here for the system to recognize closed destinations. The prefilled values are close, delete, terminate, deactivate, and remove. These words are recognized in the Rate and Changes columns.
Notificator Code DeckSpecify code decks that will be used for the next rates notification
Update Code Deck

Select the way you want both Src and Dst code decks to be updated with new/existing code names from current rates file:

  • Disabled - leave selected code decks unchanged
  • Import only not existing codes - code decks will be updated with codes and their names if they are missing
  • Import all codes (update existing) -  сode decks and codes will be updated with code names taken from a file, overwriting of existing ones
  • Import all codes (purge code deck first) - code decks are fully cleared and then all codes and code names are imported from a file
Panel
borderColor#ffffb3
bgColor#ffffb3
borderWidth2px

(warning)   Attention

If Src Code and/or Dst Code sheet type is selected, you need to enable this feature

 

Code Deck Dst Code Deck that will be used for an Update Code Deck option. Select a destination code deck that you want to update with the above-mentioned settings (note that code deck specified settings here will only be available if you are importing a file, which contains Code Names in addition to Codes).
Src Code DeckSrc Code Deck that will be used for an Update Code Deck option. Select a source code deck that you want to update with the above-mentioned settings (note that code deck specified settings here will only be available if you are importing a file, which contains Code Names in addition to Codes).
AZ Mode

A special mode that determines system behavior regarding active/future rates:

  • Disabled- leave active/future rates unchanged. Selected by default.
  • Simple mode - active rates from a current Rate Table will be closed on the specified AZ close date if they aren't present in this import.
  • Extended mode - all existing future rates will be marked as stashed. Currently, active rates (not presented in this import) will be closed by the date specified below.
AZ codesAvailable if AZ Mode is active. Specify the exact code(s) AZ Mode is going to be applied to. By default, the field value is "*" (all codes)
AZ interval

Available if AZ Mode is active. Specify the period for AZ mode to close rates. The selectable options are:

  • days from last midnight - the rates will be closed after the specified amount of days from the midnight of the import day
  • days from now - the rates will be closed after the specified amount of days from the import day
  • hours from XX:00 - the rates will be closed after the specified amount of hours from the start of an hour of the import timestamp
  • hours from now - the rates will be closed after the specified amount of hours from the import timestamp
Panel
borderColor#ccffcc
bgColor#ccffcc
borderWidth2px
borderStylesolid
Tip

For a detailed explanation, check out our Knowledge Base article


AZ close dateAvailable if AZ Mode is active. The field displays the time and date (with timezone) of rates closure based on the AZ interval parameters.
Billing Increments Check

Select whether you need billing increments checking during import or not:

  • Enabled - the system will raise an error in case imported rates' billing increments differ from those already present in the Rate Table.
  • Disabled 
Deviation Tolerance, (%)Define the value of how much can an imported rate differ from an existing one in percent. If exceeded, the system will generate an alert for the manager.
Agreements Tolerance, (days)Define a number of days that the system will take into account while analyzing the new import and the current agreement with the vendor. If the dates of an agreement and the import are closer then the specified amount, the system will generate an alert for the manager.
Changes Threshold, (rates)Define a number of changed rates that will serve as a threshold for the selected rate table. If exceeded, the system will generate an alert for the manager.

...

Screenshot: Rates import - Code Rules settings

Image RemovedImage Added

FieldDescription
CodeIndicate a destination code. For all codes, use * (asterisk)
Status

Indicate a status for the rates. By default, it will be Active. Set the Stashed status if you want to double-check them later after import.

Effective Date

Specify a start date of a rate. There are various options to schedule this date:

  • days from last midnight - the rates will be active after the specified amount of days from the midnight of the import day
  • days from now - the rates will be active after the specified amount of days from the import day
  • hours from XX:00 - the rates will be active after the specified amount of hours from the start of an hour of the import timestamp
  • hours from now - the rates will be active after the specified amount of hours from the import timestamp
Time Profile Indicate time profile that will be used for a current rate, for example, business time, non-business time, weekends, etc.
MinMinimal time of the call that will be tariffed.
For example, if the total call time was 20 seconds and Min is 30, the client will pay for 30 seconds of the call.
IntTariffication interval. 
This parameter is used, when Min Time time expires.
Extra

Additional parameters are stored under the downwards arrow icon.

Tag - specify a tag for respective rates. If it's not applicable, assign a (@) tag as default

.

  • Service - specify a service of the rates.
  • Grace Volume - a volume that will not be tariffed (i.e., it's free). Policy -rate's type for a code: regular rate or additive (extra) rate.
  • Setup Fee - an initial fee that is charged.
  • Number Length - specify the min and max number length.
  • End Date - the final date after which the rate will expire.
  • Notes -additional information.

...

Screenshot: .csv file with detailed error data

Confirming Rates

When the procedure has been executedIf you choose Stash Status of the rates during the Import process, you will be forwarded to the Rates section where all imported rates will be displayed.  If the Auto-Confirm option was disabled during the import process, you Here you need to Mass Edit the rates' status from stashed to active.

Screenshot: Confirming Rates

Image RemovedImage Added

Import History Tab

...

Screenshot: Import History output

Image AddedImage Removed

User Login
ColumnDescription
Date
Time and date of import execution
Details

Login of a user who executed the import


File 

Import and the import file. By clicking on theImage Modified icon, the file will be downloaded

Total RowsTotal amount of imported rows
Total RatesTotal amount of imported rates
NewTotal amount of rates with New type
IncreasedTotal amount of rates with Increased type
DecreasedTotal amount of rates with Decreased type
UnchangedTotal amount of rates with Unchanged type
ClosedTotal amount of closed destinations
BlockedTotal amount of blocked destinations
A-Z ClosedNumber of rates, closed by A-Z import
A-Z StashedNumber of rates, stashed by A-Z import
StatusStatus of import procedure (success/failed)

Image Modified icon

When clicked on, deletes respective import data from the system

Info
titleNote

Only the latest Import can be undone.


...