United Kingdom: Making Tax Digital - fraud prevention headers update July 2021 in Dynamics AX 2012 R3

Wprowadzenie

13 lipca 2017 r. dyrektor ds. skarbowych i paymaster general w Zjednoczonym Królestwie ogłosił, że podatek Making Tax Digital (MTD) dla podatku od wartości dodanej (VAT) rozpocznie się 1 kwietnia 2019 r.

W celu obsługi wymagań MTD dotyczących podatku VAT w systemie Dynamics AX 2012 R3 opublikowano poprawkę: aktualizacja kb 4488588.

Ponadto w kwietniu 2019 r. do interfejsu API podatku VAT wprowadzono informacje nagłówków dostaw, aby zapobiec oszustwom. Aby uzyskać więcej informacji, zobacz Zapobieganie oszustwom. Nagłówki zapobiegania oszustwom w systemie Dynamics AX 2012 R3 są obsługiwane w 4505299 KB i KB 4539848.

Omówienie

Bieżąca poprawka udostępnia następujące zmiany dotyczące funkcji podatku VAT MTD w systemie Dynamics AX 2012 R3:

1. Dołącz parametr parametrów zapobiegania oszustwom na karcie Ogólne formularza parametrów usługi sieci Web jest zawsze domyślnie oznaczony i wyłączony. Oznacza to, że nagłówki zapobiegania oszustwom zawsze będą wysyłane w ramach żądań HTTPS do interfejsu API VAT MTD firmy HMRC. Wysyłanie żądań do interfejsu API VAT MTD hmrc bez nagłówków zapobiegania oszustwom nie jest dozwolone. Aby dowiedzieć się więcej na temat tego wymagania, zobacz Wysyłanie danych zapobiegania oszustwom — HMRC Developer Hub.

2. Najnowsze wymagania dotyczące nagłówków zapobiegania oszustwom opublikowane przez HMRC (wersja 3.0) https://developer.service.hmrc.gov.uk/guides/fraud-prevention/getting-it-right/#change-log są teraz obsługiwane. Więcej szczegółów znajdziesz w dalszej części tej bazy wiedzy.

3. Wprowadzono nowy formularz Zewnętrznych usług sieci Web do identyfikowania adresów IP. Dostęp do niej można uzyskać za pomocą przycisku Zewnętrzne usługi sieci Web na karcie Zapobieganie oszustwom formularza parametrów usługi sieci Web. Zewnętrzne usługi sieci Web do identyfikowania formularza adresów IP umożliwiają użytkownikowi (roli administratora systemu) określanie adresów HTTP(S) zewnętrznych usług sieci Web, które zwracają publiczny adres IP klienta i serwera.

Uwagi:

(!) Zasady zachowania poufności informacji
Po włączeniu systemu Dynamics AX 2012 R3 do współdziałania z interfejsem API podatku VAT (Making Tax Digital, MTD) dla interfejsu API podatku VAT (Making Majesty' Revenue and Cels, HMRC) zarówno zawartość klientów, jak i dane osobowe będą udostępniane hmrc w ramach przesyłania informacji o podatku VAT do raportu Making Tax Digital (MTD) na potrzeby raportu VAT. Mogą to być informacje o lokalizacji i inne identyfikatory osobiste, takie jak adresy IP. Aby dowiedzieć się więcej o rodzajach informacji zawartych w Twoich zgłoszeniach, zobacz wymagania HMRC w witrynie internetowej HMRC. Współdziałanie z usługą sieci Web HMRC może zostać wyłączone przez administratora systemu z poziomu formularza aplikacji sieci Web przez dezaktywowanie aplikacji o typie produkcji.
Twoja prywatność jest dla nas ważna. Aby dowiedzieć się więcej, przeczytaj zasady zachowania poufności informacji i zasady dotyczące plików cookie.

4. Przycisk Wypełnij na karcie Zapobieganie oszustwom formularza parametrów usług sieci Web zawiera teraz tylko trzy nagłówki: Gov-Client-Public-IP, Gov-Vendor-Public-IP, Gov-Vendor-Forwarded. Użytkownik nadal może ręcznie dodawać inne nagłówki za pomocą przycisków Dodaj/Usuń i ręcznie określać wartości. Te wartości będą używane przez system tylko w przypadku, gdy nie można było automatycznie zebrać odpowiednich wartości.

5. Zmieniono algorytm zbierania danych na podstawie nagłówka zapobiegania oszustwom: system automatycznie zbiera informacje dla nagłówków i tylko na wypadek, gdy nie można było automatycznie zebrać wartości dla niektórych nagłówków, ręcznie zdefiniowane wartości na karcie Zapobieganie oszustwom formularza parametrów usług sieci Web będą używane do przesyłania danych do HMRC.

Ważne:

(!) Uwaga
9 lipca 2021 r. został wygenerowany nowy klucz tajny klienta dla systemu Dynamics AX 2012 R3 i opublikowany w bibliotece udostępnionych zasobów portalu LCS — UK_MTD_VAT_AX2012R3_ProdApll_20210709.zip. Przejdź do sekcji Pakiet danych w udostępnionej bibliotece zasobów, aby pobrać pakiet do magazynu lokalnego.
Po pobraniuUK_MTD_VAT_AX2012R3_ProdApll_20210709.zipz usługi LCS zaimportuj nowego klienta tajnego do systemu Dynamics AX 2012 R3, jak wyjaśniono w akapicie "Konfigurowanie aplikacji sieciWebdo użytku produkcyjnego" w artykule 4488588 KB.
Upewnij się, że token dostępu można pomyślnie odświeżyć przy użyciu nowej tajemnicy. Użyj przycisku Odśwież token dostępu w okienku Akcja w głównej księgi głównej > Setup > Formularz aplikacji sieci Web usług zewnętrznych > w systemie AX, aby ręcznie zainicjować odświeżanie tokenu dostępu.
Upewnij się, że pole wyboru Aktywny jest oznaczone dla aplikacji sieci Web o typie produkcyjnym, dla którego zaimportowano nowego klienta o kluczu tajnym.

Szczegóły poprawki

Parametr "Uwzględnij parametry zapobiegania oszustwom"

W 4505299 bazy wiedzy Dołącz parametr parametrów zapobiegania oszustwom na karcie Ogólne formularza parametrów usługi sieci Web. Bieżąca aktualizacja powoduje, że ten parametr jest zawsze domyślnie oznaczany i wyłączany. Oznacza to, że nagłówki zapobiegania oszustwom zawsze będą wysyłane w ramach twoich żądań HTTPS do interfejsu API VAT MTD firmy HMRC. Wysyłanie żądań do interfejsu API VAT MTD hmrc bez nagłówków zapobiegania oszustwom nie jest dozwolone. Aby dowiedzieć się więcej na temat tego wymagania, zobacz Wysyłanie danych zapobiegania oszustwom — HMRC Developer Hub.

tekst alternatywny

Nagłówki zapobiegania oszustwom w wersji 3.0

Najnowsze wymagania dotyczące nagłówków zapobiegania oszustwom, wersja 3.0, opublikowana przez HMRC https://developer.service.hmrc.gov.uk/guides/fraud-prevention/getting-it-right/#change-log są obsługiwane w systemie Dynamics AX 2012 R3 przy użyciu bieżącej poprawki.

Więcej informacji na temat sposobu, w jaki system Dynamics AX 2012 R3 obsługuje wszystkie nagłówki zapobiegania oszustwom, można znaleźć w poniższej tabeli:

Nagłówek HTTP	Opis	Szczegóły implementacji
Gov-Client-Connection-Method	Wartość stała: DESKTOP_APP_VIA_SERVER	Wartość stała
Gov-Client-Device-ID	Identyfikator unikatowy dla urządzenia pochodzących. Format nagłówka został zaktualizowany zgodnie z najnowszym wymaganiem HMRC.	Automatycznie identyfikowane przez system przy użyciu wartości z rejestru systemu: HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\HMRC
Gov-Client-Local-IPs	Lista wszystkich lokalnych adresów IP (IPv4 i IPv6) dostępnych dla urządzenia pochodzących.	Funkcje System.Net.IPHostEntry i System.Net.IPAddress są identyfikowane automatycznie przez system. Jeśli lokalne adresy IP nie są definiowane automatycznie, stała wartość powiązana z nagłówkiem "Gov-Client-Local-IP" będzie zbierana z formularza " Setup supplemented fraud prevention headers"(Skonfiguruj nagłówki zapobiegania oszustwom) i wysyłana do HMRC.
Gov-Client-Local-Ips-Timestamp	Sygnatura czasowa, która jest pokazywana, gdy zbierane są adresy IP gov-client-local.	Automatycznie identyfikowane przez system jako wartość DateTime w formacie yyyy-MM-ddTHH:mm:ss.fffZ
Gov-client-MAC-addresses	Lista adresów MAC dostępnych na urządzeniu, z którego pochodzi urządzenie.	Automatycznie identyfikowane przez system przy użyciu: System.Net.NetworkInformation.NetworkInterface System.Net.NetworkInformation.PhysicalAddress
Gov-Client-Multi-Factor	Lista struktur danych kluczowych wartości zawierających szczegóły stanu uwierzytelniania wieloskładnikowego (MFA) związanego z wywołaniem interfejsu API.	Pominięta w systemie Dynamics AX 2012 R3. Jeśli system obsługuje uwierzytelniania WIELOSKŁADNIKOWE za pomocą dostosowania, zdefiniuj algorytm niezbędny dla nagłówka, aby został on prawidłowo przeniesiony do hmrc.
Gov-Client-Public-IP	Publiczny adres IP (IPv4 lub IPv6), z którego urządzenie udostępnia żądanie.	Automatycznie identyfikowane przez wywoływanie zewnętrznych usług sieci Web,które zwracają wartość publicznego adresu IP. Więcej informacji znajdziesz w sekcji"Zewnętrzne usługi sieci Webdo identyfikowania adresów IP" w tym artykule z bazy wiedzy.
Gov-Client-Public-Ip-Timestamp	Sygnatura czasowa, która jest pokazywana, gdy jest zbierany adres IP gov-client-public.	Automatycznie identyfikowany przez system jako wartość DateTime w formacie yyyy-MM-ddTHH:mm:ss.fffZ.
Gov-Client-Public-Port	Publiczny port TCP używany przez urządzenie inicjujące podczas inicjowania żądania.	Pominięta w systemie Dynamics AX 2012 R3.
Gov-Client-Screens	Informacje dotyczące ekranów urządzeń pochodzących. Pola te obejmują (szerokość ekranu, wysokość ekranu, współczynnik skalowania ekranu, głębia kolorów ekranu).	Automatycznie identyfikowane przez system przy użyciu: System. Windows. Forms.Screen System.Drawing.Rectangle System. Windows. Forms.Control System.Drawing.Graphics
Gov-Client-Timezone	Lokalna strefa czasowa urządzenia pochodzących.	Automatycznie identyfikowane przez system za pomocą xGlobal::machineTzDisplayName()
Gov-Client-User-Agent	Próba zidentyfikowania rodziny, wersji, producenta i modelu systemu operacyjnego dla urządzenia rozsyłającego.	System jest identyfikowany automatycznie przez uruchamianie cmd.exe z poleceniami: "wmic os get Caption" to get the os-version value "wmic computersystem get manufacturer" w celu uzyskania wartości producenta urządzenia "wmic computersystem get model" w celu uzyskania wartości modelu urządzenia
Gov-Client-User-ID	Struktura danych o wartości klucza zawierająca identyfikatory użytkowników.	Automatycznie identyfikowane przez system: WinAPI::getUserName()
Gov-Client-Window-Size	Liczba pikseli okna na urządzeniu, w którym użytkownik zainicjował (bezpośrednio lub pośrednio) połączenie interfejsu API do hmrc.	Automatycznie identyfikowane przez system: WinAPI::getWindowRect
Gov-Vendor-License-ID	Struktura danych wartości kluczy kluczy skrótów związanych z inicjowaniem przez dostawcę żądania interfejsu API na urządzeniu, z którego pochodzi.	Automatycznie identyfikowane i skrótowane przez system: xSysConfig::find(ConfigType::SerialNo, 0)
Gov-Vendor-Product-Name	Nazwa produktu na rynku dla użytkowników końcowych.	Automatycznie identyfikowane przez system: xInfo::p roductName()
Gov-Vendor-Public-IP	Publiczny adres IP serwera, na który urządzenie inicjujące wysłało swoje żądania.	Automatycznie identyfikowane przez wywoływanie zewnętrznych usług sieci Web,które zwracają wartość publicznego adresu IP. Więcej informacji znajdziesz w sekcji"Zewnętrzne usługi sieci Webdo identyfikowania adresów IP" w tym artykule z bazy wiedzy.
Gov-Vendor-Forwarded	Lista szczegółów przeskokuje przez Internet między usługami, które zakończą usługę TLS.	System jest identyfikowany automatycznie jako wartość składająca się z wartości zbieranych dla gov-client-public-IP i Gov-Vendor-Public-IP
Gov-Vendor-version	Struktura danych o kluczowej wartości w wersjach oprogramowania związanych z obsługą żądania.	Automatycznie identyfikowane przez system: ApplicationVersion::buildNo())

Zewnętrzne usługi sieci Web identyfikujące adres IP

Za pomocą nowych zewnętrznych usług sieci Web określ formularz adresów IP w celu zdefiniowania adresów HTTP(y) usług sieci Web, które będą wywoływane w celu uzyskania adresu IP klienta i serwera oraz wysłania ich do interfejsu API MTD HMRC. Zebrane adresy IP klientów i serwerów nie są zapisywane w systemie i wysyłane do HMRC natychmiast po ich zebraniu. Dlatego gdy użytkownik biznesowy inicjuje wniosek o zwrot PODATKU VAT (na przykład o zwrot podatku VAT lub informacje o zobowiązaniach do pobrania tego podatku), system automatycznie (i w sposób ukryty przed użytkownikiem biznesowym) wysyła żądania do zewnętrznych usług sieci Web zdefiniowanych w zewnętrznych usługach sieci Web w celu zidentyfikowania formularza adresów IP w celu uzyskania publicznego adresu IP klienta i serwera. Uzyskane publiczne adresy IP klienta i serwera są natychmiast dodawane do nagłówków żądań biznesowych (Gov-Client-Public-IP, Gov-Vendor-Public-IP, Gov-Vendor-Forwarded), a żądanie jest przekazywane dalej do HMRC.

Administrator systemu decyduje, która zewnętrzna usługa sieci Web może zostać użyta do uzyskania publicznych adresów IP klienta i serwera. Odwołaj się do (!) Zasady zachowania poufności informacji w sekcji Omówienie tego artykułu z bazy wiedzy. Można zdefiniować kilka zewnętrznych usług sieci Web i będą one określane w kolejności wynikowej w określonej kolejności, dopóki nie zostanie uzyskany adres IP w formacie IPv4 lub IPv6.

Aby zdefiniować zewnętrzne usługi sieci Web, kliknij przycisk Zewnętrzne usługi sieci Web na karcie Zapobieganie oszustwom formularza parametrów usług sieci Web. Jeśli nie uzyskano publicznego adresu IP z żadnej zewnętrznej usługi sieci Web, wartość stała powiązana z nagłówkiem "Gov-Client-Public-IP" będzie zbierana na karcie "Zapobieganie oszustwom" i wysyłana do HMRC.

tekst alternatywny

Przycisk "Wypełnij" na karcie "Zapobieganie oszustwom" formularza "Parametry usługi sieci Web"

Przycisk Wypełnij na karcie Zapobieganie oszustwom formularza parametrów usługi sieci Web bieżącą poprawkę powoduje utworzenie tylko trzech nagłówków: Gov-Client-Public-IP, Gov-Vendor-Public-IP, Gov-Vendor-Forwarded. Użytkownik nadal może ręcznie dodawać inne nagłówki za pomocą przycisków Dodaj i Usuń w siatce oraz ręcznie określać wartości dla utworzonych nagłówków. Te wartości będą używane przez system tylko w przypadku, gdy nie można było automatycznie zebrać odpowiednich wartości.

Algorytm zbierania danych na podstawie nagłówka zapobiegania oszustwom

Zmieniono algorytm gromadzenia danych na podstawie nagłówka zapobiegania oszustwom. System automatycznie zbiera informacje dotyczące nagłówków i tylko na wypadek, gdy nie można było automatycznie zebrać wartości dla niektórych nagłówków, ręcznie zdefiniowane wartości na karcie Zapobieganie oszustwom formularza parametrów usług sieci Web zostaną użyte do przesłania ich do HMRC.

Zalecamy użycie przycisku Sprawdź poprawność karty Zapobieganie oszustwom formularza parametrów usług sieci Web w celu sprawdzenia, w jaki sposób system pracuje, w celu zebrania wszystkich informacji na temat zapobiegania oszustwom i upewninia się, że zostały pomyślnie zebrane wartości wszystkich nagłówków zapobiegania oszustwom. W systemie Dynamics AX 2012 R3 można pominąć tylko nagłówki Gov-Client-Multi-Factor i Gov-Client-Public-Port.

Aby można było sprawdzać nagłówki zapobiegania oszustwom przy użyciu testowego interfejsu API HMRC, musisz zarejestrować się w portalu HMRCjako deweloper , utworzyć aplikację w trybie piaskownicy i zasubskrybować jej interfejs API "Test Fraud Prevention Headers". Więcej informacji na temat sprawdzania poprawności nagłówków zapobiegania oszustwom można znaleźć w artykule Kb systemu Dynamics AX 2012 R3 4539848.