The most affordable way to turn SAP data into PDF documents

Authentication

Every request must include your customer API key in the X-API-Key header. Missing, invalid or disabled keys are rejected with 401 UNAUTHORIZED.

X-API-Key: <your-customer-api-key>

Custom branded templates

This isn't a generic text-to-PDF converter. Every customer can have their own document layout — logo, brand colors, structure — resolved automatically from the authenticated API key. No extra field in the request: the same POST /api/v1/pdf call renders with your template.

This is what lets an SAP S/4HANA customer replace their NetWeaver Java stack and Adobe Document Services (ADS) with a plain HTTP call from ABAP — the visual output stays as branded as the original SAP Form, but rendering happens entirely outside SAP. Templates are designed by the pdf4sap team as part of onboarding, not a self-service upload.

templates/<your-customer-id>/<documentType>.hbs   (most specific)
templates/<your-customer-id>/document.hbs           (your general layout)
templates/document.hbs                               (shared default)

Renders one SAP business document to PDF. The daily and monthly quota is only consumed once rendering succeeds.

Request body

{
  "documentType": "INVOICE",
  "documentNumber": "9000123456",
  "documentDate": "2026-07-30",
  "language": "en",
  "currency": "EUR",
  "company": {
    "name": "Example Energy Sp. z o.o.",
    "country": "Poland",
    "vatId": "PL1234567890"
  },
  "recipient": {
    "name": "SAP Customer A/S",
    "country": "Denmark"
  },
  "items": [
    {
      "position": "10",
      "description": "Electric energy settlement",
      "quantity": 1250.5,
      "unit": "MWH",
      "unitPrice": 82.75,
      "netAmount": 103479.88
    }
  ],
  "totals": { "net": 103479.88, "tax": 23800.37, "gross": 127280.25 }
}

curl --fail-with-body \
  -X POST https://www.pdf4sap.com/api/v1/pdf \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  --data-binary @invoice.json \
  --output invoice.pdf

Success response

On success, the response body is the binary PDF itself. Rate-limit and quota headers are attached to every response, success or error.

Error responses

Returns the current rate-limit and quota status for the authenticated customer — call it any time, it never consumes quota.

{
  "customer": { "id": "customer-a", "name": "Customer A" },
  "usage": {
    "minute": { "used": 1, "limit": 30, "remaining": 29 },
    "day": { "key": "2026-07-31", "used": 12, "limit": 500, "remaining": 488 },
    "month": { "key": "2026-07", "used": 340, "limit": 10000, "remaining": 9660 },
    "allowed": true
  }
}