Biexus|Technical Solution Document
MLT-Consulting ยท Technical Solution Document

Biexus Integration & Orchestration Platform

Technical Overview, Proposed Solution Architecture and Implementation Approach

Prepared by
Marco van Biljoen
MLT-Consulting
Platform
Biexus Integration & Orchestration Platform
โš ๏ธ Proposed Solution โ€” Subject to Technical Discovery and Validation
This document presents a proposed solution for discussion purposes. All technical specifications, integration capabilities, hosting models and estimates are indicative and must be validated during the technical discovery phase before final design and quotation are approved.
01

Executive summary

MLT-Consulting proposes the Biexus Integration & Orchestration Platform as the middleware layer to connect the client's Salesforce CRM environment with their Sage accounting/ERP system. Biexus is designed to sit between business applications โ€” not to replace them โ€” orchestrating the flow of data, applying business rules, and providing operational visibility across integrated systems.

The proposed initial scope covers the synchronisation of customer accounts and contacts, publication of product and price-list data, creation of sales orders or invoices from closed-won opportunities, and the return of financial status information to Salesforce. This document outlines the proposed architecture, data flows, implementation approach, and a 44-hour estimated effort for one initial orchestration use case.

๐Ÿ“ Key message
Biexus acts as an integration and orchestration layer between existing business applications. It does not replace Salesforce, Sage, or any other system of record. All proposed capabilities are subject to confirmation during technical discovery.
02

Business objectives and integration challenges

Business objectives

  • Ensure customer account and contact information is consistent between Salesforce and Sage.
  • Make product and price-list data from Sage available to sales users in Salesforce.
  • Automate the creation of sales orders or invoices in Sage when opportunities are won in Salesforce.
  • Provide sales teams with real-time visibility into invoice status, payments, and account standing.
  • Reduce manual data entry, eliminate duplicate records, and minimise reconciliation effort.

Integration challenges addressed

  • Data silos: Customer, product and financial data locked in separate systems with no automated exchange.
  • Manual rekeying: Sales and finance teams duplicate effort entering the same data in both systems.
  • Inconsistency: Differing account numbers, credit terms and product codes across systems cause errors.
  • Limited visibility: Sales teams cannot see outstanding balances or payment status without requesting reports from finance.
  • Scalability: As transaction volumes grow, manual processes become unsustainable.
03

Introduction to Biexus

Biexus is an integration and orchestration platform that connects enterprise applications through their APIs. Rather than replacing existing systems, Biexus acts as a middleware layer that reads from and writes to each connected system according to configurable workflows and business rules.

The platform is designed to handle the full lifecycle of an integration: connecting to source and destination systems, mapping and transforming data between different schemas, orchestrating multi-step workflows, applying validation and business rules, handling errors and retries, and providing logging and monitoring for operational visibility.

โ„น๏ธ Positioning
Biexus is positioned as an integration and orchestration layer between business applications. It does not store transactional data as a system of record, nor does it replace the client's CRM, ERP, or accounting systems.
04

Proposed solution overview

The proposed solution connects Salesforce and Sage through Biexus, with bi-directional data flows tailored to each integration use case. Biexus manages API connections to both systems, maps and transforms data between their respective schemas, and orchestrates workflows that respond to events in either system.

The solution is designed to be extensible: additional systems, objects, or workflows can be added in future phases without re-architecting the core integration layer. The initial implementation focuses on one orchestration use case, with the remaining use cases phased in as agreed scope.

๐Ÿ”Œ
Connect
API integration with Salesforce and Sage
๐Ÿ”„
Map & Transform
Field-level mapping between system schemas
โš™๏ธ
Orchestrate
Event-driven workflows with business rules
05

Technical architecture

Proposed architecture โ€” subject to validation during technical discovery

The diagram below illustrates the proposed relationship between Salesforce, the Biexus platform, and Sage. Biexus sits between the two systems, managing API connections, data transformation, workflow orchestration, and operational monitoring.

โ˜๏ธ
Salesforce CRM
Cloud SaaS
Events / triggers
Updates / status
Biexus Integration & Orchestration Platform
๐Ÿ”Œ
API Connectors
Salesforce & Sage adapters
๐Ÿ”„
Data Mapping & Transformation
Field mapping, validation, rules
โš™๏ธ
Orchestration Workflows
Triggers, steps, conditions, branching
๐Ÿ“‹
Business Rule Engine
Duplicate prevention, logic
โš ๏ธ
Error Handling & Retry
Exceptions, recovery, alerts
๐Ÿ“Š
Logging & Monitoring
Audit trail, dashboards, alerts
Create / query
Responses / data
๐Ÿข
Sage ERP
Cloud or On-Premises (TBC)
๐Ÿ”’ Secure API Connectivity (HTTPS / TLS) โ€” Authentication & network access requirements to be confirmed during discovery
Confirmed data flow Proposed / pending validation
โš ๏ธ Architecture elements requiring validation
  • Sage product, version and hosting model (cloud or on-premises) โ€” to be confirmed during technical discovery.
  • If Sage is on-premises: secure connectivity, gateway requirements, network access, firewall rules and authentication must be assessed.
  • Sage API capabilities vary by product and hosting model โ€” not all Sage products offer identical API access.
  • Biexus deployment model, hosting infrastructure and security certifications โ€” to be confirmed during technical discovery.
06

Integration use cases and data flows

Proposed scope โ€” pending discovery and confirmation

A. Customer accounts and contacts

Keep customer account and contact information consistent between Salesforce and Sage. Sage is expected to remain the master for account numbers and credit terms. Biexus would synchronise account and contact records in both directions, with field-level ownership rules to prevent conflicts.

Data elementProposed owner (system of record)Sync direction
Account name, billing addressSalesforce โ†’ SageOne-way (SF to Sage)
Account numberSage (master)One-way (Sage to SF)
Credit terms, credit limitSage (master)One-way (Sage to SF)
Contact name, email, phoneSalesforce โ†’ SageBi-directional
Payment status, outstanding balanceSage (master)One-way (Sage to SF)
โ„น๏ธ Duplicate prevention
Matching would be performed on a natural key (e.g. account number or external ID) to avoid creating duplicate records. New accounts created in Salesforce would be assigned a Sage account number on creation in Sage, which is then written back to Salesforce.

B. Products and price lists

Publish product and price-list information from Sage into Salesforce. Sage remains the master for product codes, descriptions and pricing. Biexus would map product fields from the Sage schema to the Salesforce product and price-book schema, validate required fields, and make the data available to sales users.

  • Product code, description and unit of measure mapped from Sage to Salesforce product fields.
  • Price-list items mapped to Salesforce price book entries with currency and unit price.
  • Validation ensures mandatory fields are present before records are created or updated.
  • Sync frequency to be agreed (scheduled or on-change, subject to Sage API capabilities).

C. Sales orders and invoices

When an opportunity is closed-won or a quote is approved in Salesforce, the integration may create a corresponding sales order or invoice in Sage, subject to confirmation of the business process.

  • Trigger: Opportunity stage changes to "Closed-Won" (or quote approval โ€” to be confirmed).
  • Validation: Required fields checked; customer must exist in Sage; product codes must match.
  • Data transfer: Opportunity line items mapped to Sage sales order lines with quantities and prices.
  • Response handling: Sage order number written back to Salesforce opportunity for reference.
  • Duplicate prevention: Biexus checks whether an order already exists for this opportunity before creating a new one.

D. Financial information returned to Salesforce

Return relevant financial information from Sage to Salesforce so sales teams can understand account standing and make better-informed decisions.

Financial data pointSourceBenefit to sales teams
Invoice informationSageVisibility into what has been invoiced and when
Payment statusSageIdentify paid, overdue or partially paid invoices
Outstanding balancesSageUnderstand current account exposure before new orders
Credit limitsSageCheck available credit before committing to new sales

E. Hosting and connectivity

โš ๏ธ Sage hosting model โ€” to be confirmed
The Sage product, version and hosting model must be confirmed during discovery. If Sage is hosted on-premises, the following must be assessed: secure connectivity (VPN, gateway or API proxy), network access requirements, firewall rules, authentication methods, and any applicable security controls. Do not assume that all Sage products or hosting models have identical API capabilities.
07

Data mapping and transformation approach

Data mapping defines how fields in the source system correspond to fields in the destination system. Biexus is designed to support field-level mapping with transformation functions where source and destination schemas differ.

๐Ÿ”—
Field mapping
Direct one-to-one mapping between source and destination fields
๐Ÿ”„
Transformation
Value conversion, formatting, concatenation or calculation between fields
โœ…
Validation
Required-field checks, type validation and format enforcement before transfer
๐Ÿ”‘
Key matching
Natural key or external ID matching to prevent duplicate records
๐Ÿ“ Scope basis
The implementation estimate is based on mapping 20 fields across the initial integration object. Additional fields, objects or complex transformations will be assessed and quoted separately.
08

Orchestration and business rules

Orchestration workflows define the sequence of steps that Biexus executes when a trigger event occurs. Each workflow can include conditional logic, branching, data lookups, and multi-step destination actions.

End-to-end example: Closed-won opportunity โ†’ Sales order in Sage

Trigger
Opportunity Closed-Won
Salesforce opportunity stage changes to Closed-Won, raising an event detected by Biexus.
โ†’
Fetch
Retrieve Source Data
Biexus fetches the opportunity, account and line-item details from Salesforce via API.
โ†’
Validate
Validation & Rules
Required fields checked; duplicate order detection; business rules applied (e.g. credit hold check).
โ†’
Map
Data Mapping & Transformation
Fields mapped from Salesforce schema to Sage sales order schema; values transformed as needed.
โ†’
Create
Create Sales Order in Sage
Biexus submits the mapped payload to the Sage API to create the sales order.
โ†’
Response
Handle Response
Sage returns success with order number, or an error. Biexus logs the result and updates Salesforce status.
โš ๏ธ Error path:If any step fails, Biexus logs the error, retries per configured policy, alerts the operations team, and marks the record for manual review โ€” without creating a duplicate transaction.

Business rule examples

  • Only create a Sage sales order if the Salesforce opportunity stage is "Closed-Won" and the account exists in Sage.
  • Check credit hold status before creating an order โ€” flag or hold if the account is over credit limit.
  • Prevent duplicate orders by checking whether a Sage order already references the Salesforce opportunity ID.
  • Write the Sage order number back to the Salesforce opportunity upon successful creation.
09

Security, error handling and monitoring

Secure handling of credentials and system access

  • API credentials for Salesforce and Sage are stored securely within the Biexus platform โ€” not hard-coded in workflows.
  • OAuth token management and refresh handled by the platform where supported by the target API.
  • Access to integration configurations and credentials restricted to authorised administrators.
  • Specific encryption standards, key management and security certifications โ€” to be confirmed during technical discovery.

Error handling and retry

  • Errors are caught, logged and classified (transient vs. permanent failure).
  • Transient failures (e.g. rate limits, temporary network issues) are retried automatically per a configurable retry policy.
  • Permanent failures (e.g. validation errors, missing required fields) are flagged for manual review without blocking subsequent records.
  • Failed transactions can be replayed after correction without creating duplicates.

Logging, monitoring and operational visibility

  • Every workflow execution is logged with timestamps, records processed, success/failure status and error details.
  • Execution dashboards provide visibility into run history, throughput and error rates.
  • Alerting can be configured to notify the operations team of failures or threshold breaches.
  • Audit trail supports troubleshooting and compliance reporting.

Supportability and future expansion

  • Workflows are configurable and can be modified without code changes to the core platform.
  • Additional systems, objects and workflows can be added in future phases.
  • Support ownership and service-level expectations โ€” to be confirmed during discovery.
10

Implementation methodology and estimated effort

Methodology

The implementation follows a structured approach: discovery and solution design, environment setup, data mapping and transformation build, orchestration flow development, error handling and monitoring configuration, and go-live support.

1
Discovery & Design
Confirm scope, validate APIs, define mappings
2
Platform Setup
Connect integrations, configure environment
3
Build
Map fields, build orchestration flow
4
Error & Monitor
Configure retries, alerts, dashboards
5
Go-Live
UAT, cutover, production activation

Estimated effort

Work packageEstimated hours
Project management, discovery and solution design
4
Integration environment and platform setup
โš ๏ธ Original estimate references "Aurevo" โ€” naming discrepancy to be clarified (see note below)
8
Data mapping and transformation โ€” 20 fields
10
Orchestration flow build โ€” one initial use case
12
Go-live
2
Error handling and monitoring
8
Total44
โš ๏ธ Naming discrepancy โ€” Aurevo vs Biexus
The supplied estimate references "Aurevo Integration environment and platform setup" for the 8-hour setup work package. This document is prepared for the Biexus platform. It is unclear whether "Aurevo" and "Biexus" refer to the same product or whether the estimate was prepared for a different platform. This naming discrepancy must be clarified before the estimate is accepted. We have not assumed they are the same product and have not altered the original scope.
๐Ÿ“ Estimate scope
  • These are indicative estimates โ€” the final scope must be validated during discovery.
  • The estimate includes one initial orchestration use case. Additional workflows, integration objects or materially expanded requirements must be assessed and quoted separately.
  • Recurring monthly platform credit or usage costs are not included in this implementation estimate โ€” see Exclusions.
11

Assumptions and exclusions

Assumptions

โ„น๏ธ These are assumptions โ€” not confirmed facts
  • Each system exposes a standard, licensed API and the relevant editions or subscriptions provide API access.
  • One integration object or flow is included per project, as defined in the agreed scope.
  • Historical data migration is excluded unless separately scoped and quoted.
  • Delivery is remote, with on-site workshops by agreement.
  • The required system access, API documentation, test environments and client subject-matter experts will be made available.

Exclusions

  • โœ• Monthly integration and orchestration platform credit or usage costs โ€” to be calculated once scope is confirmed.
  • โœ• Sage, Salesforce or other required software licences.
  • โœ• Configuration changes within Sage or Salesforce.
  • โœ• Non-standard or custom fields unless explicitly agreed.
  • โœ• Unlimited field mapping (scope basis: 20 fields).
  • โœ• Bulk historical data migration, data cleansing and report development.
  • โœ• Third-party consultant or vendor fees.
โš ๏ธ Ongoing platform usage
Ongoing monthly platform usage costs are not included in the 44-hour implementation estimate. These will be calculated based on confirmed transaction volumes and platform consumption once the scope is finalised.
12

Discovery questions and outstanding decisions

Structured checklist to be completed before final design and quotation

The following questions must be answered during technical discovery. Items marked "Critical"must be resolved before the final design and quotation can be approved.

System Identification

Critical
  • โ–กExact Sage product, edition and version (e.g. Sage 50, Sage 200, Sage Intacct, Sage X3)
  • โ–กSage hosting model: cloud (SaaS) or on-premises
  • โ–กSalesforce edition (e.g. Professional, Enterprise, Unlimited) and API access level

API & Connectivity

Critical
  • โ–กAvailable API documentation for both Sage and Salesforce
  • โ–กAPI credentials, keys, or OAuth app registration details
  • โ–กIf Sage is on-premises: network access, firewall rules, gateway/VPN requirements
  • โ–กAuthentication method supported by the Sage API (OAuth, API key, basic auth, session)

Data Ownership & Synchronisation

Critical
  • โ–กSource-of-truth ownership for each entity and field (Salesforce vs Sage)
  • โ–กRequired synchronisation frequency (real-time, near-real-time, batch, scheduled)
  • โ–กSynchronisation direction per entity (one-way or two-way)

Volumes & Scope

Critical
  • โ–กExpected transaction volumes (records per day / per hour)
  • โ–กRequired initial use case and full transaction lifecycle
  • โ–กNumber of fields to be mapped per entity (estimate scope basis: 20 fields)

Validation & Data Quality

Important
  • โ–กValidation rules and mandatory field requirements per entity
  • โ–กDuplicate prevention strategy (natural keys, external IDs, matching rules)
  • โ–กData cleansing requirements for existing records

Error Handling & Operations

Important
  • โ–กError handling, retry and escalation policies
  • โ–กMonitoring, support ownership and service-level expectations
  • โ–กAlerting preferences (email, dashboard, notification channels)

Security & Compliance

Important
  • โ–กSecurity, authentication and encryption requirements
  • โ–กData residency or compliance constraints (e.g. POPIA, GDPR)
  • โ–กAudit logging and access control requirements

Testing & Acceptance

Important
  • โ–กAvailable test / sandbox environments for both systems
  • โ–กUser acceptance testing (UAT) process and acceptance criteria
  • โ–กGo-live cutover plan and rollback strategy

Cost & Consumption

Critical
  • โ–กEstimated platform consumption and recurring monthly usage costs
  • โ–กCredit / usage model and expected volume-based cost
โš ๏ธ Most important questions to resolve first
  1. Exact Sage product, edition, version and hosting model (cloud or on-premises).
  2. API availability and documentation for both Sage and Salesforce.
  3. Source-of-truth ownership for each entity and field.
  4. Estimated transaction volumes and required sync frequency.
  5. Estimated platform consumption and recurring monthly costs.
13

Next steps

1
Schedule technical discovery session
Review this document with the client's IT and business stakeholders to confirm Sage and Salesforce environments, API access and integration scope.
2
Complete discovery checklist
Answer the critical questions in Section 12 to validate the proposed architecture and refine the scope.
3
Clarify Aurevo / Biexus naming
Confirm whether the supplied estimate's "Aurevo" reference and the Biexus platform are the same product, or whether the estimate needs to be revised.
4
Finalise design and quotation
Based on discovery outcomes, confirm the integration objects, field mappings, orchestration flows and provide a finalised quotation including recurring platform costs.
5
Commence implementation
Upon approval, proceed with the 44-hour implementation covering one initial orchestration use case.

Biexus Integration & Orchestration Platform

Technical Solution Document ยท Prepared by Marco van Biljoen ยท MLT-Consulting

This document presents a proposed solution and is subject to technical discovery and validation. All estimates, assumptions and capabilities are indicative until confirmed in writing.