itfx(接口通)枚举说明
本文档含两部分:itfx 接口通枚举(下文)与 OMS 数据字典枚举(见文末「OMS 数据字典枚举说明」)。
与后端 itfx-master / InterfaceForward.Domain.Shared.Enum 保持一致。
前端常量见 src/constants/itfxEnums.ts。
获取方式
运行时(下拉选项)
GET api/Dictionary/GetList?type={枚举名}
返回:
[
{ "key": 1, "value": "String" }
]
- 有
[Description] 的枚举成员,value 取 Description
- 否则
value 取枚举成员名
编译期(TypeScript 常量)
import {
FieldPosition,
ParameterType,
ItfxDictionaryType,
} from '@/constants/itfxEnums';
枚举总览
| 枚举名 |
Dictionary type |
用途 |
| ServiceProviderType |
✅ |
服务商类型 |
| RequestProtocol |
✅ |
请求协议 |
| RequestMethod |
✅ |
HTTP 方法 |
| ContentType |
✅ |
请求 Content-Type |
| ResponseContentType |
✅ |
响应 Content-Type |
| ParameterType |
✅ |
参数数据类型 |
| ParameterPlaceholder |
✅ |
固定参数占位符 |
| ParameterParseTypeEnum |
✅ |
参数解析格式 |
| FieldPosition |
✅ |
字段位置 |
| FieldOwner |
❌ |
字段所属(仅 DTO) |
| AuthParameterFlag |
✅ |
授权参数标识 |
| EffectTimeUnit |
✅ |
Token 有效时间单位 |
| InterfaceReturnConfigType |
✅ |
接口返回配置 |
| LabelType |
✅ |
标签类型 |
| OptionType |
✅ |
增删改操作 |
| LogListInputTypeEnum |
✅ |
日志筛选 |
1. 服务商 / 接口基础
ServiceProviderType — 服务商类型
| 值 |
名称 |
| 1 |
运输服务商 |
| 2 |
轨迹服务商 |
| 3 |
关务服务商 |
| 4 |
保险服务商 |
RequestProtocol — 请求协议
| 值 |
名称 |
| 1 |
Http |
| 2 |
Https |
| 3 |
WCF |
| 4 |
SOAP |
RequestMethod — HTTP 方法
| 值 |
名称 |
| 1 |
GET |
| 2 |
POST |
| 3 |
PUT |
| 4 |
DELETE |
| 5 |
OPTIONS |
| 6 |
HEAD |
| 7 |
PATCH |
2. 请求 / 响应 Content-Type
ContentType — 请求体类型
| 值 |
名称 |
脚本注意 |
| 1 |
FormUrlEncoded |
用 obj.FormFieldList |
| 2 |
FormData |
表单上传 |
| 3 |
Json |
用 obj.OriginalInterfaceMappedInput |
| 4 |
Xml |
XML 请求体 |
| 0 |
None |
无 HTTP Body,仅 Query / Header |
ResponseContentType — 响应体类型
| 值 |
名称 |
| 1 |
Json |
| 2 |
Xml |
| 3 |
pdf |
| 4 |
Base64 |
| 5 |
csv |
3. 参数相关
ParameterType — 参数数据类型
| 值 |
名称 |
| 1 |
String |
| 2 |
Float |
| 3 |
Object |
| 4 |
Boolean |
| 5 |
Array |
| 6 |
Integer |
| 7 |
DateTime |
| 8 |
DateTimeOffset |
ParameterPlaceholder — 固定参数占位符
| 值 |
枚举名 |
实际占位符 |
| 1 |
FromAccount |
$FromAccount |
| 2 |
FromBody |
$FromBody |
| 3 |
TimeStamp |
$TimeStamp |
| 4 |
DateTime |
$DateTime |
| 5 |
Url |
$Url |
| 6 |
Token |
$token |
占位符在 ReplacePlaceholder 阶段替换,早于 PrefixScript 执行。
ParameterParseTypeEnum — 参数解析类型
FieldPosition — 字段位置
| 值 |
名称 |
说明 |
| 1 |
Header |
请求头 |
| 2 |
Body |
请求体 |
| 3 |
Query |
Query 参数 |
| 4 |
Url |
URL 路径 |
| 5 |
Nothing |
不处理 |
前置脚本示例(Header):
for (int i = 0; i < obj.FixedFieldList.Count; i++) {
if (obj.FixedFieldList[i].FieldPosition == 1
&& obj.FixedFieldList[i].FieldName == "sign") {
obj.FixedFieldList[i].FieldValue = sign;
break;
}
}
FieldOwner — 字段所属
itfx 遗留枚举,0 为 ServiceProvider 业务值(非 None)。OMS 自有数值字典不适用此规则。
| 值 |
名称 |
| 0 |
ServiceProvider |
| 1 |
Interface |
| 2 |
AuthConfig |
4. 授权 / Token
AuthParameterFlag — 授权参数标识
| 值 |
名称 |
说明 |
| 1 |
InParameter |
入参 |
| 2 |
Token |
授权令牌 |
| 3 |
EffectTime |
有效时间 |
| 4 |
FixedEffectTime |
固定有效时间 |
| 5 |
PrefixScript |
前置脚本 |
| 6 |
PostfixScript |
后置脚本 |
EffectTimeUnit — 有效时间单位
| 值 |
名称 |
| 1 |
Second |
| 2 |
Minute |
| 3 |
Hour |
5. 接口返回 / 标签
InterfaceReturnConfigType — 接口返回配置
| 值 |
名称 |
| 1 |
StatusCode(状态码) |
| 2 |
PdfLabel(PDF 标签上传) |
| 3 |
ErrorMsg(错误信息返回) |
LabelType — 标签类型
6. 通用 / 日志
OptionType — 操作类型
LogListInputTypeEnum — 日志筛选
前置 / 后置脚本相关速查
| 场景 |
关键枚举 / 字段 |
| Header 签名 |
FieldPosition.Header (=1) → obj.FixedFieldList |
| Query 签名 |
FieldPosition.Query (=3) → obj.FixedFieldList |
| JSON Body 字段 |
ContentType.Json (=3) → obj.OriginalInterfaceMappedInput |
| Form 签名 |
ContentType.FormUrlEncoded (=1) → obj.FormFieldList |
| 账户密钥 |
obj.GetAccountFieldValueOrNull("字段名") |
| 时间戳占位 |
固定参数配 $TimeStamp,脚本阶段已替换 |
后端源码位置
itfx-master/src/InterfaceForward.Domain.Shared/Enum/*.cs
itfx-master/src/InterfaceForward.Domain.Shared/Dtos/FixedFieldWithValueDto.cs (FieldOwner)
itfx-master/src/InterfaceForward.Application/Services/App/DictionaryService.cs
OMS 数据字典枚举说明
与后端 oms0414-back 中 *Codes / Enums 及前端 src/views/system/dict/dict-batch-import.ts 预置种子对齐。
业务字典落库表 t_dict,唯一键为 dictType + dictCode。
获取方式
运行时(下拉 / 展示)
GET /system/dict/list?dictType={字典类型}
GET /system/dict/list?dictType={字典类型}&page=1&pageSize=500 # 分页拉全量
出参字段:dictType、dictCode、dictName、dictSort。
批量导入
系统管理 → 数据字典 → 下载预置模板 / OMS预置字典模板 / 批量导入。
Excel 表头(与 DICT_IMPORT_HEADERS 一致):
规则:
- 同一
dictType 下 dictCode 唯一;不同 dictType 可重复相同数字编码(如均为 1/2)。
- 数值 dictCode 从 1 起编;
0 表示 None/未设置,不写入字典种子,也不作为业务状态展示项。
- 通用是否:
yes_no;禁用/启用:enable_status;发布快照操作类型:operator_type。
- 子账号状态与客户主表状态编码一致,复用
customer_status。
种子数据源码:src/views/system/dict/dict-batch-import.ts → OMS_DICT_BATCH_SEED。
字典总览
| dictType |
预置种子 |
后端来源 |
用途 |
| yes_no |
✅ |
多处 0/1 布尔 |
通用是否 |
| enable_status |
✅ |
EnableStatus |
启用/禁用 |
| order_status |
✅ |
OrderStatusCodes |
订单主状态 |
| cargo_attribute |
✅ |
CargoAttributeCodes |
货物属性 |
| order_weight_type |
✅ |
OrderWeightTypeCodes |
件重尺类型 |
| order_fee_type |
✅ |
OrderFeeTypeCodes |
应收/应付 |
| currency |
✅ |
订单/费用字段 |
币种 |
| order_template_type |
✅ |
OrderTemplate.Type |
订单模板类型 |
| scheme |
✅ |
AllocationSchemeCodes |
排货方案 |
| area_type |
✅ |
AreaTypeCodes |
KPI 分区类型 |
| operator_type |
✅ |
price / rules 常量 |
发布快照操作类型 |
| forecast_type |
✅ |
ServiceChannel.ForecastType |
渠道预报类型 |
| cost_unit |
✅ |
价格项 CostUnit |
计费单位 |
| calculation_formula |
✅ |
ParcelBillingCalculator |
计算公式 |
| billable_weight |
✅ |
WeightRuleInfo.BillableWeight |
计重取值 |
| weight_rule_condition |
✅ |
WeightRuleInfo.Condition |
计重条件表达式 |
| sales_product_group |
✅ |
OrderService.ParcelQuote |
卖价分组 |
| customer_waybill |
✅ |
SalesProduct.CustomerWaybill |
客户面单类型 |
| label_template_type |
✅ |
LabelTemplate.TemplateType |
面单模板类型 |
| number_type |
✅ |
LabelPrintService |
打印号码类型 |
| auto_trigger_timing |
✅ |
AutoTriggerTimingCodes |
自动触发时机 |
| auto_trigger_operation |
✅ |
AutoTrigger.Operation |
自动触发操作 |
| pricing_factor |
✅ |
卖价/买价因素 |
定价因素 |
| customer_status |
✅ |
CustomerStatus |
客户状态 |
| customer_group |
✅ |
CustomerGroup |
客户组 |
| recharge_status |
✅ |
RechargeStatus |
充值审核状态 |
| pay_type |
✅ |
PayType |
支付方式 |
| principal_type |
✅ |
OmsLoginType / NoticeService |
主体类型 |
| notice_type |
✅ |
NoticeService |
公告/站内信 |
| receiver_type |
✅ |
NoticeService |
接收方类型 |
| warehouse_type |
✅ |
WarehouseTypeCodes |
仓库类型 |
| es_snapshot_status |
✅ |
发布记录设计 |
快照生效状态 |
| publish_record_type |
✅ |
发布/回滚设计 |
发布记录类型 |
| order_task_status |
✅ |
OrderService.Helpers |
导入任务状态 |
| export_customs_mode |
✅ |
ExportCustomsModeCodes |
出口报关方式 |
| fee_item |
✅ |
前端/设计文档 |
费用项(CostItem) |
| order_handle_status |
✅ |
OrderHandleStatusCodes |
订单处理子状态 |
| order_source |
✅ |
OrderSourceCodes |
订单来源 |
| issue_type |
✅ |
IssueTypeCodes |
问题件类型 |
| issue_notify_method |
✅ |
IssueNotifyMethodCodes |
问题通知方式 |
| claim_type |
✅ |
ClaimTypeCodes |
理赔类型 |
| order_fee_charging_stage |
✅ |
OrderFeeChargingStageCodes |
费用计费阶段 |
| customer_address_type |
✅ |
CustomerAddressTypeCodes |
客户地址类型 |
| label_generate_status |
✅ |
LabelGenerateStatusCodes |
面单 PDF 生成状态 |
| order_stock_bind_type |
✅ |
OrderStockBindTypeCodes |
库存绑定类型 |
| order_stock_bind_status |
✅ |
OrderStockBindStatusCodes |
库存绑定状态 |
| warehouse_inbound_type |
✅ |
WarehouseInboundTypeCodes |
入库类型 |
| warehouse_receipt_status |
✅ |
WarehouseReceiptStatusCodes |
收货状态 |
| warehouse_parcel_lifecycle |
✅ |
WarehouseParcelLifecycleCodes |
包裹生命周期 |
| sales_store_auth_status |
✅ |
SalesStoreAuthStatusCodes |
店铺授权状态 |
| sales_store_fulfill_status |
✅ |
SalesStoreFulfillStatusCodes |
平台店铺履约状态 |
| order_batch_job_status |
✅ |
OrderBatchJobStatusCodes |
批量任务状态 |
| order_batch_job_item_status |
✅ |
OrderBatchJobItemStatusCodes |
批量任务明细状态 |
| order_template_mapping_status |
✅ |
OrderTemplateMappingStatus |
模板映射状态 |
| customer_account_flow_biz_type |
✅ |
CustomerAccountFlowBizTypes |
账户流水业务类型 |
| secret_level |
✅ |
DataPermConstants |
密级 |
| data_scope |
✅ |
DataPermConstants |
数据范围 |
| org_scope |
✅ |
DataPermConstants |
组织范围 |
| sales_product |
— |
主数据 API |
运输方式(动态) |
| warehouse |
— |
主数据 API |
仓库(动态) |
1. 预置种子(可直接导入)
以下项已在 OMS_DICT_BATCH_SEED 中,可在 OMS预置字典模板.xlsx 一键导入。
yes_no — 通用是否
| dictCode |
dictName |
| 1 |
否 |
| 2 |
是 |
enable_status — 启用状态
| dictCode |
dictName |
| 1 |
禁用 |
| 2 |
启用 |
order_status — 订单状态
| dictCode |
dictName |
后端常量 |
| draft |
草稿 |
OrderStatusCodes.Draft |
| predeclared |
已预报 |
Predeclared |
| received |
已收货 |
Received |
| pendingAllocation |
待排货 |
PendingAllocation |
| pendingPayment |
待支付 |
PendingPayment |
| pendingShip |
待发货 |
PendingShip |
| pendingOnline |
待上网 |
PendingOnline |
| shipping |
运输中 |
Shipping |
| deliverySuccess |
派送成功 |
DeliverySuccess |
| deliveryFailed |
派送失败 |
DeliveryFailed |
| problematic |
问题件 |
Problematic |
| deleted |
已删除 |
Deleted |
| claimed |
理赔件 |
Claimed |
| all |
全部 |
仅筛选用,不落库 |
cargo_attribute — 货物属性
| dictCode |
dictName |
| general |
普货 |
| electronics |
3C&带电 |
| sensitive |
敏感货 |
order_weight_type — 件重尺类型
| dictCode |
dictName |
| forecast |
预报 |
| receive |
收货 |
| ship |
发货 |
| downstream |
下游 |
order_fee_type — 费用类型
| dictCode |
dictName |
| receivable |
应收 |
| payable |
应付 |
currency — 币种
| dictCode |
dictName |
| RMB |
人民币 |
| USD |
美元 |
| EUR |
欧元 |
scheme — 排货方案
| dictCode |
dictName |
| costLowest |
成本最低 |
| timeFastest |
时效最快 |
| overallBest |
综合最优 |
operator_type — 发布操作类型
| dictCode |
dictName |
说明 |
| price |
价格 |
卖价/买价快照 |
| rules |
规则 |
规则快照 |
forecast_type — 预报类型
| dictCode |
dictName |
| customer |
客户单号 |
| waybill |
运单号 |
| tracking |
跟踪号 |
cost_unit — 计费单位
| dictCode |
dictName |
| kg |
千克 |
| ticket |
票 |
| piece |
件 |
calculation_formula — 计算公式
| dictCode |
dictName |
说明 |
| total |
总价 |
|
| unit |
单价 |
|
| continue_unit |
续单价 |
后端归一化可能为 continue,见差异说明 |
billable_weight — 计重取值
| dictCode |
dictName |
| vw |
体积重 |
| gw |
实重 |
weight_rule_condition — 计重条件
| dictCode |
dictName |
| gw<=vw |
实重≤体积重 |
| gw>vw |
实重>体积重 |
| gw<vw |
实重<体积重 |
| gw>=vw |
实重≥体积重 |
| gw==vw |
实重=体积重 |
sales_product_group — 卖价分组
| dictCode |
dictName |
| line |
专线 |
| express |
快递 |
| postal |
邮政 |
customer_waybill — 客户面单
| dictCode |
dictName |
| system |
系统面单 |
| customer |
客户面单 |
label_template_type — 面单模板类型
| dictCode |
dictName |
| lastMile |
尾程 |
| customer |
客户 |
| inbound |
入库 |
| outbound |
出库 |
| sku |
SKU |
number_type — 打印号码类型
| dictCode |
dictName |
说明 |
| waybill |
运单号 |
|
| customerOrder |
客户单号 |
后端别名 customerorder |
| tracking |
跟踪号 |
|
| other |
其他单号 |
|
| parcel |
包裹跟踪号 |
后端使用,预置待补 |
| sku |
SKU |
后端使用,预置待补 |
| auto |
自动识别 |
后端使用,预置待补 |
auto_trigger_timing — 自动触发时机
| dictCode |
dictName |
| order_create |
下单 |
| inbound |
入库 |
| outbound |
出库 |
auto_trigger_operation — 自动触发操作
| dictCode |
dictName |
| intercept |
拦截 |
| warn |
警告 |
| problem |
问题件 |
pricing_factor — 定价因素
| dictCode |
dictName |
| cargo |
货物类型 |
| zone |
分区 |
| weight |
重量 |
| warehouse |
仓库 |
| customer |
客户 |
customer_status — 客户状态
| dictCode |
dictName |
后端 enum |
| 1 |
禁用 |
CustomerStatus.Disabled |
| 2 |
正常 |
Normal |
| 3 |
冻结 |
Frozen |
0 = CustomerStatus.None(未设置),不入字典。
customer_group — 客户组
| dictCode |
dictName |
后端 enum |
| 1 |
普通客户 |
CustomerGroup.Normal |
| 2 |
VIP1 |
Vip1 |
| 3 |
VIP2 |
Vip2 |
| 4 |
VIP3 |
Vip3 |
| 5 |
VIP4 |
Vip4 |
| 6 |
VIP5 |
Vip5 |
0 = CustomerGroup.None(未设置),不入字典。
recharge_status — 充值审核状态
| dictCode |
dictName |
后端 enum |
| 1 |
待审核 |
RechargeStatus.Pending |
| 2 |
审核通过 |
Approved |
| 3 |
审核驳回 |
Rejected |
0 = RechargeStatus.None(未设置),不入字典。
pay_type — 支付方式
| dictCode |
dictName |
后端 enum |
| 1 |
微信 |
PayType.Wechat |
| 2 |
支付宝 |
Alipay |
0 = PayType.None(未设置),不入字典。
principal_type — 主体类型
| dictCode |
dictName |
| user |
内部用户 |
| customer |
客户 |
notice_type — 通知类型
| dictCode |
dictName |
| notice |
公告 |
| message |
站内信 |
receiver_type — 接收方类型
| dictCode |
dictName |
| user |
用户 |
| customer |
客户 |
warehouse_type — 仓库类型
| dictCode |
dictName |
| main |
主仓 |
| transit |
中转仓 |
| return |
退货仓 |
| other |
其他 |
es_snapshot_status — 快照生效状态
| dictCode |
dictName |
| active |
生效 |
| inactive |
失效 |
publish_record_type — 发布记录类型
| dictCode |
dictName |
| publish |
发布 |
| rollback |
回滚 |
order_task_status — 订单导入任务状态
| dictCode |
dictName |
| pending |
待处理 |
| processing |
处理中 |
| completed |
已完成 |
area_type — 分区类型
| dictCode |
dictName |
| blacklist |
黑名单区 |
| remote |
偏远分区 |
| warning |
警告区 |
order_template_type — 订单模板类型
| dictCode |
dictName |
| standard |
标准模板 |
| custom |
自定义模板 |
2. 建议补充导入(后端已有常量,预置未含)
export_customs_mode — 出口报关方式
| dictCode |
dictName |
| 9610Simple |
9610简易申报 |
| 9610Summary |
9610汇总申报 |
| 9610Separate |
9610分离申报 |
| 9710 |
9710 |
| 9810 |
9810 |
| 0110 |
0110 |
fee_item — 费用项
业务可配置字典;前端渠道/订单页已引用,编码由运营维护,后端无 *Codes 类。
order_handle_status — 订单处理子状态
| dictCode |
dictName |
| pending |
待处理 |
| processed |
已处理 |
order_source — 订单来源
| dictCode |
dictName |
| manual |
手工录入 |
| pickup |
揽收 |
| upload |
上传 |
| batch |
批量 |
| platform |
平台店铺 |
issue_type — 问题件类型
| dictCode |
dictName |
| address |
地址异常 |
| customs |
清关问题 |
| weight |
重量异常 |
| document |
单证不全 |
| cargo |
货物异常 |
| channel |
渠道异常 |
| payment |
费用异常 |
| other |
其他 |
issue_notify_method — 问题通知方式
| dictCode |
dictName |
| inApp |
站内信 |
| email |
邮件 |
| sms |
短信 |
| feishu |
飞书 |
| wechat |
微信 |
claim_type — 理赔类型
| dictCode |
dictName |
| lost |
丢件 |
| damaged |
破损 |
| delay |
延误 |
| customs |
清关理赔 |
| fee |
费用争议 |
| other |
其他 |
order_fee_charging_stage — 费用计费阶段
| dictCode |
dictName |
| forecast |
预报 |
| inbound |
入库 |
| outbound |
出库 |
customer_address_type — 客户地址类型
| dictCode |
dictName |
| sender |
发件 |
| return |
退件 |
| receiver |
收件 |
label_generate_status — 面单 PDF 生成状态
| dictCode |
dictName |
说明 |
| Pending |
待生成 |
PascalCase,与多数 camelCase 不一致 |
| Ready |
已就绪 |
|
| Failed |
生成失败 |
|
order_stock_bind_type — 库存绑定类型
| dictCode |
dictName |
| inventory |
库存 |
| parcelItem |
包裹明细 |
order_stock_bind_status — 库存绑定状态
| dictCode |
dictName |
| bound |
已绑定 |
| deducted |
已扣减 |
| released |
已释放 |
warehouse_inbound_type — 入库类型
| dictCode |
dictName |
| normal |
正常入库 |
| return |
退货入库 |
warehouse_receipt_status — 收货状态
| dictCode |
dictName |
| forecasted |
已预报 |
| received |
已收货 |
| completed |
已完成 |
warehouse_parcel_lifecycle — 包裹生命周期
| dictCode |
dictName |
| inTransit |
在途 |
| arrived |
已到仓 |
| stored |
已上架 |
sales_store_auth_status — 店铺授权状态
| dictCode |
dictName |
| active |
有效 |
| expired |
已过期 |
| revoked |
已撤销 |
sales_store_fulfill_status — 平台店铺履约状态
| dictCode |
dictName |
| pending |
待处理 |
| toShip |
待发货 |
| canceled |
已取消 |
| suspended |
挂起 |
| shipped |
已发货 |
| completed |
已完成 |
order_batch_job_status — 批量任务状态
| dictCode |
dictName |
| pending |
待处理 |
| running |
执行中 |
| completed |
已完成 |
| failed |
失败 |
| cancelled |
已取消 |
order_batch_job_item_status — 批量任务明细状态
| dictCode |
dictName |
| pending |
待处理 |
| running |
执行中 |
| success |
成功 |
| failed |
失败 |
| cancelled |
已取消 |
order_template_mapping_status — 模板映射状态
| dictCode |
dictName |
| draft |
草稿 |
| ready |
就绪 |
customer_account_flow_biz_type — 账户流水业务类型
| dictCode |
dictName |
| recharge |
充值入账 |
| orderPay |
订单支付 |
secret_level — 密级
| dictCode |
dictName |
| 1 |
公开 |
| 2 |
内部 |
| 3 |
机密 |
| 4 |
绝密 |
data_scope — 数据范围
| dictCode |
dictName |
| 1 |
个人 |
| 2 |
小组 |
| 3 |
部门 |
| 4 |
组织树 |
| 5 |
全局 |
org_scope — 组织范围
| dictCode |
dictName |
| 1 |
仅本级 |
| 2 |
本级及下级 |
3. 小红书模块(按需)
| dictType |
dictCode 示例 |
dictName 示例 |
| xhs_agent_status |
online / offline |
在线 / 离线 |
| xhs_task_status |
pending / claimed / running / succeeded / failed / cancelled |
任务状态 |
| xhs_publish_status |
draft / scheduled / publishing / succeeded / failed / cancelled |
发布状态 |
| xhs_task_type |
engine_start / publish / browse … |
任务类型 |
| xhs_task_source |
web / schedule / skill |
任务来源 |
| xhs_analysis_type |
home_feed / search / my_feeds / feed_detail |
分析类型 |
源码:Oms.Domain/XhsAggregate/Consts/XhsCodes.cs。
4. 预置与后端差异(导入前建议对齐)
数值编码约定(0 = None)
OMS 数值 dictCode 与 C# byte 枚举 对齐规则:
| 约定 |
说明 |
0 |
None / 未设置,不写入 t_dict 种子 |
1 起 |
第一个有效业务状态 |
已从 0 起编、已修正 的字典/枚举(共 5 类):
| dictType / enum |
原编码 |
现编码 |
yes_no |
0=否, 1=是 |
1=否, 2=是 |
enable_status / EnableStatus |
0=禁用, 1=启用 |
1=禁用, 2=启用 |
customer_status / CustomerStatus |
0=禁用, 1=正常, 2=冻结 |
1=禁用, 2=正常, 3=冻结 |
customer_group / CustomerGroup |
0=普通, 1–5=VIP |
1=普通, 2–6=VIP |
recharge_status / RechargeStatus |
0=待审核, 1=通过, 2=驳回 |
1=待审核, 2=通过, 3=驳回 |
本就符合(从 1 起或字符串编码):pay_type、secret_level、data_scope、org_scope,以及全部字符串 dictCode 类型。
已有库数据迁移(若曾按旧 0 起编码落库,需执行 +1):
-- 示例:按表字段逐一 +1(执行前请备份)
UPDATE t_customer SET Status = Status + 1 WHERE Status BETWEEN 0 AND 2;
UPDATE t_customer SET CustomerGroup = CustomerGroup + 1 WHERE CustomerGroup BETWEEN 0 AND 5;
UPDATE t_recharge SET RechargeStatus = RechargeStatus + 1 WHERE RechargeStatus BETWEEN 0 AND 2;
-- IsActive / EnableStatus 等同理
| dictType |
问题 |
建议 |
| area_type |
已统一为 warning(与 AreaTypeCodes 一致) |
— |
| calculation_formula |
预置 continue_unit,NormalizeCalculationFormula 归一化为 continue |
统一编码或改后端归一化 |
| customer_group |
预置 VIP1–5;DataPermConstants.CustomerGroupOptions 文案不同 |
统一一套命名 |
| es_snapshot_status |
预置 active/inactive;发布记录曾写中文 "生效" |
落库用 dictCode,展示用 dictName |
| label_generate_status |
后端 PascalCase |
统一大小写规范 |
| number_type |
后端还有 parcel / sku / auto |
补入预置种子 |
5. 不宜字典化
| 类别 |
示例 |
原因 |
| 批量动作码 |
OrderBatchActionCodes |
内部任务路由 |
| MQ 拓扑 |
OrderBatchQueueTopology |
基础设施 |
| 系统配置键 |
SystemOtherConfigCodes |
配置标识 |
| 平台原始状态 |
Lazada/Shopee PlatformStatus |
外部平台枚举 |
| 过滤器运算符 |
DataPermConstants.FilterOperators |
技术 DSL |
| 模板字段 Key |
OrderTemplateKeys |
代码注册表 |
6. 动态字典(主数据,非静态种子)
| dictType |
加载方式 |
| sales_product |
卖价产品列表 API |
| warehouse |
仓库地址列表 API |
| product_line / kpi_area / region |
数据权限业务维度 |
订单模板 Excel 下拉亦引用:cargo_attribute、export_customs_mode、currency 等静态字典 + 上述动态类型。
7. 可改为读字典的 GetDisplayName
| 当前方法 |
建议 dictType |
OmsDocHelper.GetOrderStatusName |
order_status |
OmsDocHelper.GetWarehouseTypeName |
warehouse_type |
OrderHandleStatusCodes.GetDisplayName |
order_handle_status |
IssueTypeCodes.GetDisplayName |
issue_type |
ClaimTypeCodes.GetDisplayName |
claim_type |
IssueNotifyMethodCodes.GetDisplayName |
issue_notify_method |
CustomerAddressTypeCodes.GetDisplayName |
customer_address_type |
RechargeService.GetPayTypeName |
pay_type |
RechargeService.GetRechargeStatusName |
recharge_status |
FinanceService.GetFeeTypeName |
order_fee_type |
FinanceService.GetChargingStageName |
order_fee_charging_stage |
CustomerAccountFlowService.GetBizTypeName |
customer_account_flow_biz_type |
OMS 后端源码位置
oms0414-back/src/Oms.Domain/**/Consts/*Codes.cs
oms0414-back/src/Oms.Domain/**/Enums/*.cs
oms0414-back/src/Oms.Application/Services/System/DictService.cs
oms0414-back/src/Oms.Application/Shared/OmsDocHelper.cs
oms0414-back/src/Oms.Application/DataPerm/DataPermConstants.cs
oms0414/src/views/system/dict/dict-batch-import.ts # 预置种子与导入模板