Skip to content

销售表结构

alt text

客户表结构

都是一些信息字段,仅仅用于展示,没有什么特殊逻辑。

CREATE TABLE `erp_customer` (
  `id` bigint NOT NULL AUTO_INCREMENT COMMENT '客户编号',
  `name` varchar(255) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '客户名称',
  `contact` varchar(100) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '联系人',
  `mobile` varchar(30) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '手机号码',
  `telephone` varchar(30) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '联系电话',
  `email` varchar(50) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '电子邮箱',
  `fax` varchar(30) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '传真',
  `remark` varchar(255) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '备注',
  `status` tinyint NOT NULL COMMENT '开启状态',
  `sort` int NOT NULL COMMENT '排序',
  `tax_no` varchar(50) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '纳税人识别号',
  `tax_percent` decimal(24,6) DEFAULT NULL COMMENT '税率',
  `bank_name` varchar(50) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '开户行',
  `bank_account` varchar(50) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '开户账号',
  `bank_address` varchar(50) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '开户地址',
  PRIMARY KEY (`id` DESC)
) ENGINE=InnoDB AUTO_INCREMENT=3 DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='ERP 客户表';

销售订单表结构

erp_sale_order 表和 erp_sale_order_items 表,分别对应销售订单和销售订单项。

CREATE TABLE `erp_sale_order` (
  `id` bigint NOT NULL AUTO_INCREMENT COMMENT '编号',
  
  `no` varchar(255) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '销售单编号',
  
  `status` tinyint NOT NULL COMMENT '销售状态',
  `order_time` datetime NOT NULL COMMENT '下单时间',
  
  `customer_id` bigint NOT NULL COMMENT '客户编号',
  `account_id` bigint DEFAULT NULL COMMENT '结算账户编号',
  `sale_user_id` bigint DEFAULT NULL COMMENT '销售用户编号',
  
  `total_count` decimal(24,6) NOT NULL COMMENT '合计数量',
  `total_price` decimal(24,6) NOT NULL COMMENT '合计价格,单位:元',
  `total_product_price` decimal(24,6) NOT NULL COMMENT '合计产品价格,单位:元',
  `total_tax_price` decimal(24,6) NOT NULL COMMENT '合计税额,单位:元',
  `discount_percent` decimal(24,6) NOT NULL COMMENT '优惠率,百分比',
  `discount_price` decimal(24,6) NOT NULL COMMENT '优惠金额,单位:元',
  `deposit_price` decimal(24,6) NOT NULL DEFAULT '0.000000' COMMENT '定金金额,单位:元',
  
  `file_url` varchar(512) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '附件地址',
  `remark` varchar(1024) CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci DEFAULT NULL COMMENT '备注',
  
  `out_count` decimal(24,6) NOT NULL DEFAULT '0.000000' COMMENT '销售出库数量',
  `return_count` decimal(24,6) NOT NULL DEFAULT '0.000000' COMMENT '销售退货数量',
  
  PRIMARY KEY (`id`),
  UNIQUE KEY `no` (`no`)
) ENGINE=InnoDB AUTO_INCREMENT=6 DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='ERP 销售订单表';

① no:销售单号,一般是系统自动生成的,目前格式是 {prefix}{yyyyMMdd}{6 位自增}。具体可见 ErpNoRedisDAO 类。

② status:销售状态,统一使用 ErpAuditStatus 枚举类,只有"未审批"、"已审批"两个状态。

③ customer_id:客户编号,关联 erp_customer 表。

account_id:结算账户编号,关联后续的 erp_account 表。暂时不用关注,它用于销售的收款。

④ total_count、total_price、total_product_price、total_tax_price、discount_percent、discount_price 和 deposit_price:合计数量、合计价格、合计产品价格、合计税额、优惠率、优惠金额和定金金额。

⑤ out_count:该销售订单已经出库的数量。一个订单可以被多次销售出库,但是不能超过最大的 total_count,所以需要记录已经出库的数量。

⑥ return_count:该销售订单已经退货的数量。一个订单可以被多次销售退货,但是不能超过最大的 total_count,所以需要记录已经退货的数量。

CREATE TABLE `erp_sale_order_items` (
  `id` bigint NOT NULL AUTO_INCREMENT COMMENT '编号',
  
  `order_id` bigint NOT NULL COMMENT '销售订单编号',
  
  `product_id` bigint NOT NULL COMMENT '产品编号',
  
  `product_unit_id` bigint NOT NULL COMMENT '产品单位单位',
  `product_price` decimal(24,6) NOT NULL COMMENT '产品单价',
  `count` decimal(24,6) NOT NULL COMMENT '数量',
  `total_price` decimal(24,6) NOT NULL COMMENT '总价',
  `tax_percent` decimal(24,6) DEFAULT NULL COMMENT '税率,百分比',
  `tax_price` decimal(24,6) DEFAULT NULL COMMENT '税额,单位:元',
  
  `remark` varchar(1024) CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci DEFAULT NULL COMMENT '备注',
  
  `out_count` decimal(24,6) NOT NULL DEFAULT '0.000000' COMMENT '销售出库数量',
  `return_count` decimal(24,6) NOT NULL DEFAULT '0.000000' COMMENT '销售退货数量',
  
  PRIMARY KEY (`id`)
) ENGINE=InnoDB AUTO_INCREMENT=7 DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci COMMENT='ERP 销售订单项表';

① order_id:销售订单编号,关联到上面的 erp_sale_order 表。

② product_id:产品编号。

注意,因为销售订单不直接涉及库存,所以它并没有 warehouse_id 字段,也就是说它不关心库存的具体仓库。

③ product_unit_id、product_price、count、total_price、tax_percent 和 tax_price:产品单位编号、产品单价、数量、总价、税率和税额。

其中 total_price 等于 product_price * count + tax_price。(额外多了税额)

④ in_count 和 return_count:同 erp_sale_order 表,只是它表示的是该订单"项"的出库数量和退货数量,当然它也不能超过最大的 count

销售出库表结构

erp_sale_out 表和 erp_sale_out_items 表,分别对应销售出库和销售出库项。

CREATE TABLE `erp_sale_out` (
  `id` bigint NOT NULL AUTO_INCREMENT COMMENT '编号',
  `no` varchar(255) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '销售出库编号',
 
  `status` tinyint NOT NULL COMMENT '出库状态',
  `out_time` datetime NOT NULL COMMENT '出库时间',

  `customer_id` bigint NOT NULL COMMENT '客户编号',
  `account_id` bigint NOT NULL COMMENT '结算账户编号',
  `sale_user_id` bigint DEFAULT NULL COMMENT '销售用户编号',

  `order_id` bigint NOT NULL COMMENT '销售订单编号',
  `order_no` varchar(255) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '销售订单号',
  
  `total_count` decimal(24,6) NOT NULL COMMENT '合计数量',
  `total_price` decimal(24,6) NOT NULL COMMENT '合计价格,单位:元',
  `total_product_price` decimal(24,6) NOT NULL COMMENT '合计产品价格,单位:元',
  `total_tax_price` decimal(24,6) NOT NULL COMMENT '合计税额,单位:元',
  `discount_percent` decimal(24,6) NOT NULL COMMENT '优惠率,百分比',
  `discount_price` decimal(24,6) NOT NULL COMMENT '优惠金额,单位:元',
  `other_price` decimal(24,6) NOT NULL DEFAULT '0.000000' COMMENT '其它金额,单位:元',

  `receipt_price` decimal(24,6) NOT NULL DEFAULT '0.000000' COMMENT '已收款金额,单位:元',
  
  `file_url` varchar(512) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '附件地址',
  `remark` varchar(1024) CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci DEFAULT NULL COMMENT '备注',
  PRIMARY KEY (`id`),
  UNIQUE KEY `no` (`no`)
) ENGINE=InnoDB AUTO_INCREMENT=15 DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='ERP 销售出库表';

① no:销售出库编号,一般是系统自动生成的,目前格式是 {prefix}{yyyyMMdd}{6 位自增}。具体可见 ErpNoRedisDAO 类。

② status:出库状态,统一使用 ErpAuditStatus 枚举类,只有"未审批"、"已审批"两个状态。

③ customer_id:客户编号,关联 erp_customer 表。

account_id:结算账户编号,关联后续的 erp_account 表。暂时不用关注,它用于销售的收款。

④ order_id 和 order_no:销售订单编号和销售订单号,关联到上面的 erp_sale_order 表。

⑤ total_count、total_price、total_product_price、total_tax_price、discount_percent、discount_price 和 other_price:合计数量、合计价格、合计产品价格、合计税额、优惠率、优惠金额和其它金额。

其中,total_price 等于 total_product_price + total_tax_price + other_price - discount_price。

⑥ receipt_price:已收款金额,单位:元。暂时不用关注,它用于销售的收款。

CREATE TABLE `erp_sale_out_items` (
  `id` bigint NOT NULL AUTO_INCREMENT COMMENT '编号',
  
  `out_id` bigint NOT NULL COMMENT '销售出库编号',
  
  `order_item_id` bigint NOT NULL COMMENT '销售订单项编号',
  
  `warehouse_id` bigint NOT NULL COMMENT '仓库编号',
  `product_id` bigint NOT NULL COMMENT '产品编号',
  
  `product_unit_id` bigint NOT NULL COMMENT '产品单位单位',
  `product_price` decimal(24,6) NOT NULL COMMENT '产品单价',
  `count` decimal(24,6) NOT NULL COMMENT '数量',
  `total_price` decimal(24,6) NOT NULL COMMENT '总价',
  `tax_percent` decimal(24,6) DEFAULT NULL COMMENT '税率,百分比',
  `tax_price` decimal(24,6) DEFAULT NULL COMMENT '税额,单位:元',

  `remark` varchar(1024) CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci DEFAULT NULL COMMENT '备注',
  PRIMARY KEY (`id`)
) ENGINE=InnoDB AUTO_INCREMENT=27 DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci COMMENT='ERP 销售出库项表';

① out_id:销售出库编号,关联到上面的 erp_sale_out 表。

② order_item_id:销售订单项编号,关联到上面的 erp_sale_order_items 表,因为它需要对应的 out_count 字段。

③ warehouse_id 和 product_id:分别关联到仓库和产品,因为它涉及到库存变更。

④ product_unit_id、product_price、count、total_price、tax_percent 和 tax_price:产品单位编号、产品单价、数量、总价、税率和税额。

其中 total_price 等于 product_price * count + tax_price。(额外多了税额)

销售退货表结构

erp_sale_return 表和 erp_sale_return_items 表,分别对应销售退货和销售退货项。

CREATE TABLE `erp_sale_return` (
  `id` bigint NOT NULL AUTO_INCREMENT COMMENT '编号',
  `no` varchar(255) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '销售退货编号',
  
  `status` tinyint NOT NULL COMMENT '退货状态',
  `return_time` datetime NOT NULL COMMENT '退货时间',

  `customer_id` bigint NOT NULL COMMENT '客户编号',
  `account_id` bigint NOT NULL COMMENT '结算账户编号',
  `sale_user_id` bigint DEFAULT NULL COMMENT '销售用户编号',

  `order_id` bigint NOT NULL COMMENT '销售订单编号',
  `order_no` varchar(255) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '销售订单号',
  
  `total_count` decimal(24,6) NOT NULL COMMENT '合计数量',
  `total_price` decimal(24,6) NOT NULL COMMENT '合计价格,单位:元',
  `total_product_price` decimal(24,6) NOT NULL COMMENT '合计产品价格,单位:元',
  `total_tax_price` decimal(24,6) NOT NULL COMMENT '合计税额,单位:元',
  `discount_percent` decimal(24,6) NOT NULL COMMENT '优惠率,百分比',
  `discount_price` decimal(24,6) NOT NULL COMMENT '优惠金额,单位:元',
  `other_price` decimal(24,6) NOT NULL DEFAULT '0.000000' COMMENT '其它金额,单位:元',

  `refund_price` decimal(24,6) NOT NULL DEFAULT '0.000000' COMMENT '已退款金额,单位:元',
  
  `file_url` varchar(512) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '附件地址',
  `remark` varchar(1024) CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci DEFAULT NULL COMMENT '备注',
  PRIMARY KEY (`id`),
  UNIQUE KEY `no` (`no`)
) ENGINE=InnoDB AUTO_INCREMENT=23 DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='ERP 销售退货表';

① no:销售退货编号,一般是系统自动生成的,目前格式是 {prefix}{yyyyMMdd}{6 位自增}。具体可见 ErpNoRedisDAO 类。

② status:退货状态,统一使用 ErpAuditStatus 枚举类,只有“未审批”、“已审批”两个状态。

③ customer_id:客户编号,关联 erp_customer 表。

account_id:结算账户编号,关联后续的 erp_account 表。暂时不用关注,它用于销售的收款。

④ order_id 和 order_no:销售订单编号和销售订单号,关联到上面的 erp_sale_order 表。

⑤ total_count、total_price、total_product_price、total_tax_price、discount_percent、discount_price 和 other_price:合计数量、合计价格、合计产品价格、合计税额、优惠率、优惠金额和其它金额。

其中,total_price 等于 total_product_price + total_tax_price + other_price - discount_price。

【差异】⑥ refund_price:已退款金额,单位:元。暂时不用关注,它用于销售的收款。

CREATE TABLE `erp_sale_return_items` (
  `id` bigint NOT NULL AUTO_INCREMENT COMMENT '编号',
  
  `return_id` bigint NOT NULL COMMENT '销售退货编号',
  
  `order_item_id` bigint NOT NULL COMMENT '销售订单项编号',
  
  `warehouse_id` bigint NOT NULL COMMENT '仓库编号',
  `product_id` bigint NOT NULL COMMENT '产品编号',
  
  `product_unit_id` bigint NOT NULL COMMENT '产品单位单位',
  `product_price` decimal(24,6) NOT NULL COMMENT '产品单价',
  `count` decimal(24,6) NOT NULL COMMENT '数量',
  `total_price` decimal(24,6) NOT NULL COMMENT '总价',
  `tax_percent` decimal(24,6) DEFAULT NULL COMMENT '税率,百分比',
  `tax_price` decimal(24,6) DEFAULT NULL COMMENT '税额,单位:元',

  `remark` varchar(1024) CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci DEFAULT NULL COMMENT '备注',
  PRIMARY KEY (`id`)
) ENGINE=InnoDB AUTO_INCREMENT=43 DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci COMMENT='ERP 销售退货项表';

① return_id:销售退货编号,关联到上面的 erp_sale_return 表。

② order_item_id:销售订单项编号,关联到上面的 erp_sale_order_items 表,因为它需要对应的 return_count 字段。

③ warehouse_id 和 product_id:分别关联到仓库和产品,因为它涉及到库存变更。

④ product_unit_id、product_price、count、total_price、tax_percent 和 tax_price:产品单位编号、产品单价、数量、总价、税率和税额。

其中 total_price 等于 product_price * count + tax_price。(额外多了税额)