SAP BAH OpenAPI Backend (OpenClaw Upload Package)

Purpose

Use this skill to reliably download SAP API specification files from hub.sap.com.

Authentication:

• SAP_HUB_USERNAME
• SAP_HUB_PASSWORD

Downloaded files are written to:

• /usr/download/_openapi.json
• /usr/download/_openapi.yaml
• /usr/download/_odata.edmx

Prerequisites

1. Chromium available through Playwright.
2. Python 3.10+.
3. Python Playwright installed:

python3 -m pip install playwright
python3 -m playwright install chromium

1. Writable output directory /usr/download.

If needed:

sudo mkdir -p /usr/download
sudo chown "$USER":staff /usr/download

1. Maintain login credentials via environment variables:

export SAP_HUB_USERNAME='your_user'
export SAP_HUB_PASSWORD='your_password'

Security note:

• Do not upload real credentials to ClawHub.
• Maintain credentials only in the runtime environment.

How to start

Run from repository root:

python3 Skills/sap-bah-openapi-backend-openclaw-upload-1.0.0/scripts/reliable_sap_hub_download.py \
  --api-id WAREHOUSEORDER_0001

How to use

1) Download one or more API IDs

python3 Skills/sap-bah-openapi-backend-openclaw-upload-1.0.0/scripts/reliable_sap_hub_download.py \
  --api-id WAREHOUSEORDER_0001 \
  --api-id API_APAR_SEPA_MANDATE_SRV

2) Download from file list

python3 Skills/sap-bah-openapi-backend-openclaw-upload-1.0.0/scripts/reliable_sap_hub_download.py \
  --api-id-file /path/to/api_ids.txt

api_ids.txt example:

WAREHOUSEORDER_0001
API_APAR_SEPA_MANDATE_SRV
sap-s4-CE_EBPPPAYMENTREQUEST_0001-v1

3) Useful runtime options

python3 Skills/sap-bah-openapi-backend-openclaw-upload-1.0.0/scripts/reliable_sap_hub_download.py \
  --api-id WAREHOUSEORDER_0001 \
  --retries 4 \
  --timeout-seconds 90 \
  --json-report /usr/download/sap_download_report.json

4) Import downloaded files into project category

python3 Skills/sap-bah-openapi-backend-openclaw-upload-1.0.0/scripts/import_sap_hub_spec.py \
  --category AccountsReceivable \
  --pattern CONTRACTACCOUNT_0001 \
  --mode copy

Reliability behavior

The downloader script automatically:

1. In default env mode, starts with a clean temporary browser profile.
2. Uses Playwright Chromium.
3. Logs in using SAP_HUB_USERNAME and SAP_HUB_PASSWORD.
4. Downloads JSON/YAML/EDMX through Hub authenticated $value endpoints.
5. Retries transient failures.
6. Rejects OAuth/login HTML payloads.
7. Verifies expected OpenAPI/EDMX signatures before writing files.

Output contract

• Exit code 0: all requested files downloaded and validated.
• Exit code 2: partial/complete failures (see JSON report/stdout report).

Included files

• scripts/reliable_sap_hub_download.py
• scripts/import_sap_hub_spec.py
• scripts/scaffold_backend_from_openapi.py
• references/quickstart.md