مدقق JSON لمستندات DTE في السلفادور
الصق أو ارفع ملف JSON لمستند DTE واعرف ما الذي قد ترفضه وزارة المالية (Ministerio de Hacienda): حقول المخطط، ورقم التحكم، و NIT و DUI، وضريبة IVA، والضرائب (tributos)، والإجماليات ضمن هامش التسامح ±0.01 (holgura).
الأداة
يعمل في متصفحك. لا يتم رفع الملف إلى أي مكان.
الأخطاء الشائعة وطريقة إصلاحها
عشرة أسباب للرفض مأخوذة من مخططات JSON الرسمية لـ MH ومن Manual Funcional del Sistema de Transmisión v2.0.
| القاعدة | ما الخطأ | طريقة الإصلاح |
|---|---|---|
| المخطط · required | يُحذف حقل لأنه لا ينطبق. | أرسل كل حقول المخطط؛ واستخدم null عندما لا تنطبق القيمة. |
| المخطط · additional | يُرسل حقل من نوع أو إصدار آخر (مثل حقول v1 في Factura v2). | أنشئ كل نوع بقائمة الحقول الخاصة بإصدار مخططه الحالي. |
| القسم XI | لا يتبع numeroControl الصيغة DTE-01-M001P001-000000000000001. | كوّنه من النوع والمنشأة ونقطة البيع وتسلسل من 15 رقمًا. |
| المخطط · pattern | codigoGeneracion بأحرف صغيرة أو ليس UUID. | أنشئ UUID بأحرف كبيرة لكل مستند. |
| القسم XXI | خانات عشرية كثيرة: البنود تسمح بـ 8، والملخص يسمح بـ 2. | قرّب قيم البنود إلى 8 خانات عشرية وقيم الملخص إلى خانتين. |
| القسم XXI | إجماليات الملخص تختلف عن البنود بأكثر من سنت واحد. | أعد حساب الملخص من البنود المقرّبة. |
| IVA | حساب IVA بطريقة خاطئة: Factura تتضمن IVA، أما CCF والإشعارات فلا. | Factura: ivaItem = gravada × 13/113. CCF/الإشعارات: IVA = (gravada − descuento) × 13% في tributos بالرمز 20. |
| القسم XIV | ضريبة (tributo) مستخدمة في البنود غير موجودة في resumen.tributos. | أدرج رمز كل tributo مرة واحدة في الملخص بالمبلغ المجمّع. |
| القسم XV | Nota de crédito أو débito دون مستند CCF المرتبط، أو بنود تشير إلى مستند آخر. | أضف المستند الأصلي في documentoRelacionado وأشر إليه في كل بند. |
| NIT / DUI | DUI للمستلم برقم تحقق خاطئ، أو NIT ليس من 14 رقمًا. | تحقق من أرقام الهوية عند إنشاء العميل في نظام ERP. |
كيف تتحقق من صلاحية مستند DTE لدى وزارة المالية
يفحص هذا المدقق البنية وحقول المخطط والإجماليات في ملف JSON لمستند DTE قبل إرساله. لا يستعلم من وزارة المالية ولا يستطيع إخبارك بما إذا كانت MH قد استلمت مستندًا.
للتحقق من مستند DTE استلمته، افتح صفحة الاستعلام العام لـ MH («Consulte su DTE» على factura.gob.sv) وأدخل القيمتين المطلوبتين: تاريخ الإنشاء (fecha de generación) ورمز الإنشاء (código de generación)، وهو UUID الموجود في قسم identificacion من ملف JSON. ويحمل مستند DTE المُرسل إلى MH أيضًا ختم الاستلام (selloRecibido) الذي أعادته MH.
الاستعلام العام عن DTE لدى MH · تحقق من المشتري أولًا: التحقق من DUI و NIT.
المواصفات التي تفحص الأداة وفقها
- مخططات JSON من MH (anexo al Manual Técnico): fe-f-v2.json و fe-ccf-v4.json و fe-nc-v4.json و fe-nd-v4.json
https://factura.gob.sv/informacion-tecnica-y-funcional/ - Manual Funcional del Sistema de Transmisión v2.0 من MH (الأقسام XI و XIV و XV و XVIII و XXI)
https://factura.gob.sv/informacion-tecnica-y-funcional/ - catálogos del sistema de facturación v1.2 من MH
https://factura.gob.sv/informacion-tecnica-y-funcional/
تُحفظ ملفات المخطط مع الكود المصدري للأداة مع مجاميع SHA-256 الخاصة بها. تفحص هذه الأداة وفق المواصفات المنشورة من MH؛ وهي غير معتمدة من وزارة المالية ولا تابعة لها.
ثلاث خطوات بدون تسجيل
الصق ملف JSON أو ارفعه
استخدم مستند DTE الذي ينشئه نظامك قبل التوقيع، أو JWS الموقّع. الأنواع المدعومة: 01 و 03 و 05 و 06.
اقرأ التقرير
أخطاء المخطط والحسابات وقواعد العمل مجمّعة، ولكل منها مسار JSON وطريقة الإصلاح.
أصلحه قبل أن ترفضه MH
صحّح الحقل في SAP Business One أو نظام ERP لديك، وأعد إنشاء JSON وافحصه مرة أخرى. نزّل ملف PDF لفريقك.
أسئلة حول هذه الأداة
ما أنواع مستندات DTE وإصداراتها التي يفحصها؟
Factura (01، إصدار المخطط 2)، و Comprobante de Crédito Fiscal (03، الإصدار 4)، و Nota de Crédito (05، الإصدار 4)، و Nota de Débito (06، الإصدار 4)، باستخدام مخططات JSON التي تنشرها وزارة المالية على factura.gob.sv.
ماذا يفحص إلى جانب مخطط JSON؟
بادئة رقم التحكم، وأرقام التحقق في NIT و DUI، وأن مبلغ كل بند يساوي الكمية × السعر − الخصم، وضريبة IVA المضمّنة بنسبة 13/113 في Factura و 13% في CCF والإشعارات، وتجميع الضرائب (tributos) في الملخص، والمستندات المرتبطة في الإشعارات الدائنة والمدينة، وكل إجماليات الملخص ضمن هامش السنت الواحد (holgura) الوارد في Manual Funcional الصادر عن MH.
هل يتحقق من التوقيع أو ختم الاستلام (sello)؟
لا. يُفك ترميز JWS الموقّع لفحص محتواه، لكن لا يُتحقق من التوقيع ولا من ختم الاستلام (sello de recepción) الصادر عن MH. وحده نظام الإرسال في MH يعطي النتيجة الرسمية.
لماذا ترفض MH حقلًا يحذفه نظامي؟
تُدرج مخططات MH كل الحقول على أنها مطلوبة. عندما لا تنطبق قيمة ما، يجب إرسال الحقل بقيمة null. والحقول الإضافية غير الموجودة في إصدار المخطط تُرفض أيضًا.
هل يؤكد هذا المدقق أن MH قبلت مستند DTE؟
لا. يفحص فقط البنية وحقول المخطط والإجماليات في ملف JSON قبل إرساله، ولا يتصل أبدًا بوزارة المالية. أما استلام MH للمستند فلا تُظهره إلا MH نفسها، في صفحة الاستعلام العام، باستخدام تاريخ الإنشاء ورمز الإنشاء (código de generación).
هل هذه أداة رسمية من وزارة المالية؟
لا. كودينوفا غير تابعة لوزارة المالية (Ministerio de Hacienda). تفحص الأداة وفق المواصفات المنشورة من MH.
هل يُرفع مستند DTE الخاص بي إلى أي مكان؟
لا. يقرأ متصفحك ملف JSON ويفحصه، ويُنشأ ملف PDF فيه أيضًا. لا يُرسل أي شيء إلى كودينوفا أو إلى أي جهة أخرى.
مصممة لفرق SAP Business One
DTE السلفادور من SAP Business One؟
نربط SAP B1 بنظام الإرسال في MH: ملف JSON، والتوقيع، والإرسال، ووضع الطوارئ (contingencia)، والإبطال (invalidación). بسعر ثابت، وعادةً نرسل العرض خلال 24 ساعة.
