Voraussetzungen & Zugang
Was im SAP-System und in BTP vorhanden sein muss, bevor der erste Abruf laufen kann.
Im SAP-System
| Voraussetzung | Warum | Nachweis |
|---|---|---|
| Release ≥ 2302 (On-Premise oder Private Cloud) | Die Contract-Accounting-APIs, die den offenen Posten liefern, gibt es ab diesem Release. | Systemstatus |
OData-Services aktiv (/IWFND/MAINT_SERVICE): API_BUSINESS_PARTNER, CONTRACTACCOUNT_0001, CADOCUMENTMANAGE_0001, API_CABUSPARTINVOICE_0002, API_CABUSPARTPAYMENT_0002, CADUNNING_0001 | Die sechs Quellen. | $metadata je Service erreichbar |
| Technischer Benutzer, nur lesen | Dokument- und Payment-API könnten schreiben. Der Benutzer darf es nicht — Anzeige-Berechtigung auf FI-CA-Belege, Vertragskonto und Geschäftspartner, kein Anlegen, kein Ändern. | POST auf einen Service → 403 |
| CDS-View für Abschlagsraten mit OData-Freigabe | Für künftige Raten gibt es keine Standard-API (siehe Seite CDS-View). | Service im Katalog |
| QA-System mit denselben Services | Gebaut und getestet wird gegen QA, nie gegen Produktion. | Zugang über eine zweite Destination |
In SAP BTP
Der Cloud Connector öffnet das System nach BTP hinein. Ein Sammler außerhalb von BTP braucht deshalb eine Fassade:
Weg A (empfohlen): API Management. Je OData-Service ein API-Proxy in der Integration Suite; der Proxy nutzt Destination + Connectivity zum On-Prem-System; der Sammler ruft den Proxy mit OAuth 2.0 Client Credentials (XSUAA) auf. Rate-Limits, Quotas, Protokollierung und Schlüsselrotation an einer Stelle.
Weg B: Sammler in BTP. Der Sammler läuft als Job in Cloud Foundry oder Kyma und spricht Destination + Connectivity nativ. Kein API Management nötig, dafür eine zweite Laufzeitumgebung im Betrieb.
Welcher Weg gewählt wird, wird im Fragenkatalog „System & Zugang" beantwortet; die übrige Einrichtung ist für beide Wege gleich.
Zugangsdaten
Zugangsdaten, Zertifikate und Schlüssel werden nie über die Fragenkataloge oder E-Mail übermittelt. Bilendo stellt einen separaten, sicheren Kanal bereit; im IMS stehen nur die Namen der Secrets.