接口描述

请求地址：/ldgCustomSyncQuery/3_9/syncLedgerData/YF01

接口编号：FSSC-API-LYF01

接口诞生版本：3.9.2

所属系统：台账管理

所属微服务：zfs-ledger

接口说明：同步应收台账数据

单次调用最大条数：1000

注意事项：

1、台账数据若需要支持更新，必须配置“接口更新主键”列，基于勾选的更新主键字段进行组合校验，已存在则视为更新；否则，视为新增；

2、接口根据自定义台账模板生成，若集团修改模板配置，需自行调整接口说明内容；

3、enabledFlag传参只能为0或1，1表示删除，0表示新增/更新；不传默认为0；是否删除不可逆，不支持从1变回0;

4、enabledFlag传1时，若对应数据在系统中不存在或已经被删除，则该主表区数据会报错，明细行数据会跳过，执行结果默认为成功。

5、不同字段类型有不同的格式校验，日期选择框：检验格式为yyyy-MM-dd；日期时间选择框：检验格式为yyyy-MM-dd HH:mm:ss；数字输入框、金额输入框：校验格式为数字。

请求参数

参数名称	中文名称	类型	是否必填	示例	说明
▼data		array	Y
rowId	行ID	string	N		该参数由接口自动处理，无需传值
rowNum	行号	string	N	1	外系统传过来的行号，用于接口返回时告知外系统哪一行数据同步失败了
enabledFlag	是否删除	string	N		传参只能为0或1，1表示删除，0表示新增/更新；不传默认为0；是否删除不可逆，不支持从1变回0; 传1时，若对应数据在系统中不存在或已经被删除，则该数据被跳过，执行结果默认为成功; 传1时，若对应数据唯一标识为多选字段，则该多选字段传值内容必须和系统中已有数据内容一致（如a,b,c和b,c,a可视为一致），才可删除该数据，否则视为该数据在系统中不存在，执行跳过
accountDate	挂账日期	string	N
allCavAmount	已核销金额	number	N
applyAmount	报账金额	number	Y
boeNo	单据编号	string	Y
contractId	关联合同	string	N		填写合同编码；校验在合同管理中是否存在和有效
employeeDeptId	部门	string	Y		填写部门编码；校验在基础数据-组织数据-公司部门中是否存在和有效
employeeId	申请人	string	Y		填写员工工号；校验在基础数据-组织数据-员工信息中是否存在和有效
expenseCavAmount	在途核销金额	number	N
firstBoeDate	单据首次提交日期	string	N
leId	核算主体	string	Y		填写核算主体编码；校验在基础数据-财务数据-财务管理中是否存在和有效
operationTypeId	业务大类	string	Y		填写业务大类编码；校验在基础数据-业务数据-业务类型中是否存在和有效
orderNumber	订单编号	string	N
payableAmount	应付余额	number	N
payableType	应付类型	string	Y		校验在【系统编码】应付类型中存在； 101：采购挂账 102：资产挂账 103：预收/应付挂账 104：其他挂账款 105：薪酬挂账
paymentCurrency	报账币种	string	Y		填写币种编码；校验在币种中是否存在和有效
rate	汇率	number	Y
standardCurrency	本位币币种	string	Y		填写币种编码；校验在币种中是否存在和有效
standardCurrencyAmount	本位币金额	number	Y
taxCode	往来对象税号	string	N
validityFlag	状态	string	N		默认为0“有效” 0：有效 1：无效
vendorCode	往来对象编号	string	N
vendorId	往来对象名称	string	Y		填写员工/客商编码；校验在基础数据-业务数据-客商管理中是否存在和有效
vendorType	往来对象类型	string	N		校验在【系统编码】客商类型中存在； 001：员工 002：供应商 003：客户 005：供应商/客户 009：临时供应商
waitCavAmount	未核销金额	number	N
boeTypeCode	单据类型编码	string	Y
formTypeId	单据大类	string	Y		填写单据模板编码
projectId	项目	string	N		填写项目编码；校验在基础数据-业务数据-项目管理中是否存在和有效
budgetCode	预算科目	string	N		填写预算编码；校验在预算配置-预设维度中是否存在和有效

返回参数

参数名称	中文名称	类型	是否必填	示例	说明
successNum	成功条数	string	Y	1
failNum	失败条数	string	Y	0
data	失败对象	array	Y	{"data":[{"rowId":"1","rowNum":"1","errMsg":"第1行年月超出范围限制;"}]}
code	返回代码	integer	Y	2
msg	返回消息	string	N	部分成功，部分失败

请求参数示例

{
  "data": [
    {
      "vendorType": "vendorType",
      "boeNo": "boeNo",
      "operationTypeId": "operationTypeId",
      "orderNumber": "orderNumber",
      "standardCurrency": "standardCurrency",
      "budgetCode": "budgetCode",
      "leId": "leId",
      "validityFlag": "validityFlag",
      "vendorId": "vendorId",
      "enabledFlag": "enabledFlag",
      "payableAmount": "payableAmount",
      "applyAmount": "applyAmount",
      "vendorCode": "vendorCode",
      "standardCurrencyAmount": "standardCurrencyAmount",
      "rate": "rate",
      "rowNum": "1",
      "waitCavAmount": "waitCavAmount",
      "accountDate": "accountDate",
      "employeeDeptId": "employeeDeptId",
      "formTypeId": "formTypeId",
      "employeeId": "employeeId",
      "taxCode": "taxCode",
      "payableType": "payableType",
      "rowId": "38ffbdb043f045ed544eb1b9b2ae034b",
      "allCavAmount": "allCavAmount",
      "firstBoeDate": "firstBoeDate",
      "contractId": "contractId",
      "boeTypeCode": "boeTypeCode",
      "expenseCavAmount": "expenseCavAmount",
      "paymentCurrency": "paymentCurrency",
      "projectId": "projectId"
    }
  ]
}

返回参数示例

{
  "msg": "部分成功，部分失败",
  "code": "2",
  "successNum": "1",
  "failNum": "1",
  "data": [
    {
      "rowId": "1",
      "rowNum": "1",
      "errMsg": "第1行年月超出范围限制;"
    }
  ]
}

应付台账同步接口（3.9.2）

应付台账同步接口（3.9.2）

关于作者

目录