سفارش شما،
قدم بعدی: ارسال.

سرویس‌های حمل‌ونقل ایران را به برنامه PHP خود وصل کنید. با یک رابط مشترک، هزینه را بگیرید، مرسوله را ثبت کنید و وضعیت آن را دنبال کنید.

composer require eram/ersal:^0.2@beta
یک مرسوله در برنامه شماDEMO-1042
ازتهران
بهشیراز
یک ساختار مشترک برای مرسولهShipmentInterface

پیش از فرستادن بسته

وزن یکسان، حجم متفاوت.

نمونه‌های اجراشده با PHP
وزن واقعی۱٬۵۰۰ گرم
خروجی شیء Parcel
۱٬۵۰۰گرم
chargeableWeightGrams()

در این نمونه، وزن واقعی از وزن حجمی بیشتر است.

وزن واقعی
۱٬۵۰۰ g
وزن حجمی
۱٬۲۰۰ g
دیدن کد PHP
use Eram\Ersal\Address\Parcel;

$parcel = new Parcel(
    weightGrams: 1500,
    lengthMm: 300,
    widthMm: 200,
    heightMm: 100,
);

$parcel->volumetricWeightGrams(); // 1200
$parcel->chargeableWeightGrams(); // 1500

محاسبه با تابع Parcel در ارسال و ضریب ثابت ۵۰۰۰ انجام شده است. این عدد، قیمت یا وزن قطعی مبنای محاسبه شرکت حمل‌ونقل نیست؛ قواعد سرویس را بررسی کنید. دکمه‌ها خروجی ذخیره‌شده PHP را نشان می‌دهند.

از سفارش تا رهگیری

مرسوله‌ای که برنامه شما می‌شناسد.

رابط تیپاکس · پاسخ‌های شبیه‌سازی‌شده
پاسخ نمونه استعلام۸۵٬۰۰۰ تومان

پاسخ شبیه‌سازی‌شده برای سرویس عادی؛ این مبلغ، تعرفه فعلی تیپاکس نیست.

کد این مرحله
use Eram\Ersal\Request\QuoteRequest;

$quotes = $provider->quote(new QuoteRequest(
    origin: $origin,
    destination: $destination,
    parcel: $parcel,
));

$quotes[0]->cost->inToman(); // 85000 (fixture)
تنظیم سرویس و نشانی‌ها

اطلاعات حساب سرویس را در سرور تنظیم کنید. مراحل بالا از این اشیا استفاده می‌کنند؛ درخواست واقعی به مشخصات معتبر گیرنده و توکن خودتان نیاز دارد.

use Eram\Ersal\Ersal;
use Eram\Ersal\Provider\Tipax\TipaxConfig;
use Eram\Ersal\Address\{Address, Parcel};

$provider = (new Ersal())->create('tipax',
    new TipaxConfig(token: $yourToken)
);

// Replace these sample addresses with real order details.
$origin = new Address(
    'Demo', 'Shop', '09000000000',
    'تهران', 'تهران', 'نشانی نمونه'
);
$destination = new Address(
    'Demo', 'Recipient', '09000000000',
    'فارس', 'شیراز', 'نشانی نمونه'
);
$parcel = new Parcel(
    weightGrams: 1500,
    lengthMm: 300, widthMm: 200, heightMm: 100,
);

این نمونه با Ersal 0.2.0-beta.2 و پاسخ HTTP شبیه‌سازی‌شده اجرا شده است. قیمت، نشانی و اطلاعات رهگیری همگی نمونه‌اند. این صفحه با شرکت حمل‌ونقل ارتباطی ندارد و مرسوله‌ای ثبت نمی‌کند.

هفت رابط با امکانات متفاوت

امکانات مورد نیاز سفارش را پیدا کنید.

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

واحدهایی مشخص در کد.

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

نشانی و بسته

با زیرساخت خودتان کار کنید.

کلاینت HTTP، ثبت‌کننده لاگ یا مدیریت رویداد خودتان را به کتابخانه بدهید. از PHP ساده یا فریم‌ورک فعلی خود استفاده کنید.

ارتباط HTTP و لاگ

رهگیری با زمان‌بندی برنامه شما.

برنامه شما مرسوله‌ها را ذخیره می‌کند و زمان استعلام را تعیین می‌کند. ارسال، وضعیت و تاریخچه را برمی‌گرداند؛ پردازش وب‌هوک در این نسخه پیاده نشده است.

راهنمای رهگیری

با یک بسته شروع کنید.

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

محیط اجرا
PHP 8.1+
افزونه‌ها
curl · json · openssl · soap
وابستگی
eram/abzar
مجوز
MIT