文档中心 > API类目 > 鸟潮物流API

alibaba.niaochao.logistics.refund.order.create (鸟潮逆向物流订单创建)

创建一个逆向的物流订单

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
create_refund_logistics_order_request CreateRefundLogisticsOrderRequest 必须 逆向入参数
  • └ declared_price
  • Number
  • 可选
  • 3000
  • 声明价值,单位为分
  • └ is_test
  • String
  • 必须
  • 1
  • 测试标,1代表测试,0代表非测试
  • └ order_time
  • Date
  • 必须
  • 2021-05-25 19:34:46
  • 下单时间,毫秒时间戳
  • └ product_id
  • String
  • 必须
  • 001
  • 服务订购环节约定的服务产品id
  • └ related_source_order_id
  • String
  • 必须
  • 121212
  • 关联正向商家订单
  • └ remark
  • String
  • 可选
  • 备注111
  • 备注
  • sender_info
  • ContactInfo
  • 必须
  • 取货人信息
  • └ address
  • String
  • 必须
  • 浙江省杭州市余杭区五常街道xxx
  • 地址
  • └ lng_lat
  • String
  • 必须
  • 113.29063,23.089657
  • 经纬度
  • └ name
  • String
  • 必须
  • 张三
  • 名称
  • └ phone
  • String
  • 必须
  • 18817265536
  • 手机号码
  • └ source_order_id
  • String
  • 必须
  • 27058520883725867
  • 商家订单ID
  • sub_order_requests
  • CreateLogisticsSubOrderRequest []
  • 必须
  • 子单
  • └ bar_code
  • String
  • 可选
  • 62111xxxxxxxx
  • 商品条码
  • └ discount_fee
  • Number
  • 可选
  • 200
  • 优惠金额,单位分
  • └ expect_sale_quantity
  • BigDecimal
  • 必须
  • 10
  • 取货销售数量
  • └ expect_stock_quantity
  • BigDecimal
  • 必须
  • 10
  • 取货库存数量
  • └ item_title
  • String
  • 必须
  • 测试商品
  • 商品标题
  • └ origin_fee
  • Number
  • 可选
  • 3000
  • 原始金额,单位分
  • └ pay_fee
  • Number
  • 可选
  • 2800
  • 实际支付金额,单位分
  • └ price
  • Number
  • 可选
  • 280
  • 单价,单位分
  • └ sale_unit
  • String
  • 必须
  • 商品销售单位
  • └ sku_code
  • String
  • 可选
  • DF988876876555
  • skuCode
  • └ sku_size
  • String
  • 可选
  • {"lenght":0.00,"width":0.00,"height":0.00}
  • 商品尺寸
  • └ stock_unit
  • String
  • 必须
  • 商品库存单位
  • └ sub_source_order_id
  • String
  • 必须
  • 124444333332
  • 商家子订单ID
  • └ total_weight
  • BigDecimal
  • 可选
  • 1000
  • 总重量,单位g
  • └ volume
  • BigDecimal
  • 可选
  • 100
  • 体积,单位cm立方
  • └ weight
  • BigDecimal
  • 可选
  • 1000
  • 重量,单位g
  • └ user_expect_time
  • String
  • 必须
  • 2021-04-19 21:35:35~2021-04-19 22:40:34
  • 用户选择取货时间,用"~"间隔
  • └ warehouse_code
  • String
  • 必须
  • code
  • 商家仓id

响应参数

名称 类型 示例值 描述
result Result 返回结果
  • └ code
  • String
  • SYSTEM_ERROR
  • 错误码
  • data
  • CreateRefundLogisticsOrderResponse
  • {}
  • 返回数据
  • └ expect_time
  • String
  • 2021-04-19 21:35:35~2021-04-19 22:40:34
  • 鸟潮系统重算之后的预计送达时间
  • └ logistics_order_id
  • String
  • 189339085721050643
  • 逆向物流订单ID
  • └ message
  • String
  • 系统异常
  • 错误信息描述
  • └ success
  • Boolean
  • false
  • 请求是否成功

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaNiaochaoLogisticsRefundOrderCreateRequest req = new AlibabaNiaochaoLogisticsRefundOrderCreateRequest();
AlibabaNiaochaoLogisticsRefundOrderCreateRequest.CreateRefundLogisticsOrderRequest obj1 = new AlibabaNiaochaoLogisticsRefundOrderCreateRequest.CreateRefundLogisticsOrderRequest();
obj1.setDeclaredPrice(3000L);
obj1.setIsTest("1");
obj1.setOrderTime(StringUtils.parseDateTime("2021-05-25 19:34:46"));
obj1.setProductId("001");
obj1.setRelatedSourceOrderId("121212");
obj1.setRemark("备注111");
AlibabaNiaochaoLogisticsRefundOrderCreateRequest.ContactInfo obj2 = new AlibabaNiaochaoLogisticsRefundOrderCreateRequest.ContactInfo();
obj2.setAddress("浙江省杭州市余杭区五常街道xxx");
obj2.setLngLat("113.29063,23.089657");
obj2.setName("张三");
obj2.setPhone("18817265536");
obj1.setSenderInfo(obj2);
obj1.setSourceOrderId("27058520883725867");
List<AlibabaNiaochaoLogisticsRefundOrderCreateRequest.CreateLogisticsSubOrderRequest> list4 = new ArrayList<AlibabaNiaochaoLogisticsRefundOrderCreateRequest.CreateLogisticsSubOrderRequest>();
AlibabaNiaochaoLogisticsRefundOrderCreateRequest.CreateLogisticsSubOrderRequest obj5 = new AlibabaNiaochaoLogisticsRefundOrderCreateRequest.CreateLogisticsSubOrderRequest();
list4.add(obj5);
obj5.setBarCode("62111xxxxxxxx");
obj5.setDiscountFee(200L);
obj5.setExpectSaleQuantity("10");
obj5.setExpectStockQuantity("10");
obj5.setItemTitle("测试商品");
obj5.setOriginFee(3000L);
obj5.setPayFee(2800L);
obj5.setPrice(280L);
obj5.setSaleUnit("包");
obj5.setSkuCode("DF988876876555");
obj5.setSkuSize("{\"lenght\":0.00,\"width\":0.00,\"height\":0.00}");
obj5.setStockUnit("件");
obj5.setSubSourceOrderId("124444333332");
obj5.setTotalWeight("1000");
obj5.setVolume("100");
obj5.setWeight("1000");
obj1.setSubOrderRequests(list4);
obj1.setUserExpectTime("2021-04-19 21:35:35~2021-04-19 22:40:34");
obj1.setWarehouseCode("code");
req.setCreateRefundLogisticsOrderRequest(obj1);
AlibabaNiaochaoLogisticsRefundOrderCreateResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alibaba_niaochao_logistics_refund_order_create_response>
    <result>
        <code>SYSTEM_ERROR</code>
        <data>
            <expect_time>2021-04-19 21:35:35~2021-04-19 22:40:34</expect_time>
            <logistics_order_id>189339085721050643</logistics_order_id>
        </data>
        <message>系统异常</message>
        <success>false</success>
    </result>
</alibaba_niaochao_logistics_refund_order_create_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

返回
顶部