第三方平台
接口说明

查询商铺资质材料状态

接口介绍

该接口用于查询第三方应用为授权小程序提交商铺资质材料的状态信息。

请求

基本信息

基本


HTTP URL

https://open.microapp.bytedance.com/openapi/v1//microapp/operation/poi/query_shop_material

HTTP Method

GET

权限要求

授权小程序授予运营管理权限

查询参数

参数名

参数类型

是否必须

备注

component_appid

string

第三方应用 appid

authorizer_access_token

string

授权小程序接口调用凭据

supplier_ext_id

string

接入方店铺 ID

响应体

参数名

参数类型

备注

errno

int

错误码

message

string

错误信息

data

object


data 说明

参数名

参数类型

备注

online_shop_material

object

线上版资质信息

audit_shop_material

object

审核版资质信息

online_shop_material 说明

参数名

参数类型

备注

status

int

状态,1:上线,2:下线

biz_licence

object

商铺营业执照信息

contract

object

服务商和商家的合作协议信息

qual_material

Array<object>

商铺行业资质材料信息

additional_qual

Array<object>

补充资质信息

biz_licence、contract、qual_material 说明

参数名

参数类型

备注

path

string

资质材料链接

addtional_qual 说明

参数名

参数类型

备注

additional_qual_type

int

必要补充资质类型,目前有以下类型
1 :身份证, 2:健康证

paths

Array<object>

资质材料链接list

audit_shop_material 说明

参数名

参数类型

备注

biz_licence

object

商铺营业执照信息

contract

object

服务商和商家的合作协议信息

qual_material

Array<object>

商铺行业资质材料信息

additional_qual

Array<object>

补充资质信息

biz_licence、contract、qual_material 说明

参数名

参数类型

备注

path

string

资质材料链接

status

int

状态,1:审核中,2:审核成功,3:审核失败

reason

Array

审核失败原因

additional_qual 说明

参数名

参数类型

备注

additional_qual_type

int

必要补充资质类型,目前有以下类型
1 :身份证, 2:健康证

paths

Array<object>

资质材料链接list

status

int

状态,1:审核中,2:审核成功,3:审核失败

reason

Array

审核失败原因

注意:

  • 商铺营业执照、服务商和商家的合作协议、商铺行业资质材料、必要的补充资质都是分开审核,当且仅当所有资质都通过审核才会变更为线上版资质。

响应体示例

{
  "errno": 0,
  "message": "success",
  "data": {
    "online_shop_material": {
      "status": 1,
      "biz_licence": {
        "path": "https://lf3-developer-sign.bytemastatic.com/developer/thirdparty/xxx/xxx/shop_contract/c36ff08137"
      },
      "contract": {
        "path": "xxxxx"
      },
      "qual_material": [
        {
          "path": "xxxxx"
        }
      ],
      "additional_qual": [
        {
          "additional_qual_type": 1, //1为身份证类型资质
          "paths": [
            {
              "path": "https://xxxxxxxxx"
            }
          ]
        },
        {
          "additional_qual_type": 2, //2为健康证类型资质
          "paths": [
            {
              "path": "https://xxxxxxxxx"
            },
            {
              "path": "https://xxxxxxxxx"
            }
          ]
        }
      ]
    },
    "audit_shop_material": {
      "biz_licence": {
        "path": "xxxx",
        "status": 1
      },
      "contract": {
        "path": "xxxxxxxx",
        "status": 2
      },
      "qual_material": [
        {
          "path": "xxxxx",
          "status": 3,
          "reason": [
            "您好,您所认领的门店名称与门店主体无关,请核对认领门店名称是否正确或提供其他补充材料,谢谢。"
          ]
        }
      ],
      "additional_qual": [
        {
          "additional_qual_type": 1, //1为身份证类型资质
          "paths": [
            {
              "path": "xxxxx"
            }
          ],
          "status": 3,
          "reason": [
            "您好,您所认领的门店名称与门店主体无关,请核对认领门店名称是否正确或提供其他补充材料,谢谢。"
          ]
        },
        {
          "additional_qual_type": 2, //2为健康证类型资质
          "paths": [
            {
              "path": "xxxxx"
            }
          ],
          "status": 3,
          "reason": [
            "您好,您所认领的门店名称与门店主体无关,请核对认领门店名称是否正确或提供其他补充材料,谢谢。"
          ]
        }
      ]
    }
  }
}

错误码

错误码

message

40001

参数错误

40003

找不到相关第三方应用

40004

找不到相关授权小程序

40020

第三方应用 authorizer_access_token 不正确或者已过期

40036

授权小程序未授予该接口对应的权限

点击纠错
评价此篇文档