订单预计算

提供订单费用的预计算能力，支持根据订单信息（含商品、收货地址、配送方式等）提前计算订单的商品总价、运费、折扣及最终总金额等费用信息，帮助在正式下单前了解订单成本。

适用场景

正式下单前预估订单总费用（含商品费、运费等）

验证订单信息的有效性（如地址、SKU、配送方式等）

批量预计算多个订单的费用明细

接口类型

POST

请求频率限制

默认频率：以平台配额为准

请求说明

请求URL

正式环境：https://www.westmonth.com/openapi/order/predate
测试环境：https://testing.westmonth.com/openapi/order/predate

请求参数

Header参数

参数名	类型	必填	示例值	说明
Authorization	string	是	authorization	身份验证Token
Content-Type	string	是	application/json	建议固定传此值

Body参数

根字段

参数名	类型	必填	默认值	可选值	说明
uID	string	否	-	-	西月客户uid（指定选品网账号下单）【仅限内部ERP使用】
orders	array	是	-	-	订单集合，最多支持20单

orders数组字段

参数名	类型	必填	默认值	可选值	说明
products	array	是	-	-	产品数据
sellerOrderNo	string	是	-	-	平台订单号
deliveryRegionCode	string	是	-	-	发货区域编码
deliveryMode	string	是	-	快递配送、第三方物流自提、个人自提	配送模式
countryCode	string	是	-	-	国家二字码
zone	string	否	-	-	省、州名称（快递配送必填）
city	string	否	-	-	城市名称（快递配送必填）
county	string	否	-	-	县区、乡镇名称（快递配送必填）
zipcode	string	否	-	-	邮编（快递配送必填）
address1	string	否	-	-	地址1（快递配送必填）
address2	string	否	-	-	地址2
receiver	string	否	-	-	收件人姓名（快递配送必填）
email	string	否	-	-	邮箱
telephone	string	否	-	-	手机号（快递配送必填）
callingCode	integer	否	-	-	手机区域号
expressUrl	string	否	-	-	面单url（第三方物流自提必填）
otherFiles	array	否	-	-	其他附件（一维数组，传文件url）
barcodes	array	否	-	-	条形码（一维数组，传文件url）
logisticsCompany	string	否	-	-	物流公司编码（第三方物流自提必填）
shipmentNo	string	否	-	-	物流单号（第三方物流自提必填）
platformID	integer	否	-	-	平台ID
ecommercePlatformId	integer	否	-	-	平台ID（与platformID作用类似）
shopName	string	否	-	-	店铺名称
node	string	否	-	-	线下备注
labels	string	否	-	-	标签数组，格式：[xxx,xxx,xxx]
typesSources	integer	否	1	1:线上、2:线下	下单类型，默认1（线上）
isPurchase	boolean	否	false	-	是否急采：false=否，true=是
comment	string	否	-	-	买家备注
remark	string	否	-	-	卖家备注
freightOperatorCode	string	否	-	-	指定尾程服务商编码（非必填，特殊渠道使用）
designatedWarehouseIDS	array	否	-	-	指定仓库ID（数组，支持多个，非必填，特殊渠道使用）
rawData	object	否	-	-	原始数据（包含店铺、金额等额外信息）

products数组字段

参数名	类型	必填	默认值	说明
quantity	integer	否	-	商品数量
productSku	string	否	-	SKU名称

响应字段说明

成功响应（HTTP 200）

根字段

字段	类型	说明
code	integer	业务状态码（0表示成功）
msg	string	提示信息（成功时返回"请求成功"）
data	object	业务数据

data对象字段

字段	类型	说明
normalData	array	成功预计算的订单数据
order	array	订单费用汇总数据（与normalData结构一致）
abnormalOrderData	array	异常订单数据（预计算失败的订单）

normalData/order数组字段

字段	类型	说明
sellerOrderNo	string	平台订单号
total	integer	商品总计金额
freight	integer	运费
products	array	订单产品数据
regularPrice	integer	订单原价（商品总计+运费）
discount	integer	订单使用的折扣系数
discountAmount	integer	订单优惠金额
aggregate	integer	订单总金额（最终支付价格）
isCircle	integer	圈货标识（0：非圈货，1：圈货）
deductionImprest	integer	预付款抵扣金额
deductionImprestFormat	integer	格式化的预付款抵扣金额
isWhetherRMB	integer	是否人民币结算（0：否，1：是）
currencyCode	string	货币编码（如：CNY、USD）

products数组字段

字段	类型	说明
productSku	string	产品SKU
price	integer	单价
quantity	integer	商品数量
subtotal	integer	小计金额（单价×数量）

abnormalOrderData数组字段

字段	类型	说明
sellerOrderNo	string	平台订单号
reason	string	异常原因（如：SKU不存在、地址信息不全等）

调用示例

URL请求

请求示例

{
    "uID": "对应西月的uid",
    "orders": [
        {
            "products": [
                {
                    "quantity": 1,
                    "productSku": "cbsft114yy02-一盒12pcs"
                }
            ],
            "sellerOrderNo": "xxxx",
            "deliveryRegionCode": "CN",
            "deliveryMode": "快递配送",
            "countryCode": "US",
            "zone": "Alabama",
            "city": "Sylacauga",
            "county": "",
            "zipcode": "35150",
            "address1": "xxx",
            "address2": "",
            "receiver": "xxxx",
            "telephone": "xxxx"
        }
    ]
}

成功返回示例

{
    "code": 0,
    "data": {
        "normalData": [
            {
                "sellerOrderNo": "576722608781890541",
                "total": "2.8",
                "total_original": "4",
                "freight": 55,
                "products": [
                    {
                        "productSku": "cbsft114yy02-一盒12pcs",
                        "price": "2.8",
                        "quantity": 1,
                        "subtotal": "2.8"
                    }
                ],
                "orderTotal": "57.80",
                "regularPrice": "59.00",
                "discount": 0.7,
                "discountAmount": "1.20",
                "aggregate": "57.80",
                "isCircle": 0,
                "deductionImprest": 0,
                "deductionImprestFormat": 0,
                "isWhetherRMB": 0,
                "currencyCode": "CNY"
            }
        ],
        "order": [
            {
                "sellerOrderNo": "576722608781890541",
                "total": "2.8",
                "total_original": "4",
                "freight": 55,
                "products": [
                    {
                        "productSku": "cbsft114yy02-一盒12pcs",
                        "price": "2.8",
                        "quantity": 1,
                        "subtotal": "2.8"
                    }
                ],
                "orderTotal": "57.80",
                "regularPrice": "59.00",
                "discount": 0.7,
                "discountAmount": "1.20",
                "aggregate": "57.80",
                "isCircle": 0,
                "deductionImprest": 0,
                "deductionImprestFormat": 0,
                "isWhetherRMB": 0,
                "currencyCode": "CNY"
            }
        ],
        "abnormalOrderData": []
    },
    "msg": "请求成功"
}

失败返回示例

{
    "code": 3,
    "msg": "授权无效 authorization timestamp error",
    "data": []
}

错误处理

公共错误码

HTTP status code	错误码	错误信息	描述

注意事项

订单数量（orders）最多支持20单，超过会返回参数错误

不同配送模式（deliveryMode）对应的必填参数不同：

快递配送：需填写zone、city、county、zipcode、address1、receiver、telephone

第三方物流自提：需填写expressUrl、logisticsCompany、shipmentNo

个人自提：无需额外必填参数（除公共必填项外）

货币单位由currencyCode字段标识，默认以人民币（CNY）计算

预计算结果仅供参考，实际下单时可能因库存、活动等因素发生变化

常见问题

Q1：预计算的总金额（aggregate）包含哪些费用？

A：包含商品总金额（total）、运费（freight），扣除优惠金额（discountAmount）后的最终价格。

Q2：abnormalOrderData返回异常订单，如何处理？

A：根据异常原因（reason）修正订单信息，例如：补充缺失的地址信息、更换不存在的SKU等，重新调用接口预计算。

版本历史

版本	日期	修改说明
v1.0	2025-07-01	初始版本，支持订单费用预计算

application/json

Bodyapplication/json

示例

{
    "code": 0,
    "data": {
        "normalData": [
            {
                "sellerOrderNo": "576722608781890541",
                "total": 5,
                "freight": 40,
                "products": [
                    {
                        "productSku": "cbsft114yy02-一盒12pcs",
                        "price": 5,
                        "quantity": 1,
                        "subtotal": 5
                    }
                ],
                "regularPrice": 45,
                "discount": 1,
                "discountAmount": 0,
                "aggregate": 45,
                "isCircle": 0,
                "deductionImprest": 0,
                "deductionImprestFormat": 0,
                "isWhetherRMB": 0,
                "currencyCode": "CNY"
            }
        ],
        "order": [
            {
                "sellerOrderNo": "576722608781890541",
                "total": 5,
                "freight": 40,
                "products": [
                    {
                        "productSku": "cbsft114yy02-一盒12pcs",
                        "price": 5,
                        "quantity": 1,
                        "subtotal": 5
                    }
                ],
                "regularPrice": 45,
                "discount": 1,
                "discountAmount": 0,
                "aggregate": 45,
                "isCircle": 0,
                "deductionImprest": 0,
                "deductionImprestFormat": 0,
                "isWhetherRMB": 0,
                "currencyCode": "CNY"
            }
        ],
        "abnormalOrderData": []
    },
    "msg": "请求成功"
}

订单预计算

订单预计算

适用场景

接口类型

请求频率限制

请求说明

请求参数

Header参数

Body参数

响应字段说明

调用示例

URL请求

请求示例

成功返回示例

失败返回示例

错误处理

注意事项

常见问题

Q1：预计算的总金额（aggregate）包含哪些费用？

Q2：abnormalOrderData返回异常订单，如何处理？

版本历史

请求参数

请求示例代码

返回响应

订单预计算

订单预计算#

适用场景#

接口类型#

请求频率限制#

请求说明#

请求参数#

Header参数#

Body参数#

响应字段说明#

调用示例#

URL请求#

请求示例#

成功返回示例#

失败返回示例#

错误处理#

注意事项#

常见问题#

Q1：预计算的总金额（aggregate）包含哪些费用？#

Q2：abnormalOrderData返回异常订单，如何处理？#

版本历史#

请求参数

请求示例代码

返回响应

订单预计算

适用场景

接口类型

请求频率限制

请求说明

请求参数

Header参数

Body参数

响应字段说明

调用示例

URL请求

请求示例

成功返回示例

失败返回示例

错误处理

注意事项

常见问题

Q1：预计算的总金额（aggregate）包含哪些费用？

Q2：abnormalOrderData返回异常订单，如何处理？

版本历史