消费记录信息批量查询

说明

  • url: /common/invoice/findExpenseByPage
  • method: POST
  • 数据格式: JSON
  • 数据量: 分页查询，每次一百条
  • 查询结束条件: 查询结果数据量不满一百条时，认为是最后一页
  • 当没有任何精确字段填写时
    • 查询条件中的创建时间的范围会被限制在3天 (max_creation_date - min_creation_date <= 3 * 24 * 60 * 60 * 1000)，超过三天报错
    • 若没有创建时间的相关参数，则默认取最近3天
  • 范围值(金额，发票日期，创建时间)需要成对传参，要么都传要么都不传，单独传一个报错

请求参数

参数名 类型 必填 说明
biz_id String Y 本次业务唯一标识
page_num Integer Y 页码
purchase_invoice String Y 票据池 (Y: 采购发票池，N: 消费记录池)
public_order String N TMC 订单查询 (Y:查询TMC订单)
min_amount BigDecimal N 最小金额
max_amount BigDecimal N 最大金额
min_receipt_date Long N 最小发票日期 (时间戳)
max_receipt_date Long N 最大发票日期 (时间戳)
min_creation_date Long N 最小创建时间 (时间戳)
max_creation_date Long N 最大创建时间 (时间戳)
created_by String N 持有人code (精确)
submit_user String N 创建人code (精确)
charge_user String N 分摊人code (精确)
status Integer N 状态(0: 未报销，1: 外部系统锁定，2: 已使用)

响应参数

参数名 类型 说明
resCode Integer
resMsg String
bizId String
data JSON
data.page_num Integer 当前页码
data.page_info Array 数据集合

page_info集合对象参数说明

参数名 类型 说明
expense_id Integer 消费记录ID
company_id Integer 公司ID
purchase_invoice String 票据池 (Y: 采购发票池，N: 消费记录池)
public_order String TMC 订单 (Y：该条记录为TMC订单消费记录)
invoice_num String 发票号码
invoice_code String 发票代码
invoice_true String 发票状态 (具体含义见 票据状态说明)
created_by String 持有人code
submit_user String 创建人code
charge_user String 分摊人code
receipt_amount BigDecimal 金额
tax_amount BigDecimal 税额
total_count Integer 消费记录下的票据数量
creation_date Long 创建时间（时间戳）
last_update_date Long 最后修改时间（时间戳）
status Byte 状态

请求示例

请求参数

{
  "biz_id": "deea2bf1-ddb9-47da-9f33-387cff8f125a",
  "page_num": 1,
  "purchase_invoice": "N",
  "min_amount": 200.00,
  "max_amount": 300.00,
  "created_by": "support-1368579927556096@cloudpense.com",
  "submit_user": "support-1368579927556096@cloudpense.com",
  "status": 0
}

响应参数

{
  "resCode": 200000,
  "resMsg": "查询成功",
  "bizId": "deea2bf1-ddb9-47da-9f33-387cff8f125a",
  "data": {
    "page_num": 1,
    "page_info": [
      {
        "expense_id": 41984514,
        "company_id": 3809,
        "purchase_invoice": "N",
        "public_order": "Y",
        "invoice_num": "34553939",
        "invoice_code": "111002171071",
        "invoice_true": "I",
        "created_by": "support-1368579927556096@cloudpense.com",
        "submit_user": "support-1368579927556096@cloudpense.com",
        "receipt_amount": 236.00,
        "tax_amount": 10.00,
        "creation_date": 1666022400000,
        "last_update_date": 1666022400000,
        "total_count": 1,
        "status": 0
      },
      {
        "expense_id": 41984983,
        "company_id": 3809,
        "purchase_invoice": "N",
        "invoice_true": "Y",
        "created_by": "support-1368579927556096@cloudpense.com",
        "submit_user": "support-1368579927556096@cloudpense.com",
        "receipt_amount": 297.00,
        "tax_amount": 20.00,
        "creation_date": 1667028300000,
        "last_update_date": 1667028300000,
        "total_count": 3,
        "status": 0
      }
    ]
  }
}

results matching ""

    No results matching ""