WebAPI接口之【保存自动建立关联关系（Link实体）】使用指南和实例

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

【应用场景】

系统销售订单/发货通知单传递数据发送给第三方系统（如WMS），然后根据WMS系统会传回出库的批号、仓库等信息生成对应的系统销售出库单（调用销售出库单保存接口），同时，希望生成的出库单与上游的销售订单/发货通知单的对应行自动建立关联关系，并且要实现系统的上、下查和全流程跟踪功能正常。

【自动建立关联关系所需信息主要包含以下三类】

--源单类型、源单编号（分录行字段）

--其他业务相关记录字段如：订单单号、订单分录FEntryId（分录行字段）

--Link实体数据包（子单据体）

以出库单为例：介绍Link实体数据包字段

字段	字段说明	用途
FSRCTYPE	源单类型（分录行）	反写、BOS、插件使用	必须
FSRCBILLNO	源单编号（分录行）	BOS配置、插件等使用	必须
FSoorDerno	订单单号（分录行）	业务、报表可能使用	尽量传
FSOEntryId	订单分录内码（分录行）	业务、报表可能使用	尽量传
FEntity_Link （Link实体）	link数据包（子单据体）	关联核心数据包
FEntity_Link_FRULEID	转换规则唯一标识	关联核心字段	必须
FEntity_Link_FSTABLENAME	源单编号	关联核心字段	必须
FEntity_Link_FSBILLID	源单内码（FID）	关联核心字段	必须
FEntity_Link_FSID	源单分录内码（FENTRYID）	关联核心字段	必须
FEntity_Link_FBaseUnitQty	库存基本数量（控制字段）		尽量传
FEntity_Link_FBaseUnitQtyOld	库存基本数量（原始携带量）		尽量传
FEntity_Link_FSalBaseQty	销售基本数量（控制字段）		尽量传
FEntity_Link_FSalBaseQtyOld	销售基本数量（原始携带量）	信用管理可能使用	尽量传
FEntity_Link_FPriceBaseQty	计价基本数量（控制字段）		尽量传
FEntity_Link_FPriceBaseQtyOld	计价基本数量（原始携带量）		尽量传

相关信息可以在BOS：单据属性-单据关联配置查看：

上传图片

【销售出库单保存构造关联信息示例参考】：

示例：重点构造Link子单据体数据，自动与上游建立关联关系（Postman json示例）

{
    "formId":"SAL_OUTSTOCK",
    "data":{
        "Model": {
            "FBillTypeID": {"FNUMBER": "XSCKD01_SYS"},
            "FStockOrgId": {"FNumber": "100"},
            "FSaleOrgId": {"FNumber": "100"},
            "FCustomerID": {"FNumber": "A"},
            "SubHeadEntity": {
                        "FSettleCurrID": {"FNumber": "PRE001"},
                        "FSettleOrgID": {"FNumber": "100"}
             },
            "FEntity":[{
                "FMaterialID": {"FNumber": "1.01.001.0001"},
                "FRealQty": 1,
                "FStockID": {"FNumber": "CK001"   },
                "FSRCTYPE": "SAL_SaleOrder",
                "FSRCBILLNO": "XSDD000772",
                "FSoorDerno":"XSDD000772",
                "FSOEntryId":"101634",
               "FEntity_Link ": [{
                        "FEntity_Link_FRULEID": "SaleOrder-OutStock",
                        "FEntity_Link_FSTABLENAME ": "T_SAL_ORDERENTRY",
                        "FEntity_Link_FSBILLID ": "101034",
                        "FEntity_Link_FSID": "101634",
                        "FEntity_Link_FBaseUnitQty" :"10",
                        "FEntity_Link_FBaseUnitQtyOld" :"10",
                        "FEntity_Link_FSalBaseQty" : "10",
                        "FEntity_Link_FSalBaseQtyOld" : "10",
                        "FEntity_Link_FPriceBaseQty" : "10",
                        "FEntity_Link_FPriceBaseQtyOld" : "10"
                    }]
               }]
    }
}