درگاه خدمات الکترونیک شرکت پست جمهوری اسلامی ایرانی به منظور گام نهادن در اجرای دولت الکترونیک بستری را فراهم کرده است که با استفاده از آن تعدادی از سرویسها بصورت 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 رقمی با استفاده از تلفن ثابتنمونه کد
Request Body
{ "ClientBatchID":7, "Telephones":[ {"ClientRowID":120,"AreaCode":21,"TelephoneNo":88462820} ], "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": 502653084, "ErrorCode": 0, "Telephones": [ { "AreaCode": 21, "SubscriberNumber": 88462087 }, { "AreaCode": 21, "SubscriberNumber": 88462820 } ] }, "Errors": null }, { "ClientRowID": 121, "Postcode": "1634833333", "Succ": false, "Result": null, "Errors": [ { "ErrorCode": 9040, "ErrorMessage": "خطای سرویس دهنده: شماره تلفن در پایگاه داده یافت نشد" } ] } ] }
اعتبارسنجی و دریافت اطلاعات گواهی کدپستی(قبلا اشتباها نامش تولید گواهی کدپستی بود)
درباره سرویس
معرفی سرویس
دریافت اطلاعات مربوط به گواهی کدپستی با استفاده از شناسه یکتای گواهی کدپستی (بارکد میله ای چاپ شده بر روی گواهی کدپستی)نمونه کد
Request Body
{ "ClientBatchID":31, "Postcodes":[ {"ClientRowID":122,"PostCode":"1558733333"} ], "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": { "CertificateUrl": "http://epostcode.post.ir/postcode/cert/0b7131ec-9177-44df-9d16-941e577cacd6", "TraceID": 502662023, "ErrorCode": 0, "CertificateNo": "21131888453435550735", "Province": "تهران - منطقه 16", "TownShip": "تهران", "Zone": "مرکزی", "Village": "", "LocalityType": "شهر", "LocalityName": "تهران", "LocalityCode": 99999, "SubLocality": "سیدخندان", "Street": "خیابان شهید آّیت اله قدوسی", "Street2": "خیابان دکترعلی شریعتی", "HouseNumber": 0.0, "Floor": "اول", "SideFloor": "", "BuildingName": "ساختمان شرکت پست", "Description": "ورودی20", "PostCode": "1631713911" }, "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
دانلود نمونه قرارداد روش پرداخت postpaid
دانلود نمونه قرارداد روش پرداخت PrePay
ثبت درخواست
روش پرداخت PrePay
بسته پایه 10000 تایی - 30 روزه
-
اعتبار: 30 روز
-
پرداخت آنلاین هزینه بسته
فعالسازی خودکار بعد از پرداخت
پشتیبانی فنی
بسته پایه 5000 تایی - 30 روزه
-
اعتبار: 30 روز
-
مناسب برای استارت آپ ها
پرداخت آنلاین هزینه بسته
فعالسازی خودکار بعد از پرداخت
پشتیبانی فنی
بسته پایه 1000 تایی - 30 روزه
-
اعتبار: 30 روز
-
مناسب برای استارت آپ ها
پرداخت آنلاین هزینه بسته
فعالسازی خودکار بعد از پرداخت
پشتیبانی فنی
روش پرداخت postpaid
در این شرایط میزان عملکرد، طی دوره زمانی مشخص محاسبه و فرآیند تسویه حساب بصورت ماهیانه خواهد بوددر ضمن در این روش ضمانت نامه بانکی با توجه به سقف مصرف در ماه محاسبه و اخذ می گردد.
روش پرداخت postpaid چگونه است؟
در روش postpaid طرف قرارداد (درخواست کننده سرویس) پس از تأیید شرایط اخذ سرویس و کسب مجوز برای دریافت آن، بدون پرداخت هزینهای قرارداد را منعقد و سپس با برقراری ارتباط شبکه ای و پیاده سازی API وب سرویس متدهای موردنظر خود (متدهای تأیید شده)، سرویس را دریافت و بهره برداری می نماید و هزینه مصرف را بر اساس تعداد تراکنش های موفق صورت گرفته در پایان هر ماه و در قبال فاکتوری که مجری قرارداد برای ایشان صادر می نماید پرداخت می کند. در روش فوق ارائه ضمانت نامه بانکی از سوی درخواست کننده سرویس لازم الزامی است.
روش پرداخت prepay چگونه است؟
در روش prepay، طرف قرارداد (درخواست کننده سرویس) پس از تأیید شرایط اخذ سرویس و کسب مجوز برای دریافت آن، می بایست قرارداد خود را با سرویس دهنده منعقد نموده و سپس با برقراری ارتباط شبکه ای و پیاده سازی API وب سرویس متدهای موردنظر خود (متدهای تأیید شده)، یکی از بسته های سرویس را بنا به نیاز خود انتخاب و هزینه مربوطه را پرداخت نماید. در این روش با توجه به اینکه هزینه سرویس پیش از مصرف پرداخت شده است، دیگر فاکتوری از سوی مجری قرارداد برای ایشان صادر نمی گردد و سرویس گیرنده می تواند تا پایان مدت قرارداد هر یک از بسته هایی را که نیاز دارد انتخاب و سرویس را دریافت نماید. باید توجه داشت در این روش در یک زمان نمی توان دو بسته انتخاب نموده و برای انتخاب بسته جدید لازم است اعتبار بسته قبلی (اعتبار از نظر حجم و یا زمان) به پایان رسیده باشد.
خدمت اعتبار سنجی نشانی شهروندان چیست؟
سرویس اعتبارسنجی نشانی شهروند، خدمت نوین پستی است که به اشخاص حقیقی یا حقوقی (دولتی و خصوصی) این امکان را می دهد تا بر اساس ساز و کارهای اجرایی که تلفیقی از خدمات الکترونیکی و فیزیکی است، اعتبار نشانی پستی مشتریان و مخاطبان خود را اعتبار سنجی نمایند.
کدپستی ده رقمی چیست؟
كد پستی علائمی است كه معرف یك محدودة جغرافیایی تعریف شده در پست میباشد. به عبارت دیگر در بیشتر ادارات پست كشورهای جهان بمنظور انجام عملیات پستی ، محدودة جغرافیایی كشور خود را به قطعات جغرافیایی كوچكتری تقسیم نموده اند و برای شناسایی آنها علائمی را بكار گرفتهاند . به هریك از علائم مذكور كه به این قطعات اختصاص پیدا كرده است ، كد پستی گفته می شود. علائم مورد استفاده در كد پستی معمولا اعداد بوده و در برخی كشورها از تركیب حروف و اعداد استفاده شده است . کدپستی ده رقمی در ایران عددی است یگانه كه توسط شركت پست جمهوری اسلامی ایران (بر اساس ماده 1 آیین نامه اجرائی قانون الزام اختصاص شماره ملی و كدپستی برای كلیه اتباع ایرانی) تنها برای شناسایی هر مكان تعیین و به آن اختصاص داده می شود.