Page tree

Versions Compared

Key

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

...

(warning) At least customer accounts are required for the ACCOUNTS table.

Column

Description

ID

Account type identifier.

NAME

Account type name.

REMARK(green star) Note for proper matching selection.

In Hydra: Master Data → Reference Data → Account types.

...

(green star) Leave the table blank if you are not exporting the identity details of individual customers.

Column

Description

ID

Document type identifier.

NAME

Document type name.

REMARK(green star) Note for proper matching selection.

In Hydra: Master Data → Reference Data → ID types.

...

(green star) Leave the table blank if you are not exporting settlement (current) accounts и payments history.

Column

Description

ID

Bank identifier.

NAME

Bank name.

REMARK(green star) Note for proper matching selection.

In Hydra: Master Data → Banks.

...

(green star) Leave the table blank if you are not exporting extended comments to customers or to their equipment.

Column

Description

ID

Comment type identifier.

NAME

Comment type name.

REMARK(green star) Note for proper matching selection.

In Hydra: Master Data → Reference Data → Comment types.

...

(warning) At least one currency is required, which is used for payments and charges on customer accounts.

Column

Description

ID

Currency identifier.

NAME

Currency name.

REMARK(green star) Note for proper matching selection.

In Hydra: Master Data → Reference Data → Currencies.

...

(warning) At least primary groups required.

Column

Description

ID

Group identifier.

NAME

Group name.

REMARK(green star) Note for proper matching selection.

In Hydra: Master Data → Groups → Subject group type: Customer.

...

(warning) At least two statuses are required: for active and disconnected customers customers.

Column

Description

ID

Status identifier.

NAME

Status name.

REMARK(green star) Note for proper matching selection.

In Hydra: Master Data → Customers → Status.

...

(lightbulb) Specify only the types of customer equipment if you are not exporting its connections to the provider equipment.

Column

Description

ID

Equipment type identifier.

NAME

Equipment type name.

REMARK(green star) Note for proper matching selection.

In Hydra: Master Data → Product Catalog → Material assets.

...

(green star) Leave the table blank if there is only one firm in your Hydra (single-division setup).

Column

Description

ID

Division identifier.

NAME

Division name.

REMARK(green star) Note for proper matching selection.

In Hydra: Master Data → Organizational Structure.

...

(warning) At least Customer Self-Care Portal is required.

Column

Description

ID

Network service identifier.

NAME

Network service name.

REMARK(green star) Note for proper matching selection.

In Hydra: Equipment → Network Services.

...

Anchor
payment_types
payment_types

PAYMENT_TYPES —

...

payment types

(green star) Leave the table blank if you are not exporting payments history at all or are only exporting real payments and do not want to separate them by type (the common type from the migration application settings will be used).

Column

Description

ID

Payment type identifier.

NAME

Payment type name.

VIRTUALY for virtual types and N — for real ones.
REMARK(green star) Note for proper matching selection.

In Hydra:

  • Master Data → Reference Data → Virtual payments.
  • Master Data → Reference Data → Real payments.

...

(green star) Leave the table blank if you are not exporting the contact numbers of individuals and organizations to a separate CUSTOMER_PHONES table.

Column

Description

ID

Phone number purpose identifier.

NAME

Phone number purpose name.

REMARK(green star) Note for proper matching selection.

In Hydra: Master Data → Reference Data → Address purposes.

...

(warning) At least current customers price plans and their additional recurrent services are required if you are not exporting the charges history.

Column

Source of values

Description

ID


Product identifier.

NAME


Product name.

TYPE
Y for price plans, N — for the rest.
UNIT_IDUNITS.ID

Measurement unit identifier for quantitative services from the UNITS table.

Must correspond to the measurement unit of the respective Hydra product catalog item.

(green star) If the unit is not specified Hydra product catalog (dash), leave the field blank.

REMARK
(green star) Note for proper matching selection.

In Hydra:

  • Master Data → Product Catalog → Price plans.
  • Master Data → Product Catalog → Services.
  • Master Data → Product Catalog → Adjustments.

...

(green star) Leave the table blank if you are not exporting CPE's connections to the provider equipment for inventory or AAA purposes (e.g. DHCP Option 82 based IPoE authentication).

Column

Source of values

Description

ID


Equipment identifier.

EQUIPMENT_TYPE_IDEQUIPMENT_TYPES.IDEquipment type identifier.

CODE


Equipment code. Used for automatic matching.

IP
(green star) Equipment IPv4 address of Actual address purpose. Can be used for automatic matching instead of code.
FIRM_IDFIRMS.ID

Firm identifier for multi-division Hydra setup.

(green star) Leave the table blank if there is only one firm in your Hydra (single-division setup).

REMARK
(green star) Note for proper matching selection.

In Hydra: Equipment → Active Equipment.

...

(green star) Leave the table blank if you are not exporting street addresses to separate CUSTOMER_STREET_ADDRESSES and EQUIPMENT_STREET_ADDRESSES tables.

Column

Description

ID

Street address purpose identifier.

NAME

Street address purpose name.

REMARK(green star) Note for proper matching selection.

In Hydra: Master Data → Reference Data → Address purposes.

...

(green star) Leave the table blank if you are not exporting quantitative services.

Column

Description

ID

Measurement unit identifier.

NAME

Measurement unit name.

REMARK(green star) Note for proper matching selection.

In Hydra:

  • Master Data → Reference Data → Units of measurement.
  • Master Data → Reference Data → Time measurement units.
  • Master Data → Reference Data → Units of information.
  • Master Data → Reference Data → Data rate units.

...

Info

As a rule, each entry in this table corresponds to a single independent customer. If you need to combine multiple customers within a common basic subject (individual or organization), in addition to separate entries for each customer, export entries for their base subject, linking them to each other via PARENT_ID. In this case, the IDs of customers must be positive, and IDs of basics subjects must be negative.


ColumnSource of valuesDescription

ID


(warning) Customer (or basic subject when exported separately) identifier.

Subscribers must have positive identifiers, while basic subjects (individuals and organizations) must have negative identifiers.

STATUS_ID

CUSTOMER_STATUSES.ID

(warning) Customer status identifier. Basic subjects are always created in the Active status.

PARENT_IDCUSTOMERS.ID

Basic subject identifier when exported separately.

(green star) Leave blank for automatic generation of basic subjects and linking customers to them.

CODE


(warning) Customer code — a unique short name that identifies the customer. It is the default login for the Customer Self-Care Portal and network services.

ORGANIZATION


(warning) Y for organizations and N — for individuals.

NAME


(warning) Name of individual or name of organization.

SECOND_NAME

(green star) Middle name of an individual, leave blank for organization.

SURNAME

(green star) Last name of an individual, leave blank for organization.

ADDRESS


The actual street address of an individual or organization in the format <locality_name> <locality_type>,<street_name> <street_type>,<building>,<entrance>,<floor>,<apartment>,<intercom>

If some details are missing, leave only commas. For example: London City,Baker Street,221,2,,1,123

The house number can be supplemented with the corpus number: London City,Baker Street,221 Corpus B,2,,1,123

(green star) Leave blank if you are exporting these addresses to a separate CUSTOMER_STREET_ADDRESSES table.

ADDRESS_REMARK

Actual street address remark.

(green star) Leave blank if you are exporting these addresses to a separate CUSTOMER_STREET_ADDRESSES table.

AUTH_DOC_TYPE_ID

AUTH_DOC_TYPES.ID

(green star) Identity document identifier for individuals. Leave blank for organizations.

AUTH_DOC_SERIAL


(green star) Identity document serial number for individuals. Leave blank for organizations.

AUTH_DOC_NUMBER


(green star) Identity document number for individuals. Leave blank for organizations.

AUTH_DOC_DATE


(green star) Identity document date of issue for individuals in the format DD.MM.YYYY. Leave blank for organizations..

AUTH_DOC_ISSUING_AUTHORITY


(green star) Identity document issuer for individuals. Leave blank for organizations.

BIRTH_DATE

(green star) Date of birth of an individual in the format DD.MM.YYYY. Leave blank for organizations.

BIRTH_PLACE

(green star) Place of birth of an individual. Leave blank for organizations.

TAX_ID_NUMBER


(green star) Taxpayer identification number (Tax ID).

LEGAL_FORM_CODE


Code or name of the legal form. For example: SP or Sole proprietor, LLC or Limited liability company.

All variants must be configured in Hydra beforehand: Master Data → Reference Data → Business entity types.

(green star) Leave blank for regular individuals with no legal status.

W_PHONE


Contact work phone number in E.164 format: no spaces, hyphens, plus signs, or parentheses — only digits. You can specify multiple numbers by separating them with commas.

(green star) Leave blank if you are exporting phones to a separate CUSTOMER_PHONES table.

H_PHONE


Contact home phone number in E.164 format: no spaces, hyphens, plus signs, or parentheses — only digits. You can specify multiple numbers by separating them with commas.

(green star) Leave blank if you are exporting phones to a separate CUSTOMER_PHONES table.

M_PHONE


Contact mobile phone number in E.164 format: no spaces, hyphens, plus signs, or parentheses — only digits. You can specify multiple numbers by separating them with commas.

(green star) Leave blank if you are exporting phones to a separate CUSTOMER_PHONES table.

EMAIL


(green star) Contact email address. You can specify multiple addresses, separating them with commas.

FIRM_ID

FIRMS.ID

Firm identifier for multi-division Hydra setup.

(green star) Leave the table blank if there is only one firm in your Hydra (single-division setup).

REMARK
(green star) Brief note to the customer (or to the basic subject in the case of separate export).

Anchor
customer_group_binds
customer_group_binds

...

(warning) Each customer must be a member of at least one group.

ColumnSource of valuesDescription
ID
(warning) Group binding identifier.
CUSTOMER_IDCUSTOMERS.ID(warning) Customer identifier.
GROUP_IDCUSTOMER_GROUPS.ID(warning) Group identifier.
PRIMARY

(warning) Y for the primary group, N for additional ones.

Each customer must have only one primary group.

REMARK
(green star) Not used in the current version, leave blank.

Anchor
customer_comments
customer_comments

...

(green star) Multipart notes to customers, categorized by type, will be available on the Comments tab of the customer page in Hydra.

ColumnSource of valuesDescription
ID
(warning) Comment identifier.
CUSTOMER_IDCUSTOMERS.ID(warning) Customer identifier.
COMMENT_TYPE_IDCOMMENT_TYPES.ID(warning) Comment type identifier.
COMMENT_TEXT

(warning) Comment text. Use the ¶ character to separate lines in the text.

CREATED_DATE
(warning) Date and time of comment in format DD.MM.YYYY HH24:MI:SS.
REMINDER_DATE
(green star) Date and time of comment reminder in format DD.MM.YYYY HH24:MI:SS.
EXECUTION_DATE
(green star) Date and time of comment execution in format DD.MM.YYYY HH24:MI:SS.

Anchor
customer_mappings
customer_mappings

...

(green star) To be filled in only for the migration of additional details to previously created customers.

ColumnSource of valuesDescription
CUSTOMER_IDCUSTOMERS.ID

(warning) Exported customer identifier.

Primary key in this table: only one record is possible here for each exported subscriber..

CUSTOMER_DST_CODE
(warning) The code of the target customer in Hydra to whom the exported accounts, contracts, equipment, and subscriptions need to be added.
REMARK
(green star) Not used in the current version, leave blank.

Anchor
customer_phones
customer_phones

...

If you don't need notes and the standard purposes (Work, Home, Mobile) are sufficient — leave this table empty and use W_PHONEH_PHONE, and M_PHONE columns of the CUSTOMERS table instead.

ColumnSource of valuesDescription
ID
(warning) Contact phone number identifier.
CUSTOMER_IDCUSTOMERS.ID

(warning) Customer identifier.

When exporting customers and basic subjects separately — the identifier of the basic subject.

PHONE_TYPE_IDPHONE_TYPES.ID(warning) Contact phone number purpose identifier.
PHONE
(warning) Contact phone number in E.164 format: no spaces, hyphens, plus signs, or parentheses — only digits.
REMARK
(green star) Brief note to the contact phone number.

Anchor
customer_street_addresses
customer_street_addresses

...

If one actual street address in simplified format is sufficient, leave this table blank and use ADDRESS and ADDRESS_REMARK columns of the CUSTOMERS table instead.

ColumnSource of valuesDescription
ID
(warning) Street address identifier.
CUSTOMER_IDCUSTOMERS.ID

(warning) Customer identifier.

When exporting customers and basic subjects separately — the identifier of the basic subject.

ADDRESS_PURPOSE_IDSTREET_ADDRESS_PURPOSES.ID

(green star) Street address purpose identifier, if you are populating the STREET_ADDRESS_PURPOSES table. It's considered Actual address by default.

DISTRICT
(green star) A federal district that includes a locality. The region type in Hydra is District with the code REGION_TYPE_District.
CITY
(warning) Locality name. Region's code in Hydra registry of regions. For example: San Francisco.
CITY_TYPE

(warning) Full or short name of the type of locality. For example: City, Town, Set. or Settlement.

All variants must be configured in Hydra beforehand: Master Data → Reference Data → Region types.


STREET
(warning) Street name. Region's code in Hydra registry of regions. For example: Line Wall, Baker, Trafalgar.
STREET_TYPE
(warning) Full or short name of the type of street. For example: Rd. or Road, St. or Street, Sq. or Square.

All variants must be configured in Hydra beforehand: Master Data → Reference Data → Region types.

HOUSE

These four columns collectively define the building:

  • HOUSE — house number,
  • BUILDING — corpus (pavilion),
  • CONSTRUCT — annex (structure),
  • OWNERSHIP — ownership (property).

(warning) At least one of the values must be filled in, otherwise the address will not be migrated.

BUILDING
CONSTRUCT
OWNERSHIP
ENTRANCE
(green star) Building entrance.
FLOOR
(green star) Номер этажа, должен быть числом.
FLAT
(green star) The floor number, numeric value.
INTERCOM_CODE
(green star) Intercom code.
CUSTOM_ADDRESS
(green star) The unstructured part of the equipment location address. For example: third door on the left.
REMARK
(green star) Brief note to the address.

Anchor
accounts
accounts

ACCOUNTS — accounts of customers and basic subjects

(warning) Each customer must have at least one customer account in order to render services: an electronic wallet in the billing system, to which payments are credited and funds are debited for the provision of services.

ColumnSource of valuesDescription

ID


(warning) Account identifier.

CUSTOMER_ID

CUSTOMERS.ID

(warning) Customer identifier. When exporting customers and basic subjects separately — the identifier of the basic subject.

ACCOUNT_NUMBER


(warning) Account number

Should be unique.

ACCOUNT_TYPE_ID

ACCOUNT_TYPES.ID

(warning) Account type identifier.

CURRENCY_ID

CURRENCIES.ID

(warning) Currency identifier.

BANK_ID

BANKS.ID

(green star) Bank identifier of the settlement (current) account, leave blank for customer accounts.

BALANCE


(green star) Personal account balance. Leave blank for a settlement account.

A positive value indicates a deposit has been made, while a negative value indicates there is outstanding debt.

CREDIT


(green star) Customer account credit limit, leave blank if not required.

Positive values only.

CREDIT_END_DATE


(green star) The date and time when the credit limit expires, in DD.MM.YYYY HH24:MI:SS format. Leave blank if there is no credit limit or if it is permanent.

BALANCE_DATE


(warning) Date and time of customer account balance calculation, in DD.MM.YYYY HH24:MI:SS format. For settlement accounts, populate with current date and time.

The migrated closing balance will differ by the difference between PAYMENTS table and CHARGES table entries that occurred after the specified date.

REMARK
(green star) Brief note to the account.

Anchor
contracts
contracts

CONTRACTS — service agreements

(warning) Each customer must have at least one contract in order to render services.

ColumnSource of valuesDescription
ID
(warning) Contract identifier.
CUSTOMER_IDCUSTOMERS.ID(warning) Customer identifier.
CONTRACT_NUMBER

(warning) Contract number.

Should be unique.

SIGNATURE_DATE
(warning) Date of contract signing, in DD.MM.YYYY format.
START_DATE

(warning) The start date of the contract period, in DD.MM.YYYY format.

This usually is the same as the date of signing.

END_DATE

(green star) The end date of the contract validity period (termination date), in DD.MM.YYYY format.

For current contracts, this is usually not specified: the contract is valid indefinitely until terminated on purpose.

REMARK
(green star) Brief note to the contract.

Anchor
equipment
equipment

EQUIPMENT — customer premises equipment (service providing points)

...

The necessity of certain technical requirements depends on the configured integrations with external services and hardware, i.e. the specifics of customer authorization and service access management.

ColumnSource of valuesDescription
ID
(warning) Customer equipment identifier.
CUSTOMER_IDCUSTOMERS.ID(warning) Customer identifier.
EQUIPMENT_TYPE_IDEQUIPMENT_TYPES.ID(warning) Customer equipment type identifier.
PROVIDER_EQUIPMENT_IDPROVIDER_EQUIPMENT.ID

(green star) Provider equipment identifier (e.g., network switch or OLT) to which the CPE must be binded to.

Leave blank if binding is not required.

PROVIDER_EQUIPMENT_PORT_CODE

(green star) Provider equipment component code (e.g., port number).

Leave blank if the CPE binding should be to the provider equipment itself, rather than to its component (port).

PROVIDER_EQUIPMENT_PORT_TYPE

(green star) The code of provider equipment component type, i.e. specification item of the provider equipment type.

Leave blank if the provider equipment components has unique codes.

CODE
(warning) Customer equipment code, i.e. its short unique name
MAC

(green star) CPE hardware address, in XX-XX-XX-XX-XX-XX or XX:XX:XX:XX:XX:XX format.

Must be individual (unicast). You can specify multiple addresses by separating them with commas.

IP

(green star) IPv4 address, or IPv4 subnet in CIDR notation. For example: 128.66.125.125 or 128.66.25.48/29.

You can specify multiple addresses by separating them with commas.

IP6

(green star) IPv6 subnet. For example: 2001:db8:7df5::/64.

You can specify multiple subnets by separating them with commas.

PHONE

(green star) The phone number to which calls should be billed in E.164 format: no spaces, hyphens, plus signs, or parentheses — only digits. For example: 17607339969.

You can specify multiple phone numbers by separating them with commas.

VLAN
(green star) Not used in the current version, leave blank.
ADDRESS

The service providing street address in the format <locality_name> <locality_type>,<street_name> <street_type>,<building>,<entrance>,<floor>,<apartment>,<intercom>

If some details are missing, leave only commas. For example: London City,Baker Street,221,2,,1,123

The house number can be supplemented with the corpus number: London City,Baker Street,221 Corpus B,2,,1,123

(green star) Leave blank if you are exporting these addresses to a separate EQUIPMENT_STREET_ADDRESSES table.

ADDRESS_REMARK

Service providing street address remark

(green star) Leave blank if you are exporting these addresses to a separate EQUIPMENT_STREET_ADDRESSES table.

REMARK
(green star) Brief note to the CPE.

Anchor
equipment_comments
equipment_comments

...

(green star) Multipart notes to CPE (service providing points), categorized by type, will be available on the Comments tab of the customer equipment in Hydra.

ColumnSource of valuesDescription
ID
(warning) Comment identifier.
EQUIPMENT_IDEQUIPMENT.ID(warning) Customer equipment identifier.
COMMENT_TYPE_IDCOMMENT_TYPES.ID(warning) Comment type identifier.
COMMENT_TEXT

(warning) Comment text. Use the ¶ character to separate lines in the text.

CREATED_DATE
(warning) Date and time of comment in format DD.MM.YYYY HH24:MI:SS.
REMINDER_DATE
(green star) Date and time of comment reminder in format DD.MM.YYYY HH24:MI:SS.
EXECUTION_DATE
(green star) Date and time of comment execution in format DD.MM.YYYY HH24:MI:SS.

Anchor
equipment_street_addresses
equipment_street_addresses

...

If one service street address in simplified format is sufficient, leave this table blank and use ADDRESS and ADDRESS_REMARK columns of the EQUIPMENT table instead.

ColumnSource of valuesDescription
ID
(warning) Street address identifier.
EQUIPMENT_IDEQUIPMENT.ID

(warning) Customer equipment identifier.

ADDRESS_PURPOSE_IDSTREET_ADDRESS_PURPOSES.ID

(green star) Street address purpose identifier, if you are populating the STREET_ADDRESS_PURPOSES table. It's considered Service address by default.

DISTRICT
(green star) A federal district that includes a locality. The region type in Hydra is District with the code REGION_TYPE_District.
CITY
(warning) Locality name. Region's code in Hydra registry of regions. For example: San Francisco.
CITY_TYPE

(warning) Full or short name of the type of locality. For example: City, Town, Set. or Settlement.

All variants must be configured in Hydra beforehand: Master Data → Reference Data → Region types.

STREET
(warning) Street name. Region's code in Hydra registry of regions. For example: Line Wall, Baker, Trafalgar.
STREET_TYPE
(warning) Full or short name of the type of street. For example: Rd. or Road, St. or Street, Sq. or Square.

All variants must be configured in Hydra beforehand: Master Data → Reference Data → Region types.

HOUSE

These four columns collectively define the building:

  • HOUSE — house number,
  • BUILDING — corpus (pavilion),
  • CONSTRUCT — annex (structure),
  • OWNERSHIP — ownership (property).

(warning) At least one of the values must be filled in, otherwise the address will not be migrated.

BUILDING
CONSTRUCT
OWNERSHIP
ENTRANCE
(green star) Building entrance.
FLOOR
(green star) Floor number, numeric value.
FLAT
(green star) The number of the office, apartment or other premises.
INTERCOM_CODE
(green star) Intercom code.
CUSTOM_ADDRESS
(green star) The unstructured part of the equipment location address. For example: third door on the left.
REMARK
(green star) Brief note to the address.

Anchor
customer_net_service_binds
customer_net_service_binds

...

(green star) Leave the table blank if you do not want to provide customers with access to the customer portal, and no credentials (i.e. usernames and passwords) needed for Hydra to manage access to services.

ColumnSource of valuesDescription
ID
(warning) Network services subscription (application access) identifier.
CUSTOMER_IDCUSTOMERS.ID(warning) Customer identifier.
NETWORK_SERVICE_IDNETWORK_SERVICES.ID(warning) Network service identifier.
EQUIPMENT_IDEQUIPMENT.ID

Customer equipment identifier.

(green star) Leave blank for Customer Self-Care Portal access and notification service subscriptions.

(warning) Be sure to populate this for all subscriptions to external services provisioned by Hydra (e.g., PPPoE or SIP).

LOGIN

Login (username). Must be unique within the network service (application).

(green star) Leave blank if no login is required, for example for subscribing to notifications.

PASSWORD

Password in plain text. In test exports, you can specify the same stub value for all of them for security reasons..

(green star) Leave blank if no password is required, for example for subscribing to notifications.

PASSWORD_HASH_TYPE
(green star) Not used in the current version, leave blank.
REMARK
(green star) Not used in the current version, leave blank.

Anchor
subscriptions
subscriptions

...

(lightbulb) It is sufficient to export only current and future subscriptions; charges history migration does not use these subscriptions.

ColumnSource of valuesDescription
ID
(warning) Subscription identifier.
ACCOUNT_IDACCOUNTS.ID(warning) Customer account identifier.
CONTRACT_IDCONTRACTS.ID(warning) Contract identifier.
PRODUCT_IDPRODUCTS.ID

(warning) Product (i.e. service or price plan) identifier.

Only recurrent services can be subscribed to.

EQUIPMENT_IDEQUIPMENT.ID

Customer equipment (i.e. service providing point) identifier.

(warning) Must be specified for all services provisioned by Hydra.

(green star) It is recommended to specify equipment for unmanaged services as well, so that the service is at least linked to the service address, but you can leave it blank for them.

START_DATE
(warning) The date and time when the subscription started, in DD.MM.YYYY HH24:MI:SS format, i.e. when the customer ordered this product.
END_DATE

Subscription end date and time in DD.MM.YYYY HH24:MI:SS format, i.e. when the service should end.

(green star) Leave blank for current services and they will be provided indefinitely until disconnected on purpose.

(lightbulb) If the price plan change is scheduled in the future: in subscription to the plan, specify the date and time of its end; and in subscription to the new one, specify only the date and time of its start (one second after the end of the old one).


QUANTITY

The quantity of the service ordered in the PRODUCTS.UNIT_ID unit of measurement.

This is a multiplier for the price of the service. For example, to render two STBs rent fee at $20 each, set 2 as quantity and the subscription fee will then be 2 × $20 = $40.

(green star) Leave blank for products with no unit of measurement.

BILLING_DATE

Fixed monthly billing date — a natural number from 1 to 28. For business subscribers it's usually 1, i.e. billing periods are strictly tied to calendar months.

(green star) Leave blank if the billing date should vary, i.e. determined by the date when a charge log is issued for a service. This mode is typically used for residential customers.

REMARK
(green star) Not used in the current version, leave blank.

Anchor
charges
charges

CHARGES — charges history and current billing periods

...

(green star) As a rule, it is sufficient to export charges history from the beginning of the current year in order to make financial reports from a single billing system. The charges history migrates “as is” in the form of archived charge logs, i.e. no historical price specifications and subscriptions required for this.

ColumnSource of valuesDescription
ID
(warning) Charge identifier.
ACCOUNT_IDACCOUNTS.ID(warning) Customer account identifier.
CONTRACT_IDCONTRACTS.ID(warning) Contract identifier.
CHARGE_DATE

(warning) Date and time of charge (funds debited from the customer account) in DD.MM.YYYY HH24:MI:SS format.

During migration, it will be matched with ACCOUNTS.BALANCE_DATE to determine the final balance of the customer account.

As a rule, it's identical to either start or end date of the billing period, however may differ. Must be within the billing period.

PRODUCT_IDPRODUCTS.ID

(warning) Product identifier, i.e. the price plan, additional service, or adjustment this charge is for.

EQUIPMENT_IDEQUIPMENT.ID

Customer equipment identifier. For current billing periods, it must match the one specified for this service in SUBSCRIPTIONS.EQUIPMENT_ID.

(green star) You can leave this blank for the billing history if there is no need to link it to specific service providing points.

AMOUNT

(warning) Total amount (not price) charged for the service in the currency of the customer account for the entire billing period, multiplied by 100.

Negative values are only allowed for adjustments that increase the balance of the customer account, e.g. refunds.

CHARGING_PERIOD_START_DATE

(warning) The start date and time of the billing period in DD.MM.YYYY HH24:MI:SS format.

The time part for regular recurrent services is usually 00:00:00, i.e. midnight. For instant one-time services and balance adjustments, this should be equal to CHARGE_DATE value.

CHARGING_PERIOD_END_DATE
(warning) The end date and time of the billing period in DD.MM.YYYY HH24:MI:SS format.

The time part for regular recurrent services is usually 23:59:59, i.e. the very last second of the day. For instant one-time services and balance adjustments, this should be equal to CHARGE_DATE value.


QUANTITY

The quantity of the service rendered in the PRODUCTS.UNIT_ID unit of measurement, multiplied by 100.

(green star) Leave blank for products with no unit of measurement.

REMARK
(green star) Brief note to the charge.

Anchor
payments
payments

PAYMENTS — payments history

(green star) As a rule, it is sufficient to export payment history from the beginning of the current year in order to make financial reports from a single billing system.

ColumnSource of valuesDescription
ID
(warning) Payment identifier.
ACCOUNT_IDACCOUNTS.ID(warning) Customer account identifier.
BANK_IDBANKS.ID(warning) Bank identifier, i.e. source of the payment.
TRANSACTION_DATE

(warning) Payment date and time in DD.MM.YYYY HH24:MI:SS format.

During migration, it will be matched with ACCOUNTS.BALANCE_DATE to determine the final balance of the customer account.

PAYMENT_AMOUNT
(warning) The payment amount in the currency of the customer account, multiplied by 100.
PAYMENT_TYPE_IDPAYMENT_TYPES.ID

Payment type identifier.

(green star) Leave blank if only exporting real payments and do not want to separate them by type — the common type from the migration application settings will be used.

REMARK
(green star) Brief note to the payment.