简要描述:

创建订单接口


service名称:

createOrder


paramsJson示例:

{
    "reference_no": "WWTEST202001084545",
    "shipping_method": "B测试产品",
    "country_code": "US",
    "order_weight": 1,
    "order_pieces": "1",
    "length":1,
    "width":1,
    "height":1,
    "Consignee": {
        "consignee_street": "19 N Long Ave",
        "consignee_street2": "",
        "consignee_name": "Xiao Cai",
        "consignee_telephone": "958465448",
        "consignee_postcode": "60644-3224",
        "consignee_province": "Illinois",
        "consignee_city": "Chicago",
        "consignee_taxno": "TA2020181245",
        "consignee_email": "9586645845@qq.com",
        "IOSS":"IM5280002079"
    },
    "Shipper": {
        "shipper_countrycode": "CN",
        "shipper_province": "GUANGDONG",
        "shipper_city": "SHENZHEN",
        "shipper_street": "pinghu 55 SHENZHEN GUANGDONG",
        "shipper_postcode": "518000",
        "shipper_name": "hh cai",
        "shipper_telephone": "9586458745",
        "shipper_mobile": "18011911234",
        "shipper_taxno": "FAFA8181AA"
    },
    "ItemArr": [{
        "invoice_cnname": "手机外壳1",
        "invoice_enname": "Mobile phone shell1",
        "invoice_weight": 0.8,
        "invoice_quantity": "3",
        "invoice_unitcharge": 3.5,
        "sku": "4644392"
    },{
        "invoice_cnname": "手机外壳2",
        "invoice_enname": "Mobile phone shell2",
        "invoice_weight": 0.8,
        "invoice_quantity": "3",
        "invoice_unitcharge": 3.5,
        "sku": "4644392"
    }]
}

paramsJson参数:

参数名 数据类型 是否必填 说明
reference_no string Require 客户参考号(客户自定义单号,不能重复,需唯一)
shipping_method string Require 配送方式(产品代码)可以通过“获取配送方式”接口获取列表,也可以访问我司查询产品代码网站https://www.hh-exp.com/pk.php 手工查询
country_code string Require 收件人国家二字码
extra_service string Option 附加服务代码,每个以英文分号“;”隔开
order_weight float Option 订单重量,单位KG,默认为0.2
shipping_method_no string Option 服务商单号(追踪单号,默认不需要传值,由华翰接口返回)
order_pieces int Option 外包装件数,默认1(默认值1即可,发FBA空海运等一票货多箱的时候才需要根据情况设置)
insurance_value float Option 投保金额,默认RMB
mail_cargo_type string Option 包裹申报种类(1-Gif礼品;2-CommercialSample商品货样;3-Document文件;4-Other其他。默认4)
length float Option 长,单位cm,默认1
width float Option 宽,单位cm,默认1
height float Option 高,单位cm,默认1
Consignee Object Require 收件人信息
Shipper Object Require 发件人信息
ItemArr Object/Array Require 海关申报信息
Consignee参数
参数名 数据类型 是否必填 说明
consignee_company string Option 收件人公司名
consignee_province string Option 收件人省
consignee_city string Option 收件人城市
consignee_street string Require 收件人地址1
consignee_street2 string Option 收件人地址2
consignee_street3 string Option 收件人地址3
consignee_postcode string Option 收件人邮编
consignee_name string Require 收件人姓名
consignee_telephone string Option 收件人电话
consignee_mobile string Option 收件人手机
consignee_email string Option 收件人邮箱
consignee_certificatetype string Option 证件类型(ID-身份证;PP-护照)
consignee_certificatecode string Option 证件号码
consignee_credentials_period string Option 证件有效期, 格式:2014-04-15
consignee_doorplate string Option 收件人门牌号(注意:除一些特殊专线产品要求单独上传门牌号外,门牌号直接放地址里面即可无需单独放到此字段)
consignee_taxno string Option 收件人税号(VAT税号)
IOSS string Option 欧盟税号(ioss税号)
Shipper参数
参数名 数据类型 是否必填 说明
shipper_company string Option 发件人公司名
shipper_countrycode string Require 发件人国家二字码
shipper_province string Require 发件人省
shipper_city string Require 发件人城市
shipper_street string Require 发件人地址
shipper_postcode string Require 发件人邮编
shipper_areacode string Option 区域代码
shipper_name string Require 发件人姓名
shipper_telephone string Require 发件人电话
shipper_mobile string Require 发件人手机
shipper_email string Option 发件人邮箱
shipper_fax string Option 发件人传真
order_note string Option 订单备注
shipper_taxno string Option 发件人税号(发件人VAT税号)
ItemArr参数
参数名 数据类型 是否必填 说明
invoice_enname string Require 英文海关申报品名
invoice_cnname string Option 中文海关申报品名
invoice_weight float Require 申报重量,单位KG, 精确到三位小数。
invoice_quantity int Require 数量
unit_code string Option 单位(MTR-米;PCE-件;SET-套),默认PCE
invoice_unitcharge float Require 单价
invoice_currencycode string Option 申报币种,不传值默认为USD(美元);USD-美元,AUD-澳元,CAD-加元,EUR-欧元,GBP-英镑,HKD-港币,MXN-墨西哥元,RMB-人民币,RUB-俄罗斯卢布,SGD-新加坡元
hs_code string Option 海关协制编号(海关编码)
invoice_note string Option 配货信息
invoice_url string Option 销售地址
sku string Option 产品SKU编码
material string Option 申报材质
invoice_function string Option 用途

response XML示例:

成功返回示例:
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://www.example.org/Ec/">
    <SOAP-ENV:Body>
        <ns1:callServiceResponse>
            <response>{"ask":"Success","message":"Success","reference_no":"WWTEST202001084549","shipping_method_no":"LW423745051CN","order_code":"HHWEW0008000011YQ","track_status":"1","sender_info_status":"1","ODA":"","agent_number":"496409","time_cost(s)":"3.8042180538177"}</response>
        </ns1:callServiceResponse>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>
失败返回示例:
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://www.example.org/Ec/">
    <SOAP-ENV:Body>
        <ns1:callServiceResponse>
            <response>{"ask":"Failure","message":"服务异常:订单数据不合法","reference_no":"WWTEST202001084545","Error":{"errMessage":"参考单号已存在[WWTEST202001084545]","errCode":"ORDER_REFER_ISEXISTS"},"time_cost(s)":"0.92805314064026"}</response>
        </ns1:callServiceResponse>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

response参数:

参数名 数据类型 说明
ask string 参考公共请求参数中response参数
message string 参考公共请求参数中response参数
reference_no string 客户单号
shipping_method_no string 服务商单号(追踪单号\尾程派送单号),如:RV507879168CN ,默认取此单号
order_code string 华翰系统订单号,系统生成的唯一单号,如:HHWCO0296000051YQ ,如果需要华翰运单号,可以获取这个字段,此单号也可以17TRACK或华翰官网(hh-exp.com)查询全程轨迹
track_status string track_status(1-已产生跟踪号,2-等待后续更新跟踪号,3-不需要跟踪号) —暂未启用此功能
sender_info_status string 是否需要分配发件人地址(0-是,1-否)
ODA string 是否需要ODA检验(Y-是)
agent_number string 渠道换单号
Error Object 参考公共请求参数中Error格式 (注意:获取报错信息是 message +errMessage 才是完整的报错提示)
文档更新时间: 2021-06-28 08:56   作者:admin