Flutter集成SIGEP Web服务插件sigepweb的使用

Flutter集成SIGEP Web服务插件sigepweb的使用

sigepweb

Coverage

利用Correios的服务在您的应用程序中查询邮政编码或计算包裹的价格和交货时间。

这是什么？

Sigepweb 是由Correios创建的一个系统，旨在为这家著名的物流企业提供服务并与您的企业对接。

为了管理发货，Correios为其合同客户提供了SIGEP Web系统。
SIGEP Web 帮助准备包裹，生成带有追踪码的标签，并将这些信息发送到Correios的单位以更快速地投递包裹。
了解更多

集成是否完整？

您可能在想这个插件是否提供了API提供的所有服务。截至目前，答案是否！

事实是，API中有许多方法需要实现，而我目前确实不确定这对社区是否有用。我会尽可能地在这个插件上投入工作，使其逐步完善，但老实说我没有太多时间来完成这一切。因此，如果您有需求希望未来能通过此插件实现，请联系我，我可以优先处理您的请求。请记住，一切都会根据我的能力逐步完成。

如何贡献？

帮助这个插件成长并达到提供API所有功能的目标。提交您的Pull Request。欢迎您随时与我联系。

重要提示：只有包含测试的PR才会被接受！坚持TDD原则！

示例

通过CEP查询地址

var sigep = Sigepweb(contrato: SigepContrato.semContrato()); // 创建Sigepweb实例

var endereco = await sigep.consultaCEP('70002900'); // 查询指定CEP的地址信息

print(endereco); // 打印结果

输出：

{"cep":"70002900","logradouro":"SBN Quadra 1 Bloco A","complemento":null,"bairro":"Asa Norte","cidade":"Brasília","estado":"DF"}

计算包裹价格和交货时间

var sigep = Sigepweb(contrato: SigepContrato.semContrato()); // 创建Sigepweb实例

var calcPrecoPrazo = await sigep.calcPrecoPrazo(
  cepOrigem: '70002900', // 发货地邮政编码
  cepDestino: '04547000', // 收货地邮政编码
  valorPeso: 1,           // 包裹重量（单位：kg）
);

// 打印计算结果
for (var item in calcPrecoPrazo) {
  print("${item.nome}: R\$ ${item.valor}"); // 输出服务名称及费用
}

输出：

Sedex: R$ 53.1
PAC: R$ 27.8

更多关于Flutter集成SIGEP Web服务插件sigepweb的使用的实战教程也可以访问 https://www.itying.com/category-92-b0.html

1 回复

更多关于Flutter集成SIGEP Web服务插件sigepweb的使用的实战系列教程也可以访问 https://www.itying.com/category-92-b0.html


在Flutter中集成SIGEP Web服务插件（如 sigepweb）通常涉及以下几个步骤。SIGEP Web服务是巴西邮政（Correios）提供的一种用于跟踪和管理邮政服务的API。以下是一个基本的指南，帮助你在Flutter项目中集成和使用 sigepweb 插件。

1. 添加依赖

首先，你需要在 pubspec.yaml 文件中添加 sigepweb 插件的依赖。假设 sigepweb 插件已经发布在 pub.dev 上，你可以这样添加：

dependencies:
  flutter:
    sdk: flutter
  sigepweb: ^1.0.0  # 请使用最新版本

然后运行 flutter pub get 来获取依赖。

2. 导入插件

在你的 Dart 文件中导入 sigepweb 插件：

import 'package:sigepweb/sigepweb.dart';

3. 初始化 SIGEP Web 服务

在使用 sigepweb 插件之前，你需要初始化它。通常，你需要提供一些认证信息，如用户名、密码等。

SigepWeb sigepWeb = SigepWeb(
  username: 'your_username',
  password: 'your_password',
  // 其他可选参数
);

4. 调用 SIGEP Web 服务方法

sigepweb 插件通常会提供一些方法来调用 SIGEP Web 服务的不同功能。例如，获取跟踪信息、生成标签等。

以下是一个获取跟踪信息的示例：

Future<void> getTrackingInfo(String trackingCode) async {
  try {
    var trackingInfo = await sigepWeb.getTrackingInfo(trackingCode);
    print('Tracking Info: $trackingInfo');
  } catch (e) {
    print('Error: $e');
  }
}

5. 处理响应

根据你调用的方法，sigepweb 插件会返回不同的响应。你需要根据你的业务逻辑处理这些响应。

例如，如果你调用的是 getTrackingInfo 方法，你可能会得到一个包含跟踪信息的对象，你可以将其显示在UI中。

@override
Widget build(BuildContext context) {
  return Scaffold(
    appBar: AppBar(
      title: Text('SIGEP Web Example'),
    ),
    body: Center(
      child: ElevatedButton(
        onPressed: () async {
          await getTrackingInfo('your_tracking_code');
        },
        child: Text('Get Tracking Info'),
      ),
    ),
  );
}

6. 错误处理

在使用 sigepweb 插件时，可能会遇到各种错误，如网络错误、认证失败等。确保你在调用方法时进行适当的错误处理。

try {
  var result = await sigepWeb.someMethod();
  // 处理结果
} catch (e) {
  print('Error: $e');
  // 显示错误信息给用户
}
回到顶部