تكامل Excel و CSV
الفوترة الإلكترونية الإماراتية من Excel أو CSV — بدون ERP
إذا كانت فواتيرك تعيش في Excel أو Google Sheets أو تصدير CSV من نقطة بيع، تُحوّلها تراست بل إلى PINT-AE XML متوافق وتُرسلها إلى شبكة الهيئة عبر شريكنا مزوّد الخدمة المعتمد. لا SaaS محاسبة، لا هجرة ERP، لا كود — فقط رفع. مجاني لـ 50 فاتورة/شهر.
كيف يعمل مسار العمل Excel / CSV
ترفع كتاب عمل Excel (`.xlsx`) أو ملف CSV إلى تراست بل؛ تقرأ المنصة كل صف كفاتورة، وتحوّله إلى PINT-AE XML، وتتحقق من 51 حقلًا إلزاميًا للهيئة، وللصفوف التي تنجح — ترسل عبر مسار مزوّد الخدمة المعتمد لدينا. الصفوف التي تفشل في التحقق تظهر في قائمة انتظار الإصلاح وإعادة الإرسال مع تفسيرات أخطاء على مستوى الصف.
مسار العمل مصمم للفرق المالية التي تُنتج فواتيرها بالفعل في جداول البيانات ولا تريد إضافة ERP للحزمة فقط للتفويض. الأنماط الشائعة: شركات صغيرة على Google Sheets، شركات خدمات مهنية بعلامة تبويب فاتورة لكل مشروع، تجار تجزئة يُصدّرون تسويات POS الليلية كـ CSV، استشاريات محاسبة تُعدّ تشغيلات بالجملة لعدة أرقام TRN للعملاء في وقت واحد.
الرفع مضمون عبر رقم الفاتورة — إعادة رفع نفس الصف لا تُنشئ إرسالًا مكررًا. التصحيحات تُعيد الإرسال فقط للصفوف المُصحّحة.
قالب Excel / CSV من تراست بل
تنشر تراست بل قالب جدول بيانات أساسي يُطابق 1:1 قاموس بيانات PINT-AE. حمّله، عبّئ الصفوف ببيانات فواتيرك، ارفعه، وتراست بل تتعامل مع الباقي. القالب يُغطي جميع حقول PINT-AE الإلزامية بالإضافة إلى الحقول الشرطية الشائعة (علم المنطقة الحرة، ربط الدفعة المقدمة، مرجع الإشعار الدائن).
مستخدمو Google Sheets: File ← Download ← Comma-separated values (.csv). مستخدمو Excel: Save As ← CSV UTF-8 (Comma delimited) للحفاظ على الأحرف العربية. تصديرات CSV غير UTF-8 تفقد الأسماء القانونية العربية، مما يفشل التحقق — استخدم UTF-8 دائمًا.
تعيين عمود جدول البيانات ← PINT-AE
التعيين الدقيق الذي يطبّقه تراست بل عند تحويل كل صف من Excel / CSV إلى PINT-AE XML. يأتي القالب مع رؤوس الأعمدة هذه معبّأة مسبقًا في الصف 1 — تعبّئ الصف 2 وما بعده. الأعمدة الإضافية مُتجاهَلة (آمن للاحتفاظ بملاحظاتك الداخلية)؛ الأعمدة الإلزامية المفقودة تفشل عند الرفع.
| رأس العمود (الصف 1) | حقل PINT-AE / UBL 2.1 | ملاحظة |
|---|---|---|
| invoice_number | cbc:ID | رقم فاتورتك. يجب أن يكون فريدًا عبر جميع الرفوعات. |
| issue_date | cbc:IssueDate | تاريخ ISO (YYYY-MM-DD). لا يجب أن يكون في المستقبل. |
| invoice_type_code | cbc:InvoiceTypeCode | 388 للفاتورة التجارية، 381 للإشعار الدائن، 386 للدفعة المقدمة. |
| buyer_trn | cac:AccountingCustomerParty/cac:PartyTaxScheme/cbc:CompanyID | TRN المشتري — 15 رقمًا. غياب TRN = سبب الرفض رقم 1. |
| buyer_name | cac:AccountingCustomerParty/cac:Party/cac:PartyLegalEntity/cbc:RegistrationName | الاسم القانوني للمشتري. UTF-8؛ الأحرف العربية مدعومة. |
| buyer_country | cac:AccountingCustomerParty/cac:Party/cac:PostalAddress/cac:Country/cbc:IdentificationCode | ISO 3166-1 alpha-2. AE للمحلي؛ الرموز الأخرى تُشغّل معاملة تصدير/احتساب عكسي. |
| line_description | cac:InvoiceLine/cbc:Description | نص بند السطر. عدة أسطر لكل فاتورة تذهب على صفوف متتالية تُشارك نفس invoice_number. |
| line_quantity | cac:InvoiceLine/cbc:InvoicedQuantity | عدد الوحدات (عدد صحيح أو عشري). |
| line_unit_price | cac:InvoiceLine/cac:Price/cbc:PriceAmount | سعر الوحدة بعملة الفاتورة. |
| line_tax_category | cac:ClassifiedTaxCategory/cbc:ID | S (5% قياسي)، Z (0% بنسبة صفر)، E (معفى)، أو O (خارج النطاق). |
| line_tax_rate | cac:ClassifiedTaxCategory/cbc:Percent | رقمي — 5، 0، 0، 0 على التوالي. |
| currency | cbc:DocumentCurrencyCode | AED للمحلي. غير AED يتطلب عمود fx_rate. |
| fx_rate | cac:PricingExchangeRate/cbc:CalculationRate | مطلوب فقط إذا كانت العملة ≠ AED. |
| free_zone | علم namespace امتداد؛ فئة الضريبة مُشتقة | TRUE / FALSE. اضبطه على نطاق buyer_ أو line_ حسب الحاجة. |
| advance_uuid | cac:DocumentReference (النوع 386) | للفواتير التي تسترد دفعة مقدمة سابقة — عبّئه بـ UUID فاتورة الدفعة المقدمة. |
| parent_invoice_id | cbc:InvoiceTypeCode="381"؛ cac:BillingReference/cac:InvoiceDocumentReference | مطلوب على صفوف الإشعار الدائن (invoice_type_code=381) — UUID الفاتورة المُدانَة. |
أخطاء الرفع الشائعة وكيفية إصلاحها
أكثر ثمانية أخطاء رفع تُصادَف عندما يفشل صف جدول بيانات في فحوصات PINT-AE، مع الإصلاح الدقيق في ملف Excel أو CSV. واجهة رفع تراست بل تُبرز كل صف متأثر برسالة خطأ واضحة؛ الجدول أدناه هو النسخة المرجعية.
| رمز الخطأ | المعنى | الإصلاح في Excel / CSV / Google Sheets |
|---|---|---|
| PAE-BR-01 | عمود buyer_trn مفقود أو ليس 15 رقمًا في هذا الصف. | في جدول بياناتك، اضبط خلية buyer_trn إلى TRN من 15 رقمًا. نسّق العمود كنص بحيث لا يُسقط Excel الأصفار البادئة. |
| PAE-BR-04 | TRN البائع مفقود في إعدادات شركة تراست بل. | اضبط TRN الخاص بك مرة في تراست بل ← Settings ← Company. لا يُحمل في جدول البيانات؛ ينطبق على كل فاتورة مرفوعة. |
| PAE-BR-11 | عدم تطابق إجمالي البند (كمية × سعر ≠ إجمالي البند من الورقة). | صحّح التقريب على line_quantity أو line_unit_price بحيث يتوافق إجمالي البند. تراست بل تُعيد الحساب؛ إذا اختلفت القيمة المُعاد حسابها عن ورقتك بأكثر من 0.01، يفشل الصف. |
| PAE-BR-12 | قيمة line_tax_category غير معروفة. | S / Z / E / O فقط مقبولة. استبدل أي قيم حرة (مثل "5%"، "Zero Rated"، "Exempt") بالرمز أحادي الحرف. |
| PAE-BR-14 | العملة ≠ AED لكن لا يوجد fx_rate مُقدّم. | أضف عمود fx_rate وعبّئه بالسعر اعتبارًا من issue_date الفاتورة. |
| PAE-BR-21 | صف إشعار دائن (invoice_type_code=381) مفقود parent_invoice_id. | اضبط parent_invoice_id على صف الإشعار الدائن إلى UUID الفاتورة المُدانَة. هذا UUID من استجابة تراست بل، وليس invoice_number المحلي. |
| PAE-BR-22 | صف استرداد دفعة مقدمة مفقود مرجع advance_uuid. | اضبط advance_uuid إلى UUID فاتورة الدفعة المقدمة السابقة (invoice_type_code=386). |
| PAE-BR-31 | free_zone=TRUE لكن عنوان المشتري ليس في منطقة حرة. | صحّح عنوان المشتري في Contacts في تراست بل، أو اضبط free_zone=FALSE على الصف. |
ميزات رئيسية لمستخدمي Excel و CSV
مسار عمل Excel / CSV في تراست بل يتضمن:
- **رفوعات مضمونة** — إعادة رفع نفس invoice_number لا تُكرّر الإرسال. - **قائمة انتظار الإصلاح وإعادة الإرسال** — الصفوف الفاشلة تظهر في لوحة تحكم بأخطاء على مستوى الصف؛ صحّح الورقة، أعد الرفع، فقط الصفوف الفاشلة تُعيد الإرسال. - **توافق Google Sheets** — تصدير `.csv` الأصلي يعمل. UTF-8 مطلوب للحفاظ على العربية. - **قالب ثنائي اللغة** — رؤوس الأعمدة تُشحن بالإنجليزية + العربية؛ أي متغير مقبول عند الرفع. - **تحقق بالجملة** — جميع 51 حقل PINT-AE إلزامي مفحوصة لكل صف قبل أي إرسال. - **اختيار API** — نفس حمولة JSON التي تقبلها API يمكن أيضًا نشرها كـ CSV؛ كلا المسارين يهبطان على نفس مزوّد الخدمة المعتمد. - **متعدد المستأجرين** — مكاتب المحاسبة ترفع ملفًا واحدًا مع عمود client_trn والفواتير تُوجَّه إلى العميل الصحيح تلقائيًا. - **تجميع VAT 201** — الفواتير المرفوعة تُغذي نفس مسودة VAT 201 مثل المصادر من API وموصلات ERP.
التسعير لمستخدمي Excel / CSV
الباقة المجانية — 50 فاتورة/شهر بدون بطاقة ائتمان — بُنيت لهذا الملف بالضبط: شركة صغيرة، مهني حر، أو مستشار لكل مشروع يُفوتر في جدول بيانات ويحتاج تغطية التفويض بدون اشتراك SaaS محاسبة. الخطط المدفوعة تبدأ من 200 درهم/شهر لـ 500 فاتورة؛ التشغيلات الأكبر وخطط متعددة المستأجرين لمكاتب المحاسبة تتوسع في مستويات شفافة بالدرهم. لا رسوم إعداد. لا التزام.
الأسئلة الشائعة
هل أحتاج شراء Excel لاستخدام هذا؟
لا. أي جدول بيانات يمكنه الحفظ كـ CSV يعمل — Google Sheets، LibreOffice Calc، Numbers، أو Excel. القالب CSV؛ يمكنك فتحه في أي أداة تمتلكها بالفعل.
ماذا لو كان لدي مئات الفواتير شهريًا — هل CSV لا يزال عمليًا؟
نعم. خط أنابيب CSV في تراست بل يتعامل مع عشرات الآلاف من الصفوف لكل ملف. المتاجر عالية الحجم عادةً تُؤتمت الرفع عبر API بدلاً من إسقاط ملف يدوي، لكن نفس تنسيق CSV يعمل في كلتا الحالتين.
هل تحتاج بنود السطر أن تكون على نفس الصف كرأس الفاتورة؟
لا. عدة بنود سطر تذهب على صفوف متتالية تُشارك نفس invoice_number — تُجمّعها تراست بل في وثيقة PINT-AE واحدة عند الرفع. حقول مستوى الرأس على الصفوف 2..N مُتجاهَلة (فقط الصف الأول لـ invoice_number يحملها).
كيف تُحفظ العربية في CSV؟
احفظ كـ CSV UTF-8. في Excel: File ← Save As ← CSV UTF-8 (Comma delimited). غير UTF-8 (Windows-1252، إلخ) سيُفسد الأسماء القانونية العربية ويفشل التحقق. Google Sheets يُصدّر UTF-8 افتراضيًا.
هل يمكن لمكاتب المحاسبة رفع ملف واحد لعدة أرقام TRN للعملاء؟
نعم. أضف عمود client_trn؛ تُوجّه تراست بل كل صف إلى مستأجر العميل الصحيح في مساحة عمل استشاريين متعددة المستأجرين. هذا أحد الأسباب التي تجعل مكاتب المحاسبة الإماراتية تستخدم تراست بل بدلاً من ERP لكل عميل.