二开案例-【WebAPI】如何通过WebAPI进行单据下推

栏目：云星空知识作者：金蝶来源：金蝶云社区发布：2024-09-23浏览：1

一、请求参数

参数名	参数说明	是否必录
Ids	单据内码集合，格式："Id1,Id2,..."	使用内码时必录
Numbers	单据编码集合	使用编码时必录
EntryIds	分录内码，注：按分录下推时，单据内码和编码不需要填,否则按整单下推	按分录下推时必录
RuleId	转换规则内码	未启用默认转换规则时必录
TargetBillTypeId	目标单据类型内码	非必录
TargetOrgId	目标组织内码	非必录
TargetFormId	目标单据FormId	启用默认转换规则时必录
IsEnableDefaultRule	是否启用默认转换规则	启用默认转换规则时必录
IsDraftWhenSaveFail	保存失败时是否暂存	非必录
CustomParams	自定义参数，格式："{key1:value1,key2:value2,...}"	非必录

二、常见问题

1、生产用料清单推生产领料单，提示“分录实体明细是必填项”或者下推后缺少分录

检查生产领料单选项参数中业务参数【保存时清除实发为零分录】是否勾选，如果勾选了检查物料是否有库存，生产用料清单下推生产领料单会进行批号拣货，如果没有库存导致实发为零，调用下推接口会自动保存，一保存就把实发为零分录清除了，如不想清除实发为零分录取消勾选即可

2、手工下推正常，但使用webapi下推报错

检查转换规则是否填写错，比如生产用料清单下推生产领料单使用默认转换规则，但又扩展调整了默认转换规则不为【一般领料】，此时会无法下推，需要调整下推参数，不使用默认转换规则，改传"RuleId":"PRD_PPBOM2PICKMTRL_NORMAL"

3、下推不成功，提示“xxx必录”或者某些校验不通过

由于用webapi下推会直接保存，如果目标单据有设置必录字段且上游无法携带下来值，或者目标单据有设定某些校验规则通过初步下推生成的数据无法达到校验标准而需要二次维护数据，都可以通过设定参数IsDraftWhenSaveFail为true来处理，下推保存失败时暂存，然后会返回单据内码以及分录内码，可根据单据内码及分录内码再调用对应的目标单据保存接口来修改目标单据数据

三、Json示例（生产用料清单下推生产领料单）

{
    "Ids": "",
    "Numbers": ["PPBOM00000067"],
    "EntryIds": "",
    "RuleId": "",
    "TargetBillTypeId": "",
    "TargetOrgId": 0,
    "TargetFormId": "PRD_PickMtrl",
    "IsEnableDefaultRule": "true",
    "IsDraftWhenSaveFail": "true",
    "CustomParams": {}
}