ot/ot-tracking-php

使用 Shippo 连接多个承运商(FedEx、UPS、USPS)的 PHP 库。


README

Build Status

Shippo 是一个连接多个承运商(如 USPS、UPS、DHL、加拿大邮政、澳大利亚邮政、UberRUSH 等)的 API,通过一个接口即可。

使用我们的默认 USPS 和 DHL Express 账户,在 10 分钟内打印出运单。无需注册承运商账户即可开始。

要求

  • PHP 5.6 或更高版本。

  • Shippo 账户 - 注册免费,使用 API 也免费。只有打印实时标签时才需要付费,测试标签免费。

安装

使用 Composer 安装

  • 获取 Composer

  • 将以下内容添加到您的 composer.json 文件中

      {
        "require": {
          "shippo/shippo-php": "1.*"
        }
      }
    
  • 通过以下方式安装

      composer.phar install
    
  • 要使用绑定,请使用 Composer 的自动加载

      require_once('vendor/autoload.php');
    

    或手动

      require_once('/path/to/vendor/shippo/shippo-php/lib/Shippo.php');
    

使用 Laravel 安装

在 Laravel 中,您可以像安装其他库一样安装此库。然后在您的 app/Providers/AppServiceProvider.php 文件的 boot() 方法中添加以下内容

\Shippo::setApiKey(env('SHIPPO_API_KEY'));

为了利用配置缓存,您可以在 config/services.php 中设置一个配置参数,并通过配置检索您的 API 密钥。

\Shippo::setApiKey($this->app['config']['services.shippo.key']);

从现在起,您可以在应用程序的任何地方使用 Shippo 库,而无需在访问它时设置密钥。

测试

安装上述依赖项后,可以运行测试套件

    ./vendor/bin/phpunit

您也可以运行单个测试

    ./vendor/bin/phpunit AddressTest.php

入门

简单用法如下

    // Replace <API-KEY> with your Shippo API Key
    Shippo::setApiKey("<API-KEY>");
    $address = Shippo_Address::
        create(
            array(
                 'object_purpose' => 'QUOTE',
                 'name' => 'John Smith',
                 'company' => 'Initech',
                 'street1' => '6512 Greene Rd.',
                 'city' => 'Woodridge',
                 'state' => 'IL',
                 'zip' => '60517',
                 'country' => 'US',
                 'phone' => '773 353 2345',
                 'email' => 'jmercouris@iit.com',
                 'metadata' => 'Customer ID 23424'
            ));
            
        var_dump($address);

我们创建了许多示例来涵盖最常见用例。您可以在 示例文件夹 中找到样本代码文件。我们涵盖的一些用例包括

文档

请参阅 https://goshippo.com/docs 获取最新文档。

关于 Shippo

通过一个集成连接多个不同承运商,获取折扣运单,跟踪包裹等。您可以使用自己的承运商账户或利用我们与 USPS 和 DHL Express 的折扣费率。使用 Shippo 可以轻松处理多个承运商集成、比价、跟踪和运输工作流程的其他部分。我们提供 API 和仪表板,满足您的所有运输需求。

支持的功能

Shippo API 提供了对承运商和运输功能的深入支持。以下是通过 API 支持的一些功能

支持的功能

Shippo API 提供了对承运商和运输功能的深入支持。以下是通过 API 支持的一些功能

  • 运费与标签 - 文档
  • 仅使用跟踪号跟踪任何运输 - 文档
  • 批量标签生成 - 文档
  • 多件货物运输 - 文档
  • 舱单和扫描表 - 文档
  • 海关申报和商业发票 - 文档
  • 地址验证 - 文档
  • 包括以下 consolidator 支持
    • DHL 电子商业
    • UPS 邮政创新
    • 联邦快递 Smartpost
  • 附加服务:货到付款、认证邮件、投递确认等 - 文档