Skip to main content

ERP / MES Integration

Connect Haltless to your ERP and MES systems for bi-directional data synchronization. Supported systems: SAP, Microsoft Dynamics 365, Oracle.

Connections​

List connections​

GET /erp/connections

Auth: Bearer JWT (any role)

Create a connection​

POST /erp/connections

Auth: Bearer JWT (admin)

curl -X POST https://api.haltless.io/api/v1/erp/connections \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "SAP Production",
    "provider": "sap",
    "base_url": "https://sap.yourcompany.com",
    "auth_config": {
      "username": "haltless_integration",
      "password": "secure_password"
    },
    "sync_interval_minutes": 60,
    "is_active": true,
    "field_mappings": {
      "work_order_id": "AUFNR",
      "machine_id": "EQUNR"
    }
  }'

Providers: sap, dynamics, oracle

Constraints:

  • Max 10 connections per tenant
  • Sync interval: 5–1,440 minutes (24 hours)

Get a connection​

GET /erp/connections/{id}

Update / Delete a connection​

PATCH /erp/connections/{id} | DELETE /erp/connections/{id}

Test connection​

POST /erp/connections/{id}/test

Auth: Bearer JWT (admin)

Tests connectivity to the ERP system and returns diagnostics.

{
  "success": true,
  "latency_ms": 120,
  "message": "Successfully connected to SAP"
}

Sync operations​

Trigger a sync​

POST /erp/connections/{id}/sync

Auth: Bearer JWT (admin, operator)

{
  "direction": "outbound",
  "entity_type": "work_order",
  "entity_id": "WORK_ORDER_UUID"
}

Directions: inbound, outbound

Entity types:

EntityOutboundInbound
work_orderPush WOs to ERP-
production_dataPush OEE/output-
downtimePush downtime records-
machine-Pull machine master data

View sync logs​

GET /erp/connections/{id}/logs

All sync logs​

GET /erp/logs

Sync statuses: pending, in_progress, success, failed, skipped

Provider-specific notes​

SAP​

  • Uses OData API at /sap/opu/odata/sap
  • Supports SAP ECC and S/4HANA
  • Field mappings use SAP field names (e.g., AUFNR, EQUNR)

Microsoft Dynamics 365​

  • Uses Dynamics Web API v9.2
  • OAuth2 authentication with Azure AD

Oracle​

  • Uses Oracle REST API v1
  • Basic or OAuth2 authentication