Title: API for Supplier Master and Supplier Bank Account maintenance in S/4HANA Public Cloud Edition

[byd]

Title: API for Supplier Master and Supplier Bank Account maintenance in S/4HANA Public Cloud Edition

Question:

Hello SAP Community,

I am working on an S/4HANA Public Cloud Edition implementation project and would like to know if there are APIs available for the following:

Supplier Master creation and update - Is there an API (OData or SOAP) to create and update Supplier Master records in S/4HANA Public Cloud Edition?
Supplier Bank Account maintenance - If a Supplier Master API exists, does it also support creating and updating the Supplier's Bank Account information? Or is there a separate API for maintaining Supplier Bank Accounts?
We are planning to integrate with an external system and need to programmatically maintain supplier data including their banking details.

Any information about API names, API Hub references, or documentation links would be greatly appreciated.

Thank you in advance for your help.

Best regards

[dawid90]

Dear @byd,

Yes in Public Cloud you do have standard APIs for both supplier master and supplier bank data. Everything is driven via Business Partner.

Supplier master creation and update:

The main API is: OData (recommended)

API name:
Business Partner (A2X) – technical name API_BUSINESS_PARTNER

More details below:

https://help.sap.com/docs/SAP_S4HANA_CLOUD/3c916ef10fc240c9afc594b346ffaf77/85043858ea0f9244e1000000...

https://api.sap.com/package/SAPS4HANACloud/odata

What it can do:

This single OData service lets you create, read, update, delete master data for:

• Business Partner header (A_BusinessPartner)
• Supplier core data (A_Supplier)
• Supplier company data (A_SupplierCompany)
• Supplier purchasing data (A_SupplierPurchasingOrg)
• Business partner roles (A_BusinessPartnerRole)

More details below from SAP Help and SAP Community for Custom Fields:

https://help.sap.com/docs/SAP_S4HANA_CLOUD/3c916ef10fc240c9afc594b346ffaf77/1e488b3c40ff4ed3a96be20d...

https://community.sap.com/t5/enterprise-resource-planning-blog-posts-by-sap/add-custom-fields-to-sap...

So for a typical create or update supplier scenario you:

1. Create / update the Business Partner header
• POST /sap/opu/odata/sap/API_BUSINESS_PARTNER/A_BusinessPartner (create)
• PATCH /sap/opu/odata/sap/API_BUSINESS_PARTNER/A_BusinessPartner('<BP>') (update)
2. Assign supplier roles to that BP
• POST .../A_BusinessPartner('<BP>')/to_BusinessPartnerRole
• Use roles like FLVN00 (FI vendor) / FLVN01 (supplier) depending on your design.
3. Maintain supplier-specific data
• A_Supplier – core supplier data
• A_SupplierCompany – reconciliation account, payment terms, etc. per company code
• A_SupplierPurchasingOrg – purchasing org data (order currency, incoterms, etc.)

For your integration use case (external system maintaining suppliers) this OData API is the standard and recommended approach in Public Cloud.

Supplier bank account maintenance:

Bank data is also covered by the same Business Partner (A2X) service there is no separate Supplier Bank API.

API_BUSINESS_PARTNER you have the entity:

• A_BusinessPartnerBank – BusinessPartnerBank

More details below:

https://help.sap.com/docs/SAP_S4HANA_CLOUD/3c916ef10fc240c9afc594b346ffaf77/5d5e045826552246e1000000...

It contains fields such as:

• Business partner
• Bank country
• Bank account / IBAN

Typical operations:

• Create bank account for a supplier BP
  POST /sap/opu/odata/sap/API_BUSINESS_PARTNER/A_BusinessPartnerBank
• Update bank account
  PATCH /sap/opu/odata/sap/API_BUSINESS_PARTNER/A_BusinessPartnerBank(BusinessPartner='<BP>',BankIdentification='<ID>')

The bank itself is separate and managed via Manage Banks Master Data app. Your supplier’s bank account record in A_BusinessPartnerBank references that bank by country and bank key / ID.

More details below:

https://fioriappslibrary.hana.ondemand.com/sap/fix/externalViewer/#/detail/Apps('F6437')/S35

https://help.sap.com/docs/SAP_S4HANA_CLOUD/f86dc2eb1f8b48c880a7607213104b27/0e2291626ec34988876ef021...

How to set it up in Public Cloud:

The high-level steps:

1. Create Communication User and System (Fiori apps: Maintain Communication Users, Communication Systems).

More details below:

https://developers.sap.com/tutorials/abap-environment-business-partner-basic-auth..html

1. Create Communication Arrangement for SAP_COM_0008
• This exposes Business Partner (A2X) OData as inbound service.
2. Use the generated service URL like:
   https://<your-tenant>/sap/opu/odata/sap/API_BUSINESS_PARTNER/ in your integration.

https://api.sap.com/api/API_BUSINESS_PARTNER/resource/get_A_BusinessPartner

Best Regards,

Dawid