Back to top

产品介绍

对接流程

  1. 接口采用 Webapi
  2. 如果用post提交,请参考下面post请求

post请求

post采用json提交。


1. 发送数据:

  • Header名称

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

(2). 请求json参数

{
    "nameID": "39003346600003",
    "Miyao": "OP123gVIxZvkAZs1TUBLum5bnioeDUHQeEEtpcMOiGCYciKuD",
    "xmlType": "apiCEB",
    "jsonStr":"[{订单报文格式json,字符串}]"
 }

参数 说 明 生成方法
nameID 用户id 统一分配
Miyao 密钥 后台生成,网站中查看
xmlType 操作方式 接口订单类型,订单apiCEB
jsonStr json 数据 比如"[{\"customsCode\": \"1612231801000\"... }]"

API列表

9610,9710订单提交

订单数据
POSThttp:// 迅达物流/Api/ImportOrders

  • 请求参数:
  1. 9610,9710出口订单提交
字段 数据类型 必填 说明 示例值
  • 订单清单列表信息,可循环
  • customsCode C4 Y 申报地海关代码 “5141”
    ebpCode C..50 Y 电商平台代码 “”
    ebpName C..100 Y 电商平台名称 “”
    orderNo C..60 Y 订单编号 “”
    logisticsCode C..18 Y 物流企业代码 “”
    logisticsName C..100 Y 物流企业名称 “”
    logisticsNo C..80 Y 物流运单编号 “”
    ieFlag C1 Y 进出口标记 “”
    ieDate C8 Y 出口日期 “”
    statisticsFlag C1 Y 申报业务类型 “”
    agentCode C..18 Y 申报企业代码 “”
    agentName C..100 Y 申报企业名称 “”
    ebcCode C..18 Y 收发货人代码 “”
    ebcName C..100 Y 收发货人名称 “”
    ownerCode C..18 Y 生产销售企业代码 “”
    ownerName C..100 Y 生产销售企业名称 “”
    tradeMode C4 Y 贸易方式 “”
    trafMode C1 Y 运输方式 “”
    trafName C..100 Y 运输工具名称 “”
    voyageNo C..32 Y 航班航次号 “”
    billNo C..37 Y 提运单号 “”
    loctNo C..10 N 监管场所代码 “”
    country C3 Y 运抵国(地区) “”
    POD C3..4 Y 指运港代码 “”
    freight N19,2 Y 运费 “”
    fCurrency C3 Y 运费币制 “”
    fFlag C1 Y 运费标志 “”
    insuredFee N19,2 Y 保费 “”
    iCurrency C3 Y 保费币制 “”
    iFlag C1 Y 保费标志 “”
    wrapType C1 Y 包装种类代码 “”
    packNo int Y 件数 “”
    grossWeight N19,3 Y 毛重(公斤) “”
    netWeight N19,3 Y 净重(公斤) “”
    note C..1000 N 备注 “”
    rows
  • 订单商品循环(最多50个商品) 循环
  • gnum N5 Y 排序 “1”
    itemNo C..20 Y 货号,商品id号 “ui12321321”
    itemName C..250 Y 企业商品名称 “剃须头”
    gcode C..10 Y hs编码数据库 “9619009000”
    gname C..250 Y 商品名称 “剃须头”
    Gmodel C..250 Y 规格型号 “0|0|不锈钢|剃须头|无品牌”按照0|0|||格式提交
    barCode C..50 Y 条形码 “”
    country C3 Y 目的国(地区)代码 “”
    currency C3 Y 币制 “”
    qty N19,2 Y 申报数量 “”
    qty1 N19,2 Y 法定数量 “”
    qty2 int N 第二数量 “”
    unit C3 Y 申报计量单位 “”
    unit1 C3 Y 法定计量单位 “”
    unit2 C3 N 第二计量单位 “”
    price N19,2 Y 单价 “”
    totalPrice N19,2 Y 总价 “”
    note C..1000 Y 备注 “”
    • json数据:

    [{
      "customsCode": "5141",
      "ebpCode": "44029602F1",
      "ebpName": "供应链管理有限公司",
      "orderNo": "20210514773711482572",
      "logisticsCode": "4423980050",
      "logisticsName": "国际货运代理有限公司",
      "logisticsNo": "773711482572",
      "ieFlag": "E",
      "portCode": "5141",
      "ieDate": "20210514",
      "statisticsFlag": "B",
      "agentCode": "4401983810",
      "agentName": "物流有限公司",
      "ebcCode": "44029602F1",
      "ebcName": "供应链管理有限公司",
      "ownerCode": "44029602F1",
      "ownerName": "供应链管理有限公司",
      "tradeMode": "9610",
      "trafMode": "5",
      "trafName": "FX6028",
      "voyageNo": "FX6028/20210514",
      "billNo": "02395558363",
      "loctNo": "514105",
      "country": "133",
      "POD": "133",
      "freight": "0.00",
      "fCurrency": "502",
      "fFlag": "3",
      "insuredFee": "0.00",
      "iCurrency": "502",
      "iFlag": "3",
      "wrapType": "2",
      "packNo": "1",
      "grossWeight": "0.538",
      "netWeight": "0.537",
      "note": "",
      "rows": [
        {
          "gnum": "1",
          "itemNo": "300",
          "itemRecordNo": [],
          "itemName": [],
          "gcode": "3926909090",
          "gname": "塑料色板",
          "gmodel": "PP塑料",
          "barCode": "无",
          "country": "133",
          "currency": "502",
          "qty": "3.00",
          "qty1": "0.537",
          "unit": "011",
          "unit1": "035",
          "price": "0.52",
          "totalPrice": "1.56",
          "note": ""
        },
        {
          "gnum": "2",
          "itemNo": "300",
          "itemRecordNo": [],
          "itemName": [],
          "gcode": "3926909090",
          "gname": "塑料色板",
          "gmodel": "PP塑料",
          "barCode": "无",
          "country": "133",
          "currency": "502",
          "qty": "3.000",
          "qty1": "0.537",
          "unit": "011",
          "unit1": "035",
          "price": "0.52",
          "totalPrice": "1.56",
          "note": ""
        }
      ]
    }]
    

    • 响应报文:
    字段 必填 说明
    Success Y 业务请求是否成功,取值1成功/0失败
    Code N 业务响应数据,当Success=200ok,400错误
    Msg N 提示消息
    Data N 返回内容
    • 响应报文,保存成功回执:

    {
      "Code": "200","Success": "1","Data": "",
      "Msg": "成功10条"
    }

    • 响应报文,错误回执:

    {
      "Code": "400","Success": "0","Data": "",
      "Msg": "错误"
    }

    回执接口
    POST您的: http://地址/ BcMessageRec/receiptMessage

    • 9610,9710出口订单回执接口:类似于单一窗口回执接口
    1. 您网站的接受清单回执的地址。
    字段 数据类型 必填 说明 示例值
    recType C..20 Y 回执类型 orderMessage-订单回执
    CEB604Message-清单回执
    orderNo C..60 Y 订单编号
    invtNo C..30 N 海关清单编号
    returnStatus C..20 Y 回执状态 1:入库成功
    0:入库失败
    其它回执状态采用单一窗口标准
    399,800等等
    returnTime C..30 Y 回执时间
    returnInfo C..500 Y 回执内容
    • JSON样例:

    {
      "recType": "CEB604Message",
      "orderNo": "420644869205590285412436276576",
      "invtNo": "51412021E170053052",
      "returnStatus": "399",
      "returnTime": "2021-05-14 15:51:21",
      "returnInfo": "审核通过"
    }
    

    商业快递接口api
    POSThttp://url /api/kuaidiMessage

    • 提交订单api::请求json参数:
    1. xmlType=orderByApi
    {
        "nameID": "39003346600003",
        "Miyao": "OP123gVIxZvkAZs1TUBLum5bnioeDUHQeEEtpcMOiGCYciKuD",
        "xmlType": "orderByApi",
        "jsonStr":"{提交订单json字符串,只能一条数据}"
     }
    字段 数据类型 必填 说明 示例值
    orderID C..30 Y 订单号,唯一 1234567890
    tongdao int N 通道 1:通道一(aosn) ; 2:通道二(ZYL)
    orderCode string Y 批次号,主订单号,提单号,确定是否一批 BATCH123456
    orderID3 string N 第三方订单号
    receiverCompName string N 收件人公司名称(英文) XYZ Corp
    receiverName string Y 收件人姓名(英文) John Doe
    receiverProv string Y 收件人省/州(英文) New South Wales
    receiverCity string Y 收件人城市(英文) Kemps Creek
    receiverArea string N 收件人区县
    receiverHouseNo string N 收件人门牌
    receiverAddress string Y 收件人地址(英文) 123 Main St
    receiverAddressTwo string N 收件人地址二
    address_type string N 收件地址类型
    receiverMobile string N 收件人手机号 123456701
    receiverTel string Y 收件人电话 010-12345678
    receiverEmail string N 收件人邮箱 johndoe@example.com
    receiverPostCode string Y 收件人邮编 2178,邮编要正确填写要和城市对应上
    senderCompName string Y 寄件人公司(英文) ABC Ltd
    senderName string Y 寄件人姓名(英文) Jane Doe
    senderEngProv string Y 寄件人省份(英文) Shanghai
    senderEngCity string Y 寄件人城市(英文) Shanghai
    senderAddress string Y 寄件人地址(英文) 456 Another St
    senderPostCode string Y 寄件人邮编 200000
    senderTel string N 寄件人电话 021-12345678
    senderMobile string Y 寄件人移动电话 09876543210
    countryCode string N 收件国家二字简码 CN
    countryName string N 国家名称【中文】 China
    autoClearanceFlag string N 是否单独报关
    customsDeclMethod string N 报关方式
    productCode C..6 Y 澳洲产品代码(默认YPA)
    P92(DDU)
    P91(DDP)
    P90(包税)
    3位或者6位编码(YPA或者P92YPA)
    默认是(小包POST普快 DDU)
    P91YPA(小包POST普快 DDP)
    P90YPA(小包POST普快 包税)
    (PTG:) 自营卡派大件 Pallet2Go(通道1)
    (ZYL:自营小包(ZYL))小包渠道,偏远区域无法派送,价格优惠.
    (TRU:卡派)大件/多件时,使用此渠道,按体积收费.(AUSTRALiA)
    (MIX:小包混合(AP/自营/STA/专派)
    (FBA:悉尼/墨尔本FBA仓库地址
    下面通道2 .......
    (SAP:澳邮小包渠道,实重 < 22kg,体积重< 40kg,三边总长不超过180 单边<100)
    (STA:Startrack大件/多件时,可使用此渠道,需注意超大/超重有附加费,单边长度不超过180CM,)
    (PIK:到港口仓库自提)
    (MIT:清派混合(AP/自营/STA/卡派)通道2
    (TUK:专派渠道:范围更广价格更优 通道2

    备注:小包的不能立方米不能超过0.16.
    tariffType string N 缴税方式
    insuranceFlag string N 是否投保 1
    insurance DECIMAL N 投保金额 100.00
    taxNo string N 纳税人识别号
    vatNumber string N 增值税号码
    fbaWarehouseCode string N FBA仓库代码
    fbaNo string N FBA po单号/国际物流号
    fbaids string N FBA 亚马逊编码 ids
    numbers string Y 外包装件数 10
    cardType string N 证件类型 1
    cardNo string N 证件号码 ID1234567890
    parcelTypeCode string Y 包裹申报种类 物品/商品货样/文件/其他
    recFee DECIMAL N 实际费用 500.00
    yuRecFee DECIMAL N 预估费用 450.00
    cbm DECIMAL Y 体积立方米 0.13
    length string Y 长度(cm) 100
    width string Y 宽度(cm) 50
    height string Y 高度(cm) 40
    classification string N 内件性质 0:普货 1:带电 2:危险品 3:液体4:粉末 5:带磁
    totalValue DECIMAL N 总价值 1000.00
    innerQty int N 内件商品数量 10
    weight DECIMAL Y 重量(kg) 15.00
    remark string N 备注 Handle with care
    inners
  • 订单商品循环(最多50个商品) 循环
  • gnum int Y 排序 1
    gName string Y 商品名称【中文】 Product Name
    gEngName string Y 商品名称【英文】 Product English Name
    innerContext string N 内件成分说明 Description of inner content
    innerQty string Y 内件数量 2
    innerWeight string N 内件单件重量(KG) 0.5
    innerPrice string Y 内件单价 100.00
    currencyCode string N 币种代码 通道2固定(USD)美元,
    通道1固定(AUD)澳大利亚元
    madePlace string N 产地 China
    hscode string Y 海关编码 HS123456
    model string N 商品规格/型号 Model XYZ
    gBrand string N 商品品牌 Brand Name
    originCountry string N 原产国 CN
    remark string N 备注 No remark
    sku string N SKU/货号 SKU123456
    material string N 材质 Plastic
    purpose string N 用途 General Use
    taxNo string N 税则号 TAX123456
    salesAddress string N 销售地址 123 Sales St
    imgAddress string N 内件图片地址(链接) http://example.com/image.jpg
    distribution string N 配货 0
    electricityFlag string N 是否带电 0
    unitCode string Y 成交单位代码 035
    Unit1 string N 第一计量单位代码 011
    Unit2 string N 第二计量单位代码 011
    subOrders
  • 子订单 包裹尺重信息 循环次数和外包装件数(numbers)保持一致。。
  • numbers >= 2 的时候必须填写
  • numbers 等于 1 的时候不用填写
  • subOrderCode string N 子订单号
    weight Decimal Y 货物入库重量, 单位:KG 1
    length Decimal Y 货物入库长度, 单位:CM 1
    width Decimal Y 货物入库宽度, 单位:CM 1
    height Decimal Y 货物入库高度, 单位:CM 1
    • 请求jsonStr的json:

    {
        "orderID": "1234567890",
        "orderCode": "BATCH123456",
        "orderID3": "",
        "receiverCompName": "XYZ Corp",
        "receiverName": "John Doe",
        "receiverProv": "New South Wales",
        "receiverCity": "Kemps Creek",
        "receiverArea": "",
        "receiverHouseNo": "",
        "receiverAddress": "123 Main St",
        "receiverAddressTwo": "",
        "address_type": "",
        "receiverMobile": "12345678901",
        "receiverTel": "010-12345678",
        "receiverEmail": "johndoe@example.com",
        "receiverPostCode": "2178",
        "senderCompName": "ABC Ltd",
        "senderName": "Jane Doe",
        "senderEngProv": "Shanghai",
        "senderEngCity": "Shanghai",
        "senderAddress": "456 Another St",
        "senderPostCode": "200000",
        "senderTel": "021-12345678",
        "senderMobile": "09876543210",
        "countryCode": "CN",
        "countryName": "China",
        "autoClearanceFlag": "1",
        "customsDeclMethod": "",
        "productCode": "P92ZYL",
        "tariffType": "",
        "insuranceFlag": "1",
        "insurance": "100.00",
        "taxNo": "",
        "vatNumber": "",
        "fbaWarehouseCode": "",
        "fbaNo": "",
        "numbers": "3",
        "cardType": "1",
        "cardNo": "ID1234567890",
        "parcelTypeCode": "Goods",
        "recFee": "500.00",
        "yuRecFee": "450.00",
        "cbm": 1.23,
        "length": "100",
        "width": "50",
        "height": "40",
        "classification": "1",
        "totalValue": "1000.00",
        "innerQty": "10",
        "weight": "15.00",
        "remark": "Handle with care",
        "inners": [
            {
                "gnum": 1,
                "gName": "Product Name",
                "gEngName": "Product English Name",
                "innerContext": "Description of inner content",
                "innerQty": "2",
                "innerWeight": "0.5",
                "innerPrice": "100.00",
                "currencyCode": "USD",
                "madePlace": "China",
                "hscode": "HS123456",
                "model": "Model XYZ",
                "gBrand": "Brand Name",
                "originCountry": "CN",
                "remark": "No remark",
                "sku": "SKU123456",
                "material": "Plastic",
                "purpose": "General Use",
                "taxNo": "TAX123456",
                "salesAddress": "",
                "imgAddress": "",
                "distribution": "",
                "electricityFlag": "",
                "unitCode": "035",
                "Unit1": "035",
                "Unit2": ""
            }
        ],
        "subOrders": [
            {
                "subOrderCode": "",
                "weight": 5,
                "length": 30,
                "width": 15,
                "height": 13
            },
            {
                "subOrderCode": "",
                "weight": 5,
                "length": 30,
                "width": 15,
                "height": 13
            },
            {
                "subOrderCode": "",
                "weight": 5,
                "length": 30,
                "width": 15,
                "height": 13
            }
        ]
    }
    

    • 响应报文说明:
    字段 必填 说明
    Success Y 业务请求是否成功,取值1成功/0失败
    Code N 业务响应数据,当Success=200ok,400错误
    Msg N 提示消息
    Data N 返回内容
    • 响应报文,错误回执:

    {
      "Code": "401",
      "Success": "0",
      "Msg": "错误",
      "Data": "[\"productCode is required and should be a non-empty string.\"]"
    }

    {
      "Code": "51001",
      "Success": "0",
      "Msg": "订单参数校验异常",
      "Data": "[\"收货人邮编、州、城市不匹配\"]"
    }

    字段 必填 返回数据说明
    orderID Y 订单编号
    refCode N 尾端派送号
    conCode N 运单号
    refPdf N 面单pdf地址
    refPdf2 N 面单pdf地址2
    productName N 产品信息
    receiverProv N 邮编
    • 响应报文,保存成功回执:

    {
        "Code": "200",
        "Success": "1",
        "Msg": "成功",
        "Data": "{\"refCode\":\"QNHZ30008780\",\"conCode\":\"JSL1413000012\",\"orderID\":\"8221048103970\",\"productCode\":\"P91EPS\",\"productName\":\"(悉尼)小包全澳不包税DDP\",\"receiverProv\":\"2178\",\"refPdf\":\"https://tracking.ilsau.cn/AGENT_FILE/2024/08/29/3676E3004808_e4901c5d8b3f493eb221f74ea129ad31.pdf\",\"refPdf2\":\"\"}"
    }

    接口请求
    POST http://地址/ api/UrlKuaidiApiOrder

    • 物流轨迹请求参数
    1. xmlType=ordersTrack
    字段 数据类型 必填 说明 示例值
    xmlType String Y ordersTrack api请求类型
    jsonStr List< String > Y 单号 (尾端派送号或者订单号),最多100个,字符串格式。
    • 请求Json:

    {
        "nameID": "39003346600003",
        "Miyao": "OP123gVIxZvkAZs1TUBLum5bnioeDUHQeEEtpcMOiGCYciKuD",
        "xmlType": "ordersTrack",
        "jsonStr":"[\"167604043665\",\"167604038434\",\"167604038521\"]"
     }

    • 响应报文说明:
    字段 必填 说明
    Success Y 业务请求是否成功,取值1成功/0失败
    Code N 业务响应数据,当Success=200ok,400错误
    Msg N 提示消息
    Data N 返回内容json的字符串
    • 响应报文,错误回执:

    {
      "Code": "401",
      "Success": "0",
      "Msg": "无数据",
      "Data": ""
    }

    • (轨迹)内容json的字符串:
    字段 类型 说明
    consignment String 查询的单号
    orderStatus 运单信息
    billTrackList List< BillTrackList > 物流轨迹节点信息
    orderStatus 运单信息
    Service String 服务提供商
    despatchdepot String 始发点
    despatchdate Date 始发时间
    PortOfDelivery String 最新送达地点
    Lastscan Date 最新事件发生时间
    VenderCodeAndRefCode String 服务提供商补充信息和运单
    List< BillTrackList > 物流轨迹节点信息
    deport String 包裹所在地
    desc String 事件描述
    descCn String 事件描述 中文
    date Date 事件发生时间
    • 响应报文,成功回执:

    {
        "Code": "200",
        "Success": "1",
        "Msg": "成功",
        "Data": "[{\"Consignment\":\"3676E3003674\",\"OrderStatus\":{\"Service\":\"\",\"DespatchDepot\":null,\"DespatchDate\":null,\"PortOfDelivery\":null,\"Status\":\"Order Created\",\"Lastscan\":\"2024-08-23 14:53:47\",\"VenderCodeAndRefCode\":\"eParcel 3676E3003674\"},\"BillTrackList\":[{\"Date\":\"2024-08-23 14:53:47\",\"Desc\":\"Order Created\",\"DescCn\":\"订单已创建\",\"Deport\":\"\"}]},{\"Consignment\":\"SKP1413000029\",\"OrderStatus\":{\"Service\":\"\",\"DespatchDepot\":null,\"DespatchDate\":null,\"PortOfDelivery\":null,\"Status\":\"Order Created\",\"Lastscan\":\"2024-08-23 11:10:46\",\"VenderCodeAndRefCode\":\"Truck SKP1413000029\"},\"BillTrackList\":[{\"Date\":\"2024-08-23 11:10:46\",\"Desc\":\"Order Created\",\"DescCn\":\"订单已创建\",\"Deport\":\"\"}]},{\"Consignment\":\"3676E3003672\",\"OrderStatus\":{\"Service\":\"\",\"DespatchDepot\":null,\"DespatchDate\":null,\"PortOfDelivery\":null,\"Status\":\"Order Created\",\"Lastscan\":\"2024-08-23 14:46:27\",\"VenderCodeAndRefCode\":\"eParcel 3676E3003672\"},\"BillTrackList\":[{\"Date\":\"2024-08-23 14:46:27\",\"Desc\":\"Order Created\",\"DescCn\":\"订单已创建\",\"Deport\":\"\"}]}]"
    }

    接口请求
    POST http://地址/ api/ordersWhether

    • 查询订单下单结果,鉴于网络情况到澳洲的情况经常卡断掉,可以查询订单号是否下单成功。成功后返回面单信息,避免重复下单。
    1. xmlType=ordersWhether
    字段 数据类型 必填 说明 示例值
    xmlType String Y ordersWhether api请求类型
    jsonStr String Y 订单号 订单号,字符串格式:比如“1745566468952”。
    • 请求Json:

    {
        "nameID": "39003346600003",
        "Miyao": "OP123gVIxZvkAZs1TUBLum5bnioeDUHQeEEtpcMOiGCYciKuD",
        "xmlType": "ordersWhether",
        "jsonStr":"167604043665"
     }

    • 响应报文说明:
    字段 必填 说明
    Success Y 业务请求是否成功,取值1成功/0失败
    Code Y 业务响应数据,当Success=200ok,400错误
    Msg Y 提示消息
    Data N 返回内容json的字符串
    • 响应报文,错误回执:

    {
      "Code": "400",
      "Success": "0",
      "Msg": "订单号没有数据,可以继续下单",
      "Data": ""
    }

    • 响应报文,有订单的回执:
    字段 必填 返回数据说明
    orderID Y 订单编号
    refCode Y 尾端派送号
    conCode Y 运单号
    refPdf Y 面单pdf地址
    refPdf2 N 面单pdf地址2
    productName N 产品信息
    receiverProv N 邮编

    {
      "Code": "200",
      "Success": "1",
      "Msg": "成功",
      "Data": "{\"refCode\":\"MFBA1900000006\",
        \"refPdf\":\"http://osshk.ilsau.net/Courier_form/2025/04/25/MFBA1900000006.pdf_bf1fe1d876a14ea0976d54d8ef3acc79.pdf\",
        \"refPdf2\":\"\",
        \"conCode\":\"JSL01900000024\",
        \"orderID\":\"1745566468952\",
        \"productCode\":null,\"productName\":null,\"receiverProv\":null}"
    }

    hs编码

    hs编码 名称
    请查看通关网 请查看通关网

    货币编码

    货币 三位编码
    人民币 142
    美元 502

    Generated by   on 2024-8-20