#GoFile API de connexion

Qu'est-ce que l'API Connect ?

Une passerelle de conformité pour la déclaration fiscale britannique : votre logiciel appelle un point de terminaison avec un client et ses chiffres, et # GoFile gère tout entre cet appel et la réception par HMRC .

L'API Making Tax Digital n'est pas difficile à utiliser une seule fois. C'est une API difficile à utiliser. propreLa reconnaissance, les autorisations OAuth qui expirent après 18 mois, les en-têtes de prévention de la fraude qui doivent décrire le véritable appareil d'origine, la correspondance des obligations, les clés de période que vous ne devez jamais inventer, l'idempotence des soumissions et une piste d'audit qui reste valable des années plus tard — voilà le travail, et il ne s'arrête jamais.

L'API Connect représente ce travail, réalisé et maintenu, derrière une interface REST réduite. La version 1 couvre T.V.A.: vérifier l'autorisation d'un client, examiner sa situation complète en matière de TVA, établir une déclaration et en assurer le suivi jusqu'à l'émission d'un reçu.

À qui est-ce destiné ?

L'API est conçue pour un modèle d'agent : votre entreprise partenaire connecte son HMRC compte de services d'agent Une seule autorisation suffit, et elle couvre tous les clients pour lesquels elle est autorisée à agir.

Comment ça marche

Chaque requête est un appel REST signé. Toutes les opérations nécessitant légalement une intervention humaine se déroulent sur une page hébergée par nos soins.

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"
  }
}

L'approbation hébergée — et pourquoi elle est importante

L'administration fiscale HMRC ne se contente pas d'exiger une déclaration ; elle veut s'assurer qu'elle provient d'une personne réelle, sur un appareil réel, et qu'une personne a bien assumé la responsabilité de cette déclaration. C'est le rôle des en-têtes de prévention de la fraude, et toute erreur à leur sujet constitue un problème de conformité, et non un dysfonctionnement.

L'API Connect ne demande donc jamais à votre logiciel de les falsifier. Lorsque vous déposez un document, nous vous renvoyons une URL vers une page. nous hébergeonsSur cette page, la personne autorisée se connecte à l'aide de l'authentification à deux facteurs, son appareil est identifié, la déclaration est affichée intégralement et elle la confirme. C'est seulement après cela que nous contactons HMRC ; les en-têtes de déclaration sont alors générés à partir de cet appareil précis et joints à la déclaration comme preuve.

Cette page permet également à votre client de se connecter une seule fois HMRC . Lorsqu'une entreprise effectue une déclaration pour la première fois, elle y autorise son compte de services d'agent et revient directement à la page de déclaration.

Ce que vous n'avez pas à construire

On ne vous demandera jamais de pointeur ni de finalised L'API refuse catégoriquement ces drapeaux, car il nous appartient de les déterminer et c'est en les identifiant incorrectement que des déclarations erronées se produisent.

Bac à sable et en direct

Les modes sont choisis par la clé avec laquelle vous vous connectez, il n'y a donc pas d'interrupteur global à actionner et rien à oublier lors d'un déploiement :

• gfk_sandbox_… Fichier de clés pour l'environnement de test du HMRC . Gratuit, illimité et sûr pour une exécution en intégration continue.
• gfk_live_… Les clés du fichier renvoient réellement des résultats.

Les deux environnements fonctionnent simultanément. Votre suite de tests peut s'exécuter dans un environnement isolé (sandbox) tandis que les fichiers de production sont actifs. Le passage de l'un à l'autre se fait en fonction des identifiants utilisés pour la connexion. L'utilisation, les journaux de requêtes et les limites quotidiennes sont suivis séparément pour chaque mode.

Sécurité et preuves

La rotation s'effectue sans interruption de service : plusieurs clés peuvent être actives simultanément. Il vous suffit donc d'émettre la nouvelle paire, de la déployer, puis de révoquer l'ancienne une fois qu'aucune connexion n'est établie avec celle-ci.

Webhooks, journaux et portail développeur

Le processus de déclaration est asynchrone par nature : une approbation humaine est requise et HMRC doit y répondre. Plutôt que de vous interroger régulièrement, nous envoyons des notifications signées à votre terminal au fur et à mesure de l’avancement de la déclaration : en attente d’approbation, soumise, refusée, etc. Chaque notification est signée HMAC avec votre clé secrète de webhook, ce qui vous permet de vérifier sa provenance.

Le portail partenaire sur api.gofile.co.uk donne à votre équipe :

• Clés API — émettre des paires sandbox et live, voir la dernière utilisation, faire pivoter et révoquer.
• Journaux de requêtes — Chaque requête signée, avec son statut, son code d'erreur, son mode, sa durée et son identifiant. Les échecs de signature apparaissent également, ce qui est précisément ce dont vous avez besoin lorsque vous rencontrez des difficultés avec le HMAC à 2 heures du matin.
• livraisons Webhook — statut, code de réponse et calendrier de nouvelle tentative par événement.
• Usage — requêtes et dépôts classés par jour, ventilés par mode.
• Facturation — les factures, les modes de paiement et votre forfait.

Tarification

Les prix indiqués sont hors TVA. Les frais de dépôt seront ajoutés à votre prochaine facture mensuelle. Aucun frais par client, aucun volume minimum et aucun frais pour les déclarations en environnement de test : vous ne payez que lorsqu’une déclaration réelle parvient à l’administration fiscale britannique HMRC .

Et ensuite ?

La version 1 concerne la TVA, car c'est dans ce domaine que MTD est obligatoire et que le volume est le plus élevé. Le même modèle – un appel simplifié, une approbation hébergée, un reçu – est conçu pour s'étendre à l'ensemble des déclarations de conformité au Royaume-Uni.

La mise en œuvre de la TVA MTD pour l'impôt sur le revenu est la prochaine étape logique, et c'est là que la valeur d'une API simplifiée est la plus grande : l'interface ITSA de HMRC couvre un grand nombre de points de terminaison et de formats, et nous avons l'intention de la simplifier pour obtenir la même interface rationnelle que celle proposée par Connect pour la TVA. Si votre feuille de route dépend d'un impôt ou d'un calendrier spécifique, Dites-nous — La demande du partenaire détermine la commande.

Commencer