Supergood | Astea Alliance API
Programmatically access Astea Alliance field service data, scheduling, contracts, and inventory with a stable REST API. Supergood builds and operates production-grade, unofficial Astea Alliance integrations so your team can automate field and back-office workflows without heavy custom engineering.
Plain English: Astea Alliance is field service management software used by service organizations to run the entire service lifecycle—capturing service requests, managing contracts and entitlements, dispatching technicians, tracking parts and inventory, and invoicing for work performed. An unofficial API lets you pull customers, assets, work orders, technician schedules, parts consumption, and invoices—and push new work orders, assignments, time/parts usage, and status updates back into Alliance.
For a tech company integrating with Astea Alliance, this means you can ingest real-time work orders and technician activity to power dashboards, automate dispatch from your platform, sync parts and time to your ERP, or enrich your product with asset histories and warranty coverage. You can also create work orders from IoT alerts, check entitlements before dispatch, push parts/labor consumption from your mobile app, and keep accounting, CRM, and analytics in lockstep with what’s happening in the field.
What is Astea Alliance?
Astea Alliance (https://www.astea.com/) is a service lifecycle management platform for field service operations. Teams use Alliance to manage customers and contracts, create and schedule work orders, dispatch technicians, track installed assets and warranties, control parts and inventory, capture time and expenses, and generate invoices.
Core product areas include:
- Customer & Contract Management (accounts, service agreements, SLAs, entitlements)
- Work Orders & Dispatch (service requests, scheduling, route optimization, status tracking)
- Mobile Field Service (technician app for checklists, photos, signatures, offline)
- Inventory & Logistics (parts, warehouses, vans, serial/lot tracking, RMAs/depot repair)
- Installed Base & Warranty (assets/equipment, coverage, service history)
- Billing & Invoicing (time and materials, fixed-price, contract billing)
- Reporting & Analytics (KPIs, SLA performance, cost and margin)
Common data entities:
- Customers, Sites, and Contacts
- Assets/Installed Base and Locations
- Service Requests and Work Orders (activities, tasks, status, SLA windows)
- Technicians, Crews, and Calendars
- Schedules, Appointments, and Travel
- Contracts, SLAs, Warranties, and Entitlements
- Parts, Inventory, Warehouses, Vans, RMAs/Returns
- Time & Expense, Checklists, Photos, and Signatures
- Invoices and Payments
The Astea Alliance Integration Challenge
Field service teams rely on Alliance daily, but turning portal-driven processes into API-driven automation is non-trivial:
- Module-specific UX and entitlements: Contracts, dispatch, mobile, inventory, and billing each have distinct data models and permissions
- Enterprise security: SSO/MFA and role-based access make headless automation complex
- Portal-first features: Data is spread across tabs (e.g., work order header vs. activities, parts, time) with cross-module dependencies
- SLA and entitlement rigor: Contract coverage, warranty rules, and approval workflows must be enforced programmatically
- Mixed environments: Some deployments are hosted, others are on-prem with unique authentication and network constraints
How Supergood Creates Astea Alliance APIs
Supergood reverse-engineers authenticated browser flows and network interactions to deliver a resilient API endpoint layer for your Alliance tenant.
- Handles username/password, SSO/OAuth, and MFA (SMS, email, TOTP) securely
- Maintains session continuity with automated refresh and change detection
- Normalizes responses so you can integrate once and rely on consistent objects across modules
- Aligns with customer entitlements and role-based permissions to ensure compliant access
Use Cases
Customer, Site, and Asset Sync
- Mirror customers, sites, and installed assets into your internal systems
- Normalize asset identifiers and locations for analytics and IoT correlation
- Keep contract coverage and warranty dates up to date for downstream workflows
Work Order Automation
- Create work orders from IoT alerts or customer portal submissions
- Attach checklists, photos, and notes; set priority and SLA windows
- Update statuses programmatically (e.g., scheduled, en route, on site, completed)
Dispatch and Mobile Updates
- Assign technicians and schedule appointments with travel and route metadata
- Track arrival/finish times, capture signatures, and upload artifacts
- Trigger alerts when SLA thresholds are at risk or parts are unavailable
Parts, Labor, and Billing Reconciliation
- Push parts/labor consumption from your mobile or ERP workflows
- Validate entitlements before billing; separate contract-covered vs. billable items n- Generate invoice-ready summaries and sync financials to ERP (e.g., NetSuite, SAP, Dynamics 365)
Available Endpoints
Authentication
POST /sessions: Establish a session using credentials. Supergood manages MFA (SMS, email, TOTP) and SSO/OAuth when enabled. Returns a short-lived auth token maintained by the platform.
curl --request POST \
--url https://api.supergood.ai/integrations/<integration_id>/sessions \
--header 'Authorization: Basic <Base64 encoded token>' \
--header 'Content-Type: application/json' \
--data '{
"username": "[email protected]",
"password": "<password>",
"tenant": "global-services",
"mfa": { "type": "totp", "code": "123456" }
}'
Example response
{
"authToken": "eyJhbGciOi...",
"expiresIn": 3600,
"user": {
"id": "u_72c19f",
"name": "Service Dispatcher",
"entitlements": ["customers", "workOrders", "dispatch", "inventory"]
}
}
Work Orders
GET /work-orders: List work orders with filters and summary details.
Query parameters
- customerId: string
- status: open | scheduled | en_route | on_site | completed | cancelled
- slaDueFrom, slaDueTo: ISO 8601 timestamps
- updatedFrom, updatedTo: ISO 8601 timestamps
- page, pageSize: integers for pagination
Example response
{
"items": [
{
"workOrderId": "wo_1f92a0",
"number": "WO-2026-1045",
"status": "scheduled",
"priority": "high",
"customerId": "cust_88b32e",
"site": {
"siteId": "site_2201",
"address": {
"line1": "500 Eastside Blvd",
"city": "Atlanta",
"region": "GA",
"postalCode": "30312",
"country": "US"
}
},
"asset": {
"assetId": "asset_9a01",
"serialNumber": "SN-44728A",
"model": "Chiller CX400"
},
"problemCode": "NO_COOL",
"description": "Chiller not cooling; alarms present",
"reportedAt": "2026-01-20T13:45:00Z",
"slaDueAt": "2026-01-21T17:00:00Z",
"appointmentWindow": {
"start": "2026-01-21T13:00:00Z",
"end": "2026-01-21T17:00:00Z"
},
"assignedTechnicianIds": ["tech_45af1d"],
"updatedAt": "2026-01-21T09:30:00Z"
}
],
"page": 1,
"pageSize": 50,
"total": 1
}
Dispatch Assignments
POST /work-orders/{workOrderId}/assignments: Assign a technician and set a planned appointment window.
curl --request POST \
--url https://api.supergood.ai/integrations/<integration_id>/work-orders/wo_1f92a0/assignments \
--header 'Authorization: Bearer <authToken>' \
--header 'Content-Type: application/json' \
--data '{
"technicianId": "tech_45af1d",
"scheduledStart": "2026-01-21T13:00:00Z",
"scheduledEnd": "2026-01-21T17:00:00Z",
"routeSequence": 3,
"notifyTechnician": true,
"note": "Urgent—SLA breach risk"
}'
Example response
{
"assignmentId": "asn_90e412",
"workOrderId": "wo_1f92a0",
"status": "scheduled",
"technicianId": "tech_45af1d",
"scheduledStart": "2026-01-21T13:00:00Z",
"scheduledEnd": "2026-01-21T17:00:00Z",
"createdAt": "2026-01-21T10:03:11Z"
}
Parts & Labor Consumption
POST /work-orders/{workOrderId}/consumptions: Record parts used and labor time entries for a work order.
curl --request POST \
--url https://api.supergood.ai/integrations/<integration_id>/work-orders/wo_1f92a0/consumptions \
--header 'Authorization: Bearer <authToken>' \
--header 'Content-Type: application/json' \
--data '{
"parts": [
{
"partNumber": "FILTER-XL",
"description": "XL Air Filter",
"quantity": 2,
"uom": "EA",
"warehouseId": "wh_01",
"bin": "A-14",
"serialNumbers": [],
"lotNumber": null
}
],
"labor": [
{
"technicianId": "tech_45af1d",
"laborType": "regular",
"hours": 3.5,
"startAt": "2026-01-21T14:00:00Z",
"endAt": "2026-01-21T17:30:00Z",
"notes": "Diagnostics and filter replacement"
}
],
"customerSignature": {
"name": "Dana Harris",
"signedAt": "2026-01-21T17:35:00Z",
"signatureToken": "upl_7fa223"
}
}'
Example response
{
"workOrderId": "wo_1f92a0",
"consumptionId": "cns_51af80",
"partsRecorded": 1,
"laborEntriesRecorded": 1,
"status": "pending_billing",
"createdAt": "2026-01-21T17:36:10Z"
}
Technical Specifications
- Authentication: Username/password with MFA (SMS, email, TOTP) and SSO/OAuth where enabled; supports service accounts or customer-managed credentials
- Response format: JSON with consistent resource schemas and pagination across modules
- Rate limits: Tuned for enterprise throughput while honoring customer entitlements and usage controls
- Session management: Automatic reauth and cookie/session rotation with health checks
- Data freshness: Near real-time retrieval of customers, assets, work orders, dispatch activity, and inventory movements
- Security: Encrypted transport, scoped tokens, and audit logging; respects Alliance role-based permissions and contract constraints
- Webhooks: Optional asynchronous delivery for long-running workflows (e.g., approval gates, return material processing)
Performance Characteristics
- Latency: Sub-second responses for list/detail queries under normal load
- Throughput: Designed for high-volume work order sync, scheduling updates, and parts/labor capture
- Reliability: Retry logic, backoff, and idempotency keys minimize duplicate actions
- Adaptation: Continuous monitoring for UI/API changes with rapid adapter updates across deployments
Getting Started
- Schedule Integration Assessment
Book a 30-minute session to confirm your modules, licensing, authentication model, and deployment specifics (hosted vs on-prem).
- Supergood Builds and Validates Your API
We deliver a hardened Astea Alliance adapter tailored to your workflows, data model, and entitlements.
- Deploy with Monitoring
Go live with continuous monitoring and automatic adjustments as Alliance evolves.
Frequently Asked Questions
Q: Which Astea Alliance modules can this integration cover?
Supergood supports workflows across commonly used modules such as Customers/Sites, Installed Base, Contracts & Entitlements, Work Orders & Dispatch, Mobile artifacts (photos, signatures), Inventory/Parts, and Billing, subject to your licensing and entitlements. We finalize scope during the integration assessment.
Q: How do you handle SSO/MFA and different deployment models?
We support username/password + MFA (SMS, email, TOTP) and can operate behind SSO/OAuth when enabled. For on-prem deployments, we coordinate secure network access and session management. Sessions are refreshed automatically with secure challenge handling.
Q: Can you validate contracts and entitlements before dispatch or billing?
Yes. We can surface contract coverage, warranties, and SLA terms alongside work orders and assets, ensuring only eligible work is dispatched and billed. We can flag covered items versus billable add-ons and enforce approval gates.
Q: Can you push technician time and parts to our ERP or accounting system?
Yes. We normalize parts and labor to match your ERP/accounting schema (e.g., SAP, NetSuite, Dynamics 365, QuickBooks) and deliver updates via webhooks or polling while complying with rate and permission constraints.
Q: Are attachments, photos, and signatures supported?
Yes. We support downloading artifacts and uploading attachments via signed uploads, with checksum validation and time-limited URLs. Signatures can be captured and stored with work order completion events.
Related Integrations
IFS Cloud FSM API - Programmatically access IFS field service data with Supergood
Ready to automate your Astea Alliance workflows?
Supergood can have your Astea Alliance integration live in days with no ongoing engineering maintenance.
