Reimaginate.Orchestrator.BusinessCentral 1.1.5

Reimaginate.Orchestrator.BusinessCentral

Business Central workflow actions for Orchestrator hosts.

Use this package when workflows need Business Central finance, purchasing, item, manufacturing, or custom API page operations. The package does not own OAuth flows, token storage, tenant resolution, or company selection state. Hosts provide those concerns through IBusinessCentralWorkflowConnectionProvider.

Registration

Register the action handlers in the customer host:

services.AddBusinessCentralWorkflowActions(configuration);

If the host uses a custom workflow action resolver, scan this package's action assembly:

using Reimaginate.Orchestrator.Abstractions;
using Reimaginate.Orchestrator.BusinessCentral.Actions;

[WorkflowActionResolver]
[ScanAssembly(typeof(BusinessCentralWorkflowActionsMarker))]
public partial class WorkflowActionResolver : IWorkflowActionResolver;

Register a host-owned connection provider:

services.AddSingleton<IBusinessCentralWorkflowConnectionProvider, CustomerBusinessCentralConnectionProvider>();

IBusinessCentralWorkflowConnectionProvider receives the workflow TenantKey and optional CompanyKey, then returns a fresh access token, environment URL, and resolved Business Central company ID. TenantKey is required on every action. CompanyKey is optional; when omitted, the host provider resolves the default company.

Actions

Generic/custom API actions:

• BusinessCentral.Get
• BusinessCentral.Search
• BusinessCentral.Post
• BusinessCentral.Patch
• BusinessCentral.Delete
• BusinessCentral.InvokeAction

Typed standard API actions:

• BusinessCentral.SearchVendors
• BusinessCentral.GetVendor
• BusinessCentral.CreateVendor
• BusinessCentral.UpdateVendor
• BusinessCentral.SearchItems
• BusinessCentral.GetItem
• BusinessCentral.CreateItem
• BusinessCentral.UpdateItem
• BusinessCentral.SearchPurchaseOrders
• BusinessCentral.GetPurchaseOrder
• BusinessCentral.CreatePurchaseOrder
• BusinessCentral.UpdatePurchaseOrder
• BusinessCentral.DeletePurchaseOrder
• BusinessCentral.ReceiveAndInvoicePurchaseOrder
• BusinessCentral.SearchPurchaseInvoices
• BusinessCentral.GetPurchaseInvoice
• BusinessCentral.CreatePurchaseInvoice
• BusinessCentral.UpdatePurchaseInvoice
• BusinessCentral.DeletePurchaseInvoice
• BusinessCentral.PostPurchaseInvoice

Typed manufacturing/custom API page actions:

• BusinessCentral.SearchProductionOrders
• BusinessCentral.GetProductionOrder
• BusinessCentral.CreateProductionOrder
• BusinessCentral.UpdateProductionOrder
• BusinessCentral.SearchReleasedProductionOrders
• BusinessCentral.GetReleasedProductionOrder
• BusinessCentral.CreateReleasedProductionOrder
• BusinessCentral.UpdateReleasedProductionOrder
• BusinessCentral.SearchBoms
• BusinessCentral.GetBom
• BusinessCentral.CreateBom
• BusinessCentral.UpdateBom

All actions return Success and FailureReason plus action-specific result fields. Mutating actions require Confirm = true. Update, delete, post/process, and generic invoke operations also require an ETag; the action pack sends it as If-Match.

Custom Paths

Generic actions accept a full relative API path, for example:

relativePath: api/v2.0/companies({companyId})/vendors

The default HTTP client replaces {companyId}, {companyKey}, and {environmentName} from the resolved connection. Manufacturing actions use configured custom API page paths unless a workflow supplies relativePath directly:

{
  "Orchestrator": {
    "Actions": {
      "BusinessCentral": {
        "ProductionOrdersPath": "api/acme/manufacturing/v1.0/companies({companyId})/productionOrders",
        "ReleasedProductionOrdersPath": "api/acme/manufacturing/v1.0/companies({companyId})/releasedProductionOrders",
        "BomsPath": "api/acme/manufacturing/v1.0/companies({companyId})/boms"
      }
    }
  }
}

Examples

Search a vendor by Business Central vendor number, then create or update explicitly:

do:
  - findVendor:
      call: BusinessCentral.SearchVendors
      with:
        tenantKey: qpac-au
        number: V00010
        top: 1

  - createVendor:
      call: BusinessCentral.CreateVendor
      with:
        tenantKey: qpac-au
        confirm: true
        record:
          number: V00010
          displayName: Contoso Supplies
          email: accounts@contoso.example
          additionalFields:
            paymentTermsCode: 30D

  - updateVendor:
      call: BusinessCentral.UpdateVendor
      with:
        tenantKey: qpac-au
        id: ${findVendor.records[0].id}
        eTag: ${findVendor.records[0].@odata.etag}
        confirm: true
        record:
          displayName: Contoso Supplies Pty Ltd

Create and post a purchase invoice:

do:
  - createInvoice:
      call: BusinessCentral.CreatePurchaseInvoice
      with:
        tenantKey: qpac-au
        confirm: true
        record:
          vendorNumber: V00010
          invoiceDate: "2026-06-30T00:00:00Z"
          lines:
            - lineType: Item
              lineObjectNumber: ITEM-100
              quantity: 2
              unitCost: 42.50

  - postInvoice:
      call: BusinessCentral.PostPurchaseInvoice
      with:
        tenantKey: qpac-au
        id: ${createInvoice.id}
        eTag: ${createInvoice.eTag}
        confirm: true

Use a custom AL/API page path:

do:
  - createProductionOrder:
      call: BusinessCentral.CreateProductionOrder
      with:
        tenantKey: qpac-au
        relativePath: api/acme/manufacturing/v1.0/companies({companyId})/productionOrders
        confirm: true
        data:
          number: PROD-0001
          itemNumber: ITEM-100
        additionalFields:
          sourceType: Item

Hosts that expose these mutating actions from command-line workflows can replace IBusinessCentralActionWarningSink with a Spectre.Console-backed implementation to emit the same warning style as the current CLI.