به روزرسانی سرویس نسخه نویسی الکترونیک سازمان تامین اجتماعی و افزودن سرویس سهم بیمار به شماره ۱۱۰/۱۹۰

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

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

موضوع: ابلاغ به روزرسانی سامانه اطلاع رسانی سازمان تامین اجتماعی – API نسخه نویسی – منشی نسخه الکترونیک

گیرندگان

مدیرعامل محترم شرکت/مجموعه توسعه دهنده سامانه اطلاعات بیمارستانی
مدیرعامل محترم شرکت/مجموعه توسعه دهنده سامانه اطلاعات کلینیکی
مدیرعامل محترم شرکت/مجموعه توسعه دهنده سامانه اطلاعات مطب
مدیرعامل محترم شرکت/مجموعه توسعه دهنده سامانه اطلاعات مراکز بهداشتی

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

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

https://apiissue.tamin.ir/plugins/servlet/desk

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

رونوشت

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

نامه سازمان تامین اجتماعی شماره ۶۱۰۰/۱۴۰۵/۵۴۳ مورخ ۱۴۰۵/۰۴/۱۴

شماره: ۶۱۰۰/۱۴۰۵/۵۴۳ | تاریخ: ۱۴۰۵/۰۴/۱۴ | پیوست: دارد | ارجحیت: آنی | حائز اهمیت

موضوع: به روزرسانی سامانه اطلاع رسانی سازمان تامین اجتماعی – API نسخه نویسی – منشی نسخه الکترونیک

گیرندگان

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

با سلام

احتراما؛ با عنایت به به روزرسانی مستمر شناسنامه سرویس های نسخه نویسی و نسخه پیچی سازمان تامین اجتماعی، به استحضار می رساند: تغییرات مرتبط با اضافه شدن سرویس محاسبه سهم بیمار و مشاهده آن توسط منشی (پزشک خانواده) در سامانه نسخه نویسی و (API وابسته) در آدرس ذیل و با اطلاعیه شماره ۴۲ قابل مشاهده می باشد. لذا خواهشمند است دستور فرمایید مراتب با قید فوریت موضوعی به ذینفعان جهت بهره برداری و اقدام به موقع ابلاغ گردد.

https://apiissue.tamin.ir/plugins/servlet/desk

دامون خدابنده
رئیس مرکز فناوری اطلاعات، آمار و محاسبات سازمان تامین اجتماعی

رونوشت

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

سند راهنمای سرویس نسخه نویسی الکترونیک سازمان تامین اجتماعی

شناسنامه سند

عنوان	مقدار
عنوان سند	راهنمای سرویس نسخه نویسی الکترونیک سازمان تامین اجتماعی
سازمان	سازمان تامین اجتماعی
شماره نسخه	۱.۹.۶
تاریخ آخرین تغییرات	تیر ۱۴۰۵
تاریخ نگارش	۱۴۰۵/۰۴/۰۵

کلیه حقوق این سند متعلق به سازمان تامین اجتماعی می باشد و هرگونه کپی برداری و استفاده غیرمجاز از آن قابل پیگیری می باشد.

احراز هویت (OAuth2 با روش PKCE)

احراز هویت سرویس های نسخه نویسی الکترونیک بر پایه پروتکل OAuth2 و روش PKCE انجام می شود. آدرس های سرویس های احراز هویت به شرح زیر است:

خدمت	آدرس
دریافت authorization code (عملیاتی)	https://account.tamin.ir/auth/server/authorize
دریافت توکن (عملیاتی)	https://account.tamin.ir/auth/server/token
دریافت توکن نسخه ۲ (عملیاتی)	https://account.tamin.ir/auth/server/v2/token
دریافت توکن نسخه ۲ (تستی)	https://account-pilot.tamin.ir/auth/server/v2/token
خروج (signout)	https://account.tamin.ir/auth/signout

دریافت authorization code با متد GET و پارامترهای زیر به صورت QueryParam انجام می شود:

https://account.tamin.ir/auth/server/authorize?redirect_uri=https://ep.tamin.ir/view/index&response_type=code&client_id=12345...12345a&code_challenge=VILZG3tR4MuMQXbySv7OQTmM0Ez9SrtVRo8iBaRvPLQ&code_challenge_method=S256&state=1234567891

ردیف	پارامتر	مقدار
۱	`redirect_uri`	آدرس بازگشت
۲	`response_type`	`code`
۳	`client_id`	شناسه کلاینت
۴	`code_challenge`	مقدار چالش کد
۵	`code_challenge_method`	`S256`
۶	`state`	مقدار حالت

نمونه پاسخ دریافت authorization code:

http://{redirectUri}/?code=eyJhbGciOiJSUzI1NiI*******Fgerty2R&expires_in=60&state=1234567891

دریافت توکن با متد POST و با هدر Content-Type: application/x-www-form-urlencoded انجام می شود. نمونه پاسخ موفق:

{
    "access_token": "eyJhbGciOiJSUzI1NiJ9.dWIiOiIwfTUxq1RdefWIgCNDUxM….",
    "expires_in": 3600
}

نمونه curl دریافت توکن (grant_type=authorization_code):

curl --location --request POST 'https://account.tamin.ir/auth/server/v2/token' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'redirect_uri=xxx' \
--data-urlencode 'grant_type=authorization_code' \
--data-urlencode 'client_id=xxx' \
--data-urlencode 'code=eyJhbGciOiJSUzI' \
--data-urlencode 'code_verifier=R056ZkU2OTlMOFI5ekVvaU4wemRMZEtJTTNjVmlQeXg' \
--data-urlencode 'audience=1234567890'

نمونه curl تجدید توکن (grant_type=refresh_token):

curl --location --request POST 'https://account.tamin.ir/auth/server/v2/token' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'grant_type=refresh_token' \
--data-urlencode 'client_id=xxxx' \
--data-urlencode 'refresh_token=eyJhbGciOiva2VuIiwiZXhwIjoxNzc4MDk5MDk0LCJjbGllbnRfaWQiOiI0ZjI5NDMgbQ' \
--data-urlencode 'audience=1234567890'

سرویس ثبت نسخه (SendEpresc)

خدمت	آدرس
ثبت نسخه (عملیاتی)	https://soa.tamin.ir/interface/epresc/SendEpresc/v2/{headerID}/{docId}
ثبت نسخه (تستی)	https://ep-test.tamin.ir/api/v2/ep/{headerID}/{docNationalCode}/{docId}/detail
ویرایش نسخه (عملیاتی)	https://soa.tamin.ir/interface/epresc/SendEpresc/v2/edit/{headerID}/{docId}
ویرایش نسخه (تستی)	https://ep-test.tamin.ir/api/v2/ep/update/{headerID}/{docNationalCode}/{docId}

پارامترهای ورودی نسخه (Prescription):

نام پارامتر	نوع
`patient`	`String`
`prescDate`	`String`
`expireDate`	`String`
`docId`	`String`
`docNationalCode`	`String`
`docMobileNo`	`String`
`prescType`	`PrescType`
`comments`	`String`
`noteDetailEprscs`	`List<NoteDetailEprsc>`
`noteDetailsReferralList`	`List<NoteDetailsReferral>`
`referralFeedbackId`	`Long`
`noteHeadEprscSupplementary`	`Complaint`

قلم نسخه (NoteDetailEprsc):

نام پارامتر	نوع
`srvId`	`Service`
`srvQty`	`Integer`
`timesAday`	`TbDrugAmount`
`dose`	`String`
`repeat`	`String`
`dateDo`	`String`
`drugInstruction`	`DrugInstruction`
`illnessId`	`String`
`planId`	`String`
`referenceStatus`	`Integer`
`isDentalService`	`String`
`toothId`	`String`
`noteDetailDrug`	`DiagnosisID`

خدمت (Service) و ساختارهای مرتبط:

ساختار	نام پارامتر	نوع
Service	`srvCode`	`String`
Service	`srvType`	`ServiceType`
Service	`parTarefGrp`	`ParTarefGroup`
Service	`terminology`	`String`
ServiceType	`srvType`	`String`
TbDrugAmount	`drugAmntId`	`Integer`
DrugInstruction	`drugInstId`	`Integer`
ParTarefGroup	`parGrpCode`	`String`

ارجاع (NoteDetailsReferral):

نام پارامتر	نوع
`id`	`Long`
`referralHijriDate`	`String`
`patientNationalCode`	`String`
`docSpecReferred`	`Special`
`message`	`String`
`icd10s`	`List<Icd10>`
`complaints`	`List<Complaint>`
`quantity`	`int`
`siamId`	`String`

نمونه بدنه درخواست ثبت نسخه:

{
    "patient": "**********",
    "prescType": {
        "prescTypeId": 7
    },
    "prescDate": "14021012",
    "docId": "*********",
    "docMobileNo": "09120000000",
    "docNationalCode": "0000000000",
    "comments": "test",
    "expireDate": "14011018",
    "creatorType": "4",
    "noteDetailEprscs": [
        {
            "srvId": {
                "srvType": {
                    "srvType": "17"
                },
                "srvCode": "046386-901"
            },
            "srvQty": 1,
            "isDentalService": 1,
            "toothId": "11"
        }
    ]
}

سرویس استحقاق سنجی بیمار (محاسبه سهم بیمار)

با استفاده از این سرویس امکان استعلام وضعیت استحقاق بیمار میسر می باشد.

محیط	آدرس
عملیاتی	https://soa.tamin.ir/interface/epresc/patient/v2/deserve-info/{siam-id}/{doc-id}/{patient-id}
تستی	https://ep-test.tamin.ir/api/v2/patients/deserve-info/{requestBy}/{siam-id}/{doc-id}/{patient-id}

سرویس با متد GET فراخوانی می شود. ورودی های سرویس عبارت اند از:

siamId: شناسه سیام درمانگاه
doc-id: کد نظام پزشک
patient-id: کد ملی بیمار
requestBy: کد ملی پزشک (فقط در محیط تست ارسال گردد)

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

فهرست سرویس ها و Endpointهای اصلی

سرویس	آدرس عملیاتی
ارجاع (تعداد)	https://soa.tamin.ir/interface/epresc/SendEpresc/v2/noteDetailsReferral/count/{nationalCode}/{docId}
یافتن ارجاع	https://soa.tamin.ir/interface/epresc/SendEpresc/v2/findNoteReferral/{masterId}/{nationalCode}
کارتابل ارجاع	https://soa.tamin.ir/interface/epresc/SendEpresc/v2/fetchReferralCartable/{docNationalCode}/{patientNationalCode}/{trackingCode}
لیست ارجاع	https://soa.tamin.ir/interface/epresc/SendEpresc/v2/referralList/{referralId}
جزییات ارجاع	https://soa.tamin.ir/interface/epresc/SendEpresc/v2/referral/noteDetail/{masterParent}/{masterChild}
خدمت دندانپزشکی بدون دندان	https://soa.tamin.ir/interface/epresc/SendEpresc/v2/find-dentist-service-name-without-tooth/{dentistType}
کارتابل پرستار (دریافت)	https://soa.tamin.ir/interface/epresc/SendEpresc/v2/cartableNurse/getAll/{siamId}/{nationalCode}
کارتابل پرستار (ثبت)	https://soa.tamin.ir/interface/epresc/SendEpresc/v2/cartableNurse/saveEprsc
دستور بستری	https://soa.tamin.ir/interface/epresc/SendEpresc/v2/hospitalization-order/fetch/{siam-id}/{secretaryNationalCode}
پذیرش بیمار (پزشک خانواده)	https://ep-test.tamin.ir/api/familyDoctor/clinicReceptionAPI/{siamid}/{nationalCode}/{docId}

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

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

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

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

گیرندگان

رونوشت

نامه سازمان تامین اجتماعی شماره ۶۱۰۰/۱۴۰۵/۵۴۳ مورخ ۱۴۰۵/۰۴/۱۴

گیرندگان

رونوشت

سند راهنمای سرویس نسخه نویسی الکترونیک سازمان تامین اجتماعی

شناسنامه سند

احراز هویت (OAuth2 با روش PKCE)

سرویس ثبت نسخه (SendEpresc)

سرویس استحقاق سنجی بیمار (محاسبه سهم بیمار)

فهرست سرویس ها و Endpointهای اصلی

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

مطالب مرتبط

نظر شما