Documentação
CLEARSALE
Start typing to search…

SDK de Captura de Documentos Flutter

v1.0.1

SDK ClearSale Flutter

Os SDKs de Captura de Documentos permitem a realização de capturas pelo usuário dentro de sua aplicação. Essas capturas passam por validações que identificam o tipo de documento e que avaliam a qualidade da imagem capturada, instruindo o usuário através de feedbacks visuais.

Requisitos

Android

  • Versão mínima do SDK android: 21 ( v5 )
  • Versão compileSDK android: 35

iOS

  • Versão mínima do iOS: 13.0
  • Adicionar permissão de câmera ( NSCameraUsageDescription ) e acesso a pasta de documentos( NSDocumentsFolderUsageDescription ) no seu Info.plist
  • Cocoapods
  • Versão mínima do Swift : 5.0

Flutter

  • Versão flutter : >=3.3.0
  • Versão sdk dart : >=3.3.0 <4.0.0

Instalação

Para começar a usar o SDK, você precisa instalá-lo em seu projeto. Supondo que você já tenha umprojeto Flutter, você pode instalar o SDK usando flutter pub get :

Primeiro, adicione o plugin ao seu pubspec:

flutter pub add csdocumentoscopysdkflutter

Então, adicione nosso repositório na sua lista de repositórios (no seu arquivo build.gradle.kts ou build.gradle ) no seu projeto android nativo:

allprojects {
 repositories {
 ...
 maven {
 url = uri("https://pkgs.dev.azure.com/CS-PublicPackages/SDKS/_packaging/SDKS/maven/v1")
 }
 }
}

Para iOS , primeiro instale o plugin cocoapods-azure-universal-packages.

Após isso, certifique-se de logar no azure cli com az devops login usando o PAT que foi enviado paravocê por e-mail.

az devops login --organization https://dev.azure.com/CS-PublicPackages

Feito isso, adicione nosso repositório no seu Podfile:

plugin 'cocoapods-azure-universal-packages', {
 :organization => 'https://dev.azure.com/CS-PublicPackages/'
}

Então, adicione o SDK como sua dependência no Podfile:

pod "CSDocumentosCopySDK", :http => 'https://dev.azure.com/CS-PublicPackages/SDKS/_apis/packagin

Inicialização

Abaixo, apresentamos um exemplo completo de como inicializar o SDK. Em seguida, detalharemos cadaetapa.

// Configuração do SDK
final sdk = CSDocsSDK(
 login: login,
 transactionId: "YourTransactionIDHere",
 identity: CSDocsIdentityConfiguration(identifierId: "YourIdentifierIdHere", cpf: "YourCPFHere"
 colors: CSDocsColorsConfiguration(
 primary: "YourPrimaryColorHere",
 secondary: "YourSecondaryColorHere",
 tertiary: "YourTertiaryColorHere",
 paragraph: "YourParagraphColorHere",
 title: "YourTitleColorHere",
 background: "YourBackgroundColorHere"),
 environment: CSDocsEnvironments.hml,
 flowTypes: [CSDocsFlowTypes.capture, CSDocsFlowTypes.upload]
);
// Lembre-se que a função que chama o método `init` precisa ser async.
try {
 final resultFromSdk = await sdk.init();
 result = jsonEncode(resultFromSdk.toJson());
} on CSDocsInternalErrorException catch (e) {
 result = "error from plugin: ${e.errorDescription}";
} catch (e) {
 result = "error: ${e.toString()}";
}

Login

A função login deve ser implementada para gerenciar a autenticação. O login será chamado nainicializacao do SDK e momentos antes do token expirar, renovando-o automaticamento.

O SDK espera que a função login retorne um tipo CSDocsAuthenticationResponse , que contém osseguintes atributos:

final String accessToken;
final int expiresIn;

Por questões de segurança, o token de autenticação da Clear Sale deve ser obtido através do servidor.Ou seja, a requisição de autenticação à Clear Sale deve ser feita a partir do servidor da aplicação.

Exemplo

Future<CSDocsAuthenticationResponse> login() async {
 final authenticationUrl =
 Uri.parse("YourServerURLHere");
 
 final authenticationRequestBody = ...
 final response = await http.post(authenticationUrl,
 headers: {"Content-Type": "application/json"},
 body: jsonEncode(authenticationRequestBody.toJson()));
 if (response.statusCode != 200) {
 throw StateError("Unable to fetch credentials");
 }
 final responseAsMap = jsonDecode(response.body) as Map<String, dynamic>;
 return CSDocsAuthenticationResponse(
 accessToken: responseAsMap["token"] as String,
 expiresIn: responseAsMap["expiresInSeconds"] as int);
}

Endpoint da API de autenticação da Clear Sale

  • URL: https://<clear.sale.api.url>/authentication (obter URL com a Clear Sale)
  • Método: POST
  • Corpo da Requisição:
{
 "Username": "seu-username", // Obter com a Clear Sale
 "Password": "seu-password" // Obter com a Clear Sale
}

ID da Transação

O ID da transação é obrigatório e deve ser gerado previamente através da API da Clear Sale.

Identificação

Ao iniciar o SDK, devem ser informados um código identificador e o CPF do usuário.

  • identifierId : String de até 100 caracteres obrigatória que identifica todo o fluxo do usuário deforma única e é gerada pelo cliente. Serve para agilizar consultas e chamados de suporte (e podeser utilizada como identificador interno entre produtos aqui da ClearSale).
  • cpf : String de 11 caracteres (no formato CPF) obrigatória que identifica o usuário que irá realizar ofluxo, devendo seguir as regras de validade estipuladas pelo Governo.

Exemplo

// Instanciação do SDK
final sdk = CSDocsSDK(
 identity: CSDocsIdentityConfiguration(identifierId: "YourIdentifierIdHere", cpf: "YourCPFHere"
 ...,
);

Fluxos

Ao iniciar o SDK, é possível informar quais fluxos serão habilitados através do parâmetro flowTypes . Ospossíveis valores são:

  • CAPTURE : Fluxo para captura de documentos utilizando uma câmera.
  • UPLOAD : Fluxo para upload de documentos.

Os fluxos estão expostos no enum CSDocsFlowTypes , que pode ser importado do SDK e utilizado daseguinte forma:

// Instanciação do SDK
final sdk = CSDocsSDK(
 flowTypes: [CSDocsFlowTypes.capture, CSDocsFlowTypes.upload],
 ...,
);

Cores

Ao iniciar o SDK, deve ser informado as cores atraves do parametro colors .

  • primary : Será aplicado como cor de fundo de botões de ação principais/ativos do SDK e outline debotões sem preenchimento
  • secondary : Será aplicado em ícones explicativos e carregamento, fundo de barras de feedback parausuário durante a tela de captura
  • tertiary : Será aplicado como cor de fundo de ícones informativos grandes
  • title : Será aplicado em textos que possuam o comportamento de título
  • paragraph : Será aplicado em textos que possuam comportamento de parágrafo e demais itens deapoio como o botão de fechamento do SDK
  • background : Será aplicado no background de todas as telas

Exemplo:

// Instanciação do SDK
final sdk = CSDocsSDK(
 colors: CSDocsColorsConfiguration(
 primary: "#FF4800",
 secondary: "#FF4800",
 tertiary: "#EFEFFF",
 paragraph: "#353840",
 title: "#283785",
 background: "#FFFFFF"
 ),
 ...,
);

Ambiente

Ao iniciar o SDK, você pode informar o ambiente desejado. Todas as requisições serão feitas para esteambiente, portanto, o método de login fornecido deve apontar para o mesmo.

  • HML: Ambiente de homologação. Todas as requisições do SDK serão feitas para o ambiente dehomologação.
  • PRD: Ambiente de produção. Todas as requisições do SDK serão feitas para o ambiente deprodução.

Exemplo

Os ambientes estão expostos no objeto Environments , que pode ser importado do SDK e utilizado daseguinte forma:

// Instanciação do SDK
final sdk = CSDocsSDK(
 environment: CSDocsEnvironments.hml,
 ...,
);

Método preLoad

O método preLoad pode ser chamado a qualquer momento antes da inicialização do SDK. Ele realiza aautenticação e prepara os dados do SDK, incluindo o download antecipado do modelo de machinelearning. Isso reduz o tempo de carregamento percebido pelo usuário durante a inicialização do SDK.

Idealmente, esse método deve ser chamado o mais cedo possível a partir do momento em que se prevêque o usuário passará pelo fluxo de captura ou upload do documento.

Uso do Método preLoad

// Instanciação do SDK
final sdk = CSDocsSDK(...);
// Em algum momento da aplicação em que se possa prever o uso do SDK,
// chamar o método preLoad usando a instância criada anteriormente.
sdk.preLoad(onLoaded: (auth) {
 ...
});
  • onLoaded: Função de callback que é chamada quando o pré-carregamento é concluído comsucesso. Recebe um parâmetro auth contendo dados de autenticação.Classe do parâmetro auth: CSDocsAuthenticationResponse

Licença

Copyright © 2024 ClearSale

Todos os direitos são reservados, sendo concedida a permissão para usar o software da maneira comoestá, não sendo permitido qualquer modificação ou cópia para qualquer fim. O Software é licenciadocom suas atuais configurações “tal como está” e sem garantia de qualquer espécie, nem expressa e nemimplícita, incluindo mas não se limitando, garantias de comercialização, adequação para fins particulares e não violação de direitos patenteados. Em nenhuma hipótese os titulares dos Direitos Autorais podem ser responsabilizados por danos, perdas, causas de ação, quer seja por contrato ou ato ilícito, ou outra ação tortuosa advinda do uso do Software ou outras ações relacionadas com este Software sem prévia autorização escrita do detentor dos direitos autorais.

Updated 1 day ago

Did this page help you?