Handelsregisterauszug: Suche, Treffer, Aktueller Abdruck

{
  "title": "Handelsregister: aktuellen Registerausdruck abrufen",
  "parameters": [
    {
      "key": "firma",
      "description": "Firmenname oder Schlagwort für die normale Suche",
      "required": true
    },
    {
      "key": "registernummer",
      "description": "Registerart und -nummer, etwa HRB 12345; leer heißt: den ersten Treffer nehmen",
      "required": false,
      "default": ""
    },
    {
      "key": "kyc_webhook",
      "description": "Endpunkt, der die Trefferliste entgegennimmt",
      "required": true
    }
  ],
  "blocks": [
    {
      "blockType": "navigation",
      "label": "Registerportal",
      "url": "https://www.handelsregister.de/"
    },
    {
      "blockType": "action",
      "label": "Normale_Suche",
      "instruction": "Öffne die normale Suche, trage {{ firma }} als Firma oder Schlagwort ein, lass die übrigen Filter leer und starte die Suche"
    },
    {
      "blockType": "extraction",
      "label": "Treffer",
      "instruction": "Jeder Treffer der Ergebnisliste: Firma, Registergericht, Registerart und -nummer, Sitz, Status",
      "schema": {
        "type": "object",
        "properties": {
          "treffer": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "firma": {
                  "type": "string"
                },
                "gericht": {
                  "type": "string"
                },
                "register": {
                  "type": "string"
                },
                "sitz": {
                  "type": "string"
                },
                "status": {
                  "type": "string"
                }
              },
              "required": [
                "firma",
                "register"
              ]
            }
          }
        },
        "required": [
          "treffer"
        ]
      }
    },
    {
      "blockType": "action",
      "label": "Ausdruck_oeffnen",
      "instruction": "Öffne für den Treffer, dessen Registereintrag zu {{ registernummer }} passt - oder für den ersten Treffer, wenn der Parameter leer ist - den Aktuellen Abdruck AD"
    },
    {
      "blockType": "validation",
      "label": "Ausdruck_da",
      "criterion": "Ein aktueller Registerausdruck zu {{ firma }} wird angezeigt oder wurde als PDF heruntergeladen; es steht keine Fehlermeldung, kein Gebührenhinweis und kein Hinweis auf ein erreichtes Abrufkontingent auf der Seite"
    },
    {
      "blockType": "http_request",
      "label": "KYC_melden",
      "method": "POST",
      "url": "{{ kyc_webhook }}",
      "headers": {
        "content-type": "application/json"
      },
      "body": "{{ Treffer_output }}"
    }
  ]
}

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

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

const wf = await bb.workflows.publish(vorlage);

await using session = await bb.sessions.create();
const lauf = await bb.workflows.run(wf.workflowId, {
  sessionId: session.id,
  inputs: {
    firma: 'Musterbau GmbH',
    registernummer: 'HRB 12345',
    kyc_webhook: 'https://kyc.intern.example/hooks/register',
  },
});

// Der Ausdruck ist ein Artefakt des Laufs; die Trefferliste ging an den Webhook.
for (const block of lauf.blocks) console.log(block.label, block.status, block.screenshotKey);