**广联智通科技公司信息系统**

**开发功能说明书**

<table><tr><td><p><strong>信息系统</strong></p></td><td><p>☑SAP ☑MES</p></td></tr><tr><td><p><strong>功能名称</strong></p></td><td><p>BOM主数据接口</p></td></tr><tr><td><p><strong>开发类型</strong></p></td><td><p>□报表 □用户出口 ☑接口 □对话程序 □流程  </p><p>□表单</p></td></tr><tr><td><p><strong>开发记录号</strong></p></td><td></td></tr></table>

<a id="mpf3rr675bu5kc5ec6y"></a>
# 1. **创建修改记录（**

<table><tr><td><p>作者</p></td><td><p>陈奕清</p></td></tr><tr><td><p>业务顾问</p></td><td><p>李佩遥</p></td></tr><tr><td><p>创建日期</p></td><td><p>20260528</p></td></tr><tr><td><p>最近修改日期</p></td><td></td></tr><tr><td><p>开发</p></td><td></td></tr><tr><td><p>备注</p></td><td></td></tr></table>

<a id="mpf3rr67h0nw9g19rcc"></a>
# 2. **文档变更（调整）**

<table><thead><tr><th><p><strong>版本号</strong></p></th><th><p><strong>修正日期</strong></p></th><th><p><strong>修改人</strong></p></th><th><p><strong>修正描述</strong></p></th><th><p><strong>备注</strong></p></th></tr></thead><tbody><tr><td><p>V1.0</p></td><td><p>20260528</p></td><td><p>陈奕清</p></td><td></td><td></td></tr><tr><td></td><td></td><td></td><td></td><td></td></tr><tr><td></td><td></td><td></td><td></td><td></td></tr><tr><td></td><td></td><td></td><td></td><td></td></tr><tr><td></td><td></td><td></td><td></td><td></td></tr></tbody></table>

<a id="mpf3rr68iokg4qaeu0a"></a>
# 3. **业务需求概述（调整）**

<table><tr><td><p>需求概述：</p></td><td colspan="3"><p>MES主动拉取SAP物料清单数据</p><p>MES拉取SAP变更物料清单数据</p></td></tr><tr><td><p>开发难度(高/中/低)：</p></td><td><p>低</p></td><td><p>事务代码：</p></td><td></td></tr><tr><td><p>运行类型(在线/批处理):</p></td><td><p>在线</p></td><td></td><td></td></tr><tr><td><p>交易量：</p></td><td colspan="3"><p>低</p></td></tr><tr><td><p>备注：</p></td><td colspan="3"></td></tr></table>

<a id="mpf3rr68q0hwkg1j705"></a>
## 3.1. **现有/样本报表**

<table><tr><td><p>现有报表名称：</p></td><td><p>N/A</p></td></tr><tr><td><p>系统菜单/交易代码：</p></td><td><p>N/A</p></td></tr></table>

<a id="mpf3rr688a9wookda0k"></a>
# 4. **功能规范**

<a id="mpf3rr68d3ixoh0xjyw"></a>
## 4.1. **程序开发优先级**

<table><tr><td><p><input/>高</p></td><td><p><input/>中</p></td><td><p><input/>低</p></td></tr></table>

<a id="mpf3rr693bz54oi4op8"></a>
## 4.2. **权限要求**

全员赋予流程入口权限

<a id="mpf3rr69p261canb4eq"></a>
## 4.3. **程序运行频率**

[请在此选择本程序的运行频率，并按照业务需要，说明具体的频率要求，例如，每日：具体到时；每周：具体到日和时；每月：具体到日和时；每年：具体到日和时]

<table><tr><td><p><input/>随时</p></td><td><p><input/>周</p></td><td><p><input/>月</p></td><td><p><input/>季</p></td><td><p><input/>年</p></td></tr></table>

<a id="mpf3rr69kzg4l07sj96"></a>
## 4.4. **屏幕设计及其布局**

无

<a id="mpf3rr69p5cen0pv6x4"></a>
## 4.5. **参数和选择条件**

<a id="mpf3rr69460312ud92a"></a>
### 4.5.1. **查询 SAP BOM主数据：**

<table><tr><td><p>方法</p></td><td><p>URL</p></td><td><p>认证方式</p></td></tr><tr><td><p>GET</p></td><td><p>https://my201453-api.s4hana.sapcloud.cn/sap/opu/odata/sap/API_BILL_OF_MATERIAL_SRV;v=0002/MaterialBOM?$expand=to_BillOfMaterialItem </p></td><td><p>Basic Auth</p></td></tr></table>

<a id="mpf3rr69kojq4ro85l9"></a>
## 4.6. **字段的定义**

[请在此处说明所涉及字段所对数据表及其字段名或结构及其字段名]

apipost导出接口数据，复制粘贴过来，或者引用aipost分享的地址

<a id="mpf3rr69qeb0sui0tx6"></a>
# 5. **程序输出格式**

<a id="mpf3rr69ofgj2od8r6n"></a>
## 5.1. **业务大概逻辑**

<a id="mpf3rr692xtajz3569e"></a>
## 5.2. **前台业务截图**

[请在此处附上前台业务的截图，并将所要取出的字段标记出来]

<a id="mpf3rr692rna8byv4ze"></a>
## 5.3. **传入传出的参数**

**［仅接口类型程序需要］**

**接口用户：EXT\_USER\_TEST**

**用户密码：#xJ[zK3>VL)wDaT2m-xGx\$)[c2xXQ@QL/ZvCb<lV**

查询BOM的参数：

**请求方式**

Get

URL: https://my201453-api.s4hana.sapcloud.cn/sap/opu/odata/sap/API\_MATERIAL\_DOCUMENT\_SRV/A\_MaterialDocumentHeader

**Content-Type**

Json

**请求Header参数**

<table><tr><td><p>参数名</p></td><td><p>示例值</p></td><td><p>参数类型</p></td><td><p>是否必填</p></td><td><p>参数描述</p></td></tr><tr><td><p>Accept</p></td><td><p>application/json</p></td><td><p>string</p></td><td><p>是</p></td><td><p>-</p></td></tr><tr><td><p>x-csrf-token</p></td><td><p>Fetch</p></td><td><p>string</p></td><td><p>是</p></td><td></td></tr><tr><td><p>Accept-Language</p></td><td><p>ZH</p></td><td><p>String</p></td><td><p>是</p></td><td></td></tr></table>

![](images/817a69f35bd56f2f735b4bca78d3168e34cb2a71027d380c10e7617d0d00f32a.jpg)

{
    "d": {
        "results": [
            {
                "\_\_metadata": {
                    "id": "https://my201453-api.s4hana.sapcloud.cn/sap/opu/odata/sap/API\_BILL\_OF\_MATERIAL\_SRV;v=0002/MaterialBOM(BillOfMaterial='00000002',BillOfMaterialCategory='M',BillOfMaterialVariant='1',BillOfMaterialVersion='',EngineeringChangeDocument='',Material='133-001-01001',Plant='1011')",
                    "uri": "https://my201453-api.s4hana.sapcloud.cn/sap/opu/odata/sap/API\_BILL\_OF\_MATERIAL\_SRV;v=0002/MaterialBOM(BillOfMaterial='00000002',BillOfMaterialCategory='M',BillOfMaterialVariant='1',BillOfMaterialVersion='',EngineeringChangeDocument='',Material='133-001-01001',Plant='1011')",
                    "type": "API\_BILL\_OF\_MATERIAL\_SRV.MaterialBOMType",
                    "etag": "W/\"'SADL-202605110956033525140C\~20260511095603.3525140'\""
                },
                "AssignPlant\_ac": true, // 分配工厂（操作标记）
                "DeleteBOMHeaderWithECN\_ac": true, // 通过ECN删除BOM头（操作标记）
                "ReleaseVersionBOM\_ac": true, // 发布版本BOM（操作标记）
                "UnassignPlant\_ac": true, // 取消分配工厂（操作标记）
                "Delete\_mc": true, // 删除（操作标记）
                "Update\_mc": true, // 更新（操作标记）
                "to\_BillOfMaterialItem\_oc": true, // BOM项目导航（操作标记）
                "to\_BillOfMaterialLongText\_oc": true, // BOM长文本导航（操作标记）
                "BillOfMaterial": "00000002", // BOM号
                "BillOfMaterialCategory": "M", // BOM类别（M=物料BOM）
                "BillOfMaterialVariant": "1", // BOM用途
                "BillOfMaterialVersion": "", // BOM版本
                "EngineeringChangeDocument": "", // 工程变更单号
                "Material": "133-001-01001", // 物料号
                "Plant": "1011", // 工厂
                "BillOfMaterialHeaderUUID": "00163e24-21bd-1fe1-93a0-f4b6b386885c", // BOM报头UUID
                "BillOfMaterialVariantUsage": "1", // BOM用途
                "EngineeringChangeDocForEdit": "", // 用于编辑的工程变更单
                "IsMultipleBOMAlt": false, // 多重BOM替代
                "BOMHeaderInternalChangeCount": "1", // BOM报头内部变更计数
                "BOMUsagePriority": "0", // BOM用途优先级
                "BillOfMaterialAuthsnGrp": "", // BOM授权组
                "BOMVersionStatus": "", // BOM版本状态
                "IsVersionBillOfMaterial": false, // 版本BOM
                "IsLatestBOMVersion": false, // 最新BOM版本
                "IsConfiguredMaterial": false, // 可配置物料
                "BOMTechnicalType": "", // BOM技术类型
                "BOMGroup": "", // BOM组
                "BOMHeaderText": "", // BOM报头文本
                "BOMAlternativeText": "", // BOM替代文本
                "BillOfMaterialStatus": "1", // BOM状态
                "HeaderValidityStartDate": "/Date(1777593600000)/", // 报头有效期开始日期
                "HeaderValidityEndDate": "/Date(253402214400000)/", // 报头有效期结束日期
                "ChgToEngineeringChgDocument": "", // 工程变更单变更
                "IsMarkedForDeletion": false, // 标记删除
                "IsALE": false, // ALE
                "MatFromLotSizeQuantity": "0.000", // 物料起始批量数量
                "MaterialToLotSizeQuantity": "0.000", // 物料截止批量数量
                "BOMHeaderBaseUnit": "PCS", // BOM报头基本计量单位
                "BOMHeaderQuantityInBaseUnit": "1.000", // BOM报头基本单位数量
                "RecordCreationDate": "/Date(1778457600000)/", // 记录创建日期
                "LastChangeDate": null, // 最后更改日期
                "CreatedByUser": "CB9980000003", // 创建者
                "LastChangedByUser": "", // 最后更改者
                "BOMIsToBeDeleted": "", // BOM待删除
                "BOMIsArchivedForDeletion": false, // BOM归档删除
                "DocumentIsCreatedByCAD": false, // CAD创建文档
                "LaboratoryOrDesignOffice": "", // 实验室/设计办公室
                "LastChangeDateTime": "/Date(1778493363352+0000)/", // 最后更改日期时间
                "ProductDescription": "GL-MT3000/半成品/V1.0版本", // 物料描述
                "PlantName": "深圳广联智通工厂", // 工厂名称
                "BillOfMaterialHdrDetailsText": "", // BOM报头详细信息文本
                "SelectedBillOfMaterialVersion": "", // 选中BOM版本
                "to\_BillOfMaterialItem": { // BOM项目
                    "results": [
                        {
                            "\_\_metadata": {
                                "id": "https://my201453-api.s4hana.sapcloud.cn/sap/opu/odata/sap/API\_BILL\_OF\_MATERIAL\_SRV;v=0002/MaterialBOMItem(BillOfMaterial='00000002',BillOfMaterialCategory='M',BillOfMaterialVariant='1',BillOfMaterialVersion='',BillOfMaterialItemNodeNumber='1',HeaderChangeDocument='',Material='133-001-01001',Plant='1011')",
                                "uri": "https://my201453-api.s4hana.sapcloud.cn/sap/opu/odata/sap/API\_BILL\_OF\_MATERIAL\_SRV;v=0002/MaterialBOMItem(BillOfMaterial='00000002',BillOfMaterialCategory='M',BillOfMaterialVariant='1',BillOfMaterialVersion='',BillOfMaterialItemNodeNumber='1',HeaderChangeDocument='',Material='133-001-01001',Plant='1011')",
                                "type": "API\_BILL\_OF\_MATERIAL\_SRV.MaterialBOMItemType",
                                "etag": "W/\"'SADL-202605110956033606220C\~20260511095603.3606220'\""
                            },
                            "ConvertItem\_ac": true, // 转换项目（操作标记）
                            "DeleteBOMItemWithECN\_ac": true, // 通过ECN删除BOM项（操作标记）
                            "UpdateBOMItemWithECN\_ac": true, // 通过ECN更新BOM项（操作标记）
                            "Delete\_mc": true, // 删除（操作标记）
                            "Update\_mc": true, // 更新（操作标记）
                            "to\_BillOfMaterialItemLongText\_oc": true, // BOM项目长文本导航（操作标记）
                            "to\_BOMItmObjDependencyAssignment\_oc": true, // BOM项目对象依赖分配导航（操作标记）
                            "to\_BOMSubItems\_oc": true, // BOM子项导航（操作标记）
                            "BillOfMaterial": "00000002", // BOM号
                            "BillOfMaterialCategory": "M", // BOM类别
                            "BillOfMaterialVariant": "1", // BOM用途
                            "BillOfMaterialVersion": "", // BOM版本
                            "BillOfMaterialItemNodeNumber": "1", // BOM项目节点编号
                            "HeaderChangeDocument": "", // 报头变更单据
                            "Material": "133-001-01001", // 物料号
                            "Plant": "1011", // 工厂
                            "BillOfMaterialItemUUID": "00163e24-21bd-1fe1-93a0-b0ee4656c85c", // BOM项目UUID
                            "BillOfMaterialHeaderUUID": "00163e24-21bd-1fe1-93a0-f4b6b386885c", // BOM报头UUID
                            "BOMItemInternalChangeCount": "2", // BOM项目内部变更计数
                            "ValidityStartDate": "/Date(1777593600000)/", // 有效期开始日期
                            "ValidityEndDate": "/Date(253402214400000)/", // 有效期结束日期
                            "EngineeringChangeDocForEdit": "", // 用于编辑的工程变更单
                            "EngineeringChangeDocument": "", // 工程变更单号
                            "ChgToEngineeringChgDocument": "", // 工程变更单变更
                            "InheritedNodeNumberForBOMItem": "1", // BOM项目继承节点编号
                            "BOMItemRecordCreationDate": "/Date(1778457600000)/", // BOM项目创建日期
                            "BOMItemCreatedByUser": "CB9980000003", // BOM项目创建者
                            "BOMItemLastChangeDate": "/Date(1778457600000)/", // BOM项目最后更改日期
                            "BOMItemLastChangedByUser": "CB9980000003", // BOM项目最后更改者
                            "BillOfMaterialComponent": "132-001-01001", // BOM组件物料号
                            "BillOfMaterialItemCategory": "L", // BOM项目类别（L=库存物料）
                            "BillOfMaterialItemNumber": "0010", // BOM项目号
                            "BillOfMaterialItemUnit": "PCS", // BOM项目单位
                            "BillOfMaterialItemQuantity": "1.000", // BOM项目数量
                            "IsAssembly": "X", // 装配件
                            "IsSubItem": false, // 子项目
                            "BOMItemSorter": "", // BOM项目排序串
                            "FixedQuantity": false, // 固定数量
                            "BOMItemHasFixedQuantity": false, // BOM项目固定数量
                            "PurchasingGroup": "", // 采购组
                            "Currency": "", // 货币
                            "MaterialComponentPrice": "0.00", // 物料组件价格
                            "IdentifierBOMItem": "00000001", // BOM项目标识
                            "MaterialPriceUnitQty": "0", // 物料价格单位数量
                            "ComponentScrapInPercent": "0.00", // 组件废品率百分比
                            "OperationScrapInPercent": "0.00", // 工序废品率百分比
                            "IsNetScrap": false, // 净废品
                            "NumberOfVariableSizeItem": "0.000", // 可变尺寸项目数量
                            "QuantityVariableSizeItem": "0.000", // 可变尺寸项目数量
                            "FormulaKey": "", // 公式键
                            "ComponentDescription": "上壳组件/106.9\*82.91\*27.88mm/ABS+PC/浅蓝色", // 组件描述
                            "BOMItemDescription": "", // BOM项目描述
                            "BOMItemText2": "", // BOM项目文本2
                            "MaterialGroup": "", // 物料组
                            "DocumentType": "", // 文档类型
                            "DocNumber": "", // 文档编号
                            "DocumentVersion": "", // 文档版本
                            "DocumentPart": "", // 文档部件
                            "ClassNumber": "", // 分类编号
                            "ClassType": "", // 分类类型
                            "ResultingItemCategory": "", // 结果项目类别
                            "DependencyObjectNumber": "0", // 依赖对象编号
                            "ObjectType": "1", // 对象类型
                            "IsClassificationRelevant": false, // 分类相关
                            "IsBulkMaterial": false, // 散装物料
                            "BOMItemIsSparePart": "", // BOM项目备件
                            "BOMItemIsSalesRelevant": "", // BOM项目销售相关
                            "IsProductionRelevant": true, // 生产相关
                            "BOMItemIsPlantMaintRelevant": false, // BOM项目工厂维护相关
                            "BOMItemIsCostingRelevant": "X", // BOM项目成本核算相关
                            "IsEngineeringRelevant": false, // 工程相关
                            "SpecialProcurementType": "", // 特殊采购类型
                            "IsBOMRecursiveAllowed": false, // 允许递归BOM
                            "OperationLeadTimeOffset": "0", // 工序提前时间偏移
                            "OpsLeadTimeOffsetUnit": "", // 工序提前时间偏移单位
                            "IsMaterialProvision": "", // 物料供应
                            "BOMIsRecursive": false, // 递归BOM
                            "DocumentIsCreatedByCAD": false, // CAD创建文档
                            "DistrKeyCompConsumption": "", // 组件消耗分配码
                            "DeliveryDurationInDays": "0", // 交货天数
                            "Creditor": "", // 供应商
                            "CostElement": "", // 成本要素
                            "Size1": "0.000", // 尺寸1
                            "Size2": "0.000", // 尺寸2
                            "Size3": "0.000", // 尺寸3
                            "UnitOfMeasureForSize1To3": "", // 尺寸1-3计量单位
                            "GoodsReceiptDuration": "0", // 收货持续时间
                            "PurchasingOrganization": "", // 采购组织
                            "RequiredComponent": false, // 必需组件
                            "MultipleSelectionAllowed": false, // 允许多选
                            "ProdOrderIssueLocation": "", // 生产订单发货地点
                            "MaterialIsCoProduct": false, // 联产品物料
                            "ExplosionType": "", // 展开类型
                            "AlternativeItemGroup": "", // 替代项目组
                            "AlternativeItemPriority": "0", // 替代项目优先级
                            "AlternativeItemStrategy": "", // 替代策略
                            "UsageProbabilityPercent": "0", // 使用概率百分比
                            "FollowUpGroup": "", // 后续组
                            "DiscontinuationGroup": "", // 终止组
                            "IsConfigurableBOM": "", // 可配置BOM
                            "ReferencePoint": "", // 参考点
                            "LeadTimeOffset": "0", // 提前时间偏移
                            "ProductionSupplyArea": "", // 生产供应区域
                            "IsDeleted": false, // 已删除
                            "IsALE": false, // ALE
                            "LastChangeDateTime": "/Date(1778493363360+0000)/", // 最后更改日期时间
                            "PreliminaryComponent": "", // 初步组件
                            "YY1\_RefDesignaor1\_BMI": "", // 自定义字段-参考设计
                            "to\_BillOfMaterialItemLongText": { // BOM项目长文本
                                "\_\_deferred": { ... }
                            },
                            "to\_BOMItemCategory": { // BOM项目类别
                                "\_\_deferred": { ... }
                            },
                            "to\_BOMItmObjDependencyAssignment": { // BOM项目对象依赖分配
                                "\_\_deferred": { ... }
                            },
                            "to\_BOMSubItems": { // BOM子项目
                                "\_\_deferred": { ... }
                            },
                            "to\_BillOfMaterial": { // BOM主数据
                                "\_\_deferred": { ... }
                            }
                        }
                    ]
                },
                "to\_BillOfMaterialLongText": { // BOM长文本
                    "\_\_deferred": { ... }
                },
                "to\_BillOfMaterialUsage": { // BOM用途
                    "\_\_deferred": { ... }
                }
            }
        ]
    }
}

查询BOM变更的参数：

**请求方式**

Get

URL: https://my201453-api.s4hana.sapcloud.cn/sap/opu/odata/sap/API\_BILL\_OF\_MATERIAL\_SRV;v=0002/MaterialBOM?\$expand=to\_BillOfMaterialItem&\$filter=LastChangeDateTime ge datetimeoffset'2026-06-01T00:00:00Z' and LastChangeDateTime lt datetimeoffset'2026-06-09T00:00:00Z'

**Content-Type**

Json

**请求Header参数**

<table><tr><td><p>参数名</p></td><td><p>示例值</p></td><td><p>参数类型</p></td><td><p>是否必填</p></td><td><p>参数描述</p></td></tr><tr><td><p>Accept</p></td><td><p>application/json</p></td><td><p>string</p></td><td><p>是</p></td><td><p>-</p></td></tr><tr><td><p>x-csrf-token</p></td><td><p>Fetch</p></td><td><p>string</p></td><td><p>是</p></td><td></td></tr><tr><td><p>Accept-Language</p></td><td><p>ZH</p></td><td><p>String</p></td><td><p>是</p></td><td></td></tr></table>

![](images/a6b29dc27724b60344d55b2c21f1afcddb643438ee057a46f2b669f82ddd6bad.jpg)

**返回结果**

**响应示例**

**•成功(200 OK)**

![](images/ff68f88ca8889f222ed8e0176a89a5baae86cadc3aaec8834ad923d4332efa98.jpg)

**•失败(401 Unauthorized)**

<html>

<head>

<meta http-equiv="content-type" content="text/html; charset=windows-1252">

<title>Anmeldung fehlgeschlagen</title>

<style>

body {

background: #ffffff;

text-align: center;

width: 100%;

height: 100%;

overflow: hidden;

}

<a id="mpf3rr6916gxqaw6j52"></a>
## 5.4. **数据转换**

[仅接口程序类型需要，请在此处描述SAP系统和对方系统之间的数据匹配]

![](images/d135e2c6580d5bbe29a2767caab75f24bed91112680e7eafc8dce6b6ce4a9e02.png)

<a id="mpf3rr69d7m5067ypny"></a>
# 6. **测试数据**

[请在此处说明已经在开发环境准备好的可供程序员测试的数据]

<a id="mpf3rr69o3rgrhlaxym"></a>
# 7.  **附件或样本**

<a id="mpf3rr69hiuyvhd7k1e"></a>
# 8. **测试记录**

<table><tr><td><p>序号</p></td><td><p>CLIENT</p></td><td><p>测试人</p></td><td><p>测试日期</p></td><td><p>测试条件</p></td><td><p>预期测试结果</p></td><td><p>实际测试结果</p></td></tr><tr><td></td><td></td><td></td><td></td><td></td><td></td><td></td></tr><tr><td></td><td></td><td></td><td></td><td></td><td></td><td></td></tr><tr><td></td><td></td><td></td><td></td><td></td><td></td><td></td></tr></table>