#GoFile Connect API

Connect API nedir?

Birleşik Krallık vergi beyannamesi için bir uyumluluk geçidi: yazılımınız, müşteri ve rakamlarıyla birlikte tek bir uç noktayı arar ve # GoFile bu arama ile HMRC (Birleşik Krallık Vergi Dairesi) onayı arasındaki her şeyi halleder.

Dijital Vergilendirme (Making Tax Digital) API'sini bir kez çağırmak zor değil. Zor olan API'dir, tekrar tekrar çağırabilmektir. sahip olmakTanıma, 18 ay sonra süresi dolan OAuth yetkilendirmeleri, gerçek kaynak cihazı tanımlaması gereken sahtekarlık önleme başlıkları, yükümlülük eşleştirme, asla uydurmamanız gereken dönem anahtarları, gönderim tekrarlanabilirliği ve yıllar sonra bile geçerliliğini koruyan bir denetim izi — işte bu, işin kendisi ve asla bitmiyor.

Connect API, bu çalışmanın küçük bir REST arayüzünün arkasında yapılmış ve sürdürülen halidir. Sürüm 1 şunları kapsar: KDVMüşterinin yetkilendirilmiş olup olmadığını kontrol etmek, KDV durumunun tamamını okumak, beyanname vermek ve makbuz haline gelene kadar süreci takip etmek.

Kimin için?

API, bir aracı modeline göre tasarlanmıştır: iş ortağı firmanız HMRC bağlanır. acente hizmetleri hesabı Bir kez verilir ve bu tek yetkilendirme, işlem yapmaya yetkili olduğu her müşteriyi kapsar.

Nasıl çalışır?

Her istek imzalı bir REST çağrısıdır. Yasal olarak insan müdahalesi gerektiren her şey, bizim barındırdığımız sayfada gerçekleşir.

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

Onay alma süreci ve önemi

HMRC sadece bir vergi beyannamesi istemiyor; beyannamenin gerçek bir kişi tarafından gerçek bir cihaz üzerinden verildiğini ve beyanın sorumluluğunun bir insan tarafından üstlenildiğini bilmek istiyor. Sahtekarlığı önleme başlıkları bunun içindir ve bunların yanlış girilmesi bir uyumluluk sorunudur, bir hata değil.

Dolayısıyla Connect API, yazılımınızdan bunları taklit etmesini asla istemez. Bir dosya gönderdiğinizde, size bir sayfaya yönlendiren bir URL döndürürüz. ev sahipliği yapıyoruzBu sayfada yetkili kişi iki faktörlü kimlik doğrulama ile giriş yapar, gerçek cihazı kaydedilir, beyanname eksiksiz olarak görüntülenir ve beyanı onaylar. Ancak bundan sonra, tam olarak o cihazdan oluşturulan ve kanıt olarak gönderimle birlikte anlık görüntüsü alınan başlıklarla birlikte HMRC ararız.

Bu sayfa, müşterinizi tek seferlik HMRC bağlantısı üzerinden de yönlendirir. Bir firma ilk kez başvuru yaptığında, acente hizmetleri hesabını orada yetkilendirir ve doğrudan başvuru işlemine geri döner.

İnşa etmek zorunda olmadığınız şeyler

Sizden asla noktalama işareti veya başka bir şey istenmez. finalised Bayrak — API bunları doğrudan reddediyor çünkü bunlar bizim belirleyeceğimiz şeyler ve bunları yanlış belirlemek kötü dosyalama işlemlerinin nasıl gerçekleştiğinin bir göstergesi.

Kum havuzu ve canlı

Modlar, kullandığınız imzalama anahtarı ile seçilir, bu nedenle genel bir ayar değişikliğine gerek yoktur ve dağıtım sırasında unutulacak bir şey de bulunmaz:

• gfk_sandbox_… HMRC test ortamına ait anahtar dosyası. Ücretsiz, sınırsız ve CI'da çalıştırmak güvenli.
• gfk_live_… Anahtar dosyası gerçek sonuçlar veriyor.

İkisi de aynı anda çalışır. Test paketiniz sanal ortamda çalışırken üretim dosyaları da çalışmaya devam edebilir ve aralarında geçiş yapmak, hangi kimlik bilgisiyle oturum açtığınıza bağlıdır. Kullanım, istek kayıtları ve günlük limitler her mod için ayrı ayrı izlenir.

Güvenlik ve kanıtlar

Rotasyon sıfır kesinti süresine sahiptir: birden fazla anahtar aynı anda aktif olabilir, bu nedenle yeni çifti oluşturursunuz, devreye alırsınız ve eski çiftle hiçbir şey imzalanmadığında onu iptal edersiniz.

Web kancaları, günlükler ve geliştirici portalı

Dosyalama işlemi doğası gereği eşzamansızdır; bir insan tarafından onaylanması ve HMRC yanıt vermesi gerekir. Sizi sürekli sorgulamaya zorlamak yerine, dosyalama işlemi ilerledikçe (onay bekliyor, gönderildi, başarısız oldu vb.) imzalı olayları uç noktanıza iletiyoruz. Her teslimat, webhook gizli anahtarınızla HMRC tarafından imzalanır, böylece bizden geldiğini doğrulayabilirsiniz.

İş ortağı portalı şu adreste: api.gofile.co.uk Ekibinize şunları sağlar:

• API anahtarları — Sanal ortam ve canlı eşleştirmeleri yayınlayın, son kullanımı görün, döndürün ve iptal edin.
• İstek kayıtları — Her imzalı istek, durumu, hata kodu, modu, süresi ve istek kimliğiyle birlikte görüntülenir. İmza hataları da görünür; bu da gece saat 2'de HMAC kodunu yanlış girdiğinizde tam olarak ihtiyacınız olan şeydir.
• Webhook teslimatları — Olay başına durum, yanıt kodu ve yeniden deneme programı.
• Kullanım — Talepler ve başvurular günlere göre, yönteme göre ayrılmış olarak grafiklendirilmiştir.
• Faturalama — faturalar, ödeme yöntemleri ve planınız.

Fiyatlandırma

Fiyatlara KDV dahil değildir. Dosyalama ücretleri bir sonraki aylık faturanıza eklenir. Müşteri başına ücret yok, minimum hacim yok ve deneme amaçlı dosyalama için ücret yok; yalnızca gerçek bir beyanname HMRC ulaştığında ödeme yaparsınız.

Sırada ne var?

Versiyon 1, KDV ile ilgilidir çünkü MTD zorunlu olduğu ve hacmin en yüksek olduğu yer burasıdır. Aynı model - tek bir temiz çağrı, barındırılan onay, makbuz - Birleşik Krallık'taki diğer uyumluluk dosyalama işlemlerine de genişletilecek şekilde tasarlanmıştır.

Gelir Vergisi için MTD doğal olarak bir sonraki aşamadır ve basitleştirilmiş bir API'nin değeri burada en büyüktür: HMRC kendi ITSA arayüzü çok sayıda uç nokta ve şekli kapsar ve biz bunu Connect'in size KDV için sağladığı aynı rasyonel yüzeye indirgemeyi amaçlıyoruz. Yol haritanız belirli bir vergiye veya zaman çizelgesine bağlıysa, bize söyleyin — Ortakların talebi sipariş sırasını belirler.

Başlayın