创建运单

接口URL #

/label/create

请求方式 #

POST

请求Body参数 #

参数名 示例值 参数类型 是否必填 参数描述
apiUserCode ACUSER String 是 系统账号用户编码
orderUserReferenceCode TESTUSER String 否 可选，可自行填写订单客户识别参考码
sellerOrderNumber TESTORDER-001 String 是 销售订单号
serviceCode - String 是 系统服务渠道代码
shipFrom - Object 是 发件地址信息
shipFrom.code - Object 否 发件地址代码
shipFrom.company TEST String 是 公司名或发件人
shipFrom.attentionName TEST String 否 发件人名称
shipFrom.countryCode US String 是 国家2位简写代码
shipFrom.stateCode CA String 是 州2位简写代码
shipFrom.city rowland height String 是 城市
shipFrom.addressLine1 test String 是 地址1
shipFrom.addressLine2 - Object 否 地址2
shipFrom.postalCode 91748 String 是 邮编
shipFrom.phone 0000000000 String 是 电话号码
shipFrom.phoneExtension 0000 String 否 电话号码分机号
shipFrom.isResidential - - 是 是否住宅地址，true或者false
shipTo - Object 是 -
shipTo.company TEST String 是 公司名或收件人
shipTo.attentionName TEST String 否 收件人名称
shipTo.countryCode US String 是 国家2位简写代码
shipTo.stateCode CA String 是 州2位简写代码
shipTo.city rowland height String 是 城市
shipTo.addressLine1 test String 是 地址1
shipTo.addressLine2 - Object 是 地址2
shipTo.postalCode 91748 String 是 邮编
shipTo.phone 0000000000 String 是 电话号码
shipTo.phoneExtension 0000000000 String 否 电话号码分机号
shipTo.isResidential true Boolean 是 是否住宅地址，true或者false
packages - Object Array 是 包裹列表
packages.length 10 Number 是 包裹长
packages.width 10 Number 是 包裹宽
packages.height 10 Number 是 包裹高
packages.weight 14 Number 是 包裹重量(单个包裹)
packages.quantity 1 Number 是 包裹数量
packages.declaredValue 100 Number 否 包裹保险价值USD(单个包裹）
packages.reference1 REF01 String 否 包裹参考号1
packages.reference2 - Object 否 包裹参考号2
products - Object Array 否 Invoice产品申报列表,当为国际运单时需要填写
products.description product name String 是 产品申报名称
products.declaredValue 10 Number 是 产品申报价值
products.hsCode 96000000 String 是 产品海关编码
products.originCountry CN String 是 产品原产地国家两位简写编码
products.quantity 10 Number 是 产品数量
products.weight 10 Number 否 产品重量
options - Object 是 订单服务选项
options.dimensionUnitCode IN String 是 包裹尺寸单位, 可选值为IN （英寸）,CM (厘米)
options.weightUnitCode LBS String 是 包裹重量单位，可选值为LBS （磅）,KG (公斤)
options.shipDate 2022-05-14 String 否 格式：2022-01-01
options.deliveryConfirmation signature String 否 签名服务方式，无签收：none，普通签收：signature ,成人签收：adultSignature

请求示例 # 

{
    "apiUserCode":"ACUSER",
    "sellerOrderNumber": "TESTORDER-001",
    "serviceCode":"FEDEX-GROUND-AM",
    "shipFrom": {
        "company": "TEST",
        "attentionName": "TEST",
        "countryCode": "US",
        "stateCode": "CA",
        "city": "rowland height",
        "addressLine1": "test",
        "addressLine2": "",
        "postalCode": "91748",
        "phone": "0000000000",
        "phoneExtension": "0000"
    },
    "shipTo": {
        "company": "TEST",
        "attentionName": "TEST",
        "countryCode": "US",
        "stateCode": "CA",
        "city": "rowland height",
        "addressLine1": "test",
        "addressLine2": "",
        "postalCode": "91748",
        "phone": "0000000000",
        "phoneExtension": "0000000000",
        "isResidential": true
    },
    "packages": [
        {
            "length": 10,
            "width": 10,
            "height": 10,
            "weight": 14,
            "quantity": 1,
            "reference1": "REF01"
        }
    ],
    "options": {
        "dimensionUnitCode": "IN",
        "weightUnitCode": "LBS"
    }
}

返回示例 # 

{
    "code": 200,
    "data": {
        "masterTrackingNumber": "289120000008",   //主单号
        "shipmentOrderNumber": "AC20244794020019", //系统单号
        "sellerOrderNumber": "TESTORDER-001",
        "carrierCode": "FedEx",
        "serviceCode": "FEDEX-GROUND-AM",   //渠道代码
        "totalCharge": 10.02,   //运费价格
        "currencyCode": "USD",
        "chargeItems": null,
        "labelUrl": "https://pdf_url",
        "labelFileType": "pdf",
        "trackingNumbers": [   //运单号列表
            "289120000008"
        ]
       
    },
    "message": "success"
}