DHL business portal: fetch invoices and shipment status by workflow

{
  "title": "DHL business customer portal: invoices and shipment status",
  "parameters": [
    {
      "key": "period_from",
      "description": "First invoice date to include (YYYY-MM-DD)",
      "required": true
    },
    {
      "key": "period_to",
      "description": "Last invoice date to include (YYYY-MM-DD)",
      "required": true
    },
    {
      "key": "shipment_numbers",
      "description": "Comma-separated shipment numbers whose status you want",
      "required": false,
      "default": ""
    },
    {
      "key": "ap_webhook",
      "description": "Endpoint that receives invoices and statuses",
      "required": true
    }
  ],
  "runSequentially": true,
  "sequentialKey": "cred_dhl_gkp",
  "blocks": [
    {
      "blockType": "login",
      "label": "Sign_in",
      "credentialId": "cred_dhl_gkp",
      "url": "https://geschaeftskunden.dhl.de/"
    },
    {
      "blockType": "action",
      "label": "Open_invoices",
      "instruction": "Open the invoices area (Rechnungen) of the business customer portal and filter invoices dated from {{ period_from }} to {{ period_to }}"
    },
    {
      "blockType": "extraction",
      "label": "Invoices",
      "instruction": "Every invoice in the filtered list: invoice number, invoice date, gross amount, currency, customer number (Kundennummer), whether a PDF download is offered",
      "schema": {
        "type": "object",
        "properties": {
          "invoices": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "number": {
                  "type": "string"
                },
                "date": {
                  "type": "string"
                },
                "gross": {
                  "type": "number"
                },
                "currency": {
                  "type": "string"
                },
                "customerNumber": {
                  "type": "string"
                },
                "hasPdf": {
                  "type": "boolean"
                }
              },
              "required": [
                "number",
                "date",
                "gross"
              ]
            }
          }
        },
        "required": [
          "invoices"
        ]
      }
    },
    {
      "blockType": "action",
      "label": "Track_shipments",
      "continueOnFailure": true,
      "instruction": "Open shipment tracking (Sendungsverfolgung) in the portal and look up the shipment numbers {{ shipment_numbers }}; if the list is empty, do nothing"
    },
    {
      "blockType": "extraction",
      "label": "Statuses",
      "continueOnFailure": true,
      "instruction": "For each shipment number in {{ shipment_numbers }}: the current status, the timestamp of the last event and the delivery date if delivered",
      "schema": {
        "type": "object",
        "properties": {
          "shipments": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "number": {
                  "type": "string"
                },
                "status": {
                  "type": "string"
                },
                "lastEvent": {
                  "type": "string"
                },
                "deliveredOn": {
                  "type": "string"
                }
              },
              "required": [
                "number",
                "status"
              ]
            }
          }
        },
        "required": [
          "shipments"
        ]
      }
    },
    {
      "blockType": "http_request",
      "label": "Post_to_ap",
      "method": "POST",
      "url": "{{ ap_webhook }}",
      "headers": {
        "content-type": "application/json"
      },
      "body": "{\"invoices\": {{ Invoices_output }}, \"shipments\": {{ Statuses_output }}}"
    }
  ]
}

import { Browserberg } from '@browserberg/sdk';
import template from './dhl-business-invoices.json' with { type: 'json' };

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

const cred = await bb.credentials.create({
  name: 'DHL business customer portal',
  url: 'https://geschaeftskunden.dhl.de/',
  fields: { username: 'logistik@example.de', password: process.env.DHL_PASSWORD },
  nonSecretFields: ['username'],
});

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

// First of the month, 06:10 Berlin time; a missed night is one firing, not a backlog.
await bb.triggers.create(wf.workflowId, {
  kind: 'schedule', name: 'Monthly DHL invoices',
  cron: '10 6 1 * *', timezone: 'Europe/Berlin',
});