FORGE
FORGE
Breadcrumbs

Registration

Registration controls the active company and business unit's branding, environment information, product features, and integration credentials.

Before you begin: Select the correct company and business unit, and make sure your role can maintain Settings. Obtain the host key issued during provisioning and any credentials for the integrations you plan to enable. Secret values can be shown or hidden while you work.

Open Registration

In the web application, go to Settings > Registration. The page loads the saved registration for the active company and business unit.

Access

Provide the host key issued during provisioning.

  • Host Key (Required): Enter the host key issued during provisioning. Registration cannot be saved without it.

Company

Branding values used across FORGE.

  • Company Name (Optional): Enter the customer-facing company name used for branding across Service and Job Cost. If omitted, product surfaces can fall back to WennSoft.

  • Default Time Zone (Optional): Choose the time zone used for automatic appointment scheduling. Select the zone that represents this business unit's normal operating location.

  • Address 1 (Required): Enter the primary street address. Save remains disabled until this and the other required address fields are complete.

  • Address 2 (Optional): Enter a suite, unit, building, or other secondary address information.

  • City (Required): Enter the city for the company address.

  • State/Province (Required): Enter the state, province, or corresponding regional value.

  • Postal Code (Required): Enter the ZIP or postal code for the company address.

  • Country (Optional): Enter a country name or ISO alpha-3 code. When saved, the value is standardized to its two-letter ISO code.

  • Company Logo (Optional): Upload a PNG, JPG, SVG, or other recognized image up to 512 KB. Preview the image, or use Remove to clear it before saving.

Older addresses: If Address needs review appears, use the read-only Original address text as a reference and re-enter the address in the structured fields. The legacy text is not copied automatically, and Save stays disabled until Address 1, City, State/Province, and Postal Code are complete.

Environment

Complete the following fields:

  • Environment Name (Required): Enter a friendly name that administrators can recognize in diagnostics, such as Contoso Production.

  • Environment Type (Optional): Enter a short environment category such as prod, test, or dev when it helps distinguish deployments.

WennSoft Service Features

Complete the following fields:

  • Enable WennSoft Service (Optional): Turn on Service capabilities such as dispatching and equipment. Turning it off also turns off Maintenance Contracts, Mobile, and AI Enhancements for the tenant.

  • Maintenance Contracts (Optional): Enable maintenance-contract features. This choice is available only while Enable WennSoft Service is on.

  • Mobile (Optional): Enable FORGE Mobile. This choice is available only while Enable WennSoft Service is on; when both are enabled, Open FORGE Mobile opens the environment-matched mobile app in a new tab.

AI Enhancements

Configure endpoints and credentials for WennSoft AI features. This section is available if WennSoft Service is enabled in the previous section.

  • Enable AI Enhancements (Optional): Enable WennSoft AI features. Enable WennSoft Service must be on before this option and its connection fields are available.

  • AI Endpoint (Required): Enter the Azure OpenAI endpoint used for chat completions and AI summaries.

  • AI Embedding Endpoint (Optional): Enter a separate endpoint only when embedding generation should use an override; otherwise leave it blank to use the configured runtime behavior.

  • AI API Key (Required): Enter the Azure OpenAI API key for this tenant. Use Show only when you need to verify the value.

WennSoft Job Cost Features

  • Enable WennSoft Job Cost (Optional): Turn on Job Cost capabilities. Additional Job Cost options appear elsewhere as they become available.

Cloud Attachments

Cloud Attachments stores file content in Azure Storage. A business unit must be active before this feature can be enabled.

Complete the following fields:

  • Enable Cloud Attachments (Optional): Turn on Azure Storage file offloading for this business unit. Turning it off removes the saved storage settings on the next save.

  • Storage Connection String (Required): Enter the Azure Storage connection string supplied by your storage administrator.

  • Storage Key (Required): Enter the storage access key.

  • Container Name (Required): Enter the Azure Blob container used for attachments.

 CORS prerequisite: On the Azure Storage account, add https://forge.wennsoft.cloud under Resource sharing (CORS). Allow DELETE, GET, POST, OPTIONS, and PUT; set both allowed and exposed headers to *. Without this configuration, browser uploads and downloads can fail with CORS errors.

Business Central Integration

Complete the following fields:

  • Enable Business Central Integration (Optional): Turn on Business Central-backed functionality. Turning it off removes the saved Business Central connection values on the next save.

  • BC Client ID (Required): Enter the application registration's client ID.

  • BC Client Secret (Required): Enter the application registration's client secret. Use Show only when you need to verify it.

  • BC Company ID (Required): Enter the Business Central company identifier used for tenant data.

  • BC Tenant ID (Required): Enter the Microsoft Entra tenant GUID or tenant domain, such as contoso.onmicrosoft.com.

  • BC Environment (Required): Enter the Business Central environment name, such as Sandbox or Production.

Telematics (Azuga)

Store Azuga credentials used for telematics integration, if used.

Complete the following fields:

  • Use Telematics (Azuga) (Optional): Turn on Azuga integration so WennSoft can retrieve vehicle and location data. Turning it off removes the saved Azuga credentials on the next save.

  • Azuga User Name (Required): Enter the Azuga account user name, commonly an email address.

  • Azuga Password (Required): Enter the Azuga account password. Use Show only when you need to verify it.

  • Azuga Client ID (Required): Enter the client identifier assigned by Azuga.

Greenshades Payroll

Store Greenshades OAuth credentials, if used, to enable direct payroll exports.

Complete the following fields:

  • Use Greenshades Payroll (Optional): Turn on direct payroll exports and related Greenshades features. Turning it off removes the saved OAuth settings on the next save.

  • Greenshades Client ID (Required): Enter the OAuth client ID supplied by Greenshades.

  • Greenshades Client Secret (Required): Enter the OAuth client secret. Use Show only when you need to verify it.

  • Greenshades API Scope (Required): Enter the space-delimited scope string supplied by Greenshades, for example Greenshades.Payroll Greenshades.Employees.

  • Greenshades Workspace ID (Required): Enter the positive whole-number workspace identifier assigned by Greenshades; zero and negative values are rejected.

Review & Save

Review the selections, then select Save. A Registration saved confirmation appears and the page reloads the stored values. Use Refresh to discard unsaved edits and reload the current registration.

Result: Feature availability and branding update for the active company and business unit. Open Swagger in Customer API Documentation to launch the authenticated, read-only customer integration contract in a new tab.