账款管家审批支付API文档

更新日志

时间	版本	更新内容
20250919	V5.9.1	新增应付合同增加自定义字段
20250324	V5.3.2	支持App平台添加编辑人员；增加权限设置部分Api
20250317	V5.3.1	客户、应收合同增加编辑及删除功能，同时支持传入自定义字段
20250121	V5.1.1	付款队列数据查询
20241126	V4.11.1	审批支付创建付款单据到付款队列待付款
20240823	V4.8.1	应收/应付合同新增接口增加所属项目入参
20240709	V4.7.1	费用/报销/付款/发票等附件返回在线付款回单附件获取在线开票附件获取
20240418	V4.4.2	应付合同增加付款计划
20240407	V4.4.1	增加应收应付按年统计数量
20240318	V4.3.1	增加预收款功能相关Api：收款类型列表、新建收款类型、新建预收款、新建预收款核销、新建预收款退款
20230809	V3.8.1	增加Api：费用、报销新增；供应商收款账户、员工账户、部门列表、费用类型列表、项目列表；及人员列表优化等
20220902	V2.9.1	获取AccessToken 及入参说明
20220628	V2.6.2	列表增加自定义字段支持 (应收合同、应付合同、回款、付款、客户、供应商、费用、报销应收发票、应付发票产品、仓库、期初库存)
20220622	V2.6.1	还原列表返回格式
20220524	V2.5.3	迁移api(新增类)
20220524	V2.5.2	迁移部分api(人员、账户、行业、客户) 优化请求排序方式
20220519	V2.5.1	回款计划生成修复消息通知应收合同新增添加回款计划

文档下载

Url

[GET] : https://eapi.paiago.com/sign/docs

PayUrl

审批支付

[GET] : https://eapi.paiago.com/sign/payDocs

在线文档

ApiUrl

[GET] : https://eapi.paiago.com/sign/readApi

PayUrl

审批支付

[GET] : https://eapi.paiago.com/sign/readPayApi

Api文档

API指引

AccessToken获取

Request

Url

[POST] : https://eapi.paiago.com/ZKGJ/AccessToken/

所有请求需要添加服务器IP白名单联系账款管家

AccessToken有效期为2小时

返回类型

JSON

请求参数:

参数	类型	必填	描述	示例
corpId	string	是	企业corpId	(若需要测试账号，请联系账款管家客服)
corpKey	string	是	企业密钥
timeStamp	string	是	当前时间戳（秒）	1662085101
signature	string	是	签名

参数说明:

签名计算方法：
- $suiteKey //分配的key
- $timeStamp //时间戳
- $suiteSecret //密钥
- $timeStamp +"\n" + $suiteKey当做签名字符串，
- $suiteSecret做为签名密钥，使用HmacSHA256算法计算签名，然后进行Base64encode获取最后结果，然后把签名参数再进行urlEncode。

请求示例:

php获取签名（signature）

$str = $timeStamp . "\n" . $suiteKey; 
$signature = urlencode(base64_encode(hash_hmac('sha256', $str, $suiteSecret, true)));

java获取签名（signature）

String signature = URLEncoder.encode(signature(param), "UTF-8");
public static String signature(JSONObject param) {
    String timestamp = param.getString("timeStamp");
    String suiteKey = param.getString("suiteKey");
    String suiteSecret = param.getString("suiteSecret");
    String stringToSign = timestamp+"\n"+suiteKey;
    Mac mac = Mac.getInstance("HmacSHA256");
    mac.init(new SecretKeySpec(suiteSecret.getBytes("UTF-8"), "HmacSHA256"));
    byte[] signData = mac.doFinal(stringToSign.getBytes("UTF-8"));
    return new String(Base64.encodeBase64(signData));
}

Python获取签名（signature）

from urllib.parse import quote, urlencode
from hashlib import sha256
import hmac, base64
import time

def get_sha256(data, key):
    key = key.encode('utf-8')       # sha256加密的key
    message = data.encode('utf-8')  # 待sha256加密的内容
    sign = base64.b64encode(hmac.new(key, message, digestmod=sha256).digest()).decode()
    return sign
    
def urlencode(string):
    encoded_string = urllib.parse.quote(string, safe='!()*')
    encoded_string = encoded_string.replace(' ', '+')
    return encoded_string
    
if __name__ == '__main__':
  time = '1669108257'
  suiteKey = 'suiteTest'
  suiteSecret = 'suiteSecretTest'
  suiteData = time+'\n'+suiteKey
  sign = get_sha256(suiteData,suiteSecret)
  print(str(sign))
  #sign = quote(sign)
  #print(str(sign))
  #更新存在 转码问题
  newSign = urlencode(str(sign))
  print(newSign)

C#获取签名（signature）

using System;
using System.Text;
using System.Net;
using System.Security.Cryptography;
class Program
{
    public static void Main(string[] args)
    {
        DateTimeOffset now = DateTimeOffset.Now;
        long timeStamp = now.ToUnixTimeSeconds();
        string suiteKey = "suiteKey";
        string data = timeStamp+"\n"+suiteKey;
        string suiteSecret  = "suiteSecret";
        var keyBytes = Encoding.UTF8.GetBytes(suiteSecret);
        var messageBytes = Encoding.UTF8.GetBytes(data);
        using (var hmac = new HMACSHA256(keyBytes))
        {
            var hash = hmac.ComputeHash(messageBytes);
            var signature = WebUtility.UrlEncode(Convert.ToBase64String(hash));
            Console.WriteLine(signature);
        }
    }
}

Go获取签名（signature）

package main

import (
	"crypto/hmac"
	"crypto/sha256"
	"encoding/base64"
	"encoding/json"
	"fmt"
	"net/url"
)

type Params struct {
	TimeStamp   string `json:"timeStamp"`
	SuiteKey    string `json:"suiteKey"`
	SuiteSecret string `json:"suiteSecret"`
}

func Signature(param Params) (string, error) {
	stringToSign := param.TimeStamp + "\n" + param.SuiteKey
	h := hmac.New(sha256.New, []byte(param.SuiteSecret))
	h.Write([]byte(stringToSign))
	signData := h.Sum(nil)

	return base64.StdEncoding.EncodeToString(signData), nil
}

func main() {
	// 示例JSON字符串
	jsonStr := `{"timeStamp":"1719884033","suiteKey":"suiteKey","suiteSecret":"suiteSecret"}`

	// 解析JSON到结构体
	var param Params
	if err := json.Unmarshal([]byte(jsonStr), &param); err != nil {
		fmt.Println("Error parsing JSON:", err)
		return
	}

	// 计算签名
	signature, err := Signature(param)
	if err != nil {
		fmt.Println("Error signing:", err)
		return
	}

	// 输出签名
	// Y/sZ/1mDZ81Ycgi9e59uXRrvOTRvJuIg1kr2lgy5coA=
	fmt.Println("Signature:", signature)
	// 输出URL编码后的签名
	// Y%2FsZ%2F1mDZ81Ycgi9e59uXRrvOTRvJuIg1kr2lgy5coA%3D
	fmt.Println("Encrypt:", url.QueryEscape(signature))
}

Response

响应参数

参数	描述	类型	示例
errcode	错误码	int	0
errmsg	错误信息	string
data	返回值	string	ffc50044897a74c14b47a755d0a28dc4

响应示例:

Success

{
    "data": "eyJ0eXAiOiJKV1YiLCJhbGciOiJSUzI1NiJ9.eyJpc3MiOiJhcGlfY2VudGVyIiwiYXTkIjoiaHR0cDovL2xvY2FsaG9zdCIsImlhdCI6IjE2NjIwODc1NTYiLCJleHAiOjE2NjIwOTQ3NTYsImNvcnBJZCI6InBlbmtkMTlmZTkwN2UwZGMxNTBlNDcwNTQyN2FlZDE0ZWVkYyIsImNvcnBLZXkiOiJlYzFmODFkNWQwMjI3NGY0ZTFmZWVhUTUzYzNmNzJmMCJ9.cFWFEDRsIGxQFJepf0xU6Io7Xa3vQkrM0dBayOWlYk_qgfncIAbXZNrYUCIiZywIA5nh-kd8g42qk_Tc_6Fc-R1w5W_MfiycM6HSCftG-KTv3zvcRs9KYjfIzLW2fX9HoreNQv6XHlYkxcLz79WEPBX6jJ0jL1TBnfAMPMjbXFNiD4ff-FD3CkdBASwA1u1Ds4OSm8n6OTb5VzxtsGti7mbPNAQ-1DO6r2eIENAfiXmbBrtfnlYLadfgIt-BdS87pKqWqmYFZDP-6UJufyeHy5oU9govyt3GSdLRjGck6BrhH-r7y5_6urrfQhuPDqjuS6QgAAtk3XtFMYSDSFF1xA",
    "errcode": 0,
    "errmsg": "请求成功",
    "request_id": null,
    "env": "zkgj-cs"
}

Error

{
  "errcode": 11005,
  "errmsg": "签名无效",
  "request_id": null,
  "env": "zkgj-cs"
}

列表入参说明

Request

列表类型请求中，body参数说明

where中的条件字段需在Field中同时体现出来

请求参数:

参数	类型	必填	描述	示例
Field	array	是	请求字段	[]
Order	array	否	排序规则
Where	array	否	查询条件
ListRow	number	否	每页数量，默认20条，最大2000	20
Page	number	否	查询页码	1
ListType	number	否	特殊接口(消息)	1

请求示例:

{
    "Field":[
        "id",
        "name",
        "..."
    ],
    "Order":{
        "id":"desc"
    },
    "Where":[
        {
            "filed": "contract_date",
            "factor": ">=",
            "value": "2022-09-02"
        }
    ],
    "Page":1,
    "ListRow":10
}

where条件入参

[
    {
        "filed": "date",
        "factor": ">=",
        "value": "2022-09-02"
    },
    {
        "filed": "name",
        "factor": "like",
        "value": "凭证"
    },
    {
        "filed": "id",
        "factor": "BETWeen",
        "value": "WiiiJmSy0,fNiQxJiiiiJmSy077777777"
    },
    {
        "filed": "id",
        "factor": "IN",
        "value": "WiiiJmSy0,fNiQxJiiiiJmSy077777777"
    },
    {
        "filed":"id",
        "factor":"=",
        "value":"1"
    },
    {
        "filed":"id",
        "factor":"!=",
        "value":"1"
    }
]

新增入参说明

Request

新增类型请求中，body参数说明
部分接口有单次新增时的数量限制，请查看具体说明
部分敏感参数皆为密文如 id add_user等参数

请求示例:

[{
    "customer_name": "客户名称001",
    "customer_number": "001",
    "add_user": "WiiiJmSy0",
    "..." : "...."
},{
    "customer_name": "客户名称002",
    "customer_number": "002",
    "add_user": "WiiiJmSy0",
    "..." : "...."
},{
    "..." : "...."
}]

人员设置

人员列表

Request

Url

[POST] : https://eapi.paiago.com/ZKGJ/Corp/User/?access_token=ffc50044897a74c14b47a75

请求参数:

参数	类型	描述	示例
Field	array	请求字段	[]
> id	string	人员id
> realname	string	真实姓名
> ding_userid	string	钉钉平台的唯一id（其他平台可不传）
> department	string	部门信息
> isDelete	string	是否正常 0：正常 1删除
> isLeave	string	是否在职 0：在职 1离职
> mobile	string	手机号码（只支持官方渠道平台传入，其他平台请勿传入，会报错）
Order	array	排序规则
Where	array	查询条件
Page	number	页数	0
ListRow	number	条数	20

请求示例:

{
    "Field":[
        "id",
        "realname",
        "department"
    ],
    "Order":{
        "id":"desc",
        "realname": "asc"
    },
    "Where":[
        {
            "filed":"id",
            "factor":"=",
            "value":"lix0q7V0s"
        }
    ],
    "Page":1,
    "ListRow":20
}

Response

响应参数

参数	描述	类型
count	总数	int
data	列表（参数释义同请求`Field`释义）	array(object)
> id	人员id	string
> realname	名称	string
> ding_userid	钉钉平台的唯一id	string
> department	部门信息	array(object)
>> company_user_id	用户id	string
>> company_depart_id	部门id	string
>> ding_id	ding_id	string
>> depart_name	部门名称	string

响应示例:

{
    "data":[
        {
            "id":"liyq7sgg7",
            "realname":"无尘（**宝）",
            "department":[
                {
                    "company_user_id":"liyq7sgg7",
                    "company_depart_id":"liS0q7k0a",
                    "ding_id": "1",
                    "depart_name":"28"
                }
            ]
        }
    ],
    "count":1,
    "errcode":0,
    "errmsg":"请求成功",
    "request_id":null,
    "env":"zkgj-cs"
}

新增、编辑人员

Request

Url

[POST] : https://eapi.paiago.com/ZKGJ/Corp/User/Add/?access_token=ffc50044897a74c14b47a75

Rule

当前只支持App平台用户调用此接口
单次最多支持操作 100 条人员数据

请求参数:

参数	类型	必填	描述	示例
id	string	否	人员id（编辑人员时，请传入人员id）
name	string	是	姓名	十一
mobile	string	是	手机号编辑时此字段不生效，但是必传	18279135346
ding_ids	string	否	部门ding_id（查询部门列表获取）,多个部门以 , 隔开编辑时必传，创建时此字段不生效，可不用传	ding_id2,ding_id2
is_authorization	string	否	是否是可使用人员 0否 1是编辑时必传，创建时此字段不生效，可不用传	1

请求示例:

[
    {
        "id": "XxSmz00sV",
        "ding_ids": "4Wxzx2YIr2oDLG2,WiiiJmSy0",
        "is_authorization": "1",
        "name": "hgq3",
        "mobile": "18392981004"
    },
    {
        "id": "XJzxQ00sk",
        "ding_ids": "4Wxzx2YIr2oDLG2",
        "is_authorization": "1",
        "name": "hgq2",
        "mobile": "17770048295"
    }
]

Response

响应参数

参数	描述	类型	示例
errcode	错误码	int
errmsg	错误信息	string

{
    "errcode":21003,
    "errmsg":"第1条数据录入失败：系统已有该人员，请勿重复添加!",
    "request_id":null,
    "env":"zkgj-cs"
}

付款队列

付款队列列表查询

Request

Url

[POST] : https://eapi.paiago.com/ZKGJ/ApprovePayment/List?access_token=ffc50044897a74c14b47a75

请求参数:

参数	类型	描述	示例
Field	array	请求字段	[]
id	string	单据id
company_id	string	公司id
title	string	标题
apply_date	string	申请付款日期
apply_money	string	申请金额
status	number	状态:2待付款 5付款失败 7已付款 9付款中
payee	string	收款方名称
account_name	string	收款方户名
account_number	string	收款方账号
open_account_book	string	收款方开户银行
account_land	string	收款方开户支行
bank_branch_id	string	收款方联行号
apply_remark	string	备注
actual_payment_date	string	实际付款日期
actual_payment_money	string	实际付款金额
create_time	string	单据创建时间
order_code	string	单据编号
submit_info	string	付款记录信息（可用来查询回单）
Order	array	排序规则
Where	array	查询条件
Page	number	页数	0
ListRow	number	条数	20

请求示例:

{
    "Field": [
        "id",
        "company_list_id",
        "title",
        "order_code"
    ],
    "Where": [
        {
            "filed": "order_code",
            "factor": "like",
            "value": "api"
        }
    ],
    "ListRow": 20,
    "Page": 1
}

Response

响应参数

参数	描述	类型	示例
count	总数	int
data	列表(详见请求`Field`释义)	array(object)

响应示例:

{
    "data": [
        {
            "id": "FmQQ0qCjk",
            "company_list_id": "XJmyzgqaa",
            "title": "api测试付款005",
            "order_code": "apiPay2025-01-20-005",
            "status": 2,
            "submit_info": []
        }
    ],
    "errcode": 0,
    "errmsg": "请求成功",
    "request_id": null,
    "count": 1
}

公司费用

公司费用列表

Request

Url

[POST] : https://eapi.paiago.com/ZKGJ/getCompanyCostList?access_token=ffc50044897a74c14b47a75

请求参数:

参数	类型	描述	示例
Field	array	请求字段	[]
> id	string	费用id
> payment_method_id	string	付款方式id
> company_id	string	公司id
> pay_price	string	付款金额
> unpay_price	string	未付款金额
> type	string	类型: 0:直接新建; 1:申请费用
> payee	string	收款方
> title	string	标题
> payment_date	string	付款日期
> payment_method	string	结算方式
> cost_number	string	费用单号
> apply_username	string	收款人
> money	string	汇总金额
> depart	string	部门名称
> accounting_project	string	所属项目
> dedu_money	string	借款抵扣
> status	string	状态： 0：未处理； 1：已驳回； 2：已同意申请； 3：拒绝付款； 4：申请人撤销申请； 5：付款失败； 6：已付款撤销； 7：付款成功； 8：删除申请； 9：付款中；
> account_name	string	户名
> payment_money	string	支付金额-抵扣金额
> payment_way	string	支付路径： 0线下 1线上
> voucher	string	是否生成凭证 0未生成 1已生成 2待生成
> update_username	string	操作人
> add_time	string	添加/申请时间
> update_time	string	最后更新时间
> supplier_id	string	供应商id (若为空则表示添加费用时未选择相应供应商, 直接填写的收款方)
> supplier_account_id	string	供应商收款账号id (若为空则表示添加费用时未选择相应供应商, 直接填写的收款方)
> depart_id	string	所属部门id(dingid)
Order	array	排序规则
Where	array	查询条件
Page	number	页数	0
ListRow	number	条数	20

请求示例:

{
    "Field":[
        "id",
        "pay_price",
        "unpay_price",
        "type",
        "payee",
        "title",
        "payment_date",
        "payment_method",
        "cost_number",
        "apply_username",
        "money",
        "depart",
        "accounting_project",
        "dedu_money",
        "account_name",
        "payment_money",
        "payment_way",
        "voucher",
        "update_username",
        "add_time",
        "update_time"
    ],
    "Order":{
        "id":"desc",
        "dedu_money":"desc",
        "apply_username":"desc"
    },
    "Where":[

    ],
    "Page":1,
    "ListRow":20
}

Response

响应参数

参数	描述	类型
count	总数	int
list	列表（参数释义同请求`Field`释义）	array(object)

响应示例:

{
    "data":[
        {
            "id":"XNzimCjq0",
            "pay_price":"306.00",
            "unpay_price":"0.00",
            "type":1,
            "payee":"公共供应商",
            "title":"AACCSS",
            "payment_date":"2022-04-13",
            "payment_method":"生成凭证专用账户",
            "cost_number":"FY20220413152901",
            "apply_username":"庞凯",
            "money":"306.00",
            "depart":"510",
            "accounting_project":null,
            "dedu_money":"146.98",
            "account_name":"平安银行1",
            "payment_money":"159.02",
            "payment_way":0,
            "voucher":0,
            "update_username":"庞凯",
            "add_time":"1649834891",
            "update_time":1649834969,
            "payment_method_id":"XxxNzskgj",
            "company_id":"UNNNmzJ0k"
        }
    ],
    "count":311,
    "errcode":0,
    "errmsg":"请求成功",
    "request_id":"f9d6734b2616967d43a7dc18f0c23856",
    "env":"zkgj-dev"
}

公司费用新增

Request

Url

[POST] : https://eapi.paiago.com/ZKGJ/addPayout?access_token=ffc50044897a74c14b47a75

Rule

最多支持添加 100 条客户数据

请求参数:

参数	类型	必填	描述	示例
title	string	是	标题
receipt_number	string	否	单据编号
payment_date	string	是	付款日期
depart_id	string	是	部门id
payment_method_id	string	是	付款账户id
supplier_id	string	是	供应商id
supplier_account_id	string	是	供应商收款账户id	该条数据供应商下的收款账户
remark	string	否	备注
add_user	string	是	创建人id
project	array(object)	否	所属项目
project_id	string	是	项目id
cost_details	array(object)	否	明细
create_date	string	是	付款日期
money	string	是	金额
cost_id	string	是	费用类型id
cost_des	string	否	描述

请求示例:

[
    {
        "payment_method_id": "XmmJS0sjj",
        "supplier_id": "XxJmSg77k",
        "supplier_account_id": "XNzJNCqgC",
        "receipt_number": "001001001",
        "remark": "备注111",
        "title": "费用标题1",
        "depart_id": "lNi0q7k07",
        "payment_date": "2023-08-09",
        "project": [
            {
                "project_id": "lyQsk7qVj"
            },
            {
                "project_id": "lemCs7j0C"
            }
        ],
        "add_user": "lNzq7a0ak",
        "cost_details": [
            {
                "create_date": "2023-08-08",
                "money": "121",
                "cost_id": "XJSmi0ksj",
                "cost_des": "费用说明11"
            },
            {
                "create_date": "2023-08-08",
                "money": "123",
                "cost_id": "XxeJx0ksq",
                "cost_des": "费用说明22"
            }
        ]
    },
    {
        "payment_method_id": "XmmJS0sjj",
        "supplier_id": "XxJmSg77k",
        "supplier_account_id": "XSeNSCqg0",
        "receipt_number": "001001001",
        "remark": "备注111",
        "title": "费用标题2",
        "depart_id": "lNi0q7k07",
        "payment_date": "2023-08-09",
        "project": [
            {
                "project_id": "lyQsk7qVj"
            },
            {
                "project_id": "lemCs7j0C"
            }
        ],
        "add_user": "lNzq7a0ak",
        "cost_details": [
            {
                "create_date": "2023-08-08",
                "money": "121",
                "cost_id": "XJSmi0ksj",
                "cost_des": "费用说明12"
            },
            {
                "create_date": "2023-08-08",
                "money": "123",
                "cost_id": "XxeJx0ksq",
                "cost_des": "费用说明223"
            }
        ]
    }
]

Response

响应参数

参数	描述	类型	示例
errcode	错误码	int
errmsg	错误信息	string

响应示例:

{
    "data": [],
    "errcode": 0,
    "errmsg": "请求成功",
    "request_id": null
}

公司费用详情

Request

Url

[POST] : https://eapi.paiago.com/ZKGJ/getCompanyCostDetail?access_token=ffc50044897a74c14b47a75

请求参数:

参数	类型	描述	示例
id	string	费用id	XNzimCjq0

请求示例:

{
    "id":"XNzimCjq0"
}

Response

响应参数

参数	类型	描述	示例
data	array(object)	数据	[]
> id	string	报销id
> company_id	string	公司id
> title	string	标题
> payment_method_id_by	string	备用结算方式id
> sum_money	string	汇总金额
> dedu_money	string	抵扣金额
> apply_number	string	申请单号
> cost_number	string	费用单号
> payment_date	string	付款日期
> submit_info	array(object)	在线付款记录信息
>> dowload_url	string	付款回单
> payment_method_id	string	结算方式id
> receipt_number	string	单据编号
> open_account_book	string	开户行
> pay_price	string	已付金额
> unpay_price	string	未付金额
> bank_branch_id	string	联行号
> account_land	string	开户地
> account_name	string	户名
> account_number	string	账号
> project_ids	string	费用新建，申请所属项目id值
> supplier_id	string	供应商id (若为空则表示添加费用时未选择相应供应商, 直接填写的收款方)
> supplier_account_id	string	供应商收款账号id (若为空则表示添加费用时未选择相应供应商,直接填写的收款方)
> is_approval	string	是否启用审批流 (用于区分申请费用时是否选择审批人) 0:未选择审批人 1:选择审批人
> type	string	类型: 0:直接新建;1:申请费用
> status	string	状态： 0：未处理； 1：已驳回； 2：已同意申请； 3：拒绝付款； 4：申请人撤销申请； 5：付款失败； 6：已付款撤销； 7：付款成功； 8：删除申请； 9：付款中；
> depart_id	string	所属部门id(dingid)
> payment_userid	string	付款人id
> remark	string	备注(申请人备注信息)
> remark1	string	备注(付款人添加备注信息)
> apply_payment_date	string	申请付款日期
> add_user	string	申请/新建人id
> add_user_ding_avatar	string	申请/新建人钉钉头像
> voucher	string	是否生成凭证 0未生成 1已生成 2待生成
> add_time	string	申请/新建时间
> update_time	string	最后更新时间
> update_user	string	操作人id
> update_user_name	string	操作人姓名
> payment_way	string	支付路径： 0线下 1线上
> payee	string	收款方
> payment_method	string	户名
> values	string	开户账号
> payment_money	string	pay_price-dedu_money
> bank_name	string	开户银行
> depart_name	string	部门名称
> apply_username	string	申请人
> news_id	string	消息id
> payout_cost_list	array(object)	费用明细
>> id	string	费用详情id
>> company_id	string	公司id
>> date	string	发生日期
>> money	string	金额
>> cost_id	string	费用id
>> cost_des	string	费用说明
>> cost_name	string	费用标题
>> relation_id	string	关联费用id
>> type	string	类型: 1:费用 2：报销
>> add_time	string	添加时间
>> update_time	string	更新时间
>> delete_time	string	删除时间
>> share_type	number	分摊类型： 0：不分摊； 1：按部门分摊； 2：按项目分摊； 3：按部门&项目分摊；
>> start_id	string	区分是否是调整添加的数据，并且存储的id为最早调整前的那条数据id
>> is_end	string	是否是申请时的最后一条： 0：不是； 1：是
>> share_info	array(object)	分摊明细
>>> id	string	项目分摊id
>>> company_id	string	公司id
>>> money	string	分摊到的金额
>>> bill_money	string	分摊每笔发票的开票金额
>>> ratio	string	分摊比例
>>> depart_id	string	部门id
>>> project_id	string	项目id
>>> type	string	1：费用； 2：报销；
>>> relation_id		string
>>> add_time	string	添加时间
>>> update_time	string	最后更新时间
>>> delete_time	string	删除时间
>>> depart_name	string	部门名称
>>> project_name	string	项目名称
>> billing_info	array(object)	费用的发票详情
>>> id	string	发票id
>>> bill_type	number	发票类型： 1：增值税普通发票； 2：增值税专用发票； 3：其他； 4：增值税电子普通发票； 5：增值税电子专用发票； 6：电子发票(普通发票)； 7：电子发票(增值税专用发票)；
>>> supplier_id	string	供应商id
>>> billing_rise	string	发票抬头
>>> billing_encoded	string	发票代码
>>> is_ocr	number	是否是只能识别发票0不是 1是
>>> is_real	number	是否验真 0未验真 1是已验真
>>> billing_date	string	开票日期
>>> billing_number	string	发票号码
>>> billing_money	string	开票金额
>>> tax_rate	string	税率
>>> multiple_tax_rates	string	多税率
>>> tax	string	税额
>>> leb	number	0：新建合同发票； 1：申请合同发票； 2：费用新建发票； 3：费用申请发票； 4：报销申请发票； 5：新建其他发票； 6：申请其他发票；
>>> status	number	0未处理 1已驳回 2已同意申请(待处理) 3拒绝处理 4申请人撤销申请 7开票成功 8作废
>>> remark	string	发票的备注
>>> supplier_name	string	供应商名称
>>> before_bill_share	array(object)	最初发票分摊明细（参考`bill_share`释义）
>>> files	array(object)	附件信息
>>>> url	string	附件url
>>> bill_share	array(object)	项目开票分摊明细
>>>> id	string	项目开票分摊id
>>>> billing_id	string	应付发票id
>>>> bill_money	string	分摊每笔发票的开票金额
>>>> ratio	分摊比例	string
>>>> project_id	项目id	string
>>>> project_name	项目名称	string
>> files	array(object)	明细的附件信息
>>> url	string	附件地址，用url直接下载（部分平台可能没有附件信息，具体联系客服或者开发人员）
> borrow_list	array(object)	借款列表
>> id	string	还款信息详情id
>> borrow_id	string	借款信息id
>> money	string	还款金额
>> apply_borrow_number	string	申请借款单号
>> borrow_money	string	支付金额
>> refunded_money	string	已还金额
>> add_time	string	添加时间
>> depart_name	string	部门名称
>> loan_name	string	借款类型
>> delete_time	string	删除时间
>> project_ids	string	申请费用时所选择的项目信息
>> project_name	string	项目名称
> deduction_list	array(object)	抵扣列表
>> id	string	还款信息详情id
>> apply_borrow_number	string	申请借款单号
>> borrow_date	string	借款日期
>> borrow_money	string	支付金额
>> refunded_money	string	已还金额
>> dedu_money	string	还款金额
>> no_refund_money	string	borrow_money - refunded_money
>> type_name	string	借款类型
>> accounting_project	string	项目
> accounting_project	array	项目名称集合（数组型）
> accounting_project_names	string	项目名称集合（字符型）
> files	array(object)	附件信息
>> url	string	附件地址，用url直接下载（部分平台可能没有附件信息，具体联系客服或者开发人员）

响应示例:

{
    "data":{
        "id":"XNzimCjq0",
        "company_id":"UNNNmzJ0k",
        "payment_method_id_by":null,
        "title":"AACCSS",
        "sum_money":"306.00",
        "dedu_money":"146.98",
        "apply_number":"FYSQ20220413152801",
        "cost_number":"FY20220413152901",
        "payment_date":"2022-04-13",
        "payment_method_id":"XxxNzskgj",
        "receipt_number":"",
        "open_account_book":"平安银行",
        "pay_price":"306.00",
        "unpay_price":"0.00",
        "bank_branch_id":"NiyySyJQmms7qkqa770ajk",
        "account_land":"平安银行股份有限公司北京分行清算中心",
        "account_name":"平安银行1",
        "account_number":"6221551801010101",
        "project_ids":"",
        "supplier_id":"WiiiJmSy0",
        "supplier_account_id":665,
        "is_approval":0,
        "type":1,
        "status":7,
        "depart_id":27780798,
        "payment_userid":"WiiiJmSy0",
        "remark":"",
        "apply_payment_date":1649834891,
        "remark1":"",
        "add_user_ding_avatar":"https://static-legacy.dingtalk.com/media/lADPD2eDOoFCAuXNBFLNA3k_889_1106.jpg",
        "voucher":0,
        "add_time":1649834891,
        "add_user":"WiiiJmSy0",
        "update_time":1649834969,
        "update_user":"WiiiJmSy0",
        "payment_way":0,
        "update_user_name":"庞凯",
        "payee":"公共供应商",
        "payment_method":"生成凭证专用账户",
        "values":"001",
        "payment_money":"159.02",
        "bank_name":"中国银行",
        "depart_name":"510",
        "apply_username":"庞凯",
        "news_id":"FNzQaska0",
        "payout_cost_list":[
            {
                "id":"XxmzmkaVC",
                "company_id":"UNNNmzJ0k",
                "date":"2022-04-13",
                "money":"101.00",
                "cost_id":"XJJxy0sjC",
                "cost_des":"",
                "relation_id":"XNzimCjq0",
                "type":1,
                "add_time":1649834891,
                "update_time":null,
                "delete_time":null,
                "share_info":[
                    {
                        "id":"XNNeQ00qq",
                        "company_id":"UNNNmzJ0k",
                        "money":"33.67",
                        "bill_money":null,
                        "ratio":"33.33",
                        "depart_id":"vQSmzixeyzJJymQCjgVg0ss",
                        "project_id":null,
                        "type":1,
                        "relation_id":"XxmzmkaVC",
                        "add_time":1649834891,
                        "update_time":null,
                        "delete_time":null,
                        "depart_name":"505",
                        "project_name":null
                    }
                ],
                "share_type":1,
                "start_id":"We7",
                "is_end":1,
                "cost_name":"出差费",
                "billing_info":[
                    {
                        "id":"XQzNJ0qaj",
                        "bill_type":1,
                        "supplier_id":"WiiiJmSy0",
                        "billing_rise":"公共供应商",
                        "billing_encoded":"",
                        "is_ocr":0,
                        "is_real":0,
                        "billing_date":"2022-04-13",
                        "billing_number":"111111111111112",
                        "billing_money":"101.00",
                        "tax_rate":"12.00%",
                        "tax":"10.82",
                        "leb":3,
                        "status":7,
                        "supplier_name":"公共供应商",
                        "remark":"",
                        "files": [
                            {
                                "fileId": 0,
                                "fileName": "fapiao16.png",
                                "src": "/upload/ocr/2024/03/06194313-2361643-7843.png",
                                "fileSize": 360633,
                                "fileType": "png",
                                "relation_type": 11,
                                "spaceId": 0,
                                "add_time": "2024-03-06 19:44",
                                "url": "https://zy.paiago.com//upload/ocr/2024/03/06194313-2361643-7843.png"
                            }
                        ],
                        "before_bill_share":[

                        ],
                        "bill_share":[

                        ]
                    }
                ],
                "files": [
                    {
                        "fileId": 0,
                        "fileName": "compressed.tracemonkey-pldi-09.pdf",
                        "src": "cs/9844/803628/dda973d563fc12498b12184dd778f126.pdf",
                        "relation_id": 7792,
                        "fileSize": 1016315,
                        "fileType": "pdf",
                        "relation_type": 16,
                        "spaceId": 0,
                        "add_time": "2025-03-03 14:28",
                        "url": "https://penk-dingding.oss-cn-hangzhou.aliyuncs.com/cs/9844/803628/dda973d563fc12498b12184dd778f126.pdf?Expires=174096720&OSSAccessKeyId=LTAI5t7sMTrF9WRdrjpVYto&Signature=nvCLTcvJ1a2F38mhULOu7cInCdoY%3D"
                    }
                ]
            }
        ],
        "accounting_project":[

        ],
        "accounting_project_names":"",
        "deduction_list":[
            {
                "id":"XNJxSkjCj",
                "apply_borrow_number":"JK20211110104401",
                "borrow_date":"2021-11-10",
                "borrow_money":"11.00",
                "dedu_money":"1.01",
                "no_refund_money":"0.00",
                "type_name":"方法",
                "accounting_project":null
            }
        ],
        "borrow_list":[
            {
                "id":"XNJxSkjCj",
                "money":"1.01",
                "apply_borrow_number":"JK20211110104401",
                "borrow_money":"11.00",
                "refunded_money":"11.00",
                "add_time":"2021-11-10",
                "dapart_name":"512",
                "loan_name":"方法",
                "delete_time":null,
                "project_ids":"",
                "project_name":""
            }
        ],
        "files": [
            {
                "fileId": 0,
                "fileName": "compressed.tracemonkey-pldi-09.pdf",
                "src": "cs/9844/803628/dda973d563fc12498b12184dd778f126.pdf",
                "relation_id": 7792,
                "fileSize": 1016315,
                "fileType": "pdf",
                "relation_type": 16,
                "spaceId": 0,
                "add_time": "2025-03-03 14:28",
                "url": "https://penk-dingding.oss-cn-hangzhou.aliyuncs.com/cs/9844/803628/dda973d563fc12498b12184dd778f126.pdf?Expires=174096720&OSSAccessKeyId=LTAI5t7sMTrF9WRdrjpVYto&Signature=nvCLTcvJ1a2F38mhULOu7cInCdoY%3D"
            }
        ]
    },
    "errcode":0,
    "errmsg":"请求成功",
    "request_id":"775fec7eda99549e2174efdec476c0b2",
    "env":"zkgj-dev"
}

费用类型列表

Request

Url

[POST] : https://eapi.paiago.com/ZKGJ/CostType?access_token=ffc50044897a74c14b47a75

请求参数:

参数	类型	描述	示例
Field	array	请求字段	[]
> id	string	id
> cost_name	string	费用类型名称
> parents_id	string	父级id
> is_enable	number	是否启用
> remark	string	备注
> rank	number	等级
> sort	number	排序
Order	array	排序规则
Where	array	查询条件
Page	number	页数	0
ListRow	number	条数	20

请求示例:

{
    "Field":[
        "id",
        "cost_name",
        "parents_id",
        "is_enable",
        "remark",
        "rank",
        "sort",
    ],
    "Order":{
        "id":"desc"
    },
    "Where":[

    ],
    "Page":1,
    "ListRow":20
}

Response

响应参数

参数	描述	类型
count	总数	int
list	列表（参数释义同请求`Field`释义）	array(object)

响应示例:

{
    "data":[
        {
            "id": "XSxeJ0ka0",
            "cost_name": "材料费",
            "parents_id": 0,
            "is_enable": 1,
            "remark": null,
            "rank": 1,
            "sort": 0
        }
    ],
    "count":1,
    "errcode":0,
    "errmsg":"请求成功",
    "request_id":"f9d6734b2616967d43a7dc18f0c23856",
    "env":"zkgj-dev"
}

员工报销

员工报销列表

Request

Url

[POST] : https://eapi.paiago.com/ZKGJ/getReimbursementList?access_token=ffc50044897a74c14b47a75

请求参数:

参数	类型	描述	示例
Field	array	请求字段	[]
> pay_price	string	已付金额
> unpay_price	string	未付金额
> title	string	标题
> reimbursement_money	string	报销金额
> depart_name	string	部门明细
> reimbursement_number	string	报销单号
> arrival_date	string	付款日期
> payment_method	string	结算方式
> add_user_name	string	收款人姓名
> add_user_id	string	收款人id
> accounting_project	string	所属项目
> remark	string	申请备注
> bill_number	string	单据编号
> payment_money	string	支付金额-抵扣金额
> payment_way	string	支付路径： 0线下 1线上
> voucher	string	是否生成凭证 0未生成 1已生成 2待生成
> caozuoren	string	操作人
> add_time	string	新增/申请时间
> caozuo_date	string	操作时间
> dedu_money	string	抵扣金额
> id	string	报销id
> company_id	string	公司id
Order	array	排序规则
Where	array	查询条件
Page	number	页数	0
ListRow	number	条数	20

请求示例:

{
	"Field": [
		"pay_price",
		"unpay_price",
		"title",
		"reimbursement_money",
		"depart_name",
		"reimbursement_number",
		"arrival_date",
		"payment_method",
		"add_user_name",
		"add_user_id",
		"accounting_project",
		"remark",
		"bill_number",
		"payment_money",
		"payment_way",
		"voucher",
		"caozuoren",
		"add_time",
		"caozuo_date",
		"dedu_money",
		"id",
		"company_id"
	],
	"Order": [],
	"Where": [
		{
			"filed": "payment_method",
			"factor": "like",
			"value": "凭证"
		},
		{
			"filed": "id",
			"factor": "BETWeen",
			"value": "WiiiJmSy0,fNiQxJiiiiJmSy077777777"
		},
        {
            "filed": "id",
            "factor": "IN",
            "value": "WiiiJmSy0,fNiQxJiiiiJmSy077777777"
        }
	],
	"Page": 0,
	"ListRow": 2
}

Response

响应参数

参数	类型	描述	示例
count	int	总数	0
data	array(object)	列表（参数释义同请求`Field`释义）	[]

响应示例:

{
    "data":[
        {
            "pay_price":"203.00",
            "unpay_price":"0.00",
            "title":"AACCSS",
            "reimbursement_money":"203.00",
            "depart_name":"510",
            "reimbursement_number":"BX20220414171401",
            "arrival_date":"2022-04-14",
            "payment_method":"生成凭证专用账户",
            "add_user_name":"庞凯",
            "add_user_id":1,
            "accounting_project":"123124124(1232134)、测试单选(123三生三世)",
            "remark":"",
            "bill_number":"",
            "payment_money":"0.00",
            "payment_way":"线下付款",
            "voucher":"未生成",
            "caozuoren":"庞凯",
            "add_time":1649927614,
            "caozuo_date":"2022-04-14",
            "dedu_money":"203.00",
            "id":1804,
            "company_id":15
        }
    ],
    "count":1,
    "errcode":0,
    "errmsg":"请求成功",
    "request_id":"0feac9b1a4a0b66e679baf0fd8253fb3",
    "env":"zkgj-dev"
}

员工报销新增

Request

Url

[POST] : https://eapi.paiago.com/ZKGJ/addReimbursement?access_token=ffc50044897a74c14b47a75

Rule

最多支持添加 100 条客户数据

请求参数:

参数	类型	必填	描述	示例
title	string	是	标题
receipt_number	string	否	单据编号
payment_date	string	是	付款日期
depart_id	string	是	部门id
payment_method_id	string	是	付款账户id
rece_method_id	string	是	收款账户id	该条数据创建人下的收款账户
remark	string	否	备注
add_user	string	是	创建人id
project	array(object)	否	所属项目
project_id	string	是	项目id
cost_details	array(object)	否	明细
create_date	string	是	付款日期
money	string	是	金额
cost_id	string	是	费用类型id
cost_des	string	否	描述

请求示例:

[
    {
        "payment_method_id": "XmmJS0sjj",
        "rece_method_id": "PSxmeyVsk",
        "receipt_number": "001001001",
        "remark": "备注111",
        "title": "报销标题1",
        "depart_id": "lNi0q7k07",
        "payment_date": "2023-08-08",
        "project": [
            {
                "project_id": "lyQsk7qVj"
            },
            {
                "project_id": "lemCs7j0C"
            }
        ],
        "add_user": "lNzq7a0ak",
        "cost_details": [
            {
                "create_date": "2023-08-08",
                "money": "121",
                "cost_id": "XJSmi0ksj",
                "cost_des": "费用说明11"
            },
            {
                "create_date": "2023-08-08",
                "money": "123",
                "cost_id": "XxeJx0ksq",
                "cost_des": "费用说明22"
            }
        ]
    },
    {
        "payment_method_id": "XmmJS0sjj",
        "rece_method_id": "PSxmeyVsk",
        "receipt_number": "001001001",
        "remark": "备注111",
        "title": "报销标题2",
        "depart_id": "lNi0q7k07",
        "payment_date": "2023-08-08",
        "project": [
            {
                "project_id": "lyQsk7qVj"
            },
            {
                "project_id": "lemCs7j0C"
            }
        ],
        "add_user": "lNzq7a0ak",
        "cost_details": [
            {
                "create_date": "2023-08-08",
                "money": "121",
                "cost_id": "XJSmi0ksj",
                "cost_des": "费用说明11"
            },
            {
                "create_date": "2023-08-08",
                "money": "123",
                "cost_id": "XxeJx0ksq",
                "cost_des": "费用说明22"
            }
        ]
    }
]

Response

响应参数

参数	描述	类型	示例
errcode	错误码	int
errmsg	错误信息	string

响应示例:

{
    "data": [],
    "errcode": 0,
    "errmsg": "请求成功",
    "request_id": null
}

员工报销详情

Request

Url

[POST] : https://eapi.paiago.com/ZKGJ/getReimbursementDetail?access_token=ffc50044897a74c14b47a75

请求参数:

参数	类型	描述	示例
id	array	报销id	XJQiy0q7a

请求示例:

{
    "id":"XJQiy0q7a"
}

Response

响应参数

参数	类型	描述	示例
data	数据	array(object)	[]
> id	string	报销id
> title	string	标题
> application_number	string	申请单号
> reimbursement_number	string	报销单号
> project_ids	string	申请报销所属项目id值
> payment_remark	string	付款备注
> rece_info_id	string	收款账户id
> depart_name	string	部门名称
> ding_id	string	部门ding_id
> reimbursement_money	string	报销金额
> remark	string	申请备注
> payment_way	string	支付路径： 0: 线下 1: 线上
> pay_price	string	已付金额
> unpay_price	string	未付金额
> dedu_money	string	抵扣金额
> voucher	string	是否生成凭证 0: 未生成 1: 已生成 2: 待生成
> account_receivables	string	收款账户
> account_number	string	账号
> open_account_book	string	开户行
> account_land	string	开户地
> bank_branch_id	string	联行号
> leb	string	1银行账户； 2第三方账户： 3支付宝 4微信 5其他
> arrival_date	string	付款日期
> bill_number	string	单据编号
> payment_userid	string	付款人id
> yurRef	string	招行业务参考号
> payment_method	string	户名
> payment_values	string	开户账号
> bank_name	string	开户银行
> payment_id	string	收款方式id
> caozuoren	string	操作人
> add_user_ding_avatar	string	收款人头像
> caozuo_date	string	操作时间
> shoukuanren	string	收款人
> baoxiaoren	string	报销人
> baoxiao_avatar	string	报销人头像
> status	string	状态： 0：未处理； 1：已驳回； 2：已同意申请； 3：拒绝付款； 4：申请人撤销申请； 5：付款失败； 6：已付款撤销； 7：付款成功； 8：删除申请； 9：付款中；
> is_approval		string
> opinions	string	失败原因
> add_user	string	收款人
> payment_money	string	支付金额-抵扣金额
> news_id	string	消息id
> des	string	-
> apply_time	string	申请时间
> apply_date	string	申请时间
> submit_info	array(object)	在线付款记录信息
>> dowload_url	string	在线付款回单
> replace_user_id	string	代提交人id
> replace_user_realname	string	代提交人id姓名
> cost_list	array(object)	费用列表
>> id	string	费用详情id
>> date	string	发生日期
>> money	string	金额
>> cost_name	string	费用标题
>> cost_des	string	费用说明
>> share_type	number	分摊类型： 0：不分摊； 1：按部门分摊； 2：按项目分摊； 3：按部门&项目分摊；
>> start_id	string	区分是否是调整添加的数据并且存储的id为最早调整前的那条数据id
>> cost_id	string	费用id
>> billing_info	array(object)	费用的发票详情
>>> id	string	发票id
>>> bill_type	number	发票类型： 1：增值税普通发票； 2：增值税专用发票； 3：其他； 4：增值税电子普通发票； 5：增值税电子专用发票； 6：电子发票(普通发票)； 7：电子发票(增值税专用发票)；
>>> supplier_id	string	供应商id
>>> is_ocr	number	是否是只能识别发票 0: 不是 1:是
>>> leb	number	0：新建合同发票； 1：申请合同发票； 2：费用新建发票； 3：费用申请发票； 4：报销申请发票； 5：新建其他发票； 6：申请其他发票；
>>> status	number	0未处理 1已驳回 2已同意申请(待处理) 3拒绝处理 4申请人撤销申请 7开票成功 8作废
>>> remark	string	发票的备注
>>> billing_date	string	开票日期
>>> billing_number	string	发票号码
>>> billing_money	string	开票金额
>>> billing_rise	string	发票抬头
>>> billing_encoded	string	发票代码
>>> is_real	number	是否验真 0未验真 1是已验真
>>> tax_rate	string	税率
>>> multiple_tax_rates	string	多税率
>>> tax	string	税额
>>> supplier_name	string	供应商名称
>>> before_bill_share	array(object)	最初发票分摊明细（参考`bill_share`释义）
>>> files	array(object)	附件信息
>>>> url	string	附件url
>>> bill_share	array(object)	项目开票分摊明细
>>>> id	string	项目开票分摊id
>>>> billing_id	string	应付发票id
>>>> bill_money	string	分摊每笔发票的开票金额
>>>> ratio	string	分摊比例
>>>> project_id	string	项目id
>>>> project_name	string	项目名称
>> files	array(object)	明细的附件信息
>>> url	string	附件地址，用url直接下载（部分平台可能没有附件信息，具体联系客服或者开发人员）
>> share_info	array(object)	分摊明细
>>> id	string	项目分摊id
>>> company_id	string	公司id
>>> money	string	分摊到的金额
>>> bill_money	string	分摊每笔发票的开票金额
>>> ratio	string	分摊比例
>>> depart_id	string	部门id
>>> project_id	string	项目id
>>> type	string	1：费用； 2：报销；
>>> relation_id	string	-
>>> add_time	string	添加时间
>>> update_time	string	最后更新时间
>>> delete_time	string	删除时间
>>> depart_name	string	部门名称
>>> project_name	string	项目名称
> borrow_list	array(object)	借款列表
>> id	string	还款信息详情id
>> borrow_id	string	借款信息id
>> money	string	还款金额
>> apply_borrow_number	string	申请借款单号
>> borrow_money	string	支付金额
>> refunded_money	string	已还金额
>> add_time	string	添加时间
>> depart_name	string	部门名称
>> loan_name	string	借款类型
>> delete_time	string	删除时间
>> project_ids	string	申请费用时所选择的项目信息
>> second_num	string	默认值为1，每调整一次+1
>> project_name	string	项目名称
> deduction_list	array(object)	抵扣列表
>> id	string	借款信息id
>> apply_borrow_number	string	单号
>> borrow_date	string	借款日期
>> borrow_money	string	支付金额
>> type_name	string	借款类型
>> accounting_project	string	项目
>> no_refund_money	string	待还金额
>> dedu_money	string	本次冲抵金额
> accounting_project	array	项目名称集合（数组型）
> accounting_project_names	string	项目名称集合（字符型）
> files	array(object)	附件信息
>> url	string	附件地址，用url直接下载（部分平台可能没有附件信息，具体联系客服或者开发人员）

响应示例:

{
    "data":{
        "id":"XJQiy0q7a",
        "title":"AACCSS",
        "application_number":"BXSQ20220414171301",
        "reimbursement_number":"BX20220414171401",
        "project_ids":"XieyNjaC7,XNSmxja0g",
        "payment_remark":"",
        "rece_info_id":"PSSQixC7V",
        "depart_name":"510",
        "ding_id":"vQSzmxziiNxmeJQCjjq7jgq",
        "reimbursement_money":"203.00",
        "remark":"",
        "payment_way":0,
        "pay_price":"203.00",
        "unpay_price":"0.00",
        "dedu_money":"203.00",
        "voucher":0,
        "account_receivables":"赵成亮",
        "account_number":"18329699537",
        "open_account_book":"",
        "account_land":"中国建设银行总行(不受理个人业务)",
        "bank_branch_id":"105100000017",
        "leb":1,
        "arrival_date":"2022-04-14",
        "bill_number":"",
        "payment_userid":"WiiiJmSy0",
        "yurRef":null,
        "payment_method":"生成凭证专用账户",
        "payment_values":"001",
        "bank_name":"中国银行",
        "payment_id":"XxxNzskgj",
        "caozuoren":"庞凯",
        "add_user_ding_avatar":"https://static-legacy.dingtalk.com/media/lADPD2eDOoFCAuXNBFLNA3k_889_1106.jpg",
        "caozuo_date":1649927614,
        "shoukuanren":"庞凯",
        "baoxiaoren":"庞凯",
        "baoxiao_avatar":"https://static-legacy.dingtalk.com/media/lADPD2eDOoFCAuXNBFLNA3k_889_1106.jpg",
        "status":7,
        "is_approval":1,
        "opinions":null,
        "add_user":"WiiiJmSy0",
        "payment_money":"0.00",
        "news_id":"FNzQaskaa",
        "des":null,
        "apply_time":1649927614,
        "apply_date":1649927614,
        "submit_info":null,
        "dowload_status":0,
        "dowload_url":null,
        "replace_user_id":"We7",
        "replace_user_realname":null,
        "cost_list":[
            {
                "id":"XxmzmkaVk",
                "date":"2022-04-14",
                "money":"101.00",
                "cost_name":"出差费",
                "cost_des":"",
                "share_type":2,
                "start_id":"We7",
                "cost_id":"XJJxy0sjC",
                "billing_info":[
                    {
                        "id":"XxmzmkaVk",
                        "bill_type":1,
                        "supplier_id":"WiiiJmSy0",
                        "is_ocr":0,
                        "leb":4,
                        "status":7,
                        "remark":"",
                        "billing_date":"2022-04-14",
                        "billing_number":"20000000001",
                        "billing_money":"101.00",
                        "billing_rise":"公共供应商",
                        "billing_encoded":"",
                        "is_real":"0",
                        "tax_rate":"1.00%",
                        "tax":"1.00",
                        "supplier_name":"公共供应商",
                        "files": [
                            {
                                "fileId": 0,
                                "fileName": "fapiao16.png",
                                "src": "/upload/ocr/2024/03/06194313-2361643-7843.png",
                                "fileSize": 360633,
                                "fileType": "png",
                                "relation_type": 11,
                                "spaceId": 0,
                                "add_time": "2024-03-06 19:44",
                                "url": "https://zy.paiago.com//upload/ocr/2024/03/06194313-2361643-7843.png"
                            }
                        ],
                        "before_bill_share":[
                            {
                                "id":"PSSezNs7k",
                                "billing_id":"XJQxi0qag",
                                "bill_money":"33.66",
                                "ratio":"33.33",
                                "project_id":"XNSmxja0V",
                                "project_name":"201107伊朗二期聚酯工厂改造、增产项目(201107)"
                            }
                        ],
                        "bill_share":[
                            {
                                "id":"PSSezNs7k",
                                "billing_id":"XJQxi0qag",
                                "bill_money":"33.66",
                                "ratio":"33.33",
                                "project_id":"XNSmxja0V",
                                "project_name":"201107伊朗二期聚酯工厂改造、增产项目(201107)"
                            }
                        ]
                    }
                ],
                "share_info":[
                    {
                        "id":"XJiiN00gq",
                        "company_id":"UNNNmzJ0k",
                        "money":"33.67",
                        "bill_money":"33.66",
                        "ratio":"33.33",
                        "depart_id":null,
                        "project_id":"XNSmxja0V",
                        "type":2,
                        "relation_id":"XxmzmkaVk",
                        "add_time":1649927614,
                        "update_time":null,
                        "delete_time":null,
                        "depart_name":null,
                        "project_name":"201107伊朗二期聚酯工厂改造、增产项目(201107)"
                    }
                ],
                "files": [
                    {
                        "fileId": 0,
                        "fileName": "compressed.tracemonkey-pldi-09.pdf",
                        "src": "cs/9844/803628/dda973d563fc12498b12184dd778f126.pdf",
                        "relation_id": 7792,
                        "fileSize": 1016315,
                        "fileType": "pdf",
                        "relation_type": 16,
                        "spaceId": 0,
                        "add_time": "2025-03-03 14:28",
                        "url": "https://penk-dingding.oss-cn-hangzhou.aliyuncs.com/cs/9844/803628/dda973d563fc12498b12184dd778f126.pdf?Expires=174096720&OSSAccessKeyId=LTAI5t7sMTrF9WRdrjpVYto&Signature=nvCLTcvJ1a2F38mhULOu7cInCdoY%3D"
                    }
                ]
            }
        ],
        "borrow_list":[
            {
                "id":5939,
                "borrow_id":"XNJQJkqCs",
                "money":"1.00",
                "apply_borrow_number":"JK",
                "borrow_money":"1.00",
                "refunded_money":"1.00",
                "add_time":"2022-04-08",
                "depart_name":"510",
                "loan_name":"方法",
                "delete_time":null,
                "project_ids":"",
                "second_num":1,
                "project_name":""
            }
        ],
        "deduction_list":[
            {
                "id": "XNJQJkqCs",
                "apply_borrow_number": "JK",
                "borrow_date": "2022-04-08",
                "borrow_money": "1.00",
                "type_name": "方法",
                "accounting_project": null,
                "no_refund_money": "0.00",
                "dedu_money": "1.00"
            }
        ],
        "accounting_project":[
            "123124124(1232134)、测试单选(123三生三世)"
        ],
        "accounting_project_names":"123124124(1232134)、测试单选(123三生三世)",
        "files": [
            {
                "fileId": 0,
                "fileName": "compressed.tracemonkey-pldi-09.pdf",
                "src": "cs/9844/803628/dda973d563fc12498b12184dd778f126.pdf",
                "relation_id": 7792,
                "fileSize": 1016315,
                "fileType": "pdf",
                "relation_type": 16,
                "spaceId": 0,
                "add_time": "2025-03-03 14:28",
                "url": "https://penk-dingding.oss-cn-hangzhou.aliyuncs.com/cs/9844/803628/dda973d563fc12498b12184dd778f126.pdf?Expires=174096720&OSSAccessKeyId=LTAI5t7sMTrF9WRdrjpVYto&Signature=nvCLTcvJ1a2F38mhULOu7cInCdoY%3D"
            }
        ]
    },
    "errcode":0,
    "errmsg":"请求成功",
    "request_id":"e5bbb136d822f0b47c81b5c8ec98ea79",
    "env":"zkgj-dev"
}

权限设置

权限列表

Request

Url

[POST] : https://eapi.paiago.com/ZKGJ/Role/?access_token=ffc50044897a74c14b47a75

请求参数:

参数	类型	描述	示例
Field	array	请求字段	[]
> id	string	权限id
> rolename	string	权限名称
> user_list	string	当前权限下人员信息
Order	array	排序规则
Where	array	查询条件
Page	number	页数	0
ListRow	number	条数	20

请求示例:

{
    "Field": [
        "id",
        "rolename",
        "user_list"
    ],
    "Order": {
        "id": "desc"
    },
    "Where": [
    ],
    "ListRow": 20,
    "Page": 1
}

Response

响应参数

参数	描述	类型
count	总数	int
data	列表（参数释义同请求`Field`释义）	array(object)
> id	权限id	string
> rolename	权限名称	string
> user_list	当前权限下人员信息	array（object）
> user_role_id	人员权限id	string
> role_type	权限范围：0 全公司；1 本人；2 本部门；3 本部门及下属部门；4 特定部门	int
> user_name	用户名称	string
> user_id	用户id	string

响应示例:

{
    "data":[
        {
            "id":"liyq7sgg7",
            "realname":"权限一",
            "user_list":[
                {
                    "user_role_id":"liyq7sgg7",
                    "user_id":"liS0q7k0a",
                    "role_type": "1",
                    "user_name":"人员"
                }
            ]
        }
    ],
    "count":1,
    "errcode":0,
    "errmsg":"请求成功",
    "request_id":null,
    "env":"zkgj-cs"
}

添加权限成员

Request

Url

[POST] : https://eapi.paiago.com/ZKGJ/Role/AddUser/?access_token=ffc50044897a74c14b47a75

Rule

单次最多支持操作 100 条数据

请求参数:

参数	类型	必填	描述	示例
role_id	string	是	权限id	XxSmz00sV
user_id	string	是	人员id	XxSmz00sV

请求示例:

[
    {
        "role_id": "Xxyxz07qq",
        "user_id": "lNzq7sgVq"
    },
    {
        "role_id": "Xxyxz07qq",
        "user_id": "lNzq7sgVq"
    }
]

Response

响应参数

参数	描述	类型	示例
errcode	错误码	int
errmsg	错误信息	string

{
    "errcode":0,
    "errmsg":"成功!",
    "request_id":null,
    "env":"zkgj-cs"
}

移除权限成员

Request

Url

[POST] : https://eapi.paiago.com/ZKGJ/Role/RemoveUser/?access_token=ffc50044897a74c14b47a75

Rule

单次最多支持操作 100 条数据

请求参数:

参数	类型	必填	描述	示例
user_role_id	string	是	人员权限id（权限列表中user_list下user_role_id）	XxSmz00sV

请求示例:

[
    {
        "user_role_id": "Xxyxz07qq"
    },
    {
        "user_role_id": "Xxyxz07qq"
    }
]

Response

响应参数

参数	描述	类型	示例
errcode	错误码	int
errmsg	错误信息	string

{
    "errcode":0,
    "errmsg":"成功!",
    "request_id":null,
    "env":"zkgj-cs"
}

公共

在线付款回单

Request

Url

[POST] : https://eapi.paiago.com/ZKGJ/GetReceipt/?access_token=ffc50044897a74c14b47a75&

请求参数:

参数	类型	描述	示例
is_tenpay	number	submit_info内的is_tenpay值	1
payment_id	string	submit_info内的payment_id值	XNemJ07gq
payment_list_id	string	submit_info内的payment_list_id值	FyJJCksq0

请求示例:

(url)/GetReceipt/?access_token=ffc50044897a74c14b47a75&

Response

响应参数

参数	描述	类型	示例
data	获取到的数据	array(object)
> data	文件地址（会失效，获取后建议立刻下载）	string	http://******

响应示例:

Success

{
    "data":{
        "data":"http://******",
        "code":0,
        "msg":"成功"
    },
    "errcode":0,
    "errmsg":"请求成功",
    "request_id":null,
    "env":"zkgj-cs"
}

Error

{
    "errcode":28002,
    "errmsg":"获取失败",
    "request_id":null,
    "env":"zkgj-cs"
}

审批支付

创建付款单

Request

Url

[POST] : https://eapi.paiago.com/ZKGJ/ApprovePayment/Add/?access_token=ffc50044897a74c14b47a75

Rule

最多支持添加 100 条客户数据

请求参数:

参数	类型	必填	描述	示例
title	string	否	标题
apply_date	string	是	申请日期	2024-11-26
apply_money	number	是	申请金额	10.00
payee	string	否	收款方名称	十二
account_name	string	是	收款方户名	齐齐哈尔缘拓博思有限公司
account_number	string	是	收款方账号	15000279697834
open_account_book	string	否	收款方开户银行（收款账户为银行账户时，请传入）	平安银行
account_land	string	否	收款方开户支行（收款账户为银行账户时，请传入）	平安银行深圳分行营业部
bank_branch_id	string	否	收款方联行号
company_entity	string	否	公司主体	深圳市示例科技有限公司
apply_remark	string	否	备注
order_code	string	是	单据唯一标识	openApi20241126003
apply_name	string	是	申请人名称	十一

请求示例:

[
    {
        "title": "test-api-001",
        "apply_date": "2024-11-26",
        "apply_money": "2.01",
        "payee": "十二",
        "account_name": "齐齐哈尔缘拓博思有限公司",
        "account_number": "15000279697834",
        "open_account_book": "平安银行",
        "account_land": "平安银行深圳分行营业部",
        "bank_branch_id": "",
        "company_entity": "深圳市示例科技有限公司",
        "apply_remark": "备注",
        "order_code": "openApi20241126001",
        "apply_name": "胡*庆"
    },{
        "title": "test-api-002",
        "apply_date": "2024-11-26",
        "apply_money": "2.02",
        "payee": "十二",
        "account_name": "齐齐哈尔缘拓博思有限公司",
        "account_number": "15000279697834",
        "open_account_book": "平安银行",
        "account_land": "平安银行深圳分行营业部",
        "bank_branch_id": "",
        "company_entity": "深圳市示例科技有限公司",
        "apply_remark": "备注",
        "order_code": "openApi20241126002",
        "apply_name": "胡*庆"
    }
]

Response

响应参数

参数	描述	类型	示例
errcode	错误码	int
errmsg	错误信息	string

成功响应示例

{
    "errcode":0,
    "errmsg":"请求成功"
}

失败响应示例

{
    "errcode":21003,
    "errmsg":"第2条数据录入失败：单号(openApi20241126002) 已存在；\r\n"
}

账款管家审批支付API文档

更新日志

文档下载

Url

PayUrl

在线文档

ApiUrl

PayUrl

目录

Api文档

API指引

Request

Url

返回类型

请求参数:

参数说明:

请求示例:

php获取签名（signature）

java获取签名（signature）

Python获取签名（signature）

C#获取签名（signature）

Go获取签名（signature）

Response

响应参数

响应示例:

Request

请求参数:

请求示例:

where条件入参

Request

请求示例:

人员设置

Request

Url

请求参数:

请求示例:

Response

响应参数

响应示例:

Request

Url

Rule

请求参数:

请求示例:

Response

响应参数

付款队列

Request

Url

请求参数:

请求示例:

Response

响应参数

响应示例:

公司费用

Request

Url

请求参数:

请求示例:

Response

响应参数

响应示例:

Request

Url

Rule

请求参数:

请求示例:

Response

响应参数

响应示例:

Request

Url

请求参数:

请求示例:

Response

响应参数

响应示例:

Request

Url

请求参数: