شرکت کالارسانان چاپار ،خدمات با کیفیت و مقرون به صرفه

• ابتدا به وب‌سایت رسمی چاپار به آدرس(chaparnet.com)    مراجعه کنید.

• در صفحه اصلی سایت، روی گزینه ثبت‌نام کلیک کرده و اطلاعات مورد نیاز را وارد کنید تا حساب کاربری شما ایجاد شود.

دریافت API Key و اطلاعات اتصال

• پس از ثبت‌نام و ورود به حساب کاربری، به بخش تنظیمات API یا اتصال به وب‌سایت بروید.
• در این بخش، API Key و اطلاعات اتصال برای ارتباط وب‌سایت شما با سامانه چاپار قابل مشاهده است.

نصب افزونه چاپار در وب‌سایت فروشگاهی

• اگر وب‌سایت شما با وردپرس (WordPress) ساخته شده است، می‌توانید از افزونه چاپار برای اتصال استفاده کنید.
• برای نصب افزونه چاپار، به بخش افزونه‌ها در داشبورد وردپرس بروید و افزونه چاپار را جستجو کرده و نصب و فعال کنید.
• سپس، اطلاعات API که در مرحله قبل دریافت کرده‌اید را در تنظیمات افزونه وارد کنید تا اتصال به سامانه چاپار برقرار شود.

پیکربندی و تنظیمات وب‌سایت فروشگاهی

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

دریافت راهنمایی و پشتیبانی

• برای راهنمایی‌های بیشتر و دریافت اطلاعات کامل‌تر، می‌توانید به بخش همکاری با ما در وب‌سایت چاپار مراجعه کنید.

نکته مهم:

• اگر وب‌سایت شما از سیستم‌های مدیریت محتوای غیر وردپرس استفاده می‌کند، ممکن است نیاز به توسعه اختصاصی و برنامه‌نویسی برای اتصال به سامانه چاپار داشته باشید.

این مراحل ساده و کارآمد به شما کمک می‌کند تا وب‌سایت فروشگاهی خود را به چاپار متصل کرده و از خدمات پستی و لجستیک این شرکت بهره‌مند شوید.

در صفحه وب سایت اصلی سمت چپ بالا روی مستندات API می‌توانیم روی یک از این عملیات‌های فعال در API وصل شویم.

در وب سایت اصلی سمت چپ بالا روی گزینه افزونه‌ها کلیک می‌کنیم و یک مورد را انتخاب می‌کنیم.

پست من

اپلیکیشن Postman امکان تست ، اجرا و بررسی کد ها و متد هاي نوشته شده WebAPI را براي ما بسیار آسان می سازد.

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

ساختار تمام وب سرویس کالا رسانان چاپار با آدرس CHAPAR_CUSTOMER.postman_collection.json  قابل دسترسی می باشد.

جهت استفاده از این آدرس ابتدا باید نرم افزار پست من نصب شده باشد و سپس بتوان ساختار وب سرویس هاي چاپار را مشاهده و تست نمود.

سرویس ها

نوع ارسال

 در خروجی تمام متدها پراپرتی result , message و object وجود دارد که توضیح آنها به شرح زیر است.

پارامترهای خروجی ثابت

POSTBulk Import

https://app.krch.ir/v1/bulk_import

این متد جهت ارسال اطلاعات یک مرسوله یا تعداد زیادي از مرسولات از این وب سرویس استفاده می گردد.

پارامترهای ورودی

مثال

{

• user: {
  • username: "test",
  • password: "1234"
  },
• bulk: [
  1. {
     • cn: {
       • reference: 675675,
       • date: "2018-05-13",
       • assinged_pieces: "3",
       • service: "COD",
       • value: "3350000.00",
       • inv_value: "3350000.00",
       • payment_term: 0,
       • weight: "1",
       • note: "تست",
       • content: "تست",
       • change_state_url: https://.....
       },
     • receiver: {
       • person: "آزمایشی",
       • company: "",
       • city_no: "10770",
       • telephone: "",
       • mobile: "989034538660",
       • email: "test@test.com",
       • address: "آزمایشی",
       • post_code: "10770"
       },
     • sender: {
       • person: "آزمایشی",
       • company: "",
       • city_no: "10770",
       • telephone: "",
       • mobile: "989034538660",
       • email: "test@test.com",
       • address: "آزمایشی",
       • post_code: "10770"
       }
     }
  ]

پارامترهای خروجی

مثال

{

• result: [
  1. {
     • tracking: "54100004430128101",
     • package: [
       1. null
       ],
     • reference: 123,
     • status: true,
     • error: " (request:1,exist_package:1,exist_cons:1) "
     }
  ]

Callback URL :

اطلاعات مربوط به وضعیت جدید با نام output به URL ثبت شده با متد POST ارسال میشود.

نمونه data دریافتی :

{

• location: {
  • city: "تهران",
  • lat: "33333",
  • lng: "7777"
  },
• date: "2021-10-16 10:20:34",
• status: "OD",
• comments: "بار جهت توزیع توسط پیک ارسال شد"

POST / GETHistory Report

https://app.krch.ir/v1/bulk_import

جهت دریافت اطلاعات هر یک از محصولات ثبت شده از این متد استفاده می گردد.

پارامترهای ورودی

مثال

{

• user: {
  • username: "test",
  • password: "1234"
  },
• date: {
  • from: "25-09 -2017",
  • to: "10-10 -2017"
  },
• maximum_records: 10

پارامترهای خروجی

مثال

{

• cn: {
  • tracking: "54100004430041101",
  • date: "2020-06-17 14:20:00",
  • assinged_pieces: "4",
  • weight: "0.001",
  • service: "1",
  • value: "0",
  • payment_term: "0",
  • last_status: "OK",
  • delivery_date: "2020-06-20 13:58:08",
  • delivery_person: "تست سعید",
  • change_state_url: http://
  },
• receiver: {
  • person: "تست سعید",
  • company: null,
  • city: "تهران",
  • telephone: "02144444444",
  • mobile: "09360950049",
  • address: "تهران تستی برای تست",
  • post_code: null
  },
• financial: {
  • delivery_charge: "108945",
  • insurance_charge: "15000",
  • vat_charge: "12505",
  • pack_charge: "0",
  • extra_charge: "0",
  • cod_value: 0,
  • total_charge: 136450
  },
• history: [
  1. {
     • timestamp_date: 1592645288,
     • date: "2020-06-20 13:58:08",
     • status: "OK",
     • status_note: "بار به صورت صحیح و سالم تحویل شد"
     },
  2. {
     • timestamp_date: 1592645097,
     • date: "2020-06-20 13:54:57",
     • status: "PU",
     • status_note: "بار از مبدا جمع آوری شد"
     },
  3. {
     • timestamp_date: 1592387458,
     • date: "2020-06-17 14:20:58",
     • status: "D01",
     • status_note: "بار در سیستم ورود اطلاعات شد"
     }
  ]

POST / GETBulk History Report

https://app.krch.ir/v1/bulk_history_report

دریافت اطلاعات رهگیري N مرسوله در قالب یک گزارش ، با استفاده از این متد می توان اطلاعات رهگیري یک یا چندین بارنامه را دریافت نمود.

پارامترهای ورودی

مثال

{

• user: {
  • username: "test",
  • password: "1234"
  },
• bulk: [
  1. "54100003992527101",
  2. "54100003942527101"
  ]

پارامترهای خروجی

مثال

{

• history: [
  1. {
     • time: "01:26",
     • date: "2020-07-19",
     • status: "D01",
     • status_note: "بار در سیستم ورود اطلاعات شد",
     • tracking: "54100004430128101",
     • reference: "123"
     },
  2. {
     • time: "13:58",
     • date: "2020-06-20",
     • status: "OK",
     • status_note: "بار به صورت صحیح و سالم تحویل شد",
     • tracking: "54100004430041101",
     • reference: "9990"
     }
  ]

POST / GETCancel Pickup

https://app.krch.ir/v1/cancel_pickup

جهت حذف سفارش از این متد استفاده میشود .

پارامترهای ورودی

مثال

{

• user: {
  • username: "test",
  • password: "1234"
  },
• consignment_no: "54100004430041101",
• reason: "آزمایشی"

POST / GETGet State

https://app.krch.ir/v1/get_state

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

پارامترهای ورودی

 ساختار تعریف شده اي براي این متد وجود ندارد و با فراخوانی آدرس سرویس همین متد می توان لیست استانها را دریافت نمود.

پارامترهای خروجی

مثال

{

• state: [
  1. {
     • no: "1",
     • name: "آذربایجان شرقی"
     },
  2. {
     • no: "2",
     • name: "آذربایجان غربی"
     },
  3. {
     • no: "3",
     • name: "اردبیل"
     },
  4. {
     • no: "4",
     • name: "اصفهان"
     },
  5. {
     • no: "5",
     • name: "البرز"
     },
  6. {
     • no: "6",
     • name: "ایلام"
     },
  7. {
     • no: "7",
     • name: "بوشهر"
     },
  8. {
     • no: "8",
     • name: "تهران"
     },
  9. {
     • no: "9",
     • name: "خراسان جنوبی"
     },
  10. {
      • no: "10",
      • name: "خراسان رضوی"
      },
  11. {
      • no: "11",
      • name: "خراسان شمالی"
      },
  12. {
      • no: "12",
      • name: "خوزستان"
      },
  13. {
      • no: "13",
      • name: "زنجان"
      },
  14. {
      • no: "14",
      • name: "سمنان"
      },
  15. {
      • no: "15",
      • name: "سیستان و بلوچستان"
      },
  16. {
      • no: "16",
      • name: "فارس"
      },
  17. {
      • no: "17",
      • name: "قزوین"
      },
  18. {
      • no: "18",
      • name: "قم"
      },
  19. {
      • no: "19",
      • name: "کردستان"
      },
  20. {
      • no: "20",
      • name: "کرمان"
      },
  21. {
      • no: "21",
      • name: "کرمانشاه"
      },
  22. {
      • no: "22",
      • name: "کهکیلویه وبویراحمد"
      },
  23. {
      • no: "23",
      • name: "لرستان"
      },
  24. {
      • no: "24",
      • name: "مازندران"
      },
  25. {
      • no: "25",
      • name: "مرکزی"
      },
  26. {
      • no: "26",
      • name: "هرمزگان"
      },
  27. {
      • no: "27",
      • name: "همدان"
      },
  28. {
      • no: "28",
      • name: "چهارمحال بختیاری"
      },
  29. {
      • no: "29",
      • name: "گلستان"
      },
  30. {
      • no: "30",
      • name: "گیلان"
      },
  31. {
      • no: "31",
      • name: "یزد"
      }
  ]

POST / GETGet City

https://app.krch.ir/v1/get_city

جهت دریافت لیست شهرهایی که تحت پوشش شرکت چاپار می باشند را با استفاده از این متد دریافت نمایید.

پارامترهای ورودی

مثال

{

• state: {
  • no: 9
  }

پارامترهای خروجی

مثال

{

• objects: {
  • city: [
    1. {
       • state_no: "9",
       • no: "11907",
       • name: "آرين شهر"
       },
    2. {
       • state_no: "9",
       • no: "11925",
       • name: "آيسک"
       },
    3. {
       • state_no: "9",
       • no: "11698",
       • name: "ارسک"
       },
    4. {
       • state_no: "9",
       • no: "11735",
       • name: "اسديه"
       },
    5. {
       • state_no: "9",
       • no: "11737",
       • name: "اسفدن-خراسان جنوبي"
       },
    6. {
       • state_no: "9",
       • no: "11757",
       • name: "اسلاميه"
       },
    7. {
       • state_no: "9",
       • no: "12020",
       • name: "بشرويه"
       },
    8. {
       • state_no: "9",
       • no: "11320",
       • name: "بشرویه"
       },
    9. {
       • state_no: "9",
       • no: "11538",
       • name: "بهارستان"
       },
    10. {
        • state_no: "9",
        • no: "12120",
        • name: "بيهود"
        },
    11. {
        • state_no: "9",
        • no: "10936",
        • name: "بیرجند"
        },
    12. {
        • state_no: "9",
        • no: "12401",
        • name: "حاجي آباد-خراسان جنوبي"
        },
    13. {
        • state_no: "9",
        • no: "12504",
        • name: "خضري دشت بياض"
        },
    14. {
        • state_no: "9",
        • no: "12546",
        • name: "خوسف"
        },
    15. {
        • state_no: "9",
        • no: "17318",
        • name: "درمیان"
        },
    16. {
        • state_no: "9",
        • no: "12698",
        • name: "ديهوک"
        },
    17. {
        • state_no: "9",
        • no: "12819",
        • name: "زهان"
        },
    18. {
        • state_no: "9",
        • no: "17327",
        • name: "زیرکوه"
        },
    19. {
        • state_no: "9",
        • no: "11544",
        • name: "سدایان"
        },
    20. {
        • state_no: "9",
        • no: "12864",
        • name: "سرايان"
        },
    21. {
        • state_no: "9",
        • no: "11428",
        • name: "سرایان"
        },
    22. {
        • state_no: "9",
        • no: "12868",
        • name: "سربيشه-خراسان جنوبي"
        },
    23. {
        • state_no: "9",
        • no: "12951",
        • name: "سه قلعه"
        },
    24. {
        • state_no: "9",
        • no: "13091",
        • name: "شوسف"
        },
    25. {
        • state_no: "9",
        • no: "11328",
        • name: "طبس"
        },
    26. {
        • state_no: "9",
        • no: "13152",
        • name: "طبس مسينا"
        },
    27. {
        • state_no: "9",
        • no: "13179",
        • name: "عشق آباد-خراسان جنوبي"
        },
    28. {
        • state_no: "9",
        • no: "11348",
        • name: "فردوس"
        },
    29. {
        • state_no: "9",
        • no: "14164",
        • name: "قائنات"
        },
    30. {
        • state_no: "9",
        • no: "13283",
        • name: "قاين"
        },
    31. {
        • state_no: "9",
        • no: "11321",
        • name: "قاین"
        },
    32. {
        • state_no: "9",
        • no: "13361",
        • name: "قهستان"
        },
    33. {
        • state_no: "9",
        • no: "13751",
        • name: "محمدشهر-خراسان جنوبي"
        },
    34. {
        • state_no: "9",
        • no: "13872",
        • name: "مود"
        },
    35. {
        • state_no: "9",
        • no: "11559",
        • name: "نهبندان"
        },
    36. {
        • state_no: "9",
        • no: "14022",
        • name: "نيمبلوک"
        },
    37. {
        • state_no: "9",
        • no: "13594",
        • name: "گزو"
        },
    38. {
        • state_no: "9",
        • no: "13596",
        • name: "گزيک"
        }
    ],
  • selected: null
  }

POST / GETGet Quote

https://app.krch.ir/v1/get_quote?input=

جهت استعلام قیمت از این متد استفاده میشود .

پارامترهای ورودی

مثال

{

• order: {
  • origin: "10866",
  • destination: "10866",
  • method: "1",
  • value: "3200000",
  • weight: "4"
  }

پارامترهای خروجی

مثال

{

• order: {
  • quote: 330270,
  • price: {
    • zone: "C",
    • fld_Manual_Cost: 229000,
    • fld_Pack_Cost: 0,
    • fld_Charge_Cost: 10000,
    • fld_Manual_Insurance: 15000,
    • fld_Lab_Cost: 49000,
    • fld_Manual_VAT: 27270,
    • fld_Total_Cost: 330270,
    • price_list: "1737",
    • min_ins: "7500000"
    },
  • currency: "IRR"
  }

POST / GETTracking

https://app.krch.ir/v1/tracking?input=

جهت پیگیري مرسوله ارسالی از این متد استفاده میشود .

پارامترهای ورودی

مثال

{

• order: {
  • reference: "54100003225544101",
  • lang: "fa"
  }

پارامترهای خروجی

مثال

{

• order: {
  • delivered_to: "خسروانی",
  • delivery_time: "1397/04/20 10:27:25",
  • signature: http://,
  • geo: {
    • lat: "35.72247834",
    • lng: "51.45734967"
    },
  • history: [
    1. {
       • timestamp_date: 1531293828,
       • date: "1397/04/20",
       • status: "OD (توزیع توسط پیک)",
       • geo: {
         • lat: null,
         • lng: null
         },
       • loc: "تهران"
       },
    2. {
       • timestamp_date: 1531288645,
       • date: "1397/04/20",
       • status: "OK (سالم تحویل شد)",
       • geo: {
         • lat: "35.72247834",
         • lng: "51.45734967"
         },
       • loc: null
       },
    3. {
       • timestamp_date: 1531283244,
       • date: "1397/04/20",
       • status: "IR (اسکن ورود)",
       • geo: {
         • lat: null,
         • lng: null
         },
       • loc: "تهران"
       },
    4. {
       • timestamp_date: 1531280298,
       • date: "1397/04/20",
       • status: "OF (اسکن خروج)",
       • geo: {
         • lat: null,
         • lng: null
         },
       • loc: "تهران"
       },
    5. {
       • timestamp_date: 1531274867,
       • date: "1397/04/20",
       • status: "IR (اسکن ورود)",
       • geo: {
         • lat: null,
         • lng: null
         },
       • loc: "تهران"
       },
    6. {
       • timestamp_date: 1531258780,
       • date: "1397/04/20",
       • status: "OF (اسکن خروج)",
       • geo: {
         • lat: null,
         • lng: null
         },
       • loc: "زنجان"
       },
    7. {
       • timestamp_date: 1531258539,
       • date: "1397/04/20",
       • status: "D01 (ورود اطلاعات)",
       • geo: {
         • lat: null,
         • lng: null
         },
       • loc: "IRAN/زنجان/"
       },
    8. {
       • timestamp_date: 1531258539,
       • date: "1397/04/20",
       • status: "D01 (ورود اطلاعات)",
       • geo: {
         • lat: null,
         • lng: null
         },
       • loc: "IRAN/زنجان/"
       }
    ],
  • origin: "زنجان",
  • dest: "تهران",
  • pickup_agent_code: "3313",
  • pickup_agent: "نماینده زنجان",
  • delivery_agent_code: "1080",
  • delivery_agent: "نماینده چاپار پلاس-تهران",
  • sender_code: "1000",
  • sender_company: null,
  • sender_contact: null,
  • sender_phone: null,
  • receiver_company: null,
  • receiver_contact: null,
  • receiver_phone: "09126980570"
  }