- SAP Managed Tags:
目录
背景介绍...
前提条件...
测试场景...
测试响应...
背景介绍
API “日记账分录 – 过账（同步）”， 技术名称：JournalEntryCreateRequestConfirmation_In
使用此内向服务将日记账分录从外部系统同步过账到您的 SAP S/4HANA Cloud 系统。可根据业务需求扩展此服务。
本篇及系列博客介绍基于API “日记账分录 – 过账（同步）可以实现的场景，本篇介绍供应商发票。
前提条件
根据链接，通过 APP – 通信安排来创建场景标识是 SAP_COM_0002 的通信安排。在创建通信安排前，需要先创建通信系统，可以参考如下链接。在创建通信安排时，需要为通信安排绑定创建好的通信系统。通信系统中维护的通信用户，用于在 API 测试时的认证授权。
可以通过链接访问 Business Acceleration Hub ，查看该 API 相关信息。通过链接访问该 API 的业务文档，来查看本 API 支持的字段等详细的细节信息。
测试场景
关于本案例更详细的业务部分分析，请参见Blog-浅析API日记账分录-过账可以实现的场景-业务篇：应付账款(三) 供应商发票。
在使用测试工具进行测试前，需要进行一些配置上的维护。由于我们测试对象是 SOAP 类型的 API ，所以我们需要在 Headers 里添加字段 SOAPAction ，值为 “#POST” 。同时，因为我们的 Request Body 使用的是 xml 类型，因此我们也需要添加字段 Content-Type ，值为 test/xml 。
在 Headers 中进行配置
在填写好发送请求的 url 以及通信用户的 Username 和 Password 后，我们就可以填入 Payload 发送 API 请求。以下是用于本场景的 Example Payload: Vendor Invoice，经过 API 工具的测试生成供应商贷方凭证。
在该 Payload 里，部分字段需要根据实际业务需求和系统实际情况自行调整，可参考下表：
| 字段名 | 示例值 |
| AccountingDocumentType | KR |
| DocumentReferenceID | 123 |
| DocumentHeaderText | RES Clear with Discount |
| CreatedByUser | APITEST |
| CompanyCode | 1310 |
| DocumentDate | 2023-07-31 |
| PostingDate | 2023-07-31 |
| TaxDeterminationDate | 2023-07-31 |
| GLAccount | 61003000 |
| AssignmentReference | RES Clear w Disc |
| DocumentItemText | Test Item |
| Creditor | 13300001 |
| TaxCode | J2 |
| TaxCountry | CN |
| AmountInTransactionCurrency | 885 |
| AmountInTransactionCurrency currencyCode | CNY |
| AmountInTransactionCurrency | 1000 |
| AmountInTransactionCurrency currencyCode | CNY |
| DocumentItemText | Vender item |
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:sfin="http://sap.com/xi/SAPSCORE/SFIN">
<soapenv:Header/>
<soapenv:Body>
<sfin:JournalEntryBulkCreateRequest>
<MessageHeader>
<ID>MSG_2023-07-31</ID>
<!--<ReferenceID></ReferenceID>-->
<CreationDateTime>2023-07-31T12:00:00.1234567Z</CreationDateTime>
<SenderBusinessSystemID>SHGMA04</SenderBusinessSystemID>
<!--<TestDataIndicator>true</TestDataIndicator>-->
</MessageHeader>
<!--1 or more repetitions:-->
<JournalEntryCreateRequest>
<MessageHeader>
<ID>SUB_MSG_2023-07-31</ID>
<!--<ReferenceID></ReferenceID>-->
<CreationDateTime>2023-07-31T12:00:00.1234567Z</CreationDateTime>
</MessageHeader>
<JournalEntry>
<OriginalReferenceDocumentType>BKPFF</OriginalReferenceDocumentType>
<OriginalReferenceDocument/>
<OriginalReferenceDocumentLogicalSystem/>
<BusinessTransactionType>RFBU</BusinessTransactionType>
<AccountingDocumentType>KR</AccountingDocumentType>
<DocumentReferenceID>123</DocumentReferenceID>
<DocumentHeaderText>RES Clear with Discount</DocumentHeaderText>
<DoTaxAmountCheck>true</DoTaxAmountCheck>
<CreatedByUser>APITEST</CreatedByUser>
<CompanyCode>1310</CompanyCode>
<DocumentDate>2023-07-31</DocumentDate>
<PostingDate>2023-07-31</PostingDate>
<TaxDeterminationDate>2023-07-31</TaxDeterminationDate>
<!--<Reference1InDocumentHeader>12345678901234567890</Reference1InDocumentHeader>-->
<!--<Reference2InDocumentHeader>1234567890</Reference2InDocumentHeader>-->
<Item>
<!--Optional:-->
<ReferenceDocumentItem>1</ReferenceDocumentItem>
<GLAccount>61003000</GLAccount>
<AmountInTransactionCurrency currencyCode="CNY">885</AmountInTransactionCurrency>
<DebitCreditCode>S</DebitCreditCode>
<DocumentItemText>Test Item</DocumentItemText>
<AssignmentReference>RES Clear w Disc</AssignmentReference>
<Tax>
<TaxCode>J2</TaxCode>
<TaxCountry>CN</TaxCountry>
</Tax>
<AccountAssignment>
<CostCenter>0013101101</CostCenter>
</AccountAssignment>
<!--Optional:-->
<!--<Material></Material>-->
<!--Optional:-->
<!--<QuantityInEntryUnit unitCode="M3">0</QuantityInEntryUnit>-->
</Item>
<!--Zero or more repetitions:-->
<CreditorItem>
<ReferenceDocumentItem>2</ReferenceDocumentItem>
<Creditor>13300001</Creditor>
<AmountInTransactionCurrency currencyCode="CNY">-1000</AmountInTransactionCurrency>
<DebitCreditCode>H</DebitCreditCode>
<DocumentItemText>Vender item</DocumentItemText>
<AssignmentReference>RES Clear w Disc</AssignmentReference>
</CreditorItem>
<ProductTaxItem>
<TaxCode>J2</TaxCode>
<TaxItemClassification>VST</TaxItemClassification>
<TaxCountry>CN</TaxCountry>
<AmountInTransactionCurrency currencyCode="CNY">115</AmountInTransactionCurrency>
<DebitCreditCode>S</DebitCreditCode>
<TaxBaseAmountInTransCrcy currencyCode="CNY">885</TaxBaseAmountInTransCrcy>
</ProductTaxItem>
</JournalEntry>
</JournalEntryCreateRequest>
</sfin:JournalEntryBulkCreateRequest>
</soapenv:Body>
</soapenv:Envelope><ProductTaxItem>这部分 TaxCode 需要根据情况来修改，保证平衡。
本 API 支持创建多个日记账。参考下图，如果添加多段 13 ~ 73 行的 <JournalEntryCreateRequest> 部分的内容，则可以同时创建多个日记账。
批量创建日记账
测试响应
测试 SOAP 类型的 API 与 ODATA 类型的 API 有一点不同的是，无法通过返回的状态码来判断我们是否成功运行，因为运行成功后状态码都是 200 (除了 Username 和 Password 不正确的情况返回状态码 401 )。因此我们需要检查运行 API 后的 Response Body 进行判断。如果 <JournalEntryCreateConfirmation> 中的 AccountingDocument 值为 0000000000 ，则说明创建不成功。我们可以根据 Response Body 后面的提示内容对我们的 Payload 进行修正。
如下是成功创建日记账时返回的 Response ，会返回创建成功的会计凭证号。
<soap-env:Envelope
xmlns:soap-env="http://schemas.xmlsoap.org/soap/envelope/">
<soap-env:Header/>
<soap-env:Body>
<n0:JournalEntryBulkCreateConfirmation
xmlns:n0="http://sap.com/xi/SAPSCORE/SFIN"
xmlns:prx="urn:sap.com:proxy:CCF:/1SAI/TAS3D871C7855B59197A671:795">
<MessageHeader>
<UUID>cdc0d72f-cfa9-1ede-9cc2-019dd7163c2c</UUID>
<ReferenceID>MSG_2023-07-31</ReferenceID>
<CreationDateTime>2023-10-24T01:52:56.449332Z</CreationDateTime>
<SenderBusinessSystemID>CCF</SenderBusinessSystemID>
<RecipientBusinessSystemID>SHGMA04</RecipientBusinessSystemID>
</MessageHeader>
<ConfirmationInterfaceOrignName/>
<JournalEntryCreateConfirmation>
<MessageHeader>
<UUID>cdc0d72f-cfa9-1ede-9cc2-019dd7165c2c</UUID>
<ReferenceID>SUB_MSG_2023-07-31</ReferenceID>
<CreationDateTime>2023-10-24T01:52:56.452549Z</CreationDateTime>
</MessageHeader>
<JournalEntryCreateConfirmation>
<AccountingDocument>1900000334</AccountingDocument>
<CompanyCode>1310</CompanyCode>
<FiscalYear>2023</FiscalYear>
</JournalEntryCreateConfirmation>
<Log>
<MaximumLogItemSeverityCode>2</MaximumLogItemSeverityCode>
<Item>
<TypeID>605(RW)</TypeID>
<SeverityCode>1</SeverityCode>
<Note>Document posted successfully: BKPFF 190000033413102023 0LEUD7I</Note>
<WebURI>http://ldciccf.wdf.sap.corp:50000/sap/xi/docu_apperror?ID=NA&OBJECT=RW605&LANGUAGE=E&MSGV1=BKPFF&MSGV2=190000033413102023&MSGV3=0LEUD7I</WebURI>
</Item>
<Item>
<TypeID>707(FF)</TypeID>
<SeverityCode>2</SeverityCode>
<Note>Tax entered incorrect (code J2, amount 115.00), correct 115.05 CNY</Note>
<WebURI>http://ldciccf.wdf.sap.corp:50000/sap/xi/docu_apperror?ID=NA&OBJECT=FF707&LANGUAGE=E&MSGV1=J2&MSGV2=%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20115.00&MSGV3=%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20115.05&MSGV4=CNY</WebURI>
</Item>
</Log>
</JournalEntryCreateConfirmation>
<Log/>
</n0:JournalEntryBulkCreateConfirmation>
</soap-env:Body>
</soap-env:Envelope>
