查询企业是否黑名单

1、接口描述

根据企业全名/统一社会信用代码查询企业征信。 查询是否异常，以及经营异常、严重违法、重大税收违法风险的三个标志和列表。

2、接口地址

POST /v1/HMD/isHmd  HTTP/1.1

3、请求参数

• 参数说明

请求参数为JSON格式。

• 示例参数

{
  "qyName": "湖南长沙XX有限公司"
}

4、返回结果

• 返回结果

返回结果为JSON格式。

示例返回结果：
{
    "result": {
        "req_id": "5946d92322fe4e0192cf0275e518b517",
        "success": true,
        "time": 1819,
        "timestamp": 1632662721581
    },
    "value": {
        "qyName": "湖南长沙XX有限公司",
        "isHmd": true,
        "jyycFlag": 1,
        "yzwfFlag": 1,
        "zdsswfFlag": 1,
        "jyycList": [
            {
                "total": 2,
                "items": [
                    {
                        "outReason": "-",
                        "regNo": "430102000312822",
                        "outDate": "-",
                        "province": "HUNAN",
                        "inDate": "2018-07-09",
                        "name": "湖南长沙XX有限公司",
                        "disabled": "0",
                        "inReason": "未按照规定报送年度报告",
                        "department": "长沙市工商行政管理局芙蓉分局"
                    },
                    {
                        "outReason": "-",
                        "regNo": "430102000312822",
                        "outDate": "-",
                        "province": "HUNAN",
                        "inDate": "2018-07-08",
                        "name": "湖南长沙XX有限公司",
                        "disabled": "1",
                        "inReason": "未按照规定报送年度报告",
                        "department": "长沙市工商行政管理局芙蓉分局"
                    }
                ]
            }
        ],
        "yzwfList": {
            "execution": [
                {
                    "in_department": "湖南省市场监督管理局",
                    "out_department": "-",
                    "in_date": "2019-07-30",
                    "in_reason": "被列入经营异常名录届满3年仍未履行相关义务",
                    "out_date": "-",
                    "out_reason": "-"
                }
            ]
        },
        "zdsswfList": {
            "total": 1,
            "items": [
                {
                    "created_time": "2019-04-09",
                    "updated_time": "2019-04-09",
                    "agent": "-",
                    "address": "湖南省经济技术开发区承德南路266号6#楼322室",
                    "illegal_fact": "经江苏省淮安市国家税务局稽查局检查，发现其在2015年12月01日至2016年05月31日期间，主要存在以下问题：对外虚开增值税销项发票150份，金额1408.00万元，税额239.00万元。",
                    "url": "http://hd.chinatax.gov.cn/xxk/action/GetArticleView1.do?op=xxkweb&id=234642",
                    "result": "依照《中华人民共和国税收征收管理法》等相关法律法规的有关规定，对其处以罚款0.01万元的行政处罚，并依法移送司法机关。",
                    "credit_no": "91320891MA1MC20690",
                    "name": "湖南长沙XX有限公司",
                    "property": "虚开增值税专用发票或者虚开用于骗取出口退税、抵扣税款的其他发票",
                    "oper": "史桂,男",
                    "time": "2017-03-01",
                    "org_no": "A1MC2069",
                    "finance_officer": "-"
                }
            ]
        }
    }
}

• 字段说明

5、错误码

查询企业是否黑名单（增强版）

1、接口描述

根据企业名/统一社会信用代码查询企业征信。 查询企业基本信息，是否异常，以及经营异常、严重违法、重大税收违法风险的三个标志和列表。

2、接口地址

POST /v1/HMD/isHmdxx  HTTP/1.1

3、请求参数

• 参数说明

请求参数为JSON格式。

• 示例参数

{
  "qyName": "湖南长沙XX有限公司"
}

4、返回结果

• 返回结果

返回结果为JSON格式。

示例返回结果：
{
    "result": {
        "req_id": "5946d92322fe4e0192cf0275e518b517",
        "success": true,
        "time": 1819,
        "timestamp": 1632662721581
    },
    "value": {
        "qyName": "湖南长沙XX有限公司",
        "nsrsbh": "91430100MA4QEN94XX",
        "historyNames": [],
        "actualCapi": "-",
        "address": "上海市奉贤区新林路1111号第2幢第3间",
        "endDate": "-",
        "econKind": "个人独资企业",
        "termEnd": "-",
        "title": "投资人",
        "checkDate": "2018-11-27",
        "revokeDate": "-",
        "type": "01",
        "tags": [],
        "revokeReason": "",
        "termStart": "-",
        "orgNo": "xxxxxxx",
        "registCapi": "100 万人民币",
        "scope": "卷烟零售、雪茄烟零售，食品销售，食用农产品的销售，办公用品、电子产品、建筑材料、五金交电、日用百货、通讯设备、珠宝首饰、汽车配件、茶具、工艺品、花卉、苗木、家具、家用电器、仪器仪表、化妆品、服装服饰、计算机、软件及辅助设备批发、零售，电子商务（不得从事金融业务）。",
        "belongOrg": "奉贤区市场监管局",
        "operName": "吴xxx",
        "econKindCode": "4540",
        "startDate": "2018-05-05",
        "status": "存续",
        "isHmd": true,
        "jyycFlag": 1,
        "yzwfFlag": 1,
        "zdsswfFlag": 1,
        "jyycList": [
            {
                "total": 2,
                "items": [
                    {
                        "outReason": "-",
                        "regNo": "430102000312822",
                        "outDate": "-",
                        "province": "HUNAN",
                        "inDate": "2018-07-09",
                        "name": "湖南长沙XX有限公司",
                        "disabled": "0",
                        "inReason": "未按照规定报送年度报告",
                        "department": "长沙市工商行政管理局芙蓉分局"
                    },
                    {
                        "outReason": "-",
                        "regNo": "430102000312822",
                        "outDate": "-",
                        "province": "HUNAN",
                        "inDate": "2018-07-08",
                        "name": "湖南长沙XX有限公司",
                        "disabled": "1",
                        "inReason": "未按照规定报送年度报告",
                        "department": "长沙市工商行政管理局芙蓉分局"
                    }
                ]
            }
        ],
        "yzwfList": {
            "execution": [
                {
                    "in_department": "湖南省市场监督管理局",
                    "out_department": "-",
                    "in_date": "2019-07-30",
                    "in_reason": "被列入经营异常名录届满3年仍未履行相关义务",
                    "out_date": "-",
                    "out_reason": "-"
                }
            ]
        },
        "zdsswfList": {
            "total": 1,
            "items": [
                {
                    "created_time": "2019-04-09",
                    "updated_time": "2019-04-09",
                    "agent": "-",
                    "address": "湖南省经济技术开发区承德南路266号6#楼322室",
                    "illegal_fact": "经江苏省淮安市国家税务局稽查局检查，发现其在2015年12月01日至2016年05月31日期间，主要存在以下问题：对外虚开增值税销项发票150份，金额1408.00万元，税额239.00万元。",
                    "url": "http://hd.chinatax.gov.cn/xxk/action/GetArticleView1.do?op=xxkweb&id=234642",
                    "result": "依照《中华人民共和国税收征收管理法》等相关法律法规的有关规定，对其处以罚款0.01万元的行政处罚，并依法移送司法机关。",
                    "credit_no": "91320891MA1MC20690",
                    "name": "湖南长沙XX有限公司",
                    "property": "虚开增值税专用发票或者虚开用于骗取出口退税、抵扣税款的其他发票",
                    "oper": "史东也,男",
                    "time": "2017-03-01",
                    "org_no": "A1MC2069",
                    "finance_officer": "-"
                }
            ]
        }
    }
}

• 字段说明

5、错误码

企业模糊查询接口

1、接口描述

​ 根据企业名或统一社会信用代码查询出企业税号（包括成立日期、企业法人），或根据企业税号查询出企业名称（包括成立日期、企业法人）。

2、接口地址

POST /v1/HMD/qycx  HTTP/1.1

3、请求参数

• 参数说明

请求参数为JSON格式。

• 示例参数

{
  "qyName": "914XXXXXXXXX94XX"
}

4、返回结果

• 返回结果

返回结果为JSON格式。

示例返回结果：

单企业示例：
{
    "result": {
        "req_id": "bd79055c0ae74aafad588ee05a98d719",
        "success": true,
        "time": 5994,
        "timestamp": 1652251579994
    },
    "value": {
        "qyName": "广州XXXX有限公司",
        "nsrsbh": "9144010XXXXXXXXX",
        "operName": "董XX",
        "startDate": "2018-06-17"
    }
}

模糊企业列表示例：
{
    "result": {
        "req_id": "e1a7488bc7624a4b9c831085bb58344a",
        "success": true,
        "time": 408,
        "timestamp": 1689665694444
    },
    "value": {
        "qyName": "企享云（北京）XXXX有限公司",
        "nsrsbh": "9111010XXXXXXXXXXX",
        "operName": "崔XX",
        "startDate": "2021-06-08",
        "all": [
            {
                "qyName": "企享云（北京）XXXX有限公司",
                "nsrsbh": "9111010XXXXXXXXXXX",
                "operName": "崔XX",
                "startDate": "2021-06-08"
            },
            {
                "qyName": "企享云服XXXX公司",
                "nsrsbh": "9131011XXXXXXXXXXX",
                "operName": "崔XX",
                "startDate": "2021-07-08"
            },
            {
                "qyName": "苏州企享云XXXX有限公司",
                "nsrsbh": "91320594XXXXXXXXXXX",
                "operName": "张XX",
                "startDate": "2015-10-10"
            },
            ...
        ]
    }
}

• 字段说明

5、错误码

企业精准查询接口

1、接口描述

​ 根据企业全名或统一社会信用代码查询出统一社会信用代码、注册资本、经营范围、企业法定代表人等 。

2、接口地址

POST /v1/HMD/qycxnew  HTTP/1.1

3、请求参数

• 参数说明

请求参数为JSON格式。

• 示例参数

{
  "qyName": "914XXXXXXXXX94XX"
}

4、返回结果

• 返回结果

返回结果为JSON格式。

示例返回结果：
{
    "result": {
        "req_id": "7322051a2bde49e399500062b8f5caeb",
        "success": true,
        "time": 308,
        "timestamp": 1659447284309
    },
    "value": {
        "historyNames": [],
        "actualCapi": "-",
        "address": "上海市奉xxxxx第xxx间",
        "endDate": "-",
        "econKind": "个人独资企业",
        "termEnd": "-",
        "title": "投资人",
        "checkDate": "2018-11-27",
        "revokeDate": "-",
        "type": "01",
        "tags": [],
        "revokeReason": "",
        "termStart": "-",
        "qyName": "上海xxxxxxx行",
        "nsrsbh": "91xxxxxxx",
        "orgNo": "xxxxxxx",
        "registCapi": "100 万人民币",
        "scope": "卷烟零售、雪茄烟零售，食品销售，食用农产品的销售，办公用品、电子产品、建筑材料、五金交电、日用百货、通讯设备、珠宝首饰、汽车配件、茶具、工艺品、花卉、苗木、家具、家用电器、仪器仪表、化妆品、服装服饰、计算机、软件及辅助设备批发、零售，电子商务（不得从事金融业务）。",
        "belongOrg": "奉贤区市场监管局",
        "operName": "吴xxx",
        "econKindCode": "4540",
        "startDate": "2018-05-05",
        "status": "存续",
        "categoryNew": "0115601",
        "currency_unit": "CNY",
        "fenname": "-",
        "format_name": "上海xxxxxxx行",
        "districtCode": "310115",
        "districtName": "上海上海市浦东新区",
        "domain": "C4210",
        "domainName": "金属废料和碎屑加工处理"
    }
}

• 字段说明

5、错误码

经营异常风险接口

1、接口描述

企业经营异常信息，企业被列入或移出的原因和时间，以及做出决定的机关等。

2、接口地址

POST /v1/HMD/jyyc  HTTP/1.1

3、请求参数

• 参数说明

请求参数为JSON格式。

• 示例参数

{
  "qyName": "湖南长沙XX有限公司"
}

4、返回结果

• 返回结果

返回结果为JSON格式。

示例返回结果：
{
    "result": {
        "req_id": "5946d92322fe4e0192cf0275e518b517",
        "success": true,
        "time": 1819,
        "timestamp": 1632662721581
    },
    "value": {
        "qyName": "湖南长沙XX有限公司",
        "jyycFlag": 1,
        "jyycList": [
            {
                "total": 2,
                "items": [
                    {
                        "outReason": "-",
                        "regNo": "430102000312822",
                        "outDate": "-",
                        "province": "HUNAN",
                        "inDate": "2018-07-09",
                        "name": "湖南长沙XX有限公司",
                        "disabled": "0",
                        "inReason": "未按照规定报送年度报告",
                        "department": "长沙市工商行政管理局芙蓉分局"
                    },
                    {
                        "outReason": "-",
                        "regNo": "430102000312822",
                        "outDate": "-",
                        "province": "HUNAN",
                        "inDate": "2018-07-08",
                        "name": "湖南长沙XX有限公司",
                        "disabled": "1",
                        "inReason": "未按照规定报送年度报告",
                        "department": "长沙市工商行政管理局芙蓉分局"
                    }
                ]
            }
        ]
    }
}

• 字段说明

5、错误码

严重违法风险接口

1、接口描述

企业严重违法信息，企业被列入或移出的原因和时间，以及做出决定的机关等 。

2、接口地址

POST /v1/HMD/yzwf  HTTP/1.1

3、请求参数

• 参数说明

请求参数为JSON格式。

• 示例参数

{
  "qyName": "湖南长沙XX有限公司"
}

4、返回结果

• 返回结果

返回结果为JSON格式。

示例返回结果：
{
    "result": {
        "req_id": "5946d92322fe4e0192cf0275e518b517",
        "success": true,
        "time": 1819,
        "timestamp": 1632662721581
    },
    "value": {
        "qyName": "湖南长沙XX有限公司",
        "yzwfFlag": 1,
        "yzwfList": {
            "execution": [
                {
                    "in_department": "湖南省市场监督管理局",
                    "out_department": "-",
                    "in_date": "2019-07-30",
                    "in_reason": "被列入经营异常名录届满3年仍未履行相关义务",
                    "out_date": "-",        
                    "out_reason": "-",
                    "is_history": 0
                }
            ]
        }
    }
}

• 字段说明

5、错误码

重大税收违法风险接口

1、接口描述

企业业重大税收违法信息，包括案件性质、主要违法事实等。

2、接口地址

POST /v1/HMD/zdsswf  HTTP/1.1

3、请求参数

• 参数说明

请求参数为JSON格式。

• 示例参数

{
  "qyName": "湖南长沙XX有限公司"
}

4、返回结果

• 返回结果

返回结果为JSON格式。

示例返回结果：
{
    "result": {
        "req_id": "5946d92322fe4e0192cf0275e518b517",
        "success": true,
        "time": 1819,
        "timestamp": 1632662721581
    },
    "value": {
        "qyName": "湖南长沙XX有限公司",
        "zdsswfFlag": 1,
        "zdsswfList": {
            "total": 1,
            "items": [
                {
                    "created_time": "2019-04-09",
                    "updated_time": "2019-04-09",
                    "agent": "-",
                    "address": "湖南省经济技术开发区承德南路266号6#楼322室",
                    "illegal_fact": "经江苏省淮安市国家税务局稽查局检查，发现其在2015年12月01日至2016年05月31日期间，主要存在以下问题：对外虚开增值税销项发票150份，金额1408.00万元，税额239.00万元。",
                    "url": "http://hd.chinatax.gov.cn/xxk/action/GetArticleView1.do?op=xxkweb&id=234642",
                    "result": "依照《中华人民共和国税收征收管理法》等相关法律法规的有关规定，对其处以罚款0.01万元的行政处罚，并依法移送司法机关。",
                    "credit_no": "91320891MA1MC20690",
                    "name": "湖南长沙XX有限公司",
                    "property": "虚开增值税专用发票或者虚开用于骗取出口退税、抵扣税款的其他发票",
                    "oper": "史桂,男",
                    "time": "2017-03-01",
                    "org_no": "A1MC2069",
                    "finance_officer": "-",
                    "u_tags": 0
                }
            ]
        }
    }
}

• 字段说明

5、错误码

非正常户接口（已经下线，请调用新接口）

1、接口描述

企业非正常户信息，包括纳税人识别号、认定原因、欠税种类及金额等 。

2、接口地址

POST /v1/HMD/fzch  HTTP/1.1

非正常户接口（新）

1、接口描述

通过纳税人识别号获取企业的状态。 如需通过企业名称查询，建议先调用企业查询接口获取纳税人识别号。

2、接口地址

POST /v1/HMD/fzchnew  HTTP/1.1

3、请求参数

• 参数说明

请求参数为JSON格式。

• 示例参数

{
  "nsrsbh": "91310120MA1HPRYW29"
}

4、返回结果

• 返回结果

返回结果为JSON格式。

非正常户返回结果示例：
{
    "result": {
        "req_id": "9cc0af92b2624cfdbb1ad86d537f006c",
        "success": true,
        "time": 2712,
        "timestamp": 1655951208664
    },
    "value": {
        "nsrsbh": "91310120MA1HPRYW29",
        "fzchFlag": 1,
        "fzchList": {
            "code": "10013",
            "msg": "当前单位状态为【非正常】"
        }
    }
}

正常户返回结果示例：
{
    "result": {
        "req_id": "8ba27c80d5434f37a41f9d65a85c4f2b",
        "success": true,
        "time": 2218,
        "timestamp": 1655952447939
    },
    "value": {
        "nsrsbh": "91360500781462979X",
        "fzchFlag": 0
    }
}

• 字段说明

• fzchList非正常户数据列表说明

5、错误码

企业风控明细接口

1、接口描述

​ 企业经营异常接口、严重违法接口、重大税收违法接口，支持用户可以调用1个接口，也可以调用2个或3个或3个接口。

2、接口地址

POST /v1/HMD/qyfkmx  HTTP/1.1

3、请求参数

• 参数说明

请求参数为JSON格式。

• 示例参数

{
  "qyName": "91430XXXXXXX94XX",
  "interfaceList": "jyyc,yzwf,zdsswf"
}

4、返回结果

• 返回结果

返回结果为JSON格式。

示例返回结果：
{
    "result": {
        "req_id": "5946d92322fe4e0192cf0275e518b517",
        "success": true,
        "time": 1819,
        "timestamp": 1632662721581
    },
    "value": {
        "qyName": "91430XXXXXXX94XX",
        "jyycFlag": 1,
        "yzwfFlag": 1,
        "zdsswfFlag": 1,
        "jyycList": [
            {
                "total": 2,
                "items": [
                    {
                        "outReason": "-",
                        "regNo": "430102000312822",
                        "outDate": "-",
                        "province": "HUNAN",
                        "inDate": "2018-07-09",
                        "name": "湖南长沙XX有限公司",
                        "disabled": "0",
                        "inReason": "未按照规定报送年度报告",
                        "department": "长沙市工商行政管理局芙蓉分局"
                    },
                    {
                        "outReason": "-",
                        "regNo": "430102000312822",
                        "outDate": "-",
                        "province": "HUNAN",
                        "inDate": "2018-07-08",
                        "name": "湖南长沙XX有限公司",
                        "disabled": "1",
                        "inReason": "未按照规定报送年度报告",
                        "department": "长沙市工商行政管理局芙蓉分局"
                    }
                ]
            }
        ],
        "yzwfList": {
            "execution": [
                {
                    "in_department": "湖南省市场监督管理局",
                    "out_department": "-",
                    "in_date": "2019-07-30",
                    "in_reason": "被列入经营异常名录届满3年仍未履行相关义务",
                    "out_date": "-",
                    "out_reason": "-",
                    "is_history": 0
                }
            ]
        },
        "zdsswfList": {
            "total": 1,
            "items": [
                {
                    "created_time": "2019-04-09",
                    "updated_time": "2019-04-09",
                    "agent": "-",
                    "address": "湖南省经济技术开发区承德南路266号6#楼322室",
                    "illegal_fact": "经江苏省淮安市国家税务局稽查局检查，发现其在2015年12月01日至2016年05月31日期间，主要存在以下问题：对外虚开增值税销项发票150份，金额1408.00万元，税额239.00万元。",
                    "url": "http://hd.chinatax.gov.cn/xxk/action/GetArticleView1.do?op=xxkweb&id=234642",
                    "result": "依照《中华人民共和国税收征收管理法》等相关法律法规的有关规定，对其处以罚款0.01万元的行政处罚，并依法移送司法机关。",
                    "credit_no": "91320891MA1MC20690",
                    "name": "湖南长沙XX有限公司",
                    "property": "虚开增值税专用发票或者虚开用于骗取出口退税、抵扣税款的其他发票",
                    "oper": "史桂,男",
                    "time": "2017-03-01",
                    "org_no": "A1MC2069",
                    "finance_officer": "-",
                    "u_tags": 0
                }
            ]
        }
    }
}

• 字段说明

5、错误码

经营异常结构说明

items数据字段

严重违法结构说明

重大税收违法结构说明

items数据字段