دليل المستودع: حاسبة الرسوم الجمركية وضريبة القيمة المضافة والتكلفة النهائية للشحن داخل الخليج
صفحة تعريفية مستقلة بمستودع حاسبة الرسوم الجمركية وضريبة القيمة المضافة والتكلفة النهائية للشحن داخل الخليج. توضّح ما الذي يحاول حله، ولمن يناسب، وما الملفات التي ستجدها قبل الانتقال إلى المصدر.
المشكلة التي يعالجها
يوضح التوثيق الأصلي نطاق المشكلة بهذا الوصف:
Build an open-source cross-border GCC landed cost calculator: 1) Single-file responsive HTML/JS tool (landed_cost.html) estimating landed costs from configurable assumptions; tax and duty treatment varies by destination, product classification, origin, and shipment, so users must verify current rates, 2) Excel master pricing workbook, 3) DDP (Delivered Duty Paid) customer checkout disclosure copy swipe file.لمن صُمم؟
الجمهور المحدد في README: BOTH operating in high-growth e-commerce, digital publishing, and direct-response marketing across Saudi Arabia, UAE, and Egypt.
محتويات المستودع
الملفات الأساسية التي يسردها قسم بنية المستودع في README:
data/gcc_tariffs_and_vat_matrix.jsonLICENSEmodels/gcc-cross-border-pricing-model.xlsxREADME.mdsrc/landed_cost.jstemplates/ddp-checkout-disclosures.mdtests/calculator.test.jstests/test_calculator.pytools/landed_cost.html
طريقة مراجعته واستخدامه
- ابدأ بقراءة README وتأكد أن المشكلة المذكورة تطابق احتياجك الفعلي.
- افحص الملفات المذكورة أعلاه؛ أسماء الملفات توضح مكان البيانات والأدوات والقوالب والاختبارات.
- اتبع Quick Start الموجود في README، وتحقق من المتطلبات قبل تشغيل أي أمر.
- قارن المخرجات بعينة موثقة، وراجع القيود قبل استخدامها في قرار أو عمل عميل.
أمثلة أوامر البدء من README: python -m unittest discover -s tests · node --test tests/*.test.js
النطاق والقيود
- Unified GCC Customs Tariff: Uses a fixed 5% customs-duty scenario for illustration; actual rates depend on tariff classification, origin, destination, and exemptions.
- VAT Inbound Assessment: Uses destination VAT assumptions for an estimate. Import VAT bases and applicable rates depend on current law and shipment details; verify with the relevant authority or broker.
- Estimate Limits: Rates are fixed examples rather than live tariff lookups. Product codes, origin rules, exemptions, de minimis rules, and courier charges can change the actual total.
هذه الصفحة تلخص التوثيق المتاح ولا تثبت أداءً أو نتيجة تجارية. تحقق من صلاحية البيانات والمتطلبات قبل الاستخدام.