账款管家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 签名
参数说明:
请求示例:

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
请求参数:
参数 类型 必填 描述 示例
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
请求参数:
参数 类型 必填 描述 示例
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
请求参数:
参数 类型 必填 描述 示例
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
请求参数:
参数 类型 必填 描述 示例
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
请求参数:
参数 类型 必填 描述 示例
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/getProductList?access_token=ffc50044897a74c14b47a75
请求参数:
参数 类型 描述 示例
Field array 请求字段 []
  product_id string 产品id
  user_id string 添加人id
  company_id string 公司id
  product_name string 产品名称
  product_cate_id string 产品分类id
  product_cate string 产品分类名称
  product_model string 产品型号
  product_explain string 产品说明
  product_code string 产品编码
  product_barcode string 产品条码
  product_price string 应收销售单价
  payment_price string 应付采购单价
  product_unit string 计量单位
  add_time string 添加时间
Order array 排序规则
Where array 查询条件
Page number 页数 0
ListRow number 条数 20
请求示例:
{
	"Field": [
		"product_cate_id",
		"product_model",
		"product_explain",
		"product_code",
		"product_cate",
		"product_barcode",
		"product_price",
		"payment_price",
		"user_id",
		"add_time",
		"product_id",
		"product_name",
		"company_id",
		"product_unit"
	],
	"Order": {
			"product_id": "desc",
			"product_cate_id": "desc"
	},
	"Where": [
		{
			"filed": "product_barcode",
			"factor": ">",
			"value": "0"
		}
	],
	"Page": 0,
	"ListRow": 1
}

Response

响应参数
参数 描述 类型 示例
count 总数 int
data 列表(详见请求Field释义) array(object)
响应示例:
{
    "data":[
        {
            "product_cate_id":"UiiieSyjV",
            "product_model":"红色大号",
            "product_explain":"验证文件扩展名,规则上也会验证文件的MIME类型,通过读取文件的内容以猜测它的MIME类型",
            "product_code":"CP20220400005",
            "product_cate":"的SaaS",
            "product_barcode":"XD000000000000000000000001",
            "product_unit":"两",
            "product_price":"99.9900000",
            "payment_price":"9.9900000",
            "user_id":"WiiiJmSy0",
            "add_time":1650937140,
            "product_id":"XximJjjqj",
            "product_name":"testadd",
            "company_id":"UNNNmzJ0k"
        }
    ],
    "count":29,
    "errcode":0,
    "errmsg":"请求成功",
    "request_id":"e67f269aead549d9c8e03ea1eff75bd8",
    "env":"zkgj-dev"
}

产品类型列表

Request

Url
[POST] : https://eapi.paiago.com/ZKGJ/getProductCateList?access_token=ffc50044897a74c14b47a75
请求参数:
参数 类型 描述 示例
Field array 请求字段 []
  cate_id string 产品分类id
  name string 产品分类名称
  company_id string 公司id
  parent_id string 父级id
  level string 当前级别
  is_enable string 是否启用:
0:禁用;
1:启用;
  add_user string 添加人id
  add_time string 添加时间
Order array 排序规则
Where array 查询条件
Page number 页数 0
ListRow number 条数 20
请求示例:
{
    "Field": [
        "cate_id",
        "name",
        "company_id",
        "parent_id",
        "level",
        "is_enable",
        "add_user",
        "add_time"
    ],
    "Order": {
        "cate_id": "desc"
    },
    "Where": [
        {
            "filed": "cate_id",
            "factor": ">",
            "value": "0"
        }
    ],
    "Page": 0,
    "ListRow": 1
}

Response

响应参数
参数 描述 类型 示例
count 总数 int
data 列表(详见请求Field释义) array(object)
响应示例:
{
    "data":[
        {
            "cate_id":"UiiieSyjV",
            "name":"的SaaS",
            "company_id":"UNNNmzJ0k",
            "parent_id":"We7",
            "level":0,
            "is_enable":1,
            "add_user":"WiiiJmSy0",
            "add_time":1648604518
        }
    ],
    "count":10,
    "errcode":0,
    "errmsg":"请求成功",
    "request_id":"e97a00fc8eac9353a938f0e55ce5b29d",
    "env":"zkgj-dev"
}

新增产品

Request

Url
[POST] : https://eapi.paiago.com/ZKGJ/addProduct?access_token=ffc50044897a74c14b47a75
请求参数:
参数 类型 必填 描述 示例
product_code string 商品编码 CPX000000002
product_name string 商品编码 testadd
unit string 计量单位
product_model string 产品型号
product_explain string 产品说明
product_price string product_price
payment_price string 应付采购单价
code string 商品条码
cate_id string 分类id ""
0
"0"
UNNNSxJq0
请求示例:
{
    "product_code": "CPX000000002",
    "product_name": "testadd",
    "unit": "两",
    "product_model": "红色大号",
    "product_explain": " 验证文件扩展名,规则上也会验证文件的MIME类型,通过读取文件的内容以猜测它的MIME类型",
    "product_price": 99.99,
    "payment_price": 9.99,
    "code": "XD000000000000000000000001",
    "cate_id": 0
}

Response

响应参数
参数 描述 类型 示例
errcode 错误码 int
errmsg 错误信息 string
响应示例:
{
    "data": [],
    "errcode": 0,
    "errmsg": "请求成功",
    "request_id": "0c8b3505861e355973e410ac78dd3fc2",
    "env": "zkgj-dev"
}

新增产品类型

Request

Url
[POST] : https://eapi.paiago.com/ZKGJ/addProductCate?access_token=ffc50044897a74c14b47a75
请求参数:
参数 类型 必填 描述 示例
parent_id string 父级id
新增顶级分类时,传入0
""
0
"0"
UNNNSxJq0
name string 分类名称
code string 分类编码
请求示例:
{
    "parent_id":"UNNNSxJq0",
    "name":"新建分类x1",
    "code":"123456"
}

Response

响应参数
参数 描述 类型 示例
errcode 错误码 int
errmsg 错误信息 string
响应示例:
{
    "data": [],
    "errcode": 0,
    "errmsg": "请求成功",
    "request_id": "0c8b3505861e355973e410ac78dd3fc2",
    "env": "zkgj-dev"
}

供应商


供应商列表

Request

Url
[POST] : https://eapi.paiago.com/ZKGJ/Intercourse/Supplier/?access_token=ffc50044897a74c14b47a75
请求参数:
参数 类型 描述 示例
Field array 请求字段 []
  > id string 供应商id
  > supplier_definition string 供应商名称
  > supplier_number string 供应商编码
  > identification_code string 纳税人识别号
  > telephone string 联系人电话
  > contacts string 联系人
  > remarks string 备注
  > add_user string 创建人id
  > add_date string 创建时间
  > supplier_type_id string 供应商类型id
  > supplier_type string 供应商类型名称
  > leader string 负责人id
  > leader_name string 负责人姓名
  > account string 收款账户id
  > account_mechanism string 开户机构
  > account_definition string 账户名称
  > account_code string 账户信息
Order array 排序规则
Where array 查询条件
Page number 页数 0
ListRow number 条数 20
请求示例:
{
    "Field":[
        "id",
        "supplier_definition",
        "supplier_number",
        "supplier_type",
        "supplier_type_id",
        "identification_code",
        "telephone",
        "contacts",
        "add_user",
        "add_date",
        "remarks",
        "leader",
        "leader_name",
        "account",
        "account_mechanism",
        "account_definition",
        "account_code"
    ],
    "Order":{
        "telephone":"desc"
    },
    "Where":[

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

Response

响应参数
参数 描述 类型 示例
count 总数 int
data 列表(详见请求Field释义) array(object)
响应示例:
{
    "data":[
        {
            "id":"XixSJk0jV",
            "supplier_definition":"wwj应付供应商",
            "supplier_number":"GYS2021072900001",
            "supplier_type":"23412",
            "supplier_type_id":"PSxeNx0ag",
            "identification_code":"78657566545",
            "telephone":"18392390727",
            "contacts":"王静",
            "add_user":"liyq7skqk",
            "add_date":1627529952,
            "remarks":"但是",
            "leader":"liyq7skqk",
            "leader_name":"王*静",
            "account":"Xxxyz0s7a",
            "account_mechanism":"中国银行",
            "account_definition":"张三",
            "account_code":"4545645546"
        }
    ],
    "count":206,
    "errcode":0,
    "errmsg":"请求成功",
    "request_id":null,
    "env":"zkgj-cs"
}

供应商收款账户

Request

Url
[POST] : https://eapi.paiago.com/ZKGJ/Intercourse/SupplierAccount/?access_token=ffc50044897a74c14b47a75
请求参数:
参数 类型 描述 示例
Field array 请求字段 []
  > id string 供应商id
  > supplier_definition string 供应商名称
  > supplier_number string 供应商编码
  > account_list string 收款账户id
   > id string 账户ID
   > account_name string 账户名称
   > account_number string 账号
   > account_mechanism string 开户机构
   > account_land string 开户地
   > supplier_id string 供应商ID
   > bank_branch_id string 联行号
   > leb string 1银行账户;
现金账户:
3支付宝
4微信
5其他
Order array 排序规则
Where array 查询条件
Page number 页数 0
ListRow number 条数 20
请求示例:
{
    "Field":[
        "id",
        "supplier_number",
        "supplier_definition",
        "account_list"
    ],
    "Order":{
        "id":"asc"
    },
    "Where":[

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

Response

响应参数
参数 描述 类型 示例
count 总数 int
data 列表(详见请求Field释义) array(object)
响应示例:
{
    "data": [
        {
            "id": "Xixxxkssq",
            "supplier_number": "GYS2021082500001",
            "supplier_definition": "H供应商",
            "account_list": [
                {
                    "id": "XJSiQ0kVj",
                    "account_name": "星辰",
                    "account_number": "62170028****622",
                    "account_mechanism": "中国建设银行",
                    "account_land": "中国建设银行北京新华支行",
                    "supplier_id": "Xixxxkssq",
                    "bank_branch_id": "308584001475",
                    "leb": 1
                },
                {
                    "id": "Xxexz0kVq",
                    "account_name": "搜账户",
                    "account_number": "62170028****622",
                    "account_mechanism": "中国建设银行",
                    "account_land": "中国建设银行北京市分行东四支行营业部",
                    "supplier_id": "Xixxxkssq",
                    "bank_branch_id": "",
                    "leb": 1
                }
            ]
        },
        {
            "id": "XJNyzqVaa",
            "supplier_number": "VEN00003",
            "supplier_definition": "supplier03",
            "account_list": []
        }
    ],
    "errcode": 0,
    "errmsg": "请求成功",
    "request_id": null,
    "env": "zkgj-cs",
    "count": 34
}

供应商类型列表

Request

Url
[POST] : https://eapi.paiago.com/ZKGJ/Intercourse/SupplierType/?access_token=ffc50044897a74c14b47a75
请求参数:
参数 类型 描述 示例
Field array 请求字段 []
  > id string 供应商类型id
  > type_name string 供应商类型名称
  > num number 类型被关联数量
Order array 排序规则
Where array 查询条件
Page number 页数 0
ListRow number 条数 20
请求示例:
{
    "Field":[
        "type_name",
        "num",
        "id"
    ],
    "Order":{
        "id":"desc"
    },
    "Where":[

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

Response

响应参数
参数 描述 类型 示例
count 总数 int
data 列表(详见请求Field释义) array(object)
响应示例:
{
    "data":[
        {
            "type_name":"线上付款账户",
            "num":1,
            "id":"PSSQxzCaq"
        },
        {
            "type_name":"招行线上支付",
            "num":1,
            "id":"PiiyiSCaa"
        },
        {
            "type_name":" ",
            "num":3,
            "id":"PSSQSyCsg"
        }
    ],
    "count":24,
    "errcode":0,
    "errmsg":"请求成功",
    "request_id":null,
    "env":"zkgj-dev"
}

新增供应商

Request

Url
[POST] : https://eapi.paiago.com/ZKGJ/Intercourse/Supplier/Add/?access_token=ffc50044897a74c14b47a75
Rule
请求参数:
参数 类型 必填 描述 示例
supplier_type string 供应商类型
supplier_definition string 供应商名称
supplier_number string 供应商编号
identification_code string 纳税人识别号
telephone string 联系方式
contacts string 联系人
remarks string 备注
leader string 负责人id集合
add_user string 创建人id
child_list array(object) 收款账户信息
  account_code string 账户
  account_definaccount string 账户名称、户名
  account_mechanism string 开户银行名称
请求示例:
[
    {
        "supplier_type":"PSxeNx0ag,PSSQQxCVV,PSxNzyas0,XJJQN0sjq,PSxNJzakC",
        "supplier_definition":"WiiiJmSy02",
        "supplier_number":"GYS198322",
        "identification_code":"纳税人识别号",
        "telephone":"13888888888",
        "contacts":"联系人",
        "remarks":"备注",
        "leader":"lNzq7sqjC,lNmq7s0Va",
        "add_user":"WiiiJmSy0",
        "child_list":[
            {
                "account_code":"654321",
                "account_definaccount":"账户名称1",
                "account_mechanism":"开户机构1"
            }
        ]
    }
]

Response

响应参数
参数 描述 类型 示例
errcode 错误码 int
errmsg 错误信息 string
{
    "errcode":21003,
    "errmsg":"第1条数据录入失败:系统已有该供应商,请勿重复添加!",
    "request_id":null,
    "env":"zkgj-cs"
}

公共


合同统计

Request

Url
[POST] : https://eapi.paiago.com/ZKGJ/contract/StatisticalContracts?date=2021&access_token==ffc50044897a74c14b47a75
请求参数:
参数 类型 必填 描述 示例
date int 年份 2024【默认当前年份】
请求示例:
(url)/ZKGJ/contract/StatisticalContracts?date=2021&access_token=ffc50044897a74c14b47a75

Response

响应参数
参数 描述 类型 示例
data 编号 string
 >x 月份 string 01-12
 >y 数量 string 0-99999
 >colorField 名称 string 应收/应付
响应示例:

Success

{
    "data": [
        {
            "x": "01",
            "y": 0,
            "colorField": "应收"
        },
        {
            "x": "01",
            "y": 0,
            "colorField": "应付"
        },
        {
            "x": "02",
            "y": 0,
            "colorField": "应收"
        },
        {
            "x": "02",
            "y": 0,
            "colorField": "应付"
        },
        {
            "x": "03",
            "y": 7,
            "colorField": "应收"
        },
        {
            "x": "03",
            "y": 20,
            "colorField": "应付"
        },
        {
            "x": "04",
            "y": 7,
            "colorField": "应收"
        },
        {
            "x": "04",
            "y": 11,
            "colorField": "应付"
        },
        {
            "x": "05",
            "y": 0,
            "colorField": "应收"
        },
        {
            "x": "05",
            "y": 0,
            "colorField": "应付"
        },
        {
            "x": "06",
            "y": 0,
            "colorField": "应收"
        },
        {
            "x": "06",
            "y": 0,
            "colorField": "应付"
        },
        {
            "x": "07",
            "y": 0,
            "colorField": "应收"
        },
        {
            "x": "07",
            "y": 0,
            "colorField": "应付"
        },
        {
            "x": "08",
            "y": 0,
            "colorField": "应收"
        },
        {
            "x": "08",
            "y": 0,
            "colorField": "应付"
        },
        {
            "x": "09",
            "y": 0,
            "colorField": "应收"
        },
        {
            "x": "09",
            "y": 0,
            "colorField": "应付"
        },
        {
            "x": "10",
            "y": 0,
            "colorField": "应收"
        },
        {
            "x": "10",
            "y": 0,
            "colorField": "应付"
        },
        {
            "x": "11",
            "y": 0,
            "colorField": "应收"
        },
        {
            "x": "11",
            "y": 0,
            "colorField": "应付"
        },
        {
            "x": "12",
            "y": 0,
            "colorField": "应收"
        },
        {
            "x": "12",
            "y": 0,
            "colorField": "应付"
        }
    ],
    "errcode": 0,
    "errmsg": "请求成功",
    "request_id": null,
    "env": "zkgj-cs"
}

Error

{
    "errcode": 21005,
    "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
[GET] : https://eapi.paiago.com/ZKGJ/Number/?leb=&access_token=ffc50044897a74c14b47a75&
请求参数:
参数 类型 描述 示例
leb number 类型
(仅支持1、4、7)
1:普通模板(应收)
2:周期模板(应收)
3:框架模板(应收)
4:普通合同(应付)
5:框架合同(应付)
6:客户管理
7:供应商
8:产品设置
9:项目核算
10:入库单
11:出库单
12:调拨单
13:仓库设置
14:Bom清单
请求示例:
(url)/Number/?leb=4&access_token=ffc50044897a74c14b47a75&

Response

响应参数
参数 描述 类型 示例
data 编号 string GYS202205261
响应示例:

Success

{
    "data":"PF00003",
    "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/SystemData/TradingAccount/?access_token=ffc50044897a74c14b47a75
请求参数:
参数 类型 描述 示例
Field array 请求字段 []
  > id string 收款方式id
  > payment_method string 收款方式名称
  > account_number string 账号
  > type string 账户类型
  > bank_name string 开户银行
  > account_branch string 开户支行
Order array 排序规则
Where array 查询条件
Page number 页数 0
ListRow number 条数 20
请求示例:
{
    "Field":[
        "payment_method",
        "account_number",
        "type",
        "bank_name",
        "account_branch"
    ],
    "Order":{
        "payment_method":"desc"
    },
    "Where":[

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

Response

响应参数
参数 描述 类型
count 总数 int
data 列表(参数释义同请求Field释义) array(object)
响应示例:
{
    "data":[
        {
            "payment_method": "测试企业v",
            "account_number": "622100284020281425",
            "type": "银行账户",
            "bank_name": "平安银行",
            "account_branch": "",
            "id": "PiJNmiq0j"
        },
        {
            "payment_method": "He",
            "account_number": "18800000000",
            "type": "支付宝账户",
            "bank_name": "",
            "account_branch": "",
            "id": "XJzSi000j"
        }
    ],
    "count":178,
    "errcode":0,
    "errmsg":"请求成功",
    "request_id":null,
    "env":"zkgj-dev"
}

员工账户列表

Request

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

注:请求传入where人员id 则查询当前员工下的账户

请求参数:
参数 类型 描述 示例
Field array 请求字段 []
  > id string 收款方式id
  > account_name string 收款账户
  > account_number string 收款账号
  > add_userid string 收款人ID
  > account_land string 开户地
  > bank_branch_id string 联行号
  > open_account_book string 开户行
Order array 排序规则
Where array 查询条件
Page number 页数 0
ListRow number 条数 20
请求示例:
{
    "Field":[
        "id",
        "account_receivables",
        "account_number",
        "add_userid"
    ],
    "Order":{
        "id":"desc"
    },
    "Where":[
        {
            "filed": "add_userid",
            "factor": "=",
            "value": "lNzq7sVsC"
        }
    ],
    "Page":1,
    "ListRow":10
}

Response

响应参数
参数 描述 类型
count 总数 int
data 列表(参数释义同请求Field释义) array(object)
响应示例:
{
    "data": [
        {
            "id": "PSNNyzVsV",
            "account_name": "何佳",
            "account_number": "12345678910",
            "add_userid": "lNzq7sVsC"
        },
        {
            "id": "PSxmeyVsk",
            "account_name": "户名",
            "account_number": "12312321321321",
            "add_userid": "lNzq7sVsC"
        }
    ],
    "errcode": 0,
    "errmsg": "请求成功",
    "request_id": null,
    "env": "zkgj-dev",
    "count": 2
}

表单状态列表

Request

Url
[POST] : https://eapi.paiago.com/ZKGJ/StatusSetting?access_token=ffc50044897a74c14b47a75
请求参数:
参数 类型 描述 示例
Field array 请求字段 []
  > id string id
  > module number 模块: 1:项目状态;2:入库类型;3:出库类型
  > name string 状态名称
  > description string 描述
  > is_enable number 是否启用,1为启用
  > is_system number 是否系统预置 0:非系统预置 1:系统预置
  > sort number 排序
Order array 排序规则
Where array 查询条件
Page number 页数 0
ListRow number 条数 20
请求示例:
{
    "Field":[
        "id",
        "module",
        "name",
        "description",
        "is_enable",
        "sort",
        "is_system"
    ],
    "Order":{
        "id":"desc"
    },
    "Where":[
        {
            "filed": "module",
            "factor": "=",
            "value": "1"
        }
    ],
    "Page":1,
    "ListRow":20
}

Response

响应参数
参数 描述 类型
count 总数 int
list 列表(参数释义同请求Field释义) array(object)
响应示例:
{
    "data":[
        {
            "id": "XmNzJ0Cs7",
            "module": 1,
            "name": "已完成",
            "description": "",
            "is_enable": 1,
            "sort": 3,
            "is_system": 1
        },
        {
            "id": "XSxSQ0CCg",
            "module": 1,
            "name": "执行中",
            "description": "",
            "is_enable": 1,
            "sort": 2,
            "is_system": 1
        },
        {
            "id": "XJiyy0CCq",
            "module": 1,
            "name": "执行前",
            "description": "",
            "is_enable": 1,
            "sort": 1,
            "is_system": 1
        }
    ],
    "count":1,
    "errcode":0,
    "errmsg":"请求成功",
    "request_id":"f9d6734b2616967d43a7dc18f0c23856",
    "env":"zkgj-dev"
}

部门列表

Request

Url
[POST] : https://eapi.paiago.com/ZKGJ/Corp/Depart/?access_token=ffc50044897a74c14b47a75
请求参数:
参数 类型 描述 示例
Field array 请求字段 []
  > id string 部门id
  > depart_name string 部门名称
  > ding_id string 组织id
  > parent_ding_id string 父级组织id
Order array 排序规则
Where array 查询条件
Page number 页数 0
ListRow number 条数 20
请求示例:
{
    "Field":[
        "id",
        "depart_name",
        "ding_id",
        "parent_ding_id"
    ],
    "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
  > depart_name 部门名称 string
  > ding_id 组织id string
  > parent_ding_id 父级组织id string
  > p_ding_id 所在平台部门id(目前只有钉钉平台返回) string
  > p_parent_ding_id 所在平台部门父级id(目前只有钉钉平台返回) string
响应示例:
{
    "data":[
        {
            "id": "lix0q7V0s",
            "depart_name": "",
            "ding_id": "fixSzQyziQxeQQgs0gVaasa",
            "parent_ding_id": "WiiiJmSy0",
            "p_ding_id": "931964434",
            "p_parent_ding_id": 1
        }
    ],
    "count":1,
    "errcode":0,
    "errmsg":"请求成功",
    "request_id":null,
    "env":"zkgj-cs"
}

发票


应付发票列表

Request

Url
[POST] : https://eapi.paiago.com/ZKGJ/getPayBillingList?access_token=ffc50044897a74c14b47a75
请求参数:
参数 类型 描述 示例
Field array 请求字段 []
  > id string 发票id
  > billing_status string 发票状态
待开票
已开票
已作废
开票中
已发送
未发送
未打印
未打印发票清单
已打印
  > bill_type string 发票类型:
1:增值税普通发票
2:增值税专用发票;
3:其他;
4:增值税电子普通发票;
5:增值税电子专用发票
6:电子发票(普通发票);
7:电子发票(增值税专用发票);
  > supplier_id string 供应商id
  > billing_rise string 发票抬头
  > billing_date string 开票日期
  > billing_number string 发票号码
  > billing_checkcode string 发票校验码
  > billing_encoded string 发票代码
  > billing_money string 开票金额
  > tax_rate string 税率
  > tax string 税额
  > status string 发票状态:7开票成功
  > add_time string 添加时间
  > add_userid string 添加人id
  > update_time string
  > relation_id string 只关联费用详情以及报销详情的id 即字段payout_cost_list下的的id
  > remark string 备注
  > is_ocr string 是否是只能识别发票0不是 1是
  > tax_rate_various string 发票识别出的税率是否有多个 0不是 1是
  > is_free_tax string 是否免税 1是免税
  > is_real string 是否验真 1是已验真
  > is_scan string 是否扫码 1是扫码
  > voucher string 是否生成凭证0未生成 1已生成 2待生成
  > voucher_user string 生成凭证人员
  > voucher_time string 凭证时间
  > contract string 关联合同
  > project string 关联项目
  > leb string 发票来源
0:新建合同发票;
1:申请合同发票;
2:费用新建发票;
3:费用申请发票;
4:报销申请发票;
5:新建其他发票;
6:申请其他发票;
  > files array(object) 附件信息
Order array 排序规则
Where array 查询条件
Page number 页数 0
ListRow number 条数 20
请求示例:
{
	"Field": [
		"bill_type",
		"supplier_id",
		"billing_rise",
		"billing_date",
		"billing_number",
		"billing_checkcode",
		"billing_encoded",
		"billing_money",
		"tax_rate",
		"tax",
		"status",
		"add_time",
		"add_userid",
		"update_time",
		"relation_id",
		"remark",
		"is_ocr",
		"tax_rate_various",
		"is_free_tax",
		"is_real",
		"is_scan",
		"voucher",
		"voucher_user",
		"voucher_time",
		"contract",
		"project",
        "files"
	],
	"Order": [],
	"Where": [],
	"Page": 0,
	"ListRow": 3
}

Response

响应参数
参数 类型 描述 示例
count int 总数 100
data array(object) 列表 []
  > project array(object) 发票直接关联项目
   > company_id string 公司id
   > project_id string 项目id
   > module string =12 应付合同
   > add_time string 添加时间
   > relation_id string 合同id
   > cost_id string 分摊id
   > is_share string 是否分摊
   > share_money string 分摊金额
   > share_percentage string 分摊比例
   > project_name string 项目名称
   > project_number string 项目编号
  > contract array(object) 关联合同
   > company_id array(object) 公司id
   > supplier_id string 供应商id
   > contract_id string 合同id
   > billing_id string 发票id
   > contract_billing_money string 合同开票金额
   > tax string 税额
   > add_time number 添加时间
   > parent_id number/null 父级id
   > contract_name string 合同名称
   > contract_number string) 合同编号
   > contract_money string) 合同金额
   > contract_date string 签订日期
   > is_share_finish number 分摊类型
0:无分摊
1:部分分摊
2:全部分摊
   > project array(object) 合同关联项目
    > company_id string 公司id
    > project_id string 项目id
    > module number =2 应付合同
    > add_time number 添加时间
    > is_share number 是否分摊 0:无分摊 1:分摊
    > share_money string 分摊金额
    > share_percentage string 分摊比例
    > project_name string 项目名称
    > project_number string 项目编号
    > contract_id string 合同id
  > files array(object) 附件信息
   >> 附件url string 附件信息
响应示例:
{
    "data":[
        {
            "bill_type":1,
            "supplier_id":"WiiiJmSy0",
            "billing_rise":null,
            "billing_date":"2022-04-18",
            "billing_number":"2134r4wq4234234234",
            "billing_checkcode":"",
            "billing_encoded":"",
            "billing_money":"2.22",
            "tax_rate":"1.00",
            "tax":"0.02",
            "status":7,
            "add_time":1650282829,
            "add_userid":"WiiiJmSy0",
            "update_time":1650282829,
            "relation_id":null,
            "remark":"",
            "is_ocr":0,
            "tax_rate_various":0,
            "is_free_tax":0,
            "is_real":0,
            "is_scan":0,
            "voucher":0,
            "voucher_user":null,
            "voucher_time":0,
            "contract":[
                {
                    "id":"XSxey0kks",
                    "company_id":"UNNNmzJ0k",
                    "supplier_id":"WiiiJmSy0",
                    "contract_id":"FmxN0q7kV",
                    "billing_id":"XJQxy0qkC",
                    "contract_billing_money":"1.00",
                    "tax":"0.01",
                    "add_time":1650282513,
                    "parent_id":null,
                    "contract_name":"测试合同付款计划",
                    "contract_number":"mlr2022030200001",
                    "contract_money":"333.33",
                    "contract_date":"2022-03-02",
                    "is_share_finish":0,
                    "project":[
                        {
                            "company_id":"UNNNmzJ0k",
                            "project_id":"XieyNjaC7",
                            "module":2,
                            "add_time":1650358151,
                            "cost_id":null,
                            "is_share":0,
                            "share_money":"0.00",
                            "share_percentage":"100.00",
                            "project_name":"测试单选",
                            "project_number":"123三生三世",
                            "contract_id":"Fmxm0q7Vk"
                        }
                    ]
                },
                {
                    "id":"XmzeJ0kka",
                    "company_id":"UNNNmzJ0k",
                    "supplier_id":"WiiiJmSy0",
                    "contract_id":"FmSz0jgVV",
                    "billing_id":"XJQxy0qkC",
                    "contract_billing_money":"0.11",
                    "tax":"0.00",
                    "add_time":1650282513,
                    "parent_id":null,
                    "contract_name":"分摊770",
                    "contract_number":"FT2022021000023",
                    "contract_money":"3000.00",
                    "contract_date":"2022-02-28",
                    "is_share_finish":1,
                    "project":[

                    ]
                }
            ],
            "project":[
                {
                    "company_id":"UNNNmzJ0k",
                    "project_id":"XxzQija0C",
                    "module":12,
                    "add_time":1650282829,
                    "relation_id":"XSQzN0qks",
                    "cost_id":null,
                    "is_share":0,
                    "share_money":"0.00",
                    "share_percentage":"100.00",
                    "project_name":"201708新凤鸣年产4万吨功能性柔性化聚酯装置",
                    "project_number":"201708"
                }
            ],
            "id":"XSQzN0qks",
            "company_id":"UNNNmzJ0k",
            "leb":5,
            "files": [
                {
                    "fileId": 0,
                    "fileName": "lQDPJxbNB2PSEfzNBhjNCgCwfX6K-7mVbG8DUPxProDOAA_2560_1560.jpg",
                    "src": "/upload/ocr/2022/11/01100733-803628-1781.jpg",
                    "fileSize": 434582,
                    "fileType": "jpg",
                    "relation_type": 11,
                    "spaceId": 0,
                    "add_time": "2022-11-01 10:07",
                    "url": "http://*****.jpg"
                }
            ]
        }
    ],
    "count":249,
    "errcode":0,
    "errmsg":"请求成功",
    "request_id":"3403b99cbbcf3ffb753517f0ede0c115",
    "env":"zkgj-dev"
}


应收发票列表

Request

Url
[POST] : https://eapi.paiago.com/ZKGJ/getBillingList?access_token=ffc50044897a74c14b47a75
请求参数:
参数 类型 描述 示例
Field array 请求字段 []
  > id string 发票id
  > company_id string 公司id
  > custom_name string 客户名称
  > tax_rate string 税率
  > billing_date string 开票日期
  > billing_number string 发票编号
  > billing_money string 开票金额
  > tax string 税额
  > remark string 备注
  > billing_status string 发票状态
待开票
已开票
已作废
开票中
已发送
未发送
未打印
未打印发票清单
已打印
  > billing_type string 发票类型:
1:增值税普通发票
2:增值税专用发票;
3:其他;
4:增值税电子普通发票;
5:增值税电子专用发票
6:电子发票(普通发票);
7:电子发票(增值税专用发票);
  > billing_category string 发票类型:
0:合同发票;
1:其他发票
  > billing_encoded string 发票代码
  > tel string 联系电话
  > address string 地址
  > invoice_header string 发票抬头
  > taxpayer_identification_number string 纳税人识别号
  > bank_name string 开户银行
  > bank_account_number string 银行帐号
  > voucher string 是否生成凭证
0未生成
1已生成
2待生成
  > billing_goods string 发票明细
  > contracts string 发票合同
  > projects string 发票项目
  > online_url string 在线开票附件url
   > files array(object) 附件信息
   > rush_red string 是否红冲
   > invoice_info string 在线开票主体名称
   > add_time string 添加时间
   > is_intell string 是否在线开票
1 在线开票
0 手动开票
Order array 排序规则
Where array 查询条件
Page number 页数 0
ListRow number 条数 20
请求示例:
{
    "Field": [
        "custom_name",
        "id",
        "company_id",
        "tax_rate",
        "billing_date",
        "billing_number",
        "billing_money",
        "tax",
        "remark",
        "billing_status",
        "billing_type",
        "billing_category",
        "billing_encoded",
        "tel",
        "address",
        "invoice_header",
        "taxpayer_identification_number",
        "bank_name",
        "bank_account_number",
        "voucher",
        "billing_goods",
        "contracts",
        "projects",
        "files",
        "online_url",
        "rush_red",
        "invoice_info"
    ],
    "Order":{
        "bank_account_number" :"asc",
        "billing_status" :"asc"
    },
    "Where" : [
        {
            "filed" : "billing_money",
            "factor" : ">=",
            "value":"0"
        }
    ],
    "Page" : 0,
    "ListRow" : 100
}

Response

响应参数
参数 类型 描述 示例
count int 总数 0
data array(object) 列表 []
  > custom_name string 客户名称
  > billing_money string 开票金额
  > tax string 税额
  > billing_type string 发票类型
  > billing_goods array(object) 发票明细
   >> id string 明细id
   >> company_id string 公司id
   >> billing_id string 发票id
   >> goods_id string 商品id
   >> goods_name string 商品名称
   >> price string 商品单价
   >> all_price string 商品总价
   >> tax_rate string 税率
   >> tax string 税额
   >> is_free_tax string 是否免税:
0:不免税
1:免税
   >> number string 商品数量
  > contracts array(object) 发票合同
   >> billing_id string 发票id
   >> contract_id string 合同id
   >> tax string 税额
   >> billing_money string 开票金额
   >> contract_name string 合同名称
   >> contract_number string 合同编号
   >> custom_name string 客户名称
   >> custom_number string 客户编号
   >> contract_type string 合同类型
:一般合同,
2:周期合同,
3:框架合同..
4:框架合同的子合同
   >> contract_money string 合同金额
   >> contracted_money string 已核销金额
   >> billed_money string 已开票金额
   >> receivable_money string 回款金额
   >> discount_money string 折让金额
   >> initial_money string 初始金额
   >> status string 合同状态
0:正常
:坏账
2:完成
   >> remark string 备注
   >> project_names string 所属项目
   >> label_names string 合同标签名称
   >> add_time string 添加时间
   >> project array(object) 合同关联项目
    >>> company_id string 公司id
    >>> project_id string 项目id
    >>> module number =2 应付合同
    >>> add_time number 添加时间
    >>> is_share number 是否分摊 0:无分摊 1:分摊
    >>> share_money string 分摊金额
    >>> share_percentage string 分摊比例
    >>> project_name string 项目名称
    >>> project_number string 项目编号
    >>> contract_id string 合同id
  > projects array(object) 发票项目
   >> billing_id string 发票id
   >> project_name string 项目名称
   >> project_id string 项目id
   >> project_number string 项目编号
 > online_url string 在线开票附件
  > files array(object) 附件信息
   >> 附件url string 附件url
  > rush_red string 是否红冲(有值标识红冲
[返回值可关联到发票id])
  > invoice_info string 在线开票主体名称
响应示例
{
    "data":[
        {
            "custom_name":"鹏3",
            "billing_money":"1.00",
            "tax":"0.03",
            "billing_type":2,
            "billing_category":0,
            "tel":"",
            "address":"",
            "invoice_header":"",
            "bank_name":"",
            "bank_account_number":"",
            "billing_status":"已开票",
            "leb":0,
            "id":"FmxiC7g0g",
            "company_id":"UNNNmzJ0k",
            "billing_goods":[
                {
                    "id":"XNJexkgjs",
                    "company_id":"UNNNmzJ0k",
                    "billing_id":"FmxiC7g0g",
                    "goods_id":"PQNNmQCCq",
                    "goods_name":"111",
                    "price":"1.0000000",
                    "all_price":"1.0000000",
                    "tax_rate":"3.00",
                    "tax":"0.03",
                    "is_free_tax":0,
                    "number":"1"
                }
            ],
            "contracts":[
                {
                    "billing_id":"FmxiC7g0g",
                    "contract_id":"pmCVVCaqk",
                    "tax":"0.03",
                    "billing_money":"1.00",
                    "contract_name":"22323",
                    "contract_number":"CSaa2022040200001",
                    "custom_name":"鹏3",
                    "custom_number":"",
                    "contract_type":1,
                    "contract_money":"32232.00",
                    "contracted_money":"0.00",
                    "billed_money":"219.00",
                    "receivable_money":"0.00",
                    "discount_money":"0.00",
                    "initial_money":"32232.00",
                    "status":0,
                    "remark":"",
                    "project_names":"",
                    "label_names":"",
                    "add_time":1648881763
                }
            ],
            "projects":[
                {
                    "billing_id":"FQJNC7qga",
                    "project_name":"202027青州天安年产6万吨PBAT",
                    "project_id":"XxzQija0k",
                    "project_number":"202027"
                }
            ],
            "online_url": "https://******************",
            "files": [
                {
                    "fileId": 0,
                    "fileName": "lQDPJxbNB2PSEfzNBhjNCgCwfX6K-7mVbG8DUPxProDOAA_2560_1560.jpg",
                    "src": "/upload/ocr/2022/11/01100733-803628-1781.jpg",
                    "fileSize": 434582,
                    "fileType": "jpg",
                    "relation_type": 11,
                    "spaceId": 0,
                    "add_time": "2022-11-01 10:07",
                    "url": "http://*****.jpg"
                }
            ],
            "rush_red" : "FSJQsjqVj",
            "invoice_info": "数电测试可开票"
        }
    ],
    "count":18,
    "errcode":0,
    "errmsg":"请求成功",
    "request_id":"0738665a3bd8a014c63a6944c7abf73a",
    "env":"zkgj-dev"
}


合同付款


创建合同付款

Request

Url
[POST] : https://eapi.paiago.com/ZKGJ/currentAccount/Payment/Add/?access_token=ffc50044897a74c14b47a75
请求参数:
参数 类型 必填 描述 示例
supplier_id string 供应商id FzNxCk700
add_user string 创建人id XxSNJ00Cj
pay_date string 付款日期 2021-04-23
arrival_amount string 到账金额 2.00
discount_money string 抵扣金额 2.00
bill_code string 单据编号
telephone string 联系人电话
(废弃)
remark string 备注 备注
account_id string 收款账户id WiiiJmSy0
payment_id string 付款账户id
account_definaccount string 账户名称
account_code string 账户信息
account_mechanism string 开户机构
child_list array(object) 关联合同
 > contract_id string 合同id XieyNjaC7
 > arrival_money string 合同到账金额 0.01
 > discount_money string 合同抵扣金额 0.01
请求示例:
[
    {
        "supplier_id":"XiSSysggj",
        "pay_date":"2021-05-18",
        "arrival_amount":"433.00",
        "bill_code":"123456",
        "remarks":"备注",
        "discount_money":"0.00",
        "add_user":"lNmq7sCC0",
        "account_definaccount":"支付宝账户",
        "account_code":"支付宝账号",
        "account_mechanism":"1121111",
        "account_id":"PSxNxNaqk",
        "payment_id":"XiSmzssV0",
        "child_list":[
            {
                "contract_id":"FxxN0jCV7",
                "arrival_money":"400.00",
                "discount_money":0.00
            },
            {
                "contract_id":"FJiS0jCkV",
                "arrival_money":"33.00",
                "discount_money":0.00
            }
        ]
    }
]

Response

响应参数
参数 描述 类型 示例
errcode 错误码 int
errmsg 错误信息 string
响应示例:
{
    "data": [],
    "errcode": 0,
    "errmsg": "请求成功",
    "request_id": null,
    "env": "zkgj-cs"
}

合同付款列表

Request

Url
[POST] : https://eapi.paiago.com/ZKGJ/currentAccount/Payment/?access_token=ffc50044897a74c14b47a75
请求参数:
参数 类型 描述 示例
Field array 请求字段 []
  > id string 合同付款id
  > supplier_definition string 供应商名称
  > supplier_id string 供应商id
  > pay_date string 付款日期
  > arrival_amount string 付款金额
  > bill_code string 单据编号
  > payment_account string 付款账户
  > supplier_account string 收款账户
  > supplier_account_name string 收款账户(仅户名)
  > add_date number 创建日期
  > remarks string 备注
  > add_user string 创建人id
  > apply_name string 申请人名称
  > contract_id string 合同id
  > arrival_money string 到账金额
  > discount_money string 折扣金额
  > returning_amount string 核销金额
  > contract string 合同名称
  > contract_number string 合同编号
  > project string 所属项目
  > files string 附件信息
  > submit_info string 线上付款时, 提交的付款信息

| Order | array | 排序规则 | |
| Where | array | 查询条件 | |
| Page | number | 页数 |0| |
| ListRow | number | 条数 |20|

请求示例:
{
    "Field":[
        "supplier_definition",
        "supplier_id",
        "pay_date",
        "arrival_amount",
        "bill_code",
        "payment_account",
        "supplier_account",
        "supplier_account_name",
        "add_date",
        "remarks",
        "add_user",
        "contract_id",
        "arrival_money",
        "discount_money",
        "returning_amount",
        "contract",
        "contract_number",
        "project",
        "id",
        "files",
        "submit_info"
    ],
    "Order":{
        "id":"desc"
    },
    "Where":[
        {
            "filed":"payment_account",
            "factor":"like",
            "value":"880309"
        }
    ],
    "Page":1,
    "ListRow":3
}

Response

响应参数
参数 描述 类型 示例
count 总数 int
data 列表(详见请求Field释义) array(object)
响应示例:
{
    "data":[
        {
            "supplier_definition":"供应商名称",
            "supplier_id":"XiSSysggj",
            "pay_date":"2022-05-25",
            "arrival_amount":"-800.00",
            "bill_code":"",
            "payment_account":"户名 622878803094345",
            "supplier_account":null,
            "supplier_account_name":null,
            "add_date":1653461785,
            "remarks":"",
            "add_user":"WiiiJmSy0",
            "contract_id":"FzeNsagq7",
            "arrival_money":"-800.00",
            "discount_money":"0.00",
            "returning_amount":"-800.00",
            "contract":"测试分摊合同-1",
            "contract_number":"PF2022022200025",
            "project":"",
            "id":"Feym0gasC",
            "files": [
                {
                    "fileId": 0,
                    "fileName": "lALPD26ePbBls77NAkPNA5g_920_579.png_720x720q90g.jpg",
                    "src": "cs/9844/804109/ae3cc379845966988a3b00419f149801.jpg",
                    "fileSize": 72151,
                    "fileType": "jpg",
                    "relation_type": 14,
                    "spaceId": null,
                    "add_time": "2024-06-28 10:42",
                    "url": "https://*****"
                }
            ],
            "submit_info": [
                {
                    "payment_id": "XNemJ07gq",
                    "payment_data": "2024-06-27",
                    "remark": "2222",
                    "is_tenpay": 3,
                    "jump_url": "",
                    "dodu_change": "0",
                    "dodu_details": [],
                    "payment_list_id": "FQxxCkskC",
                    "dowload_status": 1,
                    "dowload_url": "https://***********"
                }
            ]
        }
    ],
    "count":26,
    "errcode":0,
    "errmsg":"请求成功",
    "request_id":null,
    "env":"zkgj-cs"
}

合同回款


回款列表

Request

Url
[POST] : https://eapi.paiago.com/ZKGJ/currentAccount/Collection/?access_token=ffc50044897a74c14b47a75
请求参数:
参数 类型 描述 示例
Field array 请求字段 []
  > id string 回款id
  > advance_money string 预收款金额
  > remark string 备注
  > account_id string 收款账户id
  > return_money string 回款金额
  > arrival_date string 回款日期
  > customer_id string 客户id
  > customer string 客户名称
  > payment_method string 户名
  > bank_name string 开户银行
  > custom_account string 开户账号
  > discount_money string 折让金额
  > arrival_money string 到账金额
  > contract_id string 合同id
  > contract string 合同名称
  > contract_number string 合同编号
  > contract_date string 合同日期
  > contract_money string 合同金额
  > add_user string 添加人id
  > add_date string 添加时间
  > project string 所属项目
  > billing_list string 发票数据
   > bill_id string 发票id
   > billing_code string 发票号码
   > billing_encoded string 发票代码
   > billing_date string 发票日期
   > billing_price string 发票金额
Order array 排序规则
Where array 查询条件
Page number 页数 0
ListRow number 条数 20
请求示例:
{
    "Field":[
        "customer_id",
        "customer",
        "account_id",
        "custom_account",
        "arrival_date",
        "return_money",
        "advance_money",
        "remark",
        "add_user",
        "add_date",
        "contract_id",
        "contract",
        "contract_number",
        "arrival_money",
        "contract_date",
        "contract_money",
        "add_user",
        "add_date",
        "discount_money",
        "arrival_money",
        "project",
        "payment_method",
        "bank_name",
        "custom_account",
        "billing_list"
    ],
    "Order":[

    ],
    "Where":[

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

Response

响应参数
参数 描述 类型 示例
count 总数 int
data 列表(详见请求Field释义) array(object)
响应示例:
{
    "data":[
        {
            "customer_id":"FyiiCa7qC",
            "customer":"五月",
            "account_id":"XxyQx007V",
            "custom_account":"622878803094345",
            "arrival_date":"2022-05-25",
            "return_money":"1.00",
            "advance_money":"0.00",
            "remark":"",
            "add_user":"WiiiJmSy0",
            "add_date":1653446348,
            "contract_id":"lSi0kVqjj",
            "contract":"数值自定义",
            "contract_number":"PTxt00095首发式发生",
            "arrival_money":"1.00",
            "contract_date":"2022-05-25",
            "contract_money":"11.00",
            "discount_money":"0.00",
            "project":"",
            "payment_method":"户名",
            "bank_name":"杭州商业银行",
            "id":"lzJ0Cj7g0",
            "billing_list": [
                {
                    "bill_id": "FzSNs0s0j",
                    "receivable_id": "lNm0CqsCs",
                    "billing_code": "79084301",
                    "billing_encoded": "",
                    "billing_date": "2022-06-07",
                    "billing_price": "18.19"
                }
            ]
        }
    ],
    "count":512,
    "errcode":0,
    "errmsg":"请求成功",
    "request_id":null,
    "env":"zkgj-cs"
}

新建回款

Request

Url
[POST] : https://eapi.paiago.com/ZKGJ/currentAccount/Collection/Add/?access_token=ffc50044897a74c14b47a75
请求参数:
参数 类型 必填 描述 示例
customer_id string 客户id FzNxCk700
account_id string 账户id XxSNJ00Cj
arrival_date string 核销日期 2021-04-23
return_money number 回款金额 2.00
advance_money number 预收款金额
(废弃)
1.00
remark string 备注 备注
add_user string 创建人id WiiiJmSy0
add_date string 添加日期
(废弃)
2021-01-01
contract array(object) 关联合同
 > contract_id string 合同id XieyNjaC7
 > arrival_money number 到账金额 0.01
 > discount_money number 抵扣金额 0.01
请求示例:
[
    {
        "customer_id":"FzNxCk700",
        "account_id":"XxSNJ00Cj",
        "arrival_date":"2021-04-23",
        "return_money":"9",
        "advance_money":"2",
        "remark":"备注beizhu",
        "add_user":"WiiiJmSy0",
        "add_date":"2021-04-23",
        "contract":[
            {
                "contract_id":"liN0kjCV7",
                "arrival_money":"2",
                "discount_money":"0"
            },
            {
                "contract_id":"lJz0kjCV0",
                "arrival_money":"2",
                "discount_money":"0"
            }
        ]
    }
]

Response

响应参数
参数 描述 类型 示例
errcode 错误码 int
errmsg 错误信息 string
响应示例:
{
    "data": [],
    "errcode": 0,
    "errmsg": "请求成功",
    "request_id": null,
    "env": "zkgj-cs"
}

合同(应付丨采购)


业务类型列表

Request

Url
[POST] : https://eapi.paiago.com/ZKGJ/getContractTypeList?access_token=ffc50044897a74c14b47a75
请求参数:
参数 类型 描述 示例
Field array 请求字段 []
  > id string 计划类型id
  > type_name string 计划类型名称
  > type number 业务类型 1:应收合同模板-普通业务;
2:应收合同模板-周期业务;
3:应收合同模板-框架业务;
4:应付合同模板-普通合同;
5:应付合同模板-框架合同;
  > add_time number 添加时间
Order array 排序规则
Where array 查询条件
Page number 页数 0
ListRow number 条数 20
请求示例:
{
    "Field": [
        "id",
        "type_name",
        "add_time",
        "type"
    ],
    "Order": {
        "id": "desc"
    },
    "Where": [
        {
            "filed": "type",
            "factor": "in",
            "value": "1,2,3"
        }
    ],
    "Page": 0,
    "ListRow": 10
}

Response

响应参数
参数 描述 类型 示例
count 总数 int
data 列表(详见请求Field释义) array(object)
响应示例:
{
    "data":[
        {
            "id":"PSSQiyC7s",
            "type_name":"普通业务",
            "add_time":1604472626,
            "type":1
        },
        {
            "id":"UJJNNNSqa",
            "type_name":"框架业务",
            "add_time":1600851713,
            "type":3
        },
        {
            "id":"USSxiyxqs",
            "type_name":"周期业务",
            "add_time":1600851713,
            "type":2
        }
    ],
    "count":3,
    "errcode":0,
    "errmsg":"请求成功",
    "request_id":null,
    "env":"zkgj-dev"
}

合同列表

Request

Url
[POST] : https://eapi.paiago.com/ZKGJ/Contract/Payable/?access_token=ffc50044897a74c14b47a75
请求参数:
参数 类型 描述 示例
Field array 请求字段 []
  > id string 合同id
  > name string 合同名称
  > number string 合同编号
  > money string 合同金额
  > date string 合同日期
  > remark string 备注
  > status string 合同状态
  > supplier_id string 供应商id
  > supplier_name string 供应商名称
  > followup_id string 经办人id
  > followup_depart string 经办人id
  > followup_name string 经办人名称
  > depart_name string 经办人所属部门
  > label_id string 合同标签id
  > label_list string 合同标签列表
  > maturity_date string 合同到期日期
  > add_user string 创建人id
  > add_date number 创建时间
  > project string 所属项目
  > project_ids string 所属项目id
Order array 排序规则
Where array 查询条件
Page number 页数 0
ListRow number 条数 20
请求示例:
{
    "Field":[
        "id",
        "name",
        "number",
        "money",
        "date",
        "remark",
        "status",
        "supplier_id",
        "supplier_name",
        "followup_id",
        "followup_name",
        "followup_depart",
        "depart_name",
        "label_id",
        "label_list",
        "project",
        "project_ids",
        "maturity_date",
        "add_user",
        "add_date"
    ],
    "Order":{
        "add_date":"desc"
    },
    "Where":[
        {
            "filed":"depart_name",
            "factor":"like",
            "value":"婆"
        }
    ],
    "Page":1,
    "ListRow":2
}

Response

响应参数
参数 描述 类型 示例
count 总数 int
data 列表(详见请求Field释义) array(object)
响应示例:
{
    "data":[
        {
            "id":"Fzeisks70",
            "name":"23撒发射点发",
            "number":"2123",
            "money":"23.00",
            "date":"2022-03-16",
            "remark":"",
            "status":"已完成",
            "supplier_id":"XiSSysggj",
            "supplier_name":"供应商名称",
            "followup_id":"liiq7007j",
            "followup_name":"李*燕",
            "followup_depart":"liiq7007j",
            "depart_name":null,
            "label_id":"PNNmxJC07,PNNizmsqj",
            "label_list":"合同退款优化>_<dr2",
            "project": "项目二,项目一",
            "project_ids": "lemCs7j0C,XziSmsasg"
            "maturity_date":null,
            "add_user":"liyq7sks0",
            "add_date":1647429888
        }
    ],
    "count":1,
    "errcode":0,
    "errmsg":"请求成功",
    "request_id":null,
    "env":"zkgj-cs"
}

合同标签列表

Request

Url
[POST] : https://eapi.paiago.com/ZKGJ/Contract/Payable/Label/?access_token=ffc50044897a74c14b47a75
请求参数:
参数 类型 描述 示例
Field array 请求字段 []
  > id string 标签id
  > name string 标签名称
Order array 排序规则
Where array 查询条件
Page number 页数 0
ListRow number 条数 20
请求示例:
{
    "Field":[
        "id",
        "name"
    ],
    "Order":{
        "id":"desc"
    },
    "Where":[
        {
            "filed":"name",
            "factor":"like",
            "value":" "
        }
    ],
    "Page":1,
    "ListRow":1
}

Response

响应参数
参数 描述 类型 示例
count 总数 int
data 列表(详见请求Field释义) array(object)
响应示例:
{
    "data":[
        {
            "id":"PiJQeN0qj",
            "name":"因婆婆"
        }
    ],
    "count":5,
    "errcode":0,
    "errmsg":"请求成功",
    "request_id":null,
    "env":"zkgj-cs"
}

合同模板列表

Request

Url
[POST] : https://eapi.paiago.com/ZKGJ/getContractTemplateList?access_token=ffc50044897a74c14b47a75
请求参数:
参数 类型 描述 示例
Field array 请求字段 []
  > id string 计划类型id
  > type_name string 计划类型名称
  > type number 业务类型 1:应收合同模板-普通业务;
2:应收合同模板-周期业务;
3:应收合同模板-框架业务;
4:应付合同模板-普通合同;
5:应付合同模板-框架合同;
  > description string 模板说明
  > is_system number 是否系统模板 1:是系统模板
0:不是系统模板
  > is_enable number 是否启用: 0:不启用;
1:启用
  > feature_pack number 功能套件(普通模板) 0:无,
1:发货套件,
2:结算套件
3:其他套件
  > prefix_number number 前缀编号
  > add_time number 添加时间
  > update_time number 更新时间
Order array 排序规则
Where array 查询条件
Page number 页数 0
ListRow number 条数 20
请求示例:
{
    "Field": [
        "id",
        "type_name",
        "type",
        "description",
        "is_system",
        "is_enable",
        "add_time",
        "update_time",
        "feature_pack",
        "prefix_number"
    ],
    "Order": {
        "id": "desc"
    },
    "Where": [
        {
            "filed": "is_enable",
            "factor": "=",
            "value": "1"
        },
        {
            "filed": "type",
            "factor": "=",
            "value": "1"
        }
    ],
    "Page": 0,
    "ListRow": 10
}

Response

响应参数
参数 描述 类型 示例
count 总数 int
data 列表(详见请求Field释义) array(object)
响应示例:
{
    "data":[
        {
            "id":"Xmimm0kjk",
            "type_name":"测试123",
            "type":1,
            "description":"",
            "is_system":0,
            "is_enable":1,
            "update_time":1648881703,
            "feature_pack":0,
            "prefix_number":"CSaa"
        }
    ],
    "count":107,
    "errcode":0,
    "errmsg":"请求成功",
    "request_id":null,
    "env":"zkgj-dev"
}

回款计划生成方式列表

Request

Url
[POST] : https://eapi.paiago.com/ZKGJ/getPaymentConditionList?access_token=ffc50044897a74c14b47a75
请求参数:
参数 类型 描述 示例
Field array 请求字段 []
  > id string 生成方式id
  > title string 生成方式名称
  > type number 类型:
1:合同签订后生成回款计划
2:开票后生成回款计划
3:结算后生成回款计划
4:发货后生成回款计划
5:创建合同时,手动添加回款计划
  > condition_describe string 描述
  > condition_status number 状态 0:未启用
1:启用
Order array 排序规则
Where array 查询条件
Page number 页数 0
ListRow number 条数 20
请求示例:
{
    "Field": [
        "id",
        "type",
        "title",
        "describe",
        "type_status"
    ],
    "Order": {
        "id": "desc"
    },
    "Where": [],
    "Page": 0,
    "ListRow": 1
}

Response

响应参数
参数 描述 类型 示例
count 总数 int
data 列表(详见请求Field释义) array(object)
响应示例:
{
    "data":[
        {
            "id":"WSSSxNQzk",
            "type":5,
            "title":"创建合同时,手动添加回款计划",
            "type_status":0
        }
    ],
    "count":5,
    "errcode":0,
    "errmsg":"请求成功",
    "request_id":null,
    "env":"zkgj-dev"
}

新增合同

Request

Url
[POST] : https://eapi.paiago.com/ZKGJ/Contract/Payable/Add/?access_token=ffc50044897a74c14b47a75
Rule
请求参数:
参数 类型 必填 描述 示例
name string 合同名称
number string 合同编号
money string 合同金额
contract_date string 合同日期 2021-04-23
maturity_date string 到期日期 2021-04-23
leader string 合同跟进人id 从供应商负责人中取,
供应商无负责人任意人员
add_user string 创建人id
label string 合同标签id 多标签以,分割
supplier number 供应商id
project string 项目id 多项目以,分割
payment_plan array(object) 回款计划
  > plan_date string 计划回款时间 2021-04-23
  > plan_type string 计划类型 1:常规
2:首款
3:质保金
4:尾款
或计划类型列表id值
  > type_name string 计划类型名称
  > plan_ratio number 计划金额比例 0.00~100.00
  > plan_money number 计划金额 合同金额*计划金额比例/100
  > currency_plan_money number 外币计划金额 计划金额*外币汇率
(目前仅支持人民币,
外币汇率默认为1)
  > plan_remark string 计划备注
自定义字段名称1 string 自定义字段值1
自定义字段名称2 string 自定义字段值2
请求示例:
[
    {
        "name":"test",
        "number":"XXXXXXX-2",
        "money":"11",
        "contract_date":"2021-05-13",
        "maturity_date":"2021-12-13",
        "leader":"lNmq7s0Ck",
        "add_user":"WiiiJmSy0",
        "supplier":"XNJmmagaj",
        "label":"PiJQeN0qj,PNNmxJC07,PSSeQxsqV",
        "project":"PiJQeN2qj,PNNmx2C07",
        "payment_plan": [
            {
                "plan_date": "2022-05-13",
                "plan_type": "1",
                "type_name": "常规",
                "plan_ratio": 1,
                "plan_money": 0.01,
                "currency_plan_money": 0.01,
                "plan_remark": "1"
            }
        ],
        "自定义字段名称1":"自定义字段值1",
        "自定义字段名称2":"自定义字段值2"
    }
]

Response

响应参数
参数 描述 类型 示例
errcode 错误码 int
errmsg 错误信息 string
响应示例:
{
    "data":[

    ],
    "errcode":0,
    "errmsg":"请求成功",
    "request_id":null,
    "env":"zkgj-cs"
}

计划类型列表

Request

Url
[POST] : https://eapi.paiago.com/ZKGJ/getPaymentTypeList?access_token=ffc50044897a74c14b47a75
请求参数:
参数 类型 描述 示例
Field array 请求字段 []
  > id string 计划id
  > company_id string 所属公司id
  > type_name string 计划类型名称
  > is_system number 是否系统字段 1、系统字段
0、非系统字段
  > status number 1启用
2禁用
Order array 排序规则
Where array 查询条件
Page number 页数 0
ListRow number 条数 20
请求示例:
{
    "Field":[
        "id",
        "company_id",
        "type_name",
        "is_system",
        "status"
    ],
    "Order":{
        "id":"desc"
    },
    "Where":[

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

Response

响应参数
参数 描述 类型 示例
count 总数 int
data 列表(详见请求Field释义) array(object)
响应示例:
{
    "data":[
        {
            "id":"PiJJeN0sg",
            "company_id":"UNNNmzJ0k",
            "type_name":"111111",
            "is_system":0,
            "status":1
        }
    ],
    "count":10,
    "errcode":0,
    "errmsg":"请求成功",
    "request_id":null,
    "env":"zkgj-dev"
}

合同(应收丨销售)


业务类型列表

Request

Url
[POST] : https://eapi.paiago.com/ZKGJ/getContractTypeList?access_token=ffc50044897a74c14b47a75
请求参数:
参数 类型 描述 示例
Field array 请求字段 []
  > id string 计划类型id
  > type_name string 计划类型名称
  > type number 业务类型 1:应收合同模板-普通业务;
2:应收合同模板-周期业务;
3:应收合同模板-框架业务;
4:应付合同模板-普通合同;
5:应付合同模板-框架合同;
  > add_time number 添加时间
Order array 排序规则
Where array 查询条件
Page number 页数 0
ListRow number 条数 20
请求示例:
{
    "Field": [
        "id",
        "type_name",
        "add_time",
        "type"
    ],
    "Order": {
        "id": "desc"
    },
    "Where": [
        {
            "filed": "type",
            "factor": "in",
            "value": "1,2,3"
        }
    ],
    "Page": 0,
    "ListRow": 10
}

Response

响应参数
参数 描述 类型 示例
count 总数 int
data 列表(详见请求Field释义) array(object)
响应示例:
{
    "data":[
        {
            "id":"PSSQiyC7s",
            "type_name":"普通业务",
            "add_time":1604472626,
            "type":1
        },
        {
            "id":"UJJNNNSqa",
            "type_name":"框架业务",
            "add_time":1600851713,
            "type":3
        },
        {
            "id":"USSxiyxqs",
            "type_name":"周期业务",
            "add_time":1600851713,
            "type":2
        }
    ],
    "count":3,
    "errcode":0,
    "errmsg":"请求成功",
    "request_id":null,
    "env":"zkgj-dev"
}

删除合同

Request

Url
[DELETE] : https://eapi.paiago.com/ZKGJ/Contract/Receivable/Delete/?access_token=ffc50044897a74c14b47a75
Rule
请求参数:
参数 类型 必填 描述 示例
array(String) id数组
  > string id
请求示例:
[
    "FNSNajCaC",
    "FxzmaVVaV"
]

Response

响应参数
参数 描述 类型 示例
errcode 错误码 int
errmsg 错误信息 string
响应示例:
{
    "data": [],
    "errcode": 0,
    "errmsg": "请求成功",
    "request_id": "0c8b3505861e355973e410ac78dd3fc2",
    "env": "zkgj-dev"
}

合同列表

Request

Url
[POST] : https://eapi.paiago.com/ZKGJ/Contract/Receivable/?access_token=ffc50044897a74c14b47a75
请求参数:
参数 类型 描述 示例
Field array 请求字段 []
  > id string 合同id
  > contract_name string 合同名称
  > contract_number string 合同编号
  > contract_money string 合同金额
  > receivable_money string 回款金额
  > no_receivable_money string 未回款金额
  > contract_date string 合同日期
  > maturity_date string 到期日期(非必填)
  > label_id string 合同标签id集合
  > customer_id string 客户Id
  > customer_name string 客户名称
  > leader_id string 合同跟进人id 从客户负责人中取,
客户无负责人任意人员
  > followup_depart_id string 部门id
  > followup_depart_name string 部门名称
  > add_user string 创建人id
  > add_date string 创建时间
  > labels string 合同标签名称
  > project string 关联项目
  > project_ids string 关联项目id
Order array 排序规则
Where array 查询条件
Page number 页数 0
ListRow number 条数 20
请求示例:
{
    "Field":[
        "id",
        "contract_name",
        "contract_number",
        "contract_money",
        "receivable_money",
        "no_receivable_money",
        "contract_date",
        "maturity_date",
        "label_id",
        "customer_id",
        "customer_name",
        "leader_id",
        "followup_depart_id",
        "followup_depart_name",
        "add_user",
        "add_date",
        "labels",
        "project",
        "project_ids"
    ],
    "Order":{
        "id": "desc"
    },
    "Where":[

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

Response

响应参数
参数 描述 类型 示例
count 总数 int
data 列表(详见请求Field释义) array(object)
响应示例:
{
    "data":[
        {
            "id":"WiiiJmSy0",
            "contract_name":"小明的普通合同",
            "contract_number":"123456789",
            "contract_money":"1000.00",
            "receivable_money":"600.00",
            "no_receivable_money":"400.00",
            "contract_date":"2021-09-01",
            "maturity_date":null,
            "label_id":"1,2",
            "customer_id":2,
            "customer_name":null,
            "leader_id":801114,
            "followup_depart_id":27969133,
            "followup_depart_name":null,
            "add_user":801114,
            "add_date":1505186235,
            "labels":"北京欢迎你,给一个理由",
            "project":" 添加项目统计数据4,新建项目123",
            "project_ids": "lemCs7j0C,XziSmsasg"
        }
    ],
    "count":519,
    "errcode":0,
    "errmsg":"请求成功",
    "request_id":null,
    "env":"zkgj-cs"
}

合同模板列表

Request

Url
[POST] : https://eapi.paiago.com/ZKGJ/getContractTemplateList?access_token=ffc50044897a74c14b47a75
请求参数:
参数 类型 描述 示例
Field array 请求字段 []
  > id string 计划类型id
  > type_name string 计划类型名称
  > type number 业务类型 1:应收合同模板-普通业务;
2:应收合同模板-周期业务;
3:应收合同模板-框架业务;
4:应付合同模板-普通合同;
5:应付合同模板-框架合同;
  > description string 模板说明
  > is_system number 是否系统模板 1:是系统模板
0:不是系统模板
  > is_enable number 是否启用: 0:不启用;
1:启用
  > feature_pack number 功能套件(普通模板) 0:无,
1:发货套件,
2:结算套件
3:其他套件
  > prefix_number number 前缀编号
  > add_time number 添加时间
  > update_time number 更新时间
Order array 排序规则
Where array 查询条件
Page number 页数 0
ListRow number 条数 20
请求示例:
{
    "Field": [
        "id",
        "type_name",
        "type",
        "description",
        "is_system",
        "is_enable",
        "add_time",
        "update_time",
        "feature_pack",
        "prefix_number"
    ],
    "Order": {
        "id": "desc"
    },
    "Where": [
        {
            "filed": "is_enable",
            "factor": "=",
            "value": "1"
        },
        {
            "filed": "type",
            "factor": "=",
            "value": "1"
        }
    ],
    "Page": 0,
    "ListRow": 10
}

Response

响应参数
参数 描述 类型 示例
count 总数 int
data 列表(详见请求Field释义) array(object)
响应示例:
{
    "data":[
        {
            "id":"Xmimm0kjk",
            "type_name":"测试123",
            "type":1,
            "description":"",
            "is_system":0,
            "is_enable":1,
            "update_time":1648881703,
            "feature_pack":0,
            "prefix_number":"CSaa"
        }
    ],
    "count":107,
    "errcode":0,
    "errmsg":"请求成功",
    "request_id":null,
    "env":"zkgj-dev"
}

回款计划生成方式列表

Request

Url
[POST] : https://eapi.paiago.com/ZKGJ/getPaymentConditionList?access_token=ffc50044897a74c14b47a75
请求参数:
参数 类型 描述 示例
Field array 请求字段 []
  > id string 生成方式id
  > title string 生成方式名称
  > type number 类型:
1:合同签订后生成回款计划
2:开票后生成回款计划
3:结算后生成回款计划
4:发货后生成回款计划
5:创建合同时,手动添加回款计划
  > condition_describe string 描述
  > condition_status number 状态 0:未启用
1:启用
Order array 排序规则
Where array 查询条件
Page number 页数 0
ListRow number 条数 20
请求示例:
{
    "Field": [
        "id",
        "type",
        "title",
        "describe",
        "type_status"
    ],
    "Order": {
        "id": "desc"
    },
    "Where": [],
    "Page": 0,
    "ListRow": 1
}

Response

响应参数
参数 描述 类型 示例
count 总数 int
data 列表(详见请求Field释义) array(object)
响应示例:
{
    "data":[
        {
            "id":"WSSSxNQzk",
            "type":5,
            "title":"创建合同时,手动添加回款计划",
            "type_status":0
        }
    ],
    "count":5,
    "errcode":0,
    "errmsg":"请求成功",
    "request_id":null,
    "env":"zkgj-dev"
}

新增、编辑合同

Request

Url
[POST] : https://eapi.paiago.com/ZKGJ/Contract/Receivable/Add/?access_token=ffc50044897a74c14b47a75
Rule
请求参数:
参数 类型 必填 描述 示例
id number 合同id 编辑合同时,请传入合同id
编辑时需要传入所有字段信息,包含不需要编辑的,漏传会将数据置空
contract_type number 合同类型 1:普通业务;
(只支持普通业务合同)
2:周期业务;
3:框架业务
contract_name string 合同名称
contract_number string 合同编号
contract_money string 合同金额
contract_date string 合同日期 2021-04-23
maturity_date string 到期日期 2021-04-23
customer_id string 客户Id
leader_id string 合同跟进人id 从客户负责人中取,
客户无负责人任意人员
project string 项目id 多项目以,分割
add_user string 创建人id
add_date string 创建时间
payment_type number 回款计划生成方式 1(目前仅支持为1)
payment_plan array(object) 回款计划
  > plan_date string 计划回款时间 2021-04-23
  > plan_type string 计划类型 1:常规
2:首款
3:质保金
4:尾款
或计划类型列表id值
  > type_name string 计划类型名称
  > plan_ratio number 计划金额比例 0.00~100.00
  > plan_money number 计划金额 合同金额*计划金额比例/100
  > currency_plan_money number 外币计划金额 计划金额*外币汇率
(目前仅支持人民币,
外币汇率默认为1)
  > plan_remark string 计划备注
自定义字段名称1 string 自定义字段值1
自定义字段名称2 string 自定义字段值2
请求示例:
[
    {
        "contract_type": 1,
        "contract_name": "Api测试合同",
        "contract_number": "182001",
        "contract_money": "100",
        "contract_date": "2021-04-23",
        "maturity_date": "2022-04-23",
        "customer_id": "abcdefghi",
        "leader_id": "AAAAAAAAA",
        "project":"PiJQeN2qj,PNNmx2C07",
        "add_user": "AAAAAAAAA",
        "add_date": "2021-04-23",
        "payment_plan": [
            {
                "plan_date": "2022-05-13",
                "plan_type": "1",
                "type_name": "常规",
                "plan_ratio": 1,
                "plan_money": 0.01,
                "currency_plan_money": 0.01,
                "plan_remark": "1"
            }
        ],
        "payment_type": 1,
        "自定义字段名称1":"自定义字段值1",
        "自定义字段名称2":"自定义字段值2"
    }
]

Response

响应参数
参数 描述 类型 示例
errcode 错误码 int
errmsg 错误信息 string
响应示例:
{
    "data": [],
    "errcode": 0,
    "errmsg": "请求成功",
    "request_id": "0c8b3505861e355973e410ac78dd3fc2",
    "env": "zkgj-dev"
}

计划类型列表

Request

Url
[POST] : https://eapi.paiago.com/ZKGJ/getPaymentTypeList?access_token=ffc50044897a74c14b47a75
请求参数:
参数 类型 描述 示例
Field array 请求字段 []
  > id string 计划id
  > company_id string 所属公司id
  > type_name string 计划类型名称
  > is_system number 是否系统字段 1、系统字段
0、非系统字段
  > status number 1启用
2禁用
Order array 排序规则
Where array 查询条件
Page number 页数 0
ListRow number 条数 20
请求示例:
{
    "Field":[
        "id",
        "company_id",
        "type_name",
        "is_system",
        "status"
    ],
    "Order":{
        "id":"desc"
    },
    "Where":[

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

Response

响应参数
参数 描述 类型 示例
count 总数 int
data 列表(详见请求Field释义) array(object)
响应示例:
{
    "data":[
        {
            "id":"PiJJeN0sg",
            "company_id":"UNNNmzJ0k",
            "type_name":"111111",
            "is_system":0,
            "status":1
        }
    ],
    "count":10,
    "errcode":0,
    "errmsg":"请求成功",
    "request_id":null,
    "env":"zkgj-dev"
}

客户


删除客户

Request

Url
[POST] : https://eapi.paiago.com/ZKGJ/Intercourse/Customer/Delete/?access_token=ffc50044897a74c14b47a75
Rule
请求参数:
参数 类型 必填 描述 示例
array(String) id数组
  > string id
请求示例:
[
    "FNSNajCaC",
    "FxzmaVVaV"
]

Response

响应参数
参数 描述 类型 示例
errcode 错误码 int
errmsg 错误信息 string
响应示例:
{
    "data": [],
    "errcode": 0,
    "errmsg": "请求成功",
    "request_id": "0c8b3505861e355973e410ac78dd3fc2",
    "env": "zkgj-dev"
}

客户列表

Request

Url
[POST] : https://eapi.paiago.com/ZKGJ/Intercourse/Customer/?access_token=ffc50044897a74c14b47a75
请求参数:
参数 类型 描述 示例
Field array 请求字段 []
  > id string 客户id
  > customer_name string 客户名称
  > customer_number string 客户编号
  > customer_nature number 客户性质 1:个人,
2:企业,
3:政府事业单位
  > industry string 所属行业id
  > province string
  > city string
  > area string
  > custom_address string 办公地址
  > add_user string 创建人id
  > add_date number 创建时间
  > invoice_information string 开票信息
  > mail_information string 邮寄信息
  > leader string 负责人
Order array 排序规则
Where array 查询条件
Page number 页数 0
ListRow number 条数 20
请求示例:
{
    "Field":[
        "customer_name",
        "customer_number",
        "customer_nature",
        "id",
        "industry",
        "province",
        "city",
        "area",
        "custom_address",
        "add_user",
        "add_date",
        "invoice_information",
        "mail_information",
        "leader"
    ],
    "Order":{
        "id":"desc"
    },
    "Where":[

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

Response

响应参数
参数 描述 类型
count 总数 int
data 列表(参数释义同请求Field释义) array(object)
  > invoice_information array(object) 开票信息
   >> id string 开票信息id
   >> relation_id string 客户id
   >> invoice_header string 发票抬头
   >> bank_name string 开户银行
   >> bank_number string 银行账号
   >> address string 地址
   >> tel string 电话
   >> is_default number 是否默认
   >> identifier string 统一社会信用代码
  > mail_information array(object) 邮寄信息
   >> id string 邮寄信息id
   >> province string
   >> city string
   >> area string
   >> mail_address string 详细邮寄地址
   >> recipient string 收件人
   >> mailbox string 接收人邮箱
   >> telephone string 电话
   >> is_default string 是否默认
   >> relation_id string 客户id
  > leader array(object) 负责人
   >> leader_id string 负责人id
   >> custom_id string 客户id
   >> leader_name string 负责人姓名
响应示例:
{
    "data":[
        {
            "customer_name":"123123",
            "customer_number":"123123123",
            "customer_nature":2,
            "id":"FzNNCa7jq",
            "industry":"WiiiJmSy0",
            "province":"北京市",
            "city":"市辖区",
            "area":"东城区",
            "custom_address":"123123",
            "add_user":"WiiiJmSy0",
            "add_date":1653286594,
            "invoice_information":[
                {
                    "id":"XNmxxC0sg",
                    "relation_id":"FzNNCa7jq",
                    "invoice_header":"xxxxxxxxx",
                    "bank_name":"1dsdfdf",
                    "bank_number":"1121212121212",
                    "address":"fdgdfgdfgdf",
                    "tel":"1212121212",
                    "is_default":1,
                    "identifier":"123123123123123123"
                }
            ],
            "mail_information":[
                {
                    "id":"XJeNy0qqq",
                    "province":"北京市",
                    "city":"市辖区",
                    "area":"东城区",
                    "mail_address":"123123",
                    "recipient":"12312",
                    "mailbox":"",
                    "telephone":"123123",
                    "is_default":"1",
                    "relation_id":"FzNNCa7jq"
                },
                {
                    "id":"XSQzi0qqg",
                    "province":"北京市",
                    "city":"北京市",
                    "area":"大兴区",
                    "mail_address":"22222",
                    "recipient":"2222",
                    "mailbox":"111@1.com",
                    "telephone":"22222",
                    "is_default":"0",
                    "relation_id":"FzNNCa7jq"
                }
            ],
            "leader":[
                {
                    "custom_id":"FzNNCa7jq",
                    "leader_id":"lSSq7007k",
                    "leader_name":"惠汹冰"
                },
                {
                    "custom_id":"FzNNCa7jq",
                    "leader_id":"liiq7007j",
                    "leader_name":"李*燕"
                }
            ]
        }
    ],
    "count":72,
    "errcode":0,
    "errmsg":"请求成功",
    "request_id":null,
    "env":"zkgj-cs"
}

客户收款条件

Request

Url
[POST] : https://eapi.paiago.com/ZKGJ/getCustomCollectionTerms?access_token=ffc50044897a74c14b47a75
请求参数:
参数 类型 必填 描述 示例
custom_id string 客户id
template_id array 模板id
请求示例:
{
    "custom_id":"FJSNkksgk",
    "template_id":""
}

Response

响应参数
参数 描述 类型 示例
data array(object)
  > id 计划id string
  > custom_id 客户id string
  > plan_generation 计划生成方式 int 1.合同签订后生成回款计划
2.开票后生成回款计划
3.结算后生成回款计划
4.发/到货后生成回款计划
5.创建合同时手动添加回款计划
  > type 回款方式 int 1.一次回款
2.滚动回款
3.多次回款
  > settle_type 滚动回款 int 1.周结
2.月结
3.季结
4.年结
  > settle_month 滚动回款 第 x 月 int 0
  > settle_day 滚动回款 第 x 月第 x 天 int 0
  > template_id 适用模板id string
  > template_name 适用模板名称 string
  > info 回款信息 int 0
   >> day 合同签订后 x 天 int 0
   >> plan_type_id 计划类型id string
   >> type_name 计划类型 string 常规
   >> plan_money 计划金额 string
   >> plan_ratio/max_ratio 计划金额比例 int 100
   >> plan_remarks 备注 string
响应示例:
{
    "data":[
        {
            "id":"PSQzNx0qk",
            "custom_id":"FJSNkksgk",
            "plan_generation":1,
            "type":1,
            "settle_type":0,
            "settle_month":0,
            "settle_day":0,
            "info":[
                {
                    "day":7,
                    "plan_type_id":"WiiiJmSy0",
                    "type_name":"常规",
                    "plan_ratio":"100",
                    "plan_remarks":""
                }
            ],
            "template_id":"XJzyQ0000",
            "template_name":"普通模板"
        }
    ],
    "errcode":0,
    "errmsg":"请求成功",
    "request_id":null,
    "env":"zkgj-dev"
}

新增、编辑客户

Request

Url
[POST] : https://eapi.paiago.com/ZKGJ/Intercourse/Customer/Add/?access_token=ffc50044897a74c14b47a75
Rule
请求参数:
参数 类型 必填 描述 示例
id string 客户id 编辑客户时,请传入合同id
编辑时需要传入所有字段信息,包含不需要编辑的,漏传会将数据置空
customer_name string 客户名称
customer_number string 客户编号
custom_nature string 客户性质 1:个人
2:企业
3:政府事业单位
industry_id string 行业id名称
add_user string 创建人id
province string
city string
area string
leader array(object) 负责人
leader_id string 负责人id
billing array(object) 开票信息
  invoice_header string 发票抬头
  identifier string 统一社会信用代码
  bank_name string 银行名称
  bank_number string 银行账号
  address string 地址
  tel string 联系电话
  is_default number 是否默认 0:否
1: 是
mailing array(object) 邮寄信息
  province string
  city string
  area string
  mail_address string 邮寄地址
  recipient string 联系人
  telephone string 联系方式
  is_default number 是否默认 0:否
1: 是
自定义字段名称1 string 自定义字段值1
自定义字段名称2 string 自定义字段值2
请求示例:
[
    {
        "customer_name":"test-api-0",
        "customer_number":"12345678901X-XX-XX-X",
        "custom_nature":"2",
        "industry_id":"WiiiJmSy0",
        "province":"江西省",
        "city":"南昌市",
        "area":"青山湖区",
        "custom_address":"北京东路",
        "add_user":"WiiiJmSy0",
        "add_date":"2021-04-23",
        "leader":[
            {
                "leader_id":"WiiiJmSy0"
            },
            {
                "leader_id":"WiiiJmSy0"
            }
        ],
        "billing":[
            {
                "invoice_header":"抬头1",
                "identifier":"123456",
                "bank_name":"开户银行1",
                "bank_number":"996",
                "address":"开户地址1",
                "tel":"1827913",
                "is_default":0
            },
            {
                "invoice_header":"抬头2",
                "identifier":"1234567",
                "bank_name":"开户银行2",
                "bank_number":"9966",
                "address":"开户地址2",
                "tel":"1827914",
                "is_default":1
            }
        ],
        "mailing":[
            {
                "province":"江西省",
                "city":"南昌市",
                "area":"东湖区",
                "mail_address":"东湖区地址",
                "recipient":"收件人1",
                "telephone":"1827915",
                "is_default":0
            },
            {
                "province":"江西省",
                "city":"南昌市",
                "area":"青山湖区",
                "mail_address":"青山湖区地址",
                "recipient":"收件人2",
                "telephone":"1827916",
                "is_default":1
            }
        ],
        "自定义字段名称1":"自定义字段值1",
        "自定义字段名称2":"自定义字段值2"
    }
]

Response

响应参数
参数 描述 类型 示例
errcode 错误码 int
errmsg 错误信息 string
{
    "errcode":21003,
    "errmsg":"第1条数据录入失败:系统已有该客户,请勿重复添加!",
    "request_id":null,
    "env":"zkgj-cs"
}

行业列表

Request

Url
[POST] : https://eapi.paiago.com/ZKGJ/SystemData/Industry/?access_token=ffc50044897a74c14b47a75
请求参数:
参数 类型 描述 示例
Field array 请求字段 []
  > id string 人员id
  > industry_name string 行业名称
Order array 排序规则
Where array 查询条件
Page number 页数 0
ListRow number 条数 20
请求示例:
{
    "Field":[
        "id",
        "industry_name"
    ],
    "Order":{
        "id":"desc"
    },
    "Where":[
        {
            "filed":"industry_name",
            "factor":"like",
            "value":"业"
        }
    ],
    "Page":1,
    "ListRow":10
}

Response

响应参数
参数 描述 类型
count 总数 int
data 列表(参数释义同请求Field释义) array(object)
响应示例:
{
    "data":[
        {
            "id":"UNNmJeQ0q",
            "industry_name":"开采行业"
        },
        {
            "id":"USSxyQz00",
            "industry_name":"政府/事业单位"
        }
    ],
    "count":6,
    "errcode":0,
    "errmsg":"请求成功",
    "request_id":null,
    "env":"zkgj-cs"
}

库存


仓库列表

Request

Url
[POST] : https://eapi.paiago.com/ZKGJ/getWarehouseList?access_token=ffc50044897a74c14b47a75
请求参数:
参数 类型 描述 示例
Field array 请求字段 []
  id string 仓库id
  name string 仓库名称
  number string 仓库编号
  address string 仓库地址
  tel string 联系电话
  remark string 备注
  leader string 仓库负责人
  project_name string 项目名称
  add_user string 添加人id
  add_time number 添加时间
  company_id string 公司id
Order array 排序规则
Where array 查询条件
Page number 页数 0
ListRow number 条数 20
请求示例:
{
    "Field":[
        "id",
        "name",
        "number",
        "address",
        "tel",
        "remark",
        "leader",
        "project_name",
        "add_user",
        "add_time",
        "company_id"
    ],
    "Order":{
        "id":"desc"
    },
    "Where":[
        {
            "filed":"number",
            "factor":"in",
            "value":"1111,555"
        }
    ],
    "Page":1,
    "ListRow":31
}

Response

响应参数
参数 描述 类型 示例
count 总数 int
data 列表(详见请求Field释义) array(object)
响应示例:
{
    "data":[
        {
            "id":"PiJiSy0Ca",
            "name":"啊啊啊啊啊啊啊啊",
            "number":"555",
            "address":"",
            "tel":"",
            "remark":"",
            "leader":"李飞",
            "project_name":null,
            "add_user":"WiiiJmSy0",
            "add_time":1626839048,
            "company_id":"UNNNmzJ0k"
        },
        {
            "id":"PiJiJN0C0",
            "name":"111",
            "number":"1111",
            "address":"",
            "tel":"",
            "remark":"",
            "leader":"王*艳、胡*云、ic**y、噶随风、潇*",
            "project_name":null,
            "add_user":"WiiiJmSy0",
            "add_time":1626838844,
            "company_id":"UNNNmzJ0k"
        }
    ],
    "count":2,
    "errcode":0,
    "errmsg":"请求成功",
    "request_id":"4eafe68e184c19d0d681dbf16003f848",
    "env":"zkgj-dev"
}

新增仓库

Request

Url
[POST] : https://eapi.paiago.com/ZKGJ/addWarehouse?access_token=ffc50044897a74c14b47a75
请求参数:
参数 类型 必填 描述 示例
name string 仓库名称 1号仓库
number string 仓库编码 X000000001
user_ids string 仓库负责人 WiiiJmSy0,We7,UNNNmzJ0k
tel string 联系电话 15266665555
province string 省份 陕西省
city string 西安市
area string 高新区
address string 详细地址 朋客大厦
remark string 备注 XXXXx
project_ids string 关联项目id XieyNjaC7,XieyNja0j
请求示例:
{
    "name": "1号仓库",
    "number": "X000000001",
    "user_ids": "WiiiJmSy0,We7,UNNNmzJ0k",
    "tel": "15266665555",
    "province": "陕西省",
    "city": "西安市",
    "area": "高新区",
    "address": "科技路",
    "remark": "朋客大厦",
    "project_ids": "XieyNjaC7,XieyNja0j"
}

Response

响应参数
参数 描述 类型 示例
errcode 错误码 int
errmsg 错误信息 string
响应示例:
{
    "data": [],
    "errcode": 0,
    "errmsg": "请求成功",
    "request_id": "0c8b3505861e355973e410ac78dd3fc2",
    "env": "zkgj-dev"
}

新增期初库存

Request

Url
[POST] : https://eapi.paiago.com/ZKGJ/addEarlyStock?access_token=ffc50044897a74c14b47a75
请求参数:
参数 类型 必填 描述 示例
warehouse_id string 仓库id PSxSyx00g
products array(object) 产品信息
  product_id string 产品id XximJjjqj
  number number 产品数量 1.22
请求示例:
{
    "warehouse_id": "PSxSyx00g",
    "products": [
        {
            "product_id": "XximJjjqj",
            "number": "1"
        },
        {
            "product_id": "XieQmjjqV",
            "number": "1"
        },
        {
            "product_id": "XieQmjjqV",
            "number": "99"
        },
        {
            "product_id": "XieQmjjqs",
            "number": "1"
        },
        {
            "product_id":"XNSzSjkCa",
            "number":88
        }
    ]
}

Response

响应参数
参数 描述 类型 示例
errcode 错误码 int
errmsg 错误信息 string
响应示例:
{
    "data": [],
    "errcode": 0,
    "errmsg": "请求成功",
    "request_id": "0c8b3505861e355973e410ac78dd3fc2",
    "env": "zkgj-dev"
}

期初库存列表

Request

Url
[POST] : https://eapi.paiago.com/ZKGJ/getEarlyStockList?access_token=ffc50044897a74c14b47a75
请求参数:
参数 类型 描述 示例
Field array 请求字段 []
  cate_id string 产品分类id
  company_id string 公司id
  parent_id string 父级id
  add_user string 添加人id
  product_id string 产品id
  product_name string 产品名称
  product_code string 产品编码
  product_model string 产品型号
  product_barcode string 产品条码
  product_unit string 计量单位
  cate_name string 产品类型名称
  cate_id string 产品类型id
  warehouse_id string 仓库id
  warehouse_name string 仓库名称
  add_time string 添加时间
  early_num string 期初库存
  purchase_price string 采购均价
  price string 采购价
  inventory_costs string 库存成本
  id string 添加时间
Order array 排序规则
Where array 查询条件
Page number 页数 0
ListRow number 条数 20
请求示例:
{
    "Field": [
        "product_id",
        "product_name",
        "product_code",
        "product_model",
        "code",
        "unit",
        "cate_name",
        "cate_id",
        "warehouse_id",
        "warehouse_name",
        "add_time",
        "add_user",
        "early_num",
        "purchase_price",
        "price",
        "inventory_costs",
        "id",
        "company_id"
    ],
    "Order":{
        "id": "desc"
    },
    "Where": [
        {
            "filed": "warehouse_id",
            "factor": "=",
            "value": "PSxSyx00g"
        }
    ],
    "Page": 0,
    "ListRow": 2
}

Response

响应参数
参数 描述 类型 示例
count 总数 int
data 列表(详见请求Field释义) array(object)
响应示例:
{
    "data":[
        {
            "product_cate_id":"UiiieSyjV",
            "product_model":"红色大号",
            "product_explain":"验证文件扩展名,规则上也会验证文件的MIME类型",
            "product_code":"CP20220400005",
            "product_cate":"的SaaS",
            "product_barcode":"XD000000000000000000000001",
            "product_unit":"两",
            "product_price":"99.9900000",
            "payment_price":"9.9900000",
            "user_id":"WiiiJmSy0",
            "add_time":1650937140,
            "product_id":"XximJjjqj",
            "product_name":"testadd",
            "company_id":"UNNNmzJ0k"
        }
    ],
    "count":209,
    "errcode":0,
    "errmsg":"请求成功",
    "request_id":"b56981d38721d440c93395f887601629",
    "env":"zkgj-dev"
}

消息


消息列表

Request

Url
[POST] : https://eapi.paiago.com/ZKGJ/getNewsList?access_token=ffc50044897a74c14b47a75
请求参数:
参数 类型 描述 示例
Field array 请求字段 []
  money string 开票金额 0.00
  send_userid string 发送人id
  accept_userid string 接受人id
  add_user string 申请人id
  contract_id string 合同id
  state number 消息状态
通知类:0:未读;1:已读;
事务类:
0:待处理;
1:已处理;
2:已驳回;
3:已撤销;
4:待收款,待开票,待退款等;
5:已付款,已开票,已退款;
其余直接审批无处理人的消息为已通过;
6:拒绝收款;拒绝退款;
7:同意开票(开票中),同意退款;
8:已认领;
10:(回款认领)我知道了;
11:关闭认领消息;
  type number 消息类型
0:系统通知;
1:事务类(我发起的,带我处理,我已处理);
2:抄送通知;
3:审批评论艾特消息;
  complete_time number 完成时间
  create_time number 创建/申请时间
  supplier_id string 供应商id
  custom_id string 客户id
  id string 消息id
  company_id string 公司id
  relation_id string style 关联的主键id
  style string 消息来源
1:财务指定业务人员认领回款;
2:回款认领异议(弃用);
3:预计回款消息给财务;
4:业务员认领回款;
6:合同变更消息(弃用);
7:财务退回变更消息给业务员(弃用);
8:财务已通过变更(弃用);
9:申请开票(弃用);
10:发票被通过(弃用);
11:发票被退回(弃用);
12:开票成功(弃用);
13:发票被作废(弃用);
14:财务开票给业务员发消息
(新增发票时添加,现在在用);
15:坏账收回时
给业务员发消息 关联坏账收回主表id;
16:新建坏账
给业务发送消息关联id是新建坏账主表的id;
17:发生变更时
操作人和合同跟进人不是同一个人
通过变更发给跟进人;
18:不是同一个人不通过时发给跟进人;
19:财务同意预计回款;
20:财务拒绝预计回款;
21:到期催办;
22:逾期催办;
23:组织架构更新提醒;
24:合同详情@人;
25:周报;
26:月报;
27:合同动态直接评论;
28:组织人员更新提醒;
29:授权角色系统通知;
30:版本更新提示;
31:新建合同消息;
32:赊销额度消息推送
(relation_id=healthy_id);
33:逾期回复消息;
34:到期回复消息;
35:回款认领给申请人发送的消息;
36:业务员全部退回后给财务发送的消息;
40:新组织架构消息;
41:合同申请;

---------------以上除系统消息 ------------
---------------其余审批消息不在使用---------
42:新变更;
43:申请退款;
44:项目申请;
45:合同审批;
46:发票申请;
47:申请回款;
48:回款认领;
49:合同终止;
50:入库申请;
51:出库申请;
52:调拨申请;
53:预收款申请;
54:预收款退款;
55:转入审批;
56:转出审批;
系统消息:
60:应收合同到期;
61:回款计划到期提醒;
62:回款计划逾期提醒;
63:回款消息(新建)
100:合同申请;
101:付款审批;
102:合同变更;
103:报销审批;
104:费用审批;
105:借款审批;
106:还款审批;
107:发票审批;
108:合同退款;
110:新建合同付款;
111:预付款审批;
112:合同动态直接评论或回复;
113:合同动态@提醒;
114:合同新建消息;
115:合同到期消息;
116:付款消息(新建);
117:付款计划到期提醒;
118:付款计划逾期提醒;
119:预付款退款;
120:供应商对账提醒;
121: 合同终止;
  reserve1 string style=46 客户名称
  reserve2 string style=46 开票金额
  reserve3 string style=46 发票类型
  reserve4 string 摘要
  reserve5 string 摘要
ListType number 列表类型 108
Order array 排序规则
Where array 查询条件
Page number 页数 0
ListRow number 条数 20

ListType 说明:

编号 类型名称
100 全部待处理
101 待处理 待审批
102 待处理 待开票
103 待处理 待收票
104 待处理 待收款
105 待处理 待退款
106 待处理 应收 全部
107 待处理 应收 待审批
108 待处理 应收 待开票
109 待处理 应收 待收款
110 待处理 应收 待退款
111 待处理 应付
112 待处理 应付 待审批
113 待处理 应付 待收票
114 待处理 应付 待退款
115 待处理 核算
116 待处理 核算 待审批
117 待处理 库存 全部
118 待处理 库存 待审批
200 已处理 全部
201 已处理 全部 已通过
202 已处理 全部 已驳回
203 已处理 全部 已开票
204 已处理 全部 已收票
205 已处理 全部 已收款
206 已处理 全部 已付款
207 已处理 全部 已退款
208 已处理 应收 全部
209 已处理 应收 已通过
210 已处理 应收 已驳回
211 已处理 应收 已开票
212 已处理 应收 已收款
213 已处理 应收 已退款
214 已处理 应付 全部
215 已处理 应付 已通过
216 已处理 应付 已驳回
217 已处理 应付 已收票
218 已处理 应付 已付款
219 已处理 应付 已退款
220 已处理 核算 全部
221 已处理 核算 已通过
222 已处理 核算 已驳回
223 已处理 库存 全部
224 已处理 库存 已通过
225 已处理 库存 已驳回
请求示例:
{
    "Field":[
        "money",
        "send_userid",
        "accept_userid",
        "add_user",
        "contract_id",
        "state",
        "type",
        "complete_time",
        "create_time",
        "supplier_id",
        "custom_id",
        "id",
        "company_id",
        "relation_id",
        "style",
        "reserve1",
        "reserve2",
        "reserve3",
        "reserve4",
        "reserve5"
    ],
    "Order":{
        "money":"desc",
        "id":"asc"
    },
    "Where":[
        {
            "filed":"accept_userid",
            "factor":"=",
            "value":"1"
        },
        {
            "filed":"style",
            "factor":"=",
            "value":"46"
        }
    ],
    "Page":1,
    "ListRow":1,
    "ListType":108
}

Response

响应参数
参数 类型 描述 示例
count int 总数
data array(object) 列表(字段释义参考请求Field字段)
  > news_leb number 0全部
1: 应收
2: 应付
3: 库存
4: 核算
响应示例:
{
    "data":[
        {
            "money":"4354.35",
            "send_userid":null,
            "accept_userid":1,
            "add_user":1,
            "contract_id":null,
            "state":2,
            "type":1,
            "complete_time":1605163207,
            "create_time":1605162609,
            "custom_id":null,
            "id":69164,
            "company_id":15,
            "relation_id":771,
            "style":50,
            "reserve1":"仓库:西安",
            "reserve2":"入库类型:采购入库",
            "reserve3":"入库日期:2020-11-12",
            "reserve4":"",
            "reserve5":"",
            "supplier_id":"",
            "news_leb":3
        }
    ],
    "count":44,
    "errcode":0,
    "errmsg":"请求成功",
    "request_id":"ceff9c31493da6d1fa9fc63833116a2a",
    "env":"zkgj-dev"
}


消息详情

Request

Url
[POST] : https://eapi.paiago.com/ZKGJ/getNewsDetail?access_token=ffc50044897a74c14b47a75
请求参数:
参数 类型 描述 示例
style number 消息来源
(参考消息列表 style 释义)
46
relation_id string 关联的id FQJNC7qqC
news_leb number 消息类型
(目前仅支持应收和应付两种类型)
1,应收
2,应付
3,库存
4,核算
1
id string 消息id lSSC77akj
请求示例
{
    "style":46,
    "relation_id":"FQJNC7qqC",
    "news_leb":1,
    "id":"lSSC77akj"
}

Response

响应参数

参数 类型 描述 示例
data object 数据
  id string 消息id
  money string 金额
  type string 消息类型(参考消息列表字段释义)
  state string 消息状态(参考消息列表字段释义)
  style string 消息来源(参考消息列表字段释义)
  relation_id string style 关联的id
  add_time string 添加时间
  reserve1 string 摘要 style=46 客户名称
  reserve2 string 摘要 style=46 开票金额
  reserve3 string 摘要 style=46 发票类型
  billing object 发票信息
   > apply_info object 申请信息
    >> id string 发票id
    >> custom_id string 客户id
    >> billing_type number 发票类型:
1:增值税普通发票;
2:增值税专用发票;
3:其他;
4:增值税电子普通发票;
5:增值税电子专用发票
    >> leb number 发票类别:
0:合同发票;
1:其他发票;
    >> tax_rate number 税率
    >> multiple_tax_rates string 税率为多税率时存储
    >> tax string 税额
    >> is_tax number 商品是否含税
0:含税
1:不含税
    >> is_free_tax number 是否免税:0:非免税 1:免税
    >> billing_number string 发票编号
    >> billing_encoded string 发票代码
    >> billing_date string 开票日期
    >> billing_money number 开票金额
    >> remark string 备注
    >> status number 1:发票申请阶段
2:发票申请通过阶段(待开票阶段)
3:发票申请未通过阶段
4:开票成功
5:作废
6:撤销.
8:驳回
9:开票失败
    >> invoice_header string 发票抬头
    >> taxpayer_identification_number string 纳税人识别号
    >> bank_name string 开户银行
    >> bank_account_number string 银行帐号
    >> address string 地址
    >> tel string 联系电话
    >> electric_url string pdf下载路径
    >> relation_invoice_id string (忽略)
    >> billing_goods string 商品明细
     >>> id string 商品id
     >>> company_id string 公司id
     >>> billing_id string 发票id
     >>> goods_id string 商品id
     >>> goods_name string 商品明称
     >>> price string 商品单价
     >>> all_price string 商品总价
     >>> tax_rate string 税率
     >>> tax string 税额
     >>> is_free_tax string 是否免税:0:非免税 1:免税
     >>> number string 商品数量
   billing_info object 开票信息(同申请信息字段)
响应示例
{
    "data":{
        "id":"lSSC77akj",
        "money":"20.00",
        "type":1,
        "state":5,
        "style":46,
        "relation_id":"FQJNC7qqC",
        "add_time":1648094033,
        "reserve1":"客户名称:小圈圈",
        "reserve2":"开票金额:¥20.00",
        "reserve3":"发票类型:增值税专用发票",
        "billing":{
            "apply_info":{
                "id":"FQJNC7qqC",
                "custom_id":"Fmzxkksga",
                "billing_type":2,
                "leb":0,
                "tax_rate":"0.00",
                "multiple_tax_rates":"13.00%",
                "tax":"2.30",
                "is_tax":0,
                "is_free_tax":0,
                "billing_number":null,
                "billing_encoded":"",
                "billing_date":null,
                "billing_money":"20.00",
                "remark":"",
                "status":4,
                "invoice_header":"",
                "taxpayer_identification_number":"",
                "bank_name":"",
                "bank_account_number":"",
                "address":"",
                "tel":"",
                "electric_url":null,
                "relation_invoice_id":"",
                "billing_goods":[
                    {
                        "id":"XNJeykgkq",
                        "company_id":"UNNNmzJ0k",
                        "billing_id":"FQJNC7qqC",
                        "goods_id":"PSSQJxC0q",
                        "goods_name":"软件费2",
                        "price":"20.0000000",
                        "all_price":"20.0000000",
                        "tax_rate":"13.00",
                        "tax":"2.30",
                        "is_free_tax":0,
                        "number":"1"
                    }
                ]
            },
            "billing_info":[
                {
                    "id":"FmxiC7qqs",
                    "custom_id":"Fmzxkksga",
                    "billing_type":2,
                    "leb":0,
                    "tax_rate":"13.00",
                    "multiple_tax_rates":"13%",
                    "tax":"1.47",
                    "is_tax":0,
                    "is_free_tax":0,
                    "billing_number":"87818267",
                    "billing_encoded":"1100192130",
                    "billing_date":"2022-03-24",
                    "billing_money":"11.30",
                    "remark":"",
                    "status":5,
                    "invoice_header":"锦鲤科技有限公司",
                    "taxpayer_identification_number":"9161013MA6TX6L97H",
                    "bank_name":"西安银行",
                    "bank_account_number":"23242442424",
                    "address":"陕西省西安市雁塔区科技路西电科技园",
                    "tel":"18392390727",
                    "electric_url":null,
                    "relation_invoice_id":"20882",
                    "billing_goods":[
                        {
                            "id":"XziQzkgkg",
                            "company_id":"UNNNmzJ0k",
                            "billing_id":"FmxiC7qqs",
                            "goods_id":"PSSQJxC0q",
                            "goods_name":"软件费2",
                            "price":"20.0000000",
                            "all_price":"11.3000000",
                            "tax_rate":"13.00",
                            "tax":"1.30",
                            "is_free_tax":0,
                            "number":"0.5650000"
                        }
                    ]
                }
            ]
        }
    },
    "errcode":0,
    "errmsg":"请求成功",
    "request_id":"f63e5ef058d9caf0ba40d4faa8242eda",
    "env":"zkgj-dev"
}

项目


项目列表

Request

Url
[POST] : https://eapi.paiago.com/ZKGJ/Project?access_token=ffc50044897a74c14b47a75
请求参数:
参数 类型 描述 示例
Field array 请求字段 []
  > id string 项目id
  > project_name string 项目名称
  > project_number string 项目编号
  > status_id string 状态id(可根据基础资料中的表单状态查询名称)
  > depart_id string 部门id
  > parents_id string 父级项目id
  > add_user string 项目创建人
  > is_leader string 项目负责人
  > is_archive string 是否归档 0:未归档;1:已归档;
  > member_list array 项目成员信息
  > 自定义字段1 string 自定义字段1名称
  > 自定义字段2 string 自定义字段2名称
Order array 排序规则
Where array 查询条件
Page number 页数 0
ListRow number 条数 20
请求示例:
{
    "Field":[
        "id",
        "project_name",
        "project_number",
        "status_id",
        "depart_id",
        "parents_id",
        "add_user",
        "is_leader",
        "is_archive",
        "member_list",
        "自定义字段1",
        "自定义字段2"
    ],
    "Order":{
        "id":"desc",
        "realname": "asc"
    },
    "Where":[
    ],
    "Page":1,
    "ListRow":20
}

Response

响应参数
参数 描述 类型
count 总数 int
data 列表(参数释义同请求Field释义) array(object)
  > id 项目id string
  > project_name 项目名称 string
  > project_number 项目编号 string
  > status_id 状态id(可根据基础资料中的表单状态查询名称) string
  > depart_id 部门id string
  > parents_id 父级项目id string
  > add_user 项目创建人id string
  > is_leader 项目负责人id string
  > is_archive 是否归档 0:未归档;1:已归档; number
  > member_list 项目成员信息 array(object)
   >> id id string
   >> user_id 用户id string
   >> founder 是否为项目创建人 0:否 1:是 string
   >> type 1:项目负责人 2:项目成员 string
   >> project_id 项目id string
响应示例:
{
    "data":[
        {
            "id": "XziSmsasg",
            "project_name": "项目一",
            "project_number": "",
            "status_id": "XJiyy0CCq",
            "depart_id": 0,
            "parents_id": 0,
            "add_user": "lSQq7sVCq",
            "is_leader": "lSQq7sVCq",
            "is_archive": 0,
            "member_list": [
                {
                    "id": "XixSSkC7V",
                    "user_id": "lSQq7sVCq",
                    "founder": 1,
                    "type": 1,
                    "project_id": "XziSmsasg"
                }
            ]
        }
    ],
    "count":1,
    "errcode":0,
    "errmsg":"请求成功",
    "request_id":null,
    "env":"zkgj-cs"
}

预收款


收款类型列表

Request

Url
[POST] : https://eapi.paiago.com/ZKGJ/advancePaymentType/?access_token=ffc50044897a74c14b47a75
请求参数:
参数 类型 描述 示例
Field array 请求字段 []
  > id string 收款类型id
  > income_type string 类型名称
Order array 排序规则
Where array 查询条件
Page number 页数 0
ListRow number 条数 20
请求示例:
{
    "Field":[
        "id",
        "income_type"
    ],
    "Order":[

    ],
    "Where":[

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

Response

响应参数
参数 描述 类型 示例
count 总数 int
data 列表(详见请求Field释义) array(object)
响应示例:
{
    "data":[
        {
            "id":"FyiiCa7qC",
            "income_type":"类型1"
        }
    ],
    "count":1,
    "errcode":0,
    "errmsg":"请求成功",
    "request_id":null,
    "env":"zkgj-cs"
}

新建收款类型

Request

Url
[POST] : https://eapi.paiago.com/ZKGJ/advancePaymentType/Add/?access_token=ffc50044897a74c14b47a75
请求参数:
参数 类型 必填 描述 示例
typeList array(object) 回款类型名称(数组)
请求示例:
[
    {
        "typeList": [
            "类型2",
            "类型3"
        ]
    }
]

Response

响应参数
参数 描述 类型 示例
errcode 错误码 int
errmsg 错误信息 string
响应示例:
{
    "data": [],
    "errcode": 0,
    "errmsg": "请求成功",
    "request_id": null,
    "env": "zkgj-cs"
}

新建预收款

Request

Url
[POST] : https://eapi.paiago.com/ZKGJ/advancePayment/Add/?access_token=ffc50044897a74c14b47a75
请求参数:
参数 类型 必填 描述 示例
customer_id string 客户id FzNxCk700
account_id string 账户id XxSNJ00Cj
arrival_date string 收款日期 2021-04-23
return_money number 收款金额 2.00
remark string 备注 备注
bill_number string 单据编号 n10010
income_id string 回款类型id(多个id用,隔开) PSxNSxaqC,PiixiSaqa
add_user string 创建人id WiiiJmSy0
请求示例:
[
    {
        "customer_id":"FzNxCk700",
        "account_id":"XxSNJ00Cj",
        "arrival_date":"2021-04-23",
        "return_money":"9",
        "remark":"备注beizhu",
        "bill_number":"n10010",
        "income_id":"PSxNSxaqC,PiixiSaqa",
        "add_user":"WiiiJmSy0"
    }
]

Response

响应参数
参数 描述 类型 示例
errcode 错误码 int
errmsg 错误信息 string
响应示例:
{
    "data": [],
    "errcode": 0,
    "errmsg": "请求成功",
    "request_id": null,
    "env": "zkgj-cs"
}

新建预收款核销

Request

Url
[POST] : https://eapi.paiago.com/ZKGJ/advancePayment/WriteOff/?access_token=ffc50044897a74c14b47a75
请求参数:
参数 类型 必填 描述 示例
customer_id string 客户id FzNxCk700
date string 核销日期 2021-04-23
remark string 备注 备注
add_user string 创建人id WiiiJmSy0
contract array(object) 关联合同
 > contract_id string 合同id XieyNjaC7
 > arrival_money number 到账金额 0.01
 > discount_money number 抵扣金额 0.01
请求示例:
[
    {
        "customer_id":"FzNxCk700",
        "date":"2021-04-23",
        "remark":"备注beizhu",
        "add_user":"WiiiJmSy0",
        "contract":[
            {
                "contract_id":"liN0kjCV7",
                "arrival_money":"2",
                "discount_money":"0"
            },
            {
                "contract_id":"lJz0kjCV0",
                "arrival_money":"2",
                "discount_money":"0"
            }
        ]
    }
]

Response

响应参数
参数 描述 类型 示例
errcode 错误码 int
errmsg 错误信息 string
响应示例:
{
    "data": [],
    "errcode": 0,
    "errmsg": "请求成功",
    "request_id": null,
    "env": "zkgj-cs"
}

新建预收款退款

Request

Url
[POST] : https://eapi.paiago.com/ZKGJ/advancePayment/WriteOffRefund/?access_token=ffc50044897a74c14b47a75
请求参数:
参数 类型 必填 描述 示例
customer_id string 客户id FzNxCk700
account_id string 账户id XxSNJ00Cj
date string 核销日期 2021-04-23
refund_money number 回款金额 2.00
remark string 备注 备注
bill_number string 单据编号 n10010
add_user string 创建人id WiiiJmSy0
请求示例:
[
    {
        "customer_id":"FzNxCk700",
        "account_id":"XxSNJ00Cj",
        "date":"2021-04-23",
        "refund_money":"9",
        "remark":"备注beizhu",
        "bill_number":"n10010",
        "add_user":"WiiiJmSy0"
    }
]

Response

响应参数
参数 描述 类型 示例
errcode 错误码 int
errmsg 错误信息 string
响应示例:
{
    "data": [],
    "errcode": 0,
    "errmsg": "请求成功",
    "request_id": null,
    "env": "zkgj-cs"
}