37Express下单接口(V2)

第2版


创建运单

简要描述
  • 创建运单接口
请求URL
  • https://www.37-express.com/qyfr/api/parcel/v2/
请求方式
  • POST
设置头部(HEADER)
  • Content-Type: application/json
参数
参数名 必选 类型 说明
account object 账号信息
account/email string 用户名
account/password string 密码
createShipment object 正文数据
createShipment/carrier string 派送商的ID号或者代码。可参见派送商代码和ID文档
createShipment/platformOrderNumber string 您的唯一参考单号
createShipment/createTrackingNumber string 是否需要接口返回运单号和快递单。可取值为:true,false,1,0,如果没有该节点或者什么都不填就认为是true
createShipment/getPdfFile string 是否返回快递单文件,由于面单PDF文件较大,不返回面单文件可以加快数据传输速度,如果createTrackingNumber参数为0或false,则该参数无效。可取值为:true,false,1,0,如果没有该节点或者什么都不填就认为是true
createShipment/category int 包裹类别,是一个整数值,默认值是3:<br/>1 礼品<br/>2 商业样板<br/>3 商业快件<br/>4 文件<br/>5 其它<br/>6 个人物品<br/>注:以公司名义寄件不允许提交个人物品的包裹类别
createShipment/invoiceFile string 发票文件(*.pdf),必须是BASE64编码字符串
createShipment/originCountry string 包裹中物品的原产国,填写的是国家代码,例如:US
createShipment/invoiceNumber string 发票号
createShipment/invoiceDate string 发票日期,格式必须是:YYYY-MM-DD
createShipment/parcels array 包裹明细
createShipment/parcels/weight float 包裹重量,单位:kg
createShipment/parcels/length float 包裹长度,单位:cm
createShipment/parcels/width float 包裹宽度,单位:cm
createShipment/parcels/height float 包裹高度,单位:cm
createShipment/parcels/articles array 包裹里的物品信息
createShipment/parcels/articles/description string 物品名称
createShipment/parcels/articles/quantity int 这种物品的数量
createShipment/parcels/articles/value float 单件物品的价值,单位:EUR
createShipment/parcels/articles/weight float 单件物品的重量,单位:KG
createShipment/parcels/articles/hsCode string 物品的海关税号。这里可以查询
createShipment/parcels/articles/brand string 物品的品牌
createShipment/parcels/articles/spec string 物品的规格
createShipment/parcels/articles/barcode string 物品的条形码
createShipment/senderAddress object 寄件人地址
createShipment/senderAddress/prefix string 寄件人称呼
createShipment/senderAddress/firstName string 寄件人名字
createShipment/senderAddress/lastName string 寄件人姓氏
createShipment/senderAddress/companyName string 寄件人公司,如果没有填写姓名,则公司必须填写
createShipment/senderAddress/countryCode string 寄件地址国家代码,例如:FR
createShipment/senderAddress/region string 寄件地址州/省
createShipment/senderAddress/city string 寄件地址城市
createShipment/senderAddress/street string 寄件街道地址
createShipment/senderAddress/street2 string 寄件附加街道地址
createShipment/senderAddress/postalCode string 寄件地址邮编
createShipment/senderAddress/phoneNumber string 寄件人电话
createShipment/senderAddress/email string 寄件人邮箱
createShipment/receiverAddress object 收件人地址
createShipment/receiverAddress/prefix string 收件人称呼
createShipment/receiverAddress/firstName string 收件人名字
createShipment/receiverAddress/lastName string 收件人姓氏
createShipment/receiverAddress/companyName string 收件人公司,如果没有填写姓名,则公司必须填写
createShipment/receiverAddress/countryCode string 收件地址国家代码,例如:US
createShipment/receiverAddress/region string 收件地址州/省
createShipment/receiverAddress/city string 收件地址城市
createShipment/receiverAddress/district string 城市的区/县。如果是中国,这是必填的
createShipment/receiverAddress/street string 收件街道地址
createShipment/receiverAddress/street2 string 收件附加街道地址
createShipment/receiverAddress/postalCode string 收件地址邮编
createShipment/receiverAddress/phoneNumber string 收件人电话
createShipment/receiverAddress/email string 收件人邮箱
createShipment/receiverAddress/idCard string 收件人证件号码
createShipment/upsAccessPointAddress object UPS驿站地址
createShipment/upsAccessPointAddress/name string UPS驿站名称
createShipment/upsAccessPointAddress/countryCode string UPS驿站地址国家代码,例如:FR
createShipment/upsAccessPointAddress/city string UPS驿站地址城市
createShipment/upsAccessPointAddress/street string UPS驿站街道地址
createShipment/upsAccessPointAddress/street2 string UPS驿站附加街道地址
createShipment/upsAccessPointAddress/postalCode string UPS驿站地址邮编
createShipment/mondialrelayPointAddress object Mondial Relay驿站地址
createShipment/mondialrelayPointAddress/id string Mondial Relay驿站ID
createShipment/mondialrelayPointAddress/name string Mondial Relay驿站名称
createShipment/mondialrelayPointAddress/countryCode string Mondial Relay驿站地址国家代码,例如:FR
createShipment/mondialrelayPointAddress/city string Mondial Relay驿站地址城市
createShipment/mondialrelayPointAddress/street string Mondial Relay驿站街道地址
createShipment/mondialrelayPointAddress/street2 string Mondial Relay驿站附加街道地址
createShipment/mondialrelayPointAddress/postalCode string Mondial Relay驿站地址邮编
createShipment/appointmentPickup object 预约上门取件
createShipment/appointmentPickup/pickupDate date 预约上门取件日期,格式必须是:YYYY-MM-DD
createShipment/appointmentPickup/company string 您的公司名
createShipment/appointmentPickup/name string 联系人
createShipment/appointmentPickup/countryCode string 国家,目前只允许FR
createShipment/appointmentPickup/city string 上门城市
createShipment/appointmentPickup/street string 上门街道地址
createShipment/appointmentPickup/room string 门牌号
createShipment/appointmentPickup/floor string 楼层
createShipment/appointmentPickup/postalCode string 上门地址的邮编
createShipment/appointmentPickup/phoneNumber string 联系电话
createShipment/appointmentPickup/isHome string 是否家庭地址。是用Y,否用N
createShipment/appointmentPickup/remarks string 其它特别说明
请求示例
{
    "account": {
        "email": "test@test.com",
        "password": "test_test_test_test"
    },
    "createShipment": {
        "carrier":"ups_access_point",
        "platformOrderNumber":"A-12345678",
        "createTrackingNumber":true,
        "getPdfFile":true,
        "parcels": [
            {"weight": 2,"length": 12,"width": 32,"height": 23,"articles":[
                {"description":"Cadeaux Personnels","quantity":2,"value":12,"weight":1,"hsCode":"38000000"}
            ]},
            {"weight": 3,"length": 11,"width": 33,"height": 88,"articles":[
                {"description":"Vêtements","quantity":1,"value":10,"weight":1.5,"hsCode":"61000000"},
                {"description":"Vêtements","quantity":1,"value":20,"weight":1.5,"hsCode":"61000000"}
            ]}
        ],
        "senderAddress": {
            "firstName": "Jessica",
            "lastName": "La plus belle",
            "companyName": "Cindy H",
            "countryCode": "FR",
            "city": "AUBERVILLIERS",
            "street": "8-10 RUE DE LA HAIE COQ",
            "postalCode": "93300",
            "phoneNumber": "0148340955",
            "email": "cindyhbyazalee@gmail.com"
        },
        "receiverAddress": {
            "firstName": "yangyang",
            "lastName": "xiao",
            "companyName": "TEST COMPANY",
            "countryCode": "DK",
            "city": "COPENHAGEN",
            "street": "OSTERBROGAGE 114 2ND",
            "postalCode": "2100",
            "phoneNumber": "004531905171",
            "email": "xiaoyangyang@ftl-express.com"
        },
        "upsAccessPointAddress":{
            "name":"TABAC PRESSE CARPE DIEM",
            "countryCode":"FR",
            "city":"AJACCIO",
            "street":"27 BOULEVARD DOMINIQUE PAOLI",
            "postalCode":"20090"
        }
    }
}
返回示例
{
    "success": true,
    "createShipment":{
        "incrementId": 78284091,
        "pdfUrlToken": "jdfhjdf84387hs7shdjk82h83jad0oe5",
        "pdfUrl": "https://www.37-express.com/qyfr/api/parcel/print/increment_id/78284091/token/jdfhjdf84387hs7shdjk82h83jad0oe5/",
        "trackingNumber": ["1Z6660YVYZ96488032","1Z6660YVYZ98316053"],
        "pdfContent": "BASE64编码"
    }
}
返回参数说明
参数名 类型 说明
incrementId string 唯一运单编号
pdfUrlToken string 用于打印面单的token
pdfUrl string 用于打印面单的URL
trackingNumber array 派送商的跟踪单号,只有createShipment/createTrackingNumber参数为true时才有
pdfContent string 快递单PDF文件内容,BASE64编码,只有createShipment/createTrackingNumber参数为true时才有
出错返回示例
{
    "success": false,
    "message": "Invalid login or password."
}

页面列表

ITEM_HTML