#GoFile Połącz API

Czym jest API Connect

Rozwiązanie umożliwiające przestrzeganie przepisów dotyczących rozliczeń podatkowych w Wielkiej Brytanii: oprogramowanie łączy się z jednym punktem końcowym, w którym klient podaje swoje dane, a # GoFile zajmuje się wszystkim od momentu połączenia do momentu otrzymania płatności przez HMRC .

Making Tax Digital to nie jest trudne API do jednorazowego wywołania. To trudne API do własnyRozpoznawanie, autoryzacje OAuth wygasające po 18 miesiącach, nagłówki zapobiegające oszustwom, które muszą opisywać prawdziwe urządzenie źródłowe, dopasowywanie zobowiązań, klucze okresowe, których nigdy nie wolno wymyślać, idempotentność przesyłania oraz ślad audytu, który zachowuje aktualność nawet po latach — to jest praca, która nigdy się nie kończy.

Interfejs API Connect to praca wykonywana i utrzymywana za niewielką powierzchnią REST. Wersja 1 obejmuje KADŹ: sprawdzenie, czy klient jest upoważniony, zapoznanie się z jego pełną informacją VAT, złożenie deklaracji i śledzenie jej aż do otrzymania paragonu.

Dla kogo to jest

Interfejs API jest przeznaczony dla modelu agenta: Twoja firma partnerska łączy się z HMRC konto usług agenta jednorazowo, a to pojedyncze upoważnienie obejmuje każdego klienta, w imieniu którego jest upoważniona działać.

Jak to działa

Każde żądanie to podpisane wywołanie REST. Wszystko, co prawnie wymaga udziału człowieka, dzieje się na stronie, którą hostujemy.

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

Zatwierdzenie hostowane — i dlaczego ma to znaczenie

HMRC nie chce po prostu deklaracji; chce mieć pewność, że deklaracja pochodzi od prawdziwej osoby na prawdziwym urządzeniu i że to człowiek był odpowiedzialny za jej sporządzenie. Właśnie do tego służą nagłówki zapobiegające oszustwom, a ich błędne podanie jest problemem zgodności, a nie błędem.

Dzięki temu API Connect nigdy nie prosi Twojego oprogramowania o ich fałszowanie. Gdy publikujesz zgłoszenie, zwracamy adres URL do strony. jesteśmy gospodarzamiNa tej stronie osoba upoważniona loguje się z uwierzytelnianiem dwuskładnikowym, jej prawdziwe urządzenie zostaje przechwycone, deklaracja jest wyświetlana w całości, a ona potwierdza deklarację. Dopiero wtedy kontaktujemy się HMRC – z nagłówkami utworzonymi na podstawie tego konkretnego urządzenia, które są migawką wraz z deklaracją jako dowodem.

Strona przeprowadza również Twojego klienta przez jednorazowe połączenie HMRC . Kiedy firma składa zeznanie po raz pierwszy, autoryzuje tam swoje konto usług agenta i od razu wraca do składania zeznania.

Czego nie musisz budować

Nigdy nie zostaniesz poproszony o podanie klucza okresu lub finalised flaga — API odrzuca je od razu, ponieważ to my musimy je ustalić, a błędne ich podanie prowadzi do powstawania złych zgłoszeń.

Sandbox i na żywo

Tryby wybierane są na podstawie klucza, którym się podpisujesz, więc nie ma potrzeby przełączania żadnego globalnego przełącznika i nie ma o czym zapomnieć podczas wdrażania:

• gfk_sandbox_… Plik kluczy do środowiska testowego HMRC . Bezpłatny, nieograniczony i bezpieczny do uruchomienia w CI.
• gfk_live_… klucze zawierają rzeczywiste zwroty.

Oba działają jednocześnie. Zestaw testowy może zostać uruchomiony w trybie sandbox, podczas gdy pliki produkcyjne są aktywne, a przełączanie się między nimi zależy od tego, jakimi danymi uwierzytelniającymi się posługujesz. Użycie, logi żądań i limity dzienne są monitorowane osobno dla każdego trybu.

Bezpieczeństwo i dowody

Rotacja nie powoduje przestojów: jednocześnie może być aktywnych kilka kluczy, więc wydajesz nową parę, wdrażasz ją i unieważniasz starą parę, gdy nic z nią nie podpiszesz.

Webhooki, logi i portal dla programistów

Składanie dokumentów jest z natury asynchroniczne — człowiek musi zatwierdzić, a HMRC musi odpowiedzieć. Zamiast zmuszać Cię do odpytywania, przesyłamy podpisane zdarzenia do Twojego punktu końcowego w miarę postępu procesu składania dokumentów: oczekujące na zatwierdzenie, wysłane, nieudane i inne. Każdy dokument jest podpisany HMAC przy użyciu Twojego tajnego webhooka, dzięki czemu możesz zweryfikować, czy pochodzi od nas.

Portal partnerski pod adresem api.gofile.co.uk daje Twojemu zespołowi:

• Klucze API — wydawaj piaskownice i pary na żywo, zobacz ostatnie użycie, obróć i odwołaj.
• Dzienniki żądań — każde podpisane żądanie ze statusem, kodem błędu, trybem, czasem trwania i identyfikatorem żądania. Pojawiają się również błędy podpisu, co jest dokładnie tym, czego potrzebujesz, gdy o 2 w nocy popełniasz błąd w HMAC.
• Dostawy webhooków — status, kod odpowiedzi i harmonogram ponawiania prób dla każdego zdarzenia.
• Stosowanie — wnioski i zgłoszenia uporządkowane według dnia i podzielone według trybu.
• Rozliczanie — faktury, metody płatności i Twój plan.

Wycena

Ceny nie zawierają podatku VAT. Opłaty za złożenie zeznania zostaną doliczone do kolejnej miesięcznej faktury. Brak opłat za klienta, brak minimalnej ilości zeznań i brak opłat za złożenie zeznania w trybie „sandbox” – płacisz tylko wtedy, gdy rzeczywiste zeznanie wpłynie HMRC .

Co dalej?

Wersja 1 to VAT, ponieważ to tam obowiązuje MTD , a wolumen jest najwyższy. Ten sam model – jedno czyste zgłoszenie, hostowana zgoda, potwierdzenie odbioru – został zaprojektowany tak, aby objąć nim resztę brytyjskich obowiązków związanych ze zgodnością.

MTD dla podatku dochodowego to naturalna kolejna płaszczyzna i to właśnie tam wartość uproszczonego API jest największa: własny interfejs ITSA HMRC obejmuje dużą liczbę punktów końcowych i kształtów, a my zamierzamy połączyć go w tę samą racjonalną płaszczyznę, którą Connect oferuje dla podatku VAT. Jeśli Twoja mapa drogowa zależy od konkretnego podatku lub harmonogramu, powiedz nam — zapotrzebowanie partnera decyduje o kolejności.

Zacznij