7).queryOrderRouteV2

Service capabilities: query order route

request url: host:port/server/gateway/order/queryRouteV2

SDK request class: QueryOrderRouteRequestV2

parameter data:

parameter name	description	is required	parameter type	remark
orderNo		TRUE	string	orderNo is not empty

demo:

{
    "orderNo":""
}

SDK response class:OpResponse

response data:

parameter name	description	parameter type		is required	is deprecated
code		int32
message		string
displayable		boolean
success		boolean
data		OrderRouteResponseDTO	OrderRouteResponseDTO
orderRoutes			array[OrderRouteV2]
channel		string		N
orderNo		string		Y
outOrderNo		string		Y
action	tracing action	string		Y	Y
eventCode	tracing action	string		Y
operatorTime		string		Y
eventTime		string		Y
timeZone		string		Y
routingDescription		string		Y	Y
event		string		Y
imageUrl		string		Y
shippingAddressImageUrl		string		Y
orderLocation		string		Y	Y
utcOperatorTime		string		Y	Y
eventZipCode		string		N
eventCity		string		N
eventState		string		N
eventCountry		string		N
trackNo		string		N
updateTime		string		Y
driverPrivacyMobile	valuable when eventCode is out_warehorse_2, expired at 48h	string		N

demo:

{
    "code":0,
    "message":"",
    "displayable":true,
    "data":{
        "orderRoutes":[
            {
                "eventCode":"out_warehorse_2",
                "channel":"YTO",
                "event":"Parcel has left warehouse ADLDC-1. Our driver Bhavinkumar Vaghasiya  is delivering your parcel to you.",
                "eventCity":"SA",
                "eventCountry":"AU",
                "eventState":"SA",
                "eventTime":"2023-12-07 23:11:17",
                "eventTimeZone":"UTC+10:30",
                "operatorTime":"2023-12-08 09:41:17",
                "eventZipCode":"5013",
                "imageUrl":"",
                "shippingAddressImageUrl":"",
                "orderNo":"G02228964003",
                "outOrderNo":"G02228964003",
                "timeZone":"UTC+10:30",
                "updatedTime":1701990677215,
                "utcOperatorTime":"2023-12-07 23:11:17",
                "driverPrivacyMobile":"61291882160,000001"
            },
            {
                "eventCode":"create_order",
                "channel":"YTO",
                "event":"Order created by **.",
                "eventCity":"SA",
                "eventCountry":"AU",
                "eventState":"SA",
                "eventTime":"2023-12-07 23:11:17",
                "eventTimeZone":"UTC+10:30",
                "operatorTime":"2023-12-08 09:41:17",
                "eventZipCode":"5013",
                "imageUrl":"",
                "shippingAddressImageUrl":"",
                "orderNo":"G02228964003",
                "outOrderNo":"G02228964003",
                "timeZone":"UTC+10:30",
                "updatedTime":1701990677215,
                "utcOperatorTime":"2023-12-07 23:11:17"
            }
        ]
       },
    "success":true
}

action mapping:

code	routingDescription	Explain	shown
create_order	Order created by [sender name] to be collected	Create order	Y
collect_order	Parcel arrived at warehouse [warehouse name]. We will deliver within 3 working days.	Parcel arrived at warehouse [warehouse name]. We will deliver within 3 working days.	Y
update_order	Order info updated	Order info updated
deliver_in_warehose	Parcel arrived at warehouse [warehouse name]	Parcel arrived in distribute warehourse	Y
exception_order	Order exception	System error
damage_order	Order damaged	Parcel damaged
order_sorting_finish	Order sorting	Warehouse sorting completed
out_warehorse_2	Parcel has left warehouse [warehouse name]. Our driver [driver name] is delivering your parcel to you.	Driver pick up	Y
exception_change_data_1	Incomplete delivery, being prepared to return to the warehouse.	Driver marks can not finish delivery	Y
exception_reject	You have rejected parcel.	Driver marks reject by recipient	Y
exception_withdrawing_re_in_warehouse	Your parcel has been withdrawn according to the sender's request.	FHE staff marks withdraw	Y
exception_lose	Your parcel is lost, please wait for our further information.	Driver marks lost	Y
damage_warehouse_out	Undelivered, please contact customer service.	Parcel damaged and already out of the warehouse
refund_warehouse_out	Undelivered, please contact customer service.	Parcel withdrawn and already out of the warehouse
sign_in	The parcel has been delivered. If not, please contact parcel_query_xx@fh.express and we will deal with it as soon as possible.	Signed by recipient	Y
sign_image	Your parcel has been delivered.	Delivered at front door, other safe place etc.	Y
navigation_or_address_error	Navigation error or wrong address, unable to reach destination.	Driver marks navigation error or wrong address	Y
recipient_address_pobox	The receiving address is a PO BOX.	Driver marks PO BOX	Y
no_safe_no_way_contact	There is no safe place for the parcel.	Driver marks no safe place to leave parcel	Y
user_request_for_time_change	The recipient requests to change the delivery time.	Driver marks recipient requests a new time for delivery	Y
exception_breakage	xxx Mark as damaged.	Liu Mark as damaged. The parcel is about to return to the warehouse, please wait for further processing. If you haveany questions, please contact your sender for further information	Y
exception_lose	Sorry, your parcel has been lost, please contact the customer service.	Sorry, your parcel has been lost, please contact the customer service.	Y
order_oversize	Oversized or exceeding standards.	Oversized or exceeding standards.	Y
lost	Parcel lost, please contact customer service.	FHE staff marks lost	Y
modify_sign_in	Your parcel has been delivered.	Driver change sign information	Y
reassign	The delivery has not been completed.It has been returned to the warehouse [warehouse name], and will be redeliverd for you as soon as possible.	Driver marks can not finish delivery, and will be deliver one more time	Y
transport_order	Your parcel has been forwarded to USPS, Tracking Number: [tracking number]	Forwarded to USPS (Only in US)	Y
transport_order_v2	display the detail message from other channel	Forwarded to USPS (Only in US)	Y
to_be_delivered	display the detail message from other channel	Forwarded to USPS (Only in US)	Y
allocate_order	Parcel left warehouse [warehouseName] and being transported to [transferWarehouseId]	Parcel left warehouse [warehouseName] and being transported to [transferWarehouseName]	Y
allocate_wait_out	The parcel will be shipped to %s	Order allocate wait out	Y
allocate_out	Parcel left warehouse [warehouseName] and being transported to [transferWarehouseName]	Order allocate out	Y
allocate_in	Parcel arrived at warehouse [warehouseName]. We will deliver within 3 working days	Parcel arrived at warehouse [warehouseName]. We will deliver within 3 working days	Y