定价模型一期详细设计文档 - 《pearlgo项目开发文档》

数据库表
- 1.DDL
- 2.DML
阿波罗配置
- 1、配置汇率：
结构修改
公式匹配规则

数据库表

1.DDL

-- 定价模型：物流费/其他成本配置表，此处更新的时候逻辑删除旧数据，新建新数据
CREATE TABLE `t_goods_price_model_config` (
  `id` bigint(20) NOT NULL AUTO_INCREMENT COMMENT '主键id',
  `type` int(2) NOT NULL DEFAULT '1' COMMENT '配置类型：1-物流费配置  2-其他成本配置',
  `create_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
  `update_time` timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
  `country_code` varchar(500)  NULL COMMENT '国家代码',
  `country_name` varchar(255)  NULL COMMENT '国家名称',
  `electric` int(1) DEFAULT NULL COMMENT '是否带电 0-否 1-是',
  `category_id` bigint(20) DEFAULT NULL COMMENT '类别id',
  `category_name` varchar(500) NULL COMMENT '类别名称',
  `config_json` text   COMMENT '配置的json信息',
  `status` int(1) NOT NULL DEFAULT '1' COMMENT '状态：1-正常 0-删除',
  `delete_source_id` bigint(20) DEFAULT NULL COMMENT '删除来源id，修改的时候回写',
  `account_id` bigint(20) DEFAULT NULL COMMENT '操作用户id',
  `account_name` varchar(500) NULL COMMENT '操作用户中文名',
  PRIMARY KEY (`id`)
) ENGINE=InnoDB COMMENT='物流费/其他成本配置表';
ALTER TABLE `t_goods_price_model_config`
ADD INDEX `idx_country` (`country_code`) ,
ADD INDEX `idx_electric` (`electric`) ,
ADD INDEX `idx_category` (`category_id`) ;

2.DML

-- 初始化默认的定价模型配置
INSERT INTO `ec-dc-v2`.`t_goods_price_model_config` (`id`, `type`, `create_time`, `update_time`, `country_code`, `country_name`, `electric`, `category_id`, `category_name`, `config_json`, `status`, `delete_source_id`, `account_id`, `account_name`) VALUES ('1', '1', '2021-03-11 12:38:38', '2021-03-11 12:40:53', 'US', 'United States', '1', NULL, NULL, '{\"country\":\"US\",\"electric\":1,\"price\":80,\"operatePrice\":18,\"startDate\":\"2000-01-01\",\"endDate\":\"2100-12-31\"}', '1', NULL, '734', '蓝银强');
INSERT INTO `ec-dc-v2`.`t_goods_price_model_config` (`id`, `type`, `create_time`, `update_time`, `country_code`, `country_name`, `electric`, `category_id`, `category_name`, `config_json`, `status`, `delete_source_id`, `account_id`, `account_name`) VALUES ('2', '1', '2021-03-11 12:38:38', '2021-03-11 12:41:39', 'US', 'United States', '0', NULL, NULL, '{\"country\":\"US\",\"electric\":0,\"price\":66,\"operatePrice\":17.5,\"startDate\":\"2000-01-01\",\"endDate\":\"2100-12-31\"}', '1', NULL, '734', '蓝银强');
INSERT INTO `ec-dc-v2`.`t_goods_price_model_config` (`id`, `type`, `create_time`, `update_time`, `country_code`, `country_name`, `electric`, `category_id`, `category_name`, `config_json`, `status`, `delete_source_id`, `account_id`, `account_name`) VALUES ('3', '2', '2021-03-11 12:31:41', '2021-03-11 12:42:53', NULL, NULL, NULL, '-1', '其他', '{\"categoryId\":-1,\"categoryZh\":\"其他\",\"discount\":0.08,\"endDate\":\"2100-12-31\",\"grossProfitRateControl\":0.1,\"payChannelRate\":0.05,\"postage\":5,\"refundRate\":0.13,\"roi\":2.7,\"startDate\":\"2021-03-11\"}    ', '1', NULL, '734', '蓝银强');
INSERT INTO `ec-dc-v2`.`t_goods_price_model_config` (`id`, `type`, `create_time`, `update_time`, `country_code`, `country_name`, `electric`, `category_id`, `category_name`, `config_json`, `status`, `delete_source_id`, `account_id`, `account_name`) VALUES ('4', '2', '2021-03-11 12:31:41', '2021-03-11 12:44:00', NULL, NULL, NULL, '101', '服装', '{\"categoryId\":101,\"categoryZh\":\"服装\",\"discount\":0.08,\"startDate\":\"2012-03-11\",\"grossProfitRateControl\":0.1,\"payChannelRate\":0.05,\"postage\":5,\"refundRate\":0.13,\"roi\":2.7,\"endDate\":\"2021-09-11\"}', '1', NULL, '734', '蓝银强');
INSERT INTO `ec-dc-v2`.`t_goods_price_model_config` (`id`, `type`, `create_time`, `update_time`, `country_code`, `country_name`, `electric`, `category_id`, `category_name`, `config_json`, `status`, `delete_source_id`, `account_id`, `account_name`) VALUES ('5', '2', '2021-03-11 12:31:41', '2021-03-11 12:44:17', NULL, NULL, NULL, '103', '鞋', '{\"categoryId\":103,\"categoryZh\":\"鞋\",\"discount\":0.08,\"startDate\":\"2021-03-11\",\"grossProfitRateControl\":0.1,\"payChannelRate\":0.05,\"postage\":6,\"refundRate\":0.1,\"roi\":2.6,\"endDate\":\"2021-09-11\"}', '1', NULL, '734', '蓝银强');
INSERT INTO `ec-dc-v2`.`t_goods_price_model_config` (`id`, `type`, `create_time`, `update_time`, `country_code`, `country_name`, `electric`, `category_id`, `category_name`, `config_json`, `status`, `delete_source_id`, `account_id`, `account_name`) VALUES ('6', '2', '2021-03-11 12:31:41', '2021-03-11 12:44:31', NULL, NULL, NULL, '6', '玩具', '{\"categoryId\":6,\"categoryZh\":\"玩具\",\"discount\":0.08,\"startDate\":\"2021-03-11\",\"grossProfitRateControl\":0.1,\"payChannelRate\":0.05,\"postage\":6,\"refundRate\":0.13,\"roi\":2.6,\"endDate\":\"2021-09-11\"}', '1', NULL, '734', '蓝银强');
INSERT INTO `ec-dc-v2`.`t_goods_price_model_config` (`id`, `type`, `create_time`, `update_time`, `country_code`, `country_name`, `electric`, `category_id`, `category_name`, `config_json`, `status`, `delete_source_id`, `account_id`, `account_name`) VALUES ('7', '2', '2021-03-11 12:31:41', '2021-03-11 12:44:50', NULL, NULL, NULL, '310', '住宅和花园', '{\"categoryId\":310,\"categoryZh\":\"住宅和花园\",\"discount\":0.08,\"startDate\":\"2021-03-11\",\"grossProfitRateControl\":0.1,\"payChannelRate\":0.05,\"postage\":6,\"refundRate\":0.13,\"roi\":2.6,\"endDate\":\"2021-09-11\"}', '1', NULL, '734', '蓝银强');
INSERT INTO `ec-account`.`t_sys_action` (`id`, `action_name`, `action_desc`, `action_type`, `action_code`, `parent_id`, `level`, `system_type`, `url`, `status`, `create_time`, `update_time`) VALUES ('69915', '物流费用配置', NULL, '1', 'spu:logisticsConfList', '685', '2', '1', NULL, '1', '2021-03-12 17:47:52', '2021-03-12 17:48:33');
INSERT INTO `ec-account`.`t_sys_action` (`id`, `action_name`, `action_desc`, `action_type`, `action_code`, `parent_id`, `level`, `system_type`, `url`, `status`, `create_time`, `update_time`) VALUES ('69916', '按钮-编辑', NULL, '1', 'spu:logisticsConfList:edit', '69915', '3', '1', NULL, '1', '2021-03-12 17:56:03', '2021-03-12 17:56:03');
INSERT INTO `ec-account`.`t_sys_action` (`id`, `action_name`, `action_desc`, `action_type`, `action_code`, `parent_id`, `level`, `system_type`, `url`, `status`, `create_time`, `update_time`) VALUES ('69917', '按钮-新增', NULL, '1', 'spu:logisticsConfList:add', '69915', '3', '1', NULL, '1', '2021-03-12 17:56:29', '2021-03-12 17:56:29');
INSERT INTO `ec-account`.`t_sys_action` (`id`, `action_name`, `action_desc`, `action_type`, `action_code`, `parent_id`, `level`, `system_type`, `url`, `status`, `create_time`, `update_time`) VALUES ('69918', '其他成本费配置', NULL, '1', 'spu:otherConfList', '685', '2', '1', NULL, '1', '2021-03-12 17:56:53', '2021-03-12 17:56:53');
INSERT INTO `ec-account`.`t_sys_action` (`id`, `action_name`, `action_desc`, `action_type`, `action_code`, `parent_id`, `level`, `system_type`, `url`, `status`, `create_time`, `update_time`) VALUES ('69919', '按钮-编辑', NULL, '1', 'spu:otherConfList:edit', '69918', '3', '1', NULL, '1', '2021-03-12 17:57:16', '2021-03-12 17:57:16');
INSERT INTO `ec-account`.`t_sys_action` (`id`, `action_name`, `action_desc`, `action_type`, `action_code`, `parent_id`, `level`, `system_type`, `url`, `status`, `create_time`, `update_time`) VALUES ('69920', '按钮-新增', NULL, '1', 'spu:otherConfList:add', '69918', '3', '1', NULL, '1', '2021-03-12 17:57:41', '2021-03-12 17:57:41');
ALTER TABLE `t_spu_scrapy_auditing`
MODIFY COLUMN `skus_json`  longtext CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci NULL COMMENT 'sku的价格和重量等json，从req_json抽取';

阿波罗配置

1、配置汇率：

priceModel.currencyConfig = 6.5

结构修改

1、针对草稿或者爬虫商品，sku的毛利率保存在json中
涉及表：t_spu_scrapy_auditing表 sku_json、req_json、rsp_json字段

[{
    "isCompose": false,
    "qty": 0,
    "skuName": "White-US 5-Womens Casual Shoes",
    "skuPrices": {
        "USD": {
            "currencyCode": "USD",
            "currencySymbol": "$",
            "referencePrice": 49.99,
            "referenceSupplyPrice": 49.99,
      "grossProfitRate": 0.1     //新增字段
        }
    },
    "skuPropertys": "White,US 5,Womens Casual Shoes",
    "weight": 500
}]

2、注意
草稿箱-新建时，保存的priceConfig信息用于存储在price信息中
草稿箱-编辑的详情中，展示的priceConfig是最新的priceConfig值

公式匹配规则

1、计算物流费

说明：
公式：物流费=重量/1000*物流单价+操作费
输入参数：重量（单位：克），国家，是否带电
逻辑：
1、判断是否存在配置：国家+是否带电，获取：物流单价，操作费。
2、如果未发现该配置：加载默认配置：美国+带电

2、计算实付价（最低参考售价（包邮））

说明：
公式：实付价=(物流费+商品采购成本)/汇率/(1-1/ROI-退款率-支付渠道占比-控制毛利润率)
输入参数：供货成本（币种：RMB），一级类别
逻辑：
1、判断是否存在配置：一级类别，获取：其他成本参数，如ROI，退款率，支付渠道占比等
2、如果未发现该配置：加载默认配置：一级类别：服装
3、判断是否存在汇率配置：如果未获取到则汇率为0

3、计算毛利率（包邮）

说明：
公式：修改价格后计算的包邮毛利率公式=1-支付渠道占比-退款占比-1/ROI-((物流费+商品采购成本)/汇率)/实收，实收=包邮参考售价*(1-优惠折扣)；
输入参数：物流费，商品采购成本（即供货价），参考售价（包邮），配置id
逻辑：
1、判断是否存在配置：一级类别，获取：其他成本参数，如ROI，退款率，支付渠道占比等
2、如果未发现该配置：加载默认配置：一级类别：服装
3、判断是否存在汇率配置：如果未获取到则汇率为0

4、计算毛利率（不包邮）

说明：
公式：修改价格后计算的包邮毛利率公式=1-支付渠道占比-退款占比-1/ROI-（(物流费+商品采购成本)/汇率)/实收，实收=(不包邮参考售价+邮费)*(1-优惠折扣)，邮费按不同品类进行配置”；
输入参数：物流费，商品采购成本（即供货价），参考售价（包邮），配置id
逻辑：
1、判断是否存在配置：一级类别，获取：其他成本参数，如ROI，退款率，支付渠道占比等
2、如果未发现该配置：加载默认配置：一级类别：服装
3、判断是否存在汇率配置：如果未获取到则汇率为0

5、配置发生改变的情况

编辑详情页面。

6、协议地址

平台商品新建商品：http://yapi.future.org/project/237/interface/api/16850
平台商品编辑商品：http://yapi.future.org/project/237/interface/api/16856
平台商品草稿新建/编辑：http://yapi.future.org/project/237/interface/api/17105
爬虫商品编辑：http://yapi.future.org/project/237/interface/api/17159
计算最低参考售价：http://yapi.future.org/project/237/interface/api/17339
计算毛利率(可不用)：http://yapi.future.org/project/237/interface/api/17342
计算毛利率（可根据物流费计算）：http://yapi.future.org/project/237/interface/api/17393

批量定价时，根据spu获取最低参考售价及配置信息：http://yapi.future.org/project/237/interface/api/17375
批量定价时，根据sku获取最低参考售价及配置信息：http://yapi.future.org/project/237/interface/api/17378
批量定价时，根据spu获取参考毛利率：http://yapi.future.org/project/237/interface/api/17384
批量定价时，根据sku获取参考毛利率：http://yapi.future.org/project/237/interface/api/17387

平台商品详情：http://yapi.future.org/project/237/interface/api/16865
草稿商品详情：http://yapi.future.org/project/237/interface/api/17111
爬虫商品详情：http://yapi.future.org/project/237/interface/api/17147

平台商品列表：http://yapi.future.org/project/237/interface/api/16859
草稿列表：http://yapi.future.org/project/237/interface/api/17108
爬虫商品列表：http://yapi.future.org/project/237/interface/api/17144

站点商品编辑：http://yapi.future.org/project/237/interface/api/17222
站点商品详情：http://yapi.future.org/project/237/interface/api/17216
站点商品列表：http://yapi.future.org/project/237/interface/api/17192

平台商品SPU批量定价：http://yapi.future.org/project/237/interface/api/17402
平台商品SKU批量定价：http://yapi.future.org/project/237/interface/api/17345

物理费+其他成本费的配置：http://yapi.future.org/project/237/interface/api/cat_1564

草稿箱/爬虫商品SPU批量定价：http://yapi.future.org/project/237/interface/api/17369

站点商品spu批量定价：http://yapi.future.org/project/237/interface/api/17231