Upload TrackingNo

Sandbox

https://openapi-stage-hk.orangeconnex.com/openapi

POST

/3pp/inbound/v1/upload/shipment-file

3PP could upload tracking number if the shipping method is express

Request

Header Params

clientKey

string

required

clientKey

Example:

bd1d1971-d0db-11ea-b4a1-00505694c27b

vAuthorization

string

required

vAuthorization

Access-Token

string

required

Access-Token

Example:

Body Params application/json

apiVersion

string

optional

data

object (Order Shipment No File)

optional

inboundNumber

string

required

The inbound number offered by OC when inbound order created.

>= 1 characters<= 100 characters

referenceNumber

string

required

referenceNumber

>= 1 characters<= 50 characters

trackingList

array [object {3}]

required

tracking list

messageId

string

optional

timestamp

integer <int64>

optional

Example

{
    "apiVersion": "string",
    "data": {
        "inboundNumber": "OCI5GB06746394",
        "referenceNumber": "",
        "trackingList": [
            {
                "cartonNumber": "OCC067463940001",
                "carrier": "FHL",
                "trackingNumber": "OCC067464040001DHL"
            }
        ]
    },
    "messageId": "string",
    "timestamp": 0
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://openapi-stage-hk.orangeconnex.com/openapi/3pp/inbound/v1/upload/shipment-file' \
--header 'clientKey: bd1d1971-d0db-11ea-b4a1-00505694c27b' \
--header 'Access-Token:  ' \
--header 'Content-Type: application/json' \
--data-raw '{
    "apiVersion": "string",
    "data": {
        "inboundNumber": "OCI5GB06746394",
        "referenceNumber": "",
        "trackingList": [
            {
                "cartonNumber": "OCC067463940001",
                "carrier": "FHL",
                "trackingNumber": "OCC067464040001DHL"
            }
        ]
    },
    "messageId": "string",
    "timestamp": 0
}'

Responses

🟢200OK

application/json

Body

code

integer <int32>

optional

errors

array[object (CommonVendorResponseErrorMsgDto) {3}]

optional

code

string

optional

string

optional

message

string

optional

message

string

optional

messageId

string

optional

success

boolean

optional

Examples

ExceptionSuccess

{
    "code": 3,
    "errors": [
        {
            "code": "3A0307",
            "id": "OCI5GB06746404",
            "message": "入库单状态为已上架或已取消时，不可上传物流信息"
        }
    ],
    "messageId": "string",
    "success": false
}

🟢201Created

🟠401Unauthorized

🟠403Forbidden

🟠404Not Found

Modified at 2025-06-18 10:58:30

Inbound Label Query

Upload Clearance Doc