实现店铺联系电话精确查询与索引

This commit is contained in:
2026-07-22 15:06:06 +09:00
parent 751cb46079
commit 2fd11daaf0
14 changed files with 904 additions and 64 deletions

View File

@@ -399,7 +399,7 @@ components:
DtoAgentOpenAPIWalletPackageOrderRequest:
properties:
card_nos:
description: 卡标识列表(支持 ICCID、虚拟号、MSISDN
description: 卡标识列表(支持 ICCID、虚拟号、MSISDN、设备 IMEI传入设备 IMEI 时自动转为设备维度购买
items:
type: string
maxItems: 100
@@ -460,6 +460,14 @@ components:
description: 总记录数
type: integer
type: object
DtoAgentRechargeRejectParams:
properties:
rejection_reason:
description: 驳回原因必填最多500字
type: string
required:
- rejection_reason
type: object
DtoAgentRechargeResponse:
properties:
agent_wallet_id:
@@ -499,11 +507,21 @@ components:
description: 第三方支付流水号
type: string
payment_voucher_key:
description: 支付凭证对象存储Key线下支付时存在
type: string
description: 支付凭证对象存储Key列表(线下支付时存在最多5个
items:
type: string
nullable: true
type: array
recharge_no:
description: 充值单号(ARCH前缀)
type: string
rejection_reason:
description: 驳回原因,仅 status=6 时有值
nullable: true
type: string
remark:
description: 运营备注
type: string
shop_id:
description: 店铺ID
minimum: 0
@@ -512,7 +530,7 @@ components:
description: 店铺名称
type: string
status:
description: 状态 (1:待支付, 2:已支付, 3:已完成, 4:已关闭, 5:已退款)
description: 状态 (1:待支付, 2:已支付, 3:已完成, 4:已关闭, 5:已退款, 6:已驳回)
type: integer
status_name:
description: 状态名称(中文)
@@ -1722,6 +1740,14 @@ components:
switch_mode:
description: 切卡模式0=自动1=手动(设备类型时有效)
type: string
total_virtual_remaining_mb:
description: 当前世代所有套餐虚剩余之和MB未请求时为 null
nullable: true
type: number
total_virtual_used_mb:
description: 当前世代所有套餐虚已用之和MB未请求时为 null
nullable: true
type: number
updated_at:
description: 更新时间
format: date-time
@@ -3112,9 +3138,12 @@ components:
description: 支付方式 (wallet:钱包支付, offline:线下支付)
type: string
payment_voucher_key:
description: 线下支付凭证对象存储file_keypayment_method=offline时必填,通过/storage/upload-url上传图片后获得
maxLength: 500
type: string
description: 线下支付凭证对象存储file_key列表payment_method=offline时至少1个最多5个,通过/storage/upload-url上传图片后获得
items:
type: string
maxItems: 5
nullable: true
type: array
required:
- identifier
- package_ids
@@ -3131,7 +3160,15 @@ components:
description: 支付方式 (wechat:微信在线支付, offline:线下转账仅平台可用)
type: string
payment_voucher_key:
description: 支付凭证对象存储Keypayment_method=offline 时必填,微信支付时忽略)
description: 支付凭证对象存储Key列表payment_method=offline 时至少1个最多5个,微信支付时忽略)
items:
type: string
maxItems: 5
nullable: true
type: array
remark:
description: 运营备注(可选,创建后只读)
maxLength: 1000
type: string
shop_id:
description: 目标店铺ID代理只能填自己店铺
@@ -3399,6 +3436,26 @@ components:
description: 提现单号
type: string
type: object
DtoCreateOrderPackageInvalidateTaskRequest:
properties:
file_key:
description: CSV文件对象存储Key通过/storage/upload-url上传后获得CSV单列 order_no
maxLength: 500
type: string
remark:
description: 运营备注(可选,创建后只读)
maxLength: 1000
type: string
voucher_keys:
description: 支付凭证对象存储Key列表可选最多5个
items:
type: string
maxItems: 5
nullable: true
type: array
required:
- file_key
type: object
DtoCreatePackageRequest:
properties:
calendar_type:
@@ -3641,10 +3698,13 @@ components:
maxLength: 1000
type: string
refund_voucher_key:
description: 退款凭证对象存储file_key通过/storage/upload-url上传图片后获得
maxLength: 500
minLength: 1
type: string
description: 退款凭证对象存储file_key列表至少1个最多5个通过/storage/upload-url上传图片后获得
items:
type: string
maxItems: 5
minItems: 1
nullable: true
type: array
requested_refund_amount:
description: 申请退款金额(分)
minimum: 1
@@ -4368,6 +4428,9 @@ components:
description: 创建时间
format: date-time
type: string
creator_name:
description: 操作人姓名
type: string
error_message:
description: 错误信息
type: string
@@ -4443,6 +4506,9 @@ components:
description: 创建时间
format: date-time
type: string
creator_name:
description: 操作人姓名
type: string
error_message:
description: 错误信息
type: string
@@ -5600,6 +5666,9 @@ components:
description: 创建时间
format: date-time
type: string
creator_name:
description: 操作人姓名
type: string
error_message:
description: 错误信息
type: string
@@ -5679,6 +5748,9 @@ components:
description: 创建时间
format: date-time
type: string
creator_name:
description: 操作人姓名
type: string
error_message:
description: 错误信息
type: string
@@ -5719,6 +5791,18 @@ components:
description: 总数
type: integer
type: object
DtoInvalidateFailedItem:
properties:
line:
description: CSV 行号
type: integer
order_no:
description: 订单号
type: string
reason:
description: 失败原因
type: string
type: object
DtoJSSDKConfigResponse:
properties:
app_id:
@@ -6179,6 +6263,144 @@ components:
description: 总数
type: integer
type: object
DtoOrderPackageInvalidateTaskDetailResponse:
properties:
completed_at:
description: 完成时间
nullable: true
type: string
created_at:
description: 创建时间
type: string
creator_name:
description: 操作人姓名
type: string
error_message:
description: 任务级错误信息
type: string
fail_count:
description: 失败数
type: integer
failed_items:
description: 失败记录列表
items:
$ref: '#/components/schemas/DtoInvalidateFailedItem'
nullable: true
type: array
file_name:
description: 原始文件名
type: string
id:
description: 任务ID
minimum: 0
type: integer
remark:
description: 运营备注
type: string
started_at:
description: 开始处理时间
nullable: true
type: string
status:
description: 任务状态 (1:待处理, 2:处理中, 3:已完成, 4:失败)
type: integer
status_name:
description: 状态名称(中文)
type: string
success_count:
description: 成功数
type: integer
task_no:
description: 任务编号
type: string
total_count:
description: 总行数
type: integer
updated_at:
description: 更新时间
type: string
voucher_keys:
description: 支付凭证Key列表
items:
type: string
nullable: true
type: array
type: object
DtoOrderPackageInvalidateTaskListResponse:
properties:
items:
description: 任务列表
items:
$ref: '#/components/schemas/DtoOrderPackageInvalidateTaskResponse'
nullable: true
type: array
page:
description: 当前页码
type: integer
size:
description: 每页条数
type: integer
total:
description: 总记录数
type: integer
type: object
DtoOrderPackageInvalidateTaskResponse:
properties:
completed_at:
description: 完成时间
nullable: true
type: string
created_at:
description: 创建时间
type: string
creator_name:
description: 操作人姓名
type: string
error_message:
description: 任务级错误信息
type: string
fail_count:
description: 失败数
type: integer
file_name:
description: 原始文件名
type: string
id:
description: 任务ID
minimum: 0
type: integer
remark:
description: 运营备注
type: string
started_at:
description: 开始处理时间
nullable: true
type: string
status:
description: 任务状态 (1:待处理, 2:处理中, 3:已完成, 4:失败)
type: integer
status_name:
description: 状态名称(中文)
type: string
success_count:
description: 成功数
type: integer
task_no:
description: 任务编号
type: string
total_count:
description: 总行数
type: integer
updated_at:
description: 更新时间
type: string
voucher_keys:
description: 支付凭证Key列表
items:
type: string
nullable: true
type: array
type: object
DtoOrderResponse:
properties:
actual_paid_amount:
@@ -6291,8 +6513,11 @@ components:
description: 支付状态文本
type: string
payment_voucher_key:
description: 线下支付凭证对象存储file_key线下支付订单有值)
type: string
description: 线下支付凭证对象存储file_key列表(线下支付订单有值最多5个
items:
type: string
nullable: true
type: array
purchase_remark:
description: 购买备注
type: string
@@ -7355,8 +7580,11 @@ components:
description: 退款原因
type: string
refund_voucher_key:
description: 退款凭证对象存储file_key
type: string
description: 退款凭证对象存储file_key列表最多5个
items:
type: string
nullable: true
type: array
reject_reason:
description: 拒绝原因
type: string
@@ -7425,10 +7653,12 @@ components:
nullable: true
type: string
refund_voucher_key:
description: 退款凭证对象存储file_key重新提交时可替换历史记录缺失时必填
maxLength: 500
description: 退款凭证对象存储file_key列表(重新提交时可替换;历史记录缺失时必填最多5个
items:
type: string
maxItems: 5
nullable: true
type: string
type: array
requested_refund_amount:
description: 申请退款金额(分)
minimum: 1
@@ -10356,11 +10586,11 @@ paths:
minimum: 0
nullable: true
type: integer
- description: 按状态过滤 (1:待支付, 2:已支付, 3:已完成, 4:已关闭, 5:已退款)
- description: 按状态过滤 (1:待支付, 2:已支付, 3:已完成, 4:已关闭, 5:已退款, 6:已驳回)
in: query
name: status
schema:
description: 按状态过滤 (1:待支付, 2:已支付, 3:已完成, 4:已关闭, 5:已退款)
description: 按状态过滤 (1:待支付, 2:已支付, 3:已完成, 4:已关闭, 5:已退款, 6:已驳回)
nullable: true
type: integer
- description: 创建时间起始日期(YYYY-MM-DD)
@@ -10632,6 +10862,52 @@ paths:
summary: 确认线下充值
tags:
- 代理预充值
/api/admin/agent-recharges/{id}/reject:
post:
parameters:
- description: ID
in: path
name: id
required: true
schema:
description: ID
minimum: 0
type: integer
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/DtoAgentRechargeRejectParams'
responses:
"400":
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
description: 请求参数错误
"401":
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
description: 未认证或认证已过期
"403":
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
description: 无权访问
"500":
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
description: 服务器内部错误
security:
- BearerAuth: []
summary: 驳回代理充值订单
tags:
- 代理预充值
/api/admin/asset-allocation-records:
get:
parameters:
@@ -11990,6 +12266,12 @@ paths:
get:
description: 通过虚拟号/ICCID/IMEI/SN/MSISDN 解析设备或卡的完整详情。企业账号禁止调用。
parameters:
- description: 是否返回当前世代流量汇总字段total_virtual_used_mb / total_virtual_remaining_mb默认 false
in: query
name: include_usage_summary
schema:
description: 是否返回当前世代流量汇总字段total_virtual_used_mb / total_virtual_remaining_mb默认 false
type: boolean
- description: 资产标识符(虚拟号/ICCID/IMEI/SN/MSISDN
in: path
name: identifier
@@ -17426,6 +17708,219 @@ paths:
summary: 批量回收单卡
tags:
- IoT卡管理
/api/admin/order-package-invalidate-tasks:
get:
parameters:
- description: 页码默认1
in: query
name: page
schema:
description: 页码默认1
minimum: 1
type: integer
- description: 每页条数默认20最大100
in: query
name: page_size
schema:
description: 每页条数默认20最大100
maximum: 100
minimum: 1
type: integer
- description: 按状态过滤 (1:待处理, 2:处理中, 3:已完成, 4:失败)
in: query
name: status
schema:
description: 按状态过滤 (1:待处理, 2:处理中, 3:已完成, 4:失败)
maximum: 4
minimum: 1
nullable: true
type: integer
responses:
"200":
content:
application/json:
schema:
properties:
code:
description: 响应码
example: 0
type: integer
data:
$ref: '#/components/schemas/DtoOrderPackageInvalidateTaskListResponse'
msg:
description: 响应消息
example: success
type: string
timestamp:
description: 时间戳
format: date-time
type: string
required:
- code
- msg
- data
- timestamp
type: object
description: 成功
"400":
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
description: 请求参数错误
"401":
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
description: 未认证或认证已过期
"403":
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
description: 无权访问
"500":
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
description: 服务器内部错误
security:
- BearerAuth: []
summary: 查询订单套餐失效任务列表
tags:
- 订单套餐失效
post:
description: 上传单列 CSV 文件(列名 order_no批量将订单下的非终态套餐标记为已失效status=4
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/DtoCreateOrderPackageInvalidateTaskRequest'
responses:
"200":
content:
application/json:
schema:
properties:
code:
description: 响应码
example: 0
type: integer
data:
$ref: '#/components/schemas/DtoOrderPackageInvalidateTaskResponse'
msg:
description: 响应消息
example: success
type: string
timestamp:
description: 时间戳
format: date-time
type: string
required:
- code
- msg
- data
- timestamp
type: object
description: 成功
"400":
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
description: 请求参数错误
"401":
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
description: 未认证或认证已过期
"403":
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
description: 无权访问
"500":
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
description: 服务器内部错误
security:
- BearerAuth: []
summary: 创建订单套餐批量失效任务
tags:
- 订单套餐失效
/api/admin/order-package-invalidate-tasks/{id}:
get:
parameters:
- description: ID
in: path
name: id
required: true
schema:
description: ID
minimum: 0
type: integer
responses:
"200":
content:
application/json:
schema:
properties:
code:
description: 响应码
example: 0
type: integer
data:
$ref: '#/components/schemas/DtoOrderPackageInvalidateTaskDetailResponse'
msg:
description: 响应消息
example: success
type: string
timestamp:
description: 时间戳
format: date-time
type: string
required:
- code
- msg
- data
- timestamp
type: object
description: 成功
"400":
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
description: 请求参数错误
"401":
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
description: 未认证或认证已过期
"403":
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
description: 无权访问
"500":
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
description: 服务器内部错误
security:
- BearerAuth: []
summary: 查询订单套餐失效任务详情
tags:
- 订单套餐失效
/api/admin/orders:
get:
parameters:
@@ -22334,13 +22829,22 @@ paths:
description: 店铺名称模糊查询
maxLength: 100
type: string
- description: 店铺编号模糊查询
- description: 店铺编号精确查询
in: query
name: shop_code
schema:
description: 店铺编号模糊查询
description: 店铺编号精确查询
maxLength: 50
type: string
- description: 联系电话精确查询11位 ASCII 数字;空值不启用筛选;与其他条件按 AND 组合)
in: query
name: contact_phone
schema:
description: 联系电话精确查询11位 ASCII 数字;空值不启用筛选;与其他条件按 AND 组合)
maxLength: 11
minLength: 11
pattern: ^[0-9]{11}$
type: string
- description: 上级店铺ID
in: query
name: parent_id