订单预报

1、接口描述

上传订单数据，返回物流跟踪号码

2026-10-16 商品明细增加：

mpid（平台/商家商品标识）

nspid（生产商非标准商品标识）

spid（生产商标准商品标识）。

Amazon ASIN 可通过 mpid 传入并省略 asin；原 asin 参数继续兼容。

2、请求地址

正式环境：https://api.cne.com/cgi-bin/EmsData.dll?DoApi

3、请求方式：POST

4、请求头：

Content-Type: application/json;charset=UTF-8

5、请求参数

{
    "RequestName": "PreInputSet",
    "icID": 71,
    "TimeStamp": 1622816256769,
    "MD5": "e2a2c4f41746d48d7968a2df87b790b3",
    "RecList": [
        {
            "cEmsKind": "CNE全球特惠",
            "nItemType": 1,
            "cAddrFrom": "MYSHOP",
            "shopName": "MYSHOPNAME",
            "iItem": 1,
            "cRNo": "REF00000001",
            "cDes": "GB",
            "cReceiver": "Lynne Bunyan",
            "cRUnit": "",
            "cRAddr": "23 Forence Road ",
            "cRShortAddr": "",
            "cRCity": "Sandhurst",
            "cRPostcode": "GU47 0QB",
            "cRProvince": "Berkshire",
            "cRCountry": "United Kingdom",
            "cRPhone": "07860551211",
            "cRSms": "",
            "cREMail": "",
            "cRTaxCode": "",
            "fWeight": 0.23,
            "iLong": null,
            "iWidth": null,
            "iHeight": null,
            "cMark": "",
            "tradeTime": "2021-12-27 17:28:30",
            "cMemo": "",
            "cReserve": "dxmerp",
            "vatCode":"",
            "iossCode":"",
            "cTaxRefund":"y",
            "returnAddress": {
                "name": "xxx",
                "addr": "xxx",
                "city": "广州市",
                "postcode": "xxx",
                "province": "广东省",
                "country": "CN"
            },
            "labelContent": {
            	"fileType": "pdf",
            	"labelType":"label10x10",
            	"pickList":"0"
            },
            "GoodsList": [
                {
                    "cxGoods": "连衣裙",
                    "cxGoodsA": "dress",
                    "hsCode": "9503002100",
                    "mpid": "SHOP-PRODUCT-001",
                    "nspid": "MODEL-001",
                    "spid": "4006381333931",
                    "certifierId": "CPSC-CERTIFIER-001",
                    "productId": "CPSC-PRODUCT-001",
                    "versionId": "CPSC-VERSION-001",
                    "ixQuantity": 1,
                    "fxPrice": 3.2,
                    "cxMoney": "USD",
                    "ownerType": 2,
                    "ownerName": "xxx有限公司",
                    "ownerCode": "91350211M000100Y43",
                    "exDeclarePrice": 3.2,
                    "exDeclareCurrency": "USD"
                }
            ]
        }
    ]
}

参数说明

字段名称	字段说明	字段类型	必填	备注
RequestName	请求方法名称	String	Y	固定值：PreInputSet
icID	客户编码	String	Y
TimeStamp	当前时间戳	Long	Y	13位时间戳
MD5	MD5签名	String	Y	32位小写
RecList	订单信息列表	`List<RecObject>`	Y	数组，允许一次申请多个

RecObject

字段名称	字段说明	字段类型	必填	备注
cEmsKind	渠道编码	String	Y	EmsKindList接口获取
nItemType	快件类型	Integer(1)	Y	固定为1
cAddrFrom	订单所属平台	String	Y	固定值： WISH EBAY ALIEXPRESS AMAZON DHGATE JD CDISCOUNT LAZADA TOPHATTER JOOM SHOPEE MAGENTO SHOPIFY 1688 VOVA TIKTOK_3PL BUY_WITH_MICROSOFT SHOPEXPRESS COUPANG WALMART ALIBABA ALLEGRO ETSY FAMILYFAIRY FRUUGO MANOMANO OTTO SHOPLAZZA SHOPLINE YAHOO SEMITEMU TEMU 自营店铺填：MYSHOP 其他填：OTHER
shopName	店铺名称	String(64)	N	当 cAddrFrom 为 MYSHOP 或 SHOPIFY 时，请填写店铺或独立站名称
iItem	件数	Integer	Y	默认值1 单个订单包裹数量，非SKU 数量 (大于1时，为一票多件业务，暂不支持)
cRNo	客户参考号	String(32)	N	客户系统订单号，只允许数字、字母、中划线
cDes	收件人国家	String(2)	Y	ISO国家二字码
cReceiver	收件人姓名	String(3,64)	Y	收件人姓名
cRUnit	收件人公司	String(64)	N
cRAddr	收件人地址	String(5,255)	Y	如有【详细地址2】【详细地址3】等信息，请拼接到cRAddr原有数据之后，以空格隔开
cRShortAddr	收件人短地址	String(8)	N	cRCountry 为沙特(SA)时，短地址必填
cRCity	收件人城市	String(3,64)	Y
cRProvince	收件人省州	String(64)	N
cRPostcode	收件人邮编	String(16)	Y
cRCountry	收件人国家	String(64)	Y	国家英文名称
cRPhone	收件人电话	String(32)	N
cRSms	收件人手机	String(32)	N
cREMail	收件人邮箱	String(128)	N
cRTaxCode	收件人税号	String	N	如：巴西税号
fWeight	包裹申报重量	Decimal(8,3)	Y	单位：KG
iLong	长	Decimal(10,2)	N	单位：CM
iWidth	宽	Decimal(10,2)	N	单位：CM
iHeight	高	Decimal(10,2)	N	单位：CM
cMark	标记	String(32)	N	部分Label标签上会显示该字段
tradeTime	交易时间	String(19)	N	时间必须为北京时间，格式为：yyyy-MM-dd HH:mm:ss 如：2021-12-27 17:25:32
cMemo	发货备注	String(254)	N
cReserve	接口提供商	String(30)	N	如：店小秘：dxmerp 芒果：mangoerp
vatCode	vat税号	String(32)	N	如：英国vat
iossCode	ioss号码	String(12)	N	欧盟ioss号码
cTaxRefund	是否退税	String(1)	N	n：否，y：是
cSender	寄件人姓名	String(64)	Y	收件人姓名
cSUnit	寄件人公司	String(64)	N
cSAddr	寄件人地址	String(256)	N
cSCity	寄件人城市	String(64)	N
cSProvince	寄件人省州	String(64)	N
cSPostcode	寄件人邮编	String(32)	N
cSCountry	寄件人国家	String(32)	N	国家英文名称
cSPhone	寄件人电话	String(32)	N
cSSms	寄件人手机	String(32)	N
cSEmail	寄件人邮箱	String(32)	N
returnAddress	退件地址	ReturnAdressObject	N
labelContent	Label打印参数	LabelContentObject	N	为空时，默认不返回打印链接，需要单独生成
GoodsList	产品列表	`List<GoodsObject>`	Y

ReturnAdressObject

字段名称	字段说明	字段类型	必填	备注
name	姓名	String	Y
company	公司	String	N
addr	地址	String	Y
city	城市	String	Y
provice	省州	String	N
country	国家	String	Y	iso国家二字码
postcode	邮编	String	Y
phone	电话	String	N
email	邮箱	String	N
sms	手机	String	N

LabelContentObject

字段名称	字段说明	字段类型	必填	备注
fileType	面单类型	String	Y	默认：pdf
labelType	打印类型	String	Y	默认：label10x10 label10x10：10x10纸张 label10x15：10x15纸张
pickList	拣货单配置	Integer	Y	默认：0 0：不包含拣货单 1：包含拣货单

GoodsObject

字段名称	字段说明	字段类型	必填	备注
cxGoods	产品中文描述	String	Y
cxGoodsA	产品英文描述	String	Y
ixQuantity	产品数量	Integer	Y
fxPrice	产品单价	Decimal(8,2)	Y
cxMoney	申报币种	String(3)	Y	币种三字代码，如：USD、EUR
cxGCodeA	产品sku	String	N
hsCode	海关编码	String	N	欧盟路向务必填写正确
mpid	平台/商家商品标识（M-PID）	String(64)	N	在线卖家、市场或平台分配的唯一商品标识，如 Amazon ASIN
nspid	生产商非标准商品标识（NS-PID）	String(64)	N	生产商、制造商或供应商分配的商品编号、型号等
spid	生产商标准商品标识（S-PID）	String(64)	N	基于国际通用标准的商品标识，如 GTIN（EAN、UPC 等）
asin	Amazon 平台 ASIN	String	N	原有参数继续兼容，也可通过 mpid 传入 ASIN
certifierId	CPSC 证书签发方ID	String	N	用于美国 CPSC Reference 申报，需与 productId、versionId 同时填写；如果未填写，系统可按 SKU、中文品名匹配已维护的 CPSC 申报备案信息
productId	CPSC 产品ID	String	N	用于美国 CPSC Reference 申报，需与 certifierId、versionId 同时填写；如果未填写，系统可按 SKU、中文品名匹配已维护的 CPSC 申报备案信息
versionId	CPSC 产品版本ID	String	N	用于美国 CPSC Reference 申报，需与 certifierId、productId 同时填写；如果未填写，系统可按 SKU、中文品名匹配已维护的 CPSC 申报备案信息
cxGCodeB	仓库编码	String	N
cxGCodeC	仓位编码	String	N
cxgPic	产品图片链接	String	N
cxgURL	产品链接	String	N
cxOrigin	产品原产地国家	String	N	iso国家二字码
ownerType	生产销售单位类型	Integer	N	1:个人 2:企业目前只允许为 2（企业）
ownerName	生产销售单位名称	String	N
ownerCode	生产销售单位统一社会信用代码	String	N	企业18位的统一社会信用代码
exDeclarePrice	出口报关单价	Decimal(8,2)	N	为空，或与 exDeclareCurrency 同时有值
exDeclareCurrency	出口报关币种三字码	String	N	为空，或与 exDeclarePrice 同时有值

ASIN 兼容：Amazon 商品可将 ASIN 填入 mpid 并省略 asin；原有客户继续只传 asin 仍然兼容，无需调整。

6、返回结果

{
    "ReturnValue": 1,
    "OK": 1,
    "ErrList": [
        {
            "iIndex": 0,
            "iID": 87046384,
            "cNum": "3A5V581965316",
            "cNo": "3A5V581965316",
            "cRNo": "002262P0328058000",
            "cCNo": "3A5V581965316",
            "cMess": "",
            "cPNo": "3A5V581965316",
            "printUrl": ""
        }
    ]
}

参数说明

字段名称	字段说明	字段类型	必填	备注
ReturnValue	状态	Integer	Y	大于0：成功小于等于0：失败
cMess	错误描述	String	N	请求失败时有值
OK	成功数量	Integer	Y	下单时，成功下单的数量
ErrList	返回数据内容	`List<ErrObject>`	Y

ErrObject

字段名称	字段说明	字段类型	必填	备注
iIndex	数组索引值	Integer	Y	从0开始，顺序为传入的RecList数组顺序
iID	唯一记录ID	Long	Y	大于0：成功小于等于0：失败 (未来预录单记录的删除、修改则以此ID删除)
cMess	错误描述	String	N	错误描述
cNum	CNE内部单号	String	Y
cNo	运单号	String	Y	物流追踪号码
cRNo	客户参考号	String	N	客户下单时传过来的单号
cPNo	平台单号	String	N	用于提交平台的单号
printUrl	标签打印链接	String	N	请求参数中labelContent不为空时，才有该值注：如果apiToken更换，该链接会失效，可以更加标签打印接口重新生成

1、接口描述#

2、请求地址#

3、请求方式：POST#

4、请求头：#

5、请求参数#

参数说明#

6、返回结果#

参数说明#

1、接口描述

2、请求地址

3、请求方式：POST

4、请求头：

5、请求参数

参数说明

6、返回结果

参数说明