FEL غواتيمالا مع SAP Business One: كيف يعمل الاعتماد، والتحقق من NIT، والمستندات التي تحتاجها
بقلم زين عباس, كودينوفا · آخر تحديث
لا تسمح غواتيمالا بإرسال الفواتير مباشرة إلى الجهة الضريبية. كل مستند يمر أولًا عبر جهة اعتماد (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 التي يُنشئها المُصدِرون. عمليًا، جهة الاعتماد:
- تستلم ملف XML الخاص بك.
- تفحصه وفق Reglas y Validaciones (القواعد وعمليات التحقق) الصادرة عن SAT.
- تضع توقيعها الإلكتروني المتقدم.
- تخصص رقم الاعتماد.
- ترسل المستند DTE المعتمد إليك وإلى SAT.
أنت من يختار جهة الاعتماد ويتعاقد معها. من الأسماء المعروفة Infile (المزوّد الذي يتصل به توطين Odoo لغواتيمالا)، وDigifact التي تنشر حزم SDK خاصة بها، وMegaprint التي ربطناها بـ SAP Business One. تنشر SAT القائمة الحالية لجهات الاعتماد المرخّصة على بوابتها. راجعها قبل أن توقّع أي شيء، لأن لكل جهة اعتماد واجهتها البرمجية وبيانات اعتمادها وأسعارها.
أنواع مستندات DTE
لكل مستند رمز قصير في ملف XML. هذه هي الأنواع التي ستصادفها أكثر من غيرها:
| الرمز | المستند | المصدر المعتاد في SAP B1 |
|---|---|---|
| FACT | Factura (فاتورة) | فاتورة مبيعات |
| FCAM | Factura cambiaria (فاتورة آجلة) | فاتورة مبيعات بشروط ائتمان (تحتاج شروط دفع) |
| FPEQ | Factura pequeño contribuyente | فاتورة مبيعات لمُصدِرين في نظام صغار المكلّفين |
| FCAP | Factura cambiaria pequeño contribuyente | بيع آجل من مكلّف صغير |
| FESP | Factura especial (فاتورة خاصة) | يُصدرها المشتري عند الشراء من شخص لا يُصدر فواتير |
| NCRE | Nota de crédito (إشعار دائن) | إشعار دائن للمبيعات، مع إشارة إلى المستند DTE الأصلي |
| NDEB | Nota de débito (إشعار مدين) | إشعار مدين، مع إشارة إلى المستند DTE الأصلي |
| NABN | Nota de abono | قيد دائن لحساب العميل |
| RECI | Recibo (إيصال) | إيصال |
| RDON | Recibo 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 كتزال.
سير الاعتماد خطوة بخطوة
- يرحّل المستخدم المستند في SAP B1. تُحفظ فاتورة المبيعات أو الإشعار الدائن بشكل عادي.
- يُنشئ التكامل ملف XML. الرأس، والمُصدِر، والمستلِم، والأصناف، والضرائب، والعبارات (frases) وأي ملحقات (آجلة، تصدير، إشارة إلى المستند الأصلي).
- يُرسل XML إلى الواجهة البرمجية لجهة الاعتماد. باستخدام اسم المستخدم والرمز (token) الخاصين بك لدى جهة الاعتماد تلك.
- تتحقق جهة الاعتماد وتوقّع. إذا فشلت قاعدة، يعود إليك خطأ ولا يُعتمد شيء.
- يُخصص UUID. يبدو رقم الاعتماد هكذا:
dbb51ae2-3a62-4437-b8e9-42ecfb761156. - تُشتق السلسلة والرقم من UUID. السلسلة هي أول 8 أحرف سداسية عشرية (
dbb51ae2). والرقم هو القيمة العشرية للأحرف من 9 إلى 16 دون شرطات (3a624437←979518519). - يُرسل المستند DTE إلى SAT. تفحصه SAT وتسجّل القبول أو الرفض.
- يكتب التكامل النتيجة. يُحفظ 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 لديك وجهة الاعتماد وأنواع المستندات التي تُصدرها.
المصادر
- SAT غواتيمالا: التوثيق التقني لنظام FEL
- SAT غواتيمالا: الفاتورة الإلكترونية المباشرة، العرض العام 2018 (مستضاف لدى USAC)
- Deloitte غواتيمالا: نشرة ضريبية عن FEL (Acuerdo de Directorio 13-2018)
- EY: غواتيمالا، تعديلات جديدة على متطلبات المستندات الضريبية (Acuerdo Gubernativo 245-2022)
- EDICOM: كيف يعمل FEL، الفاتورة الإلكترونية المباشرة في غواتيمالا
- Prensa Libre: إلغاء المستندات الضريبية الإلكترونية
- توثيق Odoo: التوطين الضريبي لغواتيمالا
خدمات ذات صلة
أسئلة شائعة
ما هي جهة الاعتماد (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 ساعة.
