Descrição
O método sendInstall serve para realizar a instalação e ativação do Agente. Ele pode ser chamado sempre que o dispositivo for iniciado para garantir que o agente esteja ativado. Contudo, seu uso ao iniciar o dispositivo não é obrigatório, sendo apenas uma recomendação para evitar falhas operacionais.
Assinatura do Método:
fun sendInstall(context: Context, model: PedInstallModel, callback: (NFCeResult) -> Unit) |
PARÂMETROS |
|
Nome |
Descrição |
context |
O contexto Android necessário para executar a instalação do agente. |
model |
Objeto que contém os dados necessários para o processo de instalação do agente. |
CAMPOS DO MODELO |
||||
Campo |
Tipo |
Ob. |
Tam. |
Descrição |
routerUrl |
C |
S |
44 |
URL do Concentrator Router para onde as requisições serão enviadas. |
enterprise |
C |
S |
15 - 255 |
CNPJ da empresa que está sendo configurada. |
agentKey |
C |
S |
15 - 255 |
Identificador único do agente. |
serie |
N |
N |
3 |
Deverá ser informado a série da nota para o processo de Set Num. |
number |
N |
N |
9 |
Informar a numeração inicial para a realização do processamento de notas. Ao enviar este campo com o valor 0, o sistema consultará a retaguarda e o banco de dados do agente, para obter o maior número de documento processado para o CNPJ e série informados, utilizando o valor subsequente como referência para o inicio do processamento. Neste processo, a numeração armazenada no Agente/Concentrador será ignorada. |
csc |
C |
N |
1-50 |
Código de Segurança do Contribuinte – CSC, utilizado na geração do QR Code |
cidToken |
C |
N |
1-50 |
Identificador do CSC (Token ID), fornecido pela Sefaz |
UF |
C |
N |
2 |
Código numérico da Unidade da Federação (ex: 35 para SP, 23 para CE) |
Exemplo de instância:
val model = PedInstallModel ().apply { agentKey = "LOJANDDSP001" routerUrl = "http://localhost:8080/WSConcentratorRouter/api?concentratorkey=CONCENTRATOR_NDD" enterprise = "12345678910111" setNumModel = SetNumModel() setNumModel!!.numeracaoModel = NumeracaoModel() setNumModel!!.numeracaoModel!!.serie = "849" setNumModel!!.numeracaoModel!!.numero = "1" qrcode = QrCodeModel() qrcode!!.csc = "gsdgweg43tesgwt2ws" qrcode!!.cidToken = "00001" qrcode!!.UF = "35" } • callback: (NFCeResult) -> Unit Função de callback que será chamada com o resultado do processo após a conclusão. |
|
Exemplo de Uso:
val controller = AgentLibraryController() val model = PedInstallModel().apply { agentKey = "LOJANDDSP001" routerUrl = "http//localhost:8080/WSConcentratorRouter/api?concentratorkey=CONCENTRATOR_NDD" enterprise = "12345678910111" setNumModel = SetNumModel() setNumModel!!.numeracaoModel = NumeracaoModel() setNumModel!!.numeracaoModel!!.serie = "849" setNumModel!!.numeracaoModel!!.numero = "1" qrcode = QrCodeModel() qrcode!!.csc = "gsdgweg43tesgwt2ws" qrcode!!.cidToken = "00001" qrcode!!.UF = "35" } controller.sendInstall (context, model) { result -> when (result.response?.code) { 100 -> println("Sucesso: ${result.response?.description}") 227 -> println("Erro: ${result.response?.description}") else -> println("Código desconhecido: ${result.response?.code}") } } |
Retorno: Retorna um objeto do tipo NFCeResult, que contém as informações sobre o resultado do processo.
CÓDIGOS DE RETORNO |
|
Código |
Descrição |
100 |
Processamento realizado com sucesso. |
227 |
Não foi possível realizar o processo de instalação. |