Business Services Capability Overview

What Are Business Services?

Business Services are internal BizFirstGO platform microservices that expose operations via a standardized service registry. Rather than hardcoding HTTP URLs in node configurations, nodes call services by a logical serviceId and operationId. The service registry handles endpoint resolution, versioning, and health checks.

Platform Services Available

Call Pattern

{
  "nodeType": "BusinessServiceCall",
  "config": {
    "serviceId": "payroll-service",
    "operationId": "calculatePayslip",
    "inputMap": {
      "employeeId": "$output.fetchEmployee.employeeId",
      "periodStart": "$json.periodStart",
      "periodEnd": "$json.periodEnd"
    }
  }
}

// Output:
{
  "grossPay": 5000.00,
  "netPay": 3850.00,
  "deductions": { "tax": 900, "pension": 250 },
  "payslipId": "ps-2026-05"
}

Key Features

• Service discovery: Endpoint URLs resolved from registry — not hardcoded
• Auth injection: IBusinessServiceAuthProvider automatically adds auth headers
• Circuit breaker: 5 consecutive failures trip the breaker for 30 seconds
• Versioning: Services declare API versions; nodes can pin to a specific version