Skip to content
API Docs
Developer Portal

Topcon Suite
API Documentation

Complete API reference and integration guides for all Topcon Suite products. Choose a project below to explore the endpoints, or visit the guides for authentication and integration flows.

Projects

CRM

TopconCRM

CRM and commercial management API. Manage proposals, contracts, scheduling, visits, leads, and opportunities.

🔑 X-Api-Token
Explore API
Core

TopconTECH

Concrete technology integration API. Manage supplies, suppliers, batching plants, recipes, and material data.

🔑 Ocp-Apim-Subscription-Key
Explore API
Operations

TopconDispatch

Dispatch and logistics integration API. Synchronize scheduling, deliveries, load tickets, vehicles, contracts, and fiscal artifacts.

🔑 Ocp-Apim-Subscription-Key
Explore API

Authentication

Each Topcon Suite project uses a different authentication mechanism. Refer to the details below for the project you are integrating with.

TopconCRM
X-Api-Token

Pass your API token in the Authorization header as Bearer {your_api_key}. Tokens are issued by your system administrator.

TopconTECH
Ocp-Apim-Subscription-Key

Pass the Ocp-Apim-Subscription-Key header with your subscription key on every request.

TopconDispatch
Ocp-Apim-Subscription-Key

Pass the Ocp-Apim-Subscription-Key header with your subscription key on every request.


TopconCRM — API Key Authentication

TopconCRM uses a simple API key passed in the Authorization header.

HTTP
GET /api/your-endpoint HTTP/1.1
Host: your-topcon-crm-server.com
Authorization: Bearer YOUR_API_TOKEN
Content-Type: application/json
⚠️
Keep your API token secret. Never expose it in client-side code. Store it securely in environment variables or a secrets vault.

TopconTECH — Subscription Key

TopconTECH authenticates all requests via the Ocp-Apim-Subscription-Key header. Pass your subscription key on every request.

HTTP
GET /tech-hml/your-endpoint HTTP/1.1
Host: api.topconsuite.io
Ocp-Apim-Subscription-Key: YOUR_SUBSCRIPTION_KEY
Content-Type: application/json

TopconDispatch — Subscription Key

TopconDispatch authenticates all requests via the Ocp-Apim-Subscription-Key header. Pass your subscription key on every request.

HTTP
GET /dispatch/integrations/your-endpoint HTTP/1.1
Host: api.topconsuite.io
Ocp-Apim-Subscription-Key: YOUR_SUBSCRIPTION_KEY
Content-Type: application/json
ℹ️
The subscription key header is required on every request to the Dispatch API. Missing it will result in a 401 response.

Integration Flows

Visual diagrams showing how data flows between ERP systems, Topcon Suite products, plant automation, and external services. Click any diagram to expand it.

TopconDISPATCH — ERP Integration Mapping

Shows the complete data synchronization map between ERP, TopconDISPATCH, automation systems, and GPS trackers.

TopconDISPATCH — ERP Mapping (Passive APIs) Click to expand ↗
TopconDISPATCH ERP mapping
TopconDISPATCH — Full Integration (TECH + Dispatch + Tracker) Click to expand ↗
TopconDISPATCH full integration

TopconTECH — ERP Integration Mapping

Shows how core resources (plants, suppliers, supplies, recipes) flow between ERP and TopconTECH.

TopconTECH — ERP Integration Click to expand ↗
TopconTECH ERP integration

Combined Flows (TECH / CRM / DISPATCH)

Full integration flows showing how all Topcon Suite products work together with ERP, automation, and external systems.

TECH/CRM/DISPATCH (New) — Full Flow Click to expand ↗
Combined flow new
TECH/CRM/DISPATCH/BILLING — SAP Integration Click to expand ↗
SAP integration flow
TECH/CRM/DISPATCH Desktop — Integration Mapping Click to expand ↗
Desktop integration flow
TECH/CRM/DISPATCH/BILLING Desktop — Full Flow Click to expand ↗
Full desktop flow
Project
Loading API reference...