# 6 物流

# 1 物流

# 1.1 物流试算 (POST)

下单前的物流费用试算, 与 CJ 详情页面基本一致. 需要特殊注明的是, 普通商品和供应商商品, 规则不一样, 供应商商品一般供应商指定了物流. 所以, 下单前需要 特别留意商品类型. 同时也是强烈建议还是将不同商品分开计算, 以规避很多不必要的麻烦, 比如不同物流对于重量、尺寸、大小、商品属性等等问题.

# URL

https://developers.cjdropshipping.com/api2.0/v1/logistic/freightCalculate

# CURL

curl --location --request POST 'https://developers.cjdropshipping.com/api2.0/v1/logistic/freightCalculate' \
                --header 'Content-Type: application/json' \
                --data-raw '{
                    "startCountryCode": "US",
                    "endCountryCode": "US",
                    "products": [
                        {
                            "quantity": 2,
                            "vid": "439FC05B-1311-4349-87FA-1E1EF942C418"
                        }
                    ]
                }'
参数名称 参数意义 参数类型 是否必传 长度 备注
startCountryCode 发货地 string 200
endCountryCode 目的地 string 200
zip zip string no 200
taxId tax id string no 200
houseNumber house number string no 200
iossNumber ioss number string no 200
quantity Quantity int Yes 10
vid Variant id string Yes 200

# 返回

success

{
    "code": 200,
    "result": true,
    "message": "Success",
    "data": [
        {
            "logisticAging": "2-5",
            "logisticPrice": 4.71,
            "logisticPriceCn": 30.54,
            "logisticName": "USPS+"
        }
    ],
    "requestId": "0242ad78-eea2-481d-876a-7cf64398f07f"
}
返回字段 字段意思 字段类型 长度 备注
logisticPrice 物流费用 BigDecimal (18, 2) 单位:$(美元)
logisticPriceCn 物流费用 BigDecimal (18, 2) 单位:¥(人民币)
logisticAging 物流时间 string 20
logisticName 物流名称 string 20

error

{
    "code": 1600100, 
    "result": false,
    "message": "Param error",
    "data": null,
    "requestId": "323fda9d-3c94-41dc-a944-5cc1b8baf5b1"
}
返回字段 字段意思 字段类型 长度 备注
code 错误码 int 20 返回错误码标准表
result 是否正常返回 boolean 1
message 返回信息 string 200
data 接口数据返回
requestId 请求Id string 48 用于日志查询错误

# 1.2 商家物流试算(POST)

# URL

https://developers.cjdropshipping.com/api2.0/v1/logistic/partnerFreightCalculate

# CURL

curl --location --request POST 'https://developers.cjdropshipping.com/api2.0/v1/logistic/partnerFreightCalculate' \
                --header 'Content-Type: application/json' \
                 --data-raw '{
                    "orderNumber": "1234",
                    "shippingZip": "123",
                    "shippingCountryCode": "US",
                    "shippingCountry": "123",
                    "shippingProvince": "123",
                    "shippingCity": "132",
                    "shippingAddress": "123213",
                    "shippingCustomerName": "123",
                    "shippingPhone": "111",
                    "remark": "note",
                    "fromCountryCode": "CN",
                    "logisticName": "PostNL",
                    "houseNumber": "123",
                    "iossType": 税ioss申报方式:1-不使用IOSS申报 2-使用我的IOSS号申报 3-使用CJ的IOSS号申报
                    "iossNumber": ""
                    "products": [
                        {
                            "vid": "92511400-C758-4474-93CA-66D442F5F787",
                            "quantity": 1
                        }
                    ]
                }'
参数名称 参数意义 参数类型 是否必传 长度 备注
orderNumber 订单编号 String 40
shippingCountryCode 交易国家简码 string 200
shippingCountry 交易国家 string 200
shippingProvince 交易省 string 200
shippingCity 交易城市 string 200
shippingAddress 交易地址 string 200
shippingCustomerName 交易接收人 string 200
shippingZip 交易邮编 string 200
shippingPhone 交易电话 string 200 收货人, 电话号码一定要准确
houseNumber 门牌号 string 20
remark 订单备注 string 500
logisticName 物流名称 string 200
fromCountryCode 发货地 string 200 发货仓库
email 邮箱 string 200
consigneeID 收货人id string 200
iossType 税费申报方式 int 20 税ioss申报方式:1-不使用IOSS申报 2-使用我的IOSS号申报 3-使用CJ的IOSS号申报
iossNumber ioss号 string 20
products list 200
vid 变体 id string 200
quantity 变体 数量 string 200

# 返回

success

{
    "code": 200,
    "result": true,
    "message": "Success",
    "data": [
        {
            "postageAmount": 1.69,
            "logisticsModel": "YTGN",
            "logisticsName": "YTO China Domestic"
            "arrivalTime": "2-3",
            "iossList": [
                {
                   "iossNumber": "",
                   "iossType": "",
                   "serviceAmount": "",
                   "taxAmount": ""
                }
            ]
         }
    ],
    "requestId": "0242ad78-eea2-481d-876a-7cf64398f07f"
}
返回字段 字段意思 字段类型 长度 备注
postageAmount 物流金额 BigDecimal (18, 2) 单位:$(美元)
logisticsModel 物流渠道 string 200
logisticsName 物流名称 string 200
arrivalTime 物流时效 string 20
isSupportIoss 是否支持ioss boolean
iossList list
iossNumber ioss号 string
iossType 是否默认,1-不使用IOSS申报 2-使用我的IOSS号申报 3-使用CJ的IOSS号申报
serviceAmount 手续费(美分) BigDecimal (18, 2) 单位:$(美元)
taxAmount 税费(美分) BigDecimal (18, 2) 单位:$(美元)

error

{
    "code": 1600100, 
    "result": false,
    "message": "Param error",
    "data": null,
    "requestId": "323fda9d-3c94-41dc-a944-5cc1b8baf5b1"
}
返回字段 字段意思 字段类型 长度 备注
code 错误码 int 20 返回错误码标准表
result 是否正常返回 boolean 1
message 返回信息 string 200
data 接口数据返回
requestId 请求Id string 48 用于日志查询错误

# 1.3 CJ物流试算(POST)

下单前的物流费用试算, 与 CJ 详情页面基本一致. 需要特殊注明的是, 普通商品和供应商商品, 规则不一样, 供应商商品一般供应商指定了物流. 所以, 下单前需要 特别留意商品类型. 同时也是强烈建议还是将不同商品分开计算, 以规避很多不必要的麻烦, 比如不同物流对于重量、尺寸、大小、商品属性等等问题.

# URL

https://developers.cjdropshipping.com/api2.0/v1/logistic/freightCalculateTip

# CURL

curl --location --request POST 'https://developers.cjdropshipping.com/api2.0/v1/logistic/freightCalculateTip' \
                --header 'Content-Type: application/json' \
                --header 'CJ-Access-Token: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx' \
                --data-raw '{
                    "startCountryCode": "US",
                    "endCountryCode": "US",
                    "products": [
                        {
                            "quantity": 2,
                            "vid": "439FC05B-1311-4349-87FA-1E1EF942C418"
                        }
                    ]
                }'
参数名称 参数意义 参数类型 是否必传 长度 备注
startCountryCode 发货地 string 200
endCountryCode 目的地 string 200
optionName 选项名称 string 200
productProp 商品属性 string[] 200
weight 重量 BigDecimal 200
productTypes 商品类型 string[] 200 0:正常商品, 1:服务商品, 3:包装商品, 4:供应商商品, 5:供应商自发货商品, 6:虚拟商品, 7:pod个性商品
amount 订单金额 BigDecimal 200
customerCode 客户id string 200
zip 邮编 string 200
recipientAddress2 地址2 string 200
houseNumber 门牌号 string 200
uid 订单id string 200
recipientAddress1 地址1 string 200
province 省/州 string 200
email 邮箱 string 200
dutyNo 税号 string 200
platforms 平台 string[] 200
volume 商品体积 BigDecimal 200
station 站点 二字码 string 200
wrapWeight 包装重量 BigDecimal 200
phone 手机号 string 200
town string 200
iossNumber ioss编号 string 200
skuList sku列表 string [] 200
recipientName 收件人姓名 string 200
city 城市 string 200
recipientAddress 收件地址(地址1+地址2) string 200
storageIdList 仓库id string[] 200

# 返回

success

{
    "code": 200,
    "result": true,
    "message": "Success",
    "data": [
        {
            "logisticAging": "2-5",
            "logisticPrice": 4.71,
            "logisticPriceCn": 30.54,
            "logisticName": "USPS+"
        }
    ],
    "requestId": "0242ad78-eea2-481d-876a-7cf64398f07f"
}
返回字段 字段意思 字段类型 长度 备注
channelId 渠道id string 20
discountFee 折扣费用(物流费用美金) string 20
discountFeeCNY 人民币折扣费用(物流费用人民币) string 20
dump 是否抛货 string 20 true-抛货 false-不抛货
arrivalTime 时效 string 20
error 错误信息 string 200
errorEn 错误信息 en string 200
floatMaxPrice 浮动最大金额 string 20
floatMinPrice 浮动最小金额 string 20
logisticsParamRespDTO 推荐物流相关参数 string 20
message 消息通知 string 200
optionId 选项id string 20
postage 物流费用(不包括折扣) string 20
postageCNY 人民币物流费用(不包括折扣) string 20
priceIncreases 物流折扣 string 20
reSort 排序字段 string 20
remoteFee 偏远费 string 20
remoteFeeCNY 偏远费 string 20
tip 提示 string 20
uid 订单id string 20
unWeightChargeTarget 未称重商品费用(0-收 1-不收 string 20
volumeWeight 抛重 string 20
wrapPostage 含包装物流费用 string 20
wrapPostageCNY 含包装人民币物流费用 string 20
wrapWeight 包装重量 string 20
volumeWeight 抛重 string 20
volumeWeight 抛重 string 20
stopWords 禁用词提示(校验未通过) string []
zonePrice object[] 仓库价格
discountFee 不含包装费用 string 20
lastDiscountFee 尾程不含包装费用 string 20
lastWrapPostage 尾程含包装费用 string 20
storageId 仓库id string 20
wrapPostage 含包装费用 string 20
allRuleTips object[] 20 全部规则提示
expression 表达式 string 20
interceptType 拦截类型 0-强拦截 1-非强拦截 string 20
max 范围最大值(姓名、地址) string 20
min 范围最小值(姓名、地址) string 20
msgCode 提示code string 20
type 规则类型 string 20
allStopWords object [] 全部禁用词提示
cnMsg 中文提示 string 20
enMsg 英文提示 string 20
type 禁用词类型 stringp[] 200
words 禁用词 string 20
channel object 物流渠道
cnName 中文名 string 20
enName 英文名 string 20
id 渠道id string 20
cjRespDTO object
postage 物流费用 string 20
postageCNY 人民币物流费用 string 20
remoteFee 偏远费 string 20
remoteFeeCNY 人民币偏远费 string 20
destArea object 20
cnName 中文名称 string 20
countryId 国家id string 20
enName 英文名称 string 20
parentId 父类id string 20
postCode 邮编 string 20
shortCode 简码 string 20
option object 20 物流选项
arrivalTime 妥投天数 string 20
cnName 中文名 string 20
enName 英文名 string 20
id id string 20
ruleTipTypes 必填项规则 string[] 20 (phone、dutyNo、email、zip、destArea3Id、houseNumber)
ruleTips object[] 20 规则提示(校验未通过)
expression 表达式 string 20
interceptType 拦截类型 0-强拦截 1-非强拦截 string 20
max 范围最大值(姓名、地址) string 20
min 范围最小值(姓名、地址) string 20
msgCode 提示code string 20
msgEn 规则消息en string 20
type 规则类型 string 20 phone、dutyNo、email、zip、destArea3Id、houseNumber
msgEn 规则消息en string 20
srcArea object 20 发件国家
cnName 中文名称 string 20
countryId 国家id string 20
id id string 20
parentId 父类id string 20
postCode 邮编 string 20
shortCode 简码 string 20

error

{
    "code": 1600100, 
    "result": false,
    "message": "Param error",
    "data": null,
    "requestId": "323fda9d-3c94-41dc-a944-5cc1b8baf5b1"
}
返回字段 字段意思 字段类型 长度 备注
code 错误码 int 20 返回错误码标准表
result 是否正常返回 boolean 1
message 返回信息 string 200
data 接口数据返回
requestId 请求Id string 48 用于日志查询错误

# 1.4 供应商自发货物流试算(POST)

# URL

https://developers.cjdropshipping.com/api2.0/v1/logistic/getSupplierLogisticsTemplate

# CURL

curl --location --request POST 'https://developers.cjdropshipping.com/api2.0/v1/logistic/getSupplierLogisticsTemplate' \
                --header 'Content-Type: application/json' \
                 --header 'CJ-Access-Token: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx' \
                 --data-raw '{
                    "skuList": ""
                }'
参数名称 参数意义 参数类型 是否必传 长度 备注
skuList 商品sku String[] 200 商品sku(不是变体Sku)

# 返回

success

{
    "code": 200,
    "result": true,
    "message": "Success",
    "data": [
        {
            "skuList": [],
            "logisticsInfoList": [
                {
                    "id": "123",
                    "logisticsName": "fdd",
                    "postage": "",
                    "startCountryCode": "",
                    "destCountryCode": ""
                }
            ]
        }
    ],
    "requestId": "0242ad78-eea2-481d-876a-7cf64398f07f"
}
返回字段 字段意思 字段类型 长度 备注
skuList 商品sku String[]
logisticsInfoList 物流信息 Object[]
id 模板id string 100
logisticsName 模板名称 string 200
postage 运费 BigDecimal (18,2) 单位:$(美元)
startCountryCode 发货国家编码 string 100
destCountryCode 目的国家编码 string 100

error

{
    "code": 1600100, 
    "result": false,
    "message": "Param error",
    "data": null,
    "requestId": "323fda9d-3c94-41dc-a944-5cc1b8baf5b1"
}
返回字段 字段意思 字段类型 长度 备注
code 错误码 int 20 返回错误码标准表
result 是否正常返回 boolean 1
message 返回信息 string 200
data 接口数据返回
requestId 请求Id string 48 用于日志查询错误

# 2 追踪单

# 2.1 查询物流信息 (GET)

订单生成后, 根据追踪号, 查询订单物流. 同样也可以在 CJ 查询物流平台 (opens new window) 查询

将于2024年6月1日弃用, 请使用新接口查询物流轨迹

# URL

https://developers.cjdropshipping.com/api2.0/v1/logistic/getTrackInfo?trackNumber=CJPKL7160102171YQ

# CURL

curl --location --request GET 'https://developers.cjdropshipping.com/api2.0/v1/logistic/getTrackInfo?trackNumber=CJPKL7160102171YQ
                                                                                                    &trackNumber=CJPKL7160102171YQ
                                                                                                    &trackNumber=CJPKL7160102171YQ
                                                                                                    &trackNumber=CJPKL7160102171YQ
参数名称 参数意义 参数类型 是否必传 长度 备注
trackNumber 追踪单号 string 200 支持批量

# 返回

success

{
    "code": 200,
    "result": true,
    "message": "Success",
    "data": [
        {
            "trackingNumber": "CJPKL7160102171YQ",
            "logisticName": "CJPacket Sensitive",
            "trackingFrom": "CN",
            "trackingTo": "US",
            "deliveryDay": "13",
            "deliveryTime": "2021-06-17 07:04:04",
            "trackingStatus": "In transit"
        }
    ],
    "requestId": "3426e927-8c50-4687-9ced-623e77d55bd0"
}
返回字段 字段意思 字段类型 长度 备注
trackingNumber 追踪单号 string 200
trackingFrom 起始地 string 20
trackingTo 目的地 string 20
deliveryDay 交付天数 string 200
deliveryTime 交付时间 string 200
trackingStatus 追踪单状态 string 200

error

{
    "code": 1600100,
    "result": false,
    "message": "Param error",
    "data": null,
    "requestId": "323fda9d-3c94-41dc-a944-5cc1b8baf5b1" 
}
返回字段 字段意思 字段类型 长度 备注
code 错误码 int 20 返回错误码标准表
result 是否正常返回 boolean 1
message 返回信息 string 200
data 接口数据返回
requestId 请求Id string 48 用于日志查询错误

# 2.2 查询物流信息 (GET)

订单生成后, 根据追踪号, 查询订单物流. 同样也可以在 CJ 查询物流平台 (opens new window) 查询

# URL

https://developers.cjdropshipping.com/api2.0/v1/logistic/trackInfo?trackNumber=CJPKL7160102171YQ

# CURL

curl --location --request GET 'https://developers.cjdropshipping.com/api2.0/v1/logistic/trackInfo?trackNumber=CJPKL7160102171YQ
                                                                                                    &trackNumber=CJPKL7160102171YQ
                                                                                                    &trackNumber=CJPKL7160102171YQ
                                                                                                    &trackNumber=CJPKL7160102171YQ
参数名称 参数意义 参数类型 是否必传 长度 备注
trackNumber 追踪单号 string 200 支持批量

# 返回

success

{
    "code": 200,
    "result": true,
    "message": "Success",
    "data": [
        {
            "trackingNumber": "CJPKL7160102171YQ",
            "logisticName": "CJPacket Sensitive",
            "trackingFrom": "CN",
            "trackingTo": "US",
            "deliveryDay": "13",
            "deliveryTime": "2021-06-17 07:04:04",
            "trackingStatus": "In transit"
        }
    ],
    "requestId": "3426e927-8c50-4687-9ced-623e77d55bd0"
}
返回字段 字段意思 字段类型 长度 备注
trackingNumber 追踪单号 string 200
trackingFrom 起始地 string 20
trackingTo 目的地 string 20
deliveryDay 交付天数 string 200
deliveryTime 交付时间 string 200
trackingStatus 追踪单状态 string 200

error

{
    "code": 1600100,
    "result": false,
    "message": "Param error",
    "data": null,
    "requestId": "323fda9d-3c94-41dc-a944-5cc1b8baf5b1" 
}
返回字段 字段意思 字段类型 长度 备注
code 错误码 int 20 返回错误码标准表
result 是否正常返回 boolean 1
message 返回信息 string 200
data 接口数据返回
requestId 请求Id string 48 用于日志查询错误