استعلام مرسوله پستی

آدرس سرویس: POST https:/carbon/v4.0/public_service/inquiry/post_tracking

---

شرح

این سرویس جهت استعلام مرسوله پستی مورد استفاده قرار می گیرد.

---

Headers

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

  Authorization : Bearer {Token}
  clientAddress : client IP

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

توضیحات

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

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

Parameters

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

• postal_barcode (نوع داده عددی) : (اجباری) بارکد پستی

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

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

جواب موفق:

{
    "status": "0",
    "message": "تراکنش با موفقیت انجام شد",
    "timestamp": "2025-12-10 13:24:35.885",
    "tracking_number": "859673710",
    "request_number": "202511122024",
    "result": {
        "post_type": "",
        "source_post_office": "",
        "source": "",
        "destination": "",
        "sender_name": "",
        "receiver_name": "",
        "source_postal_code": "",
        "destination_postal_code": "",
        "weight": "",
        "total_amount": "",
        "details": [
            {
                "date": "1404/06/29",
                "time": "10:02",
                "action": "",
                "postal_node": "",
                "action_id": "4",
                "count": 1
            },
            {
                "date": "1404/07/01",
                "time": "12:50",
                "action": "",
                "postal_node": "",
                "action_id": "4",
                "count": 1
            },
            {
                "date": "1404/07/01",
                "time": "11:28",
                "action": "",
                "postal_node": "",
                "action_id": "4",
                "count": 1
            },
            {
                "date": "1404/07/02",
                "time": "10:31",
                "action": "",
                "postal_node": "",
                "action_id": "4",
                "count": 1
            },
            {
                "date": "1404/07/02",
                "time": "10:39",
                "action": "",
                "postal_node": "",
                "action_id": "4",
                "count": 1
            },
            {
                "date": "1404/07/02",
                "time": "16:42",
                "action": "",
                "postal_node": "",
                "action_id": "4",
                "count": 1
            },
            {
                "date": "1404/07/02",
                "time": "09:10",
                "action": "",
                "postal_node": "",
                "action_id": "4",
                "count": 1
            }
        ]
    },
    "transaction_details": {
        "available_wallet_balance": "101819000",
        "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-10 13:49:42.253",
    "tracking_number": "20251210134942251",
    "req_id": "202511122024",
    "result": {},
    "transaction_detials": {},
    "errors": {
        "error_code": "6001",
        "error_description": "invalid input parameter: postal_barcode is not found ",
        "reference_name": "postal_barcode",
        "original_value": ""
    }
}

• status: عدد 0 به معنی موفق و عدد 1 به معنی ناموفق می باشد
• message: پاسخ از طرف سرویس سامانه ابری کربن
• timestamp : زمان و تاریخ درخواست
• request_number: شماره پیگیری ارسال شده در زمان فراخوانی
• tracking_number: شماره پیگیری ایجاد شده توسط سامانه ابری کربن جهت بررسی های بعدی
• result: آبجکتی از پاسخ سرویس شامل:
• post_type : مدل پست
• source_post_office : دفتر پست مبدا
• source: مبدا
• destination: مقصد
• sender_name: نام ارسال کننده
• receiver_name: نام دریافت کننده
• source_postal_code: کد پستی مبدا
• destination_postal_code: کد پستی مقصد
• weight: وزن
• total_amount: مقدار نهایی
• details: در این قسمت کار انجام شده در هر مرحله و ساعت را مشخص می کند .
• date: تاریخ
• time: زمان
• action: حرکت انجام شده
• postal_node: منطقه پستی
• action_id: شناسه حرکت
• count: شمارنده

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

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

---