All integrations

ERP and manufacturing distribution

SYSPRO Field Sales Integration South Africa

Enterprise integration plan — managed SYSPRO adapter not released

SalesPro Hub can provide the tenant APIs, signed webhooks and managed Windows runtime needed for a custom SYSPRO field-sales connection, but a native managed SYSPRO adapter is not released. An Enterprise implementation must confirm the exact SYSPRO version, licensed e.net or other approved interface, company and operator access, business objects, mappings and reconciled sales-order workflow before support is promised.

Test the field workflow first

Support level: Enterprise integration plan — managed SYSPRO adapter not released. The workflow below separates shipped SalesPro Hub capabilities from connector work your implementation must provide.

What this solves

One operational hand-off, with explicit ownership

For a South African manufacturer or distributor, the likely operating pattern is a customer-hosted Windows connector close to SYSPRO. The connector can use an approved SYSPRO integration interface to exchange customer, stock-code, warehouse, availability and sales-order information while SalesPro Hub remains the field workflow. SYSPRO’s business-object layer is designed to apply product business logic to XML input and output, and the Sales Order Import transaction is a relevant candidate for order creation. Those are architecture inputs, not evidence that a SalesPro adapter exists: the selected objects, licences, logon context, parameters, warehouse rules, back-order policy and result reconciliation still have to be implemented and tested.

Available in SalesPro Hub today

  • SalesPro Hub customer, submitted-order, inventory, acknowledgement and status APIs for customer-operated middleware
  • Signed webhooks and cursor-safe polling patterns for reliable incremental hand-off
  • Enterprise managed Windows runtime with one-key enrolment, heartbeat, version and remote configuration control
  • Durable local operations, stable identities, bounded retry and dead-letter review in the common runtime
  • A documented mapping and acceptance plan for customer, stock-code, warehouse, order and back-order decisions
  • Support for a custom implementation partner to use licensed SYSPRO business objects without exposing a generic inbound command port

Custom work and limitations

  • No native or generally supported SYSPRO adapter is currently released.
  • SYSPRO e.net licensing, operator rights, company access, business-object availability and version compatibility must be confirmed with the buyer and SYSPRO partner.
  • Business-object XML, parameters, customer branches, stock codes, units, warehouses, pricing, tax, credit and back-order rules require implementation.
  • SYSPRO OData may support controlled queries, but transactional create and update work should use the vendor-supported business-logic path selected for the customer.
  • A middleware proof of concept is not a supported managed connector until restart, replay, mapping, failure, reconciliation, monitoring and upgrade tests pass.
  • Integrations are Enterprise-gated when SalesPro Hub operates the Windows runtime; Professional API users may build and run their own middleware.
Do not buy implementation work until the source of truth, idempotency key, failure owner and reconciliation process are written down.
SYSPRO Business Objects overview

SYSPRO integration evidence

Connect the operating records—not just the brand names

A useful SYSPRO connection needs stable identities, explicit ownership and a visible exception path. These are the SalesPro Hub records the implementation must map and reconcile.

Written and maintained by Paul · Updated 7 August 2026

Architecture showing a South African mobile field sales workflow passing through a secure Windows connector to SYSPRO business objects and warehouse systems

Choose the supported SYSPRO transaction boundary

A future managed adapter should keep hub traffic outbound and use only the licensed customer-approved SYSPRO interface for queries and transactions.

South African distribution specialists mapping customer branches stock codes customer part numbers units warehouses prices and sales order rules for SYSPRO

Resolve identity and ownership before code

Customer, branch, stock-code, unit, warehouse and pricing decisions form the data contract that a SYSPRO adapter would need to enforce.

SYSPRO sales order business object flow showing validation posting durable result capture and a quarantined invalid stock code exception

Apply business logic and preserve the result

Order posting should validate the complete transaction, retain one source identity and expose a rejected line without endlessly retrying a permanent error.

South African warehouse and sales operations team reviewing multi-warehouse availability allocation back orders and field order status for a SYSPRO integration

Make warehouse and back-order rules explicit

The pilot must reconcile requested, supplied and back-ordered quantities across every approved warehouse rather than treating order creation as the end state.

Dark enterprise monitoring console showing a planned SYSPRO connector heartbeat version configuration retries durable queue and one business exception

Design operations before go-live

Reachability, authentication, retry age, mapping failures, installed version and recovery ownership should be observable without routine RDP access.

South African finance ERP IT warehouse and sales leaders reconciling SYSPRO customer stock order back-order tax and exception test evidence

Bind support to reconciled evidence

A managed SYSPRO adapter should only be released for the tested version and business-object contract after commercial values and failure recovery reconcile.

Architecture and ownership

Design the SYSPRO operating contract before the data flow

The planned SYSPRO pattern places a managed Windows connector inside the customer network and uses the licensed vendor integration surface selected with the ERP partner. Query work may use an approved query interface, while order creation should pass through the SYSPRO business-logic contract chosen for the exact version, such as the relevant e.net business objects. XML input, parameters, output, warnings and errors become a versioned adapter contract. No native SYSPRO adapter is currently released.

SYSPRO normally owns the official customer, branch, stock-code, warehouse, sales-order, back-order and ERP fulfilment records.

SalesPro Hub owns the rep’s offline capture, visit context, mobile draft and authorised submitted field order before the hand-off.

The implementation must assign authority for customer changes, prices, discounts, tax, available stock and allocation by warehouse.

The SYSPRO operator, company and business-object parameter set are security and business-policy inputs, not merely technical credentials.

Security review boundary

Use a dedicated least-privilege SYSPRO operator and Windows service identity with access only to the approved company and business objects. Protect credentials as write-only managed secrets, restrict local SDK or interface access and record outbound hub destinations. Logs may retain source operation IDs, response classes and approved document references but should exclude passwords, full sensitive XML and unrelated ERP data. Review e.net licensing, partner ownership, audit retention, upgrades and local break-glass access.

Failure recovery

Decide what happens when the happy path stops

A useful SYSPRO integration is not defined by one successful demo. It is defined by what remains durable, what can be replayed safely, what must stop, who sees the exception and how both systems are reconciled.

Failure or conflictRequired response
SYSPRO logon or operator failureStop transaction work, preserve the durable queue and surface the exact company or permission boundary for an authorised owner.
Invalid customer, stock code or warehouseTreat the business-object rejection as a permanent mapping exception until master data is corrected.
Back-order or credit outcome differsCapture the vendor result explicitly and reconcile supplied, held and back-ordered quantities instead of reporting a generic success.
Lost response after transactionLook up the stable source reference or reconciliation record before repeating the same sales-order import.
Service, host or network restartResume the locally persisted operation under the same identity and apply bounded retry only to temporary failures.

Acceptance plan

Tests to run with the buyer’s real edition and workflow

A sandbox proves API syntax. Production readiness requires representative identities, accounting or CRM rules, failures and reconciliation. Record the result against the exact product edition and adapter release; do not transfer evidence from a different vendor version by assumption.

  • Prove licensed logon, company selection and least-privilege business-object access for the intended SYSPRO version.
  • Map customer and branch codes, customer part numbers, stock codes, units, warehouses, prices, tax, salesperson and order type.
  • Exercise the approved sales-order import with valid, invalid, credit-held, partially supplied and back-ordered lines.
  • Replay identical and conflicting source orders and lose a response after external commit.
  • Restart the SYSPRO service, connector and Windows host while work is pending.
  • Reconcile quantities, prices, discounts, VAT, order and back-order numbers, warnings, errors and exception ownership.

Delivery lifecycle

From SYSPRO discovery to a supportable steady state

Treat the connection as a small operational product with owners, release evidence and a lifecycle. These phases stop a promising prototype from becoming an invisible production dependency that only one developer understands.

  1. 1

    Discover the real workflow

    Name the exact SYSPRO product, edition, company or tenant, licensed interface and deployment. Follow one representative customer and order from field capture to its final external state. Record current manual checks, approval points, cut-off times, volumes and the people who resolve errors. Brand-level assumptions are not a technical scope.

  2. 2

    Write the data contract

    List required and optional fields, types, formats, allowed values and stable identities. Declare a source of truth for customers, outlets, products, prices, tax, stock, documents and status. Define create, update, deactivate and delete behaviour separately. Include the idempotency key, cursor or event identity and the external reference returned after a successful commit.

  3. 3

    Build the exception contract

    Classify authentication, rate-limit, connectivity, validation, mapping, conflict and external-service errors. Decide which faults retry, how often and with what backoff; which stop immediately; and where exhausted work becomes visible. Assign a named business or technical owner and define the evidence needed to replay, correct, reject or manually reconcile an operation.

  4. 4

    Prove a controlled pilot

    Use representative South African customers, addresses, SKUs, rand values, VAT rules, discounts, warehouses and approval cases. Include duplicates, missing mappings, offline or network loss, service restart, expired credentials and a lost response after external commit. Reconcile counts and commercial totals in both systems; a green API response alone is not acceptance.

  5. 5

    Release with a rollback plan

    Version the mapping, adapter and configuration together. Record the approved package, supported architectures, required runtime, database or API prerequisites and the previous known-good state. Start with a bounded customer or order cohort, monitor exceptions and keep a tested way to pause new work without deleting the durable queue or losing reconciliation evidence.

  6. 6

    Operate and review

    Monitor reachability, authentication, latency, retry and dead-letter trends, external rate limits, installed version and reconciliation differences. Rotate credentials and exercise recovery before an emergency. Review vendor API or SDK changes and the adapter support matrix before upgrades. Retire obsolete credentials, mappings and data under the agreed security and POPIA operating process.

South African procurement note: confirm the parties’ POPIA roles, purposes, access, retention, operator terms and incident process during procurement. Hosting and subprocessors should be confirmed from current contractual evidence. Product controls can support a lawful implementation, but an integration page cannot certify the buyer’s operating practices or replace legal and security review. Before expanding the pilot, agree measurable release criteria: the maximum acceptable age of a pending operation, expected daily reconciliation window, alert response owner, acceptable mapping-error rate, retry ceiling and the evidence required to close an incident. Keep deployment, configuration and mapping versions beside the reconciliation result so a later difference can be traced to the exact operating state. Review those criteria when order volume, product range, warehouses, tax treatment or the external vendor version changes. A technically healthy connector can still create the wrong commercial result if ownership or mapping assumptions have drifted. Keep the sign-off, evidence and named operational owners accessible for every later support and change review.

Decision-maker intent

Questions different buyers ask about SYSPRO

ERP and finance

Does SalesPro Hub already have a SYSPRO connector?

No. The site documents the intended Enterprise architecture and acceptance contract; the SYSPRO-specific adapter and licensed release evidence still need to be built.

Operations

Will stock and back orders remain accurate?

Only after warehouse scope, stock timing, allocation and back-order policy are explicit and the pilot reconciles requested, supplied and held quantities.

CTO, CIO and developers

Which SYSPRO API would the integration use?

Discovery selects the supported query and business-transaction surfaces for the exact version and licences. Transaction work should preserve SYSPRO business logic rather than writing around it.

IT support

Can the connector be monitored and recovered remotely?

The Enterprise runtime provides heartbeat, version, approved settings, retry and recovery controls. The named adapter remains unavailable until its own tests pass.

Professional includes scoped APIs and signed webhooks for custom, customer-operated middleware. A managed Windows connector, remote configuration, heartbeat/version monitoring and managed recovery require Enterprise—and only become available for this named system after its real adapter passes the published release boundary.

Buyer decision guide

Scope the SYSPRO connection before buying implementation

A good trial should prove the workflow with your data—not rely on a sales promise.

Strong fit when you need

  • Teams that have already proved the SalesPro Hub field workflow with real data.
  • Businesses able to assign an owner for mapping, credentials and exception handling.
  • Integrations built around stable customer, order or product identifiers.

Confirm during the trial

  • The exact SYSPRO product, edition and API access available to your account.
  • The system of record for customers, stock, tax, status and accounting documents.
  • Whether polling, signed webhooks or middleware best fits your network and support model.

Implementation flow

How the connection works

  1. 1

    Inventory the actual SYSPRO environment

    Record the version, deployment, company, licensed interfaces, e.net operator, business objects, warehouses, branches, stock rules and implementation-partner ownership.

  2. 2

    Select query and transaction contracts

    Choose the approved read paths for customers, stock and warehouse context and the business object for sales-order validation and import; document parameters and XML schemas.

  3. 3

    Map commercial identities and rules

    Align customer and branch codes, stock codes, units, warehouses, price and discount policy, tax, salesperson, order type and back-order behaviour.

  4. 4

    Build durable posting and reconciliation

    Persist one source operation identity, apply the vendor transaction logic, capture validation output and return the committed SYSPRO order reference to SalesPro Hub.

  5. 5

    Exercise failures and recovery

    Test logon failure, partial batches, unknown stock codes, warehouse constraints, credit holds, network loss, service restarts and a lost response after commit.

  6. 6

    Approve a representative Enterprise release

    Reconcile source and SYSPRO quantities, values, VAT, order numbers, back orders and exceptions, then bind support to the tested product and adapter versions.

Field mapping starting point

SalesPro Hub field/eventSYSPRO equivalentImplementation note
customer.external_idSYSPRO customer code and branchPreserve the approved immutable account identity and branch semantics.
items[].skuSYSPRO stock codeValidate alternate customer part numbers, units and discontinued codes explicitly.
order_numberCustomer purchase order or approved source referenceUse one stable source identity for lookup and duplicate prevention.
external_referenceSYSPRO sales-order numberWrite back only after the business object reports a reconcilable commit.
items[].warehouseSYSPRO warehouseDefine defaulting, split, transfer and invalid-warehouse behaviour.
items[].quantityOrder quantity and back-order quantityReconcile fulfil-now and back-order outcomes rather than only the requested amount.

SYSPRO integration questions

Does SalesPro Hub have a native SYSPRO integration?

No. SalesPro Hub has the API and managed-runtime foundations for an Enterprise project, but the SYSPRO-specific adapter, licensed environment and acceptance evidence are not released.

Can SalesPro Hub orders be imported into SYSPRO?

A custom implementation can map submitted field orders into the appropriate SYSPRO sales-order business-object workflow. It must be built and reconciled for the exact customer environment before automatic posting is enabled.

Would the integration use SYSPRO e.net or OData?

That is decided during discovery. SYSPRO business objects and e.net are relevant for product business logic and transactions, while OData may support approved query cases. Licensing, version and partner guidance determine the final contract.

Can the connector run inside the customer network?

That is the expected managed pattern. A Windows service initiates its hub connection outbound and accesses only the customer-approved SYSPRO interfaces locally.

How will duplicate SYSPRO orders be avoided?

The adapter must keep the SalesPro Hub order identity stable through retries, include the approved source reference in the SYSPRO transaction and reconcile an existing result before creating another order.

What should an ERP manager require before go-live?

Require an exact support matrix, licensed-interface proof, mapping catalogue, service identity, failure taxonomy, replay test, order and back-order reconciliation, monitoring owner, upgrade procedure and signed acceptance result.

Validate the field workflow before connecting accounting

Import real products and customers, capture a representative order, then scope the integration against evidence instead of assumptions.

Start the free trial