订单查询

接口描述

通过订单号针对订单信息进行查询。

HTTP Verb: POST

URL: /api/supplier-service/v1/b2b/OrderSearch


Example:

POST /api/supplier-service/v1/b2b/OrderSearch  HTTP/1.1
Content-Type: application/json
Accept: application/json
User-Agent: Mozilla 5.0
Host: http://qa.etowertech.com/
X-WallTech-Date: Thu, 06 Aug 2020 06:44:25 GMT
Authorization: WallTech testLvs2jdug2qIoRsJyuxs:F714XG5EBjslUUdx5xJrTCVb9Xs=


请求样例

使用JSON列表格式拼接订单号数据进行查询,最多支持单次查询30个订单。

样例:

["JDQ002445001000931503"]

返回内容

成功样例

{
    "status": "Success",
    "errors": null,
    "data": [
        {
            "status": "Success",
            "errors": null,
            "orderNo": "JDQ002445001000931503",
            "detail": {
                "referenceNo": "order1",
                "service": "CN-US",
                "collectionType": "pick up",
                "shipper": "shipper name",
                "collectionWarehouse": "SH warehouse",
                "clearanceType": "customs declaraton",
                "platformSource": "eBay",
                "platformRefNo": "order1",
                "expectedDepartureDate": "2024-03-15",
                "insuranceType": "No need",
                "insuranceAmount": 0,
                "remark": "test order",
                "loadingPort": "CNSHA",
                "commercialInspection": 0,
                "taxRefund": 0,
                "battery": 0,
                "magnet": 0,
                "declareValue": 100,
                "collectionInfo": {
                    "collectionDate": "2024-03-15",
                    "contact": "Alex",
                    "phoneNumber": "15000695273",
                    "zipCode": "100006",
                    "country": "CN",
                    "province": "Shanghai",
                    "city": "Shanghai",
                    "district": "",
                    "addressLine1": "Dalian Road",
                    "addressLine2": ""
                },
                "consigneeInfo": {
                    "addressCode": "ONT8",
                    "consignee": "FBA",
                    "company": "",
                    "phoneNumber": "",
                    "zipCode": "92551",
                    "email": "",
                    "country": "US",
                    "province": "CA",
                    "city": "Valley",
                    "district": "",
                    "addressLine1": "Golden State FC LLC 24300 Nandina Ave Moreno Valley, CA 92551 US (ONT8)",
                    "addressLine2": ""
                },
                "cartonInfo": [
                    {
                        "ctnNo": "1",
                        "weight": 1,
                        "totalWeight": 100,
                        "width": 100,
                        "height": 100,
                        "length": 100,
                        "amount": 100,
                        "declareAmount": 50,
                        "declareDemension": "20*20*20",
                        "declareWeight": 1,
                        "FBAID": "FBA01",
                        "subOrderNo": "Order1-1",
                        "PONumber": "",
                        "remark": ""
                    },
                    {
                        "ctnNo": "2",
                        "weight": 2,
                        "totalWeight": 50,
                        "width": 100,
                        "height": 100,
                        "length": 100,
                        "amount": 25,
                        "declareAmount": 50,
                        "declareDemension": "20*20*20",
                        "declareWeight": 1,
                        "FBAID": "FBA01",
                        "subOrderNo": "Order1-2",
                        "PONumber": "",
                        "remark": ""
                    }
                ],
                "commodityInfo": [
                    {
                        "ctnNo": "1",
                        "skuNumber": "sku01",
                        "unitPrice": 10,
                        "amount": 100,
                        "hsCode": "2501001100",
                        "nameCN": "车辆",
                        "nameEN": "Car",
                        "materialCN": "金属",
                        "materialEN": "metal",
                        "usage": "transport",
                        "brand": "null",
                        "salesLink": "https://www.walltechsystem.cn/",
                        "type": "",
                        "pictureLink": "https://www.walltechsystem.cn/",
                        "FBAID": "",
                        "PONumber": ""
                    },
                    {
                        "ctnNo": "2",
                        "skuNumber": "sku02",
                        "unitPrice": 10,
                        "amount": 100,
                        "hsCode": "2501001101",
                        "nameCN": "车辆",
                        "nameEN": "Car",
                        "materialCN": "金属",
                        "materialEN": "metal",
                        "usage": "transport",
                        "brand": "null",
                        "salesLink": "https://www.walltechsystem.cn/",
                        "type": "",
                        "pictureLink": "https://www.walltechsystem.cn/",
                        "FBAID": "",
                        "PONumber": ""
                    }
                ],
                "shipmentInfo": [
                    {
                        "shipmentNo": "METO2403150089S",
                        "type": "Sea",
                        "blNo": "jwsea20240315170003",
                        "vessel": "MAERSK SEBAROK",
                        "voyage": "409S",
                        "loadingPort": "CNYTN",
                        "dischargePort": "AUSYD",
                        "transshipmentPort": "",
                        "clearancePort": "",
                        "ETD": "2020-08-16T13:47:12+0800",
                        "ATD": "2020-08-16T13:47:12+0800",
                        "ETA": "2020-08-16T13:47:12+0800",
                        "ATA": "2020-08-16T13:47:12+0800",
                        "supplier": "Shanghai Transport",
                        "carrier": "Maersk",
                        "containerType": "40HQ",
                        "containerNo": "01",
                        "sealNo": "01",
                        "remark": ""
                    },
                    {
                        "shipmentNo": "METO2403150082A",
                        "type": "Air",
                        "mawb": "112-BZAIR20240315160000",
                        "flightNo": "CA017",
                        "loadingPort": "SHA",
                        "dischargePort": "ORD",
                        "originCountry": "CN",
                        "destinationCountry": "US",
                        "ETD": "2020-08-16T13:47:12+0800",
                        "ATD": "2020-08-16T13:47:12+0800",
                        "ETA": "2020-08-16T13:47:12+0800",
                        "ATA": "2020-08-16T13:47:12+0800",
                        "supplier": "Shanghai Transport",
                        "route": "",
                        "remark": ""
                    },
                    {
                        "shipmentNo": "METO2403150086T",
                        "type": "Land",
                        "blNo": "BZLAND20240315170000",
                        "licensePlate": "沪B 95899",
                        "driver": "李师傅",
                        "ETD": "2020-08-16T13:47:12+0800",
                        "ATD": "2020-08-16T13:47:12+0800",
                        "ETA": "2020-08-16T13:47:12+0800",
                        "ATA": "2020-08-16T13:47:12+0800",
                        "supplier": "Shanghai Transport",
                        "POD": "",
                        "ISA": "",
                        "remark": ""
                    },
                    {
                        "shipmentNo": "METO2403150088E",
                        "type": "Express",
                        "trackingNo": "BZEXPRESS20240315170000",
                        "supplier": "Shanghai Transport",
                        "remark": ""
                    }
                ]
            }
        }
    ]
}

失败样例


{
    "status": "Failed",
    "errors": [
        {
            "code": 100009,
            "message": "Order 13344389 not found"
        }
    ],
    "data": [
        {
            "status": "Failure",
            "errors": [
                {
                    "code": 100009,
                    "message": "Order 13344389 not found"
                }
            ],
            "orderId": "13344389",
            "trackingNo": null
        }
    ]
}



字段描述


字段名

类型

描述

detail.referenceNo

varchar

订单参考号

detail.service

varchar

所使用服务

detail.collectionType

varchar

揽收方式,共有“pickup/上门揽收”、“Dropoff/自送到仓”

detail.shipper

varchar

订单所属客户

detail.collectionWarehouse

varchar

集货仓代码

detail.clearanceType

varchar

清关方式

detail.platformSource

varchar

平台来源

detail.platformRefNo

varchar

该订单在三方平台的参考号

detail.expectedDepartureDate

datetime

期望离港时间

detail.insuranceType

varchar

保险类型

detail.insuranceAmount

double

保险金额

detail.remark

varchar

备注

detail.loadingPort

varchar

起运港

detail.commercialInspection

boolean

是否商检

detail.taxRefund

boolean

是否需要退税

detail.battery

boolean

货物是否带电

detail.magnet

boolean

货物是否带磁

detail.declareValue

double

订单申报总金额

detail.collectionInfo


揽收信息容器

detail.collectionInfo.collectionDate

datetime

揽收日期

detail.collectionInfo.contact

varchar

揽收联系人

detail.collectionInfo.phoneNumber

varchar

电话号码

detail.collectionInfo.zipCode

varchar

邮编

detail.collectionInfo.country

varchar

国家

detail.collectionInfo.province

varchar

detail.collectionInfo.city

varchar

城市

detail.collectionInfo.district

varchar

detail.collectionInfo.addressLine1

varchar

地址第一行

detail.collectionInfo.addressLine2

varchar

地址第二行

detail.consigneeInfo


收件人信息

detail.consigneeInfo.addressCode

varchar

地址代码

detail.consigneeInfo.consignee

varchar

收件人

detail.consigneeInfo.company

varchar

公司

detail.consigneeInfo.phoneNumber

varchar

电话号码

detail.consigneeInfo.zipCode

varchar

邮编

detail.consigneeInfo.email

varchar

邮箱

detail.consigneeInfo.country

varchar

国家

detail.consigneeInfo.province

varchar

detail.consigneeInfo.city

varchar

城市

detail.consigneeInfo.district

varchar

detail.consigneeInfo.addressLine1

varchar

地址第一行

detail.consigneeInfo.addressLine2

varchar

地址第二行

detail.cartonInfo


箱子信息

detail.cartonInfo.ctnNo

varchar

箱号

detail.cartonInfo.weight

double

单箱重量

detail.cartonInfo.totalWeight

double

总重量

detail.cartonInfo.width

double

箱宽度

detail.cartonInfo.height

double

箱高度

detail.cartonInfo.length

double

箱长度

detail.cartonInfo.amount

int

箱数

detail.cartonInfo.declareAmount

int

申报箱数

detail.cartonInfo.declareDemension

varchar

申报尺寸,格式为“xx*xx*xx”

detail.cartonInfo.declareWeight

float

申报重量

detail.cartonInfo.FBAID

varchar

FBA ID

detail.cartonInfo.subOrderNo

varchar

子单号

detail.cartonInfo.PONumber

varchar

PO number

detail.cartonInfo.remark

varchar

备注

detail.commodityInfo


商品信息

detail.commodityInfo.ctnNo

varchar

商品所属箱号

detail.commodityInfo.skuNumber

varchar

商品编码

detail.commodityInfo.unitPrice

float

商品单价

detail.commodityInfo.amount

int

单箱商品数

detail.commodityInfo.hsCode

varchar

海关编码

detail.commodityInfo.nameCN

varchar

商品中文名

detail.commodityInfo.nameEN

varchar

商品英文名

detail.commodityInfo.materialCN

varchar

商品材质(中文)

detail.commodityInfo.materialEN

varchar

商品材质(英文)

detail.commodityInfo.usage

varchar

商品用途

detail.commodityInfo.brand

varchar

商品品牌

detail.commodityInfo.salesLink

varchar

商品销售链接

detail.commodityInfo.type

varchar

商品型号

detail.commodityInfo.pictureLink

varchar

商品图片

detail.commodityInfo.FBAID

varchar

FBA ID

detail.commodityInfo.PONumber

varchar

PO number

detail.shipmentInfo


运输信息

detail.shipmentInfo.shipmentNo

varchar

运单号

detail.shipmentInfo.type

varchar

运单类型

detail.shipmentInfo.supplier

varchar

运单所属供应商

detail.shipmentInfo.remark

varchar

备注

detail.shipmentInfo.blNo

varchar

海运提单号,仅运单类型为海运时展示

detail.shipmentInfo.vessel

varchar

船名,仅运单类型为海运时展示

detail.shipmentInfo.voyage

varchar

航次,仅运单类型为海运时展示

detail.shipmentInfo.loadingPort

varchar

起运港,仅运单类型为海运、空运时展示

detail.shipmentInfo.dischargePort

varchar

目的港,仅运单类型为海运、空运时展示

detail.shipmentInfo.transshipmentPort

varchar

中转港,仅运单类型为海运时展示

detail.shipmentInfo.clearancePort

varchar

清关口岸,仅运单类型为海运时展示

detail.shipmentInfo.ETD

datetime

预计出发时间,仅运单类型为海运、空运、陆运时展示

detail.shipmentInfo.ATD

datetime

实际出发时间,仅运单类型为海运、空运、陆运时展示

detail.shipmentInfo.ETA

datetime

预计到达时间,仅运单类型为海运、空运、陆运时展示

detail.shipmentInfo.ATA

datetime

实际到达时间,仅运单类型为海运、空运、陆运时展示

detail.shipmentInfo.carrier

varchar

船公司,仅运单类型为海运时展示

detail.shipmentInfo.containerType

varchar

柜型,仅运单类型为海运时展示

detail.shipmentInfo.containerNo

varchar

柜号,仅运单类型为海运时展示

detail.shipmentInfo.sealNo

varchar

封号,仅运单类型为海运时展示

detail.shipmentInfo.mawb

varchar

空运主单号,仅运单类型为空运时展示

detail.shipmentInfo.flightNo

varchar

航班号,仅运单类型为空运时展示

detail.shipmentInfo.originCountry

varchar

始发国,仅运单类型为空运时展示

detail.shipmentInfo.destinationCountry

varchar

目的国,仅运单类型为空运时展示

detail.shipmentInfo.route

varchar

航线,仅运单类型为空运时展示

detail.shipmentInfo.licensePlate

varchar

牌照,仅运单类型为陆运时展示

detail.shipmentInfo.driver

varchar

驾驶员,仅运单类型为陆运时展示

detail.shipmentInfo.POD

varchar

POD,仅运单类型为陆运时展示

detail.shipmentInfo.ISA

varchar

ISA,仅运单类型为陆运时展示

detail.shipmentInfo.trackingNo

varchar

跟踪号,仅运单类型为快递时展示