جزئیات قبض گاز

آدرس سرویس:POST https:/carbon/v4.0/bill_service/inquiry/gas_bill_details

---

شرح

این سرویس جهت استعلام جزئیات قبض آب مورد استفاده قرار می گیرد.

---

Headers

مقادیر زیر باید در هدر قرار بگیرد

  Authorization : Bearer {Token}
  clientAddress : client IP

توجه : برای دریافت توکن مربوطه به بخش سرویس توکن مراجعه فرمایید

توضیحات

• Authorization: در این قسمت توکن دریافت شده از سرویس توکن را وارد نمایید

• clientAddress: آی پی سروری که سرویس را فراخوانی کرده است

Parameters

• request_number(نوع داده عددی):(اجباری) این شناسه جهت پیگیری های بعدی مورد استفاده قرار می گیرد و پیشنهاد میگردد یه شناسه یکتا به ازای هر درخواست توسط سامانه مشتری تولید و به این سرویس ارسال گردد. سامانه ابری کربن هیچ کنترلی برروی عدم تکراری بودن این مقدار انجام نمی دهد.

• bill_id (نوع داده عددی): (اجباری) شناسه قبض گاز (در صورت وارد کردن شماره اشتراک ، این بخش باید خالی باشد.)

• participate_code (نوع داده عددی):(اجباری) شماره اشتراک (در صورت وارد کردن شناسه قبض ، این بخش باید خالی باشد.)

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

curl --location 'https:/carbon/v4.0/bill_service/inquiry/gas_bill_details' \
--header 'Content-Type: application/json' \
--header 'accept: application/json' \
--header 'clientAddress: xxx' \
--header 'Authorization: ••••••' \
--data '{
    "request_number": "202511122024",
    "bill_id": "....",
    "participate_code":""
}'

جواب موفق:

{
    "status": "0",
    "message": "تراکنش با موفقیت انجام شد",
    "timestamp": "2025-12-10 11:25:11.546",
    "tracking_number": "859668675",
    "request_number": "202511122024",
    "result": {
        "amount": "0",
        "bill_id": "....",
        "payment_id": "null",
        "payment_date": "11/22/2025 00:00:00",
        "full_name": " ",
        "address": " ",
        "description": {
            "تعداد واحد": "1",
            "نوع مصرف": "40-خانگی",
            "کد حوزه": "1",
            "گروه": "B",
            "شماره اشتراک": "3...436",
            "سریال کنتور": "4.467",
            "کد آدرس": "03..01",
            "شماره پرونده": "7.9",
            "ظرفیت": "6",
            "رقم شمارشگر پیشین": "2.6",
            "رقم شمارشگر فعلی": "2.6",
            "کارکرد شمارشگر": "10",
            "بهای گاز مصرفی": "19,295 ریال",
            "آبونمان": "0 ریال",
            "عوارض": "2,895 ریال",
            "بیمه": "11,179 ریال",
            "بدهی متفرقه": "0 ریال",
            "مانده بدهی": "44,000 ریال",
            "تعداد بدهی": "1",
            "شماره سری": "132",
            "مانده مبلغ هزار ریال": "0 ریال",
            "کسر مبلغ هزار ریال": "50 ریال",
            "عوارض گازرسانی به روستا": "1,931 ریال",
            "بستانکاری": "0",
            "تعداد روزهای مصرف": "34",
            "تاریخ صدور": "1404-08-21",
            "افزایش گازبها": "0",
            "تخفیف گازبها": "0",
            "بخشودگی گازبها": "0"
        }
    },
    "transaction_details": {
        "available_wallet_balance": "101923000",
        "provider_name": "Pertikan",
        "service_price": "....",
        "curency": "IRR",
        "remaining_number_of_calls": "1000",
        "remaining_number_of_calls_day": "1000"
    },
    "errors": {}
}

جواب ناموفق:

{
    "status": "1",
    "message": "تراکنش ناموفق",
    "timestamp": "2025-12-09 15:04:54.445",
    "tracking_number": "20251209150454442",
    "req_id": "202508162015",
    "result": {},
    "transaction_detials": {},
    "errors": {
        "error_code": "6001",
        "error_description": "invalid input parameter: bill_id is not found ",
        "reference_name": "bill_id",
        "original_value": ""
    }
}

• status: عدد 0 به معنی موفق و عدد 1 به معنی ناموفق می باشد .
• message: پاسخ از طرف سرویس سامانه ابری
• timestamp : زمان و تاریخ درخواست
• request_number: شماره پیگیری ارسال شده در زمان فراخوانی
• tracking_number: شماره پیگیری ایجاد شده توسط سامانه ابری کربن جهت بررسی های بعدی
• result: آبجکتی از پاسخ سرویس شامل:
• amount : مبلغ قبض
• bill_id :شناسه قبض وارد شده
• payment_id: شناسه پرداخت قبض
• payment_date: تاریخ پرداخت قبض
• full_name: نام کامل محله
• address: آدرس
• description: توضیحات مربوط به محل سکونت
• provider_name: نام ارائه دهنده
• service_price: قیمت سرویس

در صورت بروز خطا در درخواست :

• errors: جزییات خطا
• errors: جزییات خطا
• error_code: کد مربوط به خطایی که پیش آمده است
• error_description: متن خطا
• reference_name: اطلاعات تکمیلی خطا
• original_value: اطلاعات تکمیلی خطا

---