PHPackages                             hasan-22/tapin - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. hasan-22/tapin

ActiveLibrary[Utility & Helpers](/categories/utility)

hasan-22/tapin
==============

This package will help you to use Toppin's transportation service

v1.0.0(2y ago)151[1 issues](https://github.com/HASSAN-22/tapin/issues)MITPHPPHP ^7.4

Since Feb 25Pushed 2y ago1 watchersCompare

[ Source](https://github.com/HASSAN-22/tapin)[ Packagist](https://packagist.org/packages/hasan-22/tapin)[ Docs](https://github.com/HASSAN-22/tapin)[ RSS](/packages/hasan-22-tapin/feed)WikiDiscussions main Synced yesterday

READMEChangelog (1)DependenciesVersions (2)Used By (0)

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

[](#این-پکیج-به-شما-کمک-میکنه-به-راحتی-از-سرویس-حمل-و-نقل-تاپین-استفاده-کنید)

روش استفاده
-----------

[](#روش-استفاده)

- نصب پکیج
- `composer require hasan-22/tapin`.

### ست کردن توکن و شناسه فروشگاه

[](#ست-کردن-توکن-و-شناسه-فروشگاه)

```
use Tapin\Tapin;

$authKey = "jwt ***********************************************";
$shopId = "********-****-****-****-***********";

Tapin::setAuthKey($authKey);
$response = Tapin::shopInfo($shopId);
var_dump($response);
```

### دریافت استان ها

[](#دریافت-استان-ها)

#### پارامتر ها

[](#پارامتر-ها)

نام پارامترتوضیحاتcountتعداد رکورد های که میخواهید در یک صفحه نمایش دهد این متغیر به صورت دیفالت روی 10 رکورد تنظیم استpageشماره صفحه به صورت دیفالت روی 1 تنظیم است```
$count = 5;
$page = 1;
$response = \Tapin\Tapin::getProvinces($count, $page);
```

### دریافت شهرستان ها

[](#دریافت--شهرستان-ها)

#### پارامتر ها

[](#پارامتر-ها-1)

نام پارامترتوضیحاتcountتعداد رکورد های که میخواهید در یک صفحه نمایش دهد این متغیر به صورت دیفالت روی 10 رکورد تنظیم استpageشماره صفحه به صورت دیفالت روی 1 تنظیم است```
$count = 5;
$page = 1;
$response = \Tapin\Tapin::getCities($count, $page);
```

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

[](#دریافت-استان-و-شهرستان-ها-با-هم)

```
$response = \Tapin\Tapin::getProvinceAndCity();
```

### دریافت لیست فروشگاه ها

[](#دریافت-لیست-فروشگاه-ها)

#### پارامتر ها

[](#پارامتر-ها-2)

نام پارامترتوضیحاتcountتعداد رکورد های که میخواهید در یک صفحه نمایش دهد این متغیر به صورت دیفالت روی 10 رکورد تنظیم استpageشماره صفحه به صورت دیفالت روی 1 تنظیم است```
$response = \Tapin\Tapin::shopList();

$count = 5;
$page = 1;
$response = \Tapin\Tapin::shopList($count, $page);
```

### دریافت لیست کیوسک ها

[](#دریافت-لیست-کیوسک-ها)

#### پارامتر ها

[](#پارامتر-ها-3)

نام پارامترتوضیحاتshopId"fc45949a-921d-4b4f-1ade-ab5180f7dcve" این شناسه فروشگاه شما است. شناسه فروشگاه مشابه مثال رو به رو میباشدprovinceCodeکد استانcityCodeکد شهرستان```
$shopId = "fc45949a-921d-4b4f-1ade-ab5180f7dcve";

$response = \Tapin\Tapin::kioskList($shopId, 1, 1);
```

### دریافت جزئیات فروشگاه

[](#دریافت-جزئیات-فروشگاه)

#### پارامتر ها

[](#پارامتر-ها-4)

نام پارامترتوضیحاتshopId"fc45949a-921d-4b4f-1ade-ab5180f7dcve" این شناسه فروشگاه شما است. شناسه فروشگاه مشابه مثال رو به رو میباشد```
$shopId = "fc45949a-921d-4b4f-1ade-ab5180f7dcve";

$response = \Tapin\Tapin::shopInfo($shopId);
```

### دریافت اعتبار فروشگاه (موجودی پنل شما را نمایش میدهد)

[](#دریافت-اعتبار-فروشگاه-موجودی-پنل-شما-را-نمایش-میدهد)

#### پارامتر ها

[](#پارامتر-ها-5)

نام پارامترتوضیحاتshopId"fc45949a-921d-4b4f-1ade-ab5180f7dcve" این شناسه فروشگاه شما است. شناسه فروشگاه مشابه مثال رو به رو میباشد```
$shopId = "fc45949a-921d-4b4f-1ade-ab5180f7dcve";

$response = \Tapin\Tapin::shopValidity($shopId);
```

### لیست دسته بندی ها

[](#لیست-دسته-بندی-ها)

#### پارامتر ها

[](#پارامتر-ها-6)

نام پارامترتوضیحاتcountتعداد رکورد های که میخواهید در یک صفحه نمایش دهد این متغیر به صورت دیفالت روی 10 رکورد تنظیم استpageشماره صفحه به صورت دیفالت روی 1 تنظیم است```
$count = 10;
$page = 1;
$response = \Tapin\Tapin::categories($count, $page);
```

### لیست محصولات

[](#لیست-محصولات)

#### پارامتر ها

[](#پارامتر-ها-7)

نام پارامترتوضیحاتshopId"fc45949a-921d-4b4f-1ade-ab5180f7dcve" این شناسه فروشگاه شما است. شناسه فروشگاه مشابه مثال رو به رو میباشدcountتعداد رکورد های که میخواهید در یک صفحه نمایش دهد این متغیر به صورت دیفالت روی 10 رکورد تنظیم استpageشماره صفحه به صورت دیفالت روی 1 تنظیم است```
$shopId = "fc45949a-921d-4b4f-1ade-ab5180f7dcve";
$count = 10;
$page = 1;
$response = \Tapin\Tapin::products($shopId, $count, $page);
```

### ایجاد محصول جدید

[](#ایجاد-محصول-جدید)

#### پارامتر ها

[](#پارامتر-ها-8)

نام پارامترتوضیحاتshopId"fc45949a-921d-4b4f-1ade-ab5180f7dcve" این شناسه فروشگاه شما است. شناسه فروشگاه مشابه مثال رو به رو میباشدtitleعنوان محصولpriceقیمت محصول حتما با `ریال` وارد شودweightوزن محصول حتما `گرم` باشد نه `کیلوگرم`categoryId"fc45949a-921d-4b4f-1ade-ab5180f7dcve" شناسه دسته بندی. این شناسه مشابه مثال رو به رو میباشدdescriptionتوضحیات محصول, (این فیلد اختیاری است)```
$shopId = "fc45949a-921d-4b4f-1ade-ab5180f7dcve";
$title = "My first product";
$price = 250000; // It should be 'rial'
$weight = 500; // It should be 'gram'
$categoryId = "3d65e6eb-ca0d-47b3-9934-6295a355872f";
$description = ''; // It is not required
$response = \Tapin\Tapin::createProduct($shopId, $title, $price, $weight, $categoryId, $description);
```

### ویرایش یک محصول

[](#ویرایش-یک-محصول)

#### پارامتر ها

[](#پارامتر-ها-9)

نام پارامترتوضیحاتshopId"fc45949a-921d-4b4f-1ade-ab5180f7dcve" این شناسه فروشگاه شما است. شناسه فروشگاه مشابه مثال رو به رو میباشدproductIdشناسه محصولی که میخواهید اپدیت کنید. دقت کنید این محصول در تاپین ثبت شده است نه در وب سایت شما.titleعنوان محصولpriceقیمت محصول حتما با `ریال` وارد شودweightوزن محصول حتما `گرم` باشد نه `کیلوگرم`categoryId"fc45949a-921d-4b4f-1ade-ab5180f7dcve" شناسه دسته بندی. این شناسه مشابه مثال رو به رو میباشدdescriptionتوضحیات محصول. (این فیلد اختیاری است)```
$shopId = "fc45949a-921d-4b4f-1ade-ab5180f7dcve";
$productId = 322;
$title = "update...";
$price = 200000; // It should be 'rial'
$weight = 550; // It should be 'gram'
$categoryId = "3d65e6eb-ca0d-47b3-9934-6295a355872f";
$description = ''; // It is not required
$response = \Tapin\Tapin::updateProduct($shopId, $productId, $title, $price, $weight, $categoryId, $description);
```

### حذف یک محصول

[](#حذف-یک-محصول)

#### پارامتر ها

[](#پارامتر-ها-10)

نام پارامترتوضیحاتshopId"fc45949a-921d-4b4f-1ade-ab5180f7dcve" این شناسه فروشگاه شما است. شناسه فروشگاه مشابه مثال رو به رو میباشدproductIdشناسه محصولی که میخواهید حذف کنید. دقت کنید این محصول در تاپین ثبت شده است نه در وب سایت شما.```
$shopId = "fc45949a-921d-4b4f-1ade-ab5180f7dcve";
$productId = 322;
$response = \Tapin\Tapin::deleteProduct($shopId, $productId);
```

### استعلام هزینه ارسال

[](#استعلام-هزینه-ارسال)

#### پارامتر ها

[](#پارامتر-ها-11)

نام پارامترتوضیحاتshopId"fc45949a-921d-4b4f-1ade-ab5180f7dcve" این شناسه فروشگاه شما است. شناسه فروشگاه مشابه مثال رو به رو میباشدproductsلیستی از محصولات, نمونه این لیست را در مثال میتوانید مشاهده کنید. دقت کنید این لیست آرایه از آرایه ها باید باشدaddressادرس گیرندهprovinceCodeکد استان گیرندهcityCodeکد شهرستان گیرندهemployeeCodeکد کارمندfirstNameنام گیرندهlastNameنام خانووادگی گیرندهmobileموبایل گیرندهpostalCodeکد پستی گیرندهpayTypeنوع پرداخت سفارش, انواع روش های پرداخت در پایین اورده شده است دقت کنید ممکن است این روش ها تغییر کنند پس برای اطمینان بیشتر به تاپین هم مراجعه نماییند.orderTypeنوع سفارش, انواع روش های سفارش در پایین اورده شده است دقت کنید ممکن است این روش ها تغییر کنند پس برای اطمینان بیشتر به تاپین هم مراجعه نماییند.packageWeightوزن کل سفارشkioskاطلاعات کیوسک جابار ( درصورت عدم استفاده این فیلد ارسال نشود)emailایمیل گیرنده (اختباری میباشد)phoneشماره تلفن ثابت گیرنده (اختیاری میباشد)descriptionتوضیحات سفارش (اختیاری میباشد)### لیست نوع سفارش

[](#لیست-نوع-سفارش)

نوع ارسالکد نوع ارسالسفارشی0پیشتاز1### لیست نوع پرداخت

[](#لیست-نوع-پرداخت)

نوع پرداختکد نوع پرداختپرداخت در محل0پرداخت از اعتبار1پس کرایه2ارسال رایگان3```
$shopId = "fc45949a-921d-4b4f-1ade-ab5180f7dcve";
// نمونه محصولات (دقت کنید این لیست آرایه از آرایه ها میباشد)
$products = [
    [
        "count" => 1,
        "discount" => 0,
        "price" => 5000, // It should be `rial`
        "title" => "my product title",
        "weight" =>500, // It should be `grams` not `kilograms`
        "product_id" => null
    ]
];
$address = "تهیران ...";
$provinceCode = 1;
$cityCode = 1;
$employeeCode='-1';
$firstName='Hasan';
$lastName="Bahrami";
$mobile="09168963472";
$postalCode="1111111111";
$payType=1;
$orderType=1;
$packageWeight=900; // It should be `grams` not `kilograms`
// This is optional
$kiosk=[
    "kiosk_id"=>101,
    "height"=>101,
    "width"=>101,
    "length"=>101,
    "turning"=>true
];
// This is optional
$email="armiaevil@gmail.com";
// This is optional
$phone="02111111111";
// This is optional
$description="سفارش شکستنی است لطفا در ارسال آن بیشتر دقت کنید";

$response = \Tapin\Tapin::priceInquiry($shopId, $products, $address, $provinceCode, $cityCode, $employeeCode, $firstName, $lastName, $mobile, $postalCode, $payType, $orderType, $packageWeight, $kiosk, $email, $phone, $description);
```

### ثبت سفارش

[](#ثبت-سفارش)

#### پارامتر ها

[](#پارامتر-ها-12)

نام پارامترتوضیحاتshopId"fc45949a-921d-4b4f-1ade-ab5180f7dcve" این شناسه فروشگاه شما است. شناسه فروشگاه مشابه مثال رو به رو میباشدproductsلیستی از محصولات, نمونه این لیست را در مثال میتوانید مشاهده کنید. دقت کنید این لیست آرایه از آرایه ها باید باشدaddressادرس گیرندهprovinceCodeکد استان گیرندهcityCodeکد شهرستان گیرندهfirstNameنام گیرندهlastNameنام خانووادگی گیرندهmobileموبایل گیرندهpostalCodeکد پستی گیرندهpayTypeنوع پرداخت سفارش (انواع روش های پرداخت در پایین اورده شده است دقت کنید ممکن است این روش ها تغییر کنند پس برای اطمینان بیشتر به تاپین هم مراجعه نماییند.)orderTypeنوع سفارش (انواع روش های سفارش در پایین اورده شده است دقت کنید ممکن است این روش ها تغییر کنند پس برای اطمینان بیشتر به تاپین هم مراجعه نماییند.)packageWeightوزن کل سفارشpresenterCodeکد معرف (برای دریافت کد معرف به پنل خود در تاپین مراجعه نمایید)manualIdشناسه سفارشcontentTypeنوع محتوای کالا (لیست انواع محتوای کالا در زیر اورده شده است)registerTypeنوع ثبت سفارش (لیست انواع ثبت سفارش در زیر اورده شده است)employeeCodeکد کارمند (به صورت دیفالت روی عدد `-1` میباشد) برای مشاهده دیگر کد های کارمندان به تاپین مراجغه نماییدkioskاطلاعات کیوسک جابار ( درصورت عدم استفاده این فیلد ارسال نشود)insuranceIdشناسه بیمه کالا ( ارسال این فیلد برای سفارش های آنلاین اجباری هست در صورت عدم انتخاب توسط سیستم مقدار دهی میشود.)emailایمیل گیرنده (اختباری میباشد)phoneشماره تلفن ثابت گیرنده (اختیاری میباشد)descriptionتوضیحات سفارش (اختیاری میباشد)### لیست نوع سفارش

[](#لیست-نوع-سفارش-1)

نوع ارسالکد نوع ارسالسفارشی0پیشتاز1### لیست نوع پرداخت

[](#لیست-نوع-پرداخت-1)

نوع پرداختکد نوع پرداختپرداخت در محل0پرداخت از اعتبار1پس کرایه2ارسال رایگان3### لیست نوع محتوای کالا

[](#لیست-نوع-محتوای-کالا)

محتواکد محتواعادی1شکستنی2مایعات3غیر استاندارد4### انواع ثبت سفارش

[](#انواع-ثبت-سفارش)

محتواکد محتواثبت سفارش بدون بارکد0ثبت سفارش با بارکد در حالت آماده به پرینت1ثبت سفارش با بارکد در حالت آماده به ارسال2```
$shopId = "fc45949a-921d-4b4f-1ade-ab5180f7dcve";
// نمونه محصولات (دقت کنید این لیست آرایه از آرایه ها میباشد)
$products = [
    [
        "count" => 1,
        "discount" => 0,
        "price" => 5000, // It should be `rial`
        "title" => "my product title",
        "weight" =>500, // It should be `grams` not `kilograms`
        "product_id" => null // This must be null
    ]
];
$address = "تهیران ...";
$provinceCode = 1;
$cityCode = 1;
$firstName='Hasan';
$lastName="Bahrami";
$mobile="09168963472";
$postalCode="1111111111";
$payType=1;
$orderType=1;
$packageWeight=900; // It should be `grams` not `kilograms`
$presenterCode=999;
$manualId=1;
$contentType=1;
// It is set to `0` by default
$registerType=0;
// It is set to `-1` by default
$employeeCode='-1';
// This is optional
$kiosk=[
    "kiosk_id"=>101,
    "height"=>101,
    "width"=>101,
    "length"=>101,
    "turning"=>true
];
// This is optional
$insuranceId=null,
// This is optional
$email="armiaevil@gmail.com";
// This is optional
$phone="02111111111";
// This is optional
$description="سفارش شکستنی است لطفا در ارسال آن بیشتر دقت کنید";

$response = \Tapin\Tapin::createOrder(
    $shopId,
    $products,
    $address,
    $provinceCode,
    $cityCode,
    $firstName,
    $lastName,
    $mobile,
    $postalCode,
    $payType,
    $orderType,
    $packageWeight,
    $presenterCode,
    $manualId,
    $contentType,
    $registerType,
    $employeeCode,
    $kiosk,
    $insuranceId,
    $email,
    $phone,
    $description
);
```

### ثبت دسته ای از سفارشات

[](#ثبت-دسته-ای-از-سفارشات)

#### پارامتر ها

[](#پارامتر-ها-13)

نام پارامترتوضیحاتshopId"fc45949a-921d-4b4f-1ade-ab5180f7dcve" این شناسه فروشگاه شما است. شناسه فروشگاه مشابه مثال رو به رو میباشدproductsلیستی از محصولات, نمونه این لیست را در مثال میتوانید مشاهده کنید. دقت کنید این لیست آرایه از آرایه ها باید باشدaddressادرس گیرندهprovinceCodeکد استان گیرندهcityCodeکد شهرستان گیرندهfirstNameنام گیرندهlastNameنام خانووادگی گیرندهmobileموبایل گیرندهpostalCodeکد پستی گیرندهpayTypeنوع پرداخت سفارش (انواع روش های پرداخت در پایین اورده شده است دقت کنید ممکن است این روش ها تغییر کنند پس برای اطمینان بیشتر به تاپین هم مراجعه نماییند.)orderTypeنوع سفارش (انواع روش های سفارش در پایین اورده شده است دقت کنید ممکن است این روش ها تغییر کنند پس برای اطمینان بیشتر به تاپین هم مراجعه نماییند.)packageWeightوزن کل سفارشpresenterCodeکد معرف (برای دریافت کد معرف به پنل خود در تاپین مراجعه نمایید)manualIdشناسه سفارشcontentTypeنوع محتوای کالا (لیست انواع محتوای کالا در زیر اورده شده است)registerTypeنوع ثبت سفارش (لیست انواع ثبت سفارش در زیر اورده شده است)employeeCodeکد کارمند (به صورت دیفالت روی عدد `-1` میباشد) برای مشاهده دیگر کد های کارمندان به تاپین مراجغه نماییدinsuranceIdشناسه بیمه کالا ( ارسال این فیلد برای سفارش های آنلاین اجباری هست در صورت عدم انتخاب توسط سیستم مقدار دهی میشود.)emailایمیل گیرنده (اختباری میباشد)phoneشماره تلفن ثابت گیرنده (اختیاری میباشد)descriptionتوضیحات سفارش (اختیاری میباشد)### لیست نوع سفارش

[](#لیست-نوع-سفارش-2)

نوع ارسالکد نوع ارسالسفارشی0پیشتاز1### لیست نوع پرداخت

[](#لیست-نوع-پرداخت-2)

نوع پرداختکد نوع پرداختپرداخت در محل0پرداخت از اعتبار1پس کرایه2ارسال رایگان3### لیست نوع محتوای کالا

[](#لیست-نوع-محتوای-کالا-1)

محتواکد محتواعادی1شکستنی2مایعات3غیر استاندارد4### انواع ثبت سفارش

[](#انواع-ثبت-سفارش-1)

محتواکد محتواثبت سفارش بدون بارکد0ثبت سفارش با بارکد در حالت آماده به پرینت1ثبت سفارش با بارکد در حالت آماده به ارسال2```
$shopId = "fc45949a-921d-4b4f-1ade-ab5180f7dcve";
$orders = [
    [
        "address"=> "tehran-...",
        "city_code"=> "1",
        "province_code"=> "1",
        "first_name"=> "hasan",
        "last_name"=> "bahrami",
        "mobile"=> "09168963472",
        "postal_code"=> "1313131313",
        "pay_type"=> "1",
        "order_type"=> "1",
        "package_weight"=> 10,
        "presenter_code"=>999,
        "content_type"=>1,
        "register_type"=> 0, // It is set to `0` by default
        "employee_code"=> "-1", // It is set to `-1` by default
        "insurance_id"=>null, // This is optional
        "description"=> null, // This is optional
        "email"=> null, // This is optional
        "phone"=> null, // This is optional
        // Products must be an array of arrays
        "products"=> [
            [
                "count"=> 1,
                "discount"=> 0,
                "price"=> 5000,
                "title"=> "my product title",
                "weight"=> 500,
                "product_id"=> null // This must be null
            ]
        ]

    ]
];
$response = \Tapin\Tapin::createBatchOfOrders($shopId, $orders);
```

### لیست مبالغ بیمه

[](#لیست-مبالغ-بیمه)

```
$response = \Tapin\Tapin::insuranceAmounts();
```

### تغییر وضعیت سفارشات

[](#تغییر-وضعیت-سفارشات)

#### پارامتر ها

[](#پارامتر-ها-14)

نام پارامترتوضیحاتshopId"fc45949a-921d-4b4f-1ade-ab5180f7dcve" این شناسه فروشگاه شما است. شناسه فروشگاه مشابه مثال رو به رو میباشدorderIdشناسه یکتا سفارش (این شناسه سفارشی است که در تاپین میباشد نه در سایت شما)statusوضعیت سفارش (لیست وضعیت ها در زیر اورده شده است)#### وضعیت سفارش

[](#وضعیت-سفارش)

نام وضعیتکد وضعیتثبت شده در فروشگاه (تحت بررسی) (API)-1ثبت شده در فروشگاه (تحت بررسی)0آماده به پرینت (معلق پستی)1آماده به ارسال2اشتباه در اعلام آماده به ارسال3عدم حضور فروشگاه4قبول شد5عدم قبول (غیر قایل توزیع در مبدا)6توزیع شد7باجه معطل8غیر قابل توزیع(غیر قایل توزیع در مقصد)9پیش برگشتی مرسوله10ثبت نهایی برگشتی11مرسوله خسارتی12وارده به استان توزیع13تحويل به نامه رسان14مراجعه اول15مراجعه دوم16توزيع درصندوق پستي17بي ترتيبي(کسري مرسوله)18در حال جمع آوری50تایید شده مدیر مالی70تسویه شده مدیر مالی71تسویه شده با پست72حذف شده80بلاتکلیف81مانده قبول82تایید برگشتی83منتظر استعلام100منتظر استعلام (API)-100در حال تغییر وضعیت101عودت داده شده102پیش ثبت سفارش103```
$shopId= "fc45949a-921d-4b4f-1ade-ab5180f7dcve";
$orderId = 165;
$status = 1
$response = \Tapin\Tapin::changeOrderStatus($shopId, $orderId, $status);
```

### تتغییر وضعیت دسته ای سفارشات

[](#تتغییر-وضعیت-دسته-ای-سفارشات)

#### پارامتر ها

[](#پارامتر-ها-15)

نام پارامترتوضیحاتshopId"fc45949a-921d-4b4f-1ade-ab5180f7dcve" این شناسه فروشگاه شما است. شناسه فروشگاه مشابه مثال رو به رو میباشدordersلیست محصولاتی که میخواهید وضعیت انها تغییر کندstatusوضعیت سفارش (لیست وضعیت ها در زیر اورده شده است)#### وضعیت سفارش

[](#وضعیت-سفارش-1)

نام وضعیتکد وضعیتثبت شده در فروشگاه (تحت بررسی) (API)-1ثبت شده در فروشگاه (تحت بررسی)0آماده به پرینت (معلق پستی)1آماده به ارسال2اشتباه در اعلام آماده به ارسال3عدم حضور فروشگاه4قبول شد5عدم قبول (غیر قایل توزیع در مبدا)6توزیع شد7باجه معطل8غیر قابل توزیع(غیر قایل توزیع در مقصد)9پیش برگشتی مرسوله10ثبت نهایی برگشتی11مرسوله خسارتی12وارده به استان توزیع13تحويل به نامه رسان14مراجعه اول15مراجعه دوم16توزيع درصندوق پستي17بي ترتيبي(کسري مرسوله)18در حال جمع آوری50تایید شده مدیر مالی70تسویه شده مدیر مالی71تسویه شده با پست72حذف شده80بلاتکلیف81مانده قبول82تایید برگشتی83منتظر استعلام100منتظر استعلام (API)-100در حال تغییر وضعیت101عودت داده شده102پیش ثبت سفارش103```
$shopId = "fc45949a-921d-4b4f-1ade-ab5180f7dcve";
$orders = [
    [
        // این باید آیدی سفارش باشد
        "id"=>"d95d0f45-6162-4ec3-bd29-09452c148b40"
    ],
    [
        // این باید آیدی سفارش باشد
        "id"=>"d95d0f46-6162-4ec3-bd29-09452c148b46"
    ]
]
$status = 80;
$response = \Tapin\Tapin::changeBatchOfOrderStatus($shopId, $orders, $status);
```

### لیست سفارشات

[](#لیست-سفارشات)

#### پارامتر ها

[](#پارامتر-ها-16)

نام پارامترتوضیحاتshopId"fc45949a-921d-4b4f-1ade-ab5180f7dcve" این شناسه فروشگاه شما است. شناسه فروشگاه مشابه مثال رو به رو میباشدcountتعداد رکورد های که میخواهید در یک صفحه نمایش دهد این متغیر به صورت دیفالت روی 10 رکورد تنظیم استpageشماره صفحه به صورت دیفالت روی 1 تنظیم است```
$shopId = "fc45949a-921d-4b4f-1ade-ab5180f7dcve";
$count = 10;
$page = 1;
$response = \Tapin\Tapin::orders($shopId, $count, $page);
```

### جزئیات سفارش

[](#جزئیات-سفارش)

#### پارامتر ها

[](#پارامتر-ها-17)

نام پارامترتوضیحاتshopId"fc45949a-921d-4b4f-1ade-ab5180f7dcve" این شناسه فروشگاه شما است. شناسه فروشگاه مشابه مثال رو به رو میباشدorderIdشناسه یکتا سفارش (این شناسه سفارشی است که در تاپین میباشد نه در سایت شما)```
$shopId = "fc45949a-921d-4b4f-1ade-ab5180f7dcve";
$orderId = 10;
$response = \Tapin\Tapin::orderDetail($shopId, $orderId);
```

### لینک درگاه برای شارژ حساب

[](#لینک-درگاه-برای-شارژ-حساب)

#### پارامتر ها

[](#پارامتر-ها-18)

نام پارامترتوضیحاتshopId"fc45949a-921d-4b4f-1ade-ab5180f7dcve" این شناسه فروشگاه شما است. شناسه فروشگاه مشابه مثال رو به رو میباشدpriceمبلغی که میخواهید پنل شارژ شود(به `ریال` وارد شود)callbackآدرس بازگشتی شما```
$shopId = "fc45949a-921d-4b4f-1ade-ab5180f7dcve";
$price = 500000;
$callback="https://domain.com/callback";
$response = \Tapin\Tapin::paymentLink($shopId, $price, $callback);
```

### لیست تراکنش ها

[](#لیست-تراکنش-ها)

#### پارامتر ها

[](#پارامتر-ها-19)

نام پارامترتوضیحاتshopId"fc45949a-921d-4b4f-1ade-ab5180f7dcve" این شناسه فروشگاه شما است. شناسه فروشگاه مشابه مثال رو به رو میباشدcountتعداد رکورد های که میخواهید در یک صفحه نمایش دهد این متغیر به صورت دیفالت روی 10 رکورد تنظیم استpageشماره صفحه به صورت دیفالت روی 1 تنظیم است```
$shopId = "fc45949a-921d-4b4f-1ade-ab5180f7dcve";
$count = 10;
$page = 1;
$response = \Tapin\Tapin::transactions($shopId, $count, $page);
```

### دریافت آخرین تغییر وضعیت سفارشات بر اساس تاریخ

[](#دریافت-آخرین-تغییر-وضعیت-سفارشات-بر-اساس-تاریخ)

#### پارامتر ها

[](#پارامتر-ها-20)

نام پارامترتوضیحاتshopId"fc45949a-921d-4b4f-1ade-ab5180f7dcve" این شناسه فروشگاه شما است. شناسه فروشگاه مشابه مثال رو به رو میباشدdateتاریخ (دقت کنید تاریخ به شمسی وارد شود)countتعداد رکورد های که میخواهید در یک صفحه نمایش دهد این متغیر به صورت دیفالت روی 10 رکورد تنظیم استpageشماره صفحه به صورت دیفالت روی 1 تنظیم است```
$shopId = "fc45949a-921d-4b4f-1ade-ab5180f7dcve";
$date = "1402-12-07";
$count = 10;
$page = 1;
$response = \Tapin\Tapin::getOrderStatusByDate($shopId, $date, $count, $page);
```

### دریافت آخرین تغییر وضعیت سفارشات در بازه تاریخی مشخص

[](#دریافت-آخرین-تغییر-وضعیت-سفارشات-در-بازه-تاریخی-مشخص)

#### پارامتر ها

[](#پارامتر-ها-21)

نام پارامترتوضیحاتshopId"fc45949a-921d-4b4f-1ade-ab5180f7dcve" این شناسه فروشگاه شما است. شناسه فروشگاه مشابه مثال رو به رو میباشدfromDateاز تاریخ (دقت کنید تاریخ به میلادی وارد شود)toDateتا تاریخ (دقت کنید تاریخ به میلادی وارد شود)countتعداد رکورد های که میخواهید در یک صفحه نمایش دهد این متغیر به صورت دیفالت روی 10 رکورد تنظیم استpageشماره صفحه به صورت دیفالت روی 1 تنظیم است```
$shopId = "fc45949a-921d-4b4f-1ade-ab5180f7dcve";
$fromDate = "2024-02-20";
$toDate = "2024-02-25";
$count = 10;
$page = 1;
$response = \Tapin\Tapin::getOrderStatusBetweenDate($shopId, $fromDate, $toDate, $count, $page);
```

###  Health Score

15

—

LowBetter than 3% of packages

Maintenance0

Infrequent updates — may be unmaintained

Popularity6

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity41

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

860d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/63023595?v=4)[Hasan Bahrami](/maintainers/HASSAN-22)[@HASSAN-22](https://github.com/HASSAN-22)

---

Top Contributors

[![HASSAN-22](https://avatars.githubusercontent.com/u/63023595?v=4)](https://github.com/HASSAN-22 "HASSAN-22 (6 commits)")

---

Tags

phptransportationhasantopin

### Embed Badge

![Health badge](/badges/hasan-22-tapin/health.svg)

```
[![Health](https://phpackages.com/badges/hasan-22-tapin/health.svg)](https://phpackages.com/packages/hasan-22-tapin)
```

###  Alternatives

[imanghafoori/laravel-anypass

A minimal yet powerful package to help you in development.

21623.4k](/packages/imanghafoori-laravel-anypass)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)