跳转至

原始需求

# ECERPH-5023 订单系统》对接ozon平台跨境模式 🚀 0-1 需求 | 状态:已完成 | 创建:2023-12-28 | 最后更新:2024-01-23 云效链接 负责人:文明亮 | 模块:销售-订单管理-拉单 | 迭代:20240123-常规-1月第四迭代

原始需求描述

  1. 背景(谁?什么问题?有什么影响?为什么?)

订单系统》对接ozon平台跨境模式

订单履约流程

物流选择

API接口文档:https://docs.ozon.ru/api/seller/en/

授权说明:https://docs.ozon.ru/api/seller/en/#tag/Auth

批量拉单接口:https://docs.ozon.ru/api/seller/en/#operation/PostingAPI_GetFbsPostingListV3

订单详情拉取接口:https://docs.ozon.ru/api/seller/en/#operation/PostingAPI_GetFbsPostingV3

单个订单预报接口:https://docs.ozon.ru/api/seller/en/#operation/PostingAPI_ShipFbsPostingV3

部分订单预报接口:https://docs.ozon.ru/api/seller/en/#operation/PostingAPI_ShipFbsPostingV3

  1. 需求(做什么?怎么做?有什么要注意的?)

1.订单对接

对接内容分类

系统字段名称

对接后实现的功能

接口字段

备注

订单明细

参考号(平台订单号)

1.查看(列表+详情)

posting_number

2.查询

3.导出

order#

1.查看(列表+详情)

order_number

新增字段支持查看和筛选

2.查询

买家id

1.查看(列表+详情)

customer.customer_id

2.查询

3.导出

买家名称

1.查看(列表+详情)

customer.name

2.查询

3.导出

站点

1.查看(详情)

2.导出

3.查询

email

1.查看(列表+详情)

customer.customer_email

2.查询

3.导出

交易号

1.查看(列表+详情)

2.查询

3.导出

支付方式

1.查看(列表+详情)

analytics_data.payment_type_group_name

2.导出

3.查询

订单备注

1.查看(列表+详情)

2.导出

卖家(店铺账号)

1.查看(列表+详情)

2.导出

3.店铺账号筛选

CPF税号

1.查看(详情)

订单费用

总金额

1.查看(列表)

products.offer_id

*products.quantity

2.导出

3.仓配系统的报表

交易额

1.查看(列表)

products.offer_id

*products.quantity

2.导出

3.仓配系统的报表

运费

1.查看(列表)

这个平台没有买家支付运费,运费都是向卖家收取的

2.导出

3.仓配系统的报表

交易费(成交费)

1.查看(列表)

2.导出

3.仓配系统的报表

手续费

1.查看(列表)

2.导出

3.仓配系统的报表

其他费用

1.查看(列表)

2.导出

3.仓配系统的报表

补贴

1.查看(列表)

2.导出

3.仓配系统的报表

币种

currency_code

订单时间

创建时间

1.查看(列表+详情)

in_process_at

转换为北京时间显示

2.查询

3.导出

付款时间

1.查看(列表+详情)

in_process_at

无付款时间,同样取值创建时间

2.查询

3.导出

最晚发货时间

1.查看(列表+详情)

shipment_date

转换为北京时间显示

2.查询

发货时间

1.查看(列表+详情)

2.查询

3.导出

收件地址信息

收件人

1.查看(列表+详情)

addressee.name

2.导出

手机号码

1.查看(列表+详情)

addressee.phone

2.查询

3.导出

公司名

1.查看(列表+详情)

无地址信息,审单的时候跳过地址校验

2.导出

收件人国家/地址

1.查看(列表+详情)

无地址信息,审单的时候跳过地址校验

2.查询

3.导出

收件人省/州

1.查看(列表+详情)

无地址信息,审单的时候跳过地址校验

2.查询

3.导出

城市

1.查看(列表+详情)

无地址信息,审单的时候跳过地址校验

2.查询

3.导出

邮编

1.查看(列表+详情)

无地址信息,审单的时候跳过地址校验

2.查询

3.导出

门牌号

1.查看(列表+详情)

无地址信息,审单的时候跳过地址校验

2.导出

地址1

1.查看(列表+详情)

无地址信息,审单的时候跳过地址校验

2.导出

地址2

1.查看(列表+详情)

无地址信息,审单的时候跳过地址校验

2.导出

平台配送方式

1.查看(列表+详情)

delivery_method.name

2.查询

3.导出

跟踪号

1.查看(列表+详情)

tracking_number

未有仓库单号并且在已发货状态下的订单才获取平台的跟踪号到系统更新。存在仓库单号的情况下以仓库单号返回的跟踪号为准

2.导出

商品信息

商品sku(映射的仓库sku)

1.查看(列表+详情)

products.offer_id

2.查询

3.导出

商品名称

1.查看(列表+详情)

products.name

2.导出

商品数量

1.查看(列表+详情)【商品明细将根据映射关系以仓库sku的维度显示,所以数量也会根据映射关系变化】

products.quantity

2.导出

商品链接

1.查看(列表+详情)

商品图片

1.查看(列表+详情)

单价

1.查看(列表+详情)【商品明细将根据映射关系以仓库sku的维度显示,所以单价也会根据映射关系变化】

products.price

2.导出

2.拉单说明

(1)订单生成逻辑说明。(因为ozon拆单是在保留原单的基础上再生成一个新单。例如001订单具有A/B2个SKU,拆分为2个子单子单分别具有A/B,则平台上会存在001订单(A)和新增002单(B),所以以下生成订单的判断是为了避免重复生成订单)

(2)订单生成更新状态说明。对应订单状态字段为:status

状态字段

状态说明

系统生成状态

acceptance_in_progress

接受正在进行中

付款未完成

arbitration

仲裁

问题件

awaiting_approve

等待确认

付款未完成

awaiting_deliver

等待发货

已发货

awaiting_packaging

等待包装

待发货审核

awaiting_registration

等待注册

已发货

awaiting_verification

创建

待发货审核

cancelled

已取消

已废弃

cancelled_from_split_pending

已取消

已废弃

client_arbitration

客户交付仲裁

问题件

delivering

递送正在进行中

已发货

driver_pickup

由司机取件

已发货

not_accepted

未被分拣中心接受

已发货

sent_by_seller

由卖方发送

已发货

(3)订单更新说明

订单未审到仓配系统的情况下,订单更新为cancelled或cancelled_from_split_pending时订单转已废弃。

订单已审到仓配系统的情况下,订单更新为cancelled或cancelled_from_split_pending时截单转问题件。如果截单失败则标记订单“stop order fail”

4.订单审单的时候需要去掉地址校验,此平台暂无返回订单地址详情。

5.订单拆分只支持按照平台SKU拆分。(因为ozon拆单是在保留原单的基础上再生成一个新单。例如001订单具有A/B2个SKU,拆分为2个子单子单分别具有A/B,则平台上会存在001订单(A)和新增002单(B)。并且订单预报的时候只能使用订单号预报无法自发货或者改地址发货)

(1)【订单拆分】按钮参考amazon平台支平台SKU拆分。屏蔽仓库SKU拆分的功能

(2)【批量拆单】按钮参考amazon平台支持平台SKU拆分。屏蔽仓库SKU拆分的功能

    

6.新增子单参考号字段:用于保存拆分子单的参考号。

新增子单参考号字段:支持输入多个单号,空格隔开进行多个搜索

拆分子单走ozon物流预报的时候,ozon会拆分订单并且返回拆分后的子单号,仓配系统预报后会将这个返回的订单号作为服务单号,订单系统需要取值此服务单号更新作为系统的子单参考号,并且记录日志:“此单为拆分子单,ozon在预报成功后将生成对应的拆分子单,系统对应更新子单参考号:DSKFHKSDHFKSH”