When you need this

  • Data is copied by hand from one system to another, and nobody remembers any more why it is done that way.
  • Nobody knows where the original lives. Two reports give two answers to the same question.
  • A tender or a development project is ahead. The integration part has to be written so that the bids come back comparable.
  • An e-invoicing, X-Road or partner-interface connection does not work the way it was promised. The file moves, but the content is not what the receiving side needs.
  • A new system is arriving alongside the existing ones. Before go-live you need to know which interfaces have to work from day one.

What we do

  • Data-flow mapping — what data originates where, where it moves, who owns it and what is sensitive (PII, retention, access).
  • A shared vocabulary — one concept, one definition. Most integration disputes are really disputes about concepts.
  • API specifications (OpenAPI 3.x) — contracts, authentication, error scenarios, quotas and limits, versioning.
  • An interface description for a developer or for a tender — field-level mapping, business rules, synchronicity and frequency, and the basis for acceptance.
  • A map of dependencies and risks — what breaks if one side changes or stops responding.
  • Integration pre-analysis — the combined deliverable a developer can start work from, or a contracting authority can build a tender description on.
  • Interface delivery — REST interfaces built from the OpenAPI description, with authentication, error handling, retries, logging and monitoring.

The description is written so that it can be handed to any developer. If you would like the same person who wrote the description to build it as well, that is one of the ways to work together too.

What you receive

  • D.04

    Dataflow diagrams

    How data moves between systems and processes, with classification and sensitivity tagging (PII, retention, owner).

    FormatsDRAW.IOMDPDF
  • D.05

    APIs and integrations

    OpenAPI 3.x contracts, authentication, error scenarios, quotas, versioning.

    FormatsOPENAPIMDPOSTMAN
  • List of risks and assumptions

    What has to be true for the interface to work — and what happens if it is not.

    FormatsXLSXMD
  • Field mapping

    Source and target fields, with transformation rules and whether each field is mandatory.

    FormatsXLSXMD

All deliverables are handed over in editable formats.

Security in this work

An integration is the place where data leaves the protection of one system and arrives in another. That is why the mapping comes with data classification and sensitivity tagging: what counts as personal data, how long it is kept, who owns it, who has access, and what is logged. These are part of the interface description, not a separate security chapter at the end.

In delivery the same idea is added as a way of working: authentication and permissions from the start, secrets kept out of the code, and behaviour in error situations described and logged so that afterwards you can tell what happened.

Where this comes from

The founding analyst has 13+ years of practice with systems, data models and system-to-system interfaces in banking, telecom, IT consulting and logistics. Qualification: BCS Foundation Certificate in Business Analysis. Working languages Estonian and English.

The closest public example of what our integration-analysis conclusions look like is our e-invoicing article: it works through exactly that job — what applies, what is promised, where the promise and the actual data flow part ways, and what to do about it.

Further reading

We write in Estonian first. The pieces below have not been translated yet and open in Estonian.

Ways to work together

Each of these is a starting point; we settle its scope in conversation and fix it in a written offer. The steps can be taken separately, or one after another in a logical sequence.

Integration pre-analysis

A fixed-scope written deliverable, produced before development or a tender. It answers the question of what has to move, where to, and under which rules.

What it includes:

  • Data-flow mapping across the chosen systems
  • Overview of APIs and existing interfaces
  • Pre-requirements description for the developer
  • List of risks and assumptions

Interface specification

The technical description of a single interface, at a level that lets you build from it and accept against it. Works for internal development and as an annex to a tender alike.

What it includes:

  • An OpenAPI 3.x contract with authentication and error handling
  • Field mapping and transformation rules
  • Synchronicity, frequency, quotas and versioning
  • The basis for acceptance, and test scenarios

One interface end to end

From the description to a working interface, and on to handover. The same analyst-developer does the work from start to finish, so the description and the build do not drift apart.

What it includes:

  • The interface built from the agreed description
  • Automated tests within the agreed scope
  • Logging and monitoring, so that failures stay readable afterwards
  • A deployment guide and technical handover

Integration review

A look at what already moves in your organisation today. Suits you when interfaces have accumulated over the years and nobody holds the whole picture any more.

What it includes:

  • An inventory of existing interfaces and their owners
  • Duplicated and broken flows
  • A dependency map with the risk areas marked
  • Recommendations on the order in which to tidy things up

Describe your situation in one message.

Write down which systems you have and what moves between them by hand today. We talk the scope through and send a written offer. We reply within one working day, and the first discussion is free.