Firebase Extensions | 使用 ShipEngine 计算运费

此扩展程序的运作方式

使用此扩展程序，根据添加至指定 Cloud Firestore 集合的文档，计算全球 50 多家运输公司的实时运费。ShipEngine 会检索所有可能的费率，以帮助品牌、电子商务平台和第三方物流为每次发货做出最佳选择，无论是运费、配送时间、运输公司能力还是其他因素，都是极其重要的。

下面是会触发此扩展程序的基本文档内容示例：

admin
  .firestore()
  .collection('shipments')
  .add({
    shipment: {
      shipTo: {
        name: 'Amanda Miller',
        addressLine1: '525 S Winchester Blvd',
        cityLocality: 'San Jose',
        stateProvince: 'CA',
        postalCode: '95128',
        countryCode: 'US',
      },
      shipFrom: {
        companyName: 'Example Corp.',
        name: 'John Doe',
        phone: '111-111-1111',
        addressLine1: '4009 Marathon Blvd',
        addressLine2: 'Suite 300',
        cityLocality: 'Austin',
        stateProvince: 'TX',
        postalCode: '78756',
        countryCode: 'US',
      },
      packages: [
        {
          weight: {
            value: 1.0,
            unit: 'ounce',
          },
        },
      ],
    },
  });

额外设置

在安装此扩展程序之前，请确保您已经在 Firebase 项目中设置了一个 Cloud Firestore 数据库。

在配置此扩展程序时，您还必须创建一个 ShipEngine 帐号或使用您的现有帐号，并从 ShipEngine API 管理页面提供您的 ShipEngine API 密钥。

结算

若要安装扩展程序，您的项目必须采用 Blaze（随用随付）方案

您需要为此扩展程序所需的 Firebase 资源支付少量费用（通常约为 $0.01/月），即使没有使用此扩展程序也要支付。
此扩展程序用到了其他 Firebase 和 Google Cloud Platform 服务，如果超出这些服务的免费层级，则会产生相关费用：
Cloud Firestore
Cloud Functions（Node.js 15+ 运行时。查看常见问题解答)
Cloud Secret Manager

使用此扩展程序还需要您拥有 ShipEngine 帐号。您需要自行承担与使用 ShipEngine 帐号相关的任何费用。

您可以配置的内容

Cloud Functions 位置
ShipEngine API 密钥
Firestore 路径
运费键
ShipEngine 运输公司 ID
输入架构

创建的资源

类型: Cloud Function
说明: 处理指定 Cloud Firestore 集合中的发货数据，获取费率并根据费率信息更新文档。
类型: Cloud Function
说明:

如何安装此扩展程序

使用 Firebase 控制台

要安装和管理扩展程序，您可以使用 Firebase 控制台。

使用控制台安装

使用 Firebase CLI

要安装和管理扩展程序，您还可以使用 Firebase CLI：

步骤 1：运行以下 npm 命令来安装 CLI 或将 CLI 更新到最新版本。

npm install -g firebase-tools

不能运行？请参阅 Firebase CLI 参考文档或者更改您的 npm 权限。

第 2 步：设置一个新的 Firebase 项目目录或转到现有目录

第 3 步：将此扩展程序添加到扩展程序清单中

firebase ext:install shipengine/calculate-rates --local --project=projectId_or_alias

第 4 步（可选）：使用 Firebase Emulator Suite 在本地测试此扩展程序

firebase emulators:start

第 5 步：将清单中的扩展程序部署到项目中

firebase deploy --only extensions --project=projectId_or_alias

支持

Cloud Firestore

作者

ShipEngine

实用链接

Firebase 文档源代码

许可

Apache-2.0

版本

0.0.3

使用 ShipEngine 计算运费

Made by ShipEngine