物流助手

生成運單

<?php
$miniProgram->express->createWaybill($data);

// 例如：
try {
    $ret = $miniProgram->express->createWaybill($data);
} catch (\EasySwoole\WeChat\Kernel\Exceptions\HttpException $httpException) {
    $error = $httpException->getMessage();
}

// 成功返回
{
  "order_id": "01234567890123456789",
  "waybill_id": "123456789",
  "waybill_data": [
    {
      "key": "SF_bagAddr",
      "value": "廣州"
    },
    {
      "key": "SF_mark",
      "value": "101- 07-03 509"
    }
  ]
}

// 失敗返回，拋出 \EasySwoole\WeChat\Kernel\Exceptions\HttpException 異常

取消運單

<?php
$miniProgram->express->deleteWaybill($data);

// 例如：
try {
    $ret = $miniProgram->express->deleteWaybill($data);
} catch (\EasySwoole\WeChat\Kernel\Exceptions\HttpException $httpException) {
    $error = $httpException->getMessage();
}

獲取支持的快遞公司列表

<?php
$miniProgram->express->listProviders();

// 例如：
try {
    $ret = $miniProgram->express->listProviders();
} catch (\EasySwoole\WeChat\Kernel\Exceptions\HttpException $httpException) {
    $error = $httpException->getMessage();
}

// 列表：
{
  "count": 8,
  "data": [
    {
      "delivery_id": "BEST",
      "delivery_name": "百世快遞"
    },
    ...
  ]
}

獲取運單數據

<?php
$miniProgram->express->getWaybill($data);

// 例如：
try {
    $ret = $miniProgram->express->getWaybill($data);
} catch (\EasySwoole\WeChat\Kernel\Exceptions\HttpException $httpException) {
    $error = $httpException->getMessage();
}

查詢運單軌跡

<?php
$miniProgram->express->getWaybillTrack($data);

// 例如：
try {
    $ret = $miniProgram->express->getWaybillTrack($data);
} catch (\EasySwoole\WeChat\Kernel\Exceptions\HttpException $httpException) {
    $error = $httpException->getMessage();
}

獲取打印員

<?php
$miniProgram->express->getPrinter();

// 例如：
try {
    $ret = $miniProgram->express->getPrinter();
} catch (\EasySwoole\WeChat\Kernel\Exceptions\HttpException $httpException) {
    $error = $httpException->getMessage();
}

獲取電子面單余額

僅在使用加盟類快遞公司時，才可以調用。

<?php
$miniProgram->express->getBalance($deliveryId, $bizId);

// 例如：
try {
    $ret = $miniProgram->express->getBalance('YTO', 'xyz');
} catch (\EasySwoole\WeChat\Kernel\Exceptions\HttpException $httpException) {
    $error = $httpException->getMessage();
}

綁定打印員

若需要使用微信打單 PC 軟件，才需要調用。

<?php
$miniProgram->express->bindPrinter($openid);

// 例如：
try {
    $ret = $miniProgram->express->bindPrinter($openid);
} catch (\EasySwoole\WeChat\Kernel\Exceptions\HttpException $httpException) {
    $error = $httpException->getMessage();
}

解綁打印員

若需要使用微信打單 PC 軟件，才需要調用。

<?php
$miniProgram->express->unbindPrinter($openid);

// 例如：
try {
    $ret = $miniProgram->express->unbindPrinter($openid);
} catch (\EasySwoole\WeChat\Kernel\Exceptions\HttpException $httpException) {
    $error = $httpException->getMessage();
}