...
This Import will allow the User to add or update Charges on Services for Billing. In order to add a charge to a Service, the 'Billable' flag of the Service must already be set.
By default this import will always Add new charges, not Update existing charges. Care should be taken, as this can create duplicate charges.
There is an optional UPDATE Flag that can be set to force the import to do Updates instead of Adds.
The import cannot delete existing charges, but it can set an existing MRC charge Stop Date to end the charge.
...
Required
Datatype is String.
Charge Catalog Name
Conditionally Required (unless Charge Catalog Full Name is provided instead)
...
NOTE: Instead of mapping the Catalog Name or the Catalog Full Name, the Catalog can be set in the Import Record Format.
If the Import Record Format has a value and it is also mapped, the mapped value takes precedence.
Charge Catalog Full Name
Conditionally Required (unless Charge Catalog Name is provided instead)
Datatype is Hierarchical String.
The default value is 'blank'.
...
Permitted values are from the SERVICE_TYPE List Values
All Service Types are valid for Service Charge Imports.
Bill Date
Datatype is StringDate.
This can come from a mapping or the Import File selection form. Mapping takes precedence.
...
This will override the Charge Catalog Description for Billing.
Expense GLA
Datatype is Hierarchical String.
Override Amount
Datatype is Number.
This is only allowed if the Charge Catalog entry allows 'Override Charge Amount '.
Stop Date
Datatype is StringDate.
Default value is 'blank'.
Used for MRCs only.
NRCs ignore this field.
...
Datatype is Number.
Default value is 'blank'.
If you map the New Override Amount and provide a blank value, then any existing Override Amount on the charge will be removed.
...
Datatype is Number
Default value is 'blank'.
Used for UPDATE only.
RECID
Datatype is Number.
Default value is 'blank'.
This is used only as a lookup key for Charge Updates.
...
Datatype is Boolean.
Default Value = is False.
Permitted Values: 1, Yes, and True sets the Prorate flag to True [1].
...
Datatype is Number.
Default is 'blank'.
This is used to specify the Service Record for Services that have a blank Service ID. If this is provided, the provided value must be a valid existing service RECID. If it is not, it will cause an error. The only Service Type permitted to have blank Service IDs is Other Services .
...
SERVICE_CHARGE_TYPE:
Default Value value is 'NONRECURRINGblank'.
This flag is only needed if there are multiple Charges with the same Names that have the different types.
If this is set, it must be set to the code of one of the CHARGE_TYPE List Values from the List Values grid.
The only allowed values are the System Use Values: MONTHLY_RECURRING, NONRECURRING, QUARTERLY, SEMI_ANNUAL, and ANNUAL_RECURRING.
...
If set, this import will UPDATE existing records. If the import cannot find an existing record to UPDATE, it will error.
...
EFFECTIVE_DATE:
Data type is String.
Default value is blankValue is TODAY.
Allowed values are BACKDATE and TODAY.
This is not a date field. Allowed values are: BACKDATE or TODAYflag is used to determine the date that an updated charge will stop and restart.
Alternate Recurring Charges (Quarterly, Semi-Annual and Annual), when updated, will always use BACKDATE as the Effective Date.
See the Notes for more details.
Errors
When an Import Line fails, it is usually because the Line falls into one of the following categories:
...
If an NRC has been billed, it cannot be updated in any way.
If an existing Monthly Recurring Charge has been billed, it can be updated. Changing then Updating the GLA, Amount, Quantity, or Prorate Flag, will stop the new existing Charge stops the previous Charge and create a new Charge record begins with the appropriate changes. The date of this stop and start is determined by the Effective Date flag. If this is set to 'TODAY', then it will used stop the existing charge with yesterday's date, and start the new charge with today's date. If it is set to 'BACKDATE', then it will use the date that the current existing charge has been billed through.