SAP BTP Job Scheduling Service
Related Skills
- sap-dependency-security: Use for secure dependency and workflow hardening when your job scheduling microservices maintain npm/CLI dependency stacks
Table of Contents
Overview
SAP Job Scheduling Service is a runtime-agnostic platform service for defining and managing one-time and recurring jobs or Cloud Foundry tasks on SAP BTP. It operates across multiple hyperscalers (AWS, Azure, GCP) without requiring application modifications.
Documentation Source: https://help.sap.com/docs/job-scheduling
Last Verified: 2025-11-27
When to Use This Skill
Use this skill when:
- Setting up Job Scheduling Service on Cloud Foundry or Kyma runtime
- Creating and managing jobs via REST API or dashboard
- Configuring schedules using cron, date/time, or human-readable formats
- Implementing asynchronous job execution for long-running processes
- Securing action endpoints with OAuth 2.0 and XSUAA
- Integrating with SAP Cloud ALM or Alert Notification Service
- Developing multitenant applications with tenant-aware job scheduling
- Troubleshooting job execution issues and schedule failures
- Using the Node.js client library (@sap/jobs-client)
Quick Decision Tree
What Task?
Setup & Configuration
├─ Initial setup prerequisites → references/setup-guide.md
├─ Create service instance
│ ├─ BTP Cockpit → references/setup-guide.md#cockpit
│ ├─ CF CLI → references/setup-guide.md#cf-cli
│ └─ Kyma Dashboard → references/setup-guide.md#kyma
└─ Configure XSUAA scopes → references/security.md
Job Management
├─ Create jobs → references/rest-api.md#create-job
├─ Configure schedules → references/rest-api.md#schedules
├─ Run logs & monitoring → references/rest-api.md#run-logs
└─ Dashboard operations → references/operations.md#dashboard
Schedule Configuration
├─ One-time vs recurring → references/concepts.md#schedule-types
├─ Cron format → references/concepts.md#cron-format
├─ Date/time formats → references/concepts.md#date-formats
└─ Human-readable → references/concepts.md#human-readable
Asynchronous Execution
├─ Async mode flow → references/concepts.md#async-mode
├─ Callback implementation → references/rest-api.md#update-run-log
└─ CF tasks → references/concepts.md#cf-tasks
Security & Authentication
├─ OAuth 2.0 setup → references/security.md#oauth
├─ XSUAA configuration → references/security.md#xsuaa
└─ Credential rotation → references/security.md#rotation
Integrations
├─ SAP Cloud ALM → references/integrations.md#cloud-alm
└─ Alert Notification → references/integrations.md#alert-notification
Troubleshooting
├─ Common errors → references/troubleshooting.md#errors
├─ FAQ → references/troubleshooting.md#faq
└─ Support: BC-CP-CF-JBS
Version History & Updates
└─ What's New (2021-2025) → references/changelog.md
Core Concepts
Job
A collection of schedules with an action endpoint. Jobs invoke a configured URL at specified times synchronously (short operations) or asynchronously (long processes).
Schedule
A one-time or recurring entity within a job. Supports multiple formats (cron, date/time, human-readable) and has three lifecycle states: SCHEDULED → RUNNING → COMPLETED.
Action Endpoint
An HTTP/REST endpoint exposed by your application that the service invokes when schedules trigger. Must be OAuth 2.0 protected in production.
Cloud Foundry Task
An app or script that runs independently in its own container. Always executes asynchronously with configurable memory allocation.
Service Constraints
| Constraint |
Value |
| Minimum schedule interval |
5 minutes |
| Synchronous request timeout |
15 seconds |
| Asynchronous timeout (default) |
30 minutes (configurable up to 7 days) |
| POST request body limit |
100 KB |
| Run log retention |
15 days |
| Service SLA |
~20 minutes from scheduled time |
Quick Reference Tables
Schedule Formats
| Format |
Example |
Use Case |
| Cron |
* * * * 10:12 0,30 0 |
Every 30 min between 10:00-12:00 |
| Date/Time |
2025-10-20T04:30:00Z |
ISO-8601 one-time execution |
| Human-readable |
tomorrow at 4pm |
Natural language scheduling |
| repeatInterval |
2 hours, 5 minutes |
Recurring at fixed intervals |
| repeatAt |
4.40pm, 18:40 |
Daily at specific time |
Cron Format (7 fields)
Year Month Day DayOfWeek Hour Minute Second
* * * * * * *
| Field |
Values |
Special |
| Year |
4-digit (2025) |
* = any |
| Month |
1-12 |
*/a = every a-th |
| Day |
-31 to 31 |
negative = from end |
| DayOfWeek |
mon, tue, wed... |
a.y = a-th occurrence |
| Hour |
0-23 |
a:b = range |
| Minute |
0-59 |
a:b/c = step in range |
| Second |
0-59 |
a,b,c = multiple values |
Schedule Lifecycle States
| Phase |
States |
Description |
| SCHEDULED |
SCHEDULED |
Queued for future run |
| RUNNING |
TRIGGERED, ACK_RECVD, ACK_NOT_RECVD |
Executing |
| COMPLETED |
SUCCESS, ERROR, REQUEST_ERROR, UNKNOWN |
Finished |
HTTP Methods for Jobs
| Method |
Endpoint |
Purpose |
| POST |
/scheduler/jobs |
Create job |
| GET |
/scheduler/jobs |
List all jobs |
| GET |
/scheduler/jobs/{id} |
Get job details |
| PUT |
/scheduler/jobs/{id} |
Update job |
| DELETE |
/scheduler/jobs/{id} |
Delete job |
Best Practices
Scheduling Optimization
Avoid Peak Times:
- ❌ 0th or 30th second of any minute
- ❌ 0th, 30th, or multiples of 5 minutes
- ❌ Top of each hour
- ❌ Midnight UTC (busiest time)
Use Irregular Times:
- ✅
01:12:17 instead of 01:00:00
- ✅
01:38:37 instead of 01:30:00
Asynchronous Jobs
- Return 202 Accepted immediately - Don't block the request
- Store request headers -
x-sap-job-id, x-sap-job-schedule-id, x-sap-job-run-id, x-sap-scheduler-host
- Update run log on completion - Single API call with final status
- Handle timeouts - Default 30 min, configurable up to 7 days
One-Time Schedules
- Use only for testing/validation
- Auto-deactivate after execution
- Use
"time": "now" for immediate execution
Authentication Quick Start
Standard Plan (OAuth 2.0)
# Get access token
curl -X POST "<uaa_url>/oauth/token" \
-H "Authorization: Basic $(echo -n '<clientid>:<clientsecret>' | base64)" \
-d "grant_type=client_credentials"
# Use token in API calls
curl -X GET "https://jobscheduler-rest.<landscape>/scheduler/jobs" \
-H "Authorization: Bearer <access_token>" \
-H "Content-Type: application/json"
xs-security.json Configuration
{
"xsappname": "<app-name>",
"scopes": [{
"name": "$XSAPPNAME.JOBSCHEDULER",
"description": "Job Scheduler Scope",
"grant-as-authority-to-apps": ["$XSSERVICENAME(<jobscheduler-instance>)"]
}]
}
Create Job Example
POST /scheduler/jobs
{
"name": "myJob",
"description": "Process daily reports",
"action": "https://myapp.cfapps.eu10.hana.ondemand.com/api/process",
"active": true,
"httpMethod": "POST",
"schedules": [{
"active": true,
"description": "Daily at 6 AM",
"repeatAt": "6.00am",
"startTime": {"date": "2025-01-01", "format": "YYYY-MM-DD"}
}]
}
Node.js Client Library
Requirements: Node.js 14.x or later
npm install @sap/jobs-client@1.8.6
const JobSchedulerClient = require('@sap/jobs-client');
const scheduler = new JobSchedulerClient.Scheduler();
// Create job
scheduler.createJob({ url: vcapServices.jobscheduler[0].credentials.url }, {
name: 'myJob',
action: 'https://myapp.../process',
active: true,
httpMethod: 'GET',
schedules: [{ cron: '* * * * 0 0 0', active: true }]
}, (err, result) => { /* handle */ });
Rate Limits
| Limit Type |
Response Code |
Header |
| Client limit exceeded |
429 |
retry-after (seconds) |
| Absolute limit exceeded |
503 |
throttling (milliseconds) |
Limits stack - both can apply simultaneously.
Service Behavior
Outage Recovery
| Outage Duration |
Behavior |
| < 20 minutes |
All missed executions run immediately |
| >= 20 minutes |
Only last missed execution runs |
Auto-Deactivation Triggers
- One-time schedule executed
- No valid future dates exist
- Job/schedule endTime reached
- Action endpoint unreachable for 10+ days
Reference Files
Detailed Guides Available
- references/concepts.md - Schedule types, formats, lifecycle, async mode, multitenancy
- references/rest-api.md - Complete REST API reference with all endpoints
- references/setup-guide.md - Prerequisites, service instance creation
- references/security.md - OAuth 2.0, XSUAA scopes, credential rotation
- references/integrations.md - Cloud ALM, Alert Notification Service
- references/troubleshooting.md - FAQ, error scenarios, monitoring
- references/operations.md - Dashboard, backup/restore, service behavior
- references/changelog.md - Version history, feature updates (2021-2025)
Templates Available
- templates/job-creation.json - Job creation request template
- templates/xs-security.json - XSUAA configuration template
Common Pitfalls
Setup:
- ❌ Missing XSUAA binding before Job Scheduling binding
- ❌ Not granting scopes via
grant-as-authority-to-apps
- ❌ Using HTTP instead of HTTPS for action endpoints
Scheduling:
- ❌ Using Linux cron format (service uses SAP cron)
- ❌ Scheduling at peak times (00:00, 00:30, etc.)
- ❌ Forgetting UTC timezone (only supported timezone)
Async Jobs:
- ❌ Not returning 202 Accepted immediately
- ❌ Forgetting to call Update Run Log API
- ❌ Multiple status updates instead of single final update
Multitenancy:
- ❌ Using
tenantId filter with SaaS tenant tokens (returns 400)
- ❌ Missing Job Scheduling as application dependency
External Resources
SAP Documentation
Support
- Component: BC-CP-CF-JBS
- SAP Trust Center: Platform status verification
- Guided Answers: Self-service troubleshooting
Updates and Maintenance
Source: SAP BTP Job Scheduling Service Documentation
To Update This Skill:
- Check GitHub repository for documentation updates
- Review What's New section for changes
- Update affected reference files
- Update templates if configurations changed
- Update "Last Verified" date
Quarterly Review Recommended: Check for updates every 3 months
Next Review: 2026-02-27
Bundled Resources
Reference Files
- references/concepts.md - Schedule types, formats, lifecycle, async mode, multitenancy (12K lines)
- references/rest-api.md - Complete REST API reference with all endpoints (20K lines)
- references/setup-guide.md - Prerequisites, service instance creation (9K lines)
- references/security.md - OAuth 2.0, XSUAA scopes, credential rotation (11K lines)
- references/integrations.md - Cloud ALM, Alert Notification Service (8K lines)
- references/troubleshooting.md - FAQ, error scenarios, monitoring (9K lines)
- references/operations.md - Dashboard, backup/restore, service behavior (8K lines)
- references/changelog.md - Version history, feature updates (2021-2025) (9K lines)
Templates
- templates/job-creation.json - Job creation request template with examples
- templates/xs-security.json - XSUAA configuration template for OAuth scopes
License: GPL-3.0
Maintainer: Eduard Jiglau | hello@sap-ai-skills.com | sap-ai-skills.com | https://github.com/secondsky/sap-skills
1---
2name: sap-btp-job-scheduling
3description: |
4 This skill provides comprehensive guidance for SAP BTP Job Scheduling Service development, configuration, and operations.
5 It should be used when creating, managing, or troubleshooting scheduled jobs on SAP Business Technology Platform.
6
7 The skill covers service setup, REST API usage, schedule types and formats, OAuth 2.0 authentication, multitenancy,
8 Cloud Foundry tasks, Kyma runtime integration, and monitoring with SAP Cloud ALM and Alert Notification Service.
9
10 Keywords: SAP BTP, Job Scheduling, jobscheduler, cron, schedule, recurring jobs, one-time jobs, Cloud Foundry tasks,
11 CF tasks, Kyma, OAuth 2.0, XSUAA, @sap/jobs-client, REST API, asynchronous jobs, action endpoint, run logs,
12 SAP Cloud ALM, Alert Notification Service, multitenancy, tenant-aware, BC-CP-CF-JBS
13license: GPL-3.0
14metadata:
15 source: https://skillmd.com/skills/secondsky/sap-btp-job-scheduling
16 maintainer: "Eduard Jiglau"
17 maintainer_email: "hello@sap-ai-skills.com"
18 website: "https://sap-ai-skills.com"
19 version: "2.4.1"
20 last_verified: "2025-11-27"
21---
22
23# SAP BTP Job Scheduling Service
24
25## Related Skills
26
27- **sap-dependency-security**: Use for secure dependency and workflow hardening when your job scheduling microservices maintain npm/CLI dependency stacks
28
29## Table of Contents
30
31- [Overview](#overview)
32- [When to Use This Skill](#when-to-use-this-skill)
33- [Quick Decision Tree](#quick-decision-tree)
34- [Core Concepts](#core-concepts)
35- [Service Constraints](#service-constraints)
36- [Quick Reference Tables](#quick-reference-tables)
37 - [Schedule Formats](#schedule-formats)
38 - [Cron Format (7 fields)](#cron-format-7-fields)
39 - [Schedule Lifecycle States](#schedule-lifecycle-states)
40 - [HTTP Methods for Jobs](#http-methods-for-jobs)
41- [Best Practices](#best-practices)
42 - [Scheduling Optimization](#scheduling-optimization)
43 - [Asynchronous Jobs](#asynchronous-jobs)
44 - [One-Time Schedules](#one-time-schedules)
45- [Authentication Quick Start](#authentication-quick-start)
46 - [Standard Plan (OAuth 2.0)](#standard-plan-oauth-20)
47 - [xs-security.json Configuration](#xs-securityjson-configuration)
48- [Create Job Example](#create-job-example)
49- [Node.js Client Library](#nodejs-client-library)
50- [Rate Limits](#rate-limits)
51- [Service Behavior](#service-behavior)
52 - [Outage Recovery](#outage-recovery)
53 - [Auto-Deactivation Triggers](#auto-deactivation-triggers)
54- [Bundled Resources](#bundled-resources)
55- [Common Pitfalls](#common-pitfalls)
56- [External Resources](#external-resources)
57- [Updates and Maintenance](#updates-and-maintenance)
58
59## Overview
60
61SAP Job Scheduling Service is a runtime-agnostic platform service for defining and managing one-time and recurring jobs or Cloud Foundry tasks on SAP BTP. It operates across multiple hyperscalers (AWS, Azure, GCP) without requiring application modifications.
62
63**Documentation Source**: [https://help.sap.com/docs/job-scheduling](https://help.sap.com/docs/job-scheduling)
64
65**Last Verified**: 2025-11-27
66
67## When to Use This Skill
68
69Use this skill when:
70
71- **Setting up Job Scheduling Service** on Cloud Foundry or Kyma runtime
72- **Creating and managing jobs** via REST API or dashboard
73- **Configuring schedules** using cron, date/time, or human-readable formats
74- **Implementing asynchronous job execution** for long-running processes
75- **Securing action endpoints** with OAuth 2.0 and XSUAA
76- **Integrating with SAP Cloud ALM** or Alert Notification Service
77- **Developing multitenant applications** with tenant-aware job scheduling
78- **Troubleshooting job execution issues** and schedule failures
79- **Using the Node.js client library** (@sap/jobs-client)
80
81## Quick Decision Tree
82
83### What Task?
84
85```
86Setup & Configuration
87├─ Initial setup prerequisites → references/setup-guide.md
88├─ Create service instance
89│ ├─ BTP Cockpit → references/setup-guide.md#cockpit
90│ ├─ CF CLI → references/setup-guide.md#cf-cli
91│ └─ Kyma Dashboard → references/setup-guide.md#kyma
92└─ Configure XSUAA scopes → references/security.md
93
94Job Management
95├─ Create jobs → references/rest-api.md#create-job
96├─ Configure schedules → references/rest-api.md#schedules
97├─ Run logs & monitoring → references/rest-api.md#run-logs
98└─ Dashboard operations → references/operations.md#dashboard
99
100Schedule Configuration
101├─ One-time vs recurring → references/concepts.md#schedule-types
102├─ Cron format → references/concepts.md#cron-format
103├─ Date/time formats → references/concepts.md#date-formats
104└─ Human-readable → references/concepts.md#human-readable
105
106Asynchronous Execution
107├─ Async mode flow → references/concepts.md#async-mode
108├─ Callback implementation → references/rest-api.md#update-run-log
109└─ CF tasks → references/concepts.md#cf-tasks
110
111Security & Authentication
112├─ OAuth 2.0 setup → references/security.md#oauth
113├─ XSUAA configuration → references/security.md#xsuaa
114└─ Credential rotation → references/security.md#rotation
115
116Integrations
117├─ SAP Cloud ALM → references/integrations.md#cloud-alm
118└─ Alert Notification → references/integrations.md#alert-notification
119
120Troubleshooting
121├─ Common errors → references/troubleshooting.md#errors
122├─ FAQ → references/troubleshooting.md#faq
123└─ Support: BC-CP-CF-JBS
124
125Version History & Updates
126└─ What's New (2021-2025) → references/changelog.md
127```
128
129## Core Concepts
130
131### Job
132A collection of schedules with an action endpoint. Jobs invoke a configured URL at specified times synchronously (short operations) or asynchronously (long processes).
133
134### Schedule
135A one-time or recurring entity within a job. Supports multiple formats (cron, date/time, human-readable) and has three lifecycle states: SCHEDULED → RUNNING → COMPLETED.
136
137### Action Endpoint
138An HTTP/REST endpoint exposed by your application that the service invokes when schedules trigger. Must be OAuth 2.0 protected in production.
139
140### Cloud Foundry Task
141An app or script that runs independently in its own container. Always executes asynchronously with configurable memory allocation.
142
143## Service Constraints
144
145| Constraint | Value |
146|------------|-------|
147| Minimum schedule interval | 5 minutes |
148| Synchronous request timeout | 15 seconds |
149| Asynchronous timeout (default) | 30 minutes (configurable up to 7 days) |
150| POST request body limit | 100 KB |
151| Run log retention | 15 days |
152| Service SLA | ~20 minutes from scheduled time |
153
154## Quick Reference Tables
155
156### Schedule Formats
157
158| Format | Example | Use Case |
159|--------|---------|----------|
160| Cron | `* * * * 10:12 0,30 0` | Every 30 min between 10:00-12:00 |
161| Date/Time | `2025-10-20T04:30:00Z` | ISO-8601 one-time execution |
162| Human-readable | `tomorrow at 4pm` | Natural language scheduling |
163| repeatInterval | `2 hours`, `5 minutes` | Recurring at fixed intervals |
164| repeatAt | `4.40pm`, `18:40` | Daily at specific time |
165
166### Cron Format (7 fields)
167
168```
169Year Month Day DayOfWeek Hour Minute Second
170* * * * * * *
171```
172
173| Field | Values | Special |
174|-------|--------|---------|
175| Year | 4-digit (2025) | * = any |
176| Month | 1-12 | */a = every a-th |
177| Day | -31 to 31 | negative = from end |
178| DayOfWeek | mon, tue, wed... | a.y = a-th occurrence |
179| Hour | 0-23 | a:b = range |
180| Minute | 0-59 | a:b/c = step in range |
181| Second | 0-59 | a,b,c = multiple values |
182
183### Schedule Lifecycle States
184
185| Phase | States | Description |
186|-------|--------|-------------|
187| SCHEDULED | SCHEDULED | Queued for future run |
188| RUNNING | TRIGGERED, ACK_RECVD, ACK_NOT_RECVD | Executing |
189| COMPLETED | SUCCESS, ERROR, REQUEST_ERROR, UNKNOWN | Finished |
190
191### HTTP Methods for Jobs
192
193| Method | Endpoint | Purpose |
194|--------|----------|---------|
195| POST | `/scheduler/jobs` | Create job |
196| GET | `/scheduler/jobs` | List all jobs |
197| GET | `/scheduler/jobs/{id}` | Get job details |
198| PUT | `/scheduler/jobs/{id}` | Update job |
199| DELETE | `/scheduler/jobs/{id}` | Delete job |
200
201## Best Practices
202
203### Scheduling Optimization
204
205**Avoid Peak Times:**
206- ❌ 0th or 30th second of any minute
207- ❌ 0th, 30th, or multiples of 5 minutes
208- ❌ Top of each hour
209- ❌ Midnight UTC (busiest time)
210
211**Use Irregular Times:**
212- ✅ `01:12:17` instead of `01:00:00`
213- ✅ `01:38:37` instead of `01:30:00`
214
215### Asynchronous Jobs
216
2171. **Return 202 Accepted immediately** - Don't block the request
2182. **Store request headers** - `x-sap-job-id`, `x-sap-job-schedule-id`, `x-sap-job-run-id`, `x-sap-scheduler-host`
2193. **Update run log on completion** - Single API call with final status
2204. **Handle timeouts** - Default 30 min, configurable up to 7 days
221
222### One-Time Schedules
223
224- Use only for testing/validation
225- Auto-deactivate after execution
226- Use `"time": "now"` for immediate execution
227
228## Authentication Quick Start
229
230### Standard Plan (OAuth 2.0)
231
232```bash
233# Get access token
234curl -X POST "<uaa_url>/oauth/token" \
235 -H "Authorization: Basic $(echo -n '<clientid>:<clientsecret>' | base64)" \
236 -d "grant_type=client_credentials"
237
238# Use token in API calls
239curl -X GET "https://jobscheduler-rest.<landscape>/scheduler/jobs" \
240 -H "Authorization: Bearer <access_token>" \
241 -H "Content-Type: application/json"
242```
243
244### xs-security.json Configuration
245
246```json
247{
248 "xsappname": "<app-name>",
249 "scopes": [{
250 "name": "$XSAPPNAME.JOBSCHEDULER",
251 "description": "Job Scheduler Scope",
252 "grant-as-authority-to-apps": ["$XSSERVICENAME(<jobscheduler-instance>)"]
253 }]
254}
255```
256
257## Create Job Example
258
259```json
260POST /scheduler/jobs
261{
262 "name": "myJob",
263 "description": "Process daily reports",
264 "action": "https://myapp.cfapps.eu10.hana.ondemand.com/api/process",
265 "active": true,
266 "httpMethod": "POST",
267 "schedules": [{
268 "active": true,
269 "description": "Daily at 6 AM",
270 "repeatAt": "6.00am",
271 "startTime": {"date": "2025-01-01", "format": "YYYY-MM-DD"}
272 }]
273}
274```
275
276## Node.js Client Library
277
278**Requirements**: Node.js 14.x or later
279
280```bash
281npm install @sap/jobs-client@1.8.6
282```
283
284```javascript
285const JobSchedulerClient = require('@sap/jobs-client');
286const scheduler = new JobSchedulerClient.Scheduler();
287
288// Create job
289scheduler.createJob({ url: vcapServices.jobscheduler[0].credentials.url }, {
290 name: 'myJob',
291 action: 'https://myapp.../process',
292 active: true,
293 httpMethod: 'GET',
294 schedules: [{ cron: '* * * * 0 0 0', active: true }]
295}, (err, result) => { /* handle */ });
296```
297
298## Rate Limits
299
300| Limit Type | Response Code | Header |
301|------------|---------------|--------|
302| Client limit exceeded | 429 | `retry-after` (seconds) |
303| Absolute limit exceeded | 503 | `throttling` (milliseconds) |
304
305Limits stack - both can apply simultaneously.
306
307## Service Behavior
308
309### Outage Recovery
310
311| Outage Duration | Behavior |
312|-----------------|----------|
313| < 20 minutes | All missed executions run immediately |
314| >= 20 minutes | Only last missed execution runs |
315
316### Auto-Deactivation Triggers
317
318- One-time schedule executed
319- No valid future dates exist
320- Job/schedule endTime reached
321- Action endpoint unreachable for 10+ days
322
323## Reference Files
324
325### Detailed Guides Available
326
3271. **references/concepts.md** - Schedule types, formats, lifecycle, async mode, multitenancy
3282. **references/rest-api.md** - Complete REST API reference with all endpoints
3293. **references/setup-guide.md** - Prerequisites, service instance creation
3304. **references/security.md** - OAuth 2.0, XSUAA scopes, credential rotation
3315. **references/integrations.md** - Cloud ALM, Alert Notification Service
3326. **references/troubleshooting.md** - FAQ, error scenarios, monitoring
3337. **references/operations.md** - Dashboard, backup/restore, service behavior
3348. **references/changelog.md** - Version history, feature updates (2021-2025)
335
336### Templates Available
337
3381. **templates/job-creation.json** - Job creation request template
3392. **templates/xs-security.json** - XSUAA configuration template
340
341## Common Pitfalls
342
343**Setup:**
344- ❌ Missing XSUAA binding before Job Scheduling binding
345- ❌ Not granting scopes via `grant-as-authority-to-apps`
346- ❌ Using HTTP instead of HTTPS for action endpoints
347
348**Scheduling:**
349- ❌ Using Linux cron format (service uses SAP cron)
350- ❌ Scheduling at peak times (00:00, 00:30, etc.)
351- ❌ Forgetting UTC timezone (only supported timezone)
352
353**Async Jobs:**
354- ❌ Not returning 202 Accepted immediately
355- ❌ Forgetting to call Update Run Log API
356- ❌ Multiple status updates instead of single final update
357
358**Multitenancy:**
359- ❌ Using `tenantId` filter with SaaS tenant tokens (returns 400)
360- ❌ Missing Job Scheduling as application dependency
361
362## External Resources
363
364### SAP Documentation
365- **SAP Help Portal**: [https://help.sap.com/docs/job-scheduling](https://help.sap.com/docs/job-scheduling)
366- **SAP Developer Center**: [https://developers.sap.com/](https://developers.sap.com/)
367
368### Support
369- **Component**: BC-CP-CF-JBS
370- **SAP Trust Center**: Platform status verification
371- **Guided Answers**: Self-service troubleshooting
372
373## Updates and Maintenance
374
375**Source**: SAP BTP Job Scheduling Service Documentation
376
377**To Update This Skill**:
3781. Check GitHub repository for documentation updates
3792. Review What's New section for changes
3803. Update affected reference files
3814. Update templates if configurations changed
3825. Update "Last Verified" date
383
384**Quarterly Review Recommended**: Check for updates every 3 months
385
386**Next Review**: 2026-02-27
387
388## Bundled Resources
389
390### Reference Files
3911. **references/concepts.md** - Schedule types, formats, lifecycle, async mode, multitenancy (12K lines)
3922. **references/rest-api.md** - Complete REST API reference with all endpoints (20K lines)
3933. **references/setup-guide.md** - Prerequisites, service instance creation (9K lines)
3944. **references/security.md** - OAuth 2.0, XSUAA scopes, credential rotation (11K lines)
3955. **references/integrations.md** - Cloud ALM, Alert Notification Service (8K lines)
3966. **references/troubleshooting.md** - FAQ, error scenarios, monitoring (9K lines)
3977. **references/operations.md** - Dashboard, backup/restore, service behavior (8K lines)
3988. **references/changelog.md** - Version history, feature updates (2021-2025) (9K lines)
399
400### Templates
4011. **templates/job-creation.json** - Job creation request template with examples
4022. **templates/xs-security.json** - XSUAA configuration template for OAuth scopes
403
404---
405
406**License**: GPL-3.0
407**Maintainer**: Eduard Jiglau | [hello@sap-ai-skills.com](mailto:hello@sap-ai-skills.com) | [sap-ai-skills.com](https://sap-ai-skills.com) | [https://github.com/secondsky/sap-skills](https://github.com/secondsky/sap-skills)