DarumaMobileSAT Utilizando a biblioteca Daruma em Android para SAT

Transcrição

1 DarumaMobileSAT Utilizando a biblioteca Daruma em Android para SAT Escovadores de Bits, Vamos ver aqui um passo a passo de como adicionar e usar a biblioteca Android para o SAT Daruma, com alguns exemplos que mostraremos, você poderá realizar o uso de qualquer outro método da biblioteca. Antes de verificarmos o uso dos métodos, saiba que a biblioteca possui os métodos especificados pela SEFAZ e você pode verificar esta especificação que fica no site da SEFAZ, clicando no link a seguir: desça a página até Especificação de Requisitos do SAT, o primeiro arquivo da lista é o arquivo mais atual. Pré-requisitos: Para seguir este passo a passo, você precisa: - Ter o eclipse instalado em seu computador e também tenha um projeto Android criado para apenas adicionar os comandos; - Baixe a biblioteca DarumaMobileSAT: Descompacte o arquivo numa pasta a sua escolha, para importa-lo logo mais. Parte 1: A primeira coisa que precisamos fazer no projeto é importar a nossa biblioteca para dentro dele, vamos mostrar aqui como se faz isso de um projeto já criado no eclipse, se você esta usando outra IDE, o processo é similar. Para adicionar a nossa biblioteca ao seu projeto é só seguir os seguintes passos: Clique com o botão direito em cima do seu projeto, clique em Build Path depois em Add External Archives. 1

2 Selecione a biblioteca DarumaMobileSAT.jar no local em que descompactou, e clique em abrir. Na pasta do seu projeto vá em Referenced Libraries, clique na biblioteca com o botão direito e no menu Build Path escolha Configure Build Path.... 2

3 Em Order and Export selecione a DarumaMobileSAT e depois pressione OK. Feito isso, vamos adicionar este import, para finalizar a importação da biblioteca. No MainActivity adicione a linha abaixo: import br.com.daruma.frameworksat.mobile.darumamobilesat; Parte 2: Agora vamos criar um objeto do tipo DarumaMobileSAT que deve ser criado dentro da nossa classe principal, incluindo a seguinte linha. DarumaMobileSAT ds100i; 3

4 Em seguida vamos instanciar este objeto, dentro do nosso oncreate, usando um try catch. Informe como parâmetro de DarumaMobileSAT o context utilizado na sua aplicação, no exemplo utilizamos o this por ser a própria MainActivity o nosso context. try { ds100i = new DarumaMobileSAT(this); catch (Exception e) { String msg = e.getmessage(); AlertDialog.Builder Erro = new AlertDialog.Builder(MainActivity.this); Erro.setMessage("Erro: "+ msg); Erro.setNeutralButton("OK", null); Erro.show(); A imagem a seguir mostra a implementação no código. Parte 3: Depois de instanciar, podemos chamar os métodos do SAT que estão criados através do objeto ds100i. Lembrando que os tipos das variáveis, parâmetros e a sequencia dos métodos da DarumaMobileSAT seguem as especificações da SEFAZ, que está no link lá em cima. Observação: Ao executar a primeira comunicação que o nosso aplicativo faz com o SAT, é necessário que o usuário dê permissão. Sem nenhum tratamento vai aparecer na tela uma solicitação de permissão do aplicativo com o dispositivo USB, dê permissão para o aplicativo, feche e abra novamente para conseguir usar. Mas se fizer um tratamento, pode conceder esta permissão sem precisar fechar a aplicação. 4

5 Veja um exemplo de um método simples do SAT, de Consulta Status do SAT, aqui codificado em um botão: btnconsultar.setonclicklistener(new OnClickListener() public void onclick(view v) { try { String msg = String.valueOf(ds100i.ConsultarSAT(654321)); AlertDialog.Builder alert = new AlertDialog.Builder(MainActivity.this); alert.setmessage("retorno: " + msg); alert.setneutralbutton("ok", null); alert.show(); catch (Exception ex) { msg = ex.getmessage(); AlertDialog.Builder Erro = new AlertDialog.Builder(MainActivity.this); Erro.setMessage("Erro: " + msg); Erro.setNeutralButton("OK", null); Erro.show(); ; ); O método ConsultarSAT só tem um parâmetro do tipo int, que é o número da sessão. Esse número é um código aleatório com seis dígitos gerado pelo Aplicativo Comercial - AC. Veja o resultado da execução deste botão na imagem abaixo. 5

6 Agora vamos ver como usar o método EnviarDadosVenda e entender melhor o retorno que o SAT nos dá. Incluímos em outro botão: btnvender.setonclicklistener(new OnClickListener() public void onclick(view v) { try { String strxmlvenda = "<CFe><infCFe versaodadosent='0.07'><ide><cnpj> </cnpj><signac>sgr-sat SISTEMA DE GESTAO E RETAGUARDA DO SAT</signAC><numeroCaixa>001</numeroCaixa></ide><emit><CNPJ> </CNPJ><IE> </IE> <cregtribissqn>3</cregtribissqn><indratissqn>n</indratissqn></emit><dest></dest><det nitem='001'><prod><cprod>001</cprod><xprod>pao de forma</xprod><cfop>5102</cfop><ucom>kg</ucom><qcom>1.0000</qcom><vuncom>1.000</vuncom>< indregra>a</indregra></prod><imposto><icms><icms00><orig>0</orig><cst>00</cst><picms>1. 00</pICMS></ICMS00></ICMS><PIS><PISAliq><CST>01</CST><vBC>1.00</vBC><pPIS>1.0000</pPIS> </PISAliq></PIS><PISST><vBC>1.00</vBC><pPIS>1.0000</pPIS></PISST><COFINS><COFINSAliq><C ST>01</CST><vBC>1.00</vBC><pCOFINS>1.0000</pCOFINS></COFINSAliq></COFINS></imposto></de t><total><descacrentr><vdescsubtot>0.00</vdescsubtot></descacrentr><vcfelei12741>12.00< /vcfelei12741></total><pgto><mp><cmp>01</cmp><vmp>1.00</vmp></mp></pgto><infadic><infcp l>obrigada e volte sempre!</infcpl></infadic></infcfe></cfe>"; String msg = String.valueOf(ds100i.EnviarDadosVenda(123456, strcodativacao, strxmlvenda)); retvenda = msg.split("\\ "); AlertDialog.Builder alert = new AlertDialog.Builder(MainActivity.this); alert.setmessage("retorno: " + retvenda[9]); alert.setneutralbutton("ok", null); alert.show(); catch (Exception ex) { String msg = ex.getmessage(); AlertDialog.Builder Erro = new AlertDialog.Builder(MainActivity.this); Erro.setMessage("Erro: " + msg); Erro.setNeutralButton("OK", null); Erro.show(); ; ); 6

7 Cada método tem um padrão de retorno diferente, que pode ser consultado direto na legislação da SEFAZ, o link desta legislação esta no inicio deste STK. Veja um exemplo de retorno, o do comando de venda que acabamos de realizar, vamos usa-lo para explicar como ele é montado: Vejam que ele vem criptografado em sua maior parte, e as informações são separadas pelo caractere (pipe). No trecho do código retvenda = msg.split("\\ "); estamos pegando o retorno separado a cada caractere I encontrado, atribuindo o conteúdo ao array retvenda. Por exemplo, se você quer o arquivo 7

8 base64 do xml de retorno do sat, neste caso vai corresponder a posição retvenda[7], a chave de consulta por sua vez, ficaria na posição 9. E agora vamos ao significado de cada retorno dado pelo SAT no exemplo dado: EMITIDO COM SUCESSO PENGZT48aW...U+PC9DRmU CFe ha5ukxioer...ok9j9xtzfg== Número de sessão aleatório gerado pelo AC (Aplicativo Comercial) usado no envio de comando Código de retorno, indica Emitido com sucesso veja a tabela completa dos retornos, disponível na especificação do SAT no item Em caso de alerta ou rejeição da nota, este código é substituído por um dentre os possíveis códigos de retorno descritos no item da especificação do SAT, nos outros casos retorna o código EMITIDO COM SUCESSO - Mensagem referente ao código de retorno, neste caso o Os dois campos seguintes são respectivamente o código e a mensagem da SEFAZ de aviso ao usuário, neste caso como não houve nenhuma mensagem, eles estão vazios. O retorno que vai de PENGZT48aW5m... até...cmu+pc9drmu+ corresponde ao xml de resposta em base64, fazendo a sua decodificação da base64 ficaria assim: <CFe><infCFe Id="CFe " versao="0.07" versaodadosent="0.07" versaosb="010001"><ide><cuf>35</cuf><cnf>977290</cnf><mod>59</mod><nseriesat> </nseriesat><ncfe>000245</ncfe>< demi> </demi><hemi>105226</hemi><cdv>8</cdv><tpamb>2</tpamb><cnpj> </cnpj><signac>sgr-sat SISTEMA DE GESTAO E RETAGUARDA DO SAT</signAC><assinaturaQRCODE>hA5UkXIOerUAyo2yLY+98crZXWd8hUdC5JkSrBJ5wTkFIl9mYschNg6DKLN6fSKGdS30LZ8Rb89cXx826l6b5bb m90dcezh9wj28vys3egqor9tjuynbnkqnc9ht6zxoowo9y5v6b7ty1gojpfdphs8lruhcj8szjo462nkptmm5iy4t4nfxs+6ccchgbkz2jwgnjc4znvs4 te8s+otagnkvledgg6threxxj2ajegbm+rm+db9pwts6sr/v93hi3mnh7noy4f+39hui1akzznrn8pmsqybyuuaazpxhvibkr3vipsvhqlciifxuaecz 4ctmJu8MI09dOK9J9xtZfg==</assinaturaQRCODE><numeroCaixa>001</numeroCaixa></ide><emit><CNPJ> </CNPJ><xNome >DARUMA TELECOMUNICACOES E INFORMATICA S/A</xNome><xFant>URMET DARUMA</xFant><enderEmit><xLgr>AVENIDA INDEPENDENCIA</xLgr><nro>3500</nro><xBairro>LOT INDUSTRIAL</xBairro><xMun>TAUBATE</xMun><CEP> </CEP></enderEmit><IE> </IE><cRegTrib>3</cRegTrib><cRegT ribissqn>3</cregtribissqn><indratissqn>n</indratissqn></emit><dest/><det nitem="1"><prod><cprod>001</cprod><xprod>pao de forma</xprod><cfop>5102</cfop><ucom>kg</ucom><qcom>1.0000</qcom><vuncom>1.000</vuncom><vprod>1.00</vprod><indregra> A</indRegra><vItem>1.00</vItem></prod><imposto><ICMS><ICMS00><Orig>0</Orig><CST>00</CST><pICMS>1.00</pICMS><vICMS>0.01</v ICMS></ICMS00></ICMS><PIS><PISAliq><CST>01</CST><vBC>1.00</vBC><pPIS>1.0000</pPIS><vPIS>1.00</vPIS></PISAliq></PIS><PISST><vB C>1.00</vBC><pPIS>1.0000</pPIS><vPIS>1.00</vPIS></PISST><COFINS><COFINSAliq><CST>01</CST><vBC>1.00</vBC><pCOFINS>1.0000</pC OFINS><vCOFINS>1.00</vCOFINS></COFINSAliq></COFINS></imposto></det><total><ICMSTot><vICMS>0.01</vICMS><vProd>1.00</vProd>< vdesc>0.00</vdesc><vpis>1.00</vpis><vcofins>1.00</vcofins><vpisst>1.00</vpisst><vcofinsst>0.00</vcofinsst><voutro>0.00</vout ro></icmstot><vcfe>1.00</vcfe><descacrentr/><vcfelei12741>12.00</vcfelei12741></total><pgto><mp><cmp>01</cmp><vmp>1.00</v MP></MP><vTroco>0.00</vTroco></pgto><infAdic><infCpl>Obrigada e volte sempre!</infcpl><obsfisco xcampo="xcampo1"><xtexto>xtexto1</xtexto></obsfisco></infadic></infcfe><signature xmlns=" Algorithm=" Algorithm=" URI="#CFe "><Transforms><Transform Algorithm=" Algorithm=" Algorithm=" ue></reference></signedinfo><signaturevalue>zf1crhekgd/avm8h9mrdbakkmdn/bmxrswev3qee0ki2aiofn2it3at8e4md37hcyrqjq+uag 66w+tV9v6lySVLNaYhwCqo1/XDyHLex22Nva28q4LPlwPkirrtZDgk3jzHNU7UFHmbEhtAN2LG9CpZndlQkRIA1WzKFiARKJHoZ8Jozr6DZaA92RbI/lm 3V5EtDLoQADWaQRZhjrXBUbpLr349Y0A7Q7zQ0tAcv3mqGVa6hTdXnapgltHWQTvVmaq0E40iOwP6bFoLrADTzqX//i56wY8252vCDICH+sbAmya ZQEQfXV1tspifP7DKXazsQanyVQrYeDZDQ/U3uPw==</SignatureValue><KeyInfo><X509Data><X509Certificate>MIIGwTCCBKmgAwIBAgIJAR73 8

9 UoptuBNYMA0GCSqGSIb3DQEBCwUAMGcxCzAJBgNVBAYTAkJSMTUwMwYDVQQKEyxTZWNyZXRhcmlhIGRhIEZhemVuZGEgZG8gRXN0YWRvIG RlIFNhbyBQYXVsbzEhMB8GA1UEAxMYQUMgU0FUIGRlIFRlc3RlIFNFRkFaIFNQMB4XDTE2MTAyMTE5NTMxOFoXDTIxMTAyMTE5NTMxOFowgcY xejaqbgnvbautctkwmdawodywntelmakga1uebhmcqlixejaqbgnvbagtcvnhbybqyxvsbzerma8ga1uechmiu0vgqvotu1axdzanbgnv BAsTBkFDLVNBVDEoMCYGA1UECxMfQXV0ZW50aWNhZG8gcG9yIEFSIFNFRkFaIFNQIFNBVDFBMD8GA1UEAxM4REFSVU1BIFRFTEVDT01VTklDQ UNPRVMgRSBJTkZPUk1BVElDQSBTL0E6NDUxNzAyODkwMDAxMjUwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQCv2N7io30Nr3xtY ArVJogVay08rjINklL8Tc+nm9Z0Zf9D1PLQdRayuNVLMFSmX+4YF8h0oC1gIXLJEo/S+5IrbxrWZUn4TnYWJ8aS2X124P+l0y1s+wQc/lHkJPrSRMXJZVh n2j2paz6x26pztjfcgok4wtm7cfo3l1mokjhqns9fkocl2zs9zpntypfb80osgwa5kgssy8frzpx3kogx+y4h5kvqdkankla9lgt3xuj3yaepyiv4ltvrfe 2NOs86MjAn4CyiSpkktF6BSUSfAJXWUf32bJufPtUxYI5xeZoATaueHaJu9XXDvXaOxuI+vlU1COwA8CPYilj/8fJ5AgMBAAGjggIOMIICCjAOBgNVHQ8 BAf8EBAMCBeAwewYDVR0gBHQwcjBwBgkrBgEEAYHsLQMwYzBhBggrBgEFBQcCARZVaHR0cDovL2Fjc2F0LmltcHJlbnNhb2ZpY2lhbC5jb20uYnIvc mvwb3npdg9yaw8vzhbjl2fjc2f0c2vmyxpzcc9kcgnfywnzyxrzzwzhennwlnbkzjbrbgnvhr8ezdbimgcgxqbchlpodhrwoi8vywnzyxqtdgv zdguuaw1wcmvuc2fvzmljawfslmnvbs5ici9yzxbvc2l0b3jpby9sy3ivywnzyxrzzwzhennwl2fjc2f0c2vmyxpzcgnybc5jcmwwgaygccsgaquf BwEBBIGZMIGWMDQGCCsGAQUFBzABhihodHRwOi8vb2NzcC1waWxvdC5pbXByZW5zYW9maWNpYWwuY29tLmJyMF4GCCsGAQUFBzAChlJod HRwOi8vYWNzYXQtdGVzdGUuaW1wcmVuc2FvZmljaWFsLmNvbS5ici9yZXBvc2l0b3Jpby9jZXJ0aWZpY2Fkb3MvYWNzYXQtdGVzdGUucDdjMBM GA1UdJQQMMAoGCCsGAQUFBwMCMAkGA1UdEwQCMAAwJAYDVR0RBB0wG6AZBgVgTAEDA6AQBA40NTE3MDI4OTAwMDEyNTAfBgNVHSM EGDAWgBSOOUEAXPK4BdqobZi5AUZtbmPfAjANBgkqhkiG9w0BAQsFAAOCAgEAQVIsstvPTfk/ar8lZFJOiI4Tfpx78OZ6+kENkzGex4cyizuvNwXsAkN jdyfmnshragmuzzjvai1cl1rrvspkuxafv/cyfqnrswtflckhn476fougadkzloylrevwp0blcf6nwu4adjsn22dyb9wmhsqrwmksf19/1ui2dh3ha xr5mhl5bjn8rmobedv21wxb+brhs07ofoblrflpm0aztifrokcfvdqd/+z+6b+blngdf+0sf28yymscxgxxurhydajcidpzfgx67szjbqqfkdnvrmvmz z8dl6jbqvwmhwgrej6jbmmejoog3oihmv2o5ku3cvurc/qcenf8tvux8bzgjiuwmi/k6mbgsjqvlemgz8jtaad9rp5ws8vvo2fj+gbrx5gabusio vxhlvjytqzlhb/vlhghqfnyywmgjfsgba6u/p2jhv3few6wu8d0lkoaop0ry6vjmzsohw3q2nv+ureyscit5tzodipel8dole6q+inqpmdzlyt8tm40 07iWV49hXM+u0FWw6ArgZDJ62Ie+B0YjGdcvfUIIcs9OLTPhA1SsQdSZ50NGLDpcjcH5BfRGjoywM+tGJm5ffe+1ibUvj9WmZc9Rdbq30SUNFbPA0k yivqbtmljdwxngt5hgehga33x+jikhyy0hqayylgo04iykpm1zjd+ikyg=</x509certificate></x509data></keyinfo></signature></cfe> Data e hora da emissão do cupom. CFe Chave de consulta do cupom Valor total do cupom. O próximo parâmetro esta em branco, pois não identificamos o consumidor, caso contrário estaria o valor do CPF ou CNPJ do consumidor neste campo. ha5ukxioer...ok9j9xtzfg== - Corresponde a assinatura do XML, impressa no QRCode e finaliza a resposta. Desta forma vimos como realizar as chamadas aos métodos de nossa biblioteca SAT e como tratar as respostas. Basta agora aplicar esse conceito que vimos aos demais métodos e implementar em sua aplicação para realizar vendas com o SAT Daruma. Guia de métodos da DMF SAT Conforme especificação da SEFAZ, os métodos disponibilizados pela biblioteca de comandos são os seguintes: AssociarAssinatura (int numerosessao, String codigoativacao, StringCNPJ, String AssinaturaCNPJs): String AtivarSAT (int numerosessao, int subcomado, String codigoativacao, String CNPJ, int cuf): String AtualizarSoftwareSAT (int numerosessao, String codigoativacao): String BloquearSAT (int numerosessao, String codigoativacao): String CancelarUltimaVenda (int numerosessao, String codigoativacao, Stringchave, String dadoscancelamento): String ComunicarCertificadoICPBRASIL (int numerosessao, String codigoativacao, String certificado): String ConfigurarInterfaceDeRede (int numerosessao, String codigoativacao, String dadosconfiguracao): String 9

10 ConsultarNumeroSessao (int numerosessao, String codigoativacao, int cnumerosessao): String ConsultarSAT (int numerosessao): String ConsultarStatusOperacional (int numerosessao, String codigoativacao): String DesbloquearSAT (int numerosessao, String codigoativacao): String EnviarDadosVenda (int numerosessao, String codigoativacao, String dadosvenda): String ExtrairLogs (int numerosessao, String codigoativacao): String TesteFimAFim (int numerosessao, String codigoativacao, String dadosvendas): String TrocarCodigoDeAtivacao (int numerosessao, String codigoativacao, int opcao, String novocodigo, String confirmanovocodigo): String Possuímos ainda um método extra de consulta da Versão da Biblioteca de comandos, ele não possui parâmetros e retorna apenas a versão: regretornarversaodriver(): String Se tiver alguma dúvida e/ou dificuldade, entre em contato com a nossa equipe de suporte ao desenvolvedor. s: suporte.desenvolvedores@daruma.com.br, suporte@daruma.com.br, desenvolvedores.suporte@daruma.com.br, desenvolvedores.daruma@daruma.com.br, daruma.desenvolvedores@daruma.com.br, suporte.daruma@daruma.com.br, ddc.suporte@daruma.com.br, desenvolvedores.kiosk@daruma.com.br, claudenir@daruma.com.br Skypes: suporte_daruma, daruma.desenvolvedores, desenvolvedores_daruma, desenvolvedores.daruma, desenvolvedores_suporte_daruma, suporte_desenvolvedores_daruma, suporte_desenvolvedores_daruma, suporte.daruma, ddc_suporte_daruma, desenvolvedores_kiosk, claudenir_andrade 10