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 返回。