00_定制 > 定制需求
共 8 条需求，按创建时间倒序。产品经理：陈家宜
当前最新逻辑
（待人工总结：以最新一条已完成需求的描述为准）
需求历史
2026-03-26 ｜ 已完成 ｜ ECERPH-47314
标题：【蜚美】订单系统》订单审核规则》定制需求优惠，商品折扣值计算中建议售价取值方案调整
负责人：刘星辉 ｜ 需求类型：客户需求 ｜ 模块：销售-订单管理 ｜ 迭代：20260331-常规-3 月第 5 迭代 ｜ 最后更新：2026-07-02
需求描述：
- 背景（谁？什么问题？有什么影响？为什么？）
请按四步说明清楚，用户在什么场景下遇到什么问题，预期使用什么方式来解决问题。 1、人员/角色/用户； 运营 2、业务发生场景； 原需求：https://devops.aliyun.com/projex/req/ECERPH-45044# 《【蜚美】定制需求调整：订单审核规则-》商品金额判断策略(非付费需求)》 建议售价取值客户需要的是如下 【图片】
3、痛点问题/阻碍是什么； 客户认为费用不对 4、预期解决方案/产品功能； 调整建议售价取值
- 需求（做什么？怎么做？有什么要注意的？）
订单系统
- 原需求：https://devops.aliyun.com/projex/req/ECERPH-45044# 《【蜚美】定制需求调整：订单审核规则-》商品金额判断策略(非付费需求)》
中的建议售价的取值方案调整为如下：
（1）shopify平台上取值仓库SKU中建议售价的时候只取值shopify+美元的建议售价，如果订单币种不等于美元则需要按照汇率换算为对应币种进行计算 （2）tiktok、shopee、lazada平台则以建议售价中对应平台+币种进行匹配，如果建议售价中没有对应平台+订单币种的建议售价，则认为建议售价为0。
2026-01-12 ｜ 已完成 ｜ ECERPH-43500 🚀【0-1】
标题：【定制】订单系统》对接Kmart平台的拉单和标发的功能（承诺用户3月上线）
负责人：刘星辉 ｜ 需求类型：客户需求 ｜ 模块：销售-订单管理-拉单 ｜ 迭代：20260324-常规-3 月第 4 迭代 ｜ 最后更新：2026-07-02
原始需求：01_原始需求\ECERPH-43500_【定制】订单系统》对接Kmart平台的拉单和标发的功能（承诺用户3月上线）\原始需求.md
需求描述：
- 背景（谁？什么问题？有什么影响？为什么？）
附件中有平台对接的文档 postman的链接里面有接口以及授权信息：https://.postman.co/workspace/AAA~19214a3d-802e-4415-af37-698c61d3e610/collection/28479420-0f78d6c9-d419-469e-9a7d-0ec3b9b71be8?action=share&creator=28479420&active-environment=28479420-ceff4c63-3236-48d9-b9eb-ba139f82e8cd
【图片】
和客户沟通，他们在后台的订单是平台自动确认的，所以跳过确认的操作不做对接
- 需求（做什么？怎么做？有什么要注意的？）
中台需求：https://devops.aliyun.com/projex/req/ECERPJ-11001# 《中台》对接Kmart平台的拉单和标发功能（承诺用户3月上线）》 授权需求：https://devops.aliyun.com/projex/project/b3b56b1f88e98c5e0b75512fe1/req/f1833db5e48ff5a867d4b6110d
拉取订单接口：https://developer.mirakl.com/content/product/mmp/rest/seller/openapi3/orders/or11 确认订单：https://developer.mirakl.com/content/product/mmp/rest/seller/openapi3/orders/or21 创建包裹标发：https://developer.mirakl.com/content/product/mmp/rest/seller/openapi3/multiple-shipments/st01 更新跟踪号：https://developer.mirakl.com/content/product/mmp/rest/seller/openapi3/multiple-shipments/st23 查询承运商：https://developer.mirakl.com/content/product/mmp/rest/front/openapi3/platform-settings/sh21
- 对接订单明细数据
订单：588282719-A
【图片】
| 字段名称 | 报文字段 | 字段取值 | 备注 |
| --- | --- | --- | --- |
| 参考号（平台订单号） | orders[].order_id | 588282719-A | |
| 买家id | orders[].customer.customer_id | nii.jiaa1@gmail.com | |
| 买家名称 | orders[].customer.firstname + lastname | JIA NI | |
| 站点 | orders[].customer.shipping_address.country | AU | |
| email | orders[].customer.customer_id | nii.jiaa1@gmail.com | |
| 交易号 | | | |
| 支付方式 | orders[].payment_type | PayDock | |
| 订单备注 | orders[].customer.shipping_address.additional_info | NOT AUTHORISED to leave at front door | |
| 卖家（店铺账号） | | | |
| CPF税号 | ❌ 平台未提供 | — | |
| 总金额 | orders[].total_price | 191.96 | |
| 交易额 | orders[].price | 159.98 | |
| 运费 | orders[].shipping_price | 31.98 | |
| 交易费（成交费） | total_commission | 25.77 | |
| 手续费 | | | |
| 其他费用 | ❌ 平台未提供 | 0 | |
| 补贴 | orders[].promotions.total_deduced_amount | 0 | |
| 币种 | orders[].currency_iso_code | AUD | |
| 创建时间 | orders[].created_date | 2025-12-31T05:08:37Z | 转换为北京时间 |
| 付款时间 | orders[].customer_debited_date | 2025-12-31T05:08:37.740Z | 转换为北京时间 |
| 最晚发货时间 | orders[].shipping_deadline | 2026-01-05T12:59:59.999Z | 转换为北京时间 |
| 发货时间 | orders[].order_lines[].shipped_date | 2026-01-01T11:41:56Z | |
| 收件人 | orders[].customer.shipping_address.firstname + lastname | JIA NI | |
| 手机号码 | orders[].customer.shipping_address.phone | 0451027889 | |
| 公司名 | orders[].customer.shipping_address.company | （空） | |
| 收件人国家/地址 | orders[].customer.shipping_address.country | AU | |
| 收件人省/州 | orders[].customer.shipping_address.state | QLD | |
| 城市 | orders[].customer.shipping_address.city | INDOOROOPILLY | |
| 邮编 | orders[].customer.shipping_address.zip_code | 4068 | |
| 门牌号 | | — | |
| 地址1 | orders[].customer.shipping_address.street_1 | 167 Witton Rd | |
| 地址2 | orders[].customer.shipping_address.street_2 | — | |
| 平台配送方式 | orders[].shipping_type_label | Standard Delivery | |
| 跟踪号 | orders[].shipping_tracking | CPWI9990011190201 | |
| 平台仓库 | orders[].order_lines[].shipping_from.warehouse.code | 00001 | |
| 商品sku | orders[].order_lines[].offer_sku | 160302700 | 作为平台SKU |
| 商品名称 | orders[].order_lines[].product_title | Advwin 4-Tier Rotating Bookshelf 360 Spin Book Organizer Corner Storage Rack Display Unit 40x126cm | |
| 商品数量 | orders[].order_lines[].quantity | 2 | |
| 商品链接 | | — | |
| 商品图片 | orders[].order_lines[].product_medias[].media_url
"type": "LARGE" | /media/product/image/449363ec-77fd-4294-b4fe-93e7f7d93230 | 使用https://kmartau-prod.mirakl.net/拼接这个图片URL即可下载到图片。使用 "type": "LARGE"的图片 |
| 单价 | orders[].order_lines[].price_unit | 79.99 | |
2.订单标发
（1）订单管理上【选择订单标记】发货的界面样式如下
承运商code未非必填。code上需要增加通过接口获取到的基础数据值供用户选择。
承运商name在code没有填写的情况下必须填写。
【图片】
（2）运输方式映射新增Kmart平台
【图片】
接口入参说明
| 接口入参字段 | 系统字段 | 取值说明 |
| --- | --- | --- |
| shipments.order_id | 订单参考号 | |
| shipments.shipment_lines.order_line_id | 商品id | |
| shipments.shipment_lines.quantity | 商品数量 | 按照平台SKU拆分后的商品数量，按照仓库SKU拆分的情况下则默认全量标发 |
| shipments.shipped | 更新为已发货状态 | 默认传True |
| shipments.tracking.carrier_code | 承运商-carrier code | 【此项非必填】
承运商代码，通过接口：https://developer.mirakl.com/content/product/mmp/rest/front/openapi3/platform-settings/sh21每日定时查询更新，后提供code+名称给用户选择
显示基础数据用carrier.label[carrier.code]组合显示 |
| shipments.tracking.carrier_name | 承运商名称-carrier name | 承运商名称用户自行填写。
未填写carrier code的情况下必须填写carrier name |
| shipments.tracking.tracking_number | 跟踪号 | |
| shipments.tracking.tracking_url | 跟踪号查询地址 | |
3.订单拆分新增按平台SKU拆分的功能（可参考amazon平台的拆单功能） （1）【订单拆分】功能上新增按平台SKU拆分和仓库SKU拆分的逻辑（文案有过调整按照以下文案为准） 提示：1、按仓库sku拆分子订单生成的跟踪号，由于无法区分平台SKU的拆分数量，系统只会标发整个订单一个跟踪号到平台。 2、按平台sku拆分后子订单，系统可以区分平台SKU的发货数量，系统按照实际拆单数量对应的跟踪号都会全部标发到平台。 3、订单拆分合并修改过SKU 就不能再使用平台SKU拆分，该订单已修改过。 【图片】 （2）【批量拆分】 【图片】 （3）缺货批量拆单 【图片】 （4）自定义拆单 【图片】 （5）一键拆单 【图片】
4.订单状态说明
此平台的状态是根据商品变化的，需要通过商品下的order_line_state 来判断商品发货情况和退款情况
Order line's state Enum"STAGING""WAITING_ACCEPTANCE""WAITING_DEBIT""WAITING_DEBIT_PAYMENT""SHIPPING""SHIPPED""TO_COLLECT""RECEIVED""CLOSED""REFUSED""CANCELED""INCIDENT_OPEN""REFUNDED""WAITING_REFUND""WAITING_REFUND_PAYMENT"
2025-11-17 ｜ 已完成 ｜ ECERPH-39507
标题：【倍思奇-价卡二期定制】订单系统》价卡新增分区功能 - 需前端（限时上线：1230）（调整子分区定义，为枚举数据：1～8）
负责人：刘星辉 ｜ 需求类型：客户需求 ｜ 模块：销售-订单管理-订单规则 ｜ 迭代：20251230-常规-12月第五迭代 ｜ 最后更新：2025-12-30
需求描述：
- 背景（谁？什么问题？有什么影响？为什么？）
倍思奇，通过邮编分区直接确认订单跨区情况，然后基于运费比价，确认使用哪些仓+渠道发货。
- 需求（做什么？怎么做？有什么要注意的？）
订单系统》订单分仓规则
- 订单分仓规则中调整按钮样式如下
【图片】 【图片】
- 新增【邮编分区设置】按钮，点击弹出邮编分区设置页面.（此页面的需求：https://devops.aliyun.com/projex/project/b3b56b1f88e98c5e0b75512fe1/req/e8eee808b1edfea1c4a6acb259）
2.1、此按钮需要增加按钮权限； 2.2、具有此按钮权限的情况下才能创建有3中新增的功能；
定义说明： 1、母分区：客户录入名称； 2、子分区：枚举值，1～8，见上游依赖需求； 注意，在命中具体分区时：需要保存好 1、母分区：分区方案名称+主键ID； 2、子分区：枚举值 + 主键ID； 【图片】 【图片】
- 新版订单规则里面新增比价模式。（UI图待@马妮娅补充）
3.1只要此系统具有【邮编分区设置】按钮 则显示此匹配邮编分区的分仓方式。（待确认是否可行，通过系统有无赠送此按钮，判断系统有无开启此功能） 3.2根据用户设置的规则调用规则后。处理方式如下 订单邮编进行分仓=》匹配指定仓库和邮编之间的分区数量=》按照用户设置的分区数量=》选中符合的分区=》找到仓库以及运输方式=》比价=》按照价格低优先=》价格相同的情况下按照仓库进行优先取值
3.3执行规则的时候，日志中记录： 订单邮编XXXXX命中分区：「子分区（枚举值）=母分区（客户录入名称），仓库A+运输方式：001、002、003」、「子分区（枚举值）=母分区（客户录入名称），仓库B+运输方式：001、002、003」、「子分区（枚举值）=母分区（客户录入名称），仓库C+运输方式：001、002、003」；
比价的日志内容：比较日志同价卡的比价日志保持一致。
3.订单列表上新增跨区数据字段 （1）当订单有分仓仓库的情况下显示邮编分区。 a、需要调用仓配的接口获取此仓库+运输方式+邮编匹配的是哪个分区； b、仅在订单规则内具有【邮编分区设置】按钮的情况下才显示此邮编分区的字段。（待确认是否可行，通过系统有无赠送此按钮，判断系统有无开启此功能； d、示例： 邮编分区：子分区（枚举值）[母分区（客户录入名称）] ---注意，展示 【图片】 （2）如果订单未有分仓的时候，邮编分区此字段的值留空； （3）订单审单后如果变更了仓库需要更新邮编分区；
4.订单列表新增邮编分区。支持多选筛选 （1）下拉选框内显示从仓配系统获取到的 子分区。 （2）显示的样式为： 子分区（枚举值）[母分区（客户录入名称）]---注意，子分区是枚举数 1:8，需要按返回的数据，去重后展示。理论上一个分区方案 + 子分区，只有八条数据。如果客户有 10 个分区方案，这里理论展示数量的上限死 80 条； 【图片】
5.订单审核规则中新增邮编分区的条件 （1）仅在订单规则内具有【邮编分区设置】按钮的情况下才显示此邮编分区的条件。（确认可行，通过系统有无赠送此按钮，判断系统有无开启此功能） （2）邮编分区支持多选。 （3）样式参考，---注意，子分区是枚举数 1:8，需要按返回的数据，去重后展示。理论上一个分区方案 + 子分区，只有八条数据。如果客户有 10 个分区方案，这里理论展示数量的上限死 80 条； 【图片】
2025-10-17 ｜ 已完成 ｜ ECERPH-37219
标题：【定制-倍思奇】订单系统》对接价卡系统并且新增对外查询试算结果日志接口和系统试算信息调整
负责人：刘星辉 ｜ 需求类型：交付先锋(便捷性等) ｜ 模块：销售-对外API ｜ 迭代：20251031-紧急-10月紧急迭代 ｜ 最后更新：2026-05-18
需求描述：
- 背景（谁？什么问题？有什么影响？为什么？）
倍思奇价卡系统背景说明：https://alidocs.dingtalk.com/i/nodes/R1zknDm0WR3ALmkRCg2qwo26VBQEx5rG?utm_scene=person_space
仓配系统价卡系统需求链接： https://devops.aliyun.com/projex/req/ECERPH-37235# 《【定制需求-倍思奇】【易仓价卡系统 - 代码待补充】-》仓配管理系统-》物流管理-》对接“价卡系统”，并且结合“价卡系统”完成各物流渠道费用试算逻辑改造》
- 需求（做什么？怎么做？有什么要注意的？）
- 总配置：是否使用易仓“价卡系统”费用试算模式 【此配置存在于仓配系统，订单系统也使用此配置判断以下功能是否生效，仅在开启此配置后以下功能才生效。】
属性代码：IS_PRICE_CARD_SYSTEM_COST_ESTIMATION 描述： “价卡系统”费用试算模式属于易仓系统付费功能；功能一旦付费开启，即可优先使用“价卡系统”试算订单运费以及仓储操作费信息。选项：【1 是】、【0 否】。系统默认选择【0 否】 配置值-单选：否（默认值）、是
2、订单系统的运输试算弹窗，需要在开启价卡系统的情况下显示以下2个新增的字段:：操作费、数据来源
操作费：开启价卡系统后通过仓配试算接口获取到价卡系统计算出来的仓内操作费以及对应操作费的明细费用。
数据来源：此试算费用计算的数据来源。 价格表/API/价卡系统/平台物流API+价卡系统
【图片】
| 新增字段 | ？提示 |
| --- | --- |
| 操作费 | 开启价卡系统订单情况下会从价卡系统获取到库内操作费 |
| 数据来源 | 价格表：系统内配置的物流价格表计算出来的试算运费
API:通过物流商API获取到试算运费
价卡系统：通过价卡系统计算出来的试算运费和操作费
平台物流+价卡系统：平台物流API计算得出的试算运费+价卡系统计算得出的操作费 |
| 总费用 | 总金额=基本费用+其他费用+操作费（操作费仅在开启价卡系统的情况下生效） |
3、订单日志以及订单分仓规则的测试工具的弹窗中需要在订单进行过运费试算的情况下保存并且显示此次订单的所有渠道的试算结果
(1)订单中命中的分仓规则结果中显示【查看试算结果】按钮
【图片】
（2）订单分仓规则测试工具中如果订单出现调用运费试算接口的情况也需要显示【查看试算结果】按钮
【图片】
（3）查看试算结果弹窗如下:
【图片】
| 系统字段 | 取值说明 | ？提示 |
| --- | --- | --- |
| 分仓规则名称 | 执行的分仓规则名称 | |
| 执行时间 | 分仓规则执行的时间 | |
| 仓库 | 仓库代码+仓库名称组合显示 | |
| 运输方式 | 运输方式代码+运输方式名称 | |
| 试算总金额 | 仓配接口返回的试算总金额 | 总金额=试算运费+操作费 |
| 试算运费 | 仓配试算接口返回的总试算运费 | |
| 操作费 | 仓配试算接口返回的总操作费 | 开启价卡系统订单情况下会从价卡系统获取到库内操作费 |
| 操作费明细 | 仓配试算接口返回的操作费明细，需要显示操作费的名称以及对应金额 | |
| 时效 | 和运费试算原有逻辑保持一致 | |
| 库龄 | 和运费试算原有逻辑保持一致 | |
| 库存 | 显示分仓时的每个仓库SKU的库存数据 | |
| 数据来源 | 仓配试算接口返回的数据来源
价格表/API/价卡系统/平台物流API+价卡系统 | 价格表：系统内配置的物流价格表计算出来的试算运费
API:通过物流商API获取到试算运费
价卡系统：通过价卡系统计算出来的试算运费和操作费
平台物流API+价卡系统：平台物流API计算得出的试算运费+价卡系统计算得出的操作费 |
| 备注 | - 通过仓配试算接口返回的接口异常信息
- 分仓时候无库存的时候显示无库存的原因 | |
| 匹配结果 | 此渠道试算结果是否最终被命中
如果被命中则显示命中
未命中则显示未命中 | |
以上试算结果数据仅保存一个月，超过一个月点击查看则显示如下弹窗 【图片】
4.在以下平台上新增一个[试算运费]的字段保存显示此用户通过运费试算接口（订单分仓规则+订单列表上的运费试算功能+仓配系统审核之后回推到订单系统的费用内容）计算得出的试算运费以及对应的明细费用。 ？提示：显示通过分仓规则、订单列表上运费试算弹窗、订单审核后仓配系统进行试算得到的试算运费（仅在开启价卡系统的情况下显示此试算运费）；与上方试算运费的区别在于试算运费仅显示试算得出的运输，上面的运输费在出库后会通过物流商的接口获取到真实的尾程费用 需要新增字段的平台： 【图片】 新增字段的样式： 【图片】
5、新增分仓试算结果查询接口，保存通过订单分仓规则试算得到试算结果 （注意：以下接口内的字段为必须要有但是结构以开发设计为准）
请求参数字段说明
根级别请求字段
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| query_criteria | object | 是 | 查询条件 |
| pagination | object | 是 | 分页参数 |
| ### query_criteria对象字段 | |||
| 起始时间和结束时间需要是大于等会和小于等于，已经和客户说是这样的逻辑了 | |||
| 字段 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| order_sn | string | 否 | 系统订单号（精确匹配） |
| start_time（大于等于） | string | 否 | 执行时间起始（格式：YYYY-MM-DD HH:mm:ss） |
| end_time（小于等于） | string | 否 | 执行时间结束（格式：YYYY-MM-DD HH:mm:ss） |
| shop_account | string | 否 | 店铺账号（精确匹配） |
| ### pagination对象字段 | |||
| 字段 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| page | integer | 是 | 页码 |
| page_size | integer | 是 | 每页大小 |
请求接口报文
{ "query_criteria": { "order_sn": "SO202405200001", "start_time": "2024-05-20 00:00:00", "end_time": "2024-05-20 23:59:59", "shop_account": "shop001" }, "pagination": { "page": 1, "page_size": 20 } }
响应数据结构字段说明
根级别字段
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| code | integer | 是 | 状态码（200=成功） |
| message | string | 是 | 状态描述信息 |
| data | object | 是 | 响应数据主体 |
| ### data字段 | |||
| 字段 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| total_count | integer | 是 | 总记录数 |
| page | integer | 是 | 当前页码 |
| page_size | integer | 是 | 每页大小 |
| currency | string | 是 | 统一币种（ISO 4217标准） |
| list | array | 是 | 数据列表 |
| ### list数组中的对象字段 |
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| execute_id | string | 是 | 分仓结果执行ID |
| shop_account | string | 是 | 店铺账号 |
| order_sn | string | 是 | 系统订单号 |
| execute_time | string | 是 | 执行时间（格式：YYYY-MM-DD HH:mm:ss） |
| rule_id | string | 新增 | 分仓规则ID |
| rule_name | string | 新增 | 分仓规则名称 |
| rule_priority | integer | 新增 | 分仓规则优先级 |
| calculation_results | array | 是 | 分仓试算结果列表 |
| ### calculation_results数组中的对象字段 | |||
| 字段 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| warehouse_id | string | 是 | 仓库代码 |
| warehouse_name | string | 是 | 仓库名称 |
| warehouse_currency | string | 是 | 仓库结算币种 |
| hit_flag | boolean | 是 | 是否命中（true/false） |
| shipping_methods | array | 是 | 运输方式列表 |
| ### shipping_methods数组中的对象字段 |
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| shipping_method_id | string | 是 | 运输方式代码 |
| shipping_method_name | string | 是 | 运输方式名称 |
| currency | string | 是 | 运输方式费用币种 |
| shipping_fee | number | 是 | 基本费用 |
| number | 是 | 其他费用 | |
| operation_fee | object | 是 | 操作费信息 |
| total_fee | number | 是 | 总费用（基本费用+其他费用+操作费） |
| estimated_days | integer | 是 | 预计送达天数 |
| warehouse_age | integer | 是 | 库龄（天数） |
| integer | 是 | 库存（显示订单内每个仓库sku的库存数据，使用一个json进行显示） | |
| string | 是 | 备注（试算失败的原因或者无库存的原因） | |
| data_source | string | 新增 | 数据来源（价格表/API/价卡系统/平台物流API+价卡系统） |
| ### operation_fee对象字段 |
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| total_operation_fee | number | 是 | 操作费总额 |
| currency | string | 是 | 操作费币种 |
| fee_details | array | 是 | 操作费明细列表 |
| ### fee_details数组中的对象字段 | |||
| 字段 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| fee_type | string | 是 | 费用类型编码 |
| fee_name | string | 是 | 费用名称 |
| amount | number | 是 | 金额 |
| currency | string | 是 | 费用币种 |
响应报文接口说明
{ "code": 200, "message": "success", "data": { "total_count": 150, "page": 1, "page_size": 20, "currency": "CNY", "list": [ { "execute_id": "CALC202405200001", "shop_account": "shop001", "order_sn": "SO202405200001", "execute_time": "2024-05-20 14:30:25", "rule_id": "RULE_001", "rule_name": "就近分仓规则", "rule_priority": 1, "calculation_results": [ { "warehouse_id": "WH001", "warehouse_name": "北京仓", "warehouse_currency": "CNY", "hit_flag": true, "shipping_methods": [ { "shipping_method_id": "SM001", "shipping_method_name": "顺丰标快", "currency": "CNY", "shipping_fee": 15.80, "operation_fee": { "total_operation_fee": 8.50, "currency": "CNY", "fee_details": [ { "fee_type": "pick_fee", "fee_name": "拣货费", "amount": 3.00, "currency": "CNY" }, { "fee_type": "pack_fee", "fee_name": "打包费", "amount": 2.50, "currency": "CNY" }, { "fee_type": "handle_fee", "fee_name": "操作处理费", "amount": 2.00, "currency": "CNY" }, { "fee_type": "other_fee", "fee_name": "其他费用", "amount": 1.00, "currency": "CNY" } ] }, "total_fee": 24.30, "estimated_days": 2, "warehouse_age": 15, "data_source": "SYSTEM" }, { "shipping_method_id": "SM002", "shipping_method_name": "圆通快递", "currency": "CNY", "shipping_fee": 12.50, "operation_fee": { "total_operation_fee": 7.80, "currency": "CNY", "fee_details": [ { "fee_type": "pick_fee", "fee_name": "拣货费", "amount": 3.00, "currency": "CNY" }, { "fee_type": "pack_fee", "fee_name": "打包费", "amount": 2.30, "currency": "CNY" }, { "fee_type": "handle_fee", "fee_name": "操作处理费", "amount": 1.50, "currency": "CNY" }, { "fee_type": "other_fee", "fee_name": "其他费用", "amount": 1.00, "currency": "CNY" } ] }, "total_fee": 20.30, "estimated_days": 3, "warehouse_age": 15, "data_source": "SYSTEM" } ] }, { "warehouse_id": "WH002", "warehouse_name": "上海仓", "warehouse_currency": "CNY", "hit_flag": false, "shipping_methods": [ { "shipping_method_id": "SM003", "shipping_method_name": "中通快递", "currency": "CNY", "shipping_fee": 10.00, "operation_fee": { "total_operation_fee": 6.50, "currency": "CNY", "fee_details": [ { "fee_type": "pick_fee", "fee_name": "拣货费", "amount": 2.50, "currency": "CNY" }, { "fee_type": "pack_fee", "fee_name": "打包费", "amount": 2.00, "currency": "CNY" }, { "fee_type": "handle_fee", "fee_name": "操作处理费", "amount": 1.50, "currency": "CNY" }, { "fee_type": "other_fee", "fee_name": "其他费用", "amount": 0.50, "currency": "CNY" } ] }, "total_fee": 16.50, "estimated_days": 4, "warehouse_age": 5, "data_source": "THIRD_PARTY" } ] } ] } ] } }
2023-11-24 ｜ 已完成 ｜ ECERPH-3633
标题：【定制需求】订单系统》getorderlist接口中新增返回amazon原始数据：promotiondiscount和shippingtax
负责人：刘星辉 ｜ 模块：销售-订单管理-拉单 ｜ 迭代：20231130-紧急-11月紧急第二迭代 ｜ 最后更新：2023-11-29
需求描述：
- 背景（谁？什么问题？有什么影响？为什么？）
【图片】
- 需求（做什么？怎么做？有什么要注意的？）
订单系统》对外api
- 对外api接口：获取订单列表 的请求参数中新增参数：是否返回amazon原始订单报文的折扣和运费税 ？ 1返回 0不返回（默认值为0）
【图片】
2.请求后按照amazon接口返回的实际商品信息返回数据，如果有多个商品则返回多个数组 { "ASIN":"B09JSFX5CR" "SellerSKU":"01-000002927207" "OrderItemId":"33458301819122" "PromotionDiscount":{ "CurrencyCode":"EUR", "Amount":"0.00" }, "ShippingTax":{ "CurrencyCode":"EUR", "Amount":"0.74" } }
数据来源自amaozn订单报文中的item接口返回的原始数据 以客户代码：ntk7446 订单号：405-3448464-4907523为例 [ { "ProductInfo":{ "NumberOfItems":"1" }, "BuyerInfo":{
}, "ItemTax":{ "CurrencyCode":"EUR", "Amount":"33.33" }, "QuantityShipped":1, "BuyerRequestedCancel":{ "IsBuyerRequestedCancel":"false", "BuyerCancelReason":"" }, "ItemPrice":{ "CurrencyCode":"EUR", "Amount":"199.99" }, "ASIN":"B08MZH4PCZ", "SellerSKU":"01-000002933807-1", "Title":"Starter kit 60V 4Ah battery with charger", "ShippingTax":{ "CurrencyCode":"EUR", "Amount":"0.64" }, "IsGift":"false", "ShippingPrice":{ "CurrencyCode":"EUR", "Amount":"3.85" }, "ConditionSubtypeId":"New", "ShippingDiscount":{ "CurrencyCode":"EUR", "Amount":"0.00" }, "ShippingDiscountTax":{ "CurrencyCode":"EUR", "Amount":"0.00" }, "IsTransparency":"false", "QuantityOrdered":1, "PromotionDiscountTax":{ "CurrencyCode":"EUR", "Amount":"0.00" }, "ConditionId":"New", "PromotionDiscount":{ "CurrencyCode":"EUR", "Amount":"0.00" }, "OrderItemId":"31416477310242" }, { "ProductInfo":{ "NumberOfItems":"1" }, "BuyerInfo":{
}, "ItemTax":{ "CurrencyCode":"EUR", "Amount":"21.67" }, "QuantityShipped":1, "BuyerRequestedCancel":{ "IsBuyerRequestedCancel":"false", "BuyerCancelReason":"" }, "ItemPrice":{ "CurrencyCode":"EUR", "Amount":"129.99" }, "ASIN":"B083JN516M", "SellerSKU":"01-0002405607VT-1", "Title":"Greenworks Pro Bare Tool 60 V Max Lithium Ion 610 CFM GEN2 Brushless Cordless Electric Leaf Blower ; Batterie et chargeur non inclus", "ShippingTax":{ "CurrencyCode":"EUR", "Amount":"0.74" }, "IsGift":"false", "ShippingPrice":{ "CurrencyCode":"EUR", "Amount":"4.41" }, "ConditionSubtypeId":"New", "ShippingDiscount":{ "CurrencyCode":"EUR", "Amount":"0.00" }, "ShippingDiscountTax":{ "CurrencyCode":"EUR", "Amount":"0.00" }, "IsTransparency":"false", "QuantityOrdered":1, "PromotionDiscountTax":{ "CurrencyCode":"EUR", "Amount":"0.00" }, "ConditionId":"New", "PromotionDiscount":{ "CurrencyCode":"EUR", "Amount":"0.00" }, "OrderItemId":"31416477310282" } ]
2023-11-09 ｜ 已完成 ｜ ECERPH-3013 🚀【0-1】
标题：【定制需求】账号系统》对接新平台Woolworths
负责人：梁康太 ｜ 模块：销售-订单管理-拉单 ｜ 迭代：20231128-常规-11月第四迭代 ｜ 最后更新：2023-11-28
原始需求：01_原始需求\ECERPH-3013_【定制需求】账号系统》对接新平台Woolworths\原始需求.md
需求描述：
- 背景（谁？什么问题？有什么影响？为什么？）
接口文档：https://dev.marketplacer.com/docs/seller-api/api_collections/ 【图片】
- 需求（做什么？怎么做？有什么要注意的？）
账号系统》Woolworths
授权说明文档：https://dev.marketplacer.com/docs/seller-api/getting_started/
授权方式如下 【图片】
2023-11-03 ｜ 已完成 ｜ ECERPH-2712 🚀【0-1】
标题：【定制需求】账号系统》对接新平台Bunnings（基于：Mirakl）
负责人：梁康太 ｜ 模块：销售-订单管理-拉单 ｜ 迭代：20231121-常规-11月第三迭代 ｜ 最后更新：2026-06-25
原始需求：01_原始需求\ECERPH-2712_【定制需求】账号系统》对接新平台Bunnings（基于：Mirakl）\原始需求.md
需求描述：
- 背景（谁？什么问题？有什么影响？为什么？）
接口文档：https://help.mirakl.net/help/api-doc/seller/mmp.html#postman 登录账号：erp@yicangtech.com 密码：Erp147456123/* 对接说明文档见附件 【图片】
- 需求（做什么？怎么做？有什么要注意的？）
账号系统》Bunnings
- 新增对接Bunnings平台，授权说明文档：
https://help.mirakl.net/help/api-doc/seller/mmp.html#apiKeyAuthentication
- 授权方式同catch平台
【图片】
2023-11-01 ｜ 已完成 ｜ ECERPH-2590 🚀【0-1】
标题：【定制需求】订单系统》对接新平台Bunnings（基于：Mirakl）
负责人：文明亮 ｜ 模块：销售-订单管理-拉单 ｜ 迭代：20231121-常规-11月第三迭代 ｜ 最后更新：2026-06-25
原始需求：01_原始需求\ECERPH-2590_【定制需求】订单系统》对接新平台Bunnings（基于：Mirakl）\原始需求.md
需求描述：
- 背景（谁？什么问题？有什么影响？为什么？）
接口文档：https://help.mirakl.net/help/api-doc/seller/mmp.html#postman 登录账号：erp@yicangtech.com 密码：Erp147456123/*
对接说明文档见附件 【图片】
- 需求（做什么？怎么做？有什么要注意的？）
订单系统》Bunnings平台
- 对接平台接口
（1）拉取订单：GET OR11 - List orders：https://help.mirakl.net/help/api-doc/seller/mmp.html#OR11 （2）接受/拒绝订单：PUT OR21 - Accept or refuse order lines：https://help.mirakl.net/help/api-doc/seller/mmp.html#OR21 （3）标发：PUT OR23 - Update carrier tracking information for a specific order：https://help.mirakl.net/help/api-doc/seller/mmp.html#OR23 （4）获取标发承运商：GET SH21 - List all carriers：https://help.mirakl.net/help/api-doc/seller/mmp.html#SH21
2.获取订单详情
【图片】
| 对接内容分类 | 系统字段名称 | 对接后实现的功能 | 对应接口字段 | 以订单W232372984-A为例 | 备注 | |
| --- | --- | --- | --- | --- | --- | --- |
| 订单明细 | 参考号（平台订单号） | 1.查看（列表+详情）
2.查询
3.导出 | order_id | W232372984-A | | |
| 买家id | 1.查看（列表+详情）
2.查询
3.导出 | customer_id | f3c15195-1be1-460e-9c9a-819bfa13431e | | 买家名称 | 1.查看（列表+详情） |
| 2.查询
3.导出 | firstname+lastname | Jiawei Li | | 站点 | 1.查看（详情）
2.导出
3.查询 | |
| | | | email | 1.查看（列表+详情）
2.查询
3.导出 | customer_notification_email | r3slzwr0g4j.fb218q5zb@notification.mirakl.net |
| | | 交易号 | 1.查看（列表+详情）
2.查询
3.导出 | | | |
| | 支付方式 | 1.查看（列表+详情）
2.导出
3.查询 | payment_type | null | | |
| 订单备注 | 1.查看（列表+详情）
2.导出 | | | | 卖家（店铺账号） | 1.查看（列表+详情） |
| 2.导出
3.店铺账号筛选 | 从账号中获取店铺名称 | | | CPF税号 | 1.查看（详情） | |
| | | | 订单费用 | 总金额 | 1.查看（列表）
2.导出
3.仓配系统的报表 | total_price |
| | 119.99 | 支持更新 | 交易额 | 1.查看（列表）
2.导出
3.仓配系统的报表 | 交易额=total_price - shipping_price | 119.99 |
| | 支持更新 | 运费 | 1.查看（列表）
2.导出
3.仓配系统的报表 | shipping_price | 0 | 支持更新 |
| | 交易费（成交费） | 1.查看（列表）
2.导出
3.仓配系统的报表 | total_commission | 18.01 | 支持更新 | |
| 手续费 | 1.查看（列表）
2.导出
3.仓配系统的报表 | | | | 其他费用 | 1.查看（列表） |
| 2.导出
3.仓配系统的报表 | | | | 补贴 | 1.查看（列表）
2.导出
3.仓配系统的报表 | |
| | | | 币种 | 1.查看（列表）
2.导出
3.仓配系统的报表 | currency_iso_code | AUD |
| | | 订单时间 | 创建时间 | 1.查看（列表+详情）
2.查询
3.导出 | created_date | "2023-09-27T07:01:15Z" |
| | erp换算成北京时间 | 付款时间 | 1.查看（列表+详情）
2.查询
3.导出 | customer_debited_date | 2023-09-27T07:02:57.257Z | erp换算成北京时间 |
| | 发货时间 | 1.查看（列表+详情）
2.查询
3.导出 | order_lines.shipped_date | 2023-09-28T03:12:56Z | erp换算成北京时间。当订单直接生成到已发货状态下则取平台返回的发货时间时间作为订单的发货时间
发货时间按照商品维度返回的，如果有多个商品，则取值第一个商品的发货时间。 | |
| 收件地址信息 | 收件人 | 1.查看（列表+详情）
2.导出 | shipping_address.(firstname+lastname) | Jiawei Li | 在地址信息没有被编辑的情况下，支持更新地址信息 | |
| 手机号码 | 1.查看（列表+详情）
2.查询
3.导出 | shipping_address.phone | 0426870621 | 在地址信息没有被编辑的情况下，支持更新地址信息 | 公司名 | 1.查看（列表+详情） |
| 2.导出 | shipping_address.company | null | 在地址信息没有被编辑的情况下，支持更新地址信息 | 收件人国家/地址 | 1.查看（列表+详情）
2.查询
3.导出 | shipping_address.country_iso_code |
| | AUS | 在地址信息没有被编辑的情况下，支持更新地址信息 | 收件人省/州 | 1.查看（列表+详情）
2.查询
3.导出 | shipping_address.state | VIC |
| | 在地址信息没有被编辑的情况下，支持更新地址信息 | 城市 | 1.查看（列表+详情）
2.查询
3.导出 | shipping_address.city | BAYSWATER | 在地址信息没有被编辑的情况下，支持更新地址信息 |
| | 邮编 | 1.查看（列表+详情）
2.查询
3.导出 | shipping_address.zip_code | 3153 | 在地址信息没有被编辑的情况下，支持更新地址信息 | |
| 门牌号 | 1.查看（列表+详情）
2.导出 | | | | 地址1 | 1.查看（列表+详情） |
| 2.导出 | shipping_address.street_1 | 28 Fairlawn Place | 在地址信息没有被编辑的情况下，支持更新地址信息 | 地址2 | 1.查看（列表+详情）
2.导出 | shipping_address.street_2 |
| | null | 在地址信息没有被编辑的情况下，支持更新地址信息 | 地址3 | 1.查看（列表+详情）
2.导出 | | |
| | | 平台配送方式 | 1.查看（列表+详情）
2.查询
3.导出 | shipping_type_label | Standard | 支持更新 |
| | 跟踪号 | 1.查看（列表+详情）
2.导出 | | | | |
| 商品信息 | 商品sku（映射的仓库sku） | 1.查看（列表+详情）
2.查询
3.导出 | order_lines.offer_sku | C100911 | | |
| 商品名称 | 1.查看（列表+详情）
2.导出 | order_lines.product_title | "Advwin 160cm Coat Shoe Rack 3 in 1 with 7 Hooks - Black" | | 商品数量 | 1.查看（列表+详情）【商品明细将根据映射关系以仓库sku的维度显示，所以数量也会根据映射关系变化】 |
| 2.导出 | quantity | | | 商品链接 | 1.查看（列表+详情） | |
| | | | 商品图片 | 1.查看（列表+详情） | | |
| | | 单价 | 1.查看（列表+详情）【商品明细将根据映射关系以仓库sku的维度显示，所以单价也会根据映射关系变化】
2.导出 | order_lines.price | 119.99 | price单个商品交易总金额 |
| 单价支持更新 | 4.订单状态生成更新说明
（1）取值订单返回报文中的order_state用于区分订单状态
平台状态（order_state） | 中文解释 | 系统生成说明 | 系统更新说明 | STAGING | 分期（用户没有遇到过这中状态的订单） |
| | 生成付款未完成订单 | WAITING_ACCEPTANCE | 等待接受，用户需要ERP系统自动接受订单 | 生成付款未完成订单 | WAITING_DEBIT | 等待扣款，用户接受订单后变成该状态，过几分钟后系统扣款成功，则自动变成SHIPPING |
| | 付生成付款未完成订单 | WAITING_DEBIT_PAYMENT | 等待付款（用户没有遇到过这中状态的订单） | 生成付款未完成订单 | SHIPPING | 运输中，等待卖家发货，上传跟踪号后变成SHIPPED |
| | 生成待发货审核订单 | SHIPPED | 已发货，上传跟踪号后则变成该状态 | 生成已发货状态订单 | TO_COLLECT | 收集，包裹到指定地址，等待买家拿货 |
| | 生成已发货状态订单 | RECEIVED | 收到，平台过一段时间会自动变成该状态，或者跟踪号的物流轨迹获取到该包裹签收 | 生成已发货状态订单 | CLOSED | 关闭，平台订单最终状态，订单收到后隔一段时间，订单会自动变为关闭 |
| | 生成已发货状态订单 | REFUSED | 拒绝，等待接受的订单用户如果选择拒绝后更新为此状态 | 生成已废弃订单 | CANCELED | 取消 |
| | 生成已废弃订单 | 如果订单在ERP已存在，订单未同步到仓配系统，则将订单更新为已废弃订单，取消前订单已同步到仓配系统，则订单走截单流程，如果截单失败，则在订单上增加自定义标记“stop order fail” | | | | |
（2）平台状态更新需要在系统订单日志内记录状态的更新。
4.确认订单 （1）新增店铺设置：系统是否自动接受订单（设置代码：pm_accept_orders ） 是：pm_accept_orders_yes（默认值） 否：pm_accept_oeders_no 注意：pm_accept_oeders_no中的oeders 已经有多个平台使用无法更新为order，请复制即可
当设置为是的情况下则调用平台接口确认拉取进入系统所有平台状态为WAITING_ACCEPTANCE 的订单。 ①自动确认成功，系统记录日志:"自动接受订单成功" ②自动确认失败，订单按照平台订单状态生成到对应系统状态系统，并且记录日志“自动接受订单失败，失败原因：“平台返回的失败原因”” 【图片】 （2）手动确认订单 ①在付款未完成状态下点击【转待发货审核】按钮出现的弹窗内容提示内容改为“转待发货审核的时候系统会向平台提交接受订单，接受订单一段时间后平台状态会更新为SHIPPING同时系统会自动将订单转到待发货审核。”用户点击确认后调用接受/拒绝订单接口 【图片】 ②点击【转待发货审核】按钮的时候校验订单平台状态是否为WAITING_ACCEPTANCE，如果不是WAITING_ACCEPTANCE状态的话弹窗提示：“此订单不是WAITING_ACCEPTANCE状态的订单无法接受订单，请等待平台状态更新为WAITING_ACCEPTANCE后再试” ③接受订单成功，系统记录日志:"接受订单成功"。并且需要对对应的订单增加系统标记“已接受订单” ④接受订单失败，记录日志“接受订单失败，失败原因：“平台返回的失败原因”” （3）手动拒绝订单 ①新增拒接订单的按钮 【图片】 ②点击【拒绝订单】按钮的时候校验订单平台状态是否为WAITING_ACCEPTANCE，如果不是WAITING_ACCEPTANCE状态的话弹窗提示：“此订单不是WAITING_ACCEPTANCE状态的订单无法拒绝订单，请等待平台状态更新为WAITING_ACCEPTANCE后再试” ③拒绝订单成功，系统记录日志:"拒绝订单成功"。并且需要将订单转已废弃状态 ④拒绝订单失败，记录日志“拒绝订单失败，失败原因：“平台返回的失败原因””
5.订单标发 （1）订单系统》运输方式映射中，需要调用平台的接口：获取标发承运商 作为carrier code的基础数据。 【图片】 （2）【选择订单标记发货】的选择弹窗上需要调整样式如下。 ①carrier code无需强制校验必填， 只要保证carrier code和carrier name任意一项有填写内容即可 【图片】 （3）①【选择订单标记发货】中的批量上传的模板调整如下 【图片】 【批量更新tracking】标发和【批量导入标记发货】 【图片】 ②提交导入的时候仅校验carrier code和carrier name任意一项有填写内容即可