Sparkasse: Kontoauszüge aus dem Postfach in den Ordner

{
  "title": "Sparkasse Online-Banking: Kontoauszüge eines Monats als PDF",
  "parameters": [
    {
      "key": "banking_url",
      "description": "Die Online-Banking-Adresse deiner Sparkasse; sie ist zugleich die Freigabe-URL des Zugangs",
      "required": true
    },
    {
      "key": "monat",
      "description": "Der Auszugsmonat, der geladen werden soll (JJJJ-MM)",
      "required": true
    },
    {
      "key": "archiv_webhook",
      "description": "Endpunkt, der die Liste der Auszüge entgegennimmt",
      "required": true
    }
  ],
  "runSequentially": true,
  "sequentialKey": "cred_sparkasse",
  "blocks": [
    {
      "blockType": "login",
      "label": "Anmelden",
      "credentialId": "cred_sparkasse",
      "url": "{{ banking_url }}"
    },
    {
      "blockType": "validation",
      "label": "Uebersicht_da",
      "criterion": "Die Finanzübersicht des angemeldeten Kunden ist zu sehen; es steht keine PIN-Eingabe und keine offene pushTAN-Freigabe mehr auf der Seite"
    },
    {
      "blockType": "action",
      "label": "Postfach_oeffnen",
      "instruction": "Öffne das elektronische Postfach und darin die Kontoauszüge, eingegrenzt auf den Monat {{ monat }}"
    },
    {
      "blockType": "extraction",
      "label": "Auszuege",
      "instruction": "Jeder für {{ monat }} gelistete Kontoauszug: Konto (IBAN oder Bezeichnung), Auszugsnummer, Auszugsdatum und ob ein PDF angeboten wird",
      "schema": {
        "type": "object",
        "properties": {
          "auszuege": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "konto": {
                  "type": "string"
                },
                "nummer": {
                  "type": "string"
                },
                "datum": {
                  "type": "string"
                },
                "hatPdf": {
                  "type": "boolean"
                }
              },
              "required": [
                "konto",
                "datum"
              ]
            }
          }
        },
        "required": [
          "auszuege"
        ]
      }
    },
    {
      "blockType": "loop",
      "label": "Je_Auszug",
      "over": "{{ Auszuege_output.auszuege }}",
      "maxIterations": 30,
      "blocks": [
        {
          "blockType": "action",
          "label": "Auszug_laden",
          "nextLoopOnFailure": true,
          "instruction": "Lade den Auszug {{ loopValue.nummer }} vom {{ loopValue.datum }} für das Konto {{ loopValue.konto }} als PDF herunter"
        }
      ]
    },
    {
      "blockType": "http_request",
      "label": "Liste_senden",
      "method": "POST",
      "url": "{{ archiv_webhook }}",
      "headers": {
        "content-type": "application/json"
      },
      "body": "{{ Auszuege_output }}"
    }
  ]
}

import { Browserberg } from '@browserberg/sdk';
import vorlage from './sparkasse-kontoauszuege.json' with { type: 'json' };

const bb = new Browserberg({
  apiKey: process.env.BROWSERBERG_API_KEY,
  baseUrl: 'https://browserberg.com',
});

// Die Freigabe-URL ist die Banking-Adresse deiner Sparkasse; nur dort wird die PIN getippt.
const bankingUrl = 'https://www.sparkasse-musterstadt.example/';
const zugang = await bb.credentials.create({
  name: 'Sparkasse Geschäftskonto',
  url: bankingUrl,
  fields: { loginName: 'firma-muster', pin: process.env.SPK_PIN },
  nonSecretFields: ['loginName'],
});

const wf = await bb.workflows.publish({
  ...vorlage,
  blocks: vorlage.blocks.map((b) =>
    b.blockType === 'login' ? { ...b, credentialId: zugang.id } : b),
});

// pushTAN: Wer das Telefon hat, sieht der Anmeldung zu und gibt sie in der App frei.
await using session = await bb.sessions.create();
const { url } = await bb.sessions.watchLink(session.id);
console.log('Der Anmeldung zusehen und die pushTAN am Telefon freigeben:', url);

const lauf = await bb.workflows.run(wf.workflowId, {
  sessionId: session.id,
  inputs: {
    banking_url: bankingUrl,
    monat: '2026-08',
    archiv_webhook: 'https://dms.intern.example/hooks/auszuege',
  },
});
console.log(lauf.status, lauf.endedBy);