Tariscope 4.6.Tariscope API guide
Tariscope API Methods
5. subscriber.create
This is a POST request intended to create a new subscriber in the Tariscope database.
Request parameters:
- fullname – full name of a legal entity, individual, or employee of a communication operator.
- departmentid – identifier of the group to which the subscriber belongs. If subscribers are not divided into groups, then they belong to the root group, which has the same name as the communication node.
- subscribertype – subscriber type: 0 - individual, 1 - legal entity, 2 - official, 3 - budget, 4 - preferential.
- connectiondate - date from which the subscriber is considered connected in the format: yyyy-mm-dd.
- contactnumber – subscriber contract number.
- contractdate - contract date in the format: yyyy-mm-dd.
- accountnumber - subscriber personal account number, if it is not created automatically in Tariscope.
- personalcode – individual tax number for individuals.
- edrpou – EDRPOU code for legal entities.
- taxcode – tax code for VAT payers.
- bankcode – bank code for legal entities.
- bankname – bank name.
- bankaccount – bank account number.
- rateplanid – tariff plan identifier assigned to the subscriber.
If the request is executed correctly, the following data is returned:
При коректно виконаному запиті повертаються наступні дані:
- id – subscriber identifier in the system.
- accountnumber – subscriber’s personal account number. If it is created automatically in Tariscope, it will match id.
- fullname – full name of legal entity, individual, or employee of the telecommunications operator.
Example of a request.
Create a subscriber legal entity with the name JSC ABC, EDRPOU 55667788, TIN 123456789, with a connection date of 02.06.2023, with which a contract for the provision of communication services under number 247-23 was concluded on 01.06.2023.
This company is serviced by Kredobank, bank code 325365, bank account UA125438790123456.
This subscriber will be served under the 'Basic' tariff plan, which has the identifier 43 in Tariscope.
Include the subscriber in the subscriber group with identifier 419. Assign the subscriber a personal account 8640-fo.
http://localhost:8085/api/subscriber/create/?fullname=JSC ABC&departmentid=419&subscribertype=1&connectiondate=2023-06-02&contractnumber=247-23&contractdate=2023-06-01&accountnumber=8640-fo&personalcode=&edrpou=55667788&taxcode=&bankcode=361234&bankname=Кредобанк&bankaccount=UA125438790123456&rateplanid=43
