-
背景（谁？什么问题？有什么影响？为什么？）
附件中有平台对接的文档
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"
订单状态生成和更新说明见下流程图
https://www.figma.com/board/72XE8cRn8HkeBB8IWXCcAL/%E8%AE%A2%E5%8D%95%E7%94%9F%E5%91%BD%E5%91%A8%E6%9C%9F%E5%A4%84%E7%90%86%E6%B5%81%E7%A8%8B%EF%BC%88Create-Flow---Update-Flow%EF%BC%89?node-id=0-1&t=wHF3qo6LXnndc2hB-1
