README

SwiftShip

支持的公司

免责声明

• 此软件包是非官方的，并不被任何官方运输服务所认可或关联。
• 最初所有服务都将支持创建COD预订和跟踪。
• 它仅设计用于单一服务集成；目前尚未启用多服务功能。
• 请注意，此项目处于积极开发阶段，可能会进行更改和更新。
• 我们计划在未来版本中集成多个运输服务，允许并行使用和扩展功能。

计划支持

介绍

欢迎来到 SwiftShip，这是您在 Laravel 生态系统内轻松集成快递公司的门户。无缝连接到顶级运输服务，如 TCS、DHL、LCS、Trax 和 Leopard，所有这些都被设计用来增强您的运输操作。体验实时跟踪、成本优化和直观的界面，所有这些都被封装在一个旨在提升您的电子商务或物流平台的包中。加入我们，在 SwiftShipLaravel 作为您值得信赖的合作伙伴的旅程中，享受更快、更高效的运输体验。

目标受众

SwiftShipLaravel 定制用于 Laravel 开发者、电子商务企业和物流专业人士，他们寻求高效的快递公司集成。无论您是寻求简化运输服务的老练开发者，还是希望提升物流操作的组织，我们的包都旨在满足您的需求。探索 SwiftShipLaravel 的功能，今天提升您的运输体验。该包仅使用 COD api 进行预订和跟踪快递。

要求

在利用 SwiftShip Laravel 包之前，请确保您已从选择的快递服务获取必要的信息。以下是 TCS 的所需字段

• X-IBM-Client-Id
• userName
• Password

安装

您可以使用以下 Laravel Composer 命令轻松安装该包

composer require zfhassaan/swiftship

接下来，将 SwiftShip 服务提供者添加到您的 config/app.php 文件

/*
 * Package Service Providers...
 */
...
\zfhassaan\swiftship\Provider\SwiftShipServiceProvider::class,
...

在相同的 config/app.php 文件中，在 'aliases' 部分下添加 SwiftShip 别名

...
'aliases' => Facade::defaultAliases()->merge([
    ...
    'SwiftShip' => \zfhassaan\swiftship\Facade\SwiftShipFacade::class,
])->toArray(),
...

完成这些步骤后，将配置文件发布到您的 Laravel 应用程序

php artisan vendor:publish --tag=swift-ship-config

要使用的 .env 变量

# SWIFTSHIP COURIER PACKAGE
SWIFTSHIP_TCS_CLIENT_ID=
SWIFTSHIP_TCS_BASE_URL=
SWIFTSHIP_TCS_USERNAME=
SWIFTSHIP_TCS_PASSWORD=
SWIFTSHIP_TCS_TRACKING_URL=

用法

要使用 SwiftShip Laravel 包，请确保您已声明所选快递服务所需的所有环境变量。目前，仅支持 TCS 创建 COD 订单，订单金额为 0 或指定金额。该包还包括一个全面的 TCS 跟踪系统。

每个快递服务遵循 ServiceNameClient 的命名约定，例如 LCSClient 或 TCSClient。以下是一个创建 TCS 货运的示例

use zfhassaan\SwiftShip\SwiftShip;
use zfhassaan\SwiftShip\Couriers\TCS\TCSClient;

class YourController extends Controller
{
    public function TrackLCSShipment($trackingNumber)
    {
        $swiftShip = new SwiftShip();
        $courier = $swiftShip->setCourierClient(new TCSClient());
        $result =  $swiftShip->createBooking($request->all());
        return json_decode($result);
    }
}

跟踪订单

要跟踪订单，以下是一个使用 TCS 快递客户端的示例

use zfhassaan\swiftship\Couriers\TCS\TCSClient;
use zfhassaan\swiftship\SwiftShip;

class YourController extends Controller
{
    public function index(Request $request)
    {
        $swiftShip = new SwiftShip();
        $courier = $swiftShip->setCourierClient(new TCSClient());
        $result = $swiftShip->trackShipment($request->consignmentNo);
        return json_decode($result);
    }
}

现在，您已准备好利用 SwiftShip Laravel 包在 Laravel 应用程序中进行流线化的快递集成和订单跟踪。