Flutter数据抓取插件sat_scraping的使用

sat_scraping 是一个用于从墨西哥税务机关（SAT）网站提取税务信息的Flutter插件。它通过扫描二维码或手动输入RFC和ID CIF来获取相关信息。以下是如何使用该插件的详细步骤和示例代码。

安装插件

首先，在你的 pubspec.yaml 文件中添加 sat_scraping 依赖：

dependencies:
  flutter:
    sdk: flutter
  sat_scraping: ^x.x.x # 使用最新版本号
  qrscan: ^x.x.x       # 用于扫描二维码
  permission_handler: ^x.x.x # 用于请求权限
  share_plus: ^x.x.x   # 用于分享信息

运行 flutter pub get 来安装这些依赖。

示例代码

以下是一个完整的示例应用，展示了如何使用 sat_scraping 插件来扫描二维码并获取税务信息。

主要文件：main.dart

import 'dart:developer';

import 'package:flutter/material.dart';
import 'package:permission_handler/permission_handler.dart';
import 'package:qrscan/qrscan.dart' as scanner;
import 'package:sat_scraping/sat_scraping.dart';
import 'package:share_plus/share_plus.dart';

void main() {
  runApp(const MyApp());
}

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'SAT Escáner',
      theme: ThemeData(
        primarySwatch: Colors.blue,
        useMaterial3: false,
      ),
      home: const MyHomePage(title: 'Información Fiscal'),
    );
  }
}

class MyHomePage extends StatefulWidget {
  const MyHomePage({super.key, required this.title});

  final String title;

  [@override](/user/override)
  State<MyHomePage> createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {
  bool loading = false;
  bool error = false;
  String errorMessage = '';

  InfoFiscal infoFiscal = InfoFiscal.getDefault();

  void _shared() {
    setState(() {
      loading = true;
    });
    String regimenesComplete = '';
    for (final row in infoFiscal.caracteristicasFiscales) {
      regimenesComplete +=
          'Régimen Fiscal: \t\t${row.codigoRegimen} - ${row.regimenFiscal}\n\n';
    }
    Share.share(''
        'RFC: \t\t ${infoFiscal.rfc}\n\n'
        'ID CIF: \t\t ${infoFiscal.idCif}\n\n'
        'Razón Social: \t\t${infoFiscal.razonSocial}\n\n'
        'Código Postal: \t\t${infoFiscal.cp}\n\n'
        '$regimenesComplete'
        '');
    setState(() {
      loading = false;
    });
  }

  void _scanQR() async {
    setState(() {
      loading = true;
    });
    if (await getPermission(Permission.camera)) {
      final cameraResult = await scanner.scan();

      if (cameraResult != null) {
        try {
          infoFiscal = await SatScraping.getInfoFiscal(cameraResult);
        } catch (e) {
          log('Error: $e');
          error = true;
          errorMessage = e.toString();
        }
      }
    }
    setState(() {
      loading = false;
    });
  }

  void _writeData() async {
    setState(() {
      loading = true;
    });
    // 假设这里有一个对话框让用户输入RFC和ID CIF
    final tmpMap = {"rfc": "TU_RFC", "idcif": "TU_ID_CIF"};
    if (tmpMap == null) {
      setState(() {
        loading = false;
      });
      return;
    }
    try {
      infoFiscal = await SatScraping.getInfoFiscalManual(
        rfc: tmpMap['rfc'] as String,
        idCif: tmpMap['idcif'] as String,
      );
    } catch (e) {
      log('Error: $e');
      error = true;
      errorMessage = e.toString();
    }
    setState(() {
      loading = false;
    });
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text(widget.title),
        centerTitle: true,
        actions: [
          IconButton(
            onPressed: () {
              error = false;
              setState(() {
                infoFiscal = InfoFiscal.getDefault();
              });
            },
            icon: const Icon(Icons.refresh),
          ),
        ],
      ),
      body: ListView(
        children: [
          const Padding(
            padding: EdgeInsets.all(8.0),
            child: Center(
              child: Text(
                'Escanea el código QR'
                '\no ingresa los datos manualmente'
                '\nque viene en la constancia'
                '\nde situación fiscal',
                textAlign: TextAlign.center,
              ),
            ),
          ),
          if (error)
            Padding(
              padding: const EdgeInsets.all(8.0),
              child: Center(
                child: Text('Error al obtener la información\n$errorMessage'),
              ),
            ),
          if (loading)
            const Center(child: CircularProgressIndicator.adaptive()),
          if (!loading && infoFiscal.rfc.isNotEmpty)
            InfoSat(infoFiscal: infoFiscal),
        ],
      ),
      floatingActionButton: Column(
        mainAxisAlignment: MainAxisAlignment.end,
        children: [
          FloatingActionButton(
            heroTag: 'write',
            onPressed: loading ? null : _writeData,
            tooltip: 'Escribir Datos',
            child: const Icon(Icons.edit),
          ),
          const SizedBox(height: 10),
          FloatingActionButton(
            heroTag: 'scan',
            onPressed: loading ? null : _scanQR,
            tooltip: 'Escanear QR',
            child: const Icon(Icons.qr_code_scanner),
          ),
          const SizedBox(height: 10),
          if (infoFiscal.rfc.isNotEmpty)
            FloatingActionButton(
              heroTag: 'shared',
              onPressed: loading ? null : _shared,
              tooltip: 'Compartir Breve Información',
              child: const Icon(Icons.share),
            ),
        ],
      ),
    );
  }
}

///Función para verificar el permiso deseado, si no lo tiene, lo solicita y
///regresa ese resultado
Future<bool> getPermission(Permission permission) async {
  final PermissionStatus status = await permission.status;
  if (status.isDenied) {
    final result = await permission.request().isGranted;
    return result;
  }
  return true;
}

自定义组件：InfoSat

为了显示税务信息，你可以创建一个自定义组件 InfoSat：

class InfoSat extends StatelessWidget {
  final InfoFiscal infoFiscal;

  const InfoSat({Key? key, required this.infoFiscal}) : super(key: key);

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Card(
      margin: const EdgeInsets.all(8.0),
      child: Padding(
        padding: const EdgeInsets.all(16.0),
        child: Column(
          crossAxisAlignment: CrossAxisAlignment.start,
          children: [
            Text('RFC: ${infoFiscal.rfc}'),
            Text('ID CIF: ${infoFiscal.idCif}'),
            Text('Razón Social: ${infoFiscal.razonSocial}'),
            Text('Código Postal: ${infoFiscal.cp}'),
            // 显示其他税务信息...
          ],
        ),
      ),
    );
  }
}