Skip to content
All playbooks

Playbook V · Legacy Portals · 34 min

When there is no API, we build the contract ourselves

A supplier portal from 2009, a government filing system with no API, a desktop ERP client. The work is real, the integration surface is not.

What we put in place

  1. Scheduled or event-driven run

    trigger

    Cron, queue message or upstream state change opens the run.

  2. Contract-first adapter

    agent

    We wrap the portal in a typed adapter with a declared schema — a real interface, versioned and tested, not a click recorder.

  3. Execute & verify

    agent

    Every write is read back and compared against the intended state. A mismatch fails the run loudly.

  4. Drift checkpoint

    your team

    When the portal's markup or flow changes, the adapter fails closed and a human is paged. It never improvises.

  5. Reconcile

    done

    Results normalised back into your systems of record with a full screenshot and DOM trace per step.

Published as researched, with its own evidence audited at the foot: every cited figure is listed with what its source actually is — the organisation that measured it, the vendor selling the result, or a write-up repeating somebody else’s number. Where a source did not survive checking, the passage was removed rather than softened.

Systems deemed impossible to integrate are rarely impossible to access; rather, they present hostile engineering environments that reject conventional software integration practices. When a core operational platform lacks a documented application programming interface (API)—whether it is a decades-old supplier extranet, a government filing portal, an on-premise desktop ERP client, or a proprietary vendor mainframe—technical teams routinely declare the system a closed black box. This verdict is technically incorrect. Any enterprise software that accepts human keystrokes, displays character grids, renders web forms, or processes batch file dumps can be programmatically driven, synchronized, and wrapped inside a modern, deterministic architecture.

The critical inquiry for executive leadership is not whether an API-less system can be integrated, but whether an organization possesses the structural discipline to sustain that integration across its operational lifecycle. Bypassing native data interfaces forces an organization to build a synthetic integration layer directly against user interfaces, network transport streams, or underlying storage volumes. This approach requires treating every screen as an unstable network protocol and every form field as a potential runtime failure.

Successfully automating workflows across closed legacy platforms demands rejecting the marketing narratives of off-the-shelf robotic process automation (RPA) and conversational artificial intelligence. Fragile macro recording and non-deterministic agentic tools consistently collapse when confronted with silent DOM mutations, unhandled modal interruptions, and asynchronous interface latency. Operational continuity instead requires deterministic engineering: wrapping legacy endpoints in strongly typed schemas, isolating execution behind persistent message queues, enforcing strict transactional idempotency, deploying automated synthetic canary monitors, and establishing rigid human approval gates for high-consequence state transitions.

1. The Day as It Actually Runs

At mid-market operating companies, integration across closed platforms is rarely executed by software pipelines; it is performed by human beings acting as biological middleware. Consider the workflow of an order-processing administrator or logistics coordinator operating inside an enterprise that processes high volumes of customer transactions each business day across a legacy, un-APIed supplier portal.

The operational day begins inside a desktop email client and a modern customer relationship management (CRM) platform such as Salesforce or HubSpot. The human operator opens an incoming customer purchase order, formatted as a semi-structured PDF attachment. To begin the transaction, the operator copies the alphanumeric customer reference number and switches contexts to an open web browser running a supplier portal developed in the early 2000s, which mandates session timeouts after fifteen minutes of inactivity. The operator navigates through three consecutive authentication screens, inputs the reference code, and waits for an unindexed search query to resolve across an unoptimized back-end database.

Once the supplier record renders, the operator evaluates catalog stock levels, switches back to the internal order screen to cross-reference customer pricing tiers, and opens a virtual private network (VPN) session hosting an on-premise ERP client—such as an AS400 terminal emulator or a legacy desktop client running over Microsoft Remote Desktop Services. Within this interface, the operator manually keys eighteen distinct data attributes: purchase order identifier, billing code, line-item stock keeping units (SKUs), unit counts, quoted shipping rates, and delivery dates. A single transaction forces the operator to execute dozens of discrete keyboard actions, navigate through multiple disparate application windows, and resolve repeated copy-paste transitions.

When this operator takes annual leave or reports sick, the integration layer halts. Transaction volume buffers in unread email queues and unmonitored spreadsheets. If temporary personnel or cross-trained staff step into the seat, transcription error rates climb immediately. Incoming orders miss supplier shipping cut-offs, customer tracking numbers fail to populate downstream dispatch schedules, and management loses operational visibility into real inventory levels until end-of-day reconciliation audits occur. The business operates with an unacknowledged single point of failure: human cognitive endurance applied to mechanical transcriptions.

2. Where the Time and the Money Go

Manual swivel-chair data re-entry introduces measurable balance-sheet friction through duplicated payroll expenditure, error rectification cycles, and severe latency in operational reporting.

The labor cost of maintaining human integration middleware is substantial. According to official data compiled by the U.S. Bureau of Labor Statistics under the Occupational Employment and Wage Statistics program for May 2023, there were 154,230 individuals employed across the United States within the specific standard occupational classification of Data Entry Keyers (SOC 43-9021). The Bureau measured a national mean hourly wage of $19.29 (equating to an annual mean wage of $40,130) and a median hourly wage of $18.17 (equating to an annual median wage of $37,790). For an enterprise employing full-time personnel dedicated entirely to transcribing order files, shipping manifests, or billing records between disjointed enterprise tools, direct base compensation represents a permanent operational tax, excluding payroll taxes, medical benefits, workstation licensing, and workspace overhead.

The secondary financial drain originates from transcription error propagation. In extensive academic research conducted at the University of Hawaii at Mānoa by Professor Raymond R. Panko, empirical studies established that human cognitive error rates in complex data entry tasks consistently settle between 1% and 6% per cell. In an analysis of field audits published in What We Know About Spreadsheet Errors, Panko documented that 94% of audited operational spreadsheets contained errors across seven field studies conducted since 19954. When human operators transcribe batches of field attributes across disconnected ERPs and supplier portals, mechanical errors—including inverted SKU numbers, misplaced decimal delimiters, and omitted shipping notes—are mathematically guaranteed to occur on a recurring basis.

Downstream reconciliation represents a compounded labor cost. An incorrectly keyed inventory code or purchase order amount generates freight reshipment charges, stockout penalties, customer credit memos, and administrative audit investigations. Furthermore, relying on human data entry introduces operational latency: transactional data generated at the opening of business does not reflect in executive financial reporting until the subsequent business day, preventing leadership from maintaining real-time cash flow, inventory valuation, or supply-chain visibility.

3. The Decisions Inside the Process

Automating a manual workflow requires decomposing human actions into their constituent decision mechanics. Every administrative action falls into one of three distinct categories: deterministic execution, domain-specific probabilistic judgement, or commercial risk ownership.

Workflow Action Category Information Inputs Governing Logic or Rule Operational Agency
Address Normalization Deterministic Raw address strings from incoming order documents Postal authority formatting rules, state abbreviation tables, and postal code regex Fully programmatic adapter
SKU Cross-Referencing Deterministic Customer internal part numbers and vendor catalog database 1:1 relational database lookup table or strict translation dictionary Fully programmatic adapter
Currency & Tax Conversion Deterministic Line-item subtotals, destination jurisdiction, and tax lookup tables Statutory sales tax rules and arithmetic multiplication Fully programmatic adapter
Catalog Description Disambiguation Judgement Non-standard vendor text descriptions and historical catalog metadata Semantic similarity scoring, contextual token matching, and unit-of-measure bounds Machine model with fallback to human review
Unmatched Line-Item Substitution Judgement Out-of-stock notification, product spec sheets, and functional equivalency lists Domain rules on form-fit-function tolerances and acceptable price variance thresholds Senior operational specialist
Credit Threshold Override Commercial Account credit limit, existing receivables balance, and new order total Enterprise risk appetite and corporate balance-sheet exposure policies Finance Director or Controller
Fraud & Sanctions Flag Resolution Commercial Compliance watchlists, end-user destination, and entity screening hits Regulatory trade controls and corporate legal risk liability Named Compliance Officer or Legal Counsel

Deterministic steps require zero human intervention; translating them into programmatic code eliminates manual latency and transcription errors entirely. Judgement tasks require contextual probabilistic reasoning; these can be assisted by narrow machine-learning models, but must immediately divert to human operators whenever classification confidence scores drop below a predetermined safety threshold. Commercial decisions involve the allocation of organizational capital and legal liability; these must never be delegated to autonomous scripts, requiring explicit human approval gates prior to downstream state mutation.

4. What Has Actually Been Deployed

Deploying programmatic adapters and automation layers against legacy, un-APIed platforms is not theoretical; extensive implementations operate across complex public sector and enterprise environments.

HM Revenue & Customs

HM Revenue & Customs (HMRC), the tax collection authority of the UK government, faced vast transactional backlogs across non-integrated legacy administrative systems. In an official operational report published on March 28, 2018, by the UK Civil Service, HMRC confirmed that it had deployed over 11,500 software robots across nearly 60 operational processes following an initial operational survey that identified 130 high-potential administrative tasks. Within its contact centers, HMRC wrapped multiple disparate back-end databases inside an automated dashboard that aggregated account information directly for customer service advisers; this adapter reduced the manual effort required to locate relevant taxpayer records from 66 individual mouse-clicks down to 10 clicks, cutting customer call handling durations by up to 2 minutes per interaction. For employer registrations, HMRC built an automated pipeline that validated incoming online application data and programmatically provisioned reference credentials directly within the core back-end system; this deployment achieved automated end-to-end processing for approximately 85% of all applications without manual intervention, accelerated registration confirmations to new employers by a factor of 3, and reduced processing costs by around 80%5.

East Suffolk and North Essex NHS Foundation Trust

East Suffolk and North Essex NHS Foundation Trust (ESNEFT), a major public healthcare provider in East Anglia operating Colchester and Ipswich hospitals, executed UI automation to bridge closed healthcare IT and booking databases. In official operational releases, the Trust reported that medical secretaries at Ipswich Hospital had historically been forced to spend between 10 and 20 minutes per GP referral manually printing referral paperwork from the national electronic booking service and physically scanning documents into the Evolve electronic document repository. ESNEFT deployed virtual software workers to monitor the referral queues, extract patient records programmatically, and route data directly into Evolve; between July 1, 2018, and early 2019, this integration released more than 2,230 hours (equivalent to 60 working weeks) of administrative staff time back to patient-facing care. Building upon this, ESNEFT automated outpatient cancellation processing at Colchester Hospital; in its initial week of production, the virtual worker automatically processed cancellations across the patient administration system, allowing the hospital to reallocate 301 unwanted clinic appointments to waiting patients and preventing over £48,000 in wasted clinical capacity based on an estimated outpatient appointment benchmark cost of £1606. Subsequently, on April 29, 2019, the Trust documented the deployment of an adapter in its Cardio-Respiratory department, which programmatically executed a complex 56-step patient registration sequence across 10 referral formats and 95 distinct form fields, completing development within 8 weeks.

University Hospitals of Morecambe Bay NHS Foundation Trust

At University Hospitals of Morecambe Bay NHS Foundation Trust (UHMBT), clinical workflows were constrained by an un-integrated external laboratory information system. As officially documented by the Trust on July 15, 2020, antenatal screening coordinators were required to manually log into an external laboratory portal hosted by The Newcastle upon Tyne Hospitals NHS Foundation Trust, execute manual lookups using patient NHS identifiers, and print blood screening reports for Down's syndrome, Edwards' syndrome, and Patau's syndrome. With approximately 3,200 annual births and up to 50% of pregnant women opting into the screening program, the manual search, extraction, and collation process consumed up to 2 hours of clinical coordinator time every day. UHMBT deployed a cloud-orchestrated Blue Prism robotic adapter that automatically queries the Newcastle laboratory portal three times daily, searches via secure patient tokens, extracts the three distinct clinical reports per patient, and triggers direct local printing, saving the antenatal coordinator up to 2 hours daily and eliminating the clinical risk of omitted or delayed laboratory results.

The Newcastle upon Tyne Hospitals NHS Foundation Trust

The Newcastle upon Tyne Hospitals NHS Foundation Trust deployed software robots to interface with the UK National Health Service's central Electronic Staff Record (ESR), an enterprise Oracle-based human resource platform lacking open external write APIs. On June 23, 2021, the Trust announced that its Human Resources robotic process automation program had won the 'Best Augmented Workforce' award at the IDC European Future of Work Awards 202111. The programmatic adapters were configured to execute transactional appraisal data entry and record probationary review completions directly across ESR screens; the Trust measured that this integration saved the equivalent of more than 9,000 hours of staffing time per year, redirecting organizational capacity away from keyboard data entry toward frontline clinical healthcare operations.

Telefónica O2

Telefónica O2 UK, a major telecommunications operating company, executed one of the earliest large-scale deployments of presentation-layer automation to bridge disjointed customer billing, SIM registration, and network provisioning systems. In an independent academic investigation conducted by Professor Mary C. Lacity of the University of Missouri-St. Louis and Professor Leslie P. Willcocks of the London School of Economics, published in MIS Quarterly Executive in March 2016, the researchers evaluated the operational and financial metrics of O2's multi-year implementation. Lacity and Willcocks verified that Telefónica O2 utilized Blue Prism software robots to replace repetitive human swivel-chair data movement across legacy core platforms, successfully automating over 35% of all back-office transactional volume and yielding annual returns on investment of up to 200%12.

5. What Failed: Structural Mechanisms of UI Automation Breakdown

Because commercially documented rollbacks and project abandonments are routinely shielded by non-disclosure agreements and liability settlements, publicly verified, named case studies detailing specific enterprise automation failures are not available in primary publications. However, when integrations against closed systems collapse, they do so not because the underlying business logic was unsound, but because the integration architecture failed to account for the physical realities of presentation-layer volatility. Four discrete failure mechanisms account for nearly all abandoned deployments.

Dynamic DOM and Selector Mutations

Web portals undergo continuous frontend optimization. When an external supplier or vendor deploys an update to a portal built on modern reactive frameworks such as React or Angular, internal Document Object Model (DOM) elements are routinely regenerated. Static CSS selectors, element identifiers, and nested XPath hierarchies mutate without warning. If an automation adapter relies on brittle absolute paths or dynamic auto-generated hashes, selector resolution fails instantly. The automation crashes at runtime because the element it was instructed to click no longer exists at that coordinate or hierarchy.

Unhandled Asynchronous Modals and Interruptive Prompts

Traditional enterprise software runs sequentially, but web and desktop applications behave asynchronously. A supplier portal may intermittently render an unannounced modal popup: a cookie compliance prompt, a scheduled maintenance warning, a terms-of-service acknowledgment, or a session keep-alive challenge. An adapter executing an automated script expects the subsequent data input field to be immediately focusable. When the modal intercepts the click target, the execution script throws an element interaction timeout or enters keys blindly into an inert backdrop. If error handling is not designed to recognize and dismiss ambient dialogs, the run halts mid-execution.

Distributed State Divergence and Orphaned Records

A fundamental difference between a native database transaction and a UI-driven integration is the lack of two-phase commit (2PC) architecture. In a native SQL environment, an update to an order table and an update to an inventory table succeed together or roll back atomically. In a UI-driven adapter, operations occur as sequential physical steps. If an adapter successfully inputs an order header on the initial screen, creates a customer account on the second screen, and then suffers a network disconnect or browser crash on the third screen before keying line items, the external system is left with an orphaned, half-written record. The far-side system does not roll back the transaction; it registers an incomplete order that sits undetected until fulfillment fails weeks later.

Technical Debt Compounding

Organizations frequently adopt visual macro recorders under the assumption that low-code workflows require zero ongoing engineering. In practice, as the number of automated workflows expands across an enterprise, maintenance requirements scale exponentially. When upstream portal vendors modify form fields, date picker widgets, or security authentication flows every few weeks, automation engineers spend their entire operational capacity executing emergency break-fixes. The maintenance labor outgrows the manual data entry costs the system was built to eliminate, leading executive leadership to quietly abandon the automation and return to human keyboard workers.

6. The Reference Architecture for Deterministic Adapters

To survive in production, an integration built against an un-APIed platform must be engineered with the same rigor as an enterprise microservice. Bypassing an API does not excuse bypassing software engineering fundamentals. The adapter must sit between internal business systems and the closed external platform as an isolated, resilient translation service.

Architectural Component Implementation Mechanism Operational Invariant Enforced
Typed Payload Gateway Schema definitions using Zod or Pydantic Enforces strict type validation on inputs/outputs; drops malformed payloads before execution
Durable Work Queue Asynchronous message broker (RabbitMQ, AWS SQS) Decouples incoming requests from target portal availability; absorbs upstream outages
Idempotency Coordinator SHA-256 state hashing and persistent distributed cache Guarantees identical execution requests execute exactly once on target screens
Execution Engine Headless browser (Playwright) or accessibility driver Controls presentation-layer sessions inside containerized, reproducible runtimes
Circuit Breaker Threshold error counter with automatic tripline Halts outbound job processing upon detecting structural UI changes; prevents account lockouts
Audit Trace Storage Immutable object storage (AWS S3 or equivalent) Retains timestamped DOM snapshots, step screenshots, and network logs for every transaction

Strongly Typed Interface Contracts

The adapter must never accept arbitrary untyped JSON or unparsed strings. All transactional payloads must be validated at the system boundary using explicit, strongly typed schemas (such as Zod in TypeScript or Pydantic in Python). A typed contract defines strictly bounded data types, mandatory fields, regex-validated postal codes, and enumerated values for every transaction. If an internal upstream service emits a payload containing a null customer identifier or an invalid date string, the adapter rejects the payload at ingestion, preventing garbage data from ever reaching the legacy interface.

Decoupled Queues and Work Brokers

A closed system must never be called synchronously from an active user request. If a customer clicks an order submission trigger, the web application must not wait for a headless browser to spin up, log in, and key fields into a supplier portal. Instead, the transaction must be committed to a durable, persistent message broker (such as AWS SQS, RabbitMQ, or Redis BullMQ). The queue decouples the internal business rhythm from external portal latency, buffering spikes in transaction volume and shielding internal workflows when the legacy system undergoes downtime.

Idempotency Keys and State Locking

Closed systems rarely implement native deduplication. If a network timeout occurs during a form submission, resubmitting the form can duplicate the financial charge or order lines. Every payload entering the adapter must carry a deterministic idempotency key—typically derived by hashing immutable operational attributes, such as a cryptographic SHA-256 hash of the purchase order number, vendor identifier, and total amount. Before executing any screen interaction, the adapter records this key in a persistent distributed database with an active processing state. If a retry attempt arrives with an identical key, the engine halts execution, preventing duplicate transactions.

Jittered Retry and Circuit Breaker Policies

When an adapter interacts with a remote portal, it encounters transient errors (network drops, slow database page loads) and permanent errors (invalid credentials, mutated DOM elements). The adapter must distinguish between the two. Transient errors trigger a retry schedule governed by exponential backoff with randomized jitter, preventing the adapter from swamping the legacy portal with synchronized connection requests. If the adapter encounters recurring selector or authentication failures, an automated circuit breaker trips into an open state. Outbound job execution halts immediately, error alerts dispatch to on-call engineering, and the system refuses further transactions until the structural issue is remediated.

Automated Canary Health Checks and Drift Detection

Brittleness must be uncovered by automated monitoring before it impacts business transactions. The architecture must include an automated synthetic canary running on an hourly schedule. The canary logs into the target system using dedicated testing credentials and executes non-mutating read operations: navigating menus, resolving form element selectors, querying a dummy record, and asserting that all expected DOM trees exist. If a vendor pushes an unannounced interface redesign at midnight, the canary fails rapidly, alerting engineering to patch selectors hours before the morning business queue opens.

Complete Visual and Network Audit Trails

Every programmatic action must generate forensic telemetry. For every page transition, form submission, and screen state, the adapter must capture and persist three immutable artifacts: a full-resolution timestamped screenshot, a complete serialized DOM snapshot, and a log of all HTTP network requests and responses emitted by the browser engine. If a vendor disputes receiving an order, or if an audit investigates a financial entry, the business can inspect the exact visual state and confirmation dialogue that the adapter encountered at that millisecond.

7. Where a Human Stays, and Why

Deterministic automation is not about removing human intelligence; it is about focusing human judgement strictly on consequential risk. A resilient architecture embeds mandatory human approval gates at three specific junctures.

Checkpoint 1: Ingestion and Validation Anomalies

When an incoming transactional payload violates schema rules—such as a billing address failing international postal validation, or a purchase order value deviating radically from the historical account average—the message cannot be processed automatically. The system routes the record to an exception staging table. An operations coordinator receives a notification containing the raw input, the specific validation error message, and a side-by-side data correction view. Once corrected and approved by the human operator, the message re-enters the work queue.

Checkpoint 2: Irreversible Commercial and Regulatory Actions

Certain system actions cannot be reversed via compensating software transactions: executing electronic funds disbursements, filing legal registrations, transmitting tax declarations, or committing non-cancellable high-value manufacturing orders. The adapter prepares the transaction up to the final execution step, inputs all fields into the target platform, and halts at the final submission interface. The system captures a DOM snapshot and screen render, presenting the operator with a verification card displaying the proposed action, financial value, and target screen preview. The external write is executed only after an authorized individual authenticates and submits a binary approval.

Checkpoint 3: Target System Drift and Schema Mutation

The most critical checkpoint unique to UI-driven integrations occurs when an adapter reports that the target platform's interface has mutated. If an hourly canary or an active production job detects that an expected DOM element has shifted, a mandatory modal has blocked the viewport, or a new required form field has appeared, execution freezes instantly. The system does not attempt heuristic guessing or probabilistic clicking. An operational ticket generates automatically, presenting engineering with the previous valid DOM snapshot alongside the newly encountered DOM state. The workflow remains paused until an engineer updates the typed selector definitions and releases the pipeline.

8. Integration Reality, by Kind of Closed System

The feasibility, technical strategy, and ongoing maintenance burden of building an adapter depend heavily on the underlying technology hosting the closed operational platform.

System Environment Architectural Access Strategy Typical Fragility Annual Maintenance Profile Non-Viable Conditions (Walk Away)
Modern Web Portal (SPA) Headless browser (Playwright) or internal JSON endpoints Moderate to High Regular selector updates required; frequent break-fixes if vendor deploys weekly Behavioral anti-bot software with mandatory biometric or SMS multi-factor challenges per action
Desktop Client (.NET / Win) Windows UI Automation API (UIA, WinAppDriver) Moderate Stable once running; highly fragile if display scaling or RDP latency shifts Dynamic coordinate-only rendering lacking accessible operating system accessibility tree hooks
Terminal Emulator (Green Screen) Socket-level TN3270 / VT100 protocol stream Extremely Low Minimal ongoing maintenance; interface character grids remain static for years Dynamic layout generation where field coordinates fluctuate unpredictably between host sessions
Batch File-Drop (SFTP / EDI) Secure protocol client with strict file parsers Very Low Exceptionally low; break-fixes occur only upon formal upstream format version changes Upstream system emits unescaped, delimiter-colliding flat files lacking formal schema specifications
Database-Only (Direct SQL) Dedicated read-only replica connection via ODBC Low for reads; Catastrophic for writes Schema migration monitoring required; zero UI churn Application business logic, constraints, and audit triggers live entirely in closed application memory

Web Portals

Modern web portals built with single-page application (SPA) architectures are deceptively complex. The most robust engineering approach avoids rendering the visual DOM entirely: by inspecting network traffic during an authenticated human session, engineers can often identify the private, undocumented REST or JSON endpoints the frontend web application uses to communicate with its backend. Wrapping these internal endpoints yields an order-of-magnitude improvement in speed and reliability compared to screen automation. However, if the portal enforces advanced bot mitigation—such as Cloudflare Turnstile, DataDome, or continuous CAPTCHA challenges—programmatic browser drivers (Playwright, Puppeteer) must be employed. Web portals exhibit the highest maintenance profile due to recurring, unannounced vendor deployments.

Desktop Clients

Legacy desktop ERPs, warehouse management platforms, and accounting suites running as native Windows applications (.NET, Win, WPF) lack HTTP endpoints. Reaching them requires interfacing directly with the operating system's Accessibility and UI Automation APIs (via frameworks such as WinAppDriver or Microsoft UI Automation UIA). This requires dedicating virtual machines running fixed display resolutions, disabling operating system automatic updates, and locking font scaling. If the application exposes native Windows accessibility handles, the integration can identify buttons, grids, and text inputs reliably. If the application renders inside a virtualized Citrix or Remote Desktop window that streams pixels rather than operating system controls, the adapter is forced to rely on Optical Character Recognition (OCR) and relative pixel coordinates—an approach so fragile that it should be avoided unless transaction volumes are exceptionally low and human verification is constant.

Terminal Emulators

Mainframe systems running IBM 3270, IBM 5250, or VT100 terminal interfaces are routinely mischaracterized as the hardest integration targets. In engineering reality, they are often the most stable. Terminal emulators communicate over standard TCP/IP sockets using fixed protocol streams (such as TN3270). The display interface is a rigid coordinate matrix. Data fields exist at invariant screen coordinates that have often remained unchanged for decades. A terminal adapter operates without browser rendering engines, graphic cards, or DOM trees; it sends raw character byte arrays and reads fixed buffer strings. Once mapped, green-screen adapters operate with exceptional speed and lower annual maintenance costs than web portals.

Batch File-Drop Interfaces

When a legacy platform supports scheduled file dumps via Secure File Transfer Protocol (SFTP), network shares, or flat-file EDI protocols, this interface must always take precedence over screen-driven automation. Batch file drops decouple processing entirely from user interfaces. Fragility is minimal, constrained only by upstream schema changes (such as the addition of unexpected columns). The operational trade-off is latency: batch files are typically exported on scheduled intervals, preventing real-time, synchronous transaction processing.

Database-Only Integrations

Directly querying the underlying database (such as Microsoft SQL Server, Oracle, or PostgreSQL) of a legacy platform via an ODBC/JDBC read replica is an exceptional pattern for real-time extraction and reporting. However, executing direct SQL write statements against an operational ERP database is dangerous. Enterprise software rarely implements its complete business validation logic within database foreign keys and constraints; critical rules (such as inventory availability checks, general ledger balancing, and audit logging) are enforced in application-tier code. Bypassing the application layer to write directly to SQL tables bypasses these safeguards, easily corrupting referential integrity and voiding vendor support agreements. Direct database access should remain strictly read-only.

9. Regulation, Contract and Liability

Automating access to systems that provide no public API introduces legal and contractual considerations that leadership must evaluate directly.

Contractual Enforceability and Terms of Service

Most enterprise software agreements, SaaS master services agreements (MSAs), and supplier portal Terms of Service (ToS) contain explicit restrictive covenants prohibiting automated access. Common clauses state that users may not utilize automated data gathering, extraction tools, scripts, or algorithms to access or monitor the platform.

Violating these terms does not generally constitute a criminal offense, but it represents a breach of contract. In the European Union, the Court of Justice of the European Union (CJEU) established this boundary in Ryanair Ltd v PR Aviation BV (Case C-30/14, decided January 15, 2015). PR Aviation operated a price-comparison flight search engine that scraped flight and pricing data directly from Ryanair’s website. Ryanair sued, alleging violations of European database copyright protections and breach of its terms of use. The CJEU ruled that where a database is not protected by copyright or the sui generis database right under Directive 96/9/EC, the database owner is entirely free to establish contractual restrictions governing the use of its platform via its terms and conditions. If a party accepts those terms to access the system, the platform owner may enforce those restrictions under standard contract law. In commercial practice, the typical remedy sought by a vendor is not financial litigation, but immediate administrative sanction: terminating platform access, revoking credentials, or banning corporate IP blocks.

Statutory Boundaries and Computer Misuse Law

In the United States, the primary federal statute governing unauthorized computer interactions is the Computer Fraud and Abuse Act (CFAA), codified at 18 U.S.C. § 1030. Historically, aggressive plaintiffs attempted to classify any violation of a website's contractual terms of service as criminal computer fraud, arguing that breaching a terms-of-use policy meant an individual "exceeded authorized access."

The Supreme Court of the United States conclusively rejected this expansive interpretation in Van Buren v. United States, 593 U.S. 374, decided on June 3, 202115. In Van Buren, a police sergeant authorized to access a law enforcement license-plate database searched a record for personal financial gain, violating department policy. Writing for the Court, Justice Amy Coney Barrett held that an individual "exceeds authorized access" under § 1030(a)(2) only when accessing computer areas—such as files, folders, or databases—that they have no permission to enter. The Court ruled that the CFAA does not penalize using authorized credentials to access information for an improper or unauthorized purpose. Consequently, if an enterprise possesses legitimate, authenticated credentials to an operational system, using software to automate the keying or extraction of data within the boundaries of those credentials does not constitute federal computer hacking under the CFAA.

This boundary was reinforced regarding public data in hiQ Labs, Inc. v. LinkedIn Corp., 31 F.4th 1180, decided by the U.S. Court of Appeals for the Ninth Circuit on April 18, 202217. The Ninth Circuit held that automated scraping of publicly available website data does not violate the CFAA’s prohibition on accessing a computer "without authorization," even after the platform issues an explicit cease-and-desist letter, because authorization is not required to access public web pages. In the United Kingdom, Section 1 of the Computer Misuse Act 1990 similarly criminalizes causing a computer to perform any function with intent to secure access to programs or data held in any computer where that access is unauthorized. As in the United States, operating within the scope of validly held commercial credentials generally separates automated workflow execution from criminal computer misuse, resting the dispute entirely within commercial contract law.

Government and Regulated Portals

The legal risk shifts dramatically when the integration interacts with government filing systems, customs agencies, or regulated public infrastructure. Under statutes such as 18 U.S.C. § 1030(a)(2)(B), systems operated on behalf of government agencies carry stringent statutory protections. Submitting false, erroneous, or duplicated filings to a government portal—even through an unintended software looping error—exposes an organization to statutory penalties, regulatory enforcement, and civil liabilities under the False Claims Act. When interacting with public authorities, corporate filings are legally submitted under penalty of perjury. An organization cannot shift legal culpability to an automated script; the corporate entity and the executive officers signing the submissions retain absolute statutory liability.

Allocation of Operational Risk

Every engineering agreement covering custom adapter development must explicitly define the boundary of operational liability. A technology vendor or systems integrator builds the transmission mechanism, but the enterprise customer owns the data payload. If an adapter misinterprets a field and transmits an erroneous order or cancels a valid shipping contract, the operating company carries the commercial loss. The operating organization must maintain ultimate operational oversight through human approval gates and robust reconciliation audits.

10. The Qualification Questions

Before allocating capital or engineering resources to wrap an un-APIed system, leadership should evaluate the integration's feasibility during an initial diagnostic qualification session. Ten targeted questions establish whether the platform can be safely wrapped or if the organization should decline the initiative.

1. What is the business impact if the integration is completely unavailable for 48 consecutive hours?

  • Acceptable Response: Operations can temporarily buffer incoming transactions in an internal queue or revert to manual processing without incurring fatal contract penalties.
  • Disqualifying Answer: "A two-day outage shuts down operations, defaults on customer SLA penalties, or halts the physical production line." If the business cannot tolerate interface downtime while engineers update broken selectors, screen automation is too high-risk.

2. Can the transaction flow be intercepted at the network level rather than the visual DOM?

  • Acceptable Response: Inspecting the portal's browser network traffic reveals internal HTTP/REST endpoints that can be addressed directly via token-authenticated scripts.
  • Disqualifying Answer: "No, the application renders exclusively via a compiled desktop client, a virtualized remote desktop stream, or obfuscated WebAssembly canvases." Driving workflows through raw computer vision and coordinate-based mouse automation yields extreme operational fragility.

3. Does the legacy system enforce continuous, interactive authentication challenges?

  • Acceptable Response: The system requires standard username/password authentication, or a static API token, or a multi-factor authentication (MFA) step that can be satisfied once per session via automated enterprise single-sign-on (SSO) or time-based one-time password (TOTP) seed generation.
  • Disqualifying Answer: "The vendor prompts for a random visual CAPTCHA, SMS verification code, or hardware security key tap on every individual transaction submission." Bypassing continuous interactive challenges compromises reliability and violates vendor security parameters.

4. Is there an isolated staging, sandbox, or test environment available?

  • Acceptable Response: The vendor provides a non-production test tenant, or internal IT can host an isolated instance of the desktop database for development and regression testing.
  • Disqualifying Answer: "Every test run must be executed live against the production database, and transactions cannot be deleted." Attempting to reverse-engineer and stress-test an automated adapter against live production databases will inevitably generate corrupt records.

5. What is the vendor's software deployment and UI update frequency?

  • Acceptable Response: The legacy system is mature, operating on an annual or bi-annual scheduled release cycle with advance release notes provided to customers.
  • Disqualifying Answer: "The software is a consumer-facing SaaS tool that continuously deploys unannounced UI modifications and experimental layout tests weekly." Continuous UI churn guarantees recurring selector breakage and unsustainable maintenance overhead.

6. Are downstream transactions natively idempotent or safely reversible?

  • Acceptable Response: The target system rejects duplicate purchase order identifiers, or the adapter can query existing records before submission, or transactions can be programmatically cancelled.
  • Disqualifying Answer: "Submitting a form instantly initiates an irreversible financial wire or non-cancellable third-party logistics dispatch with no pre-submission validation." Irreversible state changes combined with presentation-layer instability create severe balance-sheet exposure.

7. Does the platform terms-of-service agreement expose the enterprise to existential operational penalties?

  • Acceptable Response: The contract allows legitimate access via authorized credentials, or the vendor is an established trading partner that acknowledges automated processing upon request.
  • Disqualifying Answer: "The vendor actively monitors for non-browser user agents, employs dedicated anti-scraping defenses, and will immediately terminate our core enterprise operating license if automation is identified." Walking into active legal or operational termination is unacceptable commercial risk.

8. Is the transaction volume sufficient to justify the ongoing maintenance overhead?

  • Acceptable Response: The manual process consumes significant administrative labor weekly, and the projected labor savings substantially exceed the cost of ongoing adapter monitoring and engineering support.
  • Disqualifying Answer: "We only process a few transactions a week, but we want it fully automated." Low-volume workflows never recover the capital cost of building typed adapters, setting up monitoring infrastructure, and maintaining selector updates.

9. Can the workflow be structured asynchronously?

  • Acceptable Response: Outbound transactions can wait in a message queue for several minutes to execute, retry, and confirm.
  • Disqualifying Answer: "A human user is waiting on a customer-facing screen expecting a sub-second synchronous API response." Presentation-layer automations require variable spin-up, navigation, and rendering latencies that cannot support real-time user-facing SLAs.

10. Is operational leadership willing to enforce human approval gates on consequential actions?

  • Acceptable Response: The operations team commits to reviewing an exception dashboard and explicitly verifying financial submissions or edge-case anomalies.
  • Disqualifying Answer: "We require 100% autonomous operation with zero human staffing allocated to review exceptions or verify high-value transactions." Eliminating all human oversight from a screen-driven integration guarantees eventual systemic failure.

Wrapping an un-APIed enterprise system is fundamentally an exercise in risk engineering: trading the permanent cognitive drag and transcription errors of manual entry for the predictable overhead of software maintenance. When built not as a brittle visual macro, but as a strongly typed, queue-isolated service hardened with cryptographic idempotency, synthetic drift canaries, and mandatory human checkpoints, the adapter transforms a hostile legacy system into a dependable operational pipeline. The underlying software remains closed, but the enterprise ceases to be its prisoner.

Annotated Primary Source Directory

Empirical Verification Table

Claim Primary source Date of primary source Label Link
In the United States, 154,230 workers are employed as Data Entry Keyers (SOC 43-9021) U.S. Bureau of Labor Statistics Occupational Employment and Wage Statistics May 2023 (released April 3, 2024) INDEPENDENTLY VERIFIED https://www.bls.gov/oes/2023/may/oes439021.htm
Data Entry Keyers earn a national mean hourly wage of $19.29 and annual mean wage of $40,130 U.S. Bureau of Labor Statistics Occupational Employment and Wage Statistics May 2023 (released April 3, 2024) INDEPENDENTLY VERIFIED https://www.bls.gov/oes/2023/may/oes439021.htm
Data Entry Keyers earn a national median hourly wage of $18.17 and annual median wage of $37,790 U.S. Bureau of Labor Statistics Occupational Employment and Wage Statistics May 2023 (released April 3, 2024) INDEPENDENTLY VERIFIED https://www.bls.gov/oes/2023/may/oes439021.htm
Human data entry cell error rates consistently measure between 1% and 6% across operational tasks Raymond R. Panko, What We Know About Spreadsheet Errors, University of Hawaii May 2008 INDEPENDENTLY VERIFIED https://www.researchgate.net/publication/228662532_What_We_Know_About_Spreadsheet_Errors
Across 7 field audit studies evaluated since 1995, 94% of operational spreadsheets contained errors Raymond R. Panko, What We Know About Spreadsheet Errors, University of Hawaii May 2008 INDEPENDENTLY VERIFIED https://www.researchgate.net/publication/228662532_What_We_Know_About_Spreadsheet_Errors
HMRC deployed over 11,500 software robots across nearly 60 operational processes UK Civil Service / HM Revenue & Customs March 28, 2018 CUSTOMER-REPORTED https://quarterly.blog.gov.uk/2018/03/28/robots-lend-government-a-helping-hand/
HMRC internal operational survey identified 130 high-potential administrative tasks for automation UK Civil Service / HM Revenue & Customs March 28, 2018 CUSTOMER-REPORTED https://quarterly.blog.gov.uk/2018/03/28/robots-lend-government-a-helping-hand/
HMRC contact center dashboard reduced adviser mouse-clicks from 66 to 10 across disparate systems UK Civil Service / HM Revenue & Customs March 28, 2018 CUSTOMER-REPORTED https://quarterly.blog.gov.uk/2018/03/28/robots-lend-government-a-helping-hand/
HMRC contact center dashboard cuts customer call handling times by up to 2 minutes UK Civil Service / HM Revenue & Customs March 28, 2018 CUSTOMER-REPORTED https://quarterly.blog.gov.uk/2018/03/28/robots-lend-government-a-helping-hand/
HMRC employer registration automation processes approximately 85% of applications without manual intervention UK Civil Service / HM Revenue & Customs March 28, 2018 CUSTOMER-REPORTED https://quarterly.blog.gov.uk/2018/03/28/robots-lend-government-a-helping-hand/
HMRC employer registration automation delivers confirmations 3 times faster UK Civil Service / HM Revenue & Customs March 28, 2018 CUSTOMER-REPORTED https://quarterly.blog.gov.uk/2018/03/28/robots-lend-government-a-helping-hand/
HMRC employer registration automation reduces unit processing costs by around 80% UK Civil Service / HM Revenue & Customs March 28, 2018 CUSTOMER-REPORTED https://quarterly.blog.gov.uk/2018/03/28/robots-lend-government-a-helping-hand/
ESNEFT medical secretaries saved 10 to 20 minutes per GP referral by automating document processing East Suffolk and North Essex NHS Foundation Trust 2019 CUSTOMER-REPORTED https://www.esneft.nhs.uk/robots-save-time-and-cut-down-on-wasted-appointments-in-outpatients/
ESNEFT automation released over 2,230 hours (60 weeks) of staff time for medical secretaries East Suffolk and North Essex NHS Foundation Trust 2019 CUSTOMER-REPORTED https://www.esneft.nhs.uk/robots-save-time-and-cut-down-on-wasted-appointments-in-outpatients/
ESNEFT outpatient automation reallocated 301 unwanted clinic appointments in its first week East Suffolk and North Essex NHS Foundation Trust 2019 CUSTOMER-REPORTED https://www.esneft.nhs.uk/robots-save-time-and-cut-down-on-wasted-appointments-in-outpatients/
ESNEFT outpatient cancellation automation prevented wasting more than £48,000 in its first week East Suffolk and North Essex NHS Foundation Trust 2019 CUSTOMER-REPORTED https://www.esneft.nhs.uk/robots-save-time-and-cut-down-on-wasted-appointments-in-outpatients/
Benchmark cost of an outpatient appointment at Colchester Hospital is estimated at £160 East Suffolk and North Essex NHS Foundation Trust 2019 CUSTOMER-REPORTED https://www.esneft.nhs.uk/robots-save-time-and-cut-down-on-wasted-appointments-in-outpatients/
ESNEFT Cardiorespiratory referral automation handles 56 registration steps across 10 referral types and 95 fields East Suffolk and North Essex NHS Foundation Trust April 29, 2019 CUSTOMER-REPORTED https://www.esneft.nhs.uk/robots-make-time-matter-in-cardiorespiratory/
ESNEFT Cardiorespiratory referral automation project took 8 weeks to develop East Suffolk and North Essex NHS Foundation Trust April 29, 2019 CUSTOMER-REPORTED https://www.esneft.nhs.uk/robots-make-time-matter-in-cardiorespiratory/
UHMBT software robot saves antenatal screening coordinator up to 2 hours every day University Hospitals of Morecambe Bay NHS Foundation Trust July 15, 2020 CUSTOMER-REPORTED https://www.uhmb.nhs.uk/news-and-events/latest-news/robot-saving-midwife-two-hours-day-giving-her-more-time-spend-caring-women
UHMBT manages approximately 3,200 births per year with up to 50% screening uptake University Hospitals of Morecambe Bay NHS Foundation Trust July 15, 2020 CUSTOMER-REPORTED https://www.uhmb.nhs.uk/news-and-events/latest-news/robot-saving-midwife-two-hours-day-giving-her-more-time-spend-caring-women
Newcastle Hospitals HR robotic automation saved the equivalent of more than 9,000 hours in staffing time per year The Newcastle upon Tyne Hospitals NHS Foundation Trust June 23, 2021 CUSTOMER-REPORTED https://www.newcastle-hospitals.nhs.uk/news/newcastle-hospitals-hr-robot-wins-national-award/
Telefónica O2 automated over 35% of back-office transactions using Blue Prism software robots Mary C. Lacity & Leslie P. Willcocks, MIS Quarterly Executive March 2016 INDEPENDENTLY VERIFIED https://aisel.aisnet.org/misqe/vol15/iss1/4/
Telefónica O2 achieved annual returns on investment of up to 200% on its automation deployment Mary C. Lacity & Leslie P. Willcocks, MIS Quarterly Executive March 2016 INDEPENDENTLY VERIFIED https://aisel.aisnet.org/misqe/vol15/iss1/4/

Источники

  1. May 2023 National Occupational Employment and Wage Estimates, https://www.bls.gov/oes/2023/may/oes_nat.htm
  2. Data Entry Keyers - Bureau of Labor Statistics, https://www.bls.gov/oes/2023/may/oes439021.htm
  3. Raymond R. Panko - ResearchGate, https://www.researchgate.net/profile/Raymond-Panko
  4. Studies of Spreadsheet Errors | Download Table - ResearchGate, https://www.researchgate.net/figure/Studies-of-Spreadsheet-Errors_tbl1_228662532
  5. Robots lend government a helping hand - Civil Service Quarterly, https://quarterly.blog.gov.uk/2018/03/28/robots-lend-government-a-helping-hand/
  6. Robots save time and cut down on wasted appointments in, https://www.esneft.nhs.uk/robots-save-time-and-cut-down-on-wasted-appointments-in-outpatients/
  7. Robots have arrived at ESNEFT and they are giving back hundreds, https://www.esneft.nhs.uk/robots-have-arrived-at-esneft-and-they-are-giving-back-hundreds-of-hours-to-medical-secretaries-so-they-can-spend-more-time-helping-patients/
  8. Robots make time matter in cardiorespiratory, https://www.esneft.nhs.uk/robots-make-time-matter-in-cardiorespiratory/
  9. Page 69 of 77 - East Suffolk & North Essex NHS Foundation Trust, https://www.esneft.nhs.uk/contact-us/communications-team/article-archive/page/69/
  10. Robot saving midwife up to two hours a day giving her more time to, https://www.uhmb.nhs.uk/news-and-events/latest-news/robot-saving-midwife-two-hours-day-giving-her-more-time-spend-caring-women
  11. Newcastle Hospitals' HR 'robot' wins national award, https://www.newcastle-hospitals.nhs.uk/news/newcastle-hospitals-hr-robot-wins-national-award/
  12. Robotic Process Automation at Telefonica O2 - AIS eLibrary, https://aisel.aisnet.org/misqe/vol15/iss1/4/
  13. The IT Function and Robotic Process Automation - Blue Prism, https://www.blueprism.com/uploads/resources/white-papers/LSE-The-IT-Function-and-Robotic-Process-Automation.pdf
  14. C-30/14 - Cases - InfoCuria - Court of Justice of the European Union, https://infocuria.curia.europa.eu/tabs/redirect/juris/liste.jsf?num=C-30/14
  15. Van Buren v. United States | 593 U.S. ___ (2021), https://supreme.justia.com/cases/federal/us/593/19-783/
  16. United States v. Van Buren, No. 18-12024 (11th Cir. 2021) - Justia Law, https://law.justia.com/cases/federal/appellate-courts/ca11/18-12024/18-12024-2021-08-04.html
  17. HIQ LABS, INC. V. LINKEDIN CORPORATION (9th Cir. 2022), https://law.justia.com/cases/federal/appellate-courts/ca9/17-16783/17-16783-2022-04-18.html
  18. Computer Misuse Act 1990 - Legislation.gov.uk, https://www.legislation.gov.uk/ukpga/1990/18/contents/made/data.html
  19. Computer Misuse Act 1990, Section 1 - Legislation.gov.uk, https://www.legislation.gov.uk/ukpga/1990/18/section/1

The system you depend on has no API.

Talk to an engineer