客户查询

POST

openapi.nmy.cn/api/v1/open/issue-maintain/customer/list

接口描述

该接口用于查询企业电子发票服务平台当前企业已维护的客户信息列表。

支持分页查询，按客户名称、纳税人识别号、分类等条件过滤，返回客户的名称、税号、地址电话、开户行及账号等开票必要字段。

请求参数

Header 参数

Body 参数application/json必填

示例

{
    "uscc": "{{uscc}}",
    "areaCode": "{{areaCode}}",
    "personalAccount": "{{personalAccount}}",
    "classification": "客户分类uuid，可查指定分类的数据,不传或传空字符串查所有",
    "page": {
        "pageIndex": 1,
        "pageSize": 20
    }
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'openapi.nmy.cn/api/v1/open/issue-maintain/customer/list' \
--header 'Authorization: {{authorization}}' \
--header 'accountId: {{accountId}}' \
--header 'Content-Type: application/json' \
--data '{
    "uscc": "{{uscc}}",
    "areaCode": "{{areaCode}}",
    "personalAccount": "{{personalAccount}}",
    "classification": "客户分类uuid，可查指定分类的数据,不传或传空字符串查所有",
    "page": {
        "pageIndex": 1,
        "pageSize": 20
    }
}'

返回响应

🟢200

application/json

Success

Bodyapplication/json

示例

{
    "code": 0,
    "message": "success",
    "data": {
        "total": 1130,
        "list": [
            {
                "khfluuid": "客户分类uuid",
                "khflmc": "示例名称",
                "jdqmc": "节点全称",
                "khxxuuid": "客户信息uuid",
                "gmfmc": "示例名称",
                "gmfnsrsbh": "91440300MA5EXAMPLE",
                "jm": "简码",
                "dzxxList": [
                    {
                        "dzxxuuid": "广东省深圳市南山区科技园",
                        "glzxxuuid": "关联主信息uuid",
                        "glzxxlx": "A",
                        "dz": "广东省深圳市南山区科技园",
                        "yhyywdmc": "开户行",
                        "yhzh": "银行账号",
                        "lxdh": "13800138000",
                        "email": "联系邮箱",
                        "sfmrdz": "广东省深圳市南山区科技园"
                    }
                ]
            }
        ]
    },
    "traceId": "xxxx-xxxx-xxxx-xxxx"
}

🟠400

🟠401

🔴500

修改于 2026-09-29 07:58:32

客户分类删除

客户新增

客户查询

接口描述#

请求参数

请求示例代码

返回响应

接口描述