# 更新日志 | 版本号 更新时间 | 更新说明 |---------------|------------------|------------------| | V1.1.13 | 2026-06-16 | 三、商品接口 item.listQuery 接口返回值增加 itemNo 字段 | | V1.1.12 2024-10-12 | 七、FBF/MCF-订单同步 物流轨迹查询返回值增加 scheduleDate 字段 |---------------------------|------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------| | V1.1.11 | 2024-06-20 | 二、API调用详解 增加统一错误码归类字段：errorCode 和 errorMessage | | V1.1.10 2024-05-20 | 七、FBF/MCF-订单同步 增加 iossNo 字段 |---------------------------|------------------------------------|------------------------------------------------------------------------------------------| | V1.1.9 | 2024-05-08 | 七、FBF/MCF-订单同步 增加 taxNumber 税号字段 | | V1.1.8 2022-11-24 | 七、FBF/MCF-订单同步 2.1 查询订单信息新增 shipmentFrom 发货国家字段 |------------------------|------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------| | V1.1.7 | 2022-07-29 | 七、FBF/MCF-订单同步 增加经纬度字段 | | V1.1.6 2022-04-02 | 七、FBF/MCF-订单同步 paymentMethod 字段改成必填 |------------------------|------------------------------------|------------------------------------------------------------------------------------------------------------------| | V1.1.5 | 2022-03-30 | 七、FBF/MCF-订单同步 3.3 Address 增加 addressLine2 字段和说明 | | V1.1.4 2022-03-22 | 七、FBF/MCF-订单同步 3.3 Address 增加 city 和 stateOrProvince 字段和说明 |------------------------|------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | V1.1.3 | 2022-03-14 | 七、FBF/MCF-订单同步 2.1 根据订单ID获取MCF或FBF订单基础信息 移除无效的接口字段 packageList | | V1.1.2 2022-01-24 | 六、FBF-商家获取库存与发货入库 查询货件基础信息及最新状态接口（inbound.listInboundShipments）更新字段描述： lastUpdatedBefore字段：必须早于当前时间减两分钟，且在请求提交时间之前。 |------------------------|------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | V1.1.1 | 2022-01-07 | 三、商品接口 1. 获取商品列表接口(item.listQuery)更新字段名称和描述： status 字段名变更为 itemStatus， 旧版本接口仍可兼容使用； auditStatus 字段名变更为 editStatus，旧版本接口仍可兼容使用； 2. 数据类型(ItemOpenDTO)新增白底图字段 ：megadealPic 含义：商品白底图，目前主要用于平台 megadeal 活动展示,，建议尺寸750*750，底色为纯白, 实物居中。仅支持单张。 3.数据类型(ItemOpenDataDTO)更新字段名称和描述： status 字段名变更为 itemStatus， 旧版本接口仍可兼容使用； auditStatus 字段名变更为 editStatus，旧版本接口仍可兼容使用； | | V1.1.0 | 2022-01-04 | 七、FBF/MCF-订单同步 1.新增 获取FBF订单或MCF订单的包裹列表接口 ( trade.fbf.getPackageList） 含义：通过该接口获取订单的包裹信息列表 2.新增 获取FBF或MCF订单中包裹的详细信息接口(trade.fbf.getPackageTrackingDetails） 含义：可通过该接口获取fordeal出仓物流单号、以及物流单号对应的轨迹信息 3. 新增数据类型：3.9  trackingEvent 物流轨迹  五、FBM-商家获取订单与自主履约 1. 更新数据类型 3.4 Package carrierCode字段是否为必填项，由【必填】更改为： 通过接口trade.fbm.shipOrder写入包裹时，必填； 通过接口trade.fbf.getPackageList获取包裹时，不返回该值。 |---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | V1.0.8 | 2021-12-06 | 六、FBF-商家获取库存与发货入库 1、获取实时库存数据（inventory.listInventorySupply）接口字段调整：数据类型3.10：InventorySupply新增字段：allocatedStock 含义：商家在Fordeal仓已被订单占用的库存数量。可用于计算商家在Fordeal仓可售库存（warehouseStock-allocatedStock） 七、FBF/MCF-订单同步 2、导入MCF订单接口（trade.mcf.createFulfillmentOrder）更新字段paymentMethod为“非必填”；取消字段purchaseTime、deliverySLA | | V1.0.7 2021-11-11 | 一、对接指南 2、授权链接更新； 七、FBF/MCF-订单同步 数据类型3.6 FulfillmentOrderItem：导入订单时支持输入fordealSKU |------------------------|------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | V1.0.6 | 2021-11-04 | 一、对接指南 2、获取/刷新授权令牌，更新返回值，移除 shopId 信息； | | V1.0.5 | 2021-8-26 | 二、API调用详解 1、优化文描； 五、FBM-商家获取订单与自主履约 1、数据类型3.2：OrderItem:增加字段 itemGrandTotal，含义：该SKU在该订单的(预计)结算收入； 七、FBF/MCF-订单同步 1、数据类型3.2：OrderItem 增加字段 itemGrandTotal，含义：该SKU在该订单的(预计)结算收入； 2、MCF业务：订单更新接口区分为：trade.mcf.updateBasicInfo、trade.mcf.updateItems； 3、MCF业务：获取平台地址库接口logistics.getChildrenAddressList中数据类型描述更新； |------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | V1.0.4 | 2021-7-20 | 三、商品接口 1、获取单个商品信息接口：item.getItemDetailById, 修正countrySalePrice格式 新增editStatus 状态信息 新增skuList.skuId信息 2、更新价格接口：item.editSkuPurchasePrice 补充json格式 3、更新库存接口：item.editSkuStock 补充json 格式，增加描述 3、更新文档排版 五、FBM-商家获取订单与自主履约 1、数据类型3.1：FBMOrder，buyerPhone文描修正； 2、订单类型3.2：orderItem增加skuProperties字段，增加SKU属性信息； 六、FBF-商家获取库存与发货入库 1、数据类型3.8：CartonContent增加对字段cartonDetail的举例； 2、数据类型3.5：InboundShipmentInfo修正shipmentId：由int调整为string； 七、FBF/MCF-订单同步 1、获取平台地址库编码接口：trade.mcf.getAdressCode，更名为： logistics.getChildrenAddressList 2、获取平台地址库编码接口：logistics.getChildrenAddressList 字段名称优化； 3、订单数据类型3.2：orderItem增加skuProperties字段，增加SKU属性信息；: |------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | V1.0.3 | 2021-6-1 | 五、FBM-商家获取订单与自主履约 1、批量获取订单接口（trade.fbm.listOrders）入参增加更新时间 lastUpdatedAfter，lastUpdatedBefore； 2、根据订单ID获取订单基础信息接口（trade.fbm.getOrder）以及数据类型3.1: FBMOrder中增加：结算总收入grandTotal，平台收费合计（totalCharge），补贴总金额（subsidyTotal） 3、数据类型3.4: package中，增加物流公司名称（carrierName） 七、FBF/MCF-订单同步 1、批量获取订单接口（trade.fbf.listOrders）入参增加更新时间 lastUpdatedAfter，lastUpdatedBefore； 2、根据订单ID获取订单基础信息接口（trade.fbf.getOrder）以及数据类型3.1:Order中增加：结算总收入grandTotal，平台收费合计（totalCharge），补贴总金额（subsidyTotal） | | V1.0.2 2021-5-25 | 七、FBF/MCF-订单同步 1、MCF订单导入接口（trade.mcf.createFulfillmentOrder）字段调整，增加DeliverySLA，IDNumber，ShipFromName，CODStrategy，Language 2、增加MCF订单更新接口（trade.mcf.updateFulfillmentOrder） 3、增加平台地址库编码获取接口（trade.mcf.getAddressCode） 4、数据类型3.3:Address（1）取消字段addressline2；（2）地址字段类型调整为int |------------------------|---------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | V1.0.1 | 2021-5-12 | 三、商品接口 1、新商品发布接口(item.postitem)调整countrySalePrice格式 2、商品编辑后发布接口(item.editItem)调整countrySalePrice 格式，skuList增加skuId 字段传入 四、订单服务： • 待支付消息接口(OrderPending)：增加字段fulfillmentChannel，区分FBM和FBF 五、FBM-商家获取订单与自主履约： 1、获取单个订单接口（trade.fbm.getOrder） （1）增加字段paymentTime, shipTime, closeTime, 2、批量获取订单接口（trade.fbm.listOrders） （1）入参：createdafter必填，before选填默认当前时间减两分钟； （2）增加字段paymentTime, shipTime, closeTime 3、获取订单详情接口（trade.fbm.listOrderItems） （1）增加字段skuImageUrl 六、商家获取库存与发货入库 1、获取实时库存数据接口（inventory.listInventorySupply） （1）原字段availableStock更新为awaitingReplenishStock，表示当前未发货的客单需求与在仓正品库存的差值，商家需在时效内调拨该数量至Fordeal仓库，及时满足客单需求。 2、根据上传的装箱明细，获取箱单号与箱子标签的PDF文件（inbound.getUniqueCartonLabels） （1）获取箱单标签接口更新，更新为获取箱单文件URL 3、数据类型3.2 Address：增加联系电话，字段名phone 七、FBF/MCF-订单同步 1、获取单个订单接口（trade.fbm.getOrder） （1）增加字段paymentTime, shipTime, closeTime, 2、批量获取订单接口（trade.fbm.listOrders） （1）入参：createdafter必填，before选填默认当前时间减两分钟； （2）增加字段paymentTime, shipTime, closeTime 五、FBM-商家获取订单与自主履约 1、获取订单详情接口（trade.fbm.listOrderItems） （1）增加字段skuImageUrl | | V1.0.0 2020-4-9 | |------------------------|------------------------------|------|