با استفاده از API مگاپی، می‌توانید به صورت خودکار اطلاعات صورتحساب‌های خود را به مگاپی و یا مستقیم به سامانه مؤدیان ارسال کنید و از مزایای آن بهره‌مند شوید.

API مگاپی ابزاری قدرتمند برای توسعه‌دهندگان است که به آنها امکان می‌دهد:

  • اتصال به مگاپی و ارسال اطلاعات صورتحساب‌ها به پنل
  • ارسال خودکار صورتحساب‌ها به سامانه مؤدیان
  • مدیریت صورتحساب‌ها در مگاپی


Authorization

احراز هویت با Bearer Token

برای استفاده از سرویس‌های API لازم است مقدار APIKey خود را در هدر درخواست و با کلید Authorization به‌صورت Bearer Token ارسال کنید.

قالب هدر

Authorization: Bearer <APIKey>
دریافت APIKey: از مسیر منوی کسب‌وکارها → تب تنظیمات سامانه مؤدیان کلید خود را دریافت کنید.

مثال درخواست با cURL

curl --location 'https://api.mphub.ir/api/invoice/salesEndUser' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer your_api_key_here' \
--data '{
  "uuid": "e6d6ad40-ad80-41ee-bfa8-ec836362983a888",
  "internalId": "e6d6ad40-ad80-41ee-bfa8-ec836362983a888",
  "no": 888,
  "dateTime": "12/17/2024 2:19:42 PM",
  "invoiceNetPrice": 3000000.0,
  "description": "ارز دیجیتال",
  "items": [
    { "no": 1, "stuffId": "2710000018070", "qty": 13.10877415, "unitPrice": 228580.0, "discount": 0.0, "vatRate": 0.0 }
  ]
}'
  • هدر Authorization باید دقیقاً با الگوی Bearer <APIKey> ارسال شود.
  • در نمونه‌های بالا مقدار your_api_key_here را با کلید واقعی خود جایگزین کنید.


مقدار APIKey را می‌توانید از مسیر زیر دریافت نمایید:
منوی کسب‌وکارها → تب تنظیمات سامانه مؤدیان

اگر به دنبال راهی برای ساده‌سازی فرآیند ارسال و مدیریت صورتحساب‌های خود هستید، API مگاپی راه‌حل ایده‌آلی برای شما است. در این مستندات، تمام اطلاعات مورد نیاز برای اتصال به API مگاپی و استفاده از آن را خواهید یافت. اگر سوالی دارید، می‌توانید از طریق تیکت با ما تماس بگیرید.

BaseURL: https://api.mphub.ir

مستندات API وب سایت