System Interface Specification

Edition 1.3.20

5/1/2020

1 / 25 Edition: 1.3.5
 Table of Contents

1. Abbreviations ........................................................................................................................4
2. Introduction to Interfaces ........................................................................................................6
2.1 Flow Chart...........................................................................................................................6
2.2 General Interfaces................................................................................................................6
2.2.1 Login Interface ..................................................................................................................6
2.2.2 Pre-Charge .......................................................................................................................9
2.2.3 Remote Recharge Interface..............................................................................................12
2.2.4 History............................................................................................................................16
2.2.5 Change Password ...........................................................................................................19
2.2.6 Transaction Report Interface ............................................................................................21
2.2.7 Global ............................................................................................................................32
1. Abbreviations
1P Single phase
3P Three phase
AES Advanced Encryption Standard
App Application
API An application programming interface (API) is an interface or communication
protocol between a client and a server intended to simplify the building of
client-side software
BERC Bangladesh Energy Regulatory Commission

BPDB Bangladesh Power Development Board” was created as a public sector

organization to boost the country’s power sector after the emergence of
Bangladesh as an independent state in 1972. The BPDB is responsible for
the major portion of generation and distribution of electricity mainly in urban
areas of the country. The Board is now under the Power Division of the
Bangladesh Ministry of Power, Energy and Mineral Resources.
DES The Data Encryption Standard is a symmetric-key algorithm for the
encryption of electronic data
DoS In computing, a Denial-of-Service attack is a cyber-attack in which the
perpetrator seeks to make a machine or network resource unavailable to its
intended users by temporarily or indefinitely disrupting services of a host
connected to the Internet
DPDC “Dhaka Power Distribution Company Limited” is a Public Limited Company
under the Power Division of the Ministry of Power, Energy and Mineral
Resources, Government of Bangladesh that manages the distribution of
electricity to the customers of the Dhaka City Corporation area
HTTP Hyper Text Transfer Protocol. HTTP is the underlying protocol used by the
World Wide Web and this protocol defines how messages are formatted and
transmitted, and what actions Web servers and browsers should take in
response to various commands
HTTPS Hypertext Transfer Protocol Secure is an extension of the Hypertext Transfer
Protocol. It is used for secure communication over a computer network, and
is widely used on the Internet
ISP Internet Service Provider
JSON type Java Script Object Notation (JSON) is an open-standard file format that uses
human-readable text to transmit data objects consisting of attribute–value
pairs and array data types (or any other serializable value). JSON is a
language-independent data format.
MD5 MD5 was initially designed to be used as a cryptographic hash function, it
has been found to suffer from extensive vulnerabilities
NBR National Board of Revenue is the central authority for tax administration in
Bangladesh
POS Point of Sales is the time and place where a retail transaction is completed
PPMS Prepayment metering system. It refers to the complete prepayment systems,
application/software, hardware, meters, modems and all other relevant items
as a whole for this project
REST Representational state transfer is a software architectural style that defines a
set of constraints to be used for creating Web services
SHA-1 SHA-1 is a cryptographic hash function which takes an input and produces a
160-bit hash value known as a message digest – typically rendered as a
hexadecimal number, 40 digits long
SSL Secure Sockets Layer
URL Uniform Resource Locator (URL), colloquially termed a web address, is a
reference to a web resource that specifies its location on a computer network
and a mechanism for retrieving it.
USSD “Unstructured Supplementary Service Data” is a Global System for Mobile
(GSM) communication technology that is used to send text between a mobile
phone and an application program in the network
UUID A universally unique identifier is a 128-bit number used to identify
information in computer systems
Web World Wide Web
2. Introduction to Interfaces
The prepayment metering system has 7 interfaces including Login, Get Customer Information,
Electricity Purchase, Remote Recharge, Balance Check, Historical Check, and Change Password. The
prepayment metering system (PPMS) provides an API of REST mode. The client determines types of
business according to the HTTP interface type. For example, interface: Login, URL: interface type of uri:
starpay/login, Method of Request: Post. Generally, input and return values of the interface are JSON
types. HTTP Status Code is used to indicate the status of the server. In general, the code “200” means
OK, “500” Internal Server Error, and “400” Bad Request.
The prepayment system will time stamp audit trails and log files. It also provides confidentiality and
integrity security protection of log files. Audit trails of all user actions are logged. In addition, all
information is available for reporting.
PPMS provides a third party management module that is to manage the new account, password, name,
time and status (For more information, please refer to KD-PQ-0011-User Manual of the Power Vending
System).
2.1 Flow Chart

2.2 General Interfaces

2.2.1 Login Interface
Function description
For third-party/ super vending super vendors will apply to the employer for third-party/ super vending.
After getting approval by BPDB/DPDC the customer can vend through approved third-party/ super
vendor. If the Super vendor is a general retailer the Star can provide a POS directly for energy sales; if
the Super-vendor is a bank or mobile operator, in that case, the PPMS will provide an API interface and
assigns the access account and security key.
Usage
 Conditions
The super-vendor will get an access Web-address from the system admin;
The super-vendor required to register in the system, and will receive name and password by email.
Method of POST
Request

URL http://ip:port/nesco/login

Name Type Description

Parameters app_name String Registration name

app_password String Registration password

postAuthCode String

Example {

"app_name":"pos",

"app_password":"123456",

"postAuthCode":"2316d133-4782-3c83-94fa-0d54530fba50"

Response
parameters Name Type Description
access_token String Authentication token
resultcode String Result code
resultdesc String Result description
balance String Balance
expires_in String Validity of token (seconds). It is a time period starting from
the moment when the user stops the last operation. When
beyond such time period, it is required to authenticate
again.
firstLogin Boolea Whether to log in for the first time
n
Example of // Succeed
Response
HTTP/1.1 200 OK

Content-Type: application/json;charset=UTF-8

"access_token":"eyJhbGciOiJIUzI1NiJ9.eyJzdGFyIjoiNzkwIiwiY3JlYXRlZCI6MTYwOT
 M4NDUwNjU5MiwibWF4RGF5IjoiMTYwOTM4NTAwNjU5MiIsImlwIjoiMTkyLjEyNS4xN
TUuMTQzIiwiZXhwIjoxNjA5Mzg1MTA2fQ.tPjyKwYq2tVDiBZWhF9Pc1Qx9IQqalx56cb
3Ua075l8"

"balance":"9177648.52",

"firstLogin":false,

"resultcode":"0",

"expires_in":"600000"

"resultdesc":"Succeed"

Exception

HTTP/1.1 400 Bad Request

Content-Type: application/json;charset=UTF-8

"resultcode":"1010004",

"resultdesc":"Invalid registration password"

Result code

Result code Description Solution

0 Success.
1010006 Incorrect Enter the correct registration name
username or
password

1010007 The account Contact with administrator

has been
locked.
1010008 Device
identification
code is empty

1010009 Device
identification
code is
incorrect

1010010 Invalid IP login

0000009 Redis not

 connected

1020004 Please enter

the instrument
number or
customer
number

0000002 Instrument
information
does not exist

1020003 Customer no
has been
locked

2.2.2 Pre-Charge
This function has been developed in order to confirmation of purchase before generate token that
prevent from any discrepancy of payment which is developed based on precharge code .
Conditions
 The purchase amount must be more than 0.
 The purchase amount keeps a decimal point at most.
 The total purchase amount must be less than the balance of the third party where the customer
purchases electricity.
 In the case of more than 1 token, it should be separated by a comma between each token.

Request POST
method

URL http://ip:port/starpay/nesco/preCharge

Request access_token:
Header eyJhbGciOiJIUzI1NiJ9.eyJzdGFyIjoiNzkwIiwiY3JlYXRlZCI6MTYwOTM4NDUwNjU5MiwibWF
4RGF5IjoiMTYwOTM4NTAwNjU5MiIsImlwIjoiMTkyLjEyNS4xNTUuMTQzIiwiZXhwIjoxNjA5
 Mzg1MTA2fQ.tPjyKwYq2tVDiBZWhF9Pc1Qx9IQqalx56cb3Ua075l8

Request
parameter
Name Type Description
customerNo String Customer Number
meterNo String Meter number
payinAmount String Amount of electricity purchase
Request {
example
"customerNo":"22189991742",

"meterNo":"",

"payinAmount":501

Response Name Type Description

parameter resultcode String Result code
resultdesc String Result description
data Object Data details
Data
newCurrencyError number Latest error amount
meterNo String
transactionId String
customerNo String
customerName String
fee Object Details of Electricity token : 3P Meter
rent(250/month), Error Amount, TAX,
Rebate(1%), Demand charge(25/kW), Last
Error, PFC, Paid Debt, VAT(5%)
Response // Succeed
example
HTTP/1.1 200 OK

Content-Type: application/json;charset=UTF-8

"data":{

"newCurrencyError":0,

"fee":{

"Energy Cost":"481.84",

"Monthly Rent(pp)(40/month)":"0.00",

"Demand Charge(30/kW)":"0.00",

"Purchase Amount":"501.00",
 "Rebate(1%)":"-4.72",

"PFC":"0.00",

"Last Error":"0.02",

"Paid Debt":"0.00",

"VAT(5%)":"23.86"

},

"meterNo":"22189991742",

"transactionId":"40fd1b0f76d164860176d1859bfe0008",

"customerNo":"22189991742",

"customerName":"22189991742"

},

"resultcode":"0",

"resultdesc":"Succeed"

Result code

Result code Description Solution

0 Success
404 No not found Account | Meter | Vending No not found

10001 User information does

not exist

10002 Single transaction is

less than:

10003 Failed to get charge

details

10004 Could not find cached

login information

10005 Please bind sales

station

10006 The recharge amount

exceeds the maximum

10007 The recharge amount

is less than the
 minimum value

10008 Third party

Low Balance
10017 Energy cost must be Actual top-up amount after charging
greater than 0 greater than 0

10024 Single transaction is

greater than:

10025 The device is not

installed and activated

2.2.3 Remote Recharge Interface

Function description
The system remotely sends the TOKEN to the meter and feedback the recharge result.
Usage
Request POST
method

URL http://ip:port/starpay/nesco/remoteCharge

Request access_token:
Header eyJhbGciOiJIUzI1NiJ9.eyJzdGFyIjoiNzkwIiwiY3JlYXRlZCI6MTYwOTM4NDUwNj
U5MiwibWF4RGF5IjoiMTYwOTM4NTAwNjU5MiIsImlwIjoiMTkyLjEyNS4xNTU
uMTQzIiwiZXhwIjoxNjA5Mzg1MTA2fQ.tPjyKwYq2tVDiBZWhF9Pc1Qx9IQqalx
56cb3Ua075l8

Request
parameter
Name Type Description
transactionId String Transaction Identification

Request {
example
"transactionId":"40fd1b0f76d164860176d1859bfe0008"

Response Name Type Description

parameter resultcode String Result code
resultdesc String Result description
data Object Data details
Data
orderNo String
 newCurrencyError number Latest error amount
meterNo String
orderDate String
customerName String
customerNo String
transactionId String
token String
fee Object Details of Electricity
token : 3P Meter
rent(250/month), Error
Amount, TAX,
Rebate(1%), Demand
charge(25/kW), Last
Error, PFC, Paid Debt,
VAT(5%)
Response // Succeed
example
HTTP/1.1 200 OK

Content-Type: application/json;charset=UTF-8

Success case 1:

"data":{

"orderNo":"506342316116217856",

"newCurrencyError":0.08,

"fee":{

"Monthly Rent(pp)(40/month)":0,

"Energy Cost":481.84,

"Demand Charge(30/kW)":0,

"Purchase Amount":501,

"Rebate(1%)":-4.72,

"PFC":0,

"Last Error":0.02,

"Paid Debt":0,

"VAT(5%)":23.86

},

"meterNo":"22189991742",

"orderDate":"05/01/2021 15:50:25",
 "customerName":"22189991742",

"customerNo":"22189991742",

"transactionId":"40fd1b0f76d164860176d1859bfe0008",

"token":"4003-5727-2451-7398-9173"

},

"resultcode":"0",

"resultdesc":"Succeed"

Success case 2:
{

"data":{

"orderNo":"506342316116217856",

"newCurrencyError":0.08,

"fee":{

"Monthly Rent(pp)(40/month)":0,

"Energy Cost":481.84,

"Demand Charge(30/kW)":0,

"Purchase Amount":501,

"Rebate(1%)":-4.72,

"PFC":0,

"Last Error":0.02,

"Paid Debt":0,

"VAT(5%)":23.86

},

"meterNo":"22189991742",

"orderDate":"05/01/2021 15:50:25",

"customerName":"22189991742",

"customerNo":"22189991742",

"transactionId":"40fd1b0f76d164860176d1859bfe0008",

"token":"4003-5727-2451-7398-9173"
 },

"resultcode":"10010",

"resultdesc":"Token send failed"

Exception

HTTP/1.1 400 Bad Request

Content-Type: application/json;charset=UTF-8

Failure case 1

"resultcode":"14003",

"resultdesc":"The Balance is not Enough ",

"data":{

"transactionId":"40fd1b0f76b6cab70176b6cd07600001"

Failure case 2

"resultcode":"10009",

"resultdesc":" Failed to generate token ",

"data":{

"transactionId":"40fd1b0f76b6cab70176b6cd07600001"

Result code

Result code Description Solution

0 Success
 10011 Transaction id invalid

10004 Could not find cached

login information

10009 Token create failed

Token send failed

10010
2.2.4 History
The super-vendor is able to query the Customer transaction information by Customer Number from the
PPMS.

Method of POST
Request

URL http://ip:port/starpay/nesco/getPurchaseRecord

Request access_token:
Header eyJhbGciOiJIUzI1NiJ9.eyJzdGFyIjoiNzkwIiwiY3JlYXRlZCI6MTYwOTM4NDUwNjU5Miwib
WF4RGF5IjoiMTYwOTM4NTAwNjU5MiIsImlwIjoiMTkyLjEyNS4xNTUuMTQzIiwiZXhwIjox
NjA5Mzg1MTA2fQ.tPjyKwYq2tVDiBZWhF9Pc1Qx9IQqalx56cb3Ua075l8

Request
parameter
Name Type Description
transactionId String Transaction Identification
Request {
example
"transactionId":"40fd1b0f76d164860176d1859bfe0008"

Response
parameter Name Type Description
resultcode String Result code
resultdesc String Result description
data Object Data details
Data
fee Object Details of Electricity token : 3P Meter
rent(250/month), Error Amount, TAX, Rebate(1%),
Demand charge(25/kW), Last Error, PFC, Paid
Debt, VAT(5%)
orderNo String
newCurrencyError Number
meterNo String
orderDate String
transactionId String
customerNo String
customerName String
token String
Example of // Succeed
Response
HTTP/1.1 200 OK

Content-Type: application/json;charset=UTF-8

"data":{

"orderNo":"506342316116217856",

"newCurrencyError":0.08,

"fee":{

"Monthly Rent(pp)(40/month)":0,

"Energy Cost":481.84,

"Demand Charge(30/kW)":0,

"Purchase Amount":501,

"Rebate(1%)":-4.72,

"PFC":0,

"Last Error":0.02,

"Paid Debt":0,

"VAT(5%)":23.86

},

"meterNo":"22189991742",

"orderDate":"05/01/2021 15:50:25",

"transactionId":"40fd1b0f76d164860176d1859bfe0008",

"customerNo":"22189991742",

"customerName":"22189991742",

"token":"4003-5727-2451-7398-9173"

},

"resultcode":"0",

"resultdesc":"Succeed"

}
Result code

Result code Description Solution

0 Success
10004 Could not find
cached login
information
10001 User
information
does not exist
10011 Transaction id
invalid

2.2.5 Change Password

Function description
The super-vendor is able to change the user account password.
Usage
Conditions
 The super-vendor requires to receive an access address from the Administrator of the system.
 The super-vendor requires to register and will get the new password.
 The password length is restricted to 100 characters at most. It might be a combination of
alphabetic, numeric and special symbols.
Method of POST
Request

URL http://ip:port/starpay/nesco/changePassword

Request access_token:
Header eyJhbGciOiJIUzUxMiJ9.eyJzdGFyIjoiMTY4IiwiY3JlYXRlZCI6MTU5MTA2MDk3NDMyNSwiZ
XhwIjoxNTkxMTQ3Mzc0fQ.y7PIcCox37ahlcxKeVHXKFPu3f4BRZbvCJgOZAeKkWiAdQ_6
mx-pf6mAxkjvawKnOJwNpOZPR0p-PKui4HXoUA

Request
parameter
Name Type Description
access_token String Authentication token
app_name String Registration name
app_old_passwor String Old password
d

app_new_passwr String New password

od

Request {
example "app_name": "pos",

"app_new_password": "000000",

"app_old_password": "123456"

Response
parameter Name Type Description
resultcode String Result code
resultdesc String Result description
Example of // Succeed
Response
HTTP/1.1 200 OK

Content-Type: application/json;charset=UTF-8

"resultcode":"0",

"resultdesc":"Succeed"

Exception

HTTP/1.1 400 Bad Request

Content-Type: application/json;charset=UTF-8

"resultcode":"10015",

"resultdesc":"Old password error"

Result code

Result code Description Solution

0 Success
10001 User
information
does not exist

10012 The query user

does not
match the
logged-in user

10013 Old password

is empty
 10014 New password
is empty

10004 Could not find

cached login
information

10015 Old password

error

10016 Password
change failed,
Abnormal
database
changes

2.2.6 Transaction Report Interface

Method of POST
Request

URL http://ip:port/starpay/nesco/transactionReport

Request access_token:
Header eyJhbGciOiJIUzUxMiJ9.eyJzdGFyIjoiMTY4IiwiY3JlYXRlZCI6MTU5MTA2MDk3NDMyNSwiZ
XhwIjoxNTkxMTQ3Mzc0fQ.y7PIcCox37ahlcxKeVHXKFPu3f4BRZbvCJgOZAeKkWiAdQ_6
mx-pf6mAxkjvawKnOJwNpOZPR0p-PKui4HXoUA

Request
parameter
Name Type Description
salesName String Name of selling point
startTime String Min time the past year
endTime String Max time the current time
Request {
example
"endTime":"05/01/2021 16:13:00",

"startTime":"04/01/2021 16:53:32"

}
Response
parameter Name Type Description
resultcode String Result code
resultdesc String Result description
data String The last Five Transactions
total Int Total number of data records
Data
orderNo String Work order number

custNo String Customer No

custName String Customer Name

meterNo String Meter No

saleName String Sale Name

purchaseEnergy Numb Electricity purchase

er

debtMoney Numb Debt amount

er

tax Numb Tax

er

mcostMoney Numb Total amount of management fee

er

subsidyMoney Numb Subsidy or Rebate

er

purchaseMoney Numb Power purchase amount

er

penaltyMoney Numb Penalty amount

er

totalMoney Numb Total payment amount = purchase amount + tax + management

er fee, etc. + fine + debt

purchaseDate String Purchase Date

newCurrencyError Numb New Currency Error

er

principleAmount Numb Pay amount-VAT

er
Example of // Succeed
Response
HTTP/1.1 200 OK

Content-Type: application/json;charset=UTF-8

"data":[

"custName":"22189991742",

"custNo":"22189991742",

"debtMoney":0,

"mcostMoney":0,

"meterNo":"22189991742",

"newCurrencyError":0.08,

"orderNo":"506342316116217856",

"penaltyMoney":0,

"principleAmount":477.14,

"purchaseDate":1609833025000,

"purchaseEnergy":108.15,

"purchaseMoney":481.84,

"saleName":"POS",

"subsidyMoney":-4.72,

"tax":23.86,

"totalMoney":501

},

"custName":"22189991742",

"custNo":"22189991742",

"debtMoney":0,

"mcostMoney":0,

"meterNo":"22189991742",

"newCurrencyError":0,
 "orderNo":"506329886335148032",

"penaltyMoney":0,

"principleAmount":477.14,

"purchaseDate":1609830062000,

"purchaseEnergy":108.14,

"purchaseMoney":481.82,

"saleName":"POS",

"subsidyMoney":-4.72,

"tax":23.86,

"totalMoney":501

},

"custName":"22189991742",

"custNo":"22189991742",

"debtMoney":0,

"mcostMoney":10,

"meterNo":"22189991742",

"newCurrencyError":0.02,

"orderNo":"506318336203399168",

"penaltyMoney":0,

"principleAmount":477.14,

"purchaseDate":1609827308000,

"purchaseEnergy":106.39,

"purchaseMoney":471.8,

"saleName":"POS",

"subsidyMoney":-4.72,

"tax":23.86,

"totalMoney":501

},

{
 "custName":"22189991742",

"custNo":"22189991742",

"debtMoney":0,

"mcostMoney":4.95,

"meterNo":"22189991742",

"newCurrencyError":0.05,

"orderNo":"506300313119727616",

"penaltyMoney":0,

"principleAmount":500,

"purchaseDate":1609823011000,

"purchaseEnergy":346.65,

"purchaseMoney":494.97,

"saleName":"POS",

"subsidyMoney":0,

"tax":0,

"totalMoney":500

},

"custName":"22189991742",

"custNo":"22189991742",

"debtMoney":0,

"mcostMoney":4.96,

"meterNo":"22189991742",

"newCurrencyError":0.08,

"orderNo":"506253085817638912",

"penaltyMoney":0,

"principleAmount":501,

"purchaseDate":1609811751000,

"purchaseEnergy":347.36,

"purchaseMoney":496.04,
 "saleName":"POS",

"subsidyMoney":0,

"tax":0,

"totalMoney":501

},

"custName":"22189991742",

"custNo":"22189991742",

"debtMoney":0,

"mcostMoney":0.5,

"meterNo":"22189991742",

"newCurrencyError":0,

"orderNo":"506037805761892352",

"penaltyMoney":0,

"principleAmount":50,

"purchaseDate":1609760424000,

"purchaseEnergy":49.5,

"purchaseMoney":49.5,

"saleName":"POS",

"subsidyMoney":0,

"tax":0,

"totalMoney":50

},

"custName":"22189991742",

"custNo":"22189991742",

"debtMoney":0,

"mcostMoney":0.5,

"meterNo":"22189991742",

"newCurrencyError":0,
 "orderNo":"506035529282424832",

"penaltyMoney":0,

"principleAmount":50,

"purchaseDate":1609759882000,

"purchaseEnergy":49.5,

"purchaseMoney":49.5,

"saleName":"POS",

"subsidyMoney":0,

"tax":0,

"totalMoney":50

},

"custName":"22189991742",

"custNo":"22189991742",

"debtMoney":0,

"mcostMoney":0.5,

"meterNo":"22189991742",

"newCurrencyError":0,

"orderNo":"506035117120753664",

"penaltyMoney":0,

"principleAmount":50,

"purchaseDate":1609759783000,

"purchaseEnergy":49.5,

"purchaseMoney":49.5,

"saleName":"POS",

"subsidyMoney":0,

"tax":0,

"totalMoney":50

},

{
 "custName":"22189991742",

"custNo":"22189991742",

"debtMoney":0,

"mcostMoney":0.5,

"meterNo":"22189991742",

"newCurrencyError":0,

"orderNo":"506029292427874304",

"penaltyMoney":0,

"principleAmount":50,

"purchaseDate":1609758395000,

"purchaseEnergy":49.5,

"purchaseMoney":49.5,

"saleName":"POS",

"subsidyMoney":0,

"tax":0,

"totalMoney":50

},

"custName":"22189991742",

"custNo":"22189991742",

"debtMoney":0,

"mcostMoney":0.5,

"meterNo":"22189991742",

"newCurrencyError":0,

"orderNo":"506007113640382464",

"penaltyMoney":0,

"principleAmount":50,

"purchaseDate":1609753107000,

"purchaseEnergy":49.5,

"purchaseMoney":49.5,
 "saleName":"POS",

"subsidyMoney":0,

"tax":0,

"totalMoney":50

},

"custName":"22189991742",

"custNo":"22189991742",

"debtMoney":0,

"mcostMoney":0.5,

"meterNo":"22189991742",

"newCurrencyError":0,

"orderNo":"506002476947447808",

"penaltyMoney":0,

"principleAmount":50,

"purchaseDate":1609752001000,

"purchaseEnergy":49.5,

"purchaseMoney":49.5,

"saleName":"POS",

"subsidyMoney":0,

"tax":0,

"totalMoney":50

},

"custName":"22189991742",

"custNo":"22189991742",

"debtMoney":0,

"mcostMoney":0.5,

"meterNo":"22189991742",

"newCurrencyError":0,
 "orderNo":"505998021816459264",

"penaltyMoney":0,

"principleAmount":50,

"purchaseDate":1609750939000,

"purchaseEnergy":49.5,

"purchaseMoney":49.5,

"saleName":"POS",

"subsidyMoney":0,

"tax":0,

"totalMoney":50

],

"resultcode":"0",

"resultdesc":"Succeed"

}
Result code

Result code Description Solution

0 Success
10018 Date format
conversion
error

10019 The start time

cannot be
greater than
the end time

10020 The start time

can only be in
the past year
10021 The start time
cannot be
greater than
the current
time

10022 The end time

cannot be
greater than
the current
time

10023 Sales Name is

empty

2.2.7 Global
Error code Error message Error description
0000003 The token is incorrect

0000004 The login IP is inconsistent with

the current access IP

0000007 Not obtained access_token The request has no

access_token
0000012 Continuous login time range Token expired and Maximum
exceeded login days exceeded,Need to log
in again to get access_token
0000013 Token expired, please replace The token has expired, but the
the old token maximum number of login days
 has not been exceeded

0000013 Error return format:

{
"data":"eyJhbGciOiJIUzI1NiJ9.eyJzdGFyIjoiNzkwIiwiY3JlYXRlZCI6MTYwOT
EzODAzMTYzNiwibWF4RGF5IjoiMTYwOTEzODMzMTYzNiIsImlwIjoiMTkyLjEyN
S4xNTUuMTQzIiwiZXhwIjoxNjA5MTM4MjExfQ.AAWb-
vo4Oh9yyfPdBGVyutvHwBiE9roJHDLlD3zuO4A",
"resultcode":"0000013",
"resultdesc":"Token expired, please replace the old token"
}

If the error code is 0000013 , Please replace the original token with data in the response data

Unknown service exception：

{
"code":"-1",
"msg":"Server error"
}