-
背景（谁？什么问题？有什么影响？为什么？）
需求客户：公司名：Rock Enterprise Co Ltd.
客户代码：nt36jq8
-
需求（做什么？怎么做？有什么要注意的？）
目前只做了Falabella的店铺授权，Falabella订单系统暂未对接，客户要求实现拉单。
已授权客户
公司名：Rock Enterprise Co Ltd.
客户代码：nt36jq8
订单流程说明：
https://developers.falabella.com/v600.0.0/reference/flow-order
==============================================================
拉单接口：
-
GetOrders (here): Retrieves orders from a selected date to the current date and time, allowing filters like a specific "status" (e.g., pending), among others.
-
GetOrder (here): Retrieves the data of a specific order.
-
GetOrderItems (here): Retrieves the items of a specific order.
-
GetMultipleOrderItems (here): Retrieves the items of an array of orders.
【以上接口中台已对接】
标发接口：
-
SetStatusToReadyToShip (here): Marks an item as ready to ship.【中台已对接】
订单系统》订单管理
新增Falbella平台。
-
订单明细对接
|
字段分类
|
字段名称
|
字段值
|
说明
|
|
订单核心信息
|
参考号（平台订单号）
|
2899605731
|
OrderId
|
|
|
Order#
|
|
OrderNumber
|
|
|
买家id
|
（报文中无此信息）
|
|
|
|
买家名称
|
Marcela Ramirez Blamey
|
CustomerFirstName + CustomerLastName
|
|
|
站点
|
（报文中无此信息）
|
|
|
|
email
|
（报文中无此信息）
|
CustomerEmail 字段为空
|
|
|
交易号
|
（报文中无此信息）
|
|
|
|
支付方式
|
ecommPay
|
PaymentMethod
|
|
|
订单备注
|
（报文中无此信息）
|
Remarks 字段为空
|
|
|
卖家（店铺账号）
|
（报文中无此信息）
|
|
|
财务信息
|
收件人税号
|
12806221-1
|
NationalRegistrationNumber (智利RUT号)
|
|
|
总金额
|
CLP 17,980.00
|
GrandTotal
|
|
|
交易额
|
CLP 12,990.00
|
PaidPrice
|
|
|
运费
|
CLP 4,990.00
|
ShippingAmount
|
|
|
交易费（成交费）
|
（报文中无此信息）
|
|
|
|
手续费
|
（报文中无此信息）
|
|
|
|
其他费用
|
（报文中无此信息）
|
|
|
|
补贴
|
（报文中无此信息）
|
|
|
|
币种
|
CLP
|
Currency
|
|
时间信息
|
创建时间
|
2025-07-21 13:11:17
|
CreatedAt 需要转换为北京时间
|
|
|
付款时间
|
（报文中无此信息）
|
|
|
|
最晚发货时间
|
2025-07-24 17:57:00
|
PromisedShippingTime 需要转换为北京时间
|
|
|
发货时间
|
（报文中无此信息）
|
|
|
收货人信息
|
收件人
|
Marcela Ramirez Blamey
|
AddressShipping.FirstName + LastName
|
|
|
手机号码
|
（报文中无此信息）
|
AddressShipping.Phone
|
|
|
公司名
|
（报文中无此信息）
|
|
|
|
收件人国家/地址
|
Chile
|
AddressShipping.Country
|
|
|
收件人省/州
|
REGION DE VALPARAISO (V)
|
AddressShipping.Region
|
|
|
城市
|
QUILPUÉ
|
AddressShipping.City
|
|
|
邮编
|
（报文中无此信息）
|
AddressShipping.PostCode
|
|
|
门牌号
|
287
|
|
|
|
地址1
|
Avenida El Belloto
|
AddressShipping.Address1
|
|
|
地址2
|
casa 4
|
AddressShipping.Address3
|
|
物流信息
|
平台配送方式
|
|
|
|
|
跟踪号
|
140111000008891577
|
TrackingCode 当订单在已发货状态下并且缺失跟踪号的情况下则从平台获取跟踪号更新到系统内
|
|
|
平台仓库
|
（报文中无此信息）
|
|
|
商品信息
|
商品sku
|
FL-795-1
|
Sku
|
|
|
商品itemid
|
109371726
|
OrderItemId 仅保存用于标发
|
|
|
包裹id
|
PKG0053915350
|
PackageId 需要支持更新 保存并且显示在订单列表上
|
|
|
商品名称
|
Secador Escurridor De Loza Platos 2 Niveles
|
Name
|
|
|
商品数量
|
1
|
默认数量为1
|
|
|
商品链接
|
（报文中无此信息）
|
|
|
|
商品图片
|
（报文中无此信息）
|
|
|
|
单价
|
CLP 12,990.00
|
ItemPrice
|
2.订单类型区分说明
"ShippingType": "Dropshipping"的情况下此单为商家发货订单
"ShippingType": "Own Warehouse"的情况下此单平台发货订单（FBF）
当订单为平台发货订单则标识此订单为FBP订单
3.订单状态说明：此平台状态为每个商品各自的状态
|
状态英文名
|
状态中文名
|
说明
|
自发货订单
|
FBP订单
|
|
pending
|
待处理
|
初始状态，订单已创建。可通过首次 GetOrders 或 GetOrder 调用获取，或通过 webhook 事件中的订单创建通知获得。
|
待发货审核【所有商品为pending状态】
|
已发货
停留在订单系统中暂不推送仓配系统
|
|
ready_to_ship
|
准备发货
|
卖家确认已准备好发货。此后订单无法被卖家或客户取消，并且预留库存将从可用库存中扣除。
|
已发货【任意一个商品为ready_to_ship，其他商品为非canceled状态】
|
已发货
根据平台海外仓分配规则推送到仓配系统
|
|
shipped
|
已发货
|
卖家将包裹交给物流运营商或 Falabella 物流。这可能是取件或交付到取件点。此状态用于内部衡量卖家的首公里交付合规性（OTS = 卖家及时发货率），用于衡量 Fplus 等级（确保根据承诺发货日期将责任转移给承运商）。
|
已发货【任意一个商品为shipped，其他商品为非canceled状态】
|
已发货
根据平台海外仓分配规则推送到仓配系统
|
|
delivered
|
已交付
|
卖家通过 Webhook 或 GetOrders API 获知客户已收到订单。此状态触发向卖家的付款。
|
已发货【任意一个商品为delivered，其他商品为非canceled状态】
|
已发货
根据平台海外仓分配规则推送到仓配系统
|
|
failed
|
交付失败
|
如果经过 3 次投递尝试（可能因承运商而异）后仍无法将订单交付给客户，则订单将被标记为失败。
|
已发货【任意一个商品为failed，其他商品为非canceled状态】
|
已发货
根据平台海外仓分配规则推送到仓配系统
|
|
canceled
|
已取消
|
订单的终止状态。可由卖家、客户、代理或物流提供商触发。
|
初始化：已废弃【所有商品都已取消】
更新：订单未转仓配，订单所有商品更新为canceled订单转已废弃
订单未转仓配，订单部分商品更新为canceled订单转问题件并且将取消商品设置为不发，异常提示：“订单中有商品取消，已经取消商品设置为不发， 请确认此单是否继续发货，继续发货请转待发货审核，不再发货请转已废弃”【部分的取消商品的订单中取消的商品已设置为不发的情况下不再进行截单或者转问题件处理】
订单已转仓配，部分商品更新为canceled则进行截单，截单成功转问题件，异常提示：“订单中有商品取消，已经取消商品设置为不发， 请确认此单是否继续发货，继续发货请转待发货审核，不再发货请转已废弃”
截单失败则系统备注：状态更新为canceled系统尝试截单，截单失败
|
初始化：已废弃【所有商品都已取消】
更新：订单未转仓配，订单所有商品更新为canceled订单转已废弃
订单未转仓配，订单部分商品更新为canceled订单将取消商品设置为不发，系统日志：“订单中有商品取消，已经取消商品设置为不发。
订单已转仓配，部分商品更新为canceled则进行截单，截单失败则系统备注：状态更新为canceled系统尝试截单，截单失败
|
4.订单标发
（1）取消审核订单时候的要求必须设置承运商的限制，此平台接口标发的时候不用设置承运商。
（2）订单标发的时候使用订单报文中返回的OrderItemId和PackageId进行标发。
5.订单自动拆单
（1）因为这个平台生成订单的时候平台就会自动生成面单和跟踪号，所以需要按照订单上的PackageId拆分订单。
生成订单的需要判断PackageId是否相同，如果相同则不进行拆单。
如果不同的话则自动拆单，将PackageId相同的商品拆分到同一个子单内。
记录日志和系统备注：此单PackageId不同将会拆分进行发货，系统自动拆分订单为wec001、wec002
（2）拆分子单后需要保存商品关联的OrderItemId和PackageId保证预报和标发正常
（3）隐藏【订单合并】、【自动合并订单】、【批量拆单】按钮
（4）订单拆分弹窗需要现在PackageId 字段并且新增提示：请按照 package id拆分订单，相同 package id的商品需要在一个子单内，不然无法对应上平台上已生成的跟踪号和面单从而导致无法正常发货。
①如果订单中商品缺失PackageId的话则不支持进行拆分提示“目前有商品缺失PackageId，请确定此订单已经生成了面单再来拆分”
②如果订单中商品的PackageId都相同的情况下不支持拆分提示“此订单内所有商品都属于同一个PackageId了，将通过一个包裹进行发货，请不要再进行拆分”
6、订单审核
订单审核的时候如果订单本身即没有PackageId也没有TrackingCode的情况下则认为订单还未分配到面单不让进行审核。审核的时候提示“订单暂无获取到面单无法确定订单是否需要拆分，暂不允许审核，请获取到面单然后再试。”
订单审核的时候如果一个订单内存在多个包裹id未进行拆分的情况下提示“此订单内有多个PackageId即关联多个面单，为了保证订单能正常关联跟踪号和面单，请通过【订单拆分】功能按照PackageId进行拆单”
FBF的订单审核订单时候不校验PackageId是否拆分到不同订单，因为不通过系统发货直接审核订单即可。
7、订单列表上以下位置新增Order#的字段并且新增此字段的筛选项
