Software & Systems · API integrations

API integrations

Interfaces between CRM, ERP, marketing tools and specialist applications that hold up in operation: with retries, a queue, monitoring and documentation. So data flows instead of being copied.

01 How you recognise it

Does this sound like your situation?

Three starting points we see regularly. One of them is enough.

  • 01

    Data is moved between systems by hand

    Every day, repeatedly and with errors. A job an interface can take over.

  • 02

    An existing connection fails silently

    Nobody notices the missing records until a customer asks.

  • 03

    One system has no interface

    Older applications only offer exports and imports, which still have to run correctly.

02 What you get

Three results you will notice in daily work.

  • The right integration pattern

    Event, schedule, request, mediation or file exchange, justified by the requirements and the systems, not by habit.

  • Six properties that are always there

    No duplicates on retry, a queue for errors, monitoring, versioning, security, documentation.

  • A launch with observation

    Gradual activation, close monitoring in the first weeks, adjustment to the real data patterns.

03 What it looks like

A case that survives an outage.

Schematic example with fictitious data

An order should move from the shop into the ERP. The target system is briefly unreachable. Here is what happens.

  1. 1 · Acceptance

    The shop reports the order. It receives a unique case number derived from the order number and goes into a queue. Acceptance is confirmed immediately.

  2. 2 · Transfer

    The transfer into the ERP uses the case number as its key. If the same case arrives twice, no second order is created; the second transfer is recognised as already processed.

  3. 3 · Temporary error

    The ERP answers with a server error. The transfer is retried at growing intervals: after 30 seconds, 2 minutes, 10 minutes, 1 hour.

  4. 4 · Permanent error

    After the last retry the case moves into a visible error queue, with the time, the answer from the target system and the transferred data.

  5. 5 · Escalation

    If a case sits in the error queue for longer than 30 minutes, a notification goes to the responsible person. There is no silent loss.

  6. 6 · Catch-up

    Once the ERP is reachable again, the waiting cases are delivered in order of arrival. The case number prevents double bookings.

We distinguish between “try again later” and “this will never work”. A content error such as an unknown article number is not retried but reported immediately.

How do we start?

Ioannis and Tugce Fotiou discussing a process together at the desk
This is how every collaboration starts: with a concrete process on the table, not with a specification document.

Two systems should exchange data reliably, even when one of them is not answering.

An interface for one case type with retry logic, idempotency and a visible error queue.

API documentation and test access on both sides, plus your expectation for frequency and acceptable delay.

We only need these accesses and documents once we start working together. For a first conversation, a short description of your situation is enough.

04 Definition

Integrations that hold up in operation.

What is an API integration?

An API integration connects two or more software systems through their programming interfaces so that data is exchanged automatically, by rules and traceably, without manual transfer.

The difference between an integration that works and one that holds up in operation lies in the invisible parts: error handling, retry logic, monitoring and documentation. Those are exactly the parts FIOXX builds in from the start.

05 Patterns

Five integration patterns and when each fits.

  • Webhooks

    Event based

    One system reports a change, the other reacts immediately. Ideal for status changes, new enquiries, orders.

  • Sync jobs

    Scheduled

    Regular reconciliation of data sets: robust, plannable, with a defined delay.

  • Request/response

    Real-time query

    One system asks when it needs to: availability, price, payment status. No copy, always current.

  • Middleware

    Central mediation

    A hub connects several systems and takes over mapping, error handling and logging.

  • Legacy

    File and batch exchange

    When a system has no API: structured exports and imports with checks and a log, as cleanly as possible.

06 Quality

What a FIOXX integration always has.

Six properties that are not negotiable, regardless of whether we use a platform or build our own service.

  • 01

    Idempotency

    The same message may arrive more than once without creating duplicate records.

  • 02

    Retry and queue

    Temporary errors are retried automatically; permanent ones land visibly in an error queue.

  • 03

    Monitoring

    Throughput, errors and latency are monitored and reported before anyone notices a missing record.

  • 04

    Versioning

    Changes to interfaces are versioned; old and new versions can run alongside each other.

  • 05

    Security

    Authentication, minimal permissions, encrypted transfer, no secrets in the code.

  • 06

    Documentation

    Every integration has a description: purpose, data flows, error cases, contacts.

07 How we work

From the requirement to operation.

  1. 01

    Requirements and data flows

    Which data, in which direction, how fast, how often? And what happens when it does not work?

  2. 02

    Check the interfaces

    What do the systems involved really offer: API, webhooks, export? Boundaries, limits and cost are clarified before building.

  3. 03

    Choose the pattern

    Event, schedule, query or mediation, matched to the requirement and the systems, not to habit.

  4. 04

    Build and test

    Implementation with automated tests, test data and trial runs against the real systems in a safe environment.

  5. 05

    Roll out and observe

    Gradual activation, close monitoring in the first weeks, adjustment to the real data patterns.

  6. 06

    Operate

    Monitoring, updates when systems change, documentation kept current. An integration is something you operate, not a project you finish.

08 Next

Integrations are the basis of automation and AI.

Every process automation and every AI agent needs access to systems. Stable interfaces are therefore not a technical side note but the prerequisite for automation to run reliably in daily work. The most common combination: CRM and ERP.

09 FAQ

Common questions about API integrations

When is an automation platform enough and when do you need your own integration?

Platforms suit manageable logic, moderate data volumes and standard systems: quick to set up and easy to see. Your own integration becomes sensible when volume, special cases, security requirements or cost exceed the platform. We start with the simplest path that works stably.

What happens if a connected system fails?

The integration detects the outage, retries requests under control and puts undeliverable messages into a queue. After recovery they are delivered. Retry logic and idempotency aim to avoid data loss and duplicates; the specific requirements and limits we define per integration. Outages are reported, not swallowed.

Can FIOXX take over existing integrations?

Yes. We document the current state, add monitoring and error handling and stabilise what is unstable. Often that is the first step before new systems get connected.

Next step

Which data still moves between systems by hand at your company?

We check the systems involved, choose the right integration pattern and build an interface that holds up in operation.