Build - the name of the maintenance release build the change was introduced in.

Service - the name of the service/services which is/are affected.

Method - the name of the method/methods which is/are affected.

Message - the message that explains what was changed.

Schema changed - shows whether it is required to rebuild WSDL/XSD-generated stubs for .net, Java and other static typing languages.

TT - a link to a ticket related to the change.



BuildServiceMethodMessageSchema changedBackward compatibleTT
MR69-0

Customer

get_customer_info,

get_customer_list

Add 'generate_invoice_earlier' field to ScheduledCustomerStatusChangeInfo structureNoYesYT:BA-13774
MR69-0CallControloriginate_advanced_callMake tag non-mandatory, it's never returned in response of orignate_advanced_callYesYesYT:BA-13752
MR69-0Payment

list_processors

get_processor

Added field name to response in struct PaymentProcessorYesYesYT:BA-13297
MR69-0Invoiceregenerate_invoice_list

Added new regenerate_invoice_list() method.

This method enables an API user to regenerate a list of invoice PDF files

YesYesYT:BA-11874
MR69-0Customerget_generated_xdrs_filemethod was removedYesNoYT:BA-9248
MR69-0Customerget_customer_xdrsremoved 'asynchronous_mode' input parameterYesNoYT:BA-9248
MR69-0Accountget_generated_xdrs_filemethod was removedYesNoYT:BA-9248
MR69-0Accountget_xdr_listremoved 'asynchronous_mode' input parameterYesNoYT:BA-9248
MR69-0User

get_user_info

get_user_list

add_user

update_user

Added option auto_redirect_to_foreign to UserInfoYesYesYT:BA-13291
MR69-0Accountget_subscriptionsExtended Account->get_subscriptions() API method to return 'i_account' field in every 'AccountSubscriptionInfo' structureNoYesYT:BA-13952
MR69-0DIDassign_did_to_owner_batchRaise fault instead of returning success property in case action failedNoNoYT:BA-13418
MR69-0IPTV

get_channel_package_list

get_service_package_list

Added new Service IPTV with methods get_channel_package_list() and get_service_package_list()

These methods enables an API user to get the list of IPTV channel and service packages imported into PortaBilling

YesYes

YT:BA-14042

MR69-0RoutingPlan

add_routing_plan,

update_routing_plan,

get_routing_plan_info,

get_routing_plan_list

Adjusted mentioned methods to work with 'rp_connection_list' (the field is related ro routing override feature)YesYesYT:BA-13814
MR69-0Invoicereview_invoice_listadded "postponed" input parameterYesYesYT:BA-13247
MR69-0**Used more strict validation for URLs (hostnames)NoNoYT:BA-12857
MR69-0

Account

Customer

Payment

make_transaction

make_tax_transaction

Max length of internal comment reduced from 230 to 200YesYesYT:BA-13433
MR69-0Product

add_group

update_group

Added group_info to response in case used detailed_response as input parameterYesYesYT:BA-14006
MR69-0Account

enable_api_notifications

disable_api_notifications

Allow specifying account alias in CC API requestsNoYesYT:BA-1994
MR69-0CallControl

originate_call

get_sip_call_list


Allow specifying account alias in CC API requestsNoYesYT:BA-1994
MR69-0Paymentget_payment_transaction_list 

Make 'object' and 'i_object' input filters of get_payment_transaction_list() are not mandatory for admin realm.

Add 'i_customer_type' input filter to the mentioned method

YesYesYT:BA-14059
MR69-0

Customer

Account

Payment

register_transaction

register_transaction

register_transaction, get_payment_transaction_list

Covered methods with ACL object Payment_TransactionsNoYesYT:BA-14273
MR69-0CallBarringget_call_barring_class_list

Added the following input filters:

'matching_type', 'number'

YesYesYT:BA-14501
MR69-0Bitcoin*All methods are covered with ACLNoYesYT:BA-14124
MR69-0CustomFields

get_custom_field_info

get_custom_field_list

Added field is_used to CustomFieldsInfoYesYesYT:BA-14089
MR69-0CustomFields

get_custom_field_list

Added input params name, object, check_usage, type, mandatory, visible_to_end_user to get_custom_field_list methodYesYesYT:BA-14089
MR69-0CustomFields

add_custom_field

update_custom_field

delete_custom_field

get_custom_field_info


Added methods add_custom_field, update_custom_field, delete_custom_field, get_custom_field_infoYesYesYT:BA-14089
MR69-0CustomFields*Covered all the methods with ACLsNoYesYT:BA-14089
MR69-0Productget_product_list

Adjust the following filters of the mentioned method:

iso_4217, name, search.

From now '%' and '_' symbols in these filters won't be escaped on the method level.

If you need the previous behaviour - please escape these symbols manually before sending them in a request.

NoNoYT:BA-14420
MR69-0DialingRuleget_dialing_rules_list

Added one more possible value (IO) for the 'usage_type' input filter.

In case when 'IO' 'usage_type' filter is sent, the method should return entities with both incoming and outgoing usage types in the response.

NoYesYT:BA-14609
MR69-0TaxationPlugin

get_tax_plugins_list,

get_tax_plugin

Added check_usage to get_tax_plugins_list and get_tax_plugin methods

Added is_used to TaxPluginInfo

YesYesYT:BA-14007
MR69-0TaxationPlugin

set_tax_plugin_parameters,

get_tax_plugin_parameters_metainfo

Added method set_tax_plugin_parameters (external) and get_tax_plugin_parameters_metainfo (internal). To reset plugin parameter value send empty value in 'value' field of parameter structYesYesYT:BA-14007
MR69-0TaxationPlugin

get_tax_transaction_code_list

Extended method get_tax_transaction_code_list input args with:

  • plugin_code
  • with_plugin_codes
  • code
  • description
  • get_total
  • limit
  • offset

Added plugin_code_list to TaxTransactionCode

YesYesYT:BA-14007
MR69-0TaxationPlugin

get_tax_transaction_code_info,

add_tax_transaction_code,

update_tax_transaction_code,

delete_tax_transaction_code

Added methods to manage with tax transaction code information

YesYesYT:BA-14007
MR69-0CallBarring*Covered CallBarring service methods with ACLsNoYesYT:BA-14600
MR69-0TaxationPlugin*Covered TaxationPlugin service methods with ACLsNoYesYT:BA-14170
MR69-0ServicePolicyarrange_policies_priorityAdded new method arrange_policies_priorityYesYesYT:BA-14489
MR69-0ServicePolicyget_service_policy_list

Add new input fields in the GetServicePolicyListRequest:

  • check_usage
  • i_apply_level
YesYesYT:BA-14489
MR69-0ServicePolicyget_attribute_listAdd new input field i_apply_level in the GetServicePolicyAttributeListRequestYesYesYT:BA-14489
MR69-0ServicePolicy

add_service_policy

get_service_policy_info

get_service_policy_list

Add new field i_apply_level in the ServicePolicyInfoYesYesYT:BA-14489
MR69-0ServicePolicyget_service_policy_listAdd new field is_used in the ServicePolicyInfoYesYesYT:BA-14489
MR69-0ServicePolicy*id field in the ServicePolicyInfo marked as obsoleteYesYesYT:BA-14489
MR69-0ServicePolicy*match_priority field can be updated using arrange_policies_priority method and only for policies with i_apply_level=1NoYesYT:BA-14489
MR69-0Account

make_transaction

change_password

Removed 'chk' API ACL field, added required permission for default account ACLYesYesYT:BA-12771
MR69-0Customer

make_transaction

make_tax_transaction

Removed 'chk' API ACL field, added required permission for default retail ACLYesYesYT:BA-12771
MR69-0Accountget_sip_statusAdded new field 'additional_sip_info_list" for GetSipStatusResponseYesYesYT:BA-13945
MR69-0Productget_product_list

Added 'get_total' field to the reqeust of the mentioned method.

From now this method returns 'total' in the response only by 'get_total' in the request.

YesNoYT:BA-14826
MR69-0CallControl

get_sip_call_list

API notifications

Added forwarder_list to SipCallInfo, changed the way of sending notification about forwarded calls: in case no actual account_id in DialogInfo used the first id in forwarder listYesYesYT:BA-14787
MR69-0Vendor

get_connection_list,

get_connection_info

Extended get_connection_list and get_connection_info API methods to return vendor_name in the ConnectionInfo structure.

NoYesYT:BA-15063
MR69-0DIDget_number_list

Extended 'get_number_list' method to take 'number_list' input field in the request.

This field can contain an array of objects with 'i_did_number' field.

Such changes enable an API user to fetch a list of DID numbers by their i_did_number.

Extended 'get_number_list' method to take 'format' input field with possible values: csv, xls and xlsx.

In a case when format is present, the method will return a file with did numbers in the appropriate file format.

YesYesYT:BA-10719
MR69-0DIDupload_did_numbersImplemented upload_did_numbers methodYesYesYT:BA-10719
MR69-0Accountget_xdr_listThe mentioned method was extended to return 'i_rate' field of every XDR in the responseNoYesYT:BA-14235
MR69-0CustomerClass

add_customer_class,

update_customer_class,

get_customer_class_info,

get_customer_class_list

The mentioned methods were extended to work with 'use_external_billing', 'reset_customer_balance' and 'hide_reset_balance_xdr' customer class DB fieldsYesYesYT:BA-14407
MR69-0ServicePolicy

add_service_policy,

update_service_policy,

get_attribute_list

Adjusted the behaviour of the mentioned methods.
From now 'possible_values' of the boolean attributes are [0,1] instead of ['Yes', 'No'].

If affects the values that are returned by get_attribute_list() for boolean value_type.
Also, a boolean attribute value can be equal to 0 or 1 in the requests of add_service_policy() and update_service_policy() methods.

NoNoYT:BA-15148
MR69-0**

The validation of the 'ip_filter' field was adjusted.

From now it's possible to specify a netmask in the field.

Both following formats are supported from now:
192.168.192.0/24 or 192.168.192.0/255.255.255.0

Affected methods: add_customer, update_customer, add_user, update_user

Affected API types: CustomerInfo, UserInfo

NoYesYT:BA-15129
MR69-0**Returned back the ACL object and attributes for fields addon_effective_from && addon_effective_to of structure ProductInfoNoNoYT:BA-15197
MR69-0SessionlogoutIts requires to send a hash instead of plan session_id using SOAP APINoNoYT:BA-15899
MR69-1**

The following fields are no longer mandatory:

  • 'name' in TaxPluginInfo;
  • 'description', 'code' in TaxTransactionCode.
NoYesYT:BA-15275
MR69-1**

The following fields are no longer mandatory:

  • 'payment_method' in AccountPaymentMethodInfo;
  • 'i_account', 'type' in CPConditionInfo;
  • 'destination', 'i_dest' in DestinationPrefixInfo;
  • 'i_env' in EnvInfo;
  • 'description', 'i_oli', 'oli' in OliInfo;
  • 'payment_method' in PaymentMethodInfo;
  • 'i_tariff', 'name' in TariffInfo;
  • 'xdr_type' in CustomerXDRInfo;
  • 'name', 'external_id', 'type' in IPTVChannelPackage;
  • 'name', 'external_id' in IPTVServicePackage.
NoYesYT:BA-15280
MR69-1**Returned back the ACL object and attributes for fields addon_effective_from && addon_effective_to of structure ProductInfoNoNoYT:BA-15197
MR69-1BillingSessiondisconnect_sessionImplemented 'disconnect_session' methodYesYesYT:BA-14530
MR69-1Invoicereview_invoiceAdded 'postponed' input parameterYesYesYT:BA-14852
MR69-1ServicePolicyget_service_policy_listApplied LIKE search pattern to match_pattern filterNoNoYT:BA-15137
MR69-1DialingRule

get_dialing_rule_info,

get_dialing_rules_list

Extended mentioned methods to return 'is_default' field in the DialingRuleInfo structureNoYesYT:BA-10496
MR69-1**Extend AuxXDRInfo XSD type to contain 'xdr_time' fieldNoYesYT:BA-13866
MR69-1Destinationget_destination_list

Extended 'get_destination_list' method to take 'destination_list' input field in the request.

This field can contain an array of objects with 'i_dest' field.

Such changes enable an API user to fetch a list of destinations by their i_dest.

YesYesYT:BA-14904
MR69-1Rateget_rate_listThe behaviour of the get_rate_list API method was adjusted a little.

Removed default filter '"discontinued":"N"' in case of '"effective_from":"now"'.
From now rates with both ( discontinued == 'Y' ) && ( discontinued == 'N' ) are returned in '"effective_from":"now"' mode.

To have the previous behaviour please send additional '"discontinued":"N"' filter manually in the request on the method.
NoNoYT:BA-10840
MR69-1Services*Attribute 'i_st_charge_unit' permissions is checked for 'rating_base' attributeNoNoYT:BA-15434
MR69-1BillingSessionget_active_sessions_listImplemented 'get_active_sessions_list' methodYesYesYT:BA-14616
MR69-1DIDcancel_did_assignmentAdded input parameter dont_release_to_pool to allow keeping DID assigned to customerYesYesYT:BA-15054
MR69-1

Account

Customer

get_custom_fields_schema

Added new types for responses from this methods: AccountCustomFieldsInfo and CustomerCustomFieldsInfo. Responses will use Account_Custom_Fields and Customer_Custom_Fields ACL objects respectively

'is_used' and 'object' fields were removed from responces of this methods

YesNoYT:BA-14963
MR69-1Templateget_template_listAdded the input parameter 'name' for searching templates by nameYesYesYT:BA-14684
MR69-1Template

*

Covered methods and type TemplateInfo with ACL object 'Templates'YesYesYT:BA-14701
MR69-1DIDget_vendor_batch_listExtend the mentioned method to return entities usage status ('is_used' field) if the 'check_usage' field is equal to '1' in the method request.YesYesYT:BA-13600
MR69-1Destination*
  • Extended get_destination_list() method to return spreadsheet attachment with destinations by 'file_format' input field (Possible values: 'csv', 'xls', 'xlsx').

  • Implemented get_default_destination_list() method that returns spreadsheet attachment with default destination set.

  • Removed unpublished download_destinations() method. The functionality of this method is covered by get_destination_list() and get_default_destination_list() methods from now.
YesYesYT:BA-15501
MR69-1IVRApplicationsget_ivr_application_info

Added the 'i_block_attr' and 'i_parent' fields  to the response, which establish dependencies between IVR options(unique id of a record - parent record)

NoYesYT:BA-13969
MR69-1AccessRoleget_access_role_list

Added 'with_usage' field to the method request.

YesYesYT:BA-15704
MR69-1DIDget_number_list

Added 'activation_cost' and 'activation_revenue' fields to the DIDNumberInfo structure in the method response.

The fealds are returned only in case if 'with_extended_info' attribute is true in the method request.

YesYesYT:BA-15050
MR69-1DiscountPlan

get_discount_plan_info,

get_discount_plan_list

The mentioned methods are extended to return 'is_complete' field in the DiscountPlanInfo structure.

These methods return the field only if the 'check_complete_status' input method attribute is true.

YesYesYT:BA-15793
MR69-1DID_Provider

get_countries_list

*

Prefix not more mandatory in DIDCountryInfo

area_name and country_iso can be nil in struct DIDRequestParameters

YesYesYT:BA-14678
MR69-1NumberPortingadd_netnumber_infoAdded 'add_netnumber_info' methodYesYesYT:BA-15038
MR69-1SessionlogoutIts requires to send a hash instead of plan session_id using SOAP APINoNoYT:BA-15899
MR69-1Tariff

add_tariff

update_tariff

get_tariff_info

get_tariff_list

Field 'volume_based' was removed from input parameters and TariffInfo output type

Yes
YT:BA-15177
MR69-1IVRApplicationsget_voice_application_listAdded 'get_voice_application_list' methodYesYesYT:BA-15709
MR69-1IVRApplicationsget_ivr_application_list

Added the following input filters:

'name', 'i_voice_application', 'description', 'number_pattern', 'with_callbacks'

YesYesYT:BA-15706
MR69-1DialingRuletest_translation_ruleChanged validation of the parameter 'string'. Now it allows only digits, the '*' and '#' signs, the '-' sign or spaces as digits separator, the '+' sign in the initial position and Latin letters A-D, a-d.YesNoYT:BA-15531
MR69-1IVRApplicationsclone_ivr_applicationAdded new method 'clone_ivr_application' that enables an API user to clone the IVR application.YesYesYT:BA-15737
MR69-1

Account

Customer

add_account

update_account

validate_account_info

add_customer

update_customer

validate_customer_info

add_subreseller

Changed validation of the 'country' field. Now it allows only ISO 3166-1 alpha-2 to be used as the 'country' field value. If some wrong codes have already been used, they will be allowed on condition that user do not change them.YesNoYT:BA-15372
MR69-1BillingSessionget_active_sessions_list

Several changes were made to ActiveSessionInfo type:

  • field 'on_net' was added;
  • types of fields 'hotlined', 'is_disconnectable' were changed to 'int'.
YesNoYT:BA-16067
MR69-1Account

activate_subscriptions
add_account
add_account_advanced (internal)
add_account_with_topup (internal)
add_alias
add_allowed_location
add_auto_payment
add_cp_condition
add_cp_rule
add_followme_number
add_phonebook_record
add_preferable_account
add_subscription
arrange_cp_rules
arrange_followme_numbers
assign_sim_card
assign_ua
assign_ua_advanced (internal)
charge_subscription_fees
delete_account (internal)
delete_alias
delete_auto_payment
delete_cp_condition
delete_payment_method
estimate_call_price
estimate_taxes
generate_accounts
get_account_state
get_alias_list
get_allowed_addons (internal)
get_allowed_location_list
get_auto_payment_info
get_booths (internal)
get_call_barring_options
get_cp_condition_list
get_cp_rule_list
get_custom_fields_schema
get_custom_fields_values
get_full_vd_counter_info
get_member_of_huntgroups_list
get_moh_list_info
get_payment_method_info
get_permitted_sip_proxies_info
get_phonebook_list
get_preferable_account_list
get_service_features
get_service_wallet_xdr_list
get_services_consumption
get_sip_status
get_subscriptions
get_transactions_total_info
get_used_location_list
get_vd_counter_list
make_transaction
move_account
release_sim_card
release_ua
set_account_state
terminate_account
topup_account
update_account
update_account_followme
update_alias
update_auto_payment
update_booth (internal)
update_call_barring_options
update_cp_condition
update_payment_method
update_subscription
vd_topup

Added alter-ego context auto-detection support to described methodsNoYesYT:BA-15101
MR69-1Customer

activate_subscriptions
add_abbreviated_dialing_number
add_auto_payment
add_batch
add_customer_extension
add_customer_huntgroup
add_customer_site
add_subscription
charge_subscription_fees
close_billing_period
delete_customer
delete_customer_extension
delete_payment_method
estimate_taxes
get_abbreviated_dialing_number_list
get_account_aliases_list
get_accounts_subscriptions (internal)
get_auto_payment_info
get_call_barring_options
get_callqueue_list
get_credit_limit_history
get_custom_fields_schema
get_custom_fields_values
get_custom_xdr_report
get_custom_xdr_report_list
get_customer_billing_periods_history
get_extensions_list
get_full_vd_counter_info
get_huntgroup_list
get_metrics_data
get_moh_list_info
get_number_sequence_info (internal)
get_payment_method_info
get_rt_tickets_list
get_service_features
get_service_wallet_xdr_list
get_services_consumption
get_sites
get_status_history
get_subscriptions
get_taxation_info
get_transactions_total_info
get_vd_counter_list
make_tax_transaction (internal)
make_transaction
modify_spending_limit
suspend_customer
terminate_customer
unsuspend_customer
update_call_barring_options
update_customer
update_customer_advanced (internal)
update_number_sequence (internal)
update_payment_method
update_service_features
update_subscription
update_taxation
vd_topup

Added alter-ego context auto-detection support to described methodsNoYesYT:BA-15101
MR69-1Destination

get_dest_group_set_list,

get_dest_group_set_info

The mentioned methods were extended to return the 'is_set_empty' field in every DestGroupSetInfo response structure if the 'check_set_emptiness' field in the request set to 1.YesYesYT:BA-16174
MR69-1Paymentget_payment_transaction_list

Adjust the method 'to_date' input filter to search transactions exactly by thedatetimeprovided in the field.

Before these changes, back-end side added 24 hours to the provideddatetimetimestamp and only that performed search.

NoNoYT:BA-12704
MR69-1UAget_ua_profile_list

Add 'get_total' flag to the 'GetUAProfileListRequest' structure.

'total' field will be returned only if 'get_total' flag is passed.


YesNoYT:BA-15687
MR69-1Invoiceget_invoice_listThe mentioned method was extended to have two additional filters in the request: issued_after and issued_before.YesYesYT:BA-15585
MR69-1ServicePolicyarrange_policies_priorityRemoved 'arrange_policies_priority' method (method was added in MR69-0)YesNoYT:BA-15683
MR69-1ServicePolicyget_service_policy_listRemoved 'i_apply_level' input field (field was added in MR69-0)YesNoYT:BA-15683
MR69-1ServicePolicyget_attribute_listRemoved input field 'i_apply_level' from GetServicePolicyAttributeListRequest (field was added in MR69-0)YesNoYT:BA-15683
MR69-1ServicePolicy

add_service_policy

get_service_policy_info

get_service_policy_list

Removed 'i_apply_level' field from ServicePolicyInfo (field was added in MR69-0)YesNoYT:BA-15683
MR69-1ServicePolicy*'match_priority' field can be set/updated using add_service_policy/update_service_policy methods for any service policy (removed restriction, added in MR69-0)NoYesYT:BA-15683
MR69-1UAget_ua_profile_listAdded new 'effective_at' input field to the request of the mentioned method.YesYesYT:BA-16212
MR69-1DialingRuletest_translation_ruleAdded new 'is_ivr_tr_rule' input field. If it passed then translation rule will be checked using python regular expression syntaxYesYesYT:BA-12085
MR69-1CustomerClass

update_taxation,

get_taxation_info

Extended update_taxation() method to take 'i_tax_transaction_code' and 'estimate_taxes' fields in the method request.

Extended get_taxation_info() method to return 'i_tax_transaction_code' and 'estimate_taxes' fields in the method response.

YesYesYT:BA-16240
MR69-1Customer

update_taxation,

get_taxation_info

Extended update_taxation() method to take 'i_tax_transaction_code' and 'estimate_taxes' fields in the method request.

Extended get_taxation_info() method to return 'i_tax_transaction_code' and 'estimate_taxes' fields in the method response.

YesYesYT:BA-16445
MR69-1Subscriptionget_subscription_list

The 'search' filter of the mentioned method was adjusted.

From now '%' and '_' symbols in this filter won't be escaped on the method level.

If you need the previous behaviour - please escape these symbols manually before sending them in a request.

NoNoYT:BA-15390
MR69-1Paymentadd_merchant
  1. From now the 'i_online_payment_processor' field is always taking into account in the 'merchant_account' input object (before these changes the field was ignored if '"remittance":1' was present in the request)
  2. Removed 'remittance' field from the method request,

From now the method automatically determines whether the adding processor is remittance by 'i_online_payment_processor' field in the 'merchant_account' input object.

YesYesYT:BA-16764
MR69-1DIDadd_numberExtended response to return warning_list; Allowed to specify i_group while adding DID numberYesYesYT:BA-15769
MR69-1Representative

get_xdr_list
get_transactions_total_info

ACL object was changed from "WebForms" to "XDR_Representatives"YesNoYT:BA-16663
  • No labels