自动记账 自动记账
首页
用户指南
适配指南
下载
资源 (opens new window)
论坛 (opens new window)
赞助
GitHub (opens new window)
首页
用户指南
适配指南
下载
资源 (opens new window)
论坛 (opens new window)
赞助
GitHub (opens new window)
  • 原理

    • 工作原理
    • 适配准备
  • 接口

    • 自动记账状态
    • 同步账本给自动记账
    • 同步分类给自动记账
    • 同步资产给自动记账
      • 接口功能
      • 请求
      • 参数
        • body内容
        • 资产类型参考
        • uri参数
      • 响应
      • 请求示例
    • 同步待报销账单给自动记账
    • 从自动记账提取需要同步的账单
    • 设置自动记账账单状态
    • 自动记账设置
目录

同步资产给自动记账

# 接口功能

同步资产给自动记账。

注意

发起同步请求前,建议先获取设置(setting_hash_asset)判断数据是否发生变化,避免高频访问接口。 因为自动记账可能处理失败,所以需要以自动记账内部的哈希值为准。

提示

对于自动记账来讲,债务中的借款人、还款人也是资产。

# 请求

POST http://127.0.0.1:52045/assets/put

# 参数

# body内容

传递给自动记账的是一个Json数组。

[
  {
    "name":"资产名称",
    "icon": "资产图标(Uri或者Base64)",
    "currency": "资产币种", // 币种类型参考:https://api.qianjiapp.com/clientweb/currencylist
    "extras": "额外数据,属于保留字段",
    "type" : "资产类型", // 资产类型参考下面部分
    "sort" : 0, //排序
  }
]

# 资产类型参考

  • NORMAL : 普通资产,例如储蓄卡、借记卡、支付宝、微信、等具有固定余额的账户
  • VIRTUAL : 虚拟资产,例如积分、优惠券、话费、公交卡余额等需要预先付费(一般不可退回)的账户
  • FINANCIAL : 理财资产,例如股票、基金、余额宝、余利宝等,存在动态波动(增减)的资产
  • CREDIT : 信用资产,例如信用卡、蚂蚁花呗,属于小额借贷,有额度限制的账户
  • BORROWER : 欠款人,例如借款给别人的钱
  • CREDITOR : 债主,例如别人借钱给自己

# uri参数

名称 类型 简介
md5 string 上面body的md5值

# 响应

名称 类型 简介
code int 响应状态,正常为200
msg string
data string

# 请求示例

POST /category/put?md5=c339d6fe8ec0f01b63f27b829784e797 HTTP/1.1
Host: 127.0.0.1:52045
Content-Type: text/json; charset=UTF-8

[
  {
    "name":"分类名称",
    "icon": "分类图标",
    "remoteId" : "123",
    "remoteParentId" : "-1",
    "remoteBookId" : "123",
    "sort" : 0, 
  },
   {
    "name":"分类名称",
    "icon": "分类图标",
    "remoteId" : "1234",
    "remoteParentId" : "123",
    "remoteBookId" : "123",
    "sort" : 0, 
  },
]

注意

务必要设置Content-Type: text/json; charset=UTF-8

上次更新: 2025/01/02, 12:09:30
同步分类给自动记账
同步待报销账单给自动记账

← 同步分类给自动记账 同步待报销账单给自动记账→

Theme by Vdoing | Copyright © 2019-2025 Ankio | GPLv3 License
  • 跟随系统
  • 浅色模式
  • 深色模式
  • 阅读模式