简要描述:

创建FBA订单接口(注意:小包不是调用此接口)


service名称:

createFbaOrder


paramsJson示例:

{
    "reference_no": "WWTEST202001084545a1",
    "shipping_method": "PK0331",
    "order_weight": 1,
    "length":1,
    "width":1,
    "height":1,
    "Warehouse": {
        "consignee_countrycode": "US",
        "consignee_street": "19 N Long Ave",
        "consignee_street2": "",
        "consignee_street3": "",
        "consignee_doorplate": "101",
        "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",
        "warehouse_code": "EDE5"
    },
    "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"
    },
    "BoxArr": 
    [
        {
            "fba_box_no": "FBA15GTZ23DZU00001",
            "box_weight": 2,
            "box_length": 3,
            "box_width": 4,
            "box_height": 5,
            "ItemArr": [
                {
                    "invoice_cnname": "zhongwenming",
                    "invoice_enname": "yingwenming",
                    "invoice_weight": 1,
                    "invoice_quantity": 1,
                    "invoice_unitcharge": 11,
                    "invoice_currencycode": "USD",
                    "hs_code": 1234567890,
                    "invoice_url": "http://www.amz.com/invoice_url",
                    "sku": "testsku",
                    "material": "glass",
                    "invoice_function": "play",
                    "ASIN": "ASINtestsku"
                },
                {
                    "invoice_cnname": "zhongwenming2",
                    "invoice_enname": "yingwenming2",
                    "invoice_weight": 1,
                    "invoice_quantity": 2,
                    "invoice_unitcharge": 22,
                    "invoice_currencycode": "USD",
                    "hs_code": 1234567890,
                    "invoice_url": "http://www.amz.com/invoice_url",
                    "sku": "testsku2",
                    "material": "glass",
                    "invoice_function": "play",
                    "ASIN": "ASINtestsku2"
                }
            ]
        },
        {
            "fba_box_no": "FBA15GTZ23DZU00002",
            "box_weight": 2,
            "box_length": 3,
            "box_width": 4,
            "box_height": 5,
            "ItemArr": [
                {
                    "invoice_cnname": "zhongwenming",
                    "invoice_enname": "yingwenming",
                    "invoice_weight": 1,
                    "invoice_quantity": 1,
                    "invoice_unitcharge": 11,
                    "invoice_currencycode": "USD",
                    "hs_code": 1234567890,
                    "invoice_url": "http://www.amz.com/invoice_url",
                    "sku": "testsku",
                    "material": "glass",
                    "invoice_function": "play",
                    "ASIN": "ASINtestsku"
                },
                {
                    "invoice_cnname": "zhongwenming2",
                    "invoice_enname": "yingwenming2",
                    "invoice_weight": 1,
                    "invoice_quantity": 2,
                    "invoice_unitcharge": 22,
                    "invoice_currencycode": "USD",
                    "hs_code": 1234567890,
                    "invoice_url": "http://www.amz.com/invoice_url",
                    "sku": "testsku2",
                    "material": "glass",
                    "invoice_function": "play",
                    "ASIN": "ASINtestsku2"
                }
            ]
        }
    ]
}

paramsJson参数:

参数名 数据类型 是否必填 说明
reference_no string Require 客户参考号(客户自定义单号,不能重复,需唯一)
shipping_method string Require 配送方式(产品代码)可以通过“获取配送方式”接口获取列表,也可以访问我司产品代码网站https://www.hh-exp.cn/ProductCode/index.php 手工查询
country_code string Require 收件人国家二字码
extra_service string Option 附加服务代码,每个以英文分号“;”隔开
order_weight float Require 订单重量,单位KG
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
Warehouse Object Require 亚马逊收件仓地址信息
Shipper Object Require 发件人信息
BoxArr Object/Array Require 海关申报信息
Warehouse参数
参数名 数据类型 是否必填 说明
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税号)
warehouse_code string Option 仓库代码(fab仓库代码)
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税号)
BoxArr参数
参数名 数据类型 是否必填 说明
fba_box_no string Require FBA箱号
box_weight string Require 箱子重,单位kg
box_length string Require 箱子长,单位cm
box_width string Require 箱子宽,单位cm
box_height string Require 箱子高,单位cm
ItemArr Object Require 详见ItemArr参数
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":"WWTEST202001084545a5","shipping_method_no":"","order_code":"HHWAB4241000005YQ","track_status":"2","sender_info_status":"0","ODA":"","agent_number":"10455768","parcels":[{"child_number":"HHWAB4241000005YQU001","fba_box_no":"FBA15GTZ23DZU00001","child_track_number":""},{"child_number":"HHWAB4241000005YQU002","fba_box_no":"FBA15GTZ23DZU00002","child_track_number":""}],"time_cost(s)":"2.047544002533"}</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-是)
parcels Object 包含子单号,FBA箱号,子单追踪单号
agent_number string 渠道换单号
Error Object 参考公共请求参数中Error格式 (注意:获取报错信息是 message +errMessage 才是完整的报错提示)
文档更新时间: 2024-09-27 18:30   作者:admin