FEL غواتيمالا مع SAP Business One: كيف يعمل الاعتماد، والتحقق من NIT، والمستندات التي تحتاجها

بقلم زين عباس, كودينوفا · آخر تحديث

الإجابة المختصرةفي نظام FEL في غواتيمالا، يُنشئ SAP Business One كل فاتورة بصيغة XML ويرسلها إلى جهة اعتماد (certificador) مرخّصة من SAT. تتحقق جهة الاعتماد منها، وتضع توقيعها الإلكتروني المتقدم، وتعيد رقم اعتماد UUID تُشتق منه السلسلة (serie) والرقم (número)، ثم يُرسل المستند DTE إلى SAT. أهم ما في الأمر بيانات المشتري النظيفة: رقم NIT أو CUI صالح، أو CF فقط للمبيعات التي تقل عن 2,500 كتزال.

لا تسمح غواتيمالا بإرسال الفواتير مباشرة إلى الجهة الضريبية. كل مستند يمر أولًا عبر جهة اعتماد (certificador). هذا الخيار التصميمي الواحد يحدد طريقة عمل تكامل SAP Business One، ومن أين تأتي الأخطاء، ومن تتصل به عندما يتعطل شيء. يغطي هذا الدليل النظام والمستندات وقواعد NIT وسير العمل، من منظور شخص ربط SAP B1 به فعليًا.

نظام FEL باختصار

FEL اختصار لـ Factura Electrónica en Línea (الفاتورة الإلكترونية المباشرة). أنشأته SAT بموجب Acuerdo de Directorio 13-2018 المنشور في 2 مايو 2018، والذي حلّ محل نظام FACE الأقدم. أدخلت SAT المكلّفين على مجموعات، ووفقًا لـ EDICOM اكتمل الانتقال في 1 يوليو 2023.

الأطراف الرئيسية:

الطرفالدور
Emisor (المُصدِر)شركتك. تُنشئ المستند الضريبي الإلكتروني DTE (documento tributario electrónico) بصيغة XML
Certificador (جهة الاعتماد)مرخّصة من SAT. تتحقق وتوقّع وتخصص رقم الاعتماد
SATتستلم المستند DTE المعتمد، وتجري فحوصاتها الخاصة، وتتيحه للاستعلام
Receptor (المستلِم)عميلك. يستلم المستند DTE ويمكنه التحقق منه لدى SAT

ماذا تفعل جهة الاعتماد

تعرّف SAT جهة الاعتماد بأنها الشخص أو الشركة التي ترخّص لها اعتماد مستندات DTE التي يُنشئها المُصدِرون. عمليًا، جهة الاعتماد:

  1. تستلم ملف XML الخاص بك.
  2. تفحصه وفق Reglas y Validaciones (القواعد وعمليات التحقق) الصادرة عن SAT.
  3. تضع توقيعها الإلكتروني المتقدم.
  4. تخصص رقم الاعتماد.
  5. ترسل المستند DTE المعتمد إليك وإلى SAT.

أنت من يختار جهة الاعتماد ويتعاقد معها. من الأسماء المعروفة Infile (المزوّد الذي يتصل به توطين Odoo لغواتيمالا)، وDigifact التي تنشر حزم SDK خاصة بها، وMegaprint التي ربطناها بـ SAP Business One. تنشر SAT القائمة الحالية لجهات الاعتماد المرخّصة على بوابتها. راجعها قبل أن توقّع أي شيء، لأن لكل جهة اعتماد واجهتها البرمجية وبيانات اعتمادها وأسعارها.

أنواع مستندات DTE

لكل مستند رمز قصير في ملف XML. هذه هي الأنواع التي ستصادفها أكثر من غيرها:

الرمزالمستندالمصدر المعتاد في SAP B1
FACTFactura (فاتورة)فاتورة مبيعات
FCAMFactura cambiaria (فاتورة آجلة)فاتورة مبيعات بشروط ائتمان (تحتاج شروط دفع)
FPEQFactura pequeño contribuyenteفاتورة مبيعات لمُصدِرين في نظام صغار المكلّفين
FCAPFactura cambiaria pequeño contribuyenteبيع آجل من مكلّف صغير
FESPFactura especial (فاتورة خاصة)يُصدرها المشتري عند الشراء من شخص لا يُصدر فواتير
NCRENota de crédito (إشعار دائن)إشعار دائن للمبيعات، مع إشارة إلى المستند DTE الأصلي
NDEBNota de débito (إشعار مدين)إشعار مدين، مع إشارة إلى المستند DTE الأصلي
NABNNota de abonoقيد دائن لحساب العميل
RECIRecibo (إيصال)إيصال
RDONRecibo por donaciónإيصال تبرع

تستخدم الصادرات فاتورة FACT مع ملحق تصدير. وتحمل الإشعارات الدائنة والمدينة ملحقًا يشير إلى المستند الأصلي، لذلك يجب أن يحتفظ التكامل بـ UUID لكل فاتورة معتمدة.

تحتاج معظم الشركات فقط إلى FACT و FCAM و NCRE وربما NDEB. نفّذ ما تُصدره فعلًا.

قواعد NIT و CUI و CF

تعريف المشتري يسبب رفضًا في FEL أكثر من أي شيء آخر.

  • NIT. ينتهي رقم NIT التقليدي برقم تحقق يُحسب بطريقة módulo 11. النتيجة 10 تُكتب K، لذلك أرقام NIT بشكل 1234567-K صالحة. تحقق منه قبل إنشاء شريك الأعمال، مثلًا بأداتنا المجانية لـ التحقق من NIT في غواتيمالا.
  • CUI. إذا لم يكن للمشتري رقم NIT، يستخدم المستند رقم CUI المكوّن من 13 رقمًا من بطاقة DPI. وتذكر الإرشادات المنشورة أيضًا أن أرقام NIT الصادرة للأفراد منذ 2023 مشتقة من CUI. لا تفرض قاعدة طول ثابتة من 8 أرقام في SAP B1.
  • CF. يمكن أن يحل Consumidor final (المستهلك النهائي) محل NIT فقط في المبيعات أو الخدمات التي تقل عن 2,500 كتزال، أو عن 500 كتزال للمياه والكهرباء والهاتف. يأتي هذا من Acuerdo Gubernativo 245-2022 الذي عدّل المادة 30 من لائحة ضريبة IVA.

في SAP B1 أنظف طريقة هي حفظ NIT في حقل الرقم الضريبي لشريك الأعمال دون شرطات، والإبقاء على عميل CF عام لمبيعات الكاونتر، ومنع الترحيل عندما تبلغ فاتورة CF مبلغ 2,500 كتزال.

سير الاعتماد خطوة بخطوة

  1. يرحّل المستخدم المستند في SAP B1. تُحفظ فاتورة المبيعات أو الإشعار الدائن بشكل عادي.
  2. يُنشئ التكامل ملف XML. الرأس، والمُصدِر، والمستلِم، والأصناف، والضرائب، والعبارات (frases) وأي ملحقات (آجلة، تصدير، إشارة إلى المستند الأصلي).
  3. يُرسل XML إلى الواجهة البرمجية لجهة الاعتماد. باستخدام اسم المستخدم والرمز (token) الخاصين بك لدى جهة الاعتماد تلك.
  4. تتحقق جهة الاعتماد وتوقّع. إذا فشلت قاعدة، يعود إليك خطأ ولا يُعتمد شيء.
  5. يُخصص UUID. يبدو رقم الاعتماد هكذا: dbb51ae2-3a62-4437-b8e9-42ecfb761156.
  6. تُشتق السلسلة والرقم من UUID. السلسلة هي أول 8 أحرف سداسية عشرية (dbb51ae2). والرقم هو القيمة العشرية للأحرف من 9 إلى 16 دون شرطات (3a624437 ← 979518519).
  7. يُرسل المستند DTE إلى SAT. تفحصه SAT وتسجّل القبول أو الرفض.
  8. يكتب التكامل النتيجة. يُحفظ UUID والسلسلة والرقم وتاريخ الاعتماد وملف XML الموقّع أو PDF على مستند SAP B1.

لأن السلسلة والرقم ليسا متسلسلين، لن يتطابق DocNum في SAP B1 مع رقم FEL أبدًا. يحتاج المستخدمون إلى رؤية الاثنين.

الطوارئ (Contingency)

يذكر العرض العام لنظام FEL الذي قدّمته SAT في 2018 أن جهة الاعتماد ترسل المستند DTE إلى SAT فورًا، أو خلال 24 ساعة في حالة الطوارئ، ويذكر إجراءً منفصلًا لإصدار المستندات في حالة الطوارئ. تفاصيل هذا الإجراء موجودة في التوثيق التقني لـ SAT وفي دليل جهة الاعتماد لديك.

بالنسبة لـ SAP B1 القاعدة العملية بسيطة. إذا لم تستجب جهة الاعتماد، علّم المستند بأنه معلّق، واحتفظ به في قائمة انتظار، وأعد المحاولة بالمستند نفسه. لا تدع مستخدمًا يعيد ترحيل الفاتورة «للمحاولة مرة أخرى»، وإلا ستعتمد البيع نفسه مرتين.

إلغاء مستند DTE (anulación)

لا يمكن حذف مستند DTE معتمد. وفقًا لإشعار من SAT نشرته Prensa Libre، منذ 1 سبتمبر 2023 يمكن إلغاء المستند DTE كحد أقصى حتى موعد استحقاق إقرار ضريبة IVA الشهري. بعد ذلك يُصدر البائع إشعارًا دائنًا NCRE يشير إلى الفاتورة الأصلية. يجب أن يرسل التكامل طلب الإلغاء إلى جهة الاعتماد ويحدّث حالة مستند SAP B1، لا أن يكتفي بإلغاء المستند في SAP.

كيف يتكامل SAP Business One مع FEL

لا يحتوي SAP B1 على اتصال FEL مدمج. الإعدادات الشائعة:

الخيارمتى يناسب
الإضافة الخاصة بجهة الاعتمادمستندات قياسية، شركة واحدة، تخصيص قليل
وسيط (Middleware) أو توطين من شريكعدة دول على تثبيت SAP B1 نفسه
تكامل مخصص (Service Layer أو DI API)مسارات مستندات خاصة، عدة قواعد بيانات، مراقبة خاصة بك

أيًّا كان اختيارك، تأكد أنه يغطي حقولًا معرّفة من قِبل المستخدم لـ UUID والسلسلة والرقم والحالة، وشاشة مراقبة للمستندات المعلقة والمرفوضة، وتصميم الفاتورة في Crystal Reports مع بيانات الاعتماد، والإشعار الدائن NCRE والإلغاء، وليس FACT فقط. تسرد صفحة FEL غواتيمالا النطاق الكامل الذي نسلّمه.

الأخطاء الشائعة وأسبابها الحقيقية

الخطأالسبب المعتادالحل
NIT inválido (رقم NIT غير صالح)خطأ كتابي، أو شرطة بقيت في الحقل، أو رقم تحقق خاطئتحقق من أرقام NIT باستخدام أداة التحقق من NIT عند إنشاء شريك الأعمال
NIT غير موجودرقم NIT يبدو صالحًا لكنه غير مسجل لدى SATاستعلم عن NIT عبر جهة الاعتماد قبل الترحيل
CF فوق الحدبيع كاونتر بقيمة 2,500 كتزال أو أكثر باستخدام CFامنع الترحيل في SAP B1 واطلب NIT أو CUI
رفض الإشعار الدائنإشارة مفقودة أو خاطئة إلى UUID الأصلياحفظ UUID على كل فاتورة وانسخه إلى الإشعار الدائن
خطأ في العبارة (frase) أو السيناريو (escenario)عبارات النظام الضريبي غير مهيأة للمُصدِروفّق العبارات مع تسجيلك لدى SAT ومع جهة الاعتماد
اعتماد مكررإعادة ترحيل يدوية بعد انتهاء المهلةأعد المحاولة بالمستند نفسه من قائمة انتظار، ولا تُعد الترحيل أبدًا

لا شيء من هذه غريب. كلها تأتي من البيانات الرئيسية ومنطق إعادة المحاولة، ولهذا نقضي وقتًا في عمليات التحقق داخل SAP B1 يعادل الوقت الذي نقضيه في استدعاء الواجهة البرمجية نفسه. إذا كنت تختار نهجًا، فاطّلع على خدمة تكامل الفوترة الإلكترونية.

نفّذت كودينوفا تكاملات FEL مع MegaPrint لـ SAP Business One في غواتيمالا والسلفادور. إذا كنت تخطط للتطبيق أو تعالج حالات رفض، تواصل معنا مع ذكر إصدار SAP B1 لديك وجهة الاعتماد وأنواع المستندات التي تُصدرها.

المصادر

خدمات ذات صلة

الأسئلة الشائعة

أسئلة شائعة

ما هي جهة الاعتماد (certificador) في FEL غواتيمالا؟

شخص أو شركة مرخّصة من SAT لاعتماد مستندات DTE التي يُنشئها المُصدِرون. تفحص جهة الاعتماد المستند وفق قواعد SAT، وتضيف توقيعها الإلكتروني المتقدم، وتخصص رقم الاعتماد، وترسل المستند DTE إلى SAT.

متى يمكنني استخدام CF (المستهلك النهائي) في فاتورة FEL؟

يسمح Acuerdo Gubernativo 245-2022 باستخدام CF فقط في المبيعات أو الخدمات التي تقل عن 2,500 كتزال، أو عن 500 كتزال للمياه والكهرباء والهاتف. فوق هذه المبالغ يجب تسجيل رقم NIT للمشتري، أو رقم CUI إذا لم يكن لديه NIT.

كيف تُخصص السلسلة (serie) والرقم (número) لفاتورة FEL؟

يُشتقان من UUID الذي تخصصه جهة الاعتماد. السلسلة هي أول 8 أحرف سداسية عشرية، والرقم هو القيمة العشرية للأحرف من 9 إلى 16، مع تجاهل الشرطات.

هل يمكنني إلغاء فاتورة FEL؟

نعم، عبر الإلغاء (anulación). يذكر إشعار من SAT نشرته صحيفة Prensa Libre أنه منذ 1 سبتمبر 2023 يمكن إلغاء المستند DTE كحد أقصى حتى موعد استحقاق إقرار ضريبة IVA الشهري. بعد ذلك تُصدر إشعارًا دائنًا (NCRE).

هل يدعم SAP Business One نظام FEL بنفسه؟

ليس مباشرة. تحتاج إلى تكامل أو إضافة تحوّل مستندات SAP B1 إلى صيغة XML الخاصة بـ SAT، وتستدعي الواجهة البرمجية لجهة الاعتماد، وتكتب UUID والسلسلة والرقم على المستند.

جاهز للبدء؟

أخبرنا بما تحتاجه. ستحصل على إجابة تقنية واضحة ونطاق عمل محدد وسعر ثابت، عادةً خلال 24 ساعة.