发票错误列表查询
系统相关界面
"界面路径:【新版发票管理】"
请求地址
环境 | 服务地址(HTTP/HTTPS) |
---|---|
V2正式环境(推荐) | https://gw.superboss.cc/router |
V2测试环境 | https://gw3.superboss.cc/router |
2022年4月1日以后申请的APP Key,统一使用V2正式环境的请求地址:https://gw.superboss.cc/router
公共参数
调用任何一个API都必须传入的参数,目前支持的公共参数有:
参数名称 | 参数类型 | 是否必须 | 参数描述 |
---|---|---|---|
method | string | 是 | API接口名称 |
appKey | string | 是 | 分配给应用的AppKey |
timestamp | string | 是 | 时间戳,时区为GMT+8,例如:2020-09-21 16:58:00。API服务端允许客户端请求最大时间误差为10分钟 |
format | string | 否 | 响应格式。默认为json格式,可选值:json |
version | string | 是 | API协议版本 可选值:1.0 |
sign_method | string | 否 | 签名的摘要算法(默认 hmac),可选值为:hmac,md5,hmac-sha256。 |
sign | string | 是 | 签名 |
session | string | 是 | 授权会话信息 (即access_token,由系统分配) |
请求头
全部展开
参数名
类型
描述
必填
Content-Type
string
application/x-www-form-urlencoded;charset=UTF-8
必填
API接口地址
全部展开
参数名
类型
描述
必填
method
string
fms.invoice.errorRecord.page
必填
请求参数
全部展开
参数名
类型
描述
必填
默认值
timeType
int
时间类型:1-生成发票时间,2-发货时间,3-交易成功时间
startTime
string
开始时间
endTime
string
结束时间
errorMsg
string
错误信息
errorMsgCode
string
错误原因编码,16表示必填项未填
pageNo
int
页 码
pageSize
int
页数
companyId
long
公司id
tidList
array
平台单列表
sidList
array
系统单列表
shopIdList
array
店铺id列表
请求示例
示例一:
{
"errorMsgCode":"16"
}
响应参数
全部展开
参数名
类型
描述
必填
success
boolean
示例:true
traceId
string
示例:4759439536627124977
total
int
示例:1
data
object
数据对象
total
int
示例:1
page
object
分页信息
startRow
int
示例:0
offsetRow
int
示例:1
pageNo
int
示例:0
pageSize
int
示例:1
list
array
数据列表
companyId
long
示例:1693
billingType
int
示例:1
createTime
long
示例:1751269510000
errorType
int
示例:0
updateTime
long
示例:1751269510000
shopId
long
示例:133477
createTimeStr
string
示例:2025-06-30 15:45:10
tid
string
示例:6943964959497065713
errorMsg
string
示例:发票备注必填项缺失身份证号、是否享受国补、补贴比例
sid
string
示例:5394845054687860
响应示例
{
"traceId": "4759439536627124977",
"data": {
"total": 1,
"page": {
"startRow": 0,
"offsetRow": 1,
"pageNo": 0,
"pageSize": 1
},
"list": [
{
"companyId": 1693,
"billingType": 1,
"createTime": 1751269510000,
"errorType": 0,
"updateTime": 1751269510000,
"shopId": 133477,
"createTimeStr": "2025-06-30 15:45:10",
"tid": "6943964959497065713",
"errorMsg": "发票备注必填项缺失身份证号、是否享受国补、补贴比例",
"sid": "5394845054687860"
}
]
},
"total": 1,
"success": true
}
异常示例
{
"traceId": "4071991477422416710",
"msg": "系统内部异常",
"code": "51075",
"success": false
}
错误码解释
错误信息 | 错误码 | 解决方案 |
---|---|---|
资源异常,请联系管理员! | 400 | 检查参数是否合法 |
非法参数! | 50 | 检查参数类型等是否合法 |
系统内部异常! | 51075 | 联系管理员 |