API接口平台
  1. 订舱
API接口平台
  • API登录
    • V2
      • 登录
  • 订舱API
    • V2
      • 基础数据
        • “基础数据”接口开发提示
        • 基础资料Excel下载
        • 获取箱类型信息列表
        • 获取包装类型信息列表
        • 获取运输条款信息列表
        • 获取港口信息
        • 获取货物信息列表
        • 获取省份列表
        • 获取城市信息
        • 获取区县信息
        • 获取街道信息
        • 获取区域范围
        • 网点信息查询
      • 货物跟踪
        • 货物跟踪
        • 获取运单船程配载信息
      • 运价/船期
        • “运价、船期查询”接口开发提示
        • 运价、船期查询
      • 优惠券
        • 获取“我的优惠券”信息
        • 优惠券使用记录
        • 优惠券可用订舱流向查询
      • 积分
        • 积分支出(抵扣)记录
        • 积分收入(订舱积分赠送)查询
        • 获取积分片区等级和用户积分
      • 航次箱体保险
        • 获取航次箱体保险配置信息
      • 订舱
        • "订舱"接口开发提示
        • 订舱保存
          POST
        • 订舱提交
          POST
        • 费用计算
          POST
        • 计算保险费
          POST
        • 获取订舱可用优惠券
          POST
        • 积分抵扣校验
          POST
        • 获取出口办单授权车队
          POST
        • 获取目的港指定车队
          POST
        • 获取订舱预计获赠积分
          POST
        • 可压年判断
          POST
        • 删除订单
          POST
        • 订单列表查询
          POST
        • 是否可选择周转配送等级
          POST
      • 拆单
        • 运单拆单提交
        • 拆单列表查询(分页)
      • 改单
        • "改单"接口开发提示
        • 改单列表查询(分页)
        • 运单改单 - 是否可以改单的校验
        • 运单改单 - 获取改单详情
        • 改单原因列表
        • 是否可以修改目的港指定车队的校验
        • 海铁路径列表
        • 删除改单附件
        • 改单提交
      • 运单
        • 水路运单 - 返回文件流
        • 订舱委托书 - 返回文件流
        • 运单信息列表查询(分页)
        • 运单导入箱号
        • 装箱图片上传
      • 项目合同
        • 项目合同列表 - 分页
      • 月结账单
        • 月结账单列表查询
        • 月结账单明细查询
      • 网上对账
        • 网上对账列表查询
        • 网上对账明细查询
      • 结算核销
        • 收款单列表查询
        • 结算明细列表查询
        • 结算明细核销
        • 月结账单核销
      • 提箱申请
        • 可提箱列表查询
        • 提箱申请提交
        • 提箱申请结果列表查询
      • 出口网上办单
        • 出口办单列表查询
        • 出口办单验证
        • 出口办单授权车队查询
        • 出口办单数据提交
        • 出口办单退单申请记录列表查询
        • 取消出口办单
        • 退单保函模板下载
        • 办单退单原因查询
        • 退单申请校验
        • 退单申请提交
  1. 订舱

费用计算

Developing
测试环境
https://tapi.antong56.com:8443/antong-api/api-platform
测试环境
https://tapi.antong56.com:8443/antong-api/api-platform
POST
https://tapi.antong56.com:8443/antong-api/api-platform
/api/booking/v2/calculateFee
1.保存订单接口,生成订单与相关费用项目,可重复调用。
2.如果修改则需要传入订单号:bookingNo,订单号在第一次保存后会生成并返回。
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://tapi.antong56.com:8443/antong-api/api-platform/api/booking/v2/calculateFee' \
--header 'token: undefined' \
--header 'salt;' \
--header 'sign;' \
--form 'bookingNo=""' \
--form 'startPortName="上海"' \
--form 'endPortName="广澳"' \
--form 'shipSchedulesId="vjAAAcCAHYCCq9xE"' \
--form 'forwardingClause="CY/CY"' \
--form 'endTruckSup=""' \
--form 'startTruckType=""' \
--form 'endTruckType=""' \
--form 'seaRailwayPath=""' \
--form 'goodsName="云母"' \
--form 'goodsNames=""' \
--form 'isUploadAttachment="0"' \
--form 'attachment=@""' \
--form 'packingType="吨袋"' \
--form 'signInBox="1"' \
--form 'roughWeight="26000"' \
--form 'cellPhoneNumber="13395039213"' \
--form 'description=""' \
--form 'declaredValue="4"' \
--form 'buyBoxInsurance="0"' \
--form 'boxPremiumConfigNo=""' \
--form 'isCouponDeduct="0"' \
--form 'couponNo=""' \
--form 'isPointsDeduct="0"' \
--form 'pressureYears="0"' \
--form 'boxType="GP"' \
--form 'emptyFull="F"' \
--form 'isSoc="0"' \
--form 'boxSize="20"' \
--form 'count="3"' \
--form 'sedCompany="泉州安通物流有限公司"' \
--form 'sedLinkman="yyy"' \
--form 'sedMobile="13395039213"' \
--form 'sedProvinceName=""' \
--form 'sedCityName=""' \
--form 'sedRegionName=""' \
--form 'sedStreetName=""' \
--form 'sedStreetRangeName=""' \
--form 'sedDetailAddress=""' \
--form 'recCompany="五冶集团上海有限公司"' \
--form 'recLinkman="yyy"' \
--form 'recMobile="13395039213"' \
--form 'recProvinceName=""' \
--form 'recCityName=""' \
--form 'recRegionName=""' \
--form 'recStreetName=""' \
--form 'recStreetRangeName=""' \
--form 'recDetailAddress=""' \
--form 'isColdStorage=""' \
--form 'isPlugin=""' \
--form 'preCool=""' \
--form 'ptiOk=""' \
--form 'temperatureType=""' \
--form 'temperatureHigh=""' \
--form 'temperatureUnit=""' \
--form 'ventilation=""' \
--form 'pluginType=""' \
--form 'dockPluginType=""' \
--form 'guarantee=@""' \
--form 'isDangerous=""' \
--form 'imdg=""' \
--form 'dangerType=""' \
--form 'unNumber=""' \
--form 'dangerRemark=""' \
--form 'dangerExplain=@""' \
--form 'dangerDeclare=@""' \
--form 'isLikeDangerous=""' \
--form 'likeDangerousFile=@""' \
--form 'bookingExpOrderEntries="[{\"boxNum\": \"1\",\"supplierName\": \"测试车队\"},{\"boxNum\": \"2\",\"supplierName\": \"测试车队2\"}]"' \
--form 'contractNo=""' \
--form 'paymentType=""' \
--form 'deliveryTurnLevel=""'
Response Response Example
成功示例
{
    "state": "ok",
    "code": 20000,
    "msg": null,
    "errorMsg": null,
    "result": {
        "allFreight": 3909,
        "oceanFreight": 2601,
        "otherFreight": 1308,
        "currencyCode": "RMB",
        "currency": "人民币",
        "obtainPoints": 128,
        "mateContract": "0"
    },
    "responseOk": true
}

Request

Header Params
token
string 
token令牌
必需
示例值:
{{token}}
salt
string 
13位毫秒值时间戳
必需
sign
string 
必需
数字签名,对salt + appSecret拼接字符串后使用国密SM3算法加密,生成16进制sign
Body Params multipart/form-data
bookingNo
string 
可选
订单号保存后生成,非必填,但保存与提交时如果有订单号需要传入,否则默认生成新订单。
startPortName
string 
必需
起始港名称,运价、船期查询(/api/freight/v2/listApiPrices)返回的startPortName
示例值:
上海
endPortName
string 
必需
目的港名称,运价、船期查询(/api/freight/v2/listApiPrices)返回的endPortName
示例值:
广澳
shipSchedulesId
string 
必需
船期ID,运价、船期查询(/api/freight/v2/listApiPrices)返回的shipSchedulesId,如果接口返回的shipSchedulesId字段为空,则该字段可放空
示例值:
vjAAAcCAHYCCq9xE
forwardingClause
string 
运输条款名称
必需
示例值:
CY/CY
endTruckSup
string 
可选
目的港指定车队名称,目的港运输条款为DOOR可指定目的港车队,获取目的港置指定车队(/api/booking/v2/getDestinationFleet)返回的supplierName字段
startTruckType
string 
可选
起始港运输类型,条款为DOOR/*必填。0 普通;1 双拖;2 短板车;3 自卸车;4 平板车;5 平板+场装;6 场拆+平板;
endTruckType
string 
可选
目的港运输类型,条款为*/DOOR必填。0 普通;1 双拖;2 短板车;3 自卸车;4 平板车;5 平板+场装;6 场拆+平板;
seaRailwayPath
string 
必需
海铁联运路径,运价、船期查询(/api/freight/v2/listApiPrices)返回的返回的seaRailwayPath,如果接口返回的seaRailwayPath字段为空,则该字段可放空
goodsName
string 
必需
货物名称,为拼箱时,拼箱货物名称(goodsNames)必填
示例值:
云母
goodsNames
array[string]
拼箱货物名称
可选
示例值:
[""]
isUploadAttachment
string 
必需
是否上传附件(传0、1);0:否;1:是;根据货物信息列表接口(/api/baseData/v2/getGoodsList)的isUploadAttachment字段判断,为是(1)时,该字段为1并且附件字段(attachment)必填
示例值:
0
attachment
file 
可选
附件,支持多附件上传
packingType
string 
包装类型名称
必需
示例值:
吨袋
signInBox
string 
可选
是否箱内签收单(传0、1),0 否;1 是;默认0
示例值:
1
roughWeight
number 
毛重
必需
示例值:
26000
cellPhoneNumber
string 
理赔电话
必需
示例值:
13395039213
description
string 
订单备注
可选
declaredValue
number 
可选
保险声明价值,传空值默认传值对应货名的最低保险申明价值
示例值:
4
buyBoxInsurance
string 
可选
是否购买航次箱体保险(传0、1),0:否,1:是;默认0
示例值:
0
boxPremiumConfigNo
string 
可选
箱体保险配置编号;是否购买航次箱体保险为是时,该字段必填;获取航次箱体保险配置信息接口(/api/booking/v2/listBoxPremiumInfo)返回的boxPremiumNo字段
isCouponDeduct
string 
可选
优惠劵抵扣(传0、1),0:否,1:是;默认0;为1时,优惠券编号(couponNo)必填
示例值:
0
couponNo
string 
优惠劵编号
可选
isPointsDeduct
string 
可选
积分抵扣(传0、1),0:否,1:是;默认0
示例值:
0
pressureYears
string 
可选
是否压年(传0、1),0:否,1:是;默认0
示例值:
0
boxType
string 
箱类型名称
必需
示例值:
GP
emptyFull
string 
必需
空重(传E、F),空箱 E;重箱 F;
示例值:
F
isSoc
string 
可选
是否SOC箱(传0、1),0:否,1:是;默认0
示例值:
0
boxSize
string 
箱尺寸
必需
示例值:
20
count
number 
订舱箱个数
必需
示例值:
3
sedCompany
string 
发货人公司名称
必需
示例值:
泉州安通物流有限公司
sedLinkman
string 
必需
发货人名称,请填写真实姓名,勿使用'先生','小姐'之类的称呼。地址不可出现单引号。
示例值:
yyy
sedMobile
string 
发货人手机号码
必需
示例值:
13395039213
sedProvinceName
string 
可选
发货省份名称,运输条款为DOOR/*(门到)的,该字段必填
sedCityName
string 
可选
发货城市名称,运输条款为DOOR/*(门到)的,该字段必填
sedRegionName
string 
可选
发货区县名称,运输条款为DOOR/*(门到)的,该字段必填
sedStreetName
string 
可选
发货街道名称,运输条款为DOOR/*(门到)的,该字段必填
sedStreetRangeName
string 
发货区域范围名称
可选
sedDetailAddress
string 
发货详细地址
可选
recCompany
string 
必需
收货人公司名称;运输条款为*/CY(到港)的,公司必须在安通系统有备案;运输条款*/DOOR(到门)的,如收货人为个人,公司须与收货人名称一致
示例值:
五冶集团上海有限公司
recLinkman
string 
必需
收货人名称,请填写真实姓名,勿使用'先生','小姐'之类的称呼。地址不可出现单引号。
示例值:
yyy
recMobile
string 
收货人手机号码
必需
示例值:
13395039213
recProvinceName
string 
可选
收货省份名称,运输条款为*/DOOR(到门)的,该字段必填
recCityName
string 
可选
收货城市名称,运输条款为*/DOOR(到门)的,该字段必填
recRegionName
string 
可选
收货区县名称,运输条款为*/DOOR(到门)的,该字段必填
recStreetName
string 
可选
收货街道名称,运输条款为*/DOOR(到门)的,该字段必填
recStreetRangeName
string 
收货区域范围名称
可选
recDetailAddress
string 
收货详细地址
可选
isColdStorage
string 
可选
是否冷藏品订舱(冷藏品箱型为RH)(传0、1),0 否;1 是;默认0;
isPlugin
string 
可选
拖车是否插电(传0、1),0 否;1 是;
preCool
string 
可选
是否预冷(传0、1),0 否;1 是;
ptiOk
string 
可选
PIT_OK(传0、1),0 否;1 是;
temperatureType
string 
可选
冷藏温度类型,冷藏品必填(传1、2):1 零上;2 零下;
temperatureHigh
string 
可选
冷藏品温度值,冷藏品必填
temperatureUnit
string 
可选
冷藏品温度单位,冷藏品必填(传1fahrenheit、2Centigrade ):2Centigrade 摄氏度;1fahrenheit 华氏度;
ventilation
string 
可选
冷藏品通风度,冷藏品必填
pluginType
string 
可选
冷藏品拖车插电类型,冷藏品必填(传1、2、3):1 全程插电;2 起运港插电;3 目的港插电;
dockPluginType
string 
可选
冷藏品码头插电类型,冷藏品必填(传1、2、3):1 码头全程插电;2 起运港码头不插电;3 目的港码头不插电;
guarantee
file 
可选
冷藏品特别说明,单附件上传,冷藏品必填
isDangerous
string 
可选
是否危险品,0 否;1 是;根据货物信息列表接口(/api/baseData/v2/getGoodsList)的isDangerous字段判断,为是(1)时,该字段为1;
imdg
string 
可选
危险品IMDG,危险品必填
dangerType
string 
可选
危险品类别,危险品必填
unNumber
string 
可选
联合国编号,危险品必填
dangerRemark
string 
危险品必特别说明
可选
dangerExplain
file 
可选
危险品说明书,单附件上传,危险品必填
dangerDeclare
file 
可选
危险品货物申报单,单附件上传,危险品必填
isLikeDangerous
string 
可选
是否疑似危险品,0 否;1 是;根据货物信息列表接口(/api/baseData/v2/getGoodsList)的isLikeDangerous字段判断,为是(1)时,该字段为1并且疑是危险品文件字段(likeDangerousFile)必填;
likeDangerousFile
file 
可选
疑是危险品文件上传;多附件上传,货物为疑似危险品时必填
bookingExpOrderEntries
string 
可选

出口港起指定车队箱量以及出口港起指定车队名称-获取出口办单授权车队接口(/api/booking/v2/getExitFleetList)返回的supplierName字段;List,格式为:[{"boxNum": "1", "supplierName": "测试车队"}]

示例值:
[{"boxNum": "1","supplierName": "测试车队"},{"boxNum": "2","supplierName": "测试车队2"}]
contractNo
string 
可选
合同分录编号(合同订舱时可使用)
paymentType
string 
可选
付款方式:1:预付,2:到付;默认预付;
deliveryTurnLevel
string 
可选
周转配送等级:普通、优先(调用是否可选择周转配送等级接口/api/booking/v2/canSelectDeliveryTurnLevelOrNot,返回的result为true,则可以选择,否则为空)

Responses

🟢200成功
application/json
Body
state
string 
状态
必需
成功 ok;失败 fail;
code
integer 
状态值
必需
成功 20000;其余为失败;
msg
string 
消息文字
必需
errorMsg
string 
报错信息
必需
responseOk
boolean 
状态
必需
成功 true;失败 false;
result
object 
必需
allFreight
number 
总费用小计(不包含优惠券金额)
必需
oceanFreight
number 
海运费小计
必需
otherFreight
number 
其它费用小计
必需
currencyCode
string 
币别编码
必需
currency
string 
币别
必需
obtainPoints
number 
预计获赠积分
必需
mateContract
string 
是否匹配到合同
必需
0 否;1 是;
deductPoints
number 
积分抵扣总额
必需
couponAmount
number 
优惠券抵扣总额
必需
Modified at 2025-06-09 07:51:58
Previous
订舱提交
Next
计算保险费
Built with