- SAP Managed Tags:
背景介绍
- S/4HANA Cloud ERP云最新支持使用API来批量对固定资产的报废处理。
- 利用此服务，可对有收入和无收入的资产报废进行批量过账。新 API 是 OData 版本 4 服务。它属于通信场景 SAP_COM_0563。
- 通过该服务，您可以对以下交易进行过账：
- 含收入的资产报废（不集成到应收账款）和
- 无收入资产报废（例如在报废的情况下）
- 此服务涵盖的交易与“过账资产报废” (F7107) 应用中的交易相对应。
前提条件
在Business Accelerator Hub搜索对应API，可以查询到API Fixed Asset – Post Asset Retirement 相关的Communication Scenario是Finance - Fixed Asset Integration(SAP_COM_0563)。
在公有云系统的APP通信安排里，创建对应的通信安排。
测试场景
以下是6个有收入报废场景的详细介绍，#后是关键字段的注释。后续还会有无收入报废场景的介绍。
有收入报废场景
1. 手工收入-完全报废
Payload代码如下，根据实际情况更改：
{
"ReferenceDocumentItem": "000001",#一个资产报废是000001，第二个是000002，最多不超过000200；
"BusinessTransactionType": "RA20",#业务交易类型，RA20代表有收入报废；RA21代表无收入报废；
"CompanyCode": "1310",#公司代码
"MasterFixedAsset": "60000000",#主资产编号
"FixedAsset": "0",#资产子编号
"DocumentDate": "2024-04-30",#日记账分录日期
"PostingDate": "2024-04-30",#日记账过账日期
"AssetValueDate": "2024-04-30",#资产起息日
"FxdAstRetirementRevenueType": "1",#报废收入类型，1代表手工收入
"AstRevenueAmountInTransCrcy": 5000,#收入金额
"FxdAstRtrmtRevnTransCrcy": "CNY", #对应下一个字段10（公司代码货币）对应的货币
"FxdAstRtrmtRevnCurrencyRole": "10", #10代表公司代码货币，
"FixedAssetRetirementType": "1", #报废类型，1代表完全报废
"AccountingDocumentHeaderText": "Post with revenue-Manual",#凭证抬头文本
"DocumentItemText": "Complete Retirement"#凭证行项目文本
}
成功运行结果示例如下：
{
"@odata.context": "../$metadata#FixedAssetRetirement/$entity",
"@odata.metadataEtag": "W/\"20240504182908\"",
"FixedAssetPostingUUID": "f7a50ed1-d4ad-1eef-82ee-8f2b253a28a4",
"ReferenceDocumentItem": "1",
"CompanyCode": "1310",
"MasterFixedAsset": "60000000",
"FixedAsset": "0",
"AssetClass": "3200",
"DocumentDate": "2024-04-30",
"PostingDate": "2024-04-30",
"AssetValueDate": "2024-04-30",
"BusinessTransactionType": "RA20",
"DocumentReferenceID": "",
"AccountingDocumentHeaderText": "Post with revenue-Manual",
"FxdAstRetirementRevenueType": "1",
"AstRevenueAmountInTransCrcy": 5000.00,
"FxdAstRtrmtRevnTransCrcy": "CNY",
"FxdAstRtrmtRevnCurrencyRole": "10",
"FxdAstRevnDetnDeprArea": "0",
"FixedAssetRetirementType": "1",
"AstRtrmtAmtInTransCrcy": 0.00,
"FxdAstRetirementTransCrcy": "",
"FxdAstRetirementRatioInPercent": 0.00,
"FxdAstRtrmtQuantityInBaseUnit": 0.000,
"BaseUnitSAPCode": "",
"BaseUnitISOCode": "",
"FixedAssetYearOfAcqnCode": "",
"AccountingDocumentType": "",
"TradingPartner": "",
"AssignmentReference": "",
"DocumentItemText": "Complete Retirement",
"SAP__Messages": []
}
运行的截屏如下：
2. 手工收入-部分报废（按金额）
Payload代码如下，根据实际情况更改：
{
"ReferenceDocumentItem": "000001",
"BusinessTransactionType": "RA20",
"CompanyCode": "1310",
"MasterFixedAsset": "60000001",
"FixedAsset": "0",
"DocumentDate": "2024-04-30",
"PostingDate": "2024-04-30",
"AssetValueDate": "2024-04-30",
"FxdAstRetirementRevenueType": "1",#1代表手工收入
"AstRevenueAmountInTransCrcy": 80,
"FxdAstRtrmtRevnTransCrcy": "CNY",
"FxdAstRtrmtRevnCurrencyRole": "10",
"FixedAssetRetirementType": "2",#2代表部分报废（按金额）
"AstRtrmtAmtInTransCrcy": 80,
"FxdAstRetirementTransCrcy": "USD", #这里只能填写功能货币，如果没有配置功能货币，可以删除这一行；
"FixedAssetYearOfAcqnCode": "1", #资产购置财年，1代表报废的当年购置，2代表报废的往年购置；
"AccountingDocumentHeaderText": "Post with revenue-Manual",
"AccountingDocumentType": ""
}
成功运行结果示例如下：
{
"@odata.context": "../$metadata#FixedAssetRetirement/$entity",
"@odata.metadataEtag": "W/\"20240504182908\"",
"FixedAssetPostingUUID": "f7a50ed1-d4ad-1eef-82ef-413a2ecf68a4",
"ReferenceDocumentItem": "1",
"CompanyCode": "1310",
"MasterFixedAsset": "60000001",
"FixedAsset": "0",
"AssetClass": "3200",
"DocumentDate": "2024-04-30",
"PostingDate": "2024-04-30",
"AssetValueDate": "2024-04-30",
"BusinessTransactionType": "RA20",
"DocumentReferenceID": "",
"AccountingDocumentHeaderText": "Post with revenue-Manual",
"FxdAstRetirementRevenueType": "1",
"AstRevenueAmountInTransCrcy": 80.00,
"FxdAstRtrmtRevnTransCrcy": "CNY",
"FxdAstRtrmtRevnCurrencyRole": "10",
"FxdAstRevnDetnDeprArea": "0",
"FixedAssetRetirementType": "2",
"AstRtrmtAmtInTransCrcy": 80.00,
"FxdAstRetirementTransCrcy": "USD",
"FxdAstRetirementRatioInPercent": 0.00,
"FxdAstRtrmtQuantityInBaseUnit": 0.000,
"BaseUnitSAPCode": "",
"BaseUnitISOCode": "",
"FixedAssetYearOfAcqnCode": "1",
"AccountingDocumentType": "",
"TradingPartner": "",
"AssignmentReference": "",
"DocumentItemText": "",
"SAP__Messages": []
}
运行的截屏如下：
3.手工收入-部分报废（按百分比）
Payload代码如下，根据实际情况更改：
{
"ReferenceDocumentItem": "000001",
"AccountingDocumentHeaderText": "3.Partial Retirement",
"AssetValueDate": "2024-04-30",
"AstRevenueAmountInTransCrcy": 1000,
"BusinessTransactionType": "RA20",
"CompanyCode": "1310",
"DocumentDate": "2024-04-30",
"DocumentItemText": "3.Post with revenue-Manual",
"FixedAsset": "0",
"FixedAssetRetirementType": "3",#3代表部分报废（百分比）
"FixedAssetYearOfAcqnCode": "1",#资产购置财年，1代表报废的当年购置，2代表报废的往年购置；
"FxdAstRetirementRatioInPercent": 50,#报废百分比
"FxdAstRetirementRevenueType": "1",
"FxdAstRtrmtRevnCurrencyRole": "10",
"FxdAstRtrmtRevnTransCrcy": "CNY",
"MasterFixedAsset": "60000002",
"PostingDate": "2024-04-30"
}
成功运行结果示例如下：
{
"@odata.context": "../$metadata#FixedAssetRetirement/$entity",
"@odata.metadataEtag": "W/\"20240504182908\"",
"FixedAssetPostingUUID": "f7a50ed1-d4ad-1eef-82ee-a84b99e9a8a4",
"ReferenceDocumentItem": "1",
"CompanyCode": "1310",
"MasterFixedAsset": "60000002",
"FixedAsset": "0",
"AssetClass": "3200",
"DocumentDate": "2024-04-30",
"PostingDate": "2024-04-30",
"AssetValueDate": "2024-04-30",
"BusinessTransactionType": "RA20",
"DocumentReferenceID": "",
"AccountingDocumentHeaderText": "Partial Retirement",
"FxdAstRetirementRevenueType": "1",
"AstRevenueAmountInTransCrcy": 1000.00,
"FxdAstRtrmtRevnTransCrcy": "CNY",
"FxdAstRtrmtRevnCurrencyRole": "10",
"FxdAstRevnDetnDeprArea": "0",
"FixedAssetRetirementType": "3",
"AstRtrmtAmtInTransCrcy": 0.00,
"FxdAstRetirementTransCrcy": "",
"FxdAstRetirementRatioInPercent": 50.00,
"FxdAstRtrmtQuantityInBaseUnit": 0.000,
"BaseUnitSAPCode": "",
"BaseUnitISOCode": "",
"FixedAssetYearOfAcqnCode": "1",
"AccountingDocumentType": "",
"TradingPartner": "",
"AssignmentReference": "",
"DocumentItemText": "Post with revenue-Manual",
"SAP__Messages": []
}
运行的截屏如下：
4.收入来自折旧范围的净账面价值-完全报废
Payload代码如下，根据实际情况更改：
{
"ReferenceDocumentItem": "000001",
"AccountingDocumentHeaderText": "4.Post with revenue",
"AssetValueDate": "2024-04-30",
"BusinessTransactionType": "RA20",
"CompanyCode": "1310",
"DocumentDate": "2024-04-30",
"DocumentItemText": "4.Post with revenue-Manual",
"FixedAsset": "0",
"FixedAssetRetirementType": "1",
"FxdAstRevnDetnDeprArea": "01",#折旧范围选择以01
"FxdAstRetirementRevenueType": "2",#2代表收入来自折旧范围的净账面价值
"MasterFixedAsset": "60000003",
"PostingDate": "2024-04-30"
}
成功运行结果示例如下：
{
"@odata.context": "../$metadata#FixedAssetRetirement/$entity",
"@odata.metadataEtag": "W/\"20240504182908\"",
"FixedAssetPostingUUID": "f7a50ed1-d4ad-1eef-82ee-e9177fe3e8a4",
"ReferenceDocumentItem": "1",
"CompanyCode": "1310",
"MasterFixedAsset": "60000003",
"FixedAsset": "0",
"AssetClass": "3200",
"DocumentDate": "2024-04-30",
"PostingDate": "2024-04-30",
"AssetValueDate": "2024-04-30",
"BusinessTransactionType": "RA20",
"DocumentReferenceID": "",
"AccountingDocumentHeaderText": "4.Post with revenue",
"FxdAstRetirementRevenueType": "2",
"AstRevenueAmountInTransCrcy": 0.00,
"FxdAstRtrmtRevnTransCrcy": "",
"FxdAstRtrmtRevnCurrencyRole": "",
"FxdAstRevnDetnDeprArea": "1",
"FixedAssetRetirementType": "1",
"AstRtrmtAmtInTransCrcy": 0.00,
"FxdAstRetirementTransCrcy": "",
"FxdAstRetirementRatioInPercent": 0.00,
"FxdAstRtrmtQuantityInBaseUnit": 0.000,
"BaseUnitSAPCode": "",
"BaseUnitISOCode": "",
"FixedAssetYearOfAcqnCode": "",
"AccountingDocumentType": "",
"TradingPartner": "",
"AssignmentReference": "",
"DocumentItemText": "4.Post with revenue-Manual",
"SAP__Messages": []
}
运行的截屏如下：
5. 收入来自折旧范围的净账面价值-部分报废（按金额）
Payload代码如下，根据实际情况更改：
{
"ReferenceDocumentItem": "000001",
"AccountingDocumentHeaderText": "5.Post with revenue",
"AssetValueDate": "2024-04-30",
"AstRtrmtAmtInTransCrcy": 1000,
"BusinessTransactionType": "RA20",
"CompanyCode": "1310",
"DocumentDate": "2024-04-30",
"DocumentItemText": "5.Post with revenue-Manual",
"FixedAsset": "0",
"FixedAssetRetirementType": "2",
"FixedAssetYearOfAcqnCode": "1", #资产购置财年，1代表报废的当年购置，2代表报废的往年购置；
"FxdAstRetirementRevenueType": "2",
"FxdAstRetirementTransCrcy": "USD", #这里只能填写功能货币，如果没有配置功能货币，可以删除这一行；
"FxdAstRevnDetnDeprArea": "01",
"MasterFixedAsset": "60000004",
"PostingDate": "2024-04-30"
}
成功运行结果示例如下：
{
"@odata.context": "../$metadata#FixedAssetRetirement/$entity",
"@odata.metadataEtag": "W/\"20240504182908\"",
"FixedAssetPostingUUID": "f7a50ed1-d4ad-1eef-82ef-2575af0d88a4",
"ReferenceDocumentItem": "1",
"CompanyCode": "1310",
"MasterFixedAsset": "60000004",
"FixedAsset": "0",
"AssetClass": "3200",
"DocumentDate": "2024-04-30",
"PostingDate": "2024-04-30",
"AssetValueDate": "2024-04-30",
"BusinessTransactionType": "RA20",
"DocumentReferenceID": "",
"AccountingDocumentHeaderText": "5.Post with revenue",
"FxdAstRetirementRevenueType": "2",
"AstRevenueAmountInTransCrcy": 0.00,
"FxdAstRtrmtRevnTransCrcy": "",
"FxdAstRtrmtRevnCurrencyRole": "",
"FxdAstRevnDetnDeprArea": "1",
"FixedAssetRetirementType": "2",
"AstRtrmtAmtInTransCrcy": 1000.00,
"FxdAstRetirementTransCrcy": "USD",
"FxdAstRetirementRatioInPercent": 0.00,
"FxdAstRtrmtQuantityInBaseUnit": 0.000,
"BaseUnitSAPCode": "",
"BaseUnitISOCode": "",
"FixedAssetYearOfAcqnCode": "1",
"AccountingDocumentType": "",
"TradingPartner": "",
"AssignmentReference": "",
"DocumentItemText": "5.Post with revenue-Manual",
"SAP__Messages": []
}
运行的截屏如下：
6.收入来自折旧范围的净账面价值-部分报废（按百分比）
Payload代码如下，根据实际情况更改：
{
"ReferenceDocumentItem": "000001",
"AccountingDocumentHeaderText": "6.Post with revenue",
"AssetValueDate": "2024-04-30",
"BusinessTransactionType": "RA20",
"CompanyCode": "1310",
"DocumentDate": "2024-04-30",
"DocumentItemText": "6.Post with revenue-Manual",
"FixedAsset": "0",
"FixedAssetRetirementType": "3",#
"FixedAssetYearOfAcqnCode": "1", #资产购置财年，1代表报废的当年购置，2代表报废的往年购置；
"FxdAstRetirementRatioInPercent": 50,
"FxdAstRetirementRevenueType": "2",
"FxdAstRevnDetnDeprArea": "01",
"MasterFixedAsset": "60000005",
"PostingDate": "2024-04-30"
}
成功运行结果示例如下：
{
"@odata.context": "../$metadata#FixedAssetRetirement/$entity",
"@odata.metadataEtag": "W/\"20240504182908\"",
"FixedAssetPostingUUID": "f7a50ed1-d4ad-1eef-82ef-2f28a9cfa8a4",
"ReferenceDocumentItem": "1",
"CompanyCode": "1310",
"MasterFixedAsset": "60000005",
"FixedAsset": "0",
"AssetClass": "3200",
"DocumentDate": "2024-04-30",
"PostingDate": "2024-04-30",
"AssetValueDate": "2024-04-30",
"BusinessTransactionType": "RA20",
"DocumentReferenceID": "",
"AccountingDocumentHeaderText": "6.Post with revenue",
"FxdAstRetirementRevenueType": "2",
"AstRevenueAmountInTransCrcy": 0.00,
"FxdAstRtrmtRevnTransCrcy": "",
"FxdAstRtrmtRevnCurrencyRole": "",
"FxdAstRevnDetnDeprArea": "1",
"FixedAssetRetirementType": "3",
"AstRtrmtAmtInTransCrcy": 0.00,
"FxdAstRetirementTransCrcy": "",
"FxdAstRetirementRatioInPercent": 50.00,
"FxdAstRtrmtQuantityInBaseUnit": 0.000,
"BaseUnitSAPCode": "",
"BaseUnitISOCode": "",
"FixedAssetYearOfAcqnCode": "1",
"AccountingDocumentType": "",
"TradingPartner": "",
"AssignmentReference": "",
"DocumentItemText": "6.Post with revenue-Manual",
"SAP__Messages": []
}
运行的截屏如下：
总结
以上几个有收入业务场景的payload的字段准备，大部分字段一致，有个别字段根据场景不一样会有所区别，使用当中可以对比分析灵活使用。
