GALS API
GALS (Government Authorisations and Licensing System) is the MCA back-office platform that manages operator contracts, billing rules, undertakings, GR1/GR2 registrations, cycle invoicing, reconciliation, and reporting. This documentation describes the gals.service.backend HTTP API consumed by the BackOffice portal.
What this service does
Create and maintain operator contracts, run year-end rollover, and generate, post, and email GR1/GR2 registration forms.
Synchronize the Business Central item catalog, configure billing rules, and manage undertakings with billing periods.
Retrieve draft cycle invoices, post to Business Central, cancel emails, and download invoice or receipt files.
Run surplus, GR1 vs GR2, and row-and-postal reconciliation checks, then export operational reports.
Architecture at a glance
<pre><code class="language-mermaid">flowchart LR portal[BackOfficePortal] -->|Bearer JWT| api[GalsBackendApi] api --> postgres[(PostgreSQL)] api --> bc[BusinessCentral] api --> mita[MitaNotifications] api --> kv[AzureKeyVault]
| Layer | Projects | Responsibility |
|---|---|---|
| Transport / HTTP | Service | Controllers, auth, Swagger, health |
| Application logic | Logic | Handlers for contracts, billing, reconciliation |
| Persistence | Storage | EF Core repositories and SQL scripts |
| Contracts | Contracts, Transport | DTOs and serializers |
| Integration | Integrator | Business Central and notification clients |
Audience
These docs are for internal MCA engineers and operators. The published static site is behind Entra ID (oauth2-proxy). API calls themselves require a B2C / Entra access token and screen-level permissions.
Next steps
Base URLs, health checks, and local preview.
Bearer tokens, claims, and permission policies.
OpenAPI-generated endpoint documentation.
Static docs export and ACI deployment.