oms/backend/app/model/externalPrintExpressInterface.js
liufumingren e1e3bb638f feat(order): 拉单任务、外部发货同步与取号记录
- 拉单任务:新增 order_sync_tasks 异步任务池,按店铺逐店拉取外部打单平台订单,前端轮询进度
- 外部发货同步:配送后把发货结果同步回店管家,提供数量统计与批量重试(externalSendSync)
- 取号:新增 waybill_fetch_records 记录取号过程,外部快递接口补充菜鸟授权信息
- 补齐相关迁移、订单页同步入口/状态展示,并新增对接说明文档

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-04 20:53:35 +08:00

60 lines
3.3 KiB
JavaScript
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

'use strict';
/**
* 外部打单平台快递接口(面单模板)模型,对应 external_print_express_interfaces 表。
*
* 数据由「从平台同步数据」拉取写入;用户可为模板绑定一个快递编码(custom_code),
* WMS 回读运单号时按「打单账号 + 平台 + 编码」定位唯一模板。
*
* status=0 表示平台侧已不再返回该模板,记录保留用于展示失效与保留绑定。
* @param {Egg.Application} app egg application
* @return {object} externalPrintExpressInterface model
*/
module.exports = app => {
const { BIGINT, STRING, TINYINT, JSON, DATE } = app.Sequelize;
const ExternalPrintExpressInterface = app.model.define('external_print_express_interface', {
id: { type: BIGINT.UNSIGNED, primaryKey: true, autoIncrement: true, comment: '主键' },
principal_id: { type: BIGINT.UNSIGNED, allowNull: false, comment: '所属主体ID' },
account_id: { type: BIGINT.UNSIGNED, allowNull: false, comment: '所属外部打单账号ID' },
platform_type: { type: STRING(32), allowNull: false, defaultValue: '', comment: '打单平台原始平台类型' },
platform_code: { type: STRING(20), allowNull: false, defaultValue: '', comment: 'OMS 预设平台编码' },
platform_name: { type: STRING(50), comment: 'OMS 预设平台名称' },
template_id: { type: BIGINT.UNSIGNED, allowNull: false, comment: '平台面单模板ID' },
template_name: { type: STRING(128), comment: '模板名称' },
express_company_id: { type: BIGINT.UNSIGNED, comment: '平台快递公司ID' },
express_company_code: { type: STRING(50), comment: '平台快递公司编码' },
express_company_name: { type: STRING(100), comment: '平台快递公司名称' },
shop_id: { type: BIGINT.UNSIGNED, comment: '平台店铺ID' },
shop_name: { type: STRING(128), comment: '平台店铺名称' },
dbname: { type: STRING(128), comment: '拉取时使用的分区库名' },
cai_niao_auth_info_id: { type: BIGINT.UNSIGNED, comment: '菜鸟授权网点ID(平台模板 CaiNiaoAuthInfoId)' },
custom_code: { type: STRING(50), comment: '绑定的快递编码(系统或自定义),回读时按账号+平台+编码定位' },
status: { type: TINYINT, allowNull: false, defaultValue: 1, comment: '状态:1有效 0失效' },
platform_updated_at: { type: DATE, comment: '平台侧更新时间' },
synced_at: { type: DATE, comment: '最近一次拉取时间' },
raw: { type: JSON, comment: '平台返回的原始结构' },
remark: { type: STRING(255), comment: '备注' },
created_at: { type: DATE, comment: '创建时间' },
updated_at: { type: DATE, comment: '更新时间' },
}, {
tableName: 'external_print_express_interfaces',
comment: '外部打单平台快递接口(面单模板)',
});
ExternalPrintExpressInterface.associate = () => {
app.model.ExternalPrintExpressInterface.belongsTo(app.model.ExternalPrintAccount, {
foreignKey: 'account_id',
as: 'account',
});
// 自定义编码若恰好等于字典编码,可带出快递名称(仅用于展示,不参与保存校验)
app.model.ExternalPrintExpressInterface.belongsTo(app.model.ExpressCompany, {
foreignKey: 'custom_code',
targetKey: 'code',
as: 'customExpressCompany',
});
};
return ExternalPrintExpressInterface;
};