Platform Integration

Overview

The Ordering Portal integrates with multiple external services and internal platform components to deliver a connected, data-rich experience. From address validation through spatial mapping to utility lookups, these integrations ensure that projects are created with accurate data and that FTS users have the contextual information they need to process orders efficiently.

ArcGIS Address Validation

Address validation is powered by the ArcGIS API, providing accurate geocoding and address lookup:

• Address search - Customers search for their property address using the integrated ArcGIS geocoding service
• Address confirmation - The "Confirm Address" step in the project creation workflow ensures the correct property is associated before any services are selected
• Validation accuracy - Addresses are validated against the ArcGIS database to ensure consistency across all orders and projects
• SPI number lookup - Users can create orders by entering an SPI (Standard Parcel Identifier) number, with the system retrieving all associated data trees and map overlays
• Location search prioritisation - The system prioritises the project file address over the property address for location search results

MapShare VIC Integration

The MapShare VIC integration provides spatial mapping capabilities for Victorian properties:

• Map display - Property locations are displayed on interactive maps within the project view
• Parcel geometry - Parcel geometry extraction prioritises geocode data over centroid coordinates for accuracy
• Spatial data - The integration provides spatial coordinate data used by downstream services such as Water Authority lookups
• Internal testing phase - The MapShare VIC integration underwent internal testing and iterative refinement before production deployment

Map Interface

The map interface within the Ordering Portal has been refined for usability:

• Size optimisation - Map display size was reduced by 15-20% to balance spatial context with other content on the page
• Static view - The map displays in a static view mode optimised for project context rather than interactive exploration
• Error handling - The map interface includes handling for scenarios where map data is unavailable
• Responsive layout - Map sizing adapts appropriately within the overall page layout

Water Authority API

The Water Authority integration automates utility lookups for projects:

• Spatial coordinate resolution - Water authority is resolved based on the spatial coordinates of the project property using ArcGIS MapServer queries
• Automatic lookup - When a project is created, the system automatically queries the Water Authority API to determine the relevant authority for the property's location
• Admin autofill - Water authority information is automatically populated in the admin project view
• Project view display - Water authority details are shown on the project view page, with configurable visibility settings
• API source configuration - The Water Authority API source is configured at the platform level for consistent data retrieval

Separate Server Infrastructure

The Ordering Portal operates on dedicated server infrastructure:

• Independent deployment - The ordering platform runs on separate server infrastructure from the main FTS Platform, ensuring performance isolation
• Platform separation - The architectural separation allows independent scaling, deployment, and maintenance of the ordering system
• Shared authentication - Despite the infrastructure separation, authentication is shared through Auth0 SSO, providing a seamless user experience

Customer Portal Integration

The Ordering Portal integrates with the existing Customer Portal:

• Sidebar navigation - The Ordering Portal appears as a navigation item in the Customer Portal sidebar when enabled for the customer's company
• SSO authentication - Customers are automatically authenticated when navigating from the Customer Portal to the Ordering Portal
• Coexistence - Both portals operate simultaneously, with the Customer Portal continuing to serve its existing functions while the Ordering Portal handles order placement

Admin Portal Integration

The Ordering Portal's administrative functions integrate with the existing Admin Portal:

• Company management - Ordering Portal access is managed through the existing company management interface in the Admin Portal
• Service configuration - Services, pricing, and document requirements are configured through the Admin Portal's service management tools
• User group management - User group and division configurations flow from the Admin Portal into the Ordering Portal

Reporting Tool Integration

The platform integrates with FTS's reporting tools:

• Return URL handling - The reporting tool return URL is managed to ensure seamless navigation between the ordering platform and reporting interfaces
• Customer report access - Customer report access settings are respected across the integrated platforms
• Null status handling - The integration handles null status categories gracefully for reporting consistency

MYOB Integration Readiness

The platform is prepared for future financial system integration:

• Customer sync discussion - MYOB integration for customer data synchronisation has been scoped and discussed as part of the platform roadmap
• Invoice data structure - The invoicing system is structured to support export and synchronisation with external financial systems

Project Lifecycle Integration

The Ordering Portal integrates with the broader project management lifecycle:

• Active/Inactive projects - Orders are only available for active projects, respecting the project lifecycle state
• Estate-level coordination - The system ensures facade, house type, and property data consistency across the project lifecycle
• Pre-construction gateways - Orders such as Protection Works and Planning Permits act as gatekeepers before site activation, enforcing project lifecycle rules
• Core milestone synchronisation - Project milestones are synchronised across the ordering and platform systems for consistent lifecycle tracking