菜单

保存

基本信息

  • 用途说明:费用报销单保存(单据标识:wg_utility_bill)
  • 请求方式:POST
  • 请求地址:https://api.kingdee.com/weigusoft/wg_cost/saveBill?access_token=&authority_info=

headers参数

  • 所有的接口必须携带header参数
参数名称 参数示例 是否必填 参数说明
Content-Type application/json true 固定传:application/json
groupName ns-v7g6 true 分组名称,获取授权信息时返回的groupName
accountId 16xxxxxxxxxxxx true 账套ID,获取授权信息时返回的accountId
X-GW-Router-Addr https://tf.jdy.com true IDC域名,获取授权信息时返回的domain
Appuserid 10102023 true 当前登录用户id

params参数

参数名称 参数类型 是否必填 参数说明
access_token string true 金蝶云通行证token
authority_info string true 见文档authority_info参数说明

body参数

参数名称 必选 类型 说明
entityName true String 单据标识:wg_utility_bill 
data true Object 其他参数

data的数据结构:

参数名称 类型 必选 说明
id String false 编辑时必传,新增不需要传
billno String true 单据编号
billdate String true 申请日期
wg_biztype String true 业务类型: 3:日常报销单 4:差旅报销单
wg_utility_reason String true 事由
wg_beardept_id String true 承担部门id
wg_applicant_id String true 申请人id
currencyid_id String true 币别id
exchangerate String false 汇率
totalamount String false 总金额
wg_payamount String false 已支付金额
wg_projectno_id String false 项目档案id
wg_fileslevel_id String false 项目阶段id
customerid_id String false 关联客户id
creatorid_id String false 创建人id
wg_startdate String false 行程期间-开始时间(业务类型为差旅报销单时必传)
wg_enddate String false 行程期间-结束时间(业务类型为差旅报销单时必传)
wg_departure String false 出发地(业务类型为差旅报销单时必传)
wg_destination String false 目的地(业务类型为差旅报销单时必传)
remark String false 备注
material_entity List  true 费用信息
wg_offset_loan List  false 借款信息

material_entity的数据结构:

参数名称 类型 必选 说明
wg_consumeid_id String true 费用明细id
wg_paytype_id String true 费用项目id
wg_taxexcluded String true 不含税金额
allamount String true 含税金额
wg_taxrate String false 税率
wg_offsetloan_amount String false 冲抵借款核销
wg_unoffsetloan_amount String false 未核销金额
wg_mremark String false 备注
allamountfor String false 含税金额本位币
wg_invoice_size String false 发票数量
wg_attach_size String false 附件数量

wg_offset_loan的数据结构:

参数名称 类型 必选 说明
wg_biztype String false 业务类型 1:个人借款 2:备用金申请
wg_loan_billno String false 单据编码
wg_offset_amount String false 冲抵金额
wg_loan_amount String true 借款金额
wg_reason String false 事由
wg_loan_date String false 借款日期
wg_srcbilltypeid_id String false 源单类型:wg_loan_bill
wg_srcinterid String false 源单id
wg_totalunsettleamount String false 待还款金额

请求示例

{
    "entityName": "wg_utility_bill",
    "data": {
        "id": "2202903410544480256",
        "billno": "fy-20250428-00000007",
        "wg_biztype": "4",
        "billdate": "2025-04-28",
        "wg_utility_reason": "444",
        "wg_beardept_id": "1697006545188965376",
        "wg_projectno_id": "2203011914353700864",
        "wg_fileslevel_id": "1726209922393292800",
        "customerid_id": "1916792682206867456",
        "wg_applicant_id": "2178239997264542720",
        "wg_startdate": "2025-05-06",
        "wg_enddate": "2025-05-28",
        "wg_departure": "1917",
        "wg_destination": "1930",
        "remark": "",
        "material_entity": [
            {
                "wg_consumeid_id": "2202891414549875712",
                "wg_paytype_id": "1916815698609355776",
                "wg_paytype_name": "硬装费用",
                "allamount": "12",
                "wg_taxexcluded": 12,
                "wg_mremark": "",
                "wg_attach_size": "0",
                "wg_invoice_size": "0",
                "wg_taxrate": "0",
                "wg_offsetloan_amount": 12,
                "wg_unoffsetloan_amount": "0.0000",
                "allamountfor": "12"
            },
            {
                "wg_consumeid_id": "2202887999035853824",
                "wg_paytype_id": "1916815698609355776",
                "wg_paytype_name": "硬装费用",
                "allamount": "444",
                "wg_taxexcluded": 444,
                "wg_mremark": "",
                "wg_attach_size": "0",
                "wg_invoice_size": "0",
                "wg_taxrate": "0",
                "wg_offsetloan_amount": 35,
                "wg_unoffsetloan_amount": "409.0000",
                "allamountfor": "444"
            }
        ],
        "wg_offset_loan": [
            {
                "wg_biztype": "1",
                "wg_loan_billno": "JK-20250425-00010",
                "wg_offset_amount": "47.0000",
                "wg_totalunsettleamount": "47",
                "wg_loan_amount": "200.0000",
                "wg_reason": "测试9",
                "wg_loan_date": "",
                "wg_srcbilltypeid_id": "wg_loan_bill",
                "wg_srcinterid": "2200887945014137856"
            }
        ],
        "currencyid_id": "100000",
        "exchangerate": "1",
        "totalamount": 456,
        "custom_field__1__3w34a7wi588f": "",
        "custom_field__1__4kepqzvn0u5w": "",
        "custom_field__1__4oct299h528s": "",
        "custom_field__4__4ugdyhgk8qjiatkh_id": ""
    }
}

响应示例

{
    "data": {
        "id": "2202903410544480256"
    },
    "errorCode": "success",
    "status": true,
    "success": true
}

分享文章
最近修改: 2025-08-07