#GoFile Connect-API

Was die Connect-API ist

Ein Compliance-Gateway für die britische Steuererklärung: Ihre Software ruft einen Endpunkt mit einem Kunden und dessen Zahlen auf, und # GoFile kümmert sich um alles zwischen diesem Aufruf und dem Eingang beim HMRC .

Making Tax Digital ist keine schwer aufzurufende API, sondern eine schwer aufzurufende API. eigen. Erkennung, OAuth-Berechtigungen, die nach 18 Monaten ablaufen, Betrugspräventions-Header, die das tatsächliche Ursprungsgerät beschreiben müssen, Verpflichtungsabgleich, Periodenschlüssel, die Sie niemals erfinden dürfen, Übermittlungs-Idempotenz und ein Prüfprotokoll, das auch Jahre später noch Bestand hat – das ist die Arbeit, und sie hört nie auf.

Die Connect API stellt diese Arbeit hinter einer kleinen REST-Schnittstelle dar und wird von ihr gewartet. Version 1 umfasst Mehrwertsteuer: Überprüfung der Berechtigung eines Kunden, Erfassung seiner vollständigen Umsatzsteuerposition, Einreichung einer Umsatzsteuererklärung und Nachverfolgung bis zum Erhalt einer Quittung.

Für wen es gedacht ist

Die API ist für ein Agentenmodell konzipiert: Ihr Partnerunternehmen verbindet seine HMRC Agenten-Servicekonto Eine einzige Autorisierung ist erforderlich, und diese eine Autorisierung gilt für alle Mandanten, für die das Unternehmen tätig werden darf.

So funktioniert es

Jede Anfrage ist ein signierter REST-Aufruf. Alles, was rechtlich gesehen die Interaktion eines Menschen erfordert, findet auf einer von uns gehosteten Seite statt.

GET /api/v1/vat/193054661/status

{
  "vat_number": "193054661",
  "mode": "live",
  "obligations": {
    "open": [
      { "period": { "start": "2026-04-01",
                    "end":   "2026-06-30" },
        "due": "2026-08-07",
        "overdue": false }
    ],
    "fulfilled": [ /* filed periods + figures */ ]
  }
}

{
  "external_client_id": "CLIENT-91827",
  "client_name": "Acme Trading Ltd",
  "vat_number": "193054661",
  "return": {
    "vat_due_sales": "12500.00",
    "total_vat_due": "12500.00",
    "net_vat_due":   "8300.00"
    /* ...nine boxes in total */
  }
}

{
  "id": "vfs_...",
  "status": "submitted",
  "receipt": {
    "gofile_reference": "GF-VAT-123",
    "form_bundle": "258868935084"
  }
}

Die gehostete Genehmigung – und warum sie wichtig ist

HMRC möchte nicht einfach nur eine Steuererklärung; sie möchte sichergehen, dass diese von einer realen Person mit einem realen Gerät stammt und dass ein Mensch die Verantwortung für die Erklärung übernommen hat. Genau dafür sind die Header zur Betrugsprävention da, und Fehler in diesen Headern stellen ein Compliance-Problem dar, keinen Softwarefehler.

Die Connect API fordert Ihre Software daher niemals auf, Daten zu fälschen. Wenn Sie ein Dokument einreichen, geben wir eine URL zu einer Seite zurück. wir beherbergenAuf dieser Seite meldet sich die autorisierte Person per Zwei-Faktor-Authentifizierung an, ihr Gerät wird erfasst, die Steuererklärung wird vollständig angezeigt und sie bestätigt die Angaben. Erst dann kontaktieren wir HMRC – mit den von diesem Gerät erstellten Headern, die zusammen mit der Steuererklärung als Beweismittel gesichert werden.

Die Seite führt Ihren Mandanten auch durch die einmalige Verbindung mit HMRC . Wenn eine Kanzlei zum ersten Mal eine Steuererklärung einreicht, autorisiert sie dort ihr Agentenkonto und wird direkt zur Einreichung weitergeleitet.

Was Sie nicht bauen müssen

Sie werden nie nach einem Punkt-Schlüssel oder einem Punkt gefragt. finalised flag — Die API lehnt sie kategorisch ab, da es in unserer Verantwortung liegt, diese festzulegen, und Fehler bei deren Festlegung zu fehlerhaften Einreichungen führen.

Sandbox und Live

Die Modi werden anhand des Schlüssels ausgewählt, mit dem Sie signieren, sodass kein globaler Schalter umgelegt werden muss und bei einer Bereitstellung nichts zu vergessen ist:

• gfk_sandbox_… Schlüsseldatei für die Testumgebung von HMRC . Kostenlos, unbegrenzt und sicher für den Einsatz in CI-Umgebungen.
• gfk_live_… Schlüsseldatei reale Renditen.

Beide Modi funktionieren gleichzeitig. Ihre Testsuite kann in der Sandbox ausgeführt werden, während die Produktionsdateien aktiv sind. Der Wechsel zwischen den Modi erfolgt durch die Wahl der Anmeldeinformationen. Nutzung, Anforderungsprotokolle und Tageslimits werden pro Modus separat erfasst.

Sicherheit und Beweismittel

Die Rotation erfolgt ohne Ausfallzeiten: Mehrere Schlüssel können gleichzeitig aktiv sein, sodass Sie das neue Schlüsselpaar ausstellen, es bereitstellen und das alte widerrufen, sobald niemand mehr damit signiert.

Webhooks, Protokolle und das Entwicklerportal

Die Einreichung von Dokumenten erfolgt naturgemäß asynchron – eine Genehmigung durch einen Mitarbeiter ist erforderlich, und HMRC muss antworten. Anstatt ständige Nachfragen zu senden, übermitteln wir Ihnen signierte Ereignisse an Ihren Endpunkt, sobald sich der Status Ihrer Einreichung ändert: Genehmigung ausstehend, eingereicht, fehlgeschlagen usw. Jede Zustellung ist mit Ihrem Webhook-Geheimnis HMAC-signiert, sodass Sie die Echtheit überprüfen können.

Das Partnerportal bei api.gofile.co.uk gibt Ihrem Team:

• API-Schlüssel — Sandbox- und Live-Paare ausgeben, letzte Nutzung anzeigen, rotieren und widerrufen.
• Anforderungsprotokolle — Jede signierte Anfrage wird mit Status, Fehlercode, Modus, Dauer und Anfrage-ID angezeigt. Auch Signaturfehler werden angezeigt – genau das, was man braucht, wenn man um 2 Uhr nachts Probleme mit dem HMAC hat.
• Webhook-Zustellung — Status, Antwortcode und Wiederholungsplan pro Ereignis.
• Verwendung — Anfragen und Einreichungen nach Tag, aufgeteilt nach Modus.
• Abrechnung — Rechnungen, Zahlungsmethoden und Ihr Tarif.

Preisgestaltung

Die Preise verstehen sich exkl. MwSt. Die Bearbeitungsgebühren werden Ihrer nächsten Monatsrechnung hinzugefügt. Es fallen keine Gebühren pro Mandant, kein Mindestvolumen und keine Gebühren für die Einreichung in der Testumgebung an – Sie zahlen erst, wenn eine tatsächliche Steuererklärung HMRC eingeht.

Was kommt als Nächstes?

Version 1 betrifft die Mehrwertsteuer, da MTD hier verpflichtend ist und das Meldevolumen am höchsten ist. Das gleiche Modell – ein einziger Anruf, eine gehostete Genehmigung, eine Quittung – ist so konzipiert, dass es auf die übrigen Meldepflichten im Vereinigten Königreich ausgeweitet werden kann.

MTD für die Einkommensteuer ist der nächste logische Schritt, und hier ist der Nutzen einer vereinfachten API am größten: Die ITSA-Schnittstelle der britischen Steuerbehörde HMRC umfasst eine Vielzahl von Endpunkten und Strukturen, und wir beabsichtigen, diese auf dieselbe übersichtliche Oberfläche zu reduzieren, die Connect für die Mehrwertsteuer bietet. Wenn Ihre Roadmap von einer bestimmten Steuer oder einem bestimmten Zeitplan abhängt, Erzählen Sie uns — Die Reihenfolge richtet sich nach der Nachfrage des Partners.

Los geht's!