مقدمة
في 13 يوليو 2017، أعلنت المديرية المالية للخزانة والمشرف العام في المملكة المتحدة أن جعل الضريبة رقمية (MTD) لضريبة القيمة المضافة (VAT) ست دخل حيز التنفيذ في 1 أبريل 2019.
لدعم متطلبات ضريبة القيمة المضافة MTD لضريبة القيمة المضافة على Dynamics AX 2012 R3، تم إصدار hotfix: KB 4488588.
بالإضافة إلى ذلك، فإن الإيرادات والجمارك (HMRC) الخاصة بها قد قدمت بشكل إلزامي لتوفير معلومات رأس API لضريبة القيمة المضافة من أبريل 2019 لمنع الاحتيال. لمزيد من المعلومات، راجع منع الاحتيال. يتم دعم رؤوس منع الاحتيال في Dynamics AX 2012 R3 مع 4505299 KB4539848.
نظرة عامة
توفر ميزة hotfix الحالية التغييرات التالية في ميزة ضريبة القيمة المضافة MTD في Dynamics AX 2012 R3:
1. تضمين معلمات منع الاحتيال في علامة التبويب عام في نموذج معلمات خدمة ويب يتم وضع علامة عليها بشكل افتراضي ومعطل دائما. وهذا يعني أنه سيتم دائما إرسال رؤوس منع الاحتيال كجزء من طلبات HTTPS إلى MTD VAT API ل HMRC. ولا يسمح بإرسال طلبات إلى API لضريبة القيمة المضافة MTD ل HMRC بدون رؤوس منع الاحتيال. يمكنك معرفة المزيد حول هذا المتطلب في إرسال بيانات منع الاحتيال - مركز مطوري HMRC.
2. يتم الآن دعم المتطلبات الأخيرة لراوي منع الاحتيال التي تنشرها HMRC (الإصدار 3.0) https://developer.service.hmrc.gov.uk/guides/fraud-prevention/getting-it-right/#change-log. ابحث عن مزيد من التفاصيل لاحقا في KB هذا.
3. يتم تقديم خدمات ويب خارجية جديدة لتحديد نموذج عناوين IP. يمكن الوصول إليه باستخدام الزر خدمات ويب الخارجية على علامة التبويب منع الاحتيال في نموذج معلمات خدمة ويب. تسمح خدمات الويب الخارجية لتحديد عناوين IP للمستخدم (لدور مسؤول النظام) بتحديد عناوين HTTP(S) لخدمات الويب الخارجية التي تقوم بإرجاع عنوان IP العام للعميل الخادم.
ملاحظات:
-
(!) إشعار الخصوصية
-
عند تمكين AX 2012 R3 من Dynamics من التفاعل مع جعل الضريبة رقمية (MTD) لضريبة القيمة المضافة (VAT) API من الإيرادات والجمارك (HMRC) الخاصة بها في المهى، سيتم مشاركة كل من محتوى العميل والبيانات الشخصية مع HMRC، كجزء من إرسال معلومات ضريبة القيمة المضافة إلى تقرير جعل الضريبة رقمية (MTD) الخاصة بضريبة القيمة المضافة. قد يتضمن ذلك معلومات الموقع ومعرفات شخصية أخرى مثل عناوين IP. لمعرفة المزيد حول أنواع المعلومات المضمنة في عملية الإرسال، يمكنك عرض متطلبات HMRC على موقع HMRC علىالويب. يمكن تعطيل التشغيل التفاعلي مع خدمة ويب الخاصة ب HMRC بواسطة مسؤول النظام من داخل نموذج تطبيقات ويب عن طريق إلغاء تنشيط تطبيق نوع الإنتاج. خصوصيتك مهمة بالنسبة لنا. لمعرفة المزيد اقرأ إشعار الخصوصية وملفات تعريف الارتباط.
4. الزر "تعبئة" ضمن علامة التبويب "منع الاحتيال" في نموذج معلمات خدمة ويب ينشئ الآن ثلاثة رؤوس فقط: Gov-Client-Public-IP و Gov-Vendor-Public-IP و Gov-Vendor-Forwarded. لا يزال يمكن للمستخدم إضافة رؤوس أخرى يدويا باستخدام أزرار إضافة/إزالة وتحديد قيم لها يدويا. لن يستخدم النظام هذه القيم إلا في حالة عدم إمكانية تجميع القيم الخاصة بها تلقائيا.
5. تم تغيير خوارزمية تجميع البيانات لرمز منع الاحتيال: يقوم النظام بتجميع المعلومات الخاصة بالرأس تلقائيا وفي حالة عدم إمكانية تجميع قيمة لبعض رؤوس المعلومات تلقائيا، سيتم استخدام القيم المعرفة يدويا على علامة التبويب منع الاحتيال في نموذج معلمات خدمة ويب للتقديم إلى HMRC.
هام:
-
(!) ملاحظة
-
في 9 يوليو 2021، تم إنشاء سرية عميل جديدة ل Dynamics AX 2012 R3 ونشرها في مكتبة الأصول المشتركة في مدخل LCS - UK_MTD_VAT_AX2012R3_ProdApll_20210709.zip. انتقل إلى قسم حزمة البيانات في مكتبة الأصول المشتركة لتنزيل الحزمة إلى مساحة التخزين المحلية.
-
-
بعد تنزيل UK_MTD_VAT_AX2012R3_ProdApll_20210709.zip من LCS، قم باستيراد سر العميل الجديد إلى Dynamics AX 2012 R3 كما هو موضح في "إعدادتطبيق ويب للإنتاج استخدام " فقرة من KB 4488588.
-
-
تأكد من أنه يمكن تحديث رمز الوصول المميز بنجاح بالسر الجديد. استخدم الزر "تحديث رمز الوصول المميز" في جزء "الإجراءات" من "دفتر الأستاذ العام" > إعداد > نموذج "الخدمات الخارجية" >ويب في AX لبدء تحديث رمز الوصول المميز يدويا.
-
تأكد من وضع علامة على خانة الاختيار نشط لتطبيق الويب الخاص بنوع الإنتاج، الذي قمت باستيراد سري عميل جديد له.
تفاصيل Hotfix
المعلمة "تضمين معلمات منع الاحتيال"
تم 4505299 KB بتضمين معلمات منع الاحتيال في علامة التبويب عام في نموذج معلمات خدمة ويب. يجعل التحديث الحالي هذه المعلمة دائما معلمة بشكل افتراضي ومعطل. وهذا يعني أنه سيتم دائما إرسال رؤوس منع الاحتيال كجزء من طلبات HTTPS إلى API لضريبة القيمة المضافة MTD ل HMRC. ولا يسمح بإرسال طلبات إلى API لضريبة القيمة المضافة MTD ل HMRC بدون رؤوس منع الاحتيال. يمكنك معرفة المزيد حول هذا المتطلب في إرسال بيانات منع الاحتيال - مركز مطوري HMRC.
رؤوس منع الاحتيال الإصدار 3.0
يتم دعم أحدث المتطلبات لراوي منع الاحتيال، الإصدار 3.0 الذي يتم نشره بواسطة HMRC https://developer.service.hmrc.gov.uk/guides/fraud-prevention/getting-it-right/#change-log في Dynamics AX 2012 R3 باستخدام hotfix الحالي.
يمكنك العثور على مزيد من التفاصيل حول كيفية دعم Dynamics AX 2012 R3 لكل رؤوس منع الاحتيال في الجدول أدناه:
رأس HTTP |
الوصف |
تفاصيل التنفيذ |
Gov-Client-connection-Method |
قيمة ثابتة: DESKTOP_APP_VIA_SERVER |
قيمة ثابتة |
Gov-Client-Device-ID |
معرف فريد لجهاز منشئ. تم تحديث تنسيق الرأس لاحتواء المتطلبات الأخيرة ل HMRC. |
معرف تلقائيا بواسطة النظام باستخدام قيمة من سجل النظام: HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\HMRC |
Gov-Client-Local-IPs |
قائمة بكل عناوين IP المحلية (IPv4 و IPv6) المتوفرة للجهاز الذي تم إنشاءه. |
معرف تلقائيا بواسطة النظام باستخدام وظائف System.Net.IPHostEntry و System.Net.IPAddress. في حال لم يتم تعريف عناوين IP المحلية تلقائيا، سيتم جمع القيمة الثابتة المرتبطة برأس "Gov-Client-Local-IPs" مننموذج" إعداد رؤوس منع الاحتيال الملحقة " وسترسل إلى HMRC. |
Gov-Client-Local-Ips-Timestamp |
يكون الوقت هو الوقت الذي يتم فيه تجميع Gov-Client-Local-IPs. |
يتم تعريفها تلقائيا بواسطة النظام كقيمة DateTime بتنسيق yyyy-MM-ddTHH:mm:ss.fffZ |
Gov-Client-MAC-Addresses |
قائمة عناوين MAC المتوفرة على الجهاز الذي تم إنشاءه. |
معرف تلقائيا بواسطة النظام باستخدام:
|
Gov-Client-Multi-Factor |
قائمة ببنيات بيانات ذات قيمة أساسية تحتوي على تفاصيل حول حالة المصادقة متعددة العوامل (MFA) المرتبطة بمكاتب API. |
تم حذفه ل Dynamics AX 2012 R3. إذا كان النظام يدعم MFA باستخدام تخصيص، فحدد الخوارزمية الضرورية للرأس لكي يتم نقله بشكل صحيح إلى HMRC. |
Gov-Client-Public-IP |
عنوان IP العام (IPv4 أو IPv6) الذي يقوم الجهاز المنشئ منه ب تقديم الطلب. |
يتم تعريفها تلقائيا عن طريق الاتصال بالخدمات الخارجية على الويب، التي تقوم بإرجاع قيمة عنوان IP العام. يمكنك العثور على مزيد من المعلومات في قسم"خدمات الويب الخارجيةلتحديد عناوين IP" في مقالة KB هذه. |
Gov-Client-Public-Ip-Timestamp |
اظهار الوقت عند تجميع Gov-Client-Public-IP. |
يتم تعريفها تلقائيا بواسطة النظام كقيمة DateTime بتنسيق yyyy-MM-ddTHH:mm:ss.fffZ. |
Gov-Client-Public-Port |
منفذ TCP العام الذي يستخدمه الجهاز الأصل عند بدء الطلب. |
تم حذفه ل Dynamics AX 2012 R3. |
Gov-Client-Screens |
المعلومات المتعلقة شاشات الجهاز الذي تم إنشاءه. تتضمن الحقول (عرض الشاشة وارتفاع الشاشة وعامل تغيير حجم الشاشة وعمق لون الشاشة). |
معرف تلقائيا بواسطة النظام باستخدام:
|
Gov-Client-Timezone |
المنطقة الزمنية المحلية للجهاز الذي تم إنشاءه. |
معرف تلقائيا بواسطة النظام باستخدام xGlobal::machineTzDisplayName() |
Gov-Client-User-Agent |
محاولة لتحديد عائلة نظام التشغيل والإصدار وصنعة الجهاز ونموذج الجهاز الأصلي. |
يتم تعريفها تلقائيا بواسطة النظام عن طريق تشغيل cmd.exe مع الأوامر:
|
Gov-Client-User-IDs |
بنية بيانات ذات قيمة أساسية تحتوي على معرفات المستخدم. |
معرف تلقائيا بواسطة النظام: WinAPI::getUserName() |
Gov-Client-Window-Size |
عدد وحدات البكسل للنافذة على الجهاز الأصلي حيث بدأ المستخدم استدعاء واجهة برمجة المستخدم (بشكل مباشر أو غير مباشر) إلى HMRC. |
معرف تلقائيا بواسطة النظام: WinAPI::getWindowRect |
Gov-Vendor-License-IDs |
بنية بيانات ذات قيمة أساسية لمفاتيح التراخيص المفصلة المتعلقة برامج المورد التي تبدأ طلب API على الجهاز المصدر. |
يتم تحديدها وتقريبها تلقائيا بواسطة النظام: xSysConfig::find(ConfigType::SerialNo, 0) |
Gov-Vendor-Product-Name |
اسم المنتج الذي تم تسويقه للمستخدمين النهائيين. |
معرف تلقائيا بواسطة النظام: xInfo::p roductName() |
Gov-Vendor-Public-IP |
عنوان IP العام للخادم الذي أرسل الجهاز الأصل طلباته له. |
يتم تعريفها تلقائيا عن طريق الاتصال بالخدمات الخارجية على الويب، التي تقوم بإرجاع قيمة عنوان IP العام. يمكنك العثور على مزيد من المعلومات في قسم"خدمات الويب الخارجيةلتحديد عناوين IP" في مقالة KB هذه. |
Gov-Vendor-Forwarded |
قائمة تتضمن تفاصيل القفزات عبر الإنترنت بين الخدمات التي تنهي TLS. |
يتم تعريفها تلقائيا بواسطة النظام كقيمة مكونة من قيم تم تجميعها ل Gov-Client-Public-IP و Gov-Vendor-Public-IP |
Gov-Vendor-Version |
بنية بيانات ذات قيمة أساسية لإصدارات البرامج المتدخلة في معالجة طلب. |
معرف تلقائيا بواسطة النظام: ApplicationVersion::buildNo()) |
خدمات الويب الخارجية لتحديد عنوان IP
استخدم خدمات ويب خارجية جديدة لتحديد نموذج عناوين IP لتعريف http(es) لخدمات الويب التي سيتم استدعاها للحصول على عنوان IP للعميل الخادم وإرساله إلى MTD API الخاص ب HMRC. لا يتم حفظ عنوان IP الذي يتم تجميعه للعميل أو الخادم في النظام ويرسل إلى HMRC مباشرة بعد تجميعها. وبالتالي، عندما يقوم مستخدم الأعمال ببدء طلب إلى HMRC (على سبيل المثال، لإرسال معلومات التزامات ضريبة القيمة المضافة أو استردادها)، يرسل النظام تلقائيا (ومخفيا من مستخدم الأعمال) الطلب (الخدمات) إلى خدمات الويب الخارجية المعرفة في خدمات الويب الخارجية لتحديد نموذج عناوين IP للحصول على عنوان IP عام للعميل وخادم. يضاف على الفور عنوان IP العام للعميل وخادم طلب العمل (Gov-Client-Public-IP و Gov-Vendor-Public-IP و Gov-Vendor-Forwarded) وينقل الطلب إلى HMRC.
يقرر مسؤول النظام خدمة الويب الخارجية التي يمكن استخدامها لغرض الحصول على عناوين IP عامة للعميل و الخادم. الرجوع إلى (!) إشعار الخصوصية في القسم نظرة عامة من مقالة KB هذه. يمكنك تحديد العديد من خدمات الويب الخارجية وستسمى بالتالي بالترتيب المحدد حتى يتم الحصول على عنوان IP بتنسيق IPv4 أو IPv6.
لتعريف خدمات ويب خارجية، انقر فوق الزر خدمات ويب خارجية في علامة التبويب منع الاحتيال في نموذج معلمات خدمة ويب. في حال لم يتم الحصول على IP العام من أي خدمة ويب خارجية، سيتم جمع القيمة الثابتة ذات الصلة برأس "Gov-Client-Public-IP" من علامة التبويب"منع الاحتيال" وسترسل إلى HMRC.
الزر "ملء" على علامة التبويب "منع الاحتيال" في نموذج "معلمات خدمة الويب"
الزر "تعبئة" على علامة التبويب "منع الاحتيال" في نموذج معلمات خدمة ويب مع وجود علامة الضبط الحالية ينشئ ثلاثة رؤوس فقط: Gov-Client-Public-IP و Gov-Vendor-Public-IP و Gov-Vendor-Forwarded. لا يزال يمكن للمستخدم إضافة رؤوس أخرى يدويا باستخدام الزرين "إضافة" و"إزالة" على الشبكة وتحديد قيم رؤوس تم إنشاؤها يدويا. لن يستخدم النظام هذه القيم إلا في حالة عدم إمكانية تجميع القيم الخاصة بها تلقائيا.
خوارزمية تجميع البيانات لرأس منع الاحتيال
تم تغيير خوارزمية تجميع البيانات لرأس منع الاحتيال. يجمع النظام المعلومات الخاصة بالرأس تلقائيا وفي حالة عدم إمكانية تجميع قيمة لبعض رؤوس الرأس تلقائيا، سيتم استخدام القيم المعرفة يدويا على علامة التبويب منع الاحتيال في نموذج معلمات خدمة ويب للتقديم إلى HMRC.
نوصي باستخدام الزر التحقق من صحة علامة التبويب منع الاحتيال في نموذج معلمات خدمة ويب للتحقق من كيفية عمل النظام على تجميع كل المعلومات لمنع الاحتيال والتأكد من تجميع القيم لكل رؤوس منع الاحتيال بنجاح. يسمح فقط بحذف رؤوس Gov-Client-Multi-Factor و Gov-Client-Public-Port ل Dynamics AX 2012 R3.
لكي تتمكن من التحقق من صحة رؤوس منع الاحتيال باستخدام اختبار API ل HMRC،يجب أن تكون مسجلا على مدخل HMRC كمطور ، وأنشئ تطبيق الحماية واشترك فيه في "اختبار API لراوي منع الاحتيال". يمكنك العثور على مزيد من المعلومات حول التحقق من صحة رؤوس منع الاحتيال من Dynamics AX 2012 R3 في KB 4539848.