Symptom
Using the OData API_BUSINESS_PARTNER, upon trying to create a Business Partner in the S/4HANA Cloud system, the system throws the error:
Language Key (KNA1-SPRAS) is a required entry field
Environment
SAP S/4HANA Cloud
Reproducing the Issue
To perform the POST call:
- Login to the third-party tool
- Perform a POST operation for the API Business Partner - Replicate from Client to SAP S/4HANA Cloud
Example of the query:
https://myxxxxxx-adm.s4hana.ondemand.com/sap/bc/srt/scs_ext/sap/businesspartnersuitebulkreplic?MessageId=${=java.util.UUID.randomUUID()}
where xxxxxx represents the tenant URL of the S/4HANA cloud system
Sample Request Payload as below:
--------------------------------------------------------------
{
"BusinessPartner": "string",
"AcademicTitle": "stri",
"AuthorizationGroup": "stri",
"BusinessPartnerCategory": "s",
"BusinessPartnerGrouping": "stri",
.
.
.
"Language": "st",
.
.
.
.
}
--------------------------------------------------------------
System throws the error:
--------------------------------------------------------------
<?xml version="1.0" encoding="utf-8"?>
<error xmlns="http://schemas.microsoft.com/ado/2007/08/dataservices/metadata">
<code>CVI_API/003</code>
<message xml:lang="en">Language Key (KNA1-SPRAS) is a required entry field</message>
.
.
.
</error>
--------------------------------------------------------------
Cause
The standard communication which is the Correspondence Language is not passed in the Request Payload
<CorrespondenceLanguage></CorrespondenceLanguage>
Resolution
To solve the reported error, provide the Correspondence Language in the Request Payload and execute to create the Business Partner.
Note:
In the Request Payload, the "CorrespondenceLanguage": "st", refers to the Correspondence language (written) for Business Partners in the 'Person' category. Maintain the correspondence language for Business Partners in the 'Organization' and 'Group' category with the address (communication).
When transferring data (direct input), ensure that for a 'Person', the field 'LANGU_CORR' and for an 'Organization' or "Group" the field 'LANGU' has an entry.
Data Element: BU_LANGU_CORR
The "Language": "st", refers to the Language for verbal communication with a Business Partner. This language may differ from the language(s) defined for written correspondence.
Data Element: BU_LANGU
See Also
Keywords
Correspondence Language, BU_LANGU, Person, BU_LANGU_CORR, Language, Business Partner, SPRAS, Organization, API_BUSINESS_PARTNER, OData, KNA1 , KBA , AP-MD-BP-RL , Business Partner Roles , Problem