¿Qué es la API Connect?
Una plataforma de cumplimiento normativo para la declaración de impuestos en el Reino Unido: su software llama a un único punto final con el cliente y sus cifras, y # GoFile gestiona todo lo que ocurre entre esa llamada y la recepción por parte de HMRC .
Hacer que los impuestos sean digitales no es una API difícil de llamar una vez. Es una API difícil de usar. propioEl reconocimiento, las concesiones OAuth que caducan a los 18 meses, los encabezados de prevención de fraude que deben describir el dispositivo de origen real, la coincidencia de obligaciones, las claves de período que nunca se deben inventar, la idempotencia de la presentación y un registro de auditoría que se mantiene vigente años después: ese es el trabajo, y nunca termina.
La API Connect es ese trabajo, realizado y mantenido, detrás de una pequeña interfaz REST. La versión 1 cubre TINA: comprobar que un cliente está autorizado, leer su situación completa en materia de IVA, presentar una declaración y hacer el seguimiento hasta obtener un recibo.
La versión corta: Tres llamadas y una redirección. Verificamos al cliente, leemos el importe a pagar, publicamos las cifras y, a continuación, enviamos a la persona autorizada a la página de aprobación alojada que le proporcionamos. Nunca tendrás que usar una credencial de Government Gateway, un token HMRC ni una clave de período.
Para quién es
Software de contabilidad y teneduría de libros
Ya dispones de las cifras. Añade la presentación de declaraciones de IVA MTD conformes a la normativa sin necesidad de convertirte en un equipo de integración HMRC .
Plataformas verticales y ERP
Sistemas comerciales, minoristas, de hostelería o específicos de la industria que deben archivarse como una funcionalidad, no como un proyecto.
Herramientas de práctica y tecnología financiera
Productos destinados a contables y sus clientes, donde la presentación de documentos debe integrarse en su flujo de trabajo.
Sistemas financieros internos
Grupos que presentan solicitudes para múltiples entidades desde un solo lugar, con un registro de auditoría por cada solicitud.
La API está diseñada para un modelo de agente: su empresa asociada conecta su HMRC cuenta de servicios de agente Una sola autorización cubre a todos los clientes para los que está autorizada a actuar.
Cómo funciona
Cada solicitud es una llamada REST firmada. Todo lo que legalmente requiere la intervención humana ocurre en una página que alojamos.
Verifique que el cliente esté autorizado.
Una sola llamada confirma que la cuenta de agente de su empresa está autorizada para ese número de IVA, con una respuesta clara y concisa, sin necesidad de descifrar un código de error HMRC .
GET /api/v1/vat/193054661/status
Lea la situación del IVA del cliente.
Una sola llamada devuelve todos los periodos abiertos con su fecha de vencimiento, todos los periodos ya finalizados y cualquier declaración en trámite. Mantenemos esta información sincronizada con HMRC para que pueda consultarla con la frecuencia que desee.
{
"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 */ ]
}
}
Después del regreso
Envíe la referencia del cliente y las nueve casillas del IVA como cadenas decimales. Omita el punto y nosotros presentaremos el abierto. Recibirá un ID de presentación y un continue_url.
{
"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 */
}
}
Redirigir a la persona autorizada
Envíelos al continue_urlRevisan la declaración, se ponen en contacto con HMRC si es la primera declaración de su empresa y presionan. Confirmar y enviar. Entregamos y capturamos el recibo.
Síguelo hasta que esté terminado.
Consulta el archivo o toma nuestros webhooks hasta que el estado llegue submitted y se adjunta el recibo HMRC .
{
"id": "vfs_...",
"status": "submitted",
"receipt": {
"gofile_reference": "GF-VAT-123",
"form_bundle": "258868935084"
}
}
La aprobación del anfitrión y por qué es importante
HMRC no solo quiere una declaración; quiere saber que la declaración provino de una persona real en un dispositivo real y que un ser humano se responsabilizó de la declaración. Para eso sirven los encabezados de prevención de fraude, y un error en ellos es un problema de cumplimiento, no un fallo técnico.
Por lo tanto, la API de Connect nunca le pide a su software que los falsifique. Cuando usted envía un documento, le devolvemos una URL a una página. nosotros albergamosEn esa página, la persona autorizada inicia sesión con autenticación de dos factores, se captura la información de su dispositivo, se muestra la declaración completa y la confirma. Solo entonces contactamos con HMRC , con los encabezados generados a partir de ese dispositivo exacto, que se capturan junto con la declaración como prueba.
Lo que esto te ofrece: Su producto no requiere credenciales de Government Gateway, ni implementación de encabezados de fraude que mantener y recertificar, ni redacción de declaraciones que corregir, sino un registro inmutable de quién aprobó qué, vinculado a las cifras exactas que vieron.
La página también guía a su cliente a través del proceso de conexión única HMRC . Cuando una empresa presenta la declaración por primera vez, autoriza allí su cuenta de servicios de agente y regresa directamente al proceso de presentación.
Lo que no tienes que construir
| El problema MTD | ¿Quién es el dueño? |
|---|---|
| Concesiones OAuth HMRC , renovación y límite de reautorización de 18 meses | #GoFile |
| Encabezados de prevención de fraude del dispositivo de origen real | #GoFile |
| Coincidencia de obligaciones y claves de período | #GoFile |
| El registro de declaración y aprobación humana | #GoFile |
| Conciliación de idempotencia de envío y tiempo de espera | #GoFile |
| Registro de auditoría y evidencia de presentación | #GoFile |
| Su lista de clientes y sus cifras de IVA. | Tú |
Nunca se le pide una tecla de período o una finalised La API las rechaza directamente, porque nos corresponde a nosotros determinarlas y cometer errores es la causa de los problemas en la presentación de informes.
Sandbox y en vivo
Los modos se eligen mediante la clave con la que firmas, por lo que no hay ningún interruptor global que activar ni nada que olvidar durante la implementación:
gfk_sandbox_…Archivo de claves para el entorno de pruebas de HMRC . Gratuito, ilimitado y seguro para ejecutar en CI.gfk_live_…claves archivo de retornos reales.
Ambos funcionan simultáneamente. Tu conjunto de pruebas puede ejecutarse en el entorno aislado mientras los archivos de producción están activos, y el cambio entre ellos depende de la credencial con la que inicies sesión. El uso, los registros de solicitudes y los límites diarios se controlan por separado para cada modo.
Seguridad y evidencia
Solicitudes firmadas
Cada llamada incluye una firma HMAC-SHA256 sobre el método, la ruta, la marca de tiempo, el valor aleatorio (nonce) y el hash del cuerpo. Se rechazan las repeticiones; los secretos se muestran una sola vez y nunca se registran.
Encriptado en reposo
Los tokens HMRC , los números de IVA, la identidad del cliente y las cifras declaradas se cifran durante su almacenamiento, no solo se controla el acceso.
Auditoría de solo anexar
Cada cambio de estado, llamada y aprobación HMRC se registra en un libro de contabilidad que nunca se sobrescribe, y se envían los encabezados exactos por la línea.
Nunca un reintento a ciegas
Un tiempo de espera agotado no se considera un fallo. Las declaraciones dudosas se cotejan con los registros de HMRC antes de que se produzca cualquier cambio.
La rotación no requiere tiempo de inactividad: varias claves pueden estar activas a la vez, por lo que se emite el nuevo par, se implementa y se revoca el anterior una vez que nadie firma con él.
Webhooks, registros y el portal del desarrollador
La presentación de documentos es asíncrona por naturaleza: una persona debe aprobarla y HMRC debe responder. En lugar de que usted realice consultas periódicas, enviamos eventos firmados a su terminal a medida que avanza el proceso: pendiente de aprobación, presentado, rechazado, etc. Cada envío está firmado con HMAC e incluye su clave secreta de webhook para que pueda verificar que proviene de nosotros.
El portal de socios en api.gofile.co.uk le da a tu equipo:
- claves API — emitir pares de entorno de pruebas y en producción, ver último uso, rotar y revocar.
- Registros de solicitudes — Cada solicitud firmada con su estado, código de error, modo, duración e ID de solicitud. También aparecen los fallos de firma, que es justo lo que necesitas cuando te equivocas con HMAC a las 2 de la madrugada.
- Entregas mediante webhook — estado, código de respuesta y calendario de reintentos por evento.
- Uso — Solicitudes y presentaciones organizadas por día, desglosadas por modalidad.
- Facturación — facturas, métodos de pago y su plan.
Precios
Salvadera
GratisRealice pruebas ilimitadas en el entorno de pruebas de HMRC . Cree y ejecute sus pruebas de integración sin coste alguno.
Plataforma
£150/mesPresentación de documentos en tiempo real, webhooks, registros y soporte. Facturación mensual.
Según la presentación
£1.50Por exitoso Declaraciones de IVA en tiempo real. Las declaraciones fallidas nunca se cobran. Todas las demás operaciones de la API son gratuitas.
Los precios no incluyen el IVA. Las tasas de presentación se añadirán a su próxima factura mensual. Sin comisiones por cliente, sin volumen mínimo y sin cargo por presentación en el entorno de pruebas: solo paga cuando la declaración real llega a HMRC .
¿Qué sigue?
La versión 1 se refiere al IVA, ya que es donde MTD es obligatorio y el volumen es mayor. El mismo modelo —una llamada clara, una aprobación alojada y un recibo— está diseñado para extenderse al resto de la presentación de declaraciones de cumplimiento en el Reino Unido.
MTD para el Impuesto sobre la Renta es la siguiente superficie natural, y es donde el valor de una API simplificada es mayor: la propia interfaz ITSA de HMRC abarca una gran cantidad de puntos finales y formas, y pretendemos consolidarla en la misma superficie racional que Connect le ofrece para el IVA. Si su hoja de ruta depende de un impuesto o cronograma específico, Cuéntanos — La demanda de los socios decide el orden.
Comience
Crear una cuenta de socio
Regístrese en api.gofile.co.ukRecibirás un par de claves de prueba inmediatamente; el secreto se mostrará una sola vez.
Construye contra el entorno de pruebas
Sigue el Referencia de la APIVerifica un cliente, lee su posición, presenta una declaración de prueba y gestiona tú mismo la aprobación alojada. Hay un cliente de referencia en PHP puro sin dependencias si deseas un ejemplo funcional para consultar.
¡Entra en directo!
Suscríbase al plan de la plataforma, genere una clave de activación y su empresa asociada conectará su cuenta de servicios de agente una sola vez. Mismo código, credenciales diferentes.
Presentar la declaración sin formar parte del equipo de integración HMRC
Lea la documentación de referencia o coméntenos qué está desarrollando; estaremos encantados de analizar su caso de uso antes de que escriba cualquier código.