文档中心 > API类目 > 新零售供应链API

alibaba.ascp.industry.supplier.logistics.price (大件取退-核价回传)

大件取退-核价回传

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
reverse_fulfil_price_request ReverseFulfilPriceRequest 必须 请求对象
  • └ mail_no
  • String
  • 必须
  • SF1000001
  • 逆向运单号
  • └ order_id
  • String
  • 必须
  • 20250401321134
  • 订单号,用于幂等
  • └ operate_time
  • String
  • 必须
  • 1659080423659
  • 操作时间戳
  • └ meterage_type
  • Number
  • 可选
  • 1
  • 核价时必填,默认为重量计费。计费类型 (0:重量计费、1:体积计费)
  • └ goods_weight
  • Number
  • 可选
  • 5000
  • 计费重量,核价时必填 包裹重量(最终计费重量),单位(克) (注意,是最终计费重量,不是包裹实际重量,是计抛重量和实际重量两者取大)
  • └ real_weight
  • Number
  • 可选
  • 4980
  • 包裹实际重量,核价时选填,非计费重量,只用于记录,不会参与计费,单位 (克)
  • └ length
  • Number
  • 可选
  • 100
  • 长,单位 cm
  • └ width
  • Number
  • 可选
  • 50
  • 宽,单位 cm
  • └ height
  • Number
  • 可选
  • 30
  • 高,单位 cm
  • fee_info_list
  • ReverseFulfilFeeInfoDTO []
  • 可选
  • {}
  • 费用列表
  • └ code
  • String
  • 可选
  • dismantle_fee
  • 费用类型 *dismantle_fee 拆装费,单位:元,两位小数 *insurance_fee 保价费,单位:元,两位小数 *package_fee 包装费,单位:元,两位小数 *go_upstairs_fee 搬楼费,单位:元,两位小数 *overlength_weight_fee 超长超重费,单位:元,两位小数 *wood_package_fee 打木架费,单位:元,两位小数 *collect_overarea_fee 揽收超区费,单位:元,两位小数 *delivery_overarea_fee 派送超区费,单位:元,两位小数
  • └ value
  • BigDecimal
  • 可选
  • 10000
  • 费用金额,单位分
  • └ desc
  • String
  • 可选
  • 保价费
  • 费用项描述
  • └ feature
  • String
  • 可选
  • {"serviceType": 0}
  • 扩展属性

响应参数

名称 类型 示例值 描述
result BaseResult 请求响应
  • └ result
  • Boolean
  • ture
  • 返回结果对象
  • └ msg
  • String
  • "调用成功"
  • 通常用于success的信息提示
  • └ success
  • Boolean
  • true
  • 请求是否成功
  • └ error_code
  • String
  • ERROR_001
  • 通常用于success为false时的页面错误码
  • └ biz_exception
  • Boolean
  • false
  • 是否为业务异常
  • └ error_msg
  • String
  • 系统错误
  • 通常用于success为false时的页面错误信息

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaAscpIndustrySupplierLogisticsPriceRequest req = new AlibabaAscpIndustrySupplierLogisticsPriceRequest();
AlibabaAscpIndustrySupplierLogisticsPriceRequest.ReverseFulfilPriceRequest obj1 = new AlibabaAscpIndustrySupplierLogisticsPriceRequest.ReverseFulfilPriceRequest();
obj1.setMailNo("SF1000001");
obj1.setOrderId("20250401321134");
obj1.setOperateTime("1659080423659");
obj1.setMeterageType(1L);
obj1.setGoodsWeight(5000L);
obj1.setRealWeight(4980L);
obj1.setLength(100L);
obj1.setWidth(50L);
obj1.setHeight(30L);
List<AlibabaAscpIndustrySupplierLogisticsPriceRequest.ReverseFulfilFeeInfoDTO> list3 = new ArrayList<AlibabaAscpIndustrySupplierLogisticsPriceRequest.ReverseFulfilFeeInfoDTO>();
AlibabaAscpIndustrySupplierLogisticsPriceRequest.ReverseFulfilFeeInfoDTO obj4 = new AlibabaAscpIndustrySupplierLogisticsPriceRequest.ReverseFulfilFeeInfoDTO();
list3.add(obj4);
obj4.setCode("dismantle_fee");
obj4.setValue("10000");
obj4.setDesc("保价费");
obj1.setFeeInfoList(list3);
obj1.setFeature("{\"serviceType\": 0}");
req.setReverseFulfilPriceRequest(obj1);
AlibabaAscpIndustrySupplierLogisticsPriceResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alibaba_ascp_industry_supplier_logistics_price_response>
    <result>
        <result>ture</result>
        <msg>&quot;调用成功&quot;</msg>
        <success>true</success>
        <error_code>ERROR_001</error_code>
        <biz_exception>false</biz_exception>
        <error_msg>系统错误</error_msg>
    </result>
</alibaba_ascp_industry_supplier_logistics_price_response>

异常示例

  • XML示例
  • JSON示例
<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

错误码解释

错误码 错误描述 解决方案

API工具

如何获得此API

FAQ

返回
顶部