Installation Creation Service
Overview
The Installation Creation Service keeps newly added or changed SBN installations in sync with external account systems. On a fixed timer it looks for installations that have been flagged for processing, reads the customer, address, package, panel and monitoring details from SBN, and creates, updates, or terminates the matching account in the connected service. Once an installation is processed it is cleared from the queue, so each change is handled once and the SBN record is updated with the external account reference.
The service can drive two integrations. The Alarm.com integration creates and maintains the customer account — account number, address, contact details, package or service plan, panel type, time zone, and branch — and terminates the account when the installation is cancelled. The SIMS integration sends the account profile (premise information, contacts, zones, and monitoring options) to the SIMS interface for installations marked for SIMS.
Processing can be limited to a single dealer, and the service emails a designated address when an installation cannot be processed so the setup can be corrected and the record reprocessed. A working SBN data-server connection is required at start-up; if the connection cannot be established the service logs the reason and stops.
Service Manager
Instructions for installing and interacting with this service is found here.
Service Properties
Only properties specific to this service are listed here. Common service properties (SBN Server connection, Logging, SMTP) are found here.
Timer (In Seconds)
How often the service checks for installations waiting to be processed. The service waits this many seconds between cycles, then processes any installations flagged for creation, update, or termination.
Restrict by Deal_id
Limits processing to a single dealer. Enter a dealer id to process only that dealer's installations, or leave it blank to process installations for all dealers.
Web Service URL (Alarm.com)
The address of the Alarm.com web service that the service calls to create, update, and terminate customer accounts.
Web Service Username / Web Service Password (Alarm.com)
The default login the service uses to authenticate to the Alarm.com web service.
CID
The Alarm.com customer identifier used by the service when communicating with Alarm.com.
Alternate Login
An optional second Alarm.com login. When the installation's dealer matches the configured "When Installation Dealer Equals" value, the service authenticates with this alternate username, password, and template instead of the default login. Leave the dealer value blank to always use the default login.
Send Terminate Message
When enabled, terminating a customer also instructs Alarm.com to send the termination message to the panel. Leave it off to terminate the account without messaging the panel.
SIMS Base URL
The address of the SIMS interface the service posts account information to. Used only for installations flagged for SIMS.
SIMS Username / SIMS Password
The login the service uses to authenticate to the SIMS interface.