# 申请小程序备案

调试工具

接口应在服务器端调用，详细说明参见服务端API。

# 接口说明

# 接口英文名

applyIcpFiling

# 功能描述

使用该接口申请小程序备案。该接口使用的媒体材料都是通过"上传小程序备案媒体材料"接口返回的media_id。使用过程中如遇到问题，可在开放平台服务商专区发帖交流

# 注意事项

申请小程序备案之前，请确保前置条件已经完成：
- 小程序名称、图标、描述等小程序基本信息已填写完成。
- 小程序至少存在一个审核通过的类目。
- 非个人类型小程序必须完成微信认证。
调用该接口之前，请先完成小程序负责人人脸核身，以及上传所有需要用到的附件材料。
人脸核身视频会用于生成核验照片，背景需白色或接近浅色，核验人不能裸露上半身，不能戴帽子、耳机、口罩等遮挡面部的物品，如视频不满足要求，即使人脸核身通过，本接口也会返回失败。
所有字段校验失败的原因会一次性返回。
每个服务商每日只能发起1000个存量已上架小程序备案申请，新增未上架小程序不受限制。
小程序备注（必填）注意事项：
- 天津市个人主体备案小程序请按以下格式补充备注：应急联系电话手机号使用人为XXX，与小程序主办者关系为XX （注：应急联系方式必须为小程序主办者的直系亲属）；天津市非个人主体备案小程序请按以下格式补充备注：应急联系电话手机号使用人为XXX公司员工XXX。
- 福建省个人主体备案小程序请按以下格式补充备注：请具体描述小程序实际经营内容、主要服务内容，该信息为主管部门审核重要依据，备注内容字数限制20-200字，请认真填写。且不能出现“**公司官网，**单位旗下产品”。
- 广东省备案小程序如果是非纯中文小程序昵称，要求在小程序备注位置注明中文名称以及小程序主要服务内容，并且在备注文案文末加上“承诺遵守中华人民共和国法律法规。”，备注内容字数限制20-200字，请认真填写。
若发起备案请求时，管理员实名信息未补充，且备案信息中小程序负责人为法人时，管理员实名信息将更新为小程序负责人（即法人）。

# 调用方式

# HTTPS 调用


POST https://api.weixin.qq.com/wxa/icp/apply_icp_filing?access_token=ACCESS_TOKEN

# 第三方调用

调用方式以及出入参和HTTPS相同，仅是调用的token不同
该接口所属的权限集id为：18、156
服务商获得其中之一权限集授权后，可通过使用authorizer_access_token代商家进行调用

# 请求参数

属性类型必填说明

access_token string 是接口调用凭证，该参数为 URL 参数，非 Body 参数。使用authorizer_access_token

icp_subject object 是备案主体信息

属性类型必填说明

base_info object 是主体基本信息

属性	类型	必填	说明
type	number	是	主体性质，示例值：`5`
name	string	是	主办单位名称，示例值：`"张三"`
province	string	是	备案省份，使用省份代码，示例值：`"110000"`(参考：获取区域信息接口)
city	string	是	备案城市，使用城市代码，示例值：`"110100"`(参考：获取区域信息接口)
district	string	是	备案县区，使用县区代码，示例值：`"110105"`(参考：获取区域信息接口)
address	string	是	通讯地址，必须属于备案省市区，地址开头的省市区不用填入，例如：通信地址为“北京市朝阳区高碑店路181号1栋12345室”时，只需要填写 `"高碑店路181号1栋12345室"` 即可
comment	string	否	主体信息备注，根据需要，如实填写
record_number	string	否	主体备案号，示例值：粤B2-20090059（申请小程序备案时不用填写，查询已备案详情时会返回）

personal_info object 否个人主体额外信息

	属性	类型	必填	说明
	residence_permit	string	否	临时居住证明照片 media_id，个人备案且非本省人员，需要提供居住证、暂住证、社保证明、房产证等临时居住证明，示例值：`"4ahCGpd3CYkE6RpkNkUR5czt3LvG8xDnDdKAz6bBKttSfM8p4k5Rj6823HXugPwQBurgMezyib7"`

organize_info object 是主体额外信息（个人备案时，如果存在与主体负责人信息相同的字段，则填入相同的值）

属性	类型	必填	说明
certificate_type	number	是	主体证件类型，示例值：`2`(参考：获取证件类型接口)
certificate_number	string	是	主体证件号码，示例值：`"110105199001011234"`
certificate_address	string	是	主体证件住所，示例值：`"北京市朝阳区高碑店路181号1栋12345室"`
certificate_photo	string	否	主体证件照片 media_id，如果小程序主体为非个人类型，则必填，示例值：`"4ahCGpd3CYkE6RpkNkUR5czt3LvG8xDnDdKAz6bBKttSfM8p4k5Rj6823HXugPwQBurgMezyib7"`

principal_info object 是主体负责人信息

属性	类型	必填	说明
name	string	是	负责人姓名，示例值：`"张三"`
mobile	string	是	负责人联系方式，示例值：`"13012344321"`
email	string	是	负责人电子邮件，示例值：`"zhangsan@zhangsancorp.com"`
emergency_contact	string	是	负责人应急联系方式，示例值：`"17743211234"`
certificate_type	number	是	负责人证件类型，示例值：`2`(参考：获取证件类型接口，此处只能填入单位性质属于个人的证件类型)
certificate_number	string	是	负责人证件号码，示例值：`"110105199001011234"`
certificate_validity_date_start	string	是	负责人证件有效期起始日期，格式为 YYYYmmdd，示例值：`"20230815"`
certificate_validity_date_end	string	是	负责人证件有效期终止日期，格式为 YYYYmmdd，如证件长期有效，请填写 `"长期"`，示例值：`"20330815"`
certificate_photo_front	string	是	负责人证件正面照片 media_id（身份证为人像面），示例值：`"4ahCGpd3CYkE6RpkNkUR5czt3LvG8xDnDdKAz6bBKttSfM8p4k5Rj6823HXugPwQBurgMezyib7"`
certificate_photo_back	string	是	负责人证件背面照片 media_id（身份证为国徽面），示例值：`"4ahCGpd3CYkE6RpkNkUR5czt3LvG8xDnDdKAz6bBKttSfM8p4k5Rj6823HXugPwQBurgMezyib7"`
authorization_letter	string	否	授权书 media_id，当主体负责人不是法人时需要主体负责人授权书，当小程序负责人不是法人时需要小程序负责人授权书，示例值：`"4ahCGpd3CYkE6RpkNkUR5czt3LvG8xDnDdKAz6bBKttSfM8p4k5Rj6823HXugPwQBurgMezyib7"`
verify_task_id	string	否	扫脸认证任务id(扫脸认证接口返回的task_id)，仅小程序负责人需要扫脸，主体负责人无需扫脸，示例值：`"R5PqRPNb6GmG3i0rqd4pTg"`

legal_person_info object 否法人信息（非个人备案，且主体负责人不是法人时，必填）

	属性	类型	必填	说明
	name	string	是	法人代表姓名，示例值：`"张三"`
	certificate_number	string	是	法人证件号码，示例值：`"110105199001011234"`

icp_applets object 是微信小程序信息

属性类型必填说明

base_info object 是微信小程序基本信息

属性类型必填说明

appid string 否小程序ID，不用填写，后台自动拉取

name string 否小程序名称，不用填写，后台自动拉取

service_content_types array<number> 是小程序服务内容类型，只能填写二级服务内容类型，最多5个，示例值：[3, 4](参考：获取小程序服务类型接口)

nrlx_details array<object> 是前置审批项，列表中不能存在重复的前置审批类型id，如不涉及前置审批项，也需要填“以上都不涉及”

属性	类型	必填	说明
type	number	是	前置审批类型，示例值：`2`(参考：获取前置审批项接口)
code	string	否	前置审批号，如果前置审批类型不是“以上都不涉及”，则必填，示例值：`"粤-12345号"`
media	string	否	前置审批媒体材料 media_id，如果前置审批类型不是“以上都不涉及”，则必填，示例值：`"4ahCGpd3CYkE6RpkNkUR5czt3LvG8xDnDdKAz6bBKttSfM8p4k5Rj6823HXugPwQBurgMezyib7"`

comment string 是请具体描述小程序实际经营内容、主要服务内容，该信息为主管部门审核重要依据，备注内容字数限制20-200字，请认真填写。（特殊备注要求请查看注意事项）

record_number string 否小程序备案号，示例值：粤B2-20090059-1626X（申请小程序备案时不用填写，查询已备案详情时会返回）

principal_info object 是小程序负责人信息

属性	类型	必填	说明
name	string	是	负责人姓名，示例值：`"张三"`
mobile	string	是	负责人联系方式，示例值：`"13012344321"`
email	string	是	负责人电子邮件，示例值：`"zhangsan@zhangsancorp.com"`
emergency_contact	string	是	负责人应急联系方式，示例值：`"17743211234"`
certificate_type	number	是	负责人证件类型，示例值：`2`(参考：获取证件类型接口，此处只能填入单位性质属于个人的证件类型)
certificate_number	string	是	负责人证件号码，示例值：`"110105199001011234"`
certificate_validity_date_start	string	是	负责人证件有效期起始日期，格式为 YYYYmmdd，示例值：`"20230815"`
certificate_validity_date_end	string	是	负责人证件有效期终止日期，格式为 YYYYmmdd，如证件长期有效，请填写 `"长期"`，示例值：`"20330815"`
certificate_photo_front	string	是	负责人证件正面照片 media_id（身份证为人像面），示例值：`"4ahCGpd3CYkE6RpkNkUR5czt3LvG8xDnDdKAz6bBKttSfM8p4k5Rj6823HXugPwQBurgMezyib7"`
certificate_photo_back	string	是	负责人证件背面照片 media_id（身份证为国徽面），示例值：`"4ahCGpd3CYkE6RpkNkUR5czt3LvG8xDnDdKAz6bBKttSfM8p4k5Rj6823HXugPwQBurgMezyib7"`
authorization_letter	string	否	授权书 media_id，当主体负责人不是法人时需要主体负责人授权书，当小程序负责人不是法人时需要小程序负责人授权书，示例值：`"4ahCGpd3CYkE6RpkNkUR5czt3LvG8xDnDdKAz6bBKttSfM8p4k5Rj6823HXugPwQBurgMezyib7"`
verify_task_id	string	否	扫脸认证任务id(扫脸认证接口返回的task_id)，仅小程序负责人需要扫脸，主体负责人无需扫脸，示例值：`"R5PqRPNb6GmG3i0rqd4pTg"`

icp_materials object 是其他备案媒体材料

属性	类型	必填	说明
commitment_letter	array<string>	否	互联网信息服务承诺书 media_id，最多上传1个
business_name_change_letter	array<string>	否	主体更名函 media_id(非个人类型，且发生过更名时需要上传)，最多上传1个
party_building_confirmation_letter	array<string>	否	党建确认函 media_id，最多上传1个
promise_video	array<string>	否	承诺视频 media_id，最多上传1个
authenticity_responsibility_letter	array<string>	否	网站备案信息真实性责任告知书 media_id，最多上传1个
authenticity_commitment_letter	array<string>	否	小程序备案信息真实性承诺书 media_id，最多上传1个
website_construction_proposal	array<string>	否	小程序建设方案书 media_id，最多上传1个
subject_other_materials	array<string>	否	主体其它附件 media_id，最多上传10个
applets_other_materials	array<string>	否	小程序其它附件 media_id，最多上传10个
holding_certificate_photo	array<string>	否	手持证件照 media_id，最多上传1个

# 返回参数

属性类型说明

errcode number 错误码

errmsg string 错误信息

hints array<object> 错误提示

属性	类型	说明
errcode	number	字段校验的错误码
err_field	string	校验失败的字段，示例值：`"icp_subject.principal_info.certificate_photo_front"`
errmsg	string	校验失败提示信息，示例值：`"缺少必填字段"`

# 其他说明

# 事件推送

当备案审核被驳回或通过时会推送该事件。服务商要接收事件推送，请移步：授权事件接收配置

# 推送参数说明

参数	类型	说明
InfoType	string	消息类型，固定为 `notify_apply_icpfiling_result`
AppId	string	服务商唯一id
authorizer_appid	string	小程序唯一id
beian_status	number	备案状态，参考“获取小程序备案状态及驳回原因”接口的备案状态枚举

# 推送数据示例

{
  "AppId": "wx1234567890abcdef",
  "CreateTime": 1689839779,
  "InfoType": "notify_apply_icpfiling_result",
  "authorizer_appid": "wxabcdef1234567890",
  "beian_status": 3
}

# 调用示例

示例说明: 个人备案

# 请求数据示例


{
    "icp_subject": {
        "base_info": {
            "type": 5, // 个人类型
            "name": "张三",
            "province": "110000", // 北京市
            "city": "110100",
            "district": "110105", // 朝阳区
            "address": "高碑店路181号1栋12345室",
            "comment": "主体备注"
        },
        "personal_info": {
            "residence_permit": "4ahCGpd3CYkE6RpkNkUR5czt3LvG8xDnDdKAz6bBKttSfM8p4k5Rj6823HXugPwQBurgMezyib7"
        },
        "organize_info": {
            "certificate_type": 2,
            "certificate_number": "110105199001011234",
            "certificate_address": "北京市朝阳区高碑店路181号1栋12345室"
        },
        "principal_info": {
            "name": "张三",
            "mobile": "13012344321",
            "email": "zhangsan@zhangsancorp.com",
            "emergency_contact": "17743211234",
            "certificate_type": 2, // 身份证
            "certificate_number": "110105199001011234",
            "certificate_validity_date_start": "20230815",
            "certificate_validity_date_end": "20330815",
            "certificate_photo_front": "4ahCGpd3CYkE6RpkNkUR5czt3LvG8xDnDdKAz6bBKttSfM8p4k5Rj6823HXugPwQBurgMezyib7",
            "certificate_photo_back": "4ahCGpd3CYkE6RpkNkUR5czt3LvG8xDnDdKAz6bBKttSfM8p4k5Rj6823HXugPwQBurgMezyib7"
        }
    },
    "icp_applets": {
        "base_info": {
            "service_content_types": [
                3,
                4
            ], // 工具 & 家政
            "nrlx_details": [
                {
                    "type": 24 // 以上都不涉及
                }
            ],
            "comment": "小程序备注"
        },
        "principal_info": {
            "name": "张三",
            "mobile": "13012344321",
            "email": "zhangsan@zhangsancorp.com",
            "emergency_contact": "17743211234",
            "certificate_type": 2, // 身份证
            "certificate_number": "110105199001011234",
            "certificate_validity_date_start": "20230815",
            "certificate_validity_date_end": "20330815",
            "certificate_photo_front": "4ahCGpd3CYkE6RpkNkUR5czt3LvG8xDnDdKAz6bBKttSfM8p4k5Rj6823HXugPwQBurgMezyib7",
            "certificate_photo_back": "4ahCGpd3CYkE6RpkNkUR5czt3LvG8xDnDdKAz6bBKttSfM8p4k5Rj6823HXugPwQBurgMezyib7",
            "verify_task_id": "R5PqRPNb6GmG3i0rqd4pTg"
        }
    },
    "icp_materials": {
        "commitment_letter": [
            "4ahCGpd3CYkE6RpkNkUR5czt3LvG8xDnDdKAz6bBKttSfM8p4k5Rj6823HXugPwQBurgMezyib7"
        ]
    }
}

# 返回数据示例


{
  "errcode": 0,
  "errmsg": "ok"
}

示例说明: 企业备案

# 请求数据示例


{
    "icp_subject": {
        "base_info": {
            "type": 4, // 企业类型
            "name": "李四王五有限责任公司",
            "province": "440000", // 广东省
            "city": "440100", // 广州市
            "district": "440105", // 海珠区
            "address": "新港中路TIT创意园B6栋",
            "comment": "主体备注"
        },
        "organize_info": {
            "certificate_type": 1, // 营业执照
            "certificate_number": "92111122223333443F",
            "certificate_address": "广东省广州市海珠区新港中路TIT创意园B6栋",
            "certificate_photo": "4ahCGpd3CYkE6RpkNkUR5czt3LvG8xDnDdKAz6bBKttSfM8p4k5Rj6823HXugPwQBurgMezyib7"
        },
        "principal_info": {
            "name": "李四",
            "mobile": "13022222221",
            "email": "lisi@lisiwangwucorp.com",
            "emergency_contact": "1722222234",
            "certificate_type": 2, // 身份证
            "certificate_number": "440105198802023334",
            "certificate_validity_date_start": "20230815",
            "certificate_validity_date_end": "20330815",
            "certificate_photo_front": "4ahCGpd3CYkE6RpkNkUR5czt3LvG8xDnDdKAz6bBKttSfM8p4k5Rj6823HXugPwQBurgMezyib7",
            "certificate_photo_back": "4ahCGpd3CYkE6RpkNkUR5czt3LvG8xDnDdKAz6bBKttSfM8p4k5Rj6823HXugPwQBurgMezyib7"
        }
    },
    "icp_applets": {
        "base_info": {
            "service_content_types": [
                3,
                4
            ], // 工具 & 家政
            "nrlx_details": [
                {
                    "type": 24 // 以上都不涉及
                }
            ],
            "comment": "小程序备注"
        },
        "principal_info": {
            "name": "王五",
            "mobile": "13011111111",
            "email": "wangwu@lisiwangwucorp.com",
            "emergency_contact": "15522223333",
            "certificate_type": 2, // 身份证
            "certificate_number": "440105199001019999",
            "certificate_validity_date_start": "20230815",
            "certificate_validity_date_end": "20330815",
            "certificate_photo_front": "4ahCGpd3CYkE6RpkNkUR5czt3LvG8xDnDdKAz6bBKttSfM8p4k5Rj6823HXugPwQBurgMezyib7",
            "certificate_photo_back": "4ahCGpd3CYkE6RpkNkUR5czt3LvG8xDnDdKAz6bBKttSfM8p4k5Rj6823HXugPwQBurgMezyib7",
            "verify_task_id": "R5PqRPNb6GmG3i0rqd4pTg"
        }
    },
    "icp_materials": {
        "commitment_letter": [
            "4ahCGpd3CYkE6RpkNkUR5czt3LvG8xDnDdKAz6bBKttSfM8p4k5Rj6823HXugPwQBurgMezyib7"
        ]
    }
}

# 返回数据示例


{
  "errcode": 0,
  "errmsg": "ok"
}

# 错误码

错误码	错误描述	解决方案
0	ok	ok
-1	system error	系统繁忙，此时请开发者稍候再试
86202	申请小程序备案失败	申请小程序备案失败，请根据返回的错误提示进行修改
86301	系统错误，请稍后重试	系统错误，请稍后重试
86302	输入信息与图片信息相差过大	重新拍摄上传图片
86303	无法获取号码归属地	请重试或更换一个号码
86308	证件有效期不满足要求	请确保证件在有效期内，且有效期大于3个月
86324	当前正在审核中，请勿重复提交	当前正在审核中，请勿重复提交
86358	存在订单尚未完成，不允许再次提交	存在订单尚未完成，不允许再次提交