运价、船期查询

Developing

测试环境

https://tapi.antong56.com:8443/antong-api/api-platform

POST

/api/freight/v2/listApiPrices

港到港时：起始港名称、目的港名称必填
港到门时：起始港名称、收货省份名称、收货城市名称、收货区县名称必填（收货街道名称、收货区域范围名称选填，越精确，匹配出的运价越准确）
门到港时：目的港名称、发货省份名称、发货城市名称、发货区县名称必填（发货街道名称、发货区域范围名称选填，越精确，匹配出的运价越准确）
门到门时：发货省份名称、发货城市名称、发货区县名称、收货省份名称、收货城市名称、收货区县名称必填（发货街道名称、发货区域范围名称、收货街道名称、收货区域范围名称选填，越精确，匹配出的运价越准确）

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://tapi.antong56.com:8443/antong-api/api-platform/api/freight/v2/listApiPrices' \
--header 'token: undefined' \
--header 'salt;' \
--header 'sign;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "endPortName": "广澳",
    "startPortName": "上海",
    "emptyFull": "F",
    "isQueryEndPortFee": "0",
    "recProvinceName": "",
    "recCityName": "",
    "recRegionName": "",
    "recStreetName": "",
    "recStreetRangeName": "",
    "sedProvinceName": "",
    "sedCityName": "",
    "sedRegionName": "",
    "sedStreetName": "",
    "sedStreetRangeName": "",
    "coldStorage": ""
}'

Response Example

海运-成功示例

{
    "state": "ok",
    "code": 20000,
    "msg": null,
    "errorMsg": null,
    "result": [
        {
            "seaRailwayPath": null,
            "startPortName": "上海",
            "endPortName": "广澳",
            "startDate": null,
            "endDate": null,
            "priceType": "1COMMON",
            "frequency": null,
            "emptyFull": "F",
            "currencyCode": "RMB",
            "isTransportPrice": null,
            "shipSchedulesId": "vjAAAeNjumSCq9xE",
            "shipSchedulesName": "安盛26/2427S",
            "shipEnglishName": "AN SHENG 26",
            "shipChineseName": "安盛26",
            "flowPath": "上海-广澳",
            "boxPath": "上海-广澳",
            "eta": "2024-08-09 19:48:00",
            "etd": "2024-08-10 11:48:00",
            "endPortEta": "2024-08-13 05:42",
            "stock20": 124,
            "stock40": 25,
            "voyage": "2427S",
            "mainFlowPath": "上海-广澳",
            "flowPathDetail": [
                {
                    "shipSchedulesName": null,
                    "flowPath": "上海-广澳",
                    "preTime": 3,
                    "etd": "2024-08-10 11:48:00",
                    "endPortEta": "2024-08-13 05:42:00",
                    "startPortName": "上海",
                    "endPortName": "广澳",
                    "mainBranchLines": "干线",
                    "bargesChedules": null
                }
            ],
            "totalVoyageTime": "3",
            "freightDetails": [
                {
                    "hisPrice": 2192,
                    "sizeType": "20GP",
                    "price": 3702,
                    "boxType": "GP",
                    "boxTypeId": "vjAAAACEFJEIo/xj",
                    "boxSize": "20",
                    "freightMfeId": "vjAAAeUn3A+NS5E3",
                    "couponList": [
                        {
                            "activityName": "上海优惠券",
                            "couponPrice": 220,
                            "surplusNum": 181,
                            "goodsNames": null
                        }
                    ]
                },
                {
                    "hisPrice": 2192,
                    "sizeType": "20HQ",
                    "price": 2702,
                    "boxType": "HQ",
                    "boxTypeId": "vjAAAACEFJIIo/xj",
                    "boxSize": "20",
                    "freightMfeId": "vjAAAeUoXPiNS5E3",
                    "couponList": []
                },
                {
                    "hisPrice": 2614,
                    "sizeType": "40HQ",
                    "price": 4404,
                    "boxType": "HQ",
                    "boxTypeId": "vjAAAACEFJIIo/xj",
                    "boxSize": "40",
                    "freightMfeId": "vjAAAeUoXPmNS5E3",
                    "couponList": [
                        {
                            "activityName": "上海优惠券",
                            "couponPrice": 220,
                            "surplusNum": 300,
                            "goodsNames": null
                        }
                    ]
                },
                {
                    "hisPrice": 4612,
                    "sizeType": "40RH",
                    "price": 6280,
                    "boxType": "RH",
                    "boxTypeId": "vjAAAACEFJQIo/xj",
                    "boxSize": "40",
                    "freightMfeId": "vjAAAeUnYCmNS5E3",
                    "couponList": []
                },
                {
                    "hisPrice": 3307,
                    "sizeType": "20TK",
                    "price": 3817,
                    "boxType": "TK",
                    "boxTypeId": "vjAAAACEFJYIo/xj",
                    "boxSize": "20",
                    "freightMfeId": "vjAAAeUoXPqNS5E3",
                    "couponList": []
                }
            ]
        },
        {
            "seaRailwayPath": null,
            "startPortName": "上海",
            "endPortName": "广澳",
            "startDate": null,
            "endDate": null,
            "priceType": "1COMMON",
            "frequency": null,
            "emptyFull": "F",
            "currencyCode": "RMB",
            "isTransportPrice": null,
            "shipSchedulesId": "vjAAAeWk0GiCq9xE",
            "shipSchedulesName": "RJ测试船舶/20241002S",
            "shipEnglishName": "rjtest",
            "shipChineseName": "RJ测试船舶",
            "flowPath": "上海-广澳",
            "boxPath": "上海-广澳",
            "eta": "2024-10-08 11:35:00",
            "etd": "2024-10-08 14:35:00",
            "endPortEta": "2024-10-10 18:53",
            "stock20": 670,
            "stock40": 110,
            "voyage": "20241002S",
            "mainFlowPath": "上海-广澳",
            "flowPathDetail": [
                {
                    "shipSchedulesName": null,
                    "flowPath": "上海-广澳",
                    "preTime": 2,
                    "etd": "2024-10-08 14:35:00",
                    "endPortEta": "2024-10-10 18:53:00",
                    "startPortName": "上海",
                    "endPortName": "广澳",
                    "mainBranchLines": "干线",
                    "bargesChedules": null
                }
            ],
            "totalVoyageTime": "2",
            "freightDetails": [
                {
                    "hisPrice": 2192,
                    "sizeType": "20GP",
                    "price": 3702,
                    "boxType": "GP",
                    "boxTypeId": "vjAAAACEFJEIo/xj",
                    "boxSize": "20",
                    "freightMfeId": "vjAAAeUn3A+NS5E3",
                    "couponList": [
                        {
                            "activityName": "上海优惠券",
                            "couponPrice": 220,
                            "surplusNum": 181,
                            "goodsNames": null
                        }
                    ]
                },
                {
                    "hisPrice": 2192,
                    "sizeType": "20HQ",
                    "price": 2702,
                    "boxType": "HQ",
                    "boxTypeId": "vjAAAACEFJIIo/xj",
                    "boxSize": "20",
                    "freightMfeId": "vjAAAeUoXPiNS5E3",
                    "couponList": []
                },
                {
                    "hisPrice": 2614,
                    "sizeType": "40HQ",
                    "price": 4404,
                    "boxType": "HQ",
                    "boxTypeId": "vjAAAACEFJIIo/xj",
                    "boxSize": "40",
                    "freightMfeId": "vjAAAeUoXPmNS5E3",
                    "couponList": [
                        {
                            "activityName": "上海优惠券",
                            "couponPrice": 220,
                            "surplusNum": 300,
                            "goodsNames": null
                        }
                    ]
                },
                {
                    "hisPrice": 4612,
                    "sizeType": "40RH",
                    "price": 6280,
                    "boxType": "RH",
                    "boxTypeId": "vjAAAACEFJQIo/xj",
                    "boxSize": "40",
                    "freightMfeId": "vjAAAeUnYCmNS5E3",
                    "couponList": []
                },
                {
                    "hisPrice": 3307,
                    "sizeType": "20TK",
                    "price": 3817,
                    "boxType": "TK",
                    "boxTypeId": "vjAAAACEFJYIo/xj",
                    "boxSize": "20",
                    "freightMfeId": "vjAAAeUoXPqNS5E3",
                    "couponList": []
                }
            ]
        }
    ],
    "responseOk": true
}

Request

Header Params

token

string

token令牌

必需

示例值:

salt

string

13位毫秒值时间戳

必需

sign

string

必需

数字签名，对salt + appSecret拼接字符串后使用国密SM3算法加密，生成16进制sign

Body Params application/json

startPortName

string

起始港名称

必需

endPortName

string

目的港名称

必需

emptyFull

string

空重

必需

F 重箱；E 空箱；默认F；

isQueryEndPortFee

string

应付类型

可选

0 客户应付；1 全程应付；默认 0；

sedProvinceName

string

发货省份名称

可选

sedCityName

string

发货城市名称

可选

sedRegionName

string

发货区县名称

可选

sedStreetName

string

发货街道名称

可选

sedStreetRangeName

string

发货区域范围名称

可选

recProvinceName

string

收货省份名称

可选

recCityName

string

收货城市名称

可选

recRegionName

string

收货区县名称

可选

recStreetName

string

收货街道名称

可选

recStreetRangeName

string

收货区域范围名称

可选

Examples

Responses

🟢200成功

application/json

Body

state

string

状态

必需

成功 ok；失败 fail；

code

integer

状态值

必需

成功 20000；其余为失败；

msg

string

消息文字

必需

errorMsg

string

报错信息

必需

responseOk

boolean

状态

必需

成功 true；失败 false；

result

array [object {26}]

必需

seaRailwayPath

string

海铁路径

必需

订单保存、提交、计费时使用

startPortName

string

起始港名称

必需

endPortName

string

目的港名称

必需

startDate

string

运价生效时间

必需

yyyy-MM-dd HH:mm:ss

endDate

string

运价失效时间

必需

yyyy-MM-dd HH:mm:ss

priceType

string

运价类型

必需

1COMMON 正常；2SPECIAL 特价；3GROUP 团购；

frequency

string

每月计划开航次数(次)

必需

emptyFull

string

空箱or重箱

必需

E：空箱；F：重箱

currencyCode

string

币别编码

必需

isTransportPrice

string

是否联运包干价

必需

0 否；1 是；

shipSchedulesId

string

船期ID

必需

订单保存、提交、计费时使用

shipSchedulesName

string

船期名称

必需

shipEnglishName

string

船名（英文）

必需

shipChineseName

string

船名（中文）

必需

flowPath

string

航线路径

必需

订单保存、提交、计费时使用

boxPath

string

箱路径

必需

eta

string

当前港口预计抵港时间

必需

yyyy-MM-dd HH:mm:ss

etd

string

当前港口预计开航时间

必需

yyyy-MM-dd HH:mm:ss

endPortEta

string

目的港口预计抵港时间

必需

yyyy-MM-dd HH:mm:ss

stock20

integer

20尺标箱剩余量

必需

stock40

integer

40尺标箱剩余量

必需

voyage

string

航次

必需

mainFlowPath

string

干线路径

必需

flowPathDetail

array [object {9}]

船程信息

必需

totalVoyageTime

string

总耗时

必需

freightDetails

array [object {8}]

各箱型尺寸运价

必需

Modified at 2025-06-09 07:48:56

“运价、船期查询”接口开发提示

获取“我的优惠券”信息