获取账单明细

请求 #

接口概述 #

通过账单编号获取账单明细信息。平台每月20号统计生成之前符合入账条件的订单，供应商可以通过账单 消息通知获取账单信息，也可以通过账单编号获取账单明细信息。供应商通过账单与平台结算开票等。

符合入账单的订单条件
当月20号(xxxx年xx月20日 23:59:59)之前的订单，且订单状态为已收货且无售后状态下的订单，才会被统计到账单中。
账单细节
当期统计生成的账单在统计生成之后且供应商已经确认此账单，若账单内有订单发生售后，售后单状态为已处理(已完成) 且有退款，平台会在下期生成的账单中体现出来售后退款的订单明细。

账单确认状态(is_confirmed)说明: #

状态 类型 说明
1 int 已确认
-1 int 待确认
-2 int 有异议

请求URL # 

GET {{host}}/bill/detail/{{billNo}}

请求头(header) #

参数名 类型 是否必填 说明
Authorization string 是 token

请求参数(url path) #

参数名 类型 是否必填 说明
billNo string 是 账单编号

请求示例 # 

GET {{host}}/bill/detail/2024061300001

响应 #

响应参数 #

参数名 类型 路径 说明
code int 错误码
msg string 错误信息
data object 结果集
id int data 账单ID
bill_no string data 账单编号
bill_name string data 账单名称(A 与 B XX年XX月XX日 对账单)
start_at string data 账单开始时间
end_at string data 账单结束时间
freight float data 运费
trade_amount float data 交易金额(包含运费)
refound_amount float data 退款金额
bill_amount float data 账单金额(交易金额减去退款金额)
is_confirmed int data 供应商是否已确认,-1:待确认,1已确认,-2有异议
is_paid bool data 平台是否已支付，true已支付，false未支付
is_settled bool data 平台是否已结算，true已结算，false未结算
remark string data 备注
created_at string data 创建时间
updated_at string data 更新时间
org_name string data 供应商名称
invoiced_amount float data 账单已开票金额(蓝票金额-红票金额)
items array data 账单明细
id int data.items 账单明细ID
bill_id int data.items 账单ID
trade_no string data.items 订单编号
total_price float data.items 订单金额(包含运费)
refound_amount float data.items 退款金额
freight float data.items 运费
finish_at string data.items 订单完成时间
abstract string data.items 订单摘要
trade_refund_nos array data.items 订单对应的退款单号(没有退款则为空)

响应示例 # 

{
  "code": 10000,
  "msg": "success",
  "data": {
    "id": 1,
    "bill_no": "2024061217033",
    "bill_name": "中车智程福利商城与xxxx有限公司 2024年06月12日 对账单",
    "start_at": "2024-05-12 17:03:15",
    "end_at": "2024-06-12 17:03:15",
    "freight": 6,
    "trade_amount": 202,
    "refound_amount": 0,
    "bill_amount": 202,
    "is_confirmed": true,
    "is_paid": false,
    "is_settled": false,
    "remark": "",
    "created_at": "2024-06-12 17:03:15",
    "updated_at": "2024-06-13 13:11:33",
    "org_name": "xxx供应商",
    "items": [
      {
        "id": 3,
        "bill_id": 1,
        "trade_no": "2240528020660001",
        "total_price": 119,
        "refound_amount": 0,
        "freight": 4,
        "finish_at": "2024-06-12 16:28:47",
        "abstract": "共2件商品",
        "trade_refund_nos": null
      },
      {
        "id": 2,
        "bill_id": 1,
        "trade_no": "2240517475100001",
        "total_price": 83,
        "refound_amount": 0,
        "freight": 2,
        "finish_at": "2024-06-12 16:28:47",
        "abstract": "共2件商品",
        "trade_refund_nos": [
          "123",
          "321"
        ]
      }
    ],
    "invoiced_amount": 85
  }
}