API开放平台

TIP

# 新增供应商

请求方式： POST（HTTPS）
请求地址： https://openapi.qince.com/api/esssSupplier/v1/addSupplier/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例：

{
    "name": "供应商A",
    "code": "GYS001",
    "title": "XX有限公司",
    "taxpayerNumber": "91110000MA001",
    "address": "北京市朝阳区XX路",
    "phone": "010-12345678",
    "bankName": "中国银行",
    "bankNumber": "6222000000000000",
    "linkman": "张三",
    "linkmanMobile": "13800138000",
    "unitAddress": "北京市朝阳区XX路XX号",
    "type": "原材料供应商",
    "remark": "备注信息"
}
说明： 本示例仅供参考，具体以参数说明为准。

参数说明：

参数 类型 必填 说明
name VARCHAR(100) 否 供应商名称
code VARCHAR(100) 否 供应商编码
title VARCHAR(200) 否 开票名称
taxpayerNumber VARCHAR(100) 否 纳税人识别号
address VARCHAR(200) 否 开票地址
phone VARCHAR(32) 否 开票电话
bankName VARCHAR(100) 否 开户银行
bankNumber VARCHAR(100) 否 银行账号
linkman VARCHAR(100) 否 联系人
linkmanMobile VARCHAR(32) 否 联系人手机
unitAddress VARCHAR(200) 否 单位地址
type VARCHAR(100) 否 供应商类型名称，类型不存在时返回错误
remark VARCHAR(4000) 否 备注

响应示例：

{
    "return_code": "0",
    "return_msg": "",
    "msg_id": "{ msg_id }",
    "response_data": ""
}

参数说明：

参数 类型 必填 说明
msg_id VARCHAR(32) 是 消息ID
return_code VARCHAR(32) 是 响应编码：0成功 1失败
return_msg VARCHAR(100) 是 响应说明

# 修改供应商

请求方式： POST（HTTPS）
请求地址： https://openapi.qince.com/api/esssSupplier/v1/editSupplier/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例：

{
    "id": "8007172427642688873",
    "name": "供应商A",
    "code": "GYS001",
    "title": "XX有限公司",
    "taxpayerNumber": "91110000MA001",
    "address": "北京市朝阳区XX路",
    "phone": "010-12345678",
    "bankName": "中国银行",
    "bankNumber": "6222000000000000",
    "linkman": "张三",
    "linkmanMobile": "13800138000",
    "unitAddress": "北京市朝阳区XX路XX号",
    "type": "原材料供应商",
    "remark": "备注信息"
}
说明： 本示例仅供参考，具体以参数说明为准。

参数说明：

参数 类型 必填 说明
id INT8 是 供应商id
name VARCHAR(100) 否 供应商名称
code VARCHAR(100) 否 供应商编码
title VARCHAR(200) 否 开票名称
taxpayerNumber VARCHAR(100) 否 纳税人识别号
address VARCHAR(200) 否 开票地址
phone VARCHAR(32) 否 开票电话
bankName VARCHAR(100) 否 开户银行
bankNumber VARCHAR(100) 否 银行账号
linkman VARCHAR(100) 否 联系人
linkmanMobile VARCHAR(32) 否 联系人手机
unitAddress VARCHAR(200) 否 单位地址
type VARCHAR(100) 否 供应商类型名称，类型不存在时返回错误
remark VARCHAR(4000) 否 备注

响应示例：

{
    "return_code": "0",
    "return_msg": "",
    "msg_id": "{ msg_id }",
    "response_data": ""
}

参数说明：

参数 类型 必填 说明
msg_id VARCHAR(32) 是 消息ID
return_code VARCHAR(32) 是 响应编码：0成功 1失败
return_msg VARCHAR(100) 是 响应说明

# 删除供应商

请求方式： POST（HTTPS）
请求地址： https://openapi.qince.com/api/esssSupplier/v1/deleteSupplier/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例：

{
    "id": "8007172427642688873"
}
说明： 本示例仅供参考，具体以参数说明为准。

参数说明：

参数 类型 必填 说明
id INT8 是 供应商id

响应示例：

{
    "return_code": "0",
    "return_msg": "",
    "msg_id": "{ msg_id }",
    "response_data": ""
}

参数说明：

参数 类型 必填 说明
msg_id VARCHAR(32) 是 消息ID
return_code VARCHAR(32) 是 响应编码：0成功 1失败
return_msg VARCHAR(100) 是 响应说明

# 查询供应商

请求方式： POST（HTTPS）
请求地址： https://openapi.qince.com/api/esssSupplier/v1/querySupplier/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例：

{
    "supplierName": "供应商A"
}
说明： 本示例仅供参考，具体以参数说明为准。

参数说明：

参数 类型 必填 说明
supplierName VARCHAR(100) 否 供应商名称，模糊查询

响应示例：

{
    "return_code": "0",
    "return_msg": "响应信息",
    "msg_id": "{ msg_id }",
    "response_data": "<<DATA>>"
}

数据DATA示例:

{
    "total": 1,
    "rows": [
        {
            "id": "8007172427642688873",
            "name": "供应商A",
            "code": "GYS001",
            "address": "北京市朝阳区XX路",
            "linkman": "张三",
            "linkmanMobile": "13800138000",
            "title": "XX有限公司",
            "taxpayerNumber": "91110000MA001",
            "phone": "010-12345678",
            "bankName": "中国银行",
            "bankNumber": "6222000000000000",
            "typeName": "原材料供应商",
            "remark": "备注信息",
            "unitAddress": "北京市朝阳区XX路XX号"
        }
    ]
}

参数说明：

参数 类型 必填 说明
total INT 是 总记录数
rows List 数据列表
rows.id VARCHAR(100) 是 供应商id
rows.name VARCHAR(100) 是 供应商名称
rows.code VARCHAR(100) 是 供应商编码
rows.address VARCHAR(200) 是 开票地址
rows.linkman VARCHAR(100) 是 联系人
rows.linkmanMobile VARCHAR(32) 是 联系人手机
rows.title VARCHAR(200) 是 开票名称
rows.taxpayerNumber VARCHAR(100) 是 纳税人识别号
rows.phone VARCHAR(32) 是 开票电话
rows.bankName VARCHAR(100) 是 开户银行
rows.bankNumber VARCHAR(100) 是 银行账号
rows.typeName VARCHAR(100) 是 供应商类型名称
rows.remark VARCHAR(4000) 是 备注
rows.unitAddress VARCHAR(200) 是 单位地址

← 直营订单相关接口 →