درگاه خدمات الکترونیک شرکت پست جمهوری اسلامی ایرانی به منظور گام نهادن در اجرای دولت الکترونیک بستری را فراهم کرده است که با استفاده از آن تعدادی از سرویسها بصورت API در اختیار عموم قرار می گیرد
- سرعت بالا
- اطلاعات دقیق
- مستندات دقیق
- پیاده سازی سریع
- نمونه کد درخواست
- نمونه کد پاسخ
- گزارشات مدیریتی
- گزارشات مصرف
خدمات دولت به دستگاههای اجرایی
دریافت نشانی با کد پستی
درباره سرویس
معرفی سرویس
با استفاده از این سرویس می توانید نشانی متناظر کدپستی به صورت فیلد به فیلد با ارسال کدپستی 10 رقمی دست یابید.توجه داشته باشید نشانی پستی استاندارد به صورت زیر است: نام استان ، نام شهرستان ، نام بخش ، (نام شهر یا دهستان) ، (نام آبادی و یا روستا) ، نام محله ، نوع و نام معبر ما قبل آخر ، نوع و نام معبر آخر ، شماره پلاک ،(نوع و نام ساختمان) ، (شرح ساختمان:بلوک و یا ورودی) ، طبقه ، سمت در طبقهنمونه کد
Request Body
{ "ClientBatchID":31, "Postcodes":[ {"ClientRowID":122,"PostCode":"1634864331"} ], "Signature":"" }
Response Body
{ "ResCode": 0, "ResMsg": "موفق", "Data": [ { "ClientRowID": 122, "Postcode": "112233", "Succ": false, "Result": null, "Errors": [ { "ErrorCode": 1001, "ErrorMessage": "کد پستی نامعتبر است." } ] }, { "ClientRowID": 120, "Postcode": "1631713911", "Succ": true, "Result": { "TraceID": 502651321, "ErrorCode": 0, "Province": "تهران - منطقه 16", "TownShip": "تهران", "Zone": "مرکزی", "Village": "", "LocalityType": "شهر", "LocalityName": "تهران", "LocalityCode": 99999, "SubLocality": "سیدخندان", "Street": "خیابان شهید آّیت اله قدوسی", "Street2": "خیابان دکترعلی شریعتی", "HouseNumber": 0.0, "Floor": "اول", "SideFloor": "", "BuildingName": "ساختمان شرکت پست", "Description": "ورودی20", "PostCode": "1631713911" }, "Errors": null }, { "ClientRowID": 121, "Postcode": "1634833333", "Succ": false, "Result": null, "Errors": [ { "ErrorCode": 9040, "ErrorMessage": "خطای سرویس دهنده: کد پستی یافت نشد" } ] } ] }
دریافت نشانی به صورت رشتهای با کد پستی
درباره سرویس
معرفی سرویس
دریافت نشانی به صورت رشته ای با ارسال کدپستی 10 رقمینمونه کد
Request Body
{ "ClientBatchID":31, "Postcodes":[ {"ClientRowID":122,"PostCode":"1634864331"} ], "Signature":"" }
Response Body
{ "ResCode": 0, "ResMsg": "موفق", "Data": [ { "ClientRowID": 122, "Postcode": "112233", "Succ": false, "Result": null, "Errors": [ { "ErrorCode": 1001, "ErrorMessage": "کد پستی نامعتبر است." } ] }, { "ClientRowID": 120, "Postcode": "1631713911", "Succ": true, "Result": { "TraceID": 502652297, "Value": "استان تهران - منطقه 16 ، شهرستان تهران ، بخش مرکزی ، شهر تهران، محله سیدخندان ، خیابان شهید آّیت اله قدوسی ، خیابان دکترعلی شریعتی ، پلاک 0 ، ساختمان شرکت پست ، ورودی20 ، طبقه اول", "ErrorCode": 0, "PostCode": "1631713911" }, "Errors": null }, { "ClientRowID": 121, "Postcode": "1634833333", "Succ": false, "Result": null, "Errors": [ { "ErrorCode": 9040, "ErrorMessage": "خطای سرویس دهنده: کد پستی یافت نشد" } ] } ] }
دریافت مختصات جغرافیایی با کدپستی
درباره سرویس
معرفی سرویس
دریافت مختصات جغرافیایی (طول و عرض) با استفاده از کد پستی 10 رقمینمونه کد
Request Body
{ "ClientBatchID":31, "Postcodes":[ {"ClientRowID":122,"PostCode":"1634864331"} ], "Signature":"" }
Response Body
{ "ResCode": 12, "ResMsg": "ناموفق", "Data": [ { "ClientRowID": 122, "Postcode": "1634864331", "Succ": false, "Result": null, "Errors": [ { "ErrorCode": 9040, "ErrorMessage": "خطای سرویس دهنده: مختصاتی برای کد جغرافیایی یافت نشد" } ] } ] }
تولید گواهی کد پستی (قبلا اشتباها اعتبارسنجی و دریافت اطلاعات گواهی کدپستی بود)
درباره سرویس
معرفی سرویس
تولید گواهی کدپستی با استفاده از کدپستی 10 رقمی با فراخوانی این متد و ارسال کدپستی ده رقمی ، گواهی کدپستی مربوط به کدپستی ارسالی تولید می گردد.اعتبار این گواهی از تاریخ صدور 15 روز است و دارای کد شناسایی یکتای 20 رقمی است که به صورت بارکد بر روی گواهی چاپ می گردد. پس از فراخوانی متد برای مشاهده و چاپ گواهی می بایست نشانی اینرنتی (URL) ذخیره شده در فیلد CertificateUrl را در یک مرورگر وب باز کرده و پس از بارگذاری شدن صفحه با کلیک بر روی دکمه "چاپ" و یا "دریافت گواهی به صورت PDF" اقدام به چاپ و یا ذخیره سازی گواهی تولید شده کنید.نمونه کد
Request Body
{ "ClientBatchID":31, "Postcodes":[ {"ClientRowID":122,"PostCode":"1634864331"} ], "Signature":"" }
Response Body
{ "ResCode": 0, "ResMsg": "موفق", "Data": [ { "ClientRowID": 122, "Postcode": "1634864331", "Succ": true, "Result": { "TraceID": 445401594, "ErrorCode": 0, "Province": "تهران - منطقه 16", "TownShip": "تهران", "Zone": "مرکزی", "Village": "", "LocalityType": "شهر", "LocalityName": "تهران", "LocalityCode": 99999, "SubLocality": "رسالت", "Street": "خیابان کرمان", "Street2": "خیابان شهید برادران اردستانی", "HouseNumber": 44.0, "Floor": "سوم", "SideFloor": "9", "BuildingName": "ساختمان میلاد نور", "Description": "بلوک شمالی", "PostCode": "1634864331" }, "Errors": null } ] }
اعتبارسنجی کدپستی
درباره سرویس
معرفی سرویس
اعتبار سنجی کد پستی ده رقمی ، در صورتی که کدپستی ارسال شده در بانک اطلاعاتی موجود باشد مقدار True و در غیر این صورت مقدار False برگرداننده می شود.نمونه کد
Request Body
{ "ClientBatchID":31, "Postcodes":[ {"ClientRowID":122,"PostCode":"1631713911"} ], "Signature":"" }
Response Body
{ "ResCode": 0, "ResMsg": "موفق", "Data": [ { "ClientRowID": 122, "Postcode": "112233", "Succ": false, "Result": null, "Errors": [ { "ErrorCode": 1001, "ErrorMessage": "کد پستی نامعتبر است." } ] }, { "ClientRowID": 120, "Postcode": "1631713911", "Succ": true, "Result": { "Value": true, "ErrorCode": 0, "TraceID": 502662303 }, "Errors": null }, { "ClientRowID": 121, "Postcode": "1558733333", "Succ": true, "Result": { "Value": false, "ErrorCode": 0, "TraceID": 502662304 }, "Errors": null } ] }
مراحل درخواست استفاده از سرویس:
نامه درخواست اتصال به سامانه GNAF
دانلود نمونه تفاهم نامه
دانلود نمونه تفاهم نامه شهرداری
ثبت درخواست
روش پرداخت PrePay
بسته پایه 10000 تایی - 30 روزه
-
اعتبار: 30 روز
-
پرداخت آنلاین هزینه بسته
فعالسازی خودکار بعد از پرداخت
پشتیبانی فنی
بسته پایه 5000 تایی - 30 روزه
-
اعتبار: 30 روز
-
مناسب برای استارت آپ ها
پرداخت آنلاین هزینه بسته
فعالسازی خودکار بعد از پرداخت
پشتیبانی فنی
بسته پایه 1000 تایی - 30 روزه
-
اعتبار: 30 روز
-
مناسب برای استارت آپ ها
پرداخت آنلاین هزینه بسته
فعالسازی خودکار بعد از پرداخت
پشتیبانی فنی
روش پرداخت postpaid
در این شرایط میزان عملکرد، طی دوره زمانی مشخص محاسبه و فرآیند تسویه حساب بصورت ماهیانه خواهد بوددر ضمن در این روش ضمانت نامه بانکی با توجه به سقف مصرف در ماه محاسبه و اخذ می گردد.
کدپستی ده رقمی چیست؟
كد پستی علائمی است كه معرف یك محدودة جغرافیایی تعریف شده در پست میباشد. به عبارت دیگر در بیشتر ادارات پست كشورهای جهان بمنظور انجام عملیات پستی ، محدودة جغرافیایی كشور خود را به قطعات جغرافیایی كوچكتری تقسیم نموده اند و برای شناسایی آنها علائمی را بكار گرفتهاند . به هریك از علائم مذكور كه به این قطعات اختصاص پیدا كرده است ، كد پستی گفته می شود. علائم مورد استفاده در كد پستی معمولا اعداد بوده و در برخی كشورها از تركیب حروف و اعداد استفاده شده است . کدپستی ده رقمی در ایران عددی است یگانه كه توسط شركت پست جمهوری اسلامی ایران (بر اساس ماده 1 آیین نامه اجرائی قانون الزام اختصاص شماره ملی و كدپستی برای كلیه اتباع ایرانی) تنها برای شناسایی هر مكان تعیین و به آن اختصاص داده می شود.
سرویس های پایه کدپستی کدام است؟
بر اساس بند ث ماده 67 قانون برنامه پنجساله ششم توسعه ، در خصوص تبادل الکترونیکی اطلاعات و پاسخگویی الکترونیکی به استعلام های مورد نیاز دستگاههای اجرایی و همچنین مطابق با ماده 11 آیین نامه توسعه خدمات الکترونیکی دستگاههای اجرایی مبنی بر الزام دستگاههای مذکور بر انطباق اطلاعات اشتراکات سازمانی خود با نشانی و کدپستی ده رقمی مکان مربوطه، شرکت ملی پست ملزم است وب سرویس پایه کدپستی خود که شامل متدهای "دریافت نشانی استاندارد از طریق کدپستی" و "دریافت مختصات جغرافیایی ساختمان از طریق کدپستی" (این متد تنها برای محدوده هایی است که توسط شرکت ملی پست ژئوکد گردیده است) را در اختیار دستگاههای اجرایی کشور اعم از دولتی و عمومی غیردولتی بصورت رایگان قرار می دهد.
خدمت اعتبار سنجی نشانی شهروندان چیست؟
سرویس اعتبارسنجی نشانی شهروند، خدمت نوین پستی است که به اشخاص حقیقی یا حقوقی (دولتی و خصوصی) این امکان را می دهد تا بر اساس ساز و کارهای اجرایی که تلفیقی از خدمات الکترونیکی و فیزیکی است، اعتبار نشانی پستی مشتریان و مخاطبان خود را اعتبار سنجی نمایند.
بستر مرکز ملی تبادل اطلاعات برای چیست؟
یکپارچه سازی اطلاعات و خدمات در راستای تحقق دولت الکترونیک نیازمند وجود بستری برای تبادل و به اشتراک گذاری دادهها، اطلاعات و خدمات است. این عمل در لایههای مختلف و در فرایندهای کاری ارائه خدمات صورت میگیرد. پیاده سازی دولت الکترونیک نیازمند آن است که تمامی سازمانهای دولتی برای ارائه خدمات خود دادهها را در دسترس سایرین قرار دهند و با استفاده از فناوری اطلاعات تسهیل در کسب و کار و ارائه هر چه سریعتر خدمت را فراهم آورند که این مهم تنها از طریق اتصال به بسترهای مرکز ملی تبادل اطلاعات ( GSB و PGSB ) دست می یابد . GSB(Government Service Bus) : به مفهوم گذرگاه خدمات دولت و یکی از ارکان اصلی توسعه زیرساخت دولت الکترونیک می باشد. GSB در حقیقت بستر مشترکی است که در آن برای تسهیل تبادل اطلاعات ناهمگون دولت، سیستمهای واسط نرم افزاری و سخت افزاری با ساختار یکپارچه طراحی شده است تا رد و بدل اطلاعات میان سازمانهای دولتی به صورت امن و در حداقل زمان ممکن انجام گیرد. بستر گذرگاه GSB منفصل از اینترنت میباشد و شبکههای اختصاصی تمام سرویس دهندگان و سرویس گیرندگان این بستر نیز می بایست منفصل از اینترنت باشند. PGSB(Public Government Service Bus) : به مفهوم گذرگاه عمومی خدمات دولت و جهت ارائه خدمات سازمانهای دولتی و بخشهای خصوصی به یکدیگر در بستر اینترنت میباشد. به عبارت دیگر این بستر جهت ارائه خدمات به سرویس دهندگان و سرویس گیرندگانی پیاده سازی شده است که بستر ارائه خدمات و یا استفاده از خدمات آنها به اینترنت متصل است. بسترهای GSB و PGSB از لحاظ طراحی و پیاده سازی سخت افزاری و نرم افزاری کاملا از هم جدا میباشند. راه اندازی بسترهای مراکز ملی تبادل اطلاعات ( GSB و PGSB ) از دو جنبه دارای اهمیت می باشد: • یکپارچه سازی سازمانهای دولتی به عنوان ارائه دهنده سرویس و اطلاعات برای استفاده در سایر بخشها در قالبی استاندارد و متحد الشکل • هر سازمان دولتی یا بخش خصوصی به عنوان دریافت کننده سرویس بتواند به این بستر یکپارچه متصل شده و از خدمات سایر بخش ها استفاده کند
در صورتی که دستگاهی تمایل به ارائه سرویس / سرویس هایی بر روی گذرگاه خدمات دولت باشد، چه اقداماتی را می بایست انجام دهد؟
اگر دستگاهی تمایل به ارائه سرویس بر روی گذرگاه خدمات دولت (GSB) را داشته باشد ضمن ارسال نامه درخواست رسمی به سازمان فناوری اطلاعات ایران لازم است اطلاعات ذیل را جهت پیاده سازی سرویس در مرکز ملی تبادل اطلاعات ارائه نماید: * اطلاعات کارشناس رابط شامل نام و نام خانوادگی، کد ملی، شماره تماس * اطلاعات فنی سرویس شامل آدرس معتبر سرویس بر روی شبکه دایر شده تا مرکز ملی تبادل اطلاعات، راهنمای استفاده از سرویس، نمونه داده آزمایشی ورودی جهت فراخوانی سرویس و در صورت نیاز به نام کاربری و کلمه عبور اختصاص نام کاربری و کلمه عبور آزمایشی و موقت برای سازمان فناوری اطلاعات ایران
در صورتی که دستگاهی تمایل به دریافت خدمات الکترونیکی از مرکز ملی تبادل اطلاعات را داشته باشد، چه اقداماتی را میبایست انجام دهد؟
1. متقاضی با دستگاه سرویسدهنده مذاکره نموده و مجوز بهره¬برداری از سرویس مورد نظر را از دستگاه متولی سرویس اخذ و به سازمان فناوری اطلاعات ایران اعلام نماید. (به دلیل اینکه سازمان فناوری اطلاعات ایران متولی سرویس نیست، لذا به هیچ عنوان اجازه ارائه سرویس بدون مجوز مربوطه وجود ندارد.) 2. با توجه به اینکه سرویس دریافتی برای چه کاربردی مدنظر است، متقاضی بایستی نسبت به انتخاب گذرگاه عمومی خدمات دولت (PGSB) یا گذرگاه اختصاصی خدمات دولت (GSB) اقدام نماید. مهمترین نکتهای که در خصوص انتخاب نوع گذرگاه بایستی مد نظر قرار گیرد، این است که سرویس دریافتی از GSB بایستی در یک شبکه اختصاصی و منفصل از اینترنت مورد استفاده قرار گیرد، لیکن سرویس دریافتی از PGSB میتواند در سامانههای مستقر بر بستر اینترنت مورد استفاده قرار گیرد. پس از آن متقاضی میتواند به نشانی https://iran.gov.ir/gsb مراجعه و نسبت به تکمیل فرمهای مربوط به اتصال به مرکز ملی تبادل اطلاعات اقدام نماید.
در صورتی که دستگاه متقاضی به شبکه مرکز ملی تبادل اطلاعات متصل باشد، چگونه میتواند از سرویسهای موجود در مرکز ملی تبادل اطلاعات بهرهمند شود؟
در این حالت دستگاه متقاضی دریافت سرویس می¬بایست با دستگاه سرویس دهنده مذاکره نموده و نیاز است دستگاه متولی سرویس از طریق روال اداری مجوز بهره¬برداری از سرویس مورد نظر را به سازمان فناوری اطلاعات ایران اعلام نماید. (به دلیل اینکه سازمان فناوری اطلاعات ایران متولی سرویس نیست، لذا به هیچ عنوان اجازه ارائه سرویس بدون مجوز مربوطه وجود ندارد) دستگاه متقاضی سپس می¬بایست نماینده خود را جهت دریافت اطلاعات و مستندات راهنمای فنی مربوطه، طی نامهای به سازمان معرفی کند و نام و نام خانوادگی، کد ملی، شماره تماس و نشانی رایانامه (Email) وی (صرفاً روی نام دامنه اداری دستگاه متقاضی) را به همراه عنوان سرویس مورد نظر اعلام نماید.
در صورت وجود مجوز بهرهبرداری از سرویس برای دستگاه متقاضی، چگونه اطلاعات سرویس را دریافت نماید؟
پس از حصول اطمینان در خصوص وجود مجوز توسط سازمان فناوری اطلاعات ایران، دستگاه متقاضی سپس می¬بایست نماینده خود را جهت دریافت اطلاعات و مستندات راهنمای فنی مربوطه، طی نامهای به سازمان معرفی کند و نام و نام خانوادگی، کد ملی، شماره تماس و نشانی رایانامه (Email) وی (صرفاً روی نام دامنه اداری دستگاه متقاضی) را به همراه عنوان سرویس مورد نظر اعلام نماید.