接口文档
登录认证
1.登录 /wxapi/login/
"params": {
"data": {
"phone": 18056649222, # 用户手机号
"name": "微信小张张111" # 用户名
}
}
}
"code": 200,
"message": "登录成功！"
}
设备
1.设备列表 /wxapi/device/list/
"code": 200,
"message": "成功",
"data": [
{
"device_id": 1, # 设备iid
"name": "设备1", # 设备名称
"number": "123456", # 设备
"variant": "shebwei123",
"manufacturer": "设备厂家1",
"devote_date": "2025-04-13",
"person_responsible": "负责人1",
"device_image": false,
"remark": "备注1"
},
{
"device_id": 2,
"name": "设备2",
"number": "123456",
"variant": "shebwei123",
"manufacturer": "设备厂家2",
"devote_date": "2025-04-13",
"person_responsible": "负责人2",
"device_image": false,
"remark": "备注2"
}
]
}
2.设备详情 /wxapi/device/info/
"device_id": 1 # 设备id
}
返回
{
"code": 200,
"message": "成功",
"data": {
"device_id": 1, # 设备id
"name": "设备1", # 设备名称
"number": "123456", # 设备编号
"variant": "shebwei123", # 设备型号
"manufacturer": "设备厂家1", # 设备厂家
"devote_date": "2025-04-13", # 投入日期
"person_responsible": "负责人1", # 责任人
"device_image": "", # 设备图片
"remark": "备注1" # 备注
}
}
3.创建设备 /wxapi/device/create/
"params": {
"data": {
"name": "设备3", # 设备名称
"number": "123456", # 设备编号
"variant": "shebwei123", # 设备型号
"manufacturer": "设备厂家3", # 设备厂家
"devote_date": "2025-04-13", # 投入日期
"person_responsible": "负责人3", # 责任人
"device_image": "", # 设备图片
"remark": "备注2" # 备注
}
}
}
返回
{
"code": 200,
"message": "成功",
}
4.编辑设备 /wxapi/device/edit/
{
"params": {
"data": {
"device_id": 3, # 设备id
"name": "设备3", # 设备名称
"number": "123456", # 设备编号
"variant": "shebwei123", # 设备型号
"manufacturer": "设备厂家3", # 设备厂家
"devote_date": "2025-04-13", # 投入日期
"person_responsible": "负责人3", # 责任人
"device_image": "", # 设备图片
"remark": "备注2" # 备注
}
}
}
返回
{
"code": 200,
"message": "成功",
}
5.删除设备 /wxapi/device/delete/
{
"params": {
"data": {
"device_id": 3, # 设备id
}
}
}
返回
{
"code": 200,
"message": "成功",
}
发票抬头
1.发票抬头列表 /wxapi/invoice/header/list/
{
返回
{
"code": 200,
"message": "成功",
"data": [
{
"vat_id": 19743, # 发票抬头id
"name": "微信小张张发票抬头", # 抬头名称
"tax_number": "91310116MA7C87D14C", # 单位税号
"registered_addr": "上海市金山区枫泾镇环东一路65弄11号（枫泾经济小区）", # 注册地址
"registered_phone": "16712108008", # 注册电话
"deposit_bank": "中国农业银行股份有限公司上海昆冈支行", # 开户银行
"bank_account": "03801330040070487" # 银行账号
},
....
]
}
2.发票抬头详情 /wxapi/invoice/header/info/
{
"vat_id": 18845 # 发票抬头id
}
{
"code": 200,
"message": "成功",
"data": {
"vat_id": 19743, # 发票抬头id
"name": "微信小张张发票抬头", # 抬头名称
"tax_number": "91310116MA7C87D14C", # 单位税号
"registered_addr": "上海市金山区枫泾镇环东一路65弄11号（枫泾经济小区）", # 单位地址
"registered_phone": "16712108008", # 电话号码
"deposit_bank": "中国农业银行股份有限公司上海昆冈支行", # 开户银行
"bank_account": "03801330040070487" # 银行账户
}
}
3.创建发票抬头 /wxapi/invoice/header/create/
{
"params": {
"data": {
"name": "微信小张张发票抬头", # 抬头名称
"tax_number": "91310116MA7C87D14C", # 税号
"registered_addr": "上海市金山区枫泾镇环东一路65弄11号（枫泾经济小区）", # 单位地址
"registered_phone": "16712108008", # 电话号码
"deposit_bank": "中国农业银行股份有限公司上海昆冈支行", # 开户银行
"bank_account": "03801330040070487" # 银行账户
}
}
}
{
"code": 200,
"message": "创建完成"
}
4.修改发票抬头 /wxapi/invoice/header/edit/
{
"params": {
"data": {
"vat_id": 19744, # 发票抬头id
"name": "微信小张张发票抬头1", # 抬头名称
"tax_number": "91310116MA7C87D14C", # 税号
"registered_addr": "上海市金山区枫泾镇环东一路65弄11号（枫泾经济小区）", # 单位地址
"registered_phone": "16712108008", # 电话号码
"deposit_bank": "中国农业银行股份有限公司上海松江支行", # 开户银行
"bank_account": "03801330040070487" # 银行账户
}
}
}
{
"code": 200,
"message": "修改完成"
}
5.删除发票抬头 /wxapi/invoice/header/delete/
{
"params": {
"data": {
"vat_id": 19744, # 发票抬头id
}
}
}
{
"code": 200,
"result": "删除完成"
}
"code": 400,
"result": "该发票抬头不存在"
}
收货地址
1.收货地址列表 /wxapi/receive/address/list/
{
{
"code": 200,
"message": "成功",
"data": [
{
"address_shipping_id": 18777, # 收货地址id
"phone": "", # 收货手机号
"name": "刘华天", # 收货name
"state_city": "上海市上海市", # 市区
"cn_full_address": "上海市 上海市 嘉定区 安亭镇春归路372号", # 详细地址
"is_default_addr": false # 是否默认地址
}
]
}
2.收货地址详情 /wxapi/receive/address/info/
{
{
"code": 200,
"message": "成功",
"data": {
"address_shipping_id": 18777, # 收货地址id
"phone": "", # 收货手机号
"name": "刘华天", # 收货name
"state_city": "上海市上海市", # 市区
"cn_full_address": "上海市 上海市 嘉定区 安亭镇春归路372号", # 详细地址
"is_default_addr": false # 是否默认地址
}
}
3.创建收货地址 /wxapi/receive/address/create/
{
"params": {
"data": {
"name": "收货地址2", # 收件人
"phone": "18056649333", # 手机号
"area_addr": "上海市松江区", # 时区
"detail_addr": "松江工业园荣乐东路29号宏远智能自动化有限公司", # 详细地址
"is_default_addr": true # 是否默认地址
}
}
}
{
"code": 200,
"message": "创建完成"
}
4.修改收货地址 /wxapi/receive/address/edit/
{
"params": {
"data": {
"address_shipping_id": 19753, # 收货地址id
"name": "收货地址1", # 收货人
"phone": "18056649111", # 电话
"area_addr": "上海市松江区", # 时区
"detail_addr": "松江工业园荣乐东路29号宏远智能自动化有限公司", # 详细地址
"is_default_addr": true # 是否默认地址
}
}
}
{
"code": 200,
"message": "修改完成"
}
5.删除收货地址 /wxapi/receive/address/delete/
{
"params": {
"data": {
"address_shipping_id": 19754 # 收货地址id
}
}
}
{
"code": 200,
"message": "删除完成"
}
预约检修
1.检修单默认返回信息 /wxapi/receive/return/info/
{
返回
report_state：('need', '需要'), ('no_need', '不需要')
{
"code": 200,
"message": "成功",
"data": {
"repairer_name": "微信小张张", # 报修人
"repairer_phone": "18056649222", # 联系方式
"repairer_company_name": "", # 所属单位
"report_state": { # 维修报告
"name": "不需要", # 不需要 / 需要
"val": "no_need" # no_need / need
}
}
}
2.检修单创建 /wxapi/receive/create/
report_state：('need', '需要') ('no_need', '不需要')
{
"params": {
"data": {
"device_id": 1, # 设备id
"repair_desc": "坏了", # 故障描述
"vat_id": 19743, # 发票地址
"report_state": "need", # 检测报告
"address_shipping_id": 18772, # 收货地址
"express_no": "SF1541833925366", # 物流单号
"repairer_name": "报修人", # 报修人
"repairer_phone": 18056649999, # 报修联系电话
"repairer_company_name": "报修所属公司1", # 报修所属公司
"video": , # 视频
"images_list": [] # 图片列表
}
}
}
{
"code": 200,
"message": "创建成功"
}
3.检修单列表 /wxapi/receive/list/
{
state：('draft', '草稿'), ('register', '已登记'), ('to_test', '待测试'), ('done', '已完成'), ('cancel', '已取消')
{
"code": 200,
"message": "成功",
"data": [
{
"receive_id": 3451, # 检修登记单id
"name": "PC25041470", # 单据编号
"state": { # 状态
"name": "草稿", # 草稿 / 已登记 / 待测试 / 已完成 / 已取消
"val": "draft" # draft / register / to_test /done / cancel
},
"device_id": 1, # 设备id
"device_name": "设备1", # 设备名称
"repair_desc": "坏了", # 故障描述
"repairer_name": "报修人", # 报修人
"repairer_phone": "18056649999", # 联系电话
"repairer_company_name": "报修所属公司1" # 所属公司
},
{
"receive_id": 3450,
"name": "PC25041469",
"state": {
"name": "草稿",
"val": "draft"
},
"device_id": 1,
"device_name": "设备1",
"repair_desc": "坏了",
"repairer_name": "报修人",
"repairer_phone": "18056649999",
"repairer_company_name": "报修所属公司1"
}
]
}
4.检修单详情 /wxapi/receive/info/
{
"receive_id": 3451 # 维修单id
}
返回
mini_state: ('pending', '待受理'), ('accepted', '已受理'), ('wait_confirm', '待确认'), ('wait_repair', '待检修'), ('wait_balance', '待结算'), ('wait_deliver', '待交付'), ('done', '完成'), ('cancel', '已取消')
report_state：('need', '需要') ('no_need', '不需要')
delivery_state: ('self_pickup', '自提'), ('send', '寄送'),
{
"code": 200,
"message": "成功",
"data": {
"receive_id": 3451, # # 检修登记单id
"name": "PC25041470", # 单据编号
"mini_state": { # 状态
"name": "草稿", # 草稿
"val": "draft" # draft
},
"device_id": 1, # 设备id
"device_name": "设备1", # 设备name
"repair_desc": "坏了", # 故障描述
"report_state": { # 检测报告
"name": "需要", # 需要 / 不需要
"val": "need" # need / no_need
},
"express_no": "SF1541833925366", # 物流单号
"vat_id": 19743, # 发票id
"vat_name": "微信小张张", # 发票地址名称
"repairer_name": "报修人", # 报修人
"repairer_phone": "18056649999", # 联系方式
"repairer_company_name": "报修所属公司1", # 所属单位
"address_shipping_id": 18772, # 收货地址
"address_shipping_addr": "上海市 上海市 嘉定区 安亭镇春归路372号", # 送货地址详细地址
"video": "", # 视频
"images_list": [], # 图片
"create_date": "2025-04-14 14:15:49", # 订单提交时间
"accepted_date": null, # 订单受理时间
"device_test_date": null, # 设备测试时间
"quotation_confirm_date": null, # 报价确认时间
"repaired_date": null, # 检修完成时间
"order_balance_date": null, # 订单结算时间
"order_deliver_date": null, # 订单交付时间
"order_done_date": null, # 订单完成时间
"fault_desc_list": ['故障描述1', '故障描述1'], # 故障详细列表
"repair_order_price_dict": { # 费用
"amount_total": 0, # 价格总计
"repair_order_price_line": [{
"project_name" : "费用明细名称1", # 费用明细名称
"price" : 0 # 费用明细价格
}] # 价格明细
},
"delivery_method": { # 配送方式
"name": "", # 自提 / 寄送
"val": "" # self_pickup / send
},
"self_pickup_date": "2025-04-16", # 自提日期
"week_str": "周三", # 自提周期
"self_pickup_time_str": "13:00 - 17:30" # 自提时间段
}
}
5.检修单撤销 /wxapi/receive/cancel/
{
"receive_id": 3452 # 维修单id
}
返回
{
"code": 200,
"message": "成功",
}
6.检修单结算创建 /wxapi/receive/balance/create/
{
"params": {
"data": {
"receive_id": 3451, # 检修登记单id
"trade_pic": null, # 交易凭证
"balance_remark": "结算备注" # 结算备注
}
}
}
返回
{
"code": 200,
"message": "成功"
}
7.检修单提货默认 /wxapi/receive/delivery/default/
{
"receive_id": 3452 # 维修单id
}
返回
{
"code": 200,
"message": "成功",
"data": {
"delivery_method": "self_pickup", # 提货方式
"self_pickup_addr": { # 自提地址
"address_shipping_id": 19744, # 地址id
"phone": "", # 电话
"name": "微信小张张发票抬头1", # 名称
"cn_full_address": "上海市 上海市 松江区 中山街道南乐路168号第D12幢一楼" # 地址
},
"address_shipping": { # 收货地址
"address_shipping_id": 19744, # 地址id
"phone": "", # 电话
"name": "微信小张张发票抬头1", # 名称
"state_city": "上海市上海市", # 时区
"cn_full_address": "上海市 上海 市 松江区 中山街道南乐路168号第D12幢一楼", # 详细地址
"is_default_addr": false # 是否默认地址
}
}
}
8.检修单提货创建 /wxapi/receive/delivery/create/
delivery_method：('self_pickup', '自提'), ('send', '寄送')
{
"params": {
"data": {
"receive_id": 3451, # 检修登记单id
"delivery_method": "send", # 配送方式
"self_pickup_date": "2025-04-16", # 自提日期
"self_pickup_time_str": "13:00 - 17:30", # 自提时间段
"address_shipping_id": 18772 # 收货地址
}
}
}
返回
{
"code": 200,
"message": "成功"
}
修改于 2025-04-17 09:18:48