-
背景（谁？什么问题？有什么影响？为什么？）
接口文档：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任意一项有填写内容即可