网上报销类

    expensesclaim/add


    目录

    1.接口说明

    1.1接口描述

         新增一张费用报销单

    1.2适用版本

         支持U8V12.0 及更高版本

    2.使用场景

    移动报销、报销应用

    3.接口调用说明

    3.1请求说明

    url https://api.yonyouup.com/api/expensesclaim/add
    格式 JSON
    https请求方式 POST
    编码类型 UTF-8


    3.2url参数说明

    参数 类型 是否必填 描述
    from_account string 调用方id
    to_account string 提供方id
    app_key string 应用编码
    token string api调用唯一识别码
    tradeid string 交易唯一识别码,tradeid与biz_id只能传入一个
    ds_sequence number 数据源序号(默认取应用的第一个数据源)
    biz_id string 上游id,需要保证biz_id与ERP主键唯一对应关系,tradeid与biz_id只能传入一个
    sync number 0=异步新增(默认);1=同步新增;


    3.3请求体参数说明

    参数 类型 参数路径 是否必填 描述
    operationtypecode string 单据类型编码
    typename string 单据类型
    code string 单据编号
    expensedate date 报销日期
    expenserid string 报销人编码
    cpsn_name string 报销人
    deptid string 部门
    cdepname string 部门名称
    expensemoney number 报销金额
    budgetitemid string 预算项目编码
    cbgitemname string 预算项目
    currency string 币种
    agentid string 经办人
    auditorid string 审核人
    auditdate date 审核日期
    cuscode string 客户编码
    ccusname string 客户名称
    ccusabbname string 客户简称
    vencode string 供应商编码
    cvenname string 供应商名称
    cvenabbname string 供应商简称
    auditdatetime date 审核日期时间
    auditstate number 审核状态
    paystate number 支付状态
    vouchstate number 单据状态
    used string 用途
    exchangerate number 汇率
    itemclassid string 项目大类
    itemid string 头项目
    citem_name string 项目大类名称
    citemname string 头项目
    spreaddeptid string 头分摊部门
    spreaddepname string 部门名称
    cdefine1 string 自定义项1
    cdefine2 string 自定义项2
    cdefine3 string 自定义项3
    cdefine4 date 自定义项4
    cdefine5 number 自定义项5
    cdefine6 date 自定义项6
    cdefine7 number 自定义项7
    cdefine8 string 自定义项8
    cdefine9 string 自定义项9
    cdefine10 string 自定义项10
    cdefine11 string 自定义项11
    cdefine12 string 自定义项12
    cdefine13 string 自定义项13
    cdefine14 string 自定义项14
    cdefine15 number 自定义项15
    cdefine16 number 自定义项16
    costapplycode string 申请单号
    begindate date entry 起始日期
    enddate date entry 终止日期
    begintime string entry 起始时间
    emdtime string entry 终止时间
    beginzero string entry 起始地点
    endzero string entry 达到地点
    vehiclecode string entry 交通工具编码
    vehiclename string entry 交通工具
    attachmentnum number entry 附单据数
    costitemid string entry 费用项目编码
    cexpname string entry 费用项目
    deptid string entry 部门编码
    subdepname string entry 部门名称
    expenserid string entry 报销人编码
    subpsn_name string entry 报销人
    itemclassid string entry 项目大类编码
    subcitem_name string entry 项目大类名称
    itemid string entry 项目编码
    subcitemname string entry 项目名称
    expensemoney number entry 报销金额
    localmoney number entry 本币金额
    number number entry 数量
    quota number entry 定额
    vouchmoney number entry 单据金额
    overquotarate number entry 超定额比率
    rate number entry 百分比
    spreaddeptid string entry 费用承担部门编码
    spreaddepname string entry 费用承担部门
    memo string entry 说明
    budgetitemid string entry 预算项目编码
    subbgitemname string entry 预算项目
    cdefine22 string entry 自定义项22
    cdefine23 string entry 自定义项23
    cdefine24 string entry 自定义项24
    cdefine25 string entry 自定义项25
    cdefine26 number entry 自定义项26
    cdefine27 number entry 自定义项27
    cdefine28 string entry 自定义项28
    cdefine29 string entry 自定义项29
    cdefine30 string entry 自定义项30
    cdefine31 string entry 自定义项31
    cdefine32 string entry 自定义项32
    cdefine33 string entry 自定义项33
    cdefine34 number entry 自定义项34
    cdefine35 number entry 自定义项35
    cdefine36 date entry 自定义项36
    cdefine37 date entry 自定义项37

    3.4请求示例

    POST https://api.yonyouup.com/api/expensesclaim/add?from_account=openapi_dev&to_account=openapi_ent&app_key=opa6fdd4bea98b95ad7&token=843d03f66e6544e19707ccec11030296&biz_id=0971&ds_sequence=1
    
    POST 内容:
    {
    	"expensesclaim":{
    		"expensemoney":"1500",
    		"expenserid":"00001",
    		"operationtypecode":"3002",
    		"used":"报销用途说明...",
    		"user_id":"demo",
    		"deptid":"0302",
    		"entry":[
    			{
    				"costitemid":"04",
    				"deptid":"0302",
    				"expensemoney":"1500",
    				"expenserid":"00001",
    				"rowno":"1"
    			}
    		]
    	}
    }
    


    3.5返回参数说明

    参数说明 类型 描述
    errcode string 错误码,0 为正常。
    errmsg string 错误信息。
    id string 新增成功后返回新单据编号。
    tradeid string 新增成功后返回交易唯一识别码

    3.6正确返回示例

    JSON示例:

    {
        "tradeid": "158f3f05730711e591c702004c4f4f50",
        "ping_after": "3",
        "url": "https://api.yonyouup.com/result?requestid=158f3f05730711e591c702004c4f4f50"
    }
    上述 api 请求返回信息表示建议客户端 3 秒钟后向 https://api.yonyouup.com/result?requestid=158f3f05730711e591c702004c4f4f50 发送 GET 请求获取真正的 api 调用结果,结果格式如下:
    {
      "errcode" : "0", 
      "errmsg" : "", 
      "id" : "883",
      "tradeid" : "158f3f05730711e591c702004c4f4f50"
    }  
    

    3.7错误返回示例

    application/json;charset=UTF-8
    {
    	"errcode" : "30021",
    	"errmsg" : "此应用未上线"
    } 

    4.API测试

    API测试 SDK下载