API customer EN

en | ru

Section API ERP "UserSide"

Purpose: Actions with users. Most actions are relevant for manual billing.

Additional parameters:
subcat - subcategory of the request (possible value: see below)

Subcategories

add

Modified in: 3.13.25 (added is_corporate parameter)

Description: Adding a user
Optional parameters:
 fio - name of the user
 codeti - user id in the billing system
 is_potential - flag - potential user
 is_corporate - flag - legal entity
 billing_id - billing id

abon_hist

Modified in: 3.17dev1 (excluded usercode parameter, added customer_id parameter)

Description: Display transactions with user (financial and other)
Obligatory parameters:
 usercode - (for version 3.16 and earlier)' user ID
 customer_id - (for version 3.17 and later) user ID

change_balance

Modified in: 3.16dev2 (removed operator_id parameter, added employee_id parameter)

Modified in: 3.13.22 (added operator_id parameter)

Description: Balance change (income/expense operation)
Obligatory parameters:
customer_id - user ID
 amount - Amount
 comment - operation notes
Optional parameters:
 employee_id - employee ID
 operator_id - operator ID (before version 3.16dev2)

change_billing

Modified in: 3.16.23 (added billing_user_id parameter)

Added in: 3.12.48

Description: Billing modification
Obligatory parameters:
 customer_id - user id
 billing_id - billing id
Optional parameters:
 billing_user_id - user id in billing

change_date_connect

Added in: 3.12.80

Description: Change the connection date
Obligatory parameters:
 customer_id - user ID
 value - date

delete

Added in: 3.14.21

Description: Deleting a user
Obligatory parameters:
 id - user ID

edit

Modified in: 3.16dev3 (added group_id parameter)

Modified in: 3.13.56 (added manager_id parameter)

Added in: 3.12rc2

Description: Editing a user
Obligatory parameters:
 id - user ID
Optional parameters:
 account_number - personal account number
 agreement_date - agreement date
 agreement_number - agreement number
 apartment_number - flat number
 comment - notes
 date_activity - date of network activity
 date_activity_inet - date of internet activity
 date_connect - date of connection
 email - email address
 entrance - entrance number
 flag_corporate - flag - legal entity
 floor - floor
 group_id - group id
 house_id - house id
 is_potential - flag - potential user
 login - login
 manager_id - id of manager employee
 name - name of user
 parent_id - id of parent user (for the child user)
 phone0 - mobile phone number
 phone1 - home phone number

get_activity_counter

Added in: 3.12.81

Description: Retrieve the counter of active users
Obligatory parameters:
 type - counter type (Possible values: net, internet, personal_area)

get_abon_id

Modified in: 3.14.34 (added possible account value for data_typer parameter)

Description: Retrieving of user ID from incoming data
Obligatory parameters:
 data_typer - type of data we are checking (possible values: account, billing_uid, codeti, dognumber, ip, login, mac, mail, phone)
 data_value - value
Optional parameters:
 is_skip_old - flag - do not search among former users

get_customers_id

Modified in: 3.16dev3 (added parameters name, limit, is_like)

Modified in: 3.15.26 (added is_ex parameter)

Modified in: 3.14.71 (added dependence_device_id parameter)

Modified in: 3.14.58 (added balance_from, balance_to, state_id parameters)

Modified in: 3.14.41 (added date_connect_from and date_connect_to parameters)

Modified in: 3.14.5 (added address_unit_id parameter)

Modified in: 3.13.48 (added tariff_id parameter)

Modified in: 3.13.35 (added mark_id parameter)

Added in: 3.12.8

Description: Retrieve list of user IDs by incoming conditions
Obligatory parameters:
 None
Optional parameters (but at least one condition must be specified):
 address_unit_id - address unit id
 appartment - number of the flat
 balance_from - balance (from)
 balance_to - balance (to)
 billing_id - billing number id
 date_connect_from - date of connection (from)
 date_connect_to - date of connection (to)
 dependence_device_id - id of the device the users depend on
 house_id - house id
 is_ex - flag - former users
 mark_id - mark id
 name - name/title of user
 state_id - status id
 tariff_id - tariff id
 limit - maximum number of records to return in the response
 is_like - flag - use substring comparison where possible (not a full match)

get_data

Description: Receiving user information
Obligatory parameters:
 customer_id - user ID