Zjednoczone Królestwo: Tworzenie nagłówków na temat zapobiegania oszustwom w zakresie podatków i cyfr w Dynamics 365 na potrzeby finansów i operacji

Dotyczy
Dynamics 365 for Finance and Operations

Wprowadzenie

W dniu 13 lipca 2017 r. sekretarz finansowy skarbu i paymaster generalny w Wielkiej Brytanii ogłosił, że wprowadzenie podatku cyfrowego (MTD) dla podatku od wartości dodanej (VAT) wejdzie w życie 1 kwietnia 2019 r.

Dynamics 365 dla finansów i operacji począwszy od wersji 10.0.1 obsługuje MTD dla podatku VAT w Zjednoczonym Królestwie.

Aby wspierać mtd wymagań dotyczących podatku VAT w Dynamics 365 dla finansów i operacji w wersji 7.3, wydano poprawki: #4492999, #4493076.

Dokumentacja dotycząca konfigurowania i używania Dynamics 365 dla usług Finanse i Operacje mtd dla podatku VAT jest publikowana na https://learn.microsoft.com/en-us/dynamics365/unified-operations/financials/localizations/emea-gbr-mtd-vat-integration.

Ponadto hm revenue and customs (HMRC) wprowadziło obowiązek dostarczania informacji nagłówkowych dla interfejsu API VAT od kwietnia 2019 r., aby zapobiec oszustwom. Aby uzyskać więcej informacji, zobacz Zapobieganie oszustwom.

Omówienie

Aby zapobiec oszustwom, interfejsy API HMRC udostępniają nagłówki HTTP, które muszą być używane do przekazywania danych inspekcji.

W zależności od architektury środowiska używanego przez przedsiębiorstwo, które współdziała z MTD dla vat różne zestawy nagłówków HTTP w celu zapobiegania oszustwom muszą być przesyłane. Nagłówek "Gov-Client-Connection-Method" musi reprezentować metodę połączenia używaną dla żądania przez firmę. Większość firm korzystających z Dynamics 365 finansów i operacji w architekturze chmury używa metody połączenia "WEB_APP_VIA_SERVER" podczas współdziałania z HMRC za pośrednictwem funkcji wiadomości elektronicznych. Możliwe jest również, że użytkownik może zainicjować zadanie wsadowe w celu współdziałania z HMRC, w tym przypadku metoda połączenia zostanie przesłana jako "BATCH_PROCESS_DIRECT". 

Metoda połączenia "WEB_APP_VIA_SERVER" zakłada transmisję następujących nagłówków:

Nagłówek HTTP Opis Pokrycia
Gov-Client-Public-IP Publiczny adres IP (IPv4 lub IPv6), z którego pochodzi urządzenie, przesyła żądanie. Nie ma zakresu bieżącej poprawki.
Gov-Client-Public-Port Publiczny port TCP używany przez urządzenie źródłowe podczas inicjowania żądania. Nie ma zakresu bieżącej poprawki.
Identyfikator gov-client-device-id Identyfikator unikatowy dla urządzenia źródłowego. Nie ma zakresu bieżącej poprawki.
Identyfikatory użytkowników gov-client Struktura danych klucz-wartość zawierająca identyfikatory użytkowników. Nie ma zakresu bieżącej poprawki.
Gov-Client-Timezone Lokalna strefa czasowa urządzenia źródłowego. Nie ma zakresu bieżącej poprawki.
Gov-Client-Local-IPs Lista wszystkich lokalnych adresów IP (IPv4 i IPv6) dostępnych dla urządzenia źródłowego. Nie ma zakresu bieżącej poprawki.
Ekrany gov-klienta Informacje dotyczące ekranów urządzenia źródłowego. Pola te obejmują:
  • szerokość to zgłoszona szerokość ekranu w pikselach.
  • wysokość to zgłoszona wysokość ekranu w pikselach.
  • współczynnik skalowania jest zgłaszanym współczynnikem skalowania ekranu.
  • głębia kolorów to głębia kolorów ekranu w bitach.
Nie ma zakresu bieżącej poprawki.
Rozmiar okna klienta gov- Liczba pikseli okna na urządzeniu źródłowym, w którym użytkownik zainicjował (bezpośrednio lub pośrednio) wywołanie interfejsu API do HMRC. Nie ma zakresu bieżącej poprawki.
Gov-Client-Browser-Plugins Lista wtyczek przeglądarki na urządzeniu źródłowym. Nie ma zakresu bieżącej poprawki.
Gov-client-browser-JS-user-agent Ciąg agenta użytkownika zgłoszony w języku JavaScript z urządzenia źródłowego. Nie ma zakresu bieżącej poprawki.
Gov-Client-Browser-Do-Not-Track Czy opcja Nie śledź jest włączona w przeglądarce. Nie ma zakresu bieżącej poprawki.
Gov-Client-Multi-Factor Lista struktur danych wartości klucza zawierająca szczegóły stanu uwierzytelniania wieloskładnikowego (MFA) związane z wywołaniem interfejsu API. Nie ma zakresu bieżącej poprawki.
Gov-Vendor-Version Struktura danych o kluczowej wartości w wersjach oprogramowania zaangażowanych w obsługę żądania. Dołączone do bieżącej poprawki.
Identyfikatory licencji gov-vendor Struktura danych klucz-wartość skrótów kluczy licencji odnoszących się do oprogramowania dostawcy inicjujących żądanie interfejsu API na urządzeniu źródłowym. Nie ma zakresu bieżącej poprawki.
Gov-Vendor-Public-IP Publiczny adres IP serwerów, na które urządzenie źródłowe wysłało swoje żądania. Nie ma zakresu bieżącej poprawki.
Gov-Vendor-Forwarded Lista zawierająca szczegóły przeskakuje przez Internet między usługami, które zamykają protokół TLS. Nie ma zakresu bieżącej poprawki.

Metoda połączenia "BATCH_PROCESS_DIRECT" zakłada transmisję następujących nagłówków:

Nagłówek HTTP Opis Pokrycia
Identyfikator gov-client-device-id Identyfikator unikatowy dla urządzenia źródłowego. Nie ma zakresu bieżącej poprawki.
Identyfikatory użytkowników gov-client Struktura danych klucz-wartość zawierająca identyfikatory użytkowników. Nie ma zakresu bieżącej poprawki.
Gov-Client-Timezone Lokalna strefa czasowa urządzenia źródłowego. Dołączone do bieżącej poprawki.
Gov-Client-Local-IPs Lista wszystkich lokalnych adresów IP (IPv4 i IPv6) dostępnych dla urządzenia źródłowego. Nie ma zakresu bieżącej poprawki.
Gov-Client-User-Agent Próba zidentyfikowania rodziny systemów operacyjnych, wersji, producenta urządzenia i modelu urządzenia źródłowego. Dołączone do bieżącej poprawki.
Gov-Vendor-Version Struktura danych o kluczowej wartości w wersjach oprogramowania zaangażowanych w obsługę żądania. Dołączone do bieżącej poprawki.
Identyfikatory licencji gov-vendor Struktura danych klucz-wartość skrótów kluczy licencji odnoszących się do oprogramowania dostawcy inicjujących żądanie interfejsu API na urządzeniu źródłowym. Nie ma zakresu bieżącej poprawki.
Gov-Client-MAC-Addresses Lista adresów MAC dostępnych na urządzeniu źródłowym. Dołączone do bieżącej poprawki.

      

Szczegóły implementacji

W celu wsparcia możliwości wykrycia parametrów wymaganych przez wymagania hmrc zapobiegania oszustwom, takie jak strefa czasowa i adres MAC, w metodzie połączenia BATCH_PROCESS_DIRECT i wersji oprogramowania w metodach połączenia WEB_APP_VIA_SERVER i BATCH_PROCESS_DIRECT, w części aplikacji uwzględniono metody X++. Oto informacje o wersjach Dynamics 365 dla finansów i operacji, w tym następujące metody:

Dynamics 365 dla wersji Finanse i Operacje Numer kompilacji
10.0.1 10.0.51.30002
10.0.2 10.0.80.10022
10.0.3 10.0.107.0

W przypadku wersji 7.3 Dynamics 365 for Finance and Operations należy zainstalować 4504462 KB #.

W Dynamics 365 for Finance and Operations nagłówki żądań składają się w formacie "MTD VAT web request headers format (UK)" w module Raporty elektroniczne (ER). Aby wspierać nagłówki zapobiegania oszustwom, ta konfiguracja formatu została rozszerzona o niezbędne węzły:

image.png

Określenie odpowiednich wartości nagłówków jest obsługiwane przez wywołanie metod X++ przez konfigurację "mapowania modelu PODATKU MTD". "Model struktury wiadomości elektronicznych" został również rozszerzony o węzły używane do mapowania wartości nagłówków zapobiegania oszustwom.

Konfigurowanie

Aby aktywować przenoszenie nagłówków zapobiegania oszustwom podczas współdziałania z interfejsem API HMRC, zaimportuj z portalu LCS następujące wersje wyższych wersji następujących konfiguracji ER:

⁠#⁠ Nazwa konfiguracji GER Type (Typ) Wersja
1 Model struktury wiadomości elektronicznych Model 22
2 Mapowanie modelu PODATKU VAT MTD (Zjednoczone Królestwo) Mapowanie modelu (eksportowanie, importowanie) 22.25
3 Format nagłówków żądań internetowych mtd vat (Wielka Brytania) Formatowanie (eksportowanie) 22.13

      

Ważna uwaga! Po zaimportowaniu nowych wersji konfiguracji ER sprawdź, czy następujące konfiguracje są oznaczone jako Domyślne dla mapowania modeli:

  • Mapowanie modelu deklaracji podatkowej
  • Mapowanie modelu PODATKU VAT MTD (Zjednoczone Królestwo)

Po zaimportowaniu wspomnianych lub wyższych wersji konfiguracji ER parametry zapobiegania oszustwom zostaną przesłane jako część żądania HTTP HMRC.

Gdy użytkownik inicjuje wniosek do HMRC bez aktywowania zadania wsadowego, następujące okno dialogowe poinformuje o tym, jakie informacje zostaną wysłane do HMRC:

image.png

Jeśli użytkownik przerwa przesyłanie na tym etapie przez kliknięcie przycisku Anuluj w oknie dialogowym, transmisja zostanie anulowana, a stan wiadomości elektronicznej zostanie zmieniony na "Błąd", dołączony opis błędu do dziennika akcji będzie zawierać informacje, że "Żądanie do HMRC zostanie anulowane przez użytkownika". Użytkownik będzie mógł kontynuować przesyłanie tej samej wiadomości elektronicznej za pomocą przycisku "Wyślij raport".

Gdy użytkownik inicjuje wniosek do HMRC w zadaniu wsadowym, nagłówki zapobiegania oszustwom zostaną przesłane do HMRC, a informacje o tym, jakie nagłówki zostały wysłane, zostaną dołączone do zadania wsadowego. Otwórz administrację> systemu Badaniezadań wsadowych>, wybierz zadanie wsadowe i przejrzyj szczegóły komunikatu dziennika (dziennik zadań > wsadowych okienka > akcji).

Jeśli z jakiegoś powodu firma zdecyduje się zwrócić się do HMRC bez przekazywania nagłówków zapobiegania oszustwom, wersja formatu, w tym nagłówki zapobiegania oszustwom, może zostać w ogóle usunięta lub nie zaimportowana lub alternatywnie te nagłówki mogą być wyłączone w formacie "MTD VAT request headers format (UK)" w module Raportowanie elektroniczne. W tym celu należy wykonać następujące czynności:

  1. Wybierz pozycję "MTD VAT web request headers format (UK)" w drzewie konfiguracji funkcji ER i utwórz format podrzędny, wywodząc go (zobacz więcej informacji o "Konstruowaniu formatu wybierającego inny format jako podstawę").
  2. Otwórz format podrzędny w Designer (przycisk Designer okienko Akcja funkcji ER).
  3. Wybierz węzeł "Gov-Client-Connection-Method" i ustaw parametr "Enabled" na "false":

image.png

4. Powtórz p.3 dla innych nagłówków zapobiegania oszustwom: Gov-Client-Timezone, Gov-Client-User-Agent, Gov-Vendor-Version, Gov-Client-MAC-Addresses.

5. Zapisz konfigurację i zakończ ją.

6. Otwórzustawienia usługi elektronicznejkonfiguracji>podatkowej> usługi sieci Webraportowania> i wybierz format podrzędny w polu "Żądanie mapowania formatu nagłówków" wszystkich usług sieci Web używanych do współdziałania z hmrc zamiast formatu nadrzędnego używanego domyślnie:

image.png

Ważna uwaga! Wnioski o interfejs API bez nagłówków zapobiegania oszustwom mogą zostać odrzucone przez HMRC. Ściśle zaleca się adresy żądań API do HMRC z nagłówków zapobiegania oszustwom.

Informacje dotyczące poprawek

Instrukcje pobierania elektronicznej konfiguracji raportowania z usług cyklu życia: https://learn.microsoft.com/en-us/dynamics365/unified-operations/dev-itpro/analytics/download-electronic-reporting-configuration-lcs

Jak uzyskać pliki aktualizacji systemu Microsoft Dynamics AX

Ta aktualizacja jest dostępna do ręcznego pobrania i zainstalowania z Centrum pobierania Microsoft w wersji 7.3:

Wymagania wstępne

Aby zastosować tę poprawkę, musisz mieć zainstalowany jeden z następujących produktów:

  • Microsoft Dynamics 365 na potrzeby finansów i operacji (7.3)

Wymóg ponownego uruchomienia

Po zastosowaniu poprawki należy ponownie uruchomić usługę Application Object Server (AOS).

Jeśli napotkasz problem podczas pobierania, instalowania tej poprawki lub masz inne pytania dotyczące pomocy technicznej, skontaktuj się z partnerem lub, jeśli korzystasz z planu pomocy technicznej bezpośrednio z firmą Microsoft, możesz skontaktować się z pomocą techniczną dla oprogramowania Microsoft Dynamics i utworzyć nowy wniosek o pomoc techniczną. Aby to zrobić, odwiedź następującą witrynę internetową firmy Microsoft:

https://mbs.microsoft.com/support/newstart.aspx

Możesz również skontaktować się z pomocą techniczną w zakresie oprogramowania Microsoft Dynamics telefonicznie, korzystając z tych linków w przypadku numerów telefonów określonych w danym kraju. Aby to zrobić, odwiedź jedną z następujących witryn internetowych firmy Microsoft:

Partnerzy

https://mbs.microsoft.com/partnersource/resources/support/supportinformation/Global+Support+Contacts

Klienci

https://mbs.microsoft.com/customersource/northamerica/help/help/contactus

W specjalnych przypadkach opłaty, które są zwykle naliczane za połączenia z pomocą techniczną, mogą zostać anulowane, jeśli specjalista pomocy technicznej w zakresie oprogramowania Microsoft Dynamics i produktów pokrewnych stwierdzi, że określona aktualizacja rozwiąże problem. Typowe koszty pomocy technicznej będą miały zastosowanie do wszelkich dodatkowych pytań dotyczących pomocy technicznej i problemów, które nie kwalifikują się do określonej aktualizacji.