4.3 查询对账单

接口URL

{开放平台域名地址}/openApi/open/order/settlement/item/list

HTTP请求方式

POST

公共参数

字段	类型	是否必填	中文意描述
access_token	String	是	授权访问凭证
timestamp	String	是	毫秒级时间戳 防止重复攻击
sign	String	是	签名
version	String	否	业务接口版本号，如1.0.0

body参数

字段	类型	是否必填	中文意描述
paymentStartTime	String	是	支付起始时间，格式为yyyy-MM-dd HH:mm:ss
paymentEndTime	String	是	支付终止时间，格式为yyyy-MM-dd HH:mm:ss
orderStartTime	String	否	下单起始时间，格式为yyyy-MM-dd HH:mm:ss
orderEndTime	String	否	下单终止时间，格式为yyyy-MM-dd HH:mm:ss
bizOrderNum	String	否	业务单号
orderNum	String	否	订单号
currentPage	Integer	否	页码，默认1
itemsPerPage	Integer	否	页数，默认100，最大500

请求示例

POST /openApi/open/order/settlement/item/list?access_token=abc&timestamp=1597300776947&sign=fa66cb4d8604413b8fb30afd32e3e73e HTTP/1.1
Content-Type: application/json
Cache-Control: no-cache
{
     "paymentStartTime": "2022-9-1 00:00:00",
     "paymentEndTime": "2022-12-15 23:59:59",
     "currentPage": 1,
     "itemsPerPage": 100
   }

返回参数说明

字段	类型	中文意描述
code	String	返回码
data	ResponseData	相应报文
msg	String	如果错误，返回错误信息

ResponseData：

字段	类型	中文意描述
orderNum	String	订单号
bizOrderNum	String	业务单号
skuName	String	商品名称
channelName	Integer	频道名称
skuCategoryName	String	实体分类
orderUserMobile	String	手机号
orderUserName	String	下单用户名称
paymentType	String	支付方式
cardId	String	卡号/账号
paymentAmount	BigDecimal	本次消费（福豆/次）
settlementAmount	BigDecimal	结算金额
contractId	String	合同编号
contract	String	所属合同
unionOrganization	String	部门
orderTime	String	下单时间
paymentTime	String	支付时间
totalAmount	String	订单总金额，含税
settlementType	Short	结算单类型: 1-付款单、2-退款单

返回示例

success:

{
  "code": "0",
  "data": [
    {
      "orderNum": "31667365951449629248009653",
      "bizOrderNum": "21221102131100027835",
      "skuName": "【全频道】【多规格】",
      "totalQuantity": -1,
      "channelName": "优选生活",
      "skuCategoryName": "南非橙",
      "orderUserMobile": "17521568541",
      "orderUserName": "union_fosun_zsn111",
      "paymentType": "企业积分",
      "cardId": "et16673658980808529027287_121577_2211021300001295",
      "paymentAmount": -2.00,
      "settlementAmount": -2.00,
      "contractId": "286239",
      "contract": null,
      "unionOrganization": "上海松亭复地房地产开发有限公司/财务管理部",
      "orderTime": "2022-11-02 13:11:31",
      "paymentTime": "2022-11-02 13:12:32",
      "totalAmount": -2.00,
      "settlementType": 2
    },
    {
      "orderNum": "21667365827518629248078960",
      "bizOrderNum": "21221102131000004984",
      "skuName": "hyb商城活动-001",
      "totalQuantity": 1,
      "channelName": "优选生活",
      "skuCategoryName": "南非橙",
      "orderUserMobile": "17521568541",
      "orderUserName": "union_fosun_zsn111",
      "paymentType": "企业积分",
      "cardId": "et16673658335129223844294_121577_2211021300001295",
      "paymentAmount": 0.01,
      "settlementAmount": 0.01,
      "contractId": "286239",
      "contract": null,
      "unionOrganization": "上海松亭复地房地产开发有限公司/财务管理部",
      "orderTime": "2022-11-02 13:10:27",
      "paymentTime": "2022-11-02 13:10:34",
      "totalAmount": 0.01,
      "settlementType": 1
    }
  ],
  "msg": "success",
  "errMsg": null
}

fail:

{
  "code": "10016",
  "data": null,
  "msg": "签名错误"
}