Handelsregister extract download: a workflow template

{
  "title": "Handelsregister: retrieve the current register printout",
  "parameters": [
    {
      "key": "company",
      "description": "Company name or keyword for the normal search",
      "required": true
    },
    {
      "key": "register_number",
      "description": "Register type and number to match, e.g. HRB 12345; empty means take the first hit",
      "required": false,
      "default": ""
    },
    {
      "key": "kyc_webhook",
      "description": "Endpoint that receives the hit list",
      "required": true
    }
  ],
  "blocks": [
    {
      "blockType": "navigation",
      "label": "Register_portal",
      "url": "https://www.handelsregister.de/"
    },
    {
      "blockType": "action",
      "label": "Normal_search",
      "instruction": "Open the normal search (Normale Suche), enter {{ company }} as company name or keyword, leave the other filters empty and run the search"
    },
    {
      "blockType": "extraction",
      "label": "Hits",
      "instruction": "Every hit in the result list: company name, register court, register type and number, seat, status",
      "schema": {
        "type": "object",
        "properties": {
          "hits": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "company": {
                  "type": "string"
                },
                "court": {
                  "type": "string"
                },
                "register": {
                  "type": "string"
                },
                "seat": {
                  "type": "string"
                },
                "status": {
                  "type": "string"
                }
              },
              "required": [
                "company",
                "register"
              ]
            }
          }
        },
        "required": [
          "hits"
        ]
      }
    },
    {
      "blockType": "action",
      "label": "Open_printout",
      "instruction": "For the hit whose register entry matches {{ register_number }}, or the first hit when that is empty, open AD, the current printout (Aktueller Abdruck)"
    },
    {
      "blockType": "validation",
      "label": "Printout_present",
      "criterion": "A current register printout for {{ company }} is displayed or has been downloaded as a PDF; no error message, fee notice or retrieval limit is shown"
    },
    {
      "blockType": "http_request",
      "label": "Notify_kyc",
      "method": "POST",
      "url": "{{ kyc_webhook }}",
      "headers": {
        "content-type": "application/json"
      },
      "body": "{{ Hits_output }}"
    }
  ]
}

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

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

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

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

// The printout is an artifact of the run; the hit list went to the webhook.
for (const block of run.blocks) console.log(block.label, block.status, block.screenshotKey);