Home - 外部联络人
最后修改者: huangyingliang 2026-08-04 17:49:27
删除外部联络人
编号 : 005
POST - https://fl.tp6.hyj111.cn/admin/externalContact/del
headers下token必传
请求参数
| 参数名 | 参数类型 | 必传 | 缺省值 | 描述 |
|---|---|---|---|---|
| id | int | Y | 外部联络人ID |
返回值
{
"status": 200,
"msg": "删除外部联络人成功",
"data": []
}
备注
软删除外部联络人,写入 bbc_external_contact.delete_time。
最后修改者: huangyingliang 2026-08-04 17:49:27
修改外部联络人启用状态
编号 : 004
POST - https://fl.tp6.hyj111.cn/admin/externalContact/changeState
headers下token必传
请求参数
| 参数名 | 参数类型 | 必传 | 缺省值 | 描述 |
|---|---|---|---|---|
| id | int | Y | 外部联络人ID | |
| state | int | Y | 状态:0=禁用,1=启用 |
返回值
{
"status": 200,
"msg": "修改外部联络人状态成功",
"data": []
}
备注
修改外部联络人启用状态,state=1 表示启用,state=0 表示禁用。
最后修改者: huangyingliang 2026-08-04 17:49:27
编辑外部联络人
编号 : 003
POST - https://fl.tp6.hyj111.cn/admin/externalContact/edit
headers下token必传
请求参数
| 参数名 | 参数类型 | 必传 | 缺省值 | 描述 |
|---|---|---|---|---|
| id | int | Y | 外部联络人ID | |
| payee_name | string | Y | 收款人信息 | |
| bank_account | string | Y | 卡号 | |
| bank_name | string | Y | 开户行 | |
| keyword | string | Y | 关键词,可以选择付款类目名称,也可以手动输入 |
返回值
{
"status": 200,
"msg": "编辑外部联络人成功",
"data": []
}
备注
编辑外部联络人;关键词可以选择付款类目名称,也可以手动输入,不再绑定付款类目ID;收款人信息允许重复,同一关键词下卡号不能重复,不同关键词允许使用同一卡号。
最后修改者: huangyingliang 2026-08-04 17:49:27
添加外部联络人
编号 : 002
POST - https://fl.tp6.hyj111.cn/admin/externalContact/add
headers下token必传
请求参数
| 参数名 | 参数类型 | 必传 | 缺省值 | 描述 |
|---|---|---|---|---|
| payee_name | string | Y | 收款人信息 | |
| bank_account | string | Y | 卡号 | |
| bank_name | string | Y | 开户行 | |
| keyword | string | Y | 关键词,可以选择付款类目名称,也可以手动输入 |
返回值
{
"status": 200,
"msg": "添加外部联络人成功",
"data": {
"id": 1
}
}
备注
新增外部联络人;关键词可以选择付款类目名称,也可以手动输入,不再绑定付款类目ID;收款人信息允许重复,同一关键词下卡号不能重复,不同关键词允许使用同一卡号。
最后修改者: huangyingliang 2026-08-04 17:49:27
外部联络人列表
编号 : 001
GET - https://fl.tp6.hyj111.cn/admin/externalContact/lists
headers下token必传
请求参数
| 参数名 | 参数类型 | 必传 | 缺省值 | 描述 |
|---|---|---|---|---|
| page | int | N | 1 | 页码 |
| pageSize | int | N | 10 | 每页显示数 |
| id | int | N | 外部联络人ID | |
| keyword | string | N | 收款人信息/卡号/开户行/关键词 | |
| payee_name | string | N | 收款人信息 | |
| bank_account | string | N | 卡号 | |
| bank_name | string | N | 开户行 | |
| payment_category_id | int | N | 付款类目ID,仅用于筛选历史关联数据 | |
| state | int | N | 状态:0=禁用,1=启用 |
返回值
{
"status": 200,
"msg": "获取外部联络人列表成功",
"data": {
"total": 1,
"per_page": 10,
"current_page": 1,
"last_page": 1,
"data": [
{
"id": 1,
"payee_name": "顺丰快递",
"bank_account": "6222 0000 0000 0000",
"bank_name": "招商银行南通支行",
"keyword": "办公费",
"payment_category_id": 149,
"payment_category_name": "办公费",
"state": 1,
"created_at": "2026-07-23 10:00:00",
"updated_at": "2026-07-23 10:00:00"
}
]
}
}
备注
分页查询外部联络人;可通过 state=1 查询启用数据,通过 state=0 查询禁用数据;keyword 会模糊匹配收款人信息、卡号、开户行、关键词及历史付款类目名称;keyword 可以选择付款类目名称,也可以手动输入,新建和编辑不再绑定付款类目ID;历史付款类目关联仍通过 payment_category_id 和 payment_category_name 返回。