# ServiceNow Integration Approach

**Status:** Recommended Pattern  
**Date:** 2026-07-07

## Overview

TallyFlow should integrate with ServiceNow through **TallyFlow Core** rather than directly from TallyFlow Assets (Mobile) or other components. Core acts as the integration hub and single source of truth for field operations data.

## Recommended Architecture

```mermaid
flowchart LR
    A[TallyFlow Assets Mobile] -->|REST / WebSocket| B[TallyFlow Core]
    C[TallyFlow Print] -->|REST| B
    D[TallyFlow Capture] -->|REST| B
    E[TallyFlow IoT] -->|REST / MQTT| B
    B -->|REST / Integration Hub| F[ServiceNow]
    F -->|REST| B
```

**Core Principle:** All external systems, including ServiceNow, connect to TallyFlow Core.

## Data Flow Directions

| Direction                  | Typical Data                          | Trigger                          | Recommended Method                  |
|---------------------------|---------------------------------------|----------------------------------|-------------------------------------|
| **ServiceNow → TallyFlow** | Asset master data, locations, status  | Scheduled or event-driven        | ServiceNow Integration Hub → Core REST |
| **TallyFlow → ServiceNow** | Real-time location, RFID scans, condition updates | Mobile scan, IoT event, zone change | Core → ServiceNow REST / Flow Designer |
| **Bidirectional**          | Asset status synchronization          | On change or scheduled           | Core as middleware                  |

## Key Integration Points

### 1. Asset Master Data
- ServiceNow remains the system of record for asset metadata.
- TallyFlow Core receives updates (new assets, location changes, status).
- TallyFlow enriches ServiceNow records with RFID tag data, real-time location, and movement history.

### 2. Field Operations Data
- TallyFlow Assets (Mobile) captures RFID scans, photos, zone movements, and condition data.
- This data is pushed to ServiceNow for visibility in Asset Management, Work Orders, or CMDB.

### 3. Real-time Location & Condition
- IoT and mobile events flow through Core and are published to ServiceNow (via REST or Integration Hub).

## Authentication & Security

- Use **OAuth 2.0** or **ServiceNow Integration Hub** credentials from Core.
- Core should manage token refresh and retry logic.
- Avoid embedding ServiceNow credentials in the mobile app.

## Benefits of Routing Through Core

- Maintains TallyFlow’s offline-first capabilities.
- Ensures consistent data model and audit trail.
- Simplifies future integrations (ERP, WMS, etc.).
- Allows TallyFlow to act as a specialized asset tracking layer on top of ServiceNow.

## Next Steps (Typical Engagement)

1. Define asset data model mapping between ServiceNow and TallyFlow.
2. Identify events that should trigger synchronization.
3. Build or configure a lightweight connector in TallyFlow Core.
4. Use ServiceNow Integration Hub or REST Message for the ServiceNow side.
5. Test bidirectional sync and conflict resolution rules.

---

**Owner:** TallyFlow Product Team  
**Related Documents:** [[TallyFlow Architecture]]