文档中心 > API类目 > 天猫精灵供应链网关API

aliyun.gsc.funds.flow.notify (官网订单资金流水同步猫链系统)

官网订单资金流水同步猫链系统,当官网有资金流水产生时,订单流水会通知到猫链系统

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
official_funds_record_request OfficialFundsRecordRequest 必须 官网资金流水通知请求对象
  • payments
  • MainOrderFinanceDTO []
  • 必须
  • [{"main_biz_order_id":"mainorderid1"}]
  • 已付款订单信息
  • └ main_biz_order_id
  • String
  • 必须
  • mainorderid1
  • 主订单id
  • └ create_date
  • Date
  • 必须
  • 2022-09-23 09:00:00
  • 订单创建时间
  • └ biz_date
  • Date
  • 必须
  • 2022-09-23 10:00:00
  • 业务日期
  • └ seller_id
  • String
  • 必须
  • gmall
  • 卖家标记
  • └ sale_type
  • String
  • 必须
  • sell/proxy
  • 销售类型:sell-经销,proxy-代销
  • sub_orders
  • SubOrderFinanceDTO []
  • 必须
  • [{"sub_biz_order_id":"mainordernid2-1"}]
  • 子订单财务对象
  • └ sub_biz_order_id
  • String
  • 必须
  • 子订单号
  • 子订单号
  • └ auction_id
  • String
  • 必须
  • 商品ID
  • 前端商品ID
  • └ auction_title
  • String
  • 必须
  • 商品名称
  • 前端商品名称
  • └ out_item_id
  • String
  • 必须
  • item id
  • 外部item id
  • └ out_item_name
  • String
  • 可选
  • item名称
  • 外部item名称
  • └ out_sku_id
  • String
  • 可选
  • sku id
  • 外部sku id
  • └ out_sku_name
  • String
  • 可选
  • sku名称
  • 外部sku名称
  • └ price
  • Number
  • 必须
  • 50
  • 商品单价
  • └ freight
  • Number
  • 必须
  • 80
  • 运费
  • └ amount
  • Number
  • 必须
  • 100
  • 付款总数量,现金-付款金额,积分-积分数量
  • └ amount_type
  • String
  • 必须
  • member_point
  • 付款类型:member_point-积分,currency-现金
  • └ pay_type
  • String
  • 必须
  • weixin
  • 支付类型,alipay-支付宝,weixin-微信
  • └ currency_type
  • String
  • 必须
  • yuan
  • 货币类型,人民币:yuan
  • └ qty
  • Number
  • 必须
  • 10
  • 购买数量
  • └ point_grant
  • Number
  • 必须
  • 11
  • 授予积分,出现在积分流水中,即amount_type=member_point时候
  • └ return_amount
  • Number
  • 可选
  • 12
  • 逆向,返还积分数量/金额
  • └ return_amount_type
  • String
  • 可选
  • currency
  • 逆向,member_point:积分 currency:现金
  • └ return_currency_type
  • String
  • 可选
  • fen
  • 逆向,现金时的币种,目前为分 "fen"
  • └ uid
  • String
  • 必须
  • p_mainorderid1
  • 唯一键
  • └ return_point_grant
  • Number
  • 必须
  • 13
  • 逆向流程时,用户退还商家的赠予积分
  • confirms
  • MainOrderFinanceDTO []
  • 可选
  • [{"main_biz_order_id":"mainorderid2"}]
  • 已确认订单信息
  • └ main_biz_order_id
  • String
  • 可选
  • mainorderid2
  • 主订单id
  • └ create_date
  • Date
  • 可选
  • 2022-09-23 09:00:00
  • 订单创建时间
  • └ biz_date
  • Date
  • 可选
  • 2022-09-23 10:00:00
  • 业务日期
  • └ seller_id
  • String
  • 可选
  • gmall
  • 卖家标记
  • └ sale_type
  • String
  • 可选
  • sell/proxy
  • 销售类型:sell-经销,proxy-代销
  • sub_orders
  • SubOrderFinanceDTO []
  • 可选
  • [{"sub_biz_order_id":"mainordernid2-1"}]
  • 子订单财务对象
  • └ sub_biz_order_id
  • String
  • 可选
  • 子订单号
  • 子订单号
  • └ auction_id
  • String
  • 可选
  • 商品ID
  • 商品ID
  • └ auction_title
  • String
  • 可选
  • 商品名称
  • 商品名称
  • └ out_item_id
  • String
  • 可选
  • item id
  • item id
  • └ out_item_name
  • String
  • 可选
  • item名称
  • item名称
  • └ out_sku_id
  • String
  • 可选
  • sku id
  • sku id
  • └ out_sku_name
  • String
  • 可选
  • sku名称
  • 外部sku名称
  • └ price
  • Number
  • 可选
  • 100
  • 商品单价
  • └ freight
  • Number
  • 可选
  • 80
  • 运费
  • └ point_grant
  • Number
  • 可选
  • 11
  • 授予积分,出现在积分流水中,即amount_type=member_point时候
  • └ qty
  • Number
  • 可选
  • 10
  • 购买数量
  • refunds
  • MainOrderFinanceDTO []
  • 可选
  • [{"main_biz_order_id":"mainorderid3"}]
  • 已退款订单信息
  • └ main_biz_order_id
  • String
  • 可选
  • mainorderid3
  • 主订单id
  • └ create_date
  • Date
  • 可选
  • 2022-09-23 09:00:00
  • 订单创建时间
  • └ biz_date
  • Date
  • 可选
  • 2022-09-23 10:00:00
  • 业务日期
  • └ seller_id
  • String
  • 可选
  • gmall
  • 卖家标记
  • └ sale_type
  • String
  • 可选
  • sell/proxy
  • 销售类型:sell-经销,proxy-代销
  • sub_orders
  • SubOrderFinanceDTO []
  • 可选
  • [{"sub_biz_order_id":"mainordernid3-1"}]
  • 子订单财务对象
  • └ sub_biz_order_id
  • String
  • 可选
  • 子订单号
  • 子订单号
  • └ auction_id
  • String
  • 可选
  • 前端商品ID
  • 前端商品ID
  • └ auction_title
  • String
  • 可选
  • 前端商品名称
  • 前端商品名称
  • └ out_item_id
  • String
  • 可选
  • 外部item id
  • 外部item id
  • └ out_item_name
  • String
  • 可选
  • 外部item名称
  • 外部item名称
  • └ out_sku_id
  • String
  • 可选
  • 外部sku id
  • 外部sku id
  • └ out_sku_name
  • String
  • 可选
  • sku名称
  • sku名称
  • └ return_amount
  • Number
  • 可选
  • 120
  • 返还金额/积分
  • └ return_amount_type
  • String
  • 可选
  • member_point
  • 积分类型,member_point-积分
  • └ qty
  • Number
  • 可选
  • 11
  • 购买数量
  • └ return_currency_type
  • String
  • 可选
  • fen
  • 币种:分
  • └ uid
  • String
  • 可选
  • p_mainorderid1
  • 唯一键
  • └ return_point_grant
  • Number
  • 可选
  • 13
  • 逆向流程时,用户退还商家的赠予积分

响应参数

名称 类型 示例值 描述
result DataResult 返回结果对象
  • └ code
  • String
  • 00000000
  • 状态码
  • └ message
  • String
  • 成功
  • 响应描述

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AliyunGscFundsFlowNotifyRequest req = new AliyunGscFundsFlowNotifyRequest();
AliyunGscFundsFlowNotifyRequest.OfficialFundsRecordRequest obj1 = new AliyunGscFundsFlowNotifyRequest.OfficialFundsRecordRequest();
List<AliyunGscFundsFlowNotifyRequest.MainOrderFinanceDTO> list3 = new ArrayList<AliyunGscFundsFlowNotifyRequest.MainOrderFinanceDTO>();
AliyunGscFundsFlowNotifyRequest.MainOrderFinanceDTO obj4 = new AliyunGscFundsFlowNotifyRequest.MainOrderFinanceDTO();
list3.add(obj4);
obj4.setMainBizOrderId("mainorderid1");
obj4.setCreateDate(StringUtils.parseDateTime("2022-09-23 09:00:00"));
obj4.setBizDate(StringUtils.parseDateTime("2022-09-23 10:00:00"));
obj4.setSellerId("gmall");
obj4.setSaleType("sell/proxy");
List<AliyunGscFundsFlowNotifyRequest.SubOrderFinanceDTO> list7 = new ArrayList<AliyunGscFundsFlowNotifyRequest.SubOrderFinanceDTO>();
AliyunGscFundsFlowNotifyRequest.SubOrderFinanceDTO obj8 = new AliyunGscFundsFlowNotifyRequest.SubOrderFinanceDTO();
list7.add(obj8);
obj8.setSubBizOrderId("子订单号");
obj8.setAuctionId("商品ID");
obj8.setAuctionTitle("商品名称");
obj8.setOutItemId("item id");
obj8.setOutItemName("item名称");
obj8.setOutSkuId("sku id");
obj8.setOutSkuName("sku名称");
obj8.setPrice(50L);
obj8.setFreight(80L);
obj8.setAmount(100L);
obj8.setAmountType("member_point");
obj8.setPayType("weixin");
obj8.setCurrencyType("yuan");
obj8.setQty(10L);
obj8.setPointGrant(11L);
obj8.setReturnAmount(12L);
obj8.setReturnAmountType("currency");
obj8.setReturnCurrencyType("fen");
obj8.setUid("p_mainorderid1");
obj8.setReturnPointGrant(13L);
list5.setSubOrders(list7);
obj1.setPayments(list3);
List<AliyunGscFundsFlowNotifyRequest.MainOrderFinanceDTO> list10 = new ArrayList<AliyunGscFundsFlowNotifyRequest.MainOrderFinanceDTO>();
AliyunGscFundsFlowNotifyRequest.MainOrderFinanceDTO obj11 = new AliyunGscFundsFlowNotifyRequest.MainOrderFinanceDTO();
list10.add(obj11);
obj11.setMainBizOrderId("mainorderid2");
obj11.setCreateDate(StringUtils.parseDateTime("2022-09-23 09:00:00"));
obj11.setBizDate(StringUtils.parseDateTime("2022-09-23 10:00:00"));
obj11.setSellerId("gmall");
obj11.setSaleType("sell/proxy");
List<AliyunGscFundsFlowNotifyRequest.SubOrderFinanceDTO> list14 = new ArrayList<AliyunGscFundsFlowNotifyRequest.SubOrderFinanceDTO>();
AliyunGscFundsFlowNotifyRequest.SubOrderFinanceDTO obj15 = new AliyunGscFundsFlowNotifyRequest.SubOrderFinanceDTO();
list14.add(obj15);
obj15.setSubBizOrderId("子订单号");
obj15.setAuctionId("商品ID");
obj15.setAuctionTitle("商品名称");
obj15.setOutItemId("item id");
obj15.setOutItemName("item名称");
obj15.setOutSkuId("sku id");
obj15.setOutSkuName("sku名称");
obj15.setPrice(100L);
obj15.setFreight(80L);
obj15.setPointGrant(11L);
obj15.setQty(10L);
list12.setSubOrders(list14);
obj1.setConfirms(list10);
List<AliyunGscFundsFlowNotifyRequest.MainOrderFinanceDTO> list17 = new ArrayList<AliyunGscFundsFlowNotifyRequest.MainOrderFinanceDTO>();
AliyunGscFundsFlowNotifyRequest.MainOrderFinanceDTO obj18 = new AliyunGscFundsFlowNotifyRequest.MainOrderFinanceDTO();
list17.add(obj18);
obj18.setMainBizOrderId("mainorderid3");
obj18.setCreateDate(StringUtils.parseDateTime("2022-09-23 09:00:00"));
obj18.setBizDate(StringUtils.parseDateTime("2022-09-23 10:00:00"));
obj18.setSellerId("gmall");
obj18.setSaleType("sell/proxy");
List<AliyunGscFundsFlowNotifyRequest.SubOrderFinanceDTO> list21 = new ArrayList<AliyunGscFundsFlowNotifyRequest.SubOrderFinanceDTO>();
AliyunGscFundsFlowNotifyRequest.SubOrderFinanceDTO obj22 = new AliyunGscFundsFlowNotifyRequest.SubOrderFinanceDTO();
list21.add(obj22);
obj22.setSubBizOrderId("子订单号");
obj22.setAuctionId("前端商品ID");
obj22.setAuctionTitle("前端商品名称");
obj22.setOutItemId("外部item id");
obj22.setOutItemName("外部item名称");
obj22.setOutSkuId("外部sku id");
obj22.setOutSkuName("sku名称");
obj22.setReturnAmount(120L);
obj22.setReturnAmountType("member_point");
obj22.setQty(11L);
obj22.setReturnCurrencyType("fen");
obj22.setUid("p_mainorderid1");
obj22.setReturnPointGrant(13L);
list19.setSubOrders(list21);
obj1.setRefunds(list17);
req.setOfficialFundsRecordRequest(obj1);
AliyunGscFundsFlowNotifyResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<aliyun_gsc_funds_flow_notify_response>
    <result>
        <code>00000000</code>
        <message>成功</message>
    </result>
</aliyun_gsc_funds_flow_notify_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

返回
顶部