حسابداری و امور مالی بیمارستانبخشنامه، تعرفه و محاسبات حقوق
جست‌وجوخبرنامه
قوانین و مقررات

ابلاغ به روز رسانی سند راهنمای پیاده سازی وب سرویس مکسا در بستر دیتاس

زمان مطالعه: ۱۶ دقیقه۳۵ بازدید

ابلاغیه شماره ۱۱۰/۱۹۸ مورخ ۱۴۰۵/۰۴/۲۷

شماره: ۱۱۰/۱۹۸  |  تاریخ: ۱۴۰۵/۰۴/۲۷  |  پیوست: دارد  |  فوری

موضوع: ابلاغ به روز رسانی سند راهنمای پیاده سازی وب سرویس مکسا در بستر دیتاس

گیرندگان

  • جناب آقای دکتر محمد مهدی ناصحی، مدیر عامل محترم سازمان بیمه سلامت ایران
  • جناب آقای دکتر سالاری، مدیر عامل محترم سازمان تامین اجتماعی
  • جناب آقای دکتر مسعود فیض اربابی، مدیرعامل محترم سازمان بیمه خدمات درمانی نیروهای مسلح
  • جناب آقای دکتر پرویز خوش کلام خسروشاهی، رئیس کل محترم بیمه مرکزی جمهوری اسلامی ایران
  • جناب آقای سید مرتضی بختیاری، رئیس محترم کمیته امداد امام خمینی(ره)
  • مدیرعامل محترم شرکت/مجموعه توسعه دهنده سامانه اطلاعات بیمارستانی
  • مدیرعامل محترم شرکت/مجموعه توسعه دهنده سامانه اطلاعات آزمایشگاهی
  • مدیرعامل محترم شرکت/مجموعه توسعه دهنده سامانه اطلاعات داروخانه
  • مدیرعامل محترم شرکت/مجموعه توسعه دهنده سامانه اطلاعات تصویر برداری
  • مدیرعامل محترم شرکت/مجموعه توسعه دهنده سامانه اطلاعات رادیولوژی
  • مدیرعامل محترم شرکت/مجموعه توسعه دهنده سامانه اطلاعات مطب
  • مدیرعامل محترم شرکت/مجموعه توسعه دهنده سامانه اطلاعات نوبت دهی
  • مدیرعامل محترم شرکت/مجموعه توسعه دهنده سامانه اطلاعات مراکز بهداشتی
  • مدیرعامل محترم شرکت/مجموعه توسعه دهنده سامانه اطلاعات کلینیکی

با سلام و احترام

پیرو ابلاغیه های شماره ۱۱۰/۸۸ مورخ ۱۴۰۲/۰۳/۲۷ و شماره ۱۱۰/۱۲۳ مورخ ۱۴۰۲/۰۴/۲۱ مبنی بر الزام پیاده سازی کدینگ ابلاغی مکسا از طریق وب سرویس های مکسا در بستر دیتاس، به استحضار می رساند، به پیوست نگارش به روز رسانی شده سند راهنمای فنی پیاده سازی سرویس مکسا جهت اجرا و پیاده سازی در سامانه های اطلاعات مرتبط ابلاغ می گردد. لازم بذکر است وب سرویس مکسا علاوه بر سامانه مکسا به نشانی https://maxa.behdasht.gov.ir، در بخش شهروندی سامانه رگولاتوری-اپراتوری به نشانی https://op.salamat.gov.ir در دسترس و قابل بهره برداری می باشد. لذا خواهشمند است، اقدامات مقتضی در خصوص پیاده سازی دستورالعمل مذکور معمول گردد.

دکتر سید رضا مظهری
رئیس مرکز مدیریت آمار و فناوری اطلاعات

رونوشت

  • جناب آقای دکتر سیدسجاد رضوی، معاون محترم درمان
  • جناب آقای دکتر علیرضا رئیسی، معاون محترم بهداشت
  • جناب آقای دکتر حکیم جوادی، رئیس محترم سازمان نظام صنفی رایانه ای کشور
  • جناب آقای دکتر احمد رضا ریحانی یساولی، مدیر کل محترم دفتر بازرسی و مدیریت عملکرد
  • جناب آقای دکتر سید ابراهیم اسکندری، رئیس محترم مرکز حراست
  • جناب آقای دکتر محمودرضا محقق دولت آبادی، مشاور محترم اجرایی معاونت درمان
  • جناب آقای معنوی، دبیر محترم شورای عالی بیمه سلامت و مدیر کل دفتر برنامه ریزی و سیاست گذاری بیمه سلامت
  • جناب آقای عباس نجاری، معاون محترم فنی مرکز مدیریت آمار و فناوری اطلاعات
  • سرکار خانم مهندس معصومه خانی، رئیس محترم گروه تنظیم مقررات، صدور پروانه و نظارت

ابلاغیه شماره ۱۱۰/۸۸ مورخ ۱۴۰۲/۰۳/۲۷

شماره: ۱۱۰/۸۸  |  تاریخ: ۱۴۰۲/۰۳/۲۷  |  پیوست: دارد  |  پیگیری

موضوع: ابلاغ بهره برداری از کدینگ نسخه الکترونیک از طریق وب سرویس مکسا

گیرندگان

  • جناب آقای دکتر محمد مهدی ناصحی، مدیرعامل محترم سازمان بیمه سلامت
  • جناب آقای دکتر سید میرهاشم موسوی، مدیرعامل محترم سازمان تامین اجتماعی
  • جناب آقای دکتر امیر نوروزی، رئیس محترم سازمان خدمات درمانی وزارت دفاع و پشتیبانی نیروهای مسلح
  • جناب آقای دکتر مجید بهزادپور، رئیس محترم بیمه مرکزی جمهوری اسلامی ایران
  • جناب آقای سید مرتضی بختیاری، رئیس محترم بیمه کمیته امداد امام خمینی(ره)
  • جناب آقای دکتر فریدون نوحی، رئیس محترم مرکز آموزشی، تحقیقاتی و درمانی قلب و عروق شهید رجایی
  • جناب آقای دکتر علی اکبر ولایتی، رئیس محترم مرکز آموزشی، پژوهشی و درمانی بیمارستان مسیح دانشوری
  • جناب آقای دکتر علی واشقانی فراهانی، رئیس محترم مرکز قلب تهران
  • جناب آقای دکتر حسین صمدی نیا، رئیس محترم بیمارستان بقیه الله (عج)
  • مدیرعامل محترم شرکت/مجموعه توسعه دهنده سامانه اطلاعات بیمارستانی
  • مدیرعامل محترم شرکت/مجموعه توسعه دهنده سامانه اطلاعات آزمایشگاه
  • مدیرعامل محترم شرکت/مجموعه توسعه دهنده سامانه اطلاعات داروخانه
  • مدیرعامل محترم شرکت/مجموعه توسعه دهنده سامانه اطلاعات تصویربرداری
  • مدیرعامل محترم شرکت/مجموعه توسعه دهنده سامانه اطلاعات رادیولوژی
  • مدیرعامل محترم شرکت/مجموعه توسعه دهنده سامانه اطلاعات کلینیکی
  • مدیرعامل محترم شرکت/مجموعه توسعه دهنده سامانه اطلاعات مطب
  • مدیرعامل محترم شرکت/مجموعه توسعه دهنده سامانه اطلاعات نوبت دهی
  • مدیرعامل محترم شرکت/مجموعه توسعه دهنده سامانه اطلاعات مراکز بهداشتی

با سلام

احتراما، پیرو ابلاغیه شماره ۱۱۰/۱۳۰ مورخ ۱۴۰۰/۰۵/۰۷ موضوع «ابلاغ بهره برداری از کدینگ نسخه الکترونیک از طریق وب سرویس مکسا» به استحضار می رساند، سرویس های مکسا (مرجع کدینگ سلامت ایران) در بستر دیتاس (درگاه یکپارچه تبادل اطلاعات سلامت) کمافی السابق فعال، در دسترس و به شرح آدرس های ذیل با پروتکل های بر بستر دیتاس (دسترسی های دیتاس) می باشد. لازم به ذکر است آخرین مستندات مربوطه به پیوست و قابل دسترس از طریق آدرس https://it.behdasht.gov.ir/ditasdocs بوده و با عنایت به مطابقت سرویس های مذکور با اطلاعات موجود ابلاغی در سامانه مکسا به آدرس https://maxa.behdasht.gov.ir خواهشمند است دستور فرمایید، اقدامات لازم جهت بهره برداری مقتضی در راستای یکپارچگی کدینگ ابلاغی نسخه الکترونیک در پنل و وب سرویس های مرتبط آن مجموعه و اعلام مراتب معمول گردد.

ردیفعنوانآدرس
۱دریافت لیست ترمینولوژیhttps://apigateway.behdasht.gov.ir/api/client/apim/v1/maksaservice/gwmaksa/CtsTerminologies
۲جستجوی کدینگ در ترمینولوژیhttps://apigateway.behdasht.gov.ir/api/client/apim/v1/maksaservice/gwmaksa/Terminology
۳دریافت لیست کدینگ های ترمینولوژیhttps://apigateway.behdasht.gov.ir/api/client/apim/v1/maksaservice/gwmaksa/SearchTerminology
۴اعتبار سنجی کدینگ ترمینولوژیhttps://apigateway.behdasht.gov.ir/api/client/apim/v1/maksaservice/gwmaksa/ValidateCts

دکتر سید رضا مظهری
رئیس مرکز مدیریت آمار و فناوری اطلاعات

رونوشت

  • جناب آقای دکتر پورحسینی، مشاور محترم وزیر و مدیر کل حوزه وزارتی
  • جناب آقای دکتر حسین فرشیدی، معاون محترم بهداشت
  • جناب آقای دکتر سعید کریمی، معاون محترم درمان
  • جناب آقای مهندس حسن هاشمی، رئیس محترم سازمان نظام صنفی رایانه ای کشور
  • جناب آقای دکتر محمودرضا محقق دولت آبادی، دبیر محترم شورای عالی بیمه سلامت و مدیر کل دفتر برنامه ریزی و سیاستگذاری بیمه های سلامت
  • جناب آقای دکتر حسین فرزانه، رئیس محترم مرکز حراست وزارت بهداشت درمان و آموزش پزشکی
  • جناب آقای دکتر رحیم نیا، مدیر کل محترم دفتر بازرسی، ارزیابی عملکرد و پاسخگویی به شکایات
  • مدیران محترم آمار و فناوری اطلاعات دانشگاه ها/دانشکده های علوم پزشکی و خدمات بهداشتی درمانی سراسر کشور
  • جناب آقای دکتر رضا گل پیرا، مسئول محترم واحد فناوری اطلاعات مرکز آموزشی، تحقیقاتی و درمانی قلب و عروق شهید رجایی
  • جناب آقای ناصر شاکر حسینی، رئیس محترم کمیسیون سلامت الکترونیک سازمان نظام صنفی رایانه ای کشور

ابلاغیه شماره ۱۱۰/۱۲۳ مورخ ۱۴۰۲/۰۴/۲۱

شماره: ۱۱۰/۱۲۳  |  تاریخ: ۱۴۰۲/۰۴/۲۱  |  پیوست: ندارد  |  پیگیری

موضوع: ابلاغ الزام پیاده سازی کدینگ ابلاغی مکسا از طریق وب سرویس های مکسا در بستر دیتاس (پیگیری)

گیرندگان

  • جناب آقای دکتر محمد مهدی ناصحی، مدیرعامل محترم سازمان بیمه سلامت
  • جناب آقای دکتر سید میرهاشم موسوی، مدیرعامل محترم سازمان تامین اجتماعی
  • جناب آقای دکتر امیر نوروزی، رئیس محترم سازمان خدمات درمانی وزارت دفاع و پشتیبانی نیروهای مسلح
  • جناب آقای دکتر مجید بهزادپور، رئیس محترم بیمه مرکزی جمهوری اسلامی ایران
  • جناب آقای سید مرتضی بختیاری، رئیس محترم بیمه کمیته امداد امام خمینی(ره)
  • مدیرعامل محترم شرکت/مجموعه توسعه دهنده سامانه اطلاعات بیمارستانی
  • مدیرعامل محترم شرکت/مجموعه توسعه دهنده سامانه اطلاعات آزمایشگاه
  • مدیرعامل محترم شرکت/مجموعه توسعه دهنده سامانه اطلاعات داروخانه
  • مدیرعامل محترم شرکت/مجموعه توسعه دهنده سامانه اطلاعات تصویربرداری
  • مدیرعامل محترم شرکت/مجموعه توسعه دهنده سامانه اطلاعات رادیولوژی
  • مدیرعامل محترم شرکت/مجموعه توسعه دهنده سامانه اطلاعات کلینیکی
  • مدیرعامل محترم شرکت/مجموعه توسعه دهنده سامانه اطلاعات مطب
  • مدیرعامل محترم شرکت/مجموعه توسعه دهنده سامانه اطلاعات نوبت دهی
  • مدیرعامل محترم شرکت/مجموعه توسعه دهنده سامانه اطلاعات مراکز بهداشتی

با سلام و احترام

پیرو ابلاغیه های شماره ۱۱۰/۳۵۶ مورخ ۱۴۰۰/۰۹/۱۳، ۱۱۰/۱۳۰ مورخ ۱۴۰۰/۰۵/۰۷ و ۱۱۰/۸۸ مورخ ۱۴۰۲/۰۳/۲۷ یادآور می گردد، مرجع کدینگ سلامت ایران (مکسا) و وب سرویس های مکسا در بستر دیتاس (درگاه یکپارچه تبادل اطلاعات سلامت) به عنوان مرجع استعلام و بهره برداری کدینگ حوزه سلامت توسط سازمان های بیمه گر و شرکت های توسعه دهنده اطلاعات سلامت تعیین شده است.

لذا ضروری است کدینگ‌های ابلاغی مکسا در سامانه های حوزه سلامت پیاده سازی و اجرا گردد و وجود برخی مغایرت های سازمان های بیمه گر با کدینگ ابلاغی مکسا که توسط تعدادی از شرکت های توسعه دهنده اطلاعات سلامت اعلام و توسط برخی دانشگاه های مرتبط ارسال گردیده است، دلیل موجهی بر عدم انجام تکلیف مذکور نمی باشد.

خواهشمند است دستور فرمایید، اقدامات لازم جهت بهره برداری مقتضی در راستای یکپارچگی کدینگ ابلاغی نسخه الکترونیک مطابق با مکسا در سامانه‌ها و سرویس های پایه مرتبط آن مجموعه و اعلام مراتب معمول گردد.

دکتر سید رضا مظهری
رئیس مرکز مدیریت آمار و فناوری اطلاعات

رونوشت

  • جناب آقای دکتر پورحسینی، مشاور محترم وزیر و مدیر کل حوزه وزارتی
  • جناب آقای دکتر سعید کریمی، معاون محترم درمان
  • جناب آقای دکتر حسین فرشیدی، معاون محترم بهداشت
  • جناب آقای مهندس حسن هاشمی، رئیس محترم سازمان نظام صنفی رایانه ای کشور
  • جناب آقای دکتر محمودرضا محقق دولت آبادی، دبیر محترم شورای عالی بیمه سلامت و مدیر کل دفتر برنامه ریزی و سیاستگذاری بیمه های سلامت
  • جناب آقای دکتر حسین فرزانه، رئیس محترم مرکز حراست وزارت بهداشت درمان و آموزش پزشکی
  • جناب آقای دکتر رحیم نیا، مدیر کل محترم دفتر بازرسی، ارزیابی عملکرد و پاسخگویی به شکایات
  • مدیران محترم آمار و فناوری اطلاعات دانشگاه ها/دانشکده های علوم پزشکی و خدمات بهداشتی درمانی سراسر کشور
  • جناب آقای ناصر شاکر حسینی، رئیس محترم کمیسیون سلامت الکترونیک سازمان نظام صنفی رایانه ای کشور

دریافت فایل اصلی مستندات ابلاغیه

📎 دریافت بسته کامل مستندات ابلاغیه ۱۱۰/۱۹۸ از سایت مرکز مدیریت آمار و فناوری اطلاعات وزارت بهداشت (شامل سند راهنمای فنی پیاده سازی وب سرویس مکسا در بستر دیتاس)

سند راهنمای فنی پیاده سازی سرویس مرجع کدینگ سلامت ایران (مکسا)

درگاه یکپارچه تبادل اطلاعات سلامت (دیتاس)

شناسنامه سند

  • کلیه حقوق این سند متعلق به مرکز مدیریت آمار و فناوری اطلاعات وزارت بهداشت، درمان و آموزش پزشکی می باشد. هرگونه کپی برداری و استفاده غیرمجاز از آن پیگرد قانونی دارد.
  • ارائه دهنده سرویس موظف است هرگونه تغییر در ساختار سرویس را به مسئول دیتاس اطلاع دهد و هرگونه ایجاد تغییر در سند بدون هماهنگی با ایشان غیرقانونی است.
عنوانمقدار
نام سندسند راهنمای فنی پیاده سازی سرویس مرجع کدینگ سلامت ایران (مکسا)
ارائه دهنده سرویسمرکز مدیریت آمار و فناوری اطلاعات وزارت بهداشت، درمان و آموزش پزشکی
نام فایلDITAS_MAXAService_V1.5
تاریخ انتشار نگارش اولیه سند۰۹/۰۴/۱۴۰۰
تاریخ انتشار نگارش فعلی سند۱۶/۰۳/۱۴۰۵
شرح سنداین سند به منظور بهره برداری از سرویس مرجع کدینگ سلامت ایران تهیه شده است.
نویسندگانمعاونت فنی مرکز مدیریت آمار و فناوری اطلاعات وزارت بهداشت، درمان و آموزش پزشکی

تاریخچه ویرایش سند

نویسنده/ویراستارتاریخ نگارشنگارشاقدامات
محسن میرزایی۰۹/۰۴/۱۴۰۰1.0تدوین اولیه سند
حامد رضایی۲۳/۰۴/۱۴۰۰1.0.1اصلاح و بازبینی محتوایی
پوریا نسیمی۲۶/۰۶/۱۴۰۰1.0.2افزودن مقدمه و تعاریف
حامد رضایی۲۷/۰۶/۱۴۰۰1.1اصلاح و بازبینی محتوایی، تایید نسخه 1.1
پوریا نسیمی، شیرین شاطریان۱۷/۰۶/۱۴۰۱1.1.1اصلاح و بازبینی محتوایی
حامد رضایی۱۸/۰۶/۱۴۰۱1.1.2اصلاح ساختار و بازبینی محتوایی
ابراهیم کشاورز صفری۱۹/۰۶/۱۴۰۱1.1.3اصلاح قالب، بازبینی محتوایی و نگارشی
افشین شرفی۲۰/۰۶/۱۴۰۱1.1.4بازبینی و ویرایش نمونه های ورودی و خروجی توابع
حامد رضایی۲۱/۰۶/۱۴۰۱1.2اصلاح ساختار
ابراهیم کشاورز صفری۲۱/۰۶/۱۴۰۱1.2تایید نسخه 1.2
ابراهیم کشاورز صفری۰۱/۱۲/۱۴۰۱1.3بروزرسانی کدهای نمونه ورودی توابع سرویس
شیرین شاطریان۰۱/۱۲/۱۴۰۱1.3کنترل کیفی
پوریا نسیمی۲۱/۰۲/۱۴۰۵1.4
  • اختیاری شدن تاریخ در ورودی تابع CtsTerminologies
  • اختیاری شدن تاریخ، افزودن دسته بندی، شماره صفحه و اندازه صفحه در ورودی تابع SearchTerminology
  • اضافه شدن توضیحات، دسته بندی ها و والد (از نوع DoCodedTextDto) به خروجی کدینگ های تابع SearchTerminology
  • افزودن شماره صفحه و اندازه صفحه در ورودی تابع TerminologiesTermByVersion
  • اضافه شدن توضیحات، دسته بندی ها و والد (از نوع DoCodedTextDto) به خروجی کدینگ های تابع TerminologiesTermByVersion
  • تابع TerminologyCategories جهت دریافت دسته بندی های یک ترمینولوژی
معصومه خانی، لیلا کرمی۱۶/۰۳/۱۴۰۵1.5کنترل کیفی

تاییدکننده سند

نویسنده/ویراستارتاریخ نگارشنگارشوضعیت
سید رضا مظهری۱۶/۰۳/۱۴۰۵1.5تائید نهایی

فهرست مطالب

عنوانصفحه
فهرست مطالب۴
فهرست جداول۵
مقدمه۶
تعاریف۶
نحوه احراز هویت کاربر دیتاس۷
دسترسی به خدمات۸
تابع دریافت توکن دیتاس۸
تابع بروزرسانی توکن دیتاس۹
نحوه فراخوانی توابع سرویس مرکز کدینگ سلامت ایران (مکسا)۱۱
پارامتر های ورودی Header توابع سرویس مکسا۱۱
تابع Terminology۱۱
تابع SearchTerminology۱۲
تابع ValidateCts۱۶
تابع CtsTerminologies۱۸
تابع TerminologyValueByVersion۲۰
تابع TerminologiesTermByVersion۲۱
تابع TerminologyVersions۲۳
تابع TerminologyCategories۲۵
پیوست ها۲۷
پیوست ۱ – ساختار خروجی فراخوانی توابع دیتاس۲۷
پیوست ۲ – کدهای وضعیت پاسخ دیتاس نسبت به فراخوانی توابع۲۸

فهرست جداول

جدولعنوانصفحه
۱پارامترهای ورودی Header تابع دریافت توکن۸
۲پارامترهای ورودی Body تابع دریافت توکن۸
۳پارامترهای خروجی Body تابع دریافت توکن دیتاس۹
۴پارامترهای خروجی Header تابع دریافت توکن۹
۵پارامترهای ورودی Header تابع بروزرسانی توکن دیتاس۱۰
۶پارامترهای خروجی تابع بروزرسانی توکن۱۰
۷پارامترهای ورودی Header توابع سرویس مکسا۱۱
۸پارامترهای ورودی Body تابع Terminology۱۲
۹پارامترهای ورودی Body تابع SearchTerminology۱۳
۱۰پارامترهای ورودی Body تابع ValidateCts۱۷
۱۱پارامترهای ورودی Body تابع CtsTerminologies۱۹
۱۲پارامترهای ورودی Body تابع TerminologyValueByVersion۲۱
۱۳پارامترهای ورودی Body تابع TerminologiesTermByVersion۲۲
۱۴پارامترهای خروجی Body تابع TerminologiesTermByVersion۲۳
۱۵پارامترهای ورودی Body تابع TerminologyVersions۲۴
۱۶پارامترهای خروجی Body تابع TerminologyVersions۲۵
۱۷پارامترهای ورودی Body تابع TerminologyCategories۲۵

دسترسی به خدمات و آدرس پایه سرویس

آدرس پایه (Base Url) سرویس به شرح زیر است:

Base Url:  Https://apigateway.behdasht.gov.ir

تابع دریافت توکن دیتاس

درخواست

POST /oauth/token HTTP/1.1
Host: apigateway.behdasht.gov.ir
Authorization: Basic {authorizationCode}
grant_type=password&username=yourusername&password=yourpassword

پاسخ موفق

{
    "access_token": "c8abceda-aa31-4a7e-95c0-213e5709e6b6",
    "token_type": "bearer",
    "refresh_token": "84dc3bf1-7342-4c5e-adc3-c2304583ae02",
    "expires_in": 763,
    "scope": "trust read write"
}

پاسخ ناموفق

{
    "error": "invalid_grant",
    "error_description": "Bad credentials"
}

پارامترهای خروجی Body (جدول ۳)

ردیفنام پارامترنوع
۱access_tokenstring
۲refresh_tokenstring
۳scopestring
۴token_typestring
۵expires_instring

پارامترهای خروجی Header (جدول ۴)

ردیفنام پارامترنوع
۱requestIdstring

تابع بروزرسانی توکن دیتاس

درخواست

POST /oauth/token HTTP/1.1
Host: apigateway.behdasht.gov.ir
Authorization: Basic {authorizationCode}
grant_type=refresh_token&refresh_token={refreshToken}

پاسخ موفق

{
    "access_token": "529d80a1-e8af-44b2-9dac-565cff4258f1",
    "token_type": "bearer",
    "refresh_token": "f998a112-b166-4177-8e2e-c2d89fedb352",
    "expires_in": 899,
    "scope": "trust read write"
}

پاسخ ناموفق

{
    "error": "invalid_grant",
    "error_description": "Bad credentials"
}

پارامترهای خروجی (جدول ۶)

ردیفنام پارامترنوع
۱accessTokenstring
۲refreshTokenstring
۳scopestring
۴tokenTypestring
۵expiresInstring

پارامترهای ورودی Header توابع سرویس مکسا (جدول ۷)

ردیفنام پارامترنوع
۱Content-TypeString
۲PidString
۳AuthorizationString

تابع Terminology

درخواست

GET  /api/client/apim/v1/maksaservice/gwmaksa/Terminology HTTP/1.1
Host: apigateway.behdasht.gov.ir
pid: {Your Pid}
Content-Type: application/json
Authorization: Bearer {{token}}
{
  "terminologyId": "thritaEHR.Religion",
  "codedString": "1"
}

نمونه curl

curl --location --request GET 'https://apigateway.behdasht.gov.ir/api/client/apim/v1/maksaservice/gwmaksa/Terminology' \
--header 'pid: {Your Pid}' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {{token}}' \

تابع SearchTerminology

پارامترهای ورودی Body (جدول ۹)

ردیفنام پارامترنوع
۱CategoryString
۲PageNumberInt
۳PageSizeInt

پاسخ موفق (نمونه)

{
    "result": {
        "data": [
            {
                "valueField": "تلفن منزل",
                "terminology_idField": "ContactType",
                "coded_stringField": "1",
                "description": null,
                "categories": [],
                "parent": null
            },
            {
                "valueField": "پیجر شخصی",
                "terminology_idField": "ContactType",
                "coded_stringField": "10",
                "description": null,
                "categories": [],
                "parent": null
            },
            {
                "valueField": "پیجر محل کار",
                "terminology_idField": "ContactType",
                "coded_stringField": "11",
                "description": null,
                "categories": [],
                "parent": null
            },
            {
                "valueField": "تلفن همراه محل کار",
                "terminology_idField": "ContactType",
                "coded_stringField": "12",
                "description": null,
                "categories": [],
                "parent": null
            },
            {
                "valueField": "نشانی منزل",
                "terminology_idField": "ContactType",
                "coded_stringField": "13",
                "description": null,
                "categories": [],
                "parent": null
            },
            {
                "valueField": "نشانی وب سایت شخصی",
                "terminology_idField": "ContactType",
                "coded_stringField": "8",
                "description": null,
                "categories": [],
                "parent": null
            },
            {
                "valueField": "نشانی وب سایت محل کار",
                "terminology_idField": "ContactType",
                "coded_stringField": "9",
                "description": null,
                "categories": [],
                "parent": null
            }
        ],
        "status": {
            "statusCode": 200
        }
    },
    "status": {
        "statusCode": 200,
        "message": "OK"
    }
}

پاسخ ناموفق

{
    "result": {
        "status": {
            "statusCode": 404
        }
    },
    "status": {
        "statusCode": 200,
        "message": "OK"
    }
}

تابع ValidateCts

پاسخ ناموفق

{
    "result": {
        "status": {
            "statusCode": 404
        }
    },
    "status": {
        "statusCode": 200,
        "message": "OK"
    }
}

تابع CtsTerminologies

درخواست

POST /api/client/apim/v1/maksaservice/gwmaksa/CtsTerminologies HTTP/1.1
Host: apigateway.behdasht.gov.ir
pid: {Your Pid}
Content-Type: application/json
Authorization: Bearer {{token}}
{
  "FromDate": {
    "yearField": 1390,
    "monthField": 10,
    "dayField": 10,
    "hourField": 10,
    "minuteField": 10,
    "secondField": 10
  }
}

نمونه curl

curl --location --request POST 'https://apigateway.behdasht.gov.ir/api/client/apim/v1/maksaservice/gwmaksa/CtsTerminologies' \
--header 'pid: {Your Pid}' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {{token}}' \
--data-raw '{
  "FromDate": {
    "yearField": 1390,
    "monthField": 10,
    "dayField": 10,
    "hourField": 10,
    "minuteField": 10,
    "secondField": 10
  }
}'

پاسخ ناموفق

{
    "result": {
        "status": {
            "statusCode": 404
        }
    },
    "status": {
        "statusCode": 200,
        "message": "OK"
    }
}

تابع TerminologyValueByVersion

پارامترهای ورودی Body (جدول ۱۲)

ردیفنام پارامترنوع
۱terminologyIdString
۲codedStringString
۳versionString

پاسخ موفق

{
    "result": {
        "data": "\"ACETAMINOPHEN 100 mg / 1mL 15 mL SOLUTION / DROPS ORAL\"",
        "status": {
            "statusCode": 200
        }
    },
    "status": {
        "statusCode": 200,
        "message": "OK"
    }
}

پاسخ ناموفق

{
    "status": 0,
    "code": 401,
    "msg": "",
    "violations": []
}

تابع TerminologiesTermByVersion

درخواست

POST  /api/client/apim/v1/maksaservice/gwmaksa/TerminologiesTermByVersion HTTP/1.1
Host: apigateway.behdasht.gov.ir
pid: {Your Pid}
Content-Type: application/json
Authorization: Bearer {{token}}
{
   "terminologyId": "erX",
   "version": "10000",
   "pageNumber": 1,
   "pageSize": 100
}

نمونه curl

curl --location --request POST 'https://apigateway.behdasht.gov.ir/api/client/apim/v1/maksaservice/gwmaksa/TerminologiesTermByVersion' \
--header 'pid: {Your Pid}' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {{token}}' \
--data-raw '{
   "terminologyId": "erX",
   "version": "10000",
   "pageNumber": 1,
   "pageSize": 100
}'

پارامترهای ورودی Body (جدول ۱۳)

ردیفنام پارامترنوع
۱terminologyIdString
۲versionString
۳pageNumberInt
۴pageSizeInt

پاسخ موفق

{
    "result": {
        "data": [
            {
                "valueField": "MOMETASONE FUROATE 0.1 % 15 g CREAM TOPICAL [MEGACORT]",
                "terminology_idField": "eRx",
                "coded_stringField": "60281",
                "description": null,
                "categories": [],
                "parent": null
            }
        ],
        "status": {
            "statusCode": 200
        }
    },
    "status": {
        "statusCode": 200,
        "message": "OK"
    }
}

پاسخ ناموفق

{
    "result": {
        "status": {
            "statusCode": 404
        }
    },
    "status": {
        "statusCode": 200,
        "message": "OK"
    }
}

پارامترهای خروجی Body (جدول ۱۴)

ردیفنام پارامترنوع
۱valueFieldString
۲terminology_idFieldString
۳coded_stringFieldString

تابع TerminologyVersions

درخواست

POST  /api/client/apim/v1/maksaservice/gwmaksa/TerminologyVersions HTTP/1.1
Host: apigateway.behdasht.gov.ir
pid: {Your Pid}
Content-Type: application/json
Authorization: Bearer {{token}}
{
  "terminologyId" : "ErX"
}

نمونه curl

curl --location --request POST 'https://apigateway.behdasht.gov.ir/api/client/apim/v1/maksaservice/gwmaksa/TerminologyVersions' \
--header 'pid: {Your Pid}' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {{token}}' \
--data-raw '{
  "terminologyId" : "ErX"
}'

پارامترهای ورودی Body (جدول ۱۵)

ردیفنام پارامترنوع
۱terminologyIdString

پاسخ موفق

{
    "result": {
        "data": [
            {
                "id": 147,
                "TerminologyId": "eRX",
                "Version": "10000",
                "VersionId": 86,
                "IsLast": true
            }
        ],
        "status": {
            "statusCode": 200
        }
    },
    "status": {
        "statusCode": 200,
        "message": "OK"
    }
}

پاسخ ناموفق

{
    "result": {
        "status": {
            "statusCode": 404
        }
    },
    "status": {
        "statusCode": 200,
        "message": "OK"
    }
}

پارامترهای خروجی Body (جدول ۱۶)

ردیفنام پارامترنوع
۱idInteger
۲TerminologyIdString
۳VersionString
۴VersionIdInteger
۵IsLastBoolean

تابع TerminologyCategories

درخواست

POST  /api/client/apim/v1/maksaservice/gwmaksa/TerminologyCategories HTTP/1.1
Host: apigateway.behdasht.gov.ir
pid: {Your Pid}
Content-Type: application/json
Authorization: Bearer {{token}}
{
  "terminologyId" : "ErX"
}

پارامترهای ورودی Body (جدول ۱۷)

ردیفنام پارامترنوع
۱terminologyIdString

پاسخ موفق

{
    "result": {
        "data": [
            "دارو",
            "تجهیزات"
        ],
        "status": {
            "statusCode": 200
        }
    },
    "status": {
        "statusCode": 200,
        "message": "OK"
    }
}

پاسخ ناموفق

{
    "result": {
        "status": {
            "statusCode": 404
        }
    },
    "status": {
        "statusCode": 200,
        "message": "OK"
    }
}

پیوست ۲ – کدهای وضعیت پاسخ دیتاس نسبت به فراخوانی توابع

ردیفکد وضعیتپیام
۱200OK!
۲202Accepted!
۳400Bad request.
۴401Credential is not valid!
۵403Your origin IP is permanently blocked!
۶404Not Found!
۷410All resources are moved permanently to the HTTP secure protocol(HTTPS)!
۸429Too many requests or Access denied!
۹499Client Closed Request!
۱۰500Internal server error!
۱۱503Service provider error!
۱۲504Backend timeout!
۱۳520Unknown error!

منبع : سایت حسابداری بیمارستان
کانال تلگرام @hospitalaccounting

مطالب مرتبط

نظر شما

نظر شما پس از بررسی منتشر می‌شود. ایمیل‌تان هرگز روی سایت نمایش داده نمی‌شود.