GL - Ntropii

Tenant-side proxy for the GL connection state stored on tenant.config.gl in api-workspace. Reads the GL adapter’s connection state and projects it into a small response shape the ui-tenant header consumes for the GL status surface (logo + state dot + last-sync time). GL config is currently tenant-scoped, so all entities under a tenant share the same GL connection. The header surface lives in the entity layout but reflects tenant-level state.

GL connection status

GET /v1/gl/status

Returns the tenant’s GL connection (provider, service, status, last-sync). Returns { "connected": false } when the tenant has no GL configured — the header renders a placeholder. Response — connected

{
  "connected": true,
  "tenantId": "11111111-…",
  "provider": "unified",
  "service": "xero",
  "status": "ACTIVE",
  "lastSyncAt": "2026-05-08T10:14:00Z",
  "workspaceName": "Fundmin Demo (Xero)"
}

Response — not connected

{ "connected": false, "tenantId": "11111111-…" }

Field	Notes
`connected`	`true` only when `conn.status === "ACTIVE"`.
`provider`	The registered GL adapter that owns this connection.
`service`	Underlying provider service id (e.g. `"xero"`, `"quickbooks"`).
`status`	Raw connection status from `api-workspace`.
`lastSyncAt`	Latest of `metadata.updated_at` / `metadata.connected_at`, or `null`.
`workspaceName`	`metadata.name` (or `metadata.service` fallback).

Start a GL connect session

POST /v1/gl/connect/session

Starts a GL connect session for this tenant. The UI opens sessionUrl (typically in a popup / new tab); the GL adapter handles the OAuth dance with the underlying provider (Xero / QuickBooks / …) and fires a webhook back to api-workspace on success which flips tenant.config.gl.options.status to ACTIVE. The UI polls GET /gl/status after the user completes the connect flow. Body

{ "serviceId": "xero" }

Field	Required	Notes
`serviceId`	No	Pre-select a provider in the connect UI. Omit to let the user pick.

Response

{
  "sessionUrl": "https://gl-connect.example.com/session/…",
  "consumerId": "tenant-11111111-…"
}

Disconnect

DELETE /v1/gl

Disconnects the tenant’s GL connection. Idempotent — a no-op if there’s no connection. Response — 204 No Content.

Cross-links

General ledgers (SDK)

ntro.capabilities.gl — the Python surface workflows use to post journals + bills against the connected GL.

Tenant architecture

Where the GL connection sits in the cell topology.

Get Started

Tooling

Building workflows

Ntro SDK

API Reference

Deploy & Run

GL

GL connection status

Start a GL connect session

Disconnect

Cross-links

General ledgers (SDK)

Tenant architecture

​GL connection status

​Start a GL connect session

​Disconnect

​Cross-links

General ledgers (SDK)

Tenant architecture

GL connection status

Start a GL connect session

Disconnect

Cross-links