接口文档 - 星云税融API

订购产品

为企业订购指定产品

登录查看报价

POST https://shuiwu.xingyunv2.cn/api/v1/proxy/subscription/create

请求参数

参数名	类型	必填	说明
nsrsbh	String	是	纳税人识别号（企业税号），15/17/18/20位
aggOrgName	String	是	企业名称，需与税务局登记名称一致
dq	String	是	地区编码，见地区码附录
productCodeList	String	是	产品码列表，英文逗号分隔，见产品码附录

请求示例

JSON

{
    "nsrsbh": "91430103MADFYUHT72",
    "aggOrgName": "长沙市天心区智健益丰大药房（个人独资）",
    "dq": "43",
    "productCodeList": "0053"
}

响应参数

参数名	类型	说明
code	String	SUCCESS=成功
data.aggOrgId	Integer	企业唯一标识ID，需保存用于后续接口
data.purchaseDetailList	Array	各产品订购结果详情

响应示例

JSON

{
    "reqId": "c835d3478de34f17b479e269fe96c826",
    "code": "SUCCESS",
    "success": true,
    "message": "",
    "data": {
        "aggOrgId": 510700005344,
        "purchaseDetailList": [
            {
                "productCode": "0002",
                "success": true,
                "message": "订购成功"
            },
            {
                "productCode": "0003",
                "success": false,
                "message": "订购失败"
            },
            {
                "productCode": "0020",
                "success": true,
                "message": "订购成功(已订购)"
            }
        ]
    }
}

订购修改

修改已有订购信息

登录查看报价

POST https://shuiwu.xingyunv2.cn/api/v1/proxy/subscription/modify

请求参数

参数名	类型	必填	说明
aggOrgId	Integer	是	企业id
aggOrgName	String	是	企业名称
dq	String	是	地区，见附录地区代码
nsrsbh	String	否	税号（已废弃，不支持修改）

请求示例

JSON

{
    "aggOrgId": 452681066557440,
    "aggOrgName": "XXX公司",
    "dq": "31"
}

响应参数

参数名	类型	说明
reqId	String	请求id，由服务器端生成的唯一标识
code	String	错误码
success	Boolean	是否成功标记
message	String	错误信息
data.aggOrgId	Integer	企业id
data.purchaseDetailList	Array	订购详情

响应示例

JSON

{
    "reqId": "c835d3478de34f17b479e269fe96c826",
    "code": "SUCCESS",
    "success": true,
    "message": "",
    "data": null
}

订购取消

取消产品订购

登录查看报价

POST https://shuiwu.xingyunv2.cn/api/v1/proxy/subscription/cancel

请求参数

参数名	类型	必填	说明
aggOrgId	Integer	是	企业id
productCodeList	String	是	产品码列表，英文逗号分割，见附录产品码

请求示例

JSON

{
    "aggOrgId": 452681066557440,
    "productCodeList": "0002,0003,0020"
}

响应参数

参数名	类型	说明
reqId	String	请求id，由服务器端生成的唯一标识
code	String	错误码
success	Boolean	是否成功标记
message	String	错误信息
data.aggOrgId	Integer	企业id
data.cancelDetailList	Array	取消详情列表
data.cancelDetailList[].productCode	String	产品码
data.cancelDetailList[].success	Boolean	是否成功
data.cancelDetailList[].message	String	结果信息

响应示例

JSON

{
    "reqId": "c835d3478de34f17b479e269fe96c826",
    "code": "SUCCESS",
    "success": true,
    "message": "",
    "data": {
        "aggOrgId": 452681066557440,
        "cancelDetailList": [
            {
                "productCode": "0002",
                "success": true,
                "message": "取消成功"
            },
            {
                "productCode": "0003",
                "success": false,
                "message": "取消失败"
            },
            {
                "productCode": "0020",
                "success": true,
                "message": "取消成功(无此订购产品)"
            }
        ]
    }
}

订购查询

查询订购状态

登录查看报价

POST https://shuiwu.xingyunv2.cn/api/v1/proxy/subscription/query

请求参数

参数名	类型	必填	说明
aggOrgId	String/Integer	是	企业ID

请求示例

JSON

{
    "aggOrgId": 452681066557440
}

响应参数

参数名	类型	说明
code	String	SUCCESS=成功
data	Array	订购列表，含aggOrgId、productCodeList、nsrsbh、aggOrgName、dq

响应示例

JSON

{
    "reqId": "c835d3478de34f17b479e269fe96c826",
    "code": "SUCCESS",
    "success": true,
    "message": "",
    "data": [
        {
            "aggOrgId": 452681066557440,
            "productCodeList": "0002,0003,0020,0021",
            "nsrsbh": "91xxxxxxxxxxxxx",
            "aggOrgName": "XXX公司",
            "dq": "6100"
        }
    ]
}