Manual da Plataforma Fiscal SAT Linux

Transcrição

1 Manual da Plataforma Fiscal SAT 2017 Lucas Viana e Fabio Sosa BSP BSP - Bematech Software Partners Manual da Plataforma Fiscal SAT Linux versão Lucas Viana e Fabio Sosa - BSP Página 1

2 Manual da Plataforma Fiscal SAT 2017 Lucas Viana e Fabio Sosa BSP por Lucas Viana e Fabio Sosa BSP Esse é o Manual da Plataforma Fiscal SAT para o ambiente Linux Ubuntu LTS 32 bits, desenvolvido por 2017 Lucas Viana e Fabio Sosa - BSP Todos os direitos reservados. Criado para consulta de desenvolvedores que estão utilizando nosso produto, qualquer dúvida ou sugestão entrar em contato com nossa equipe, pelos contatos de suporte na seção "Suporte". março de Lucas Viana e Fabio Sosa - BSP Página 2

3 Índice de Conteúdo Prefácio Parte I Bem-vindo Conhecendo a Plataforma... 4 Parte II Instalação e Configuração RB-1000_2000 FI Recebendo o RB 1000/2000 FI... 6 Parte III Instalação do software de ativação no Windows Ativando o Software Associando Assinatura RB100/2000 FI Certificado A CERTIFICADO - A Parte IV Instalando e Configurando o Fiscal Manager Linux Configurando o Fiscal Manager Configurando o Virtual ECF Parte V Ativando o SAT com o Cliente Remoto Configurando o Cliente Remoto e o Concentrador Parte VI Cenário de Teste Parte VII - 7 Controle de Versão do Manual... Lucas Viana e Fabio Sosa - BSP Página 3

4 1 - Bem-vindo Obrigado por utilizar nossa Plataforma Fiscal SAT. Tenha certeza que esse produto foi feito para facilitar o desenvolvimento da sua aplicação e atender à legislação do SAT Fiscal Conhecendo a Plataforma Sobre a Plataforma Fiscal para SAT A Plataforma Fiscal SAT é uma ferramenta que facilita as aplicações comerciais de se adequarem à legislação do SAT Fiscal. Com a Plataforma, sua aplicação será capaz de fazer: Construção do XML do CF-e-SAT; Envio de venda para o SAT; Impressão do extrato CF-e; Gerenciar a fila no caso de mais de um PDV por SAT; Custódia simples dos arquivos ou por Cloud Lucas Viana e Fabio Sosa - BSP Página 4

5 2 - Instalação e Lucas Viana e Fabio Sosa - BSP Página 5

6 2.1 - RB-1000_2000 FI Recebendo o RB 1000/2000 FI Ao adquirir seu equipamento RB 1000/2000 S@T, você deve conectá-lo a uma entrada USB do seu computador e a um cabo de rede vindo do modem (rede), como na imagem abaixo: Após isso, instale o Software de Ativação, que pode ser baixado no link: Portal Partners Bematech (Obs: A ativação do Sat será por meio de ativação remota, pois ainda não temos software nativo para ativação para Linux. Veremos no capitulo 5 a instalação do SAT Cliente Lucas Viana e Fabio Sosa - BSP Página 6

7 3 - Instalação do software de ativação no Lucas Viana e Fabio Sosa - BSP Página 7

8 @2017 Lucas Viana e Fabio Sosa - BSP Página 8

9 É necessário garantir que o S@T possa se conectar ao webservice da Sefaz, caso esteja em uma rede restrita, deve-se liberar os seguintes endereços e portas: 1 - wssathomolog.fazenda.sp.gov.br 2 - satnacional.fazenda.sp.gov.br 3 - Portas 80 e 443 TCP Também tem o servidor de horário que tem que estar disponível para o equipamento: 1 - ntp.cais.rnp.br 2 - Porta 123 UDP 3.1 Ativando o Software As informações de ativação do S@T é realizado nessa Lucas Viana e Fabio Sosa - BSP Página 9

10 Você deve inserir o Código de Ativação que deve ser criado neste momento e deve obedecer a regulamentação da SEFAZ SAT, na especificação técnica capítulo item b.1: "O código de ativação do Equipamento SAT deverá ser escolhido pelo contribuinte e possuir um mínimo de 8 e um máximo de 32 caracteres alfanuméricos." Obs.: No caso de SAT de homologação, devem ser utilizados os dados da Bematech, pois a SEFAZ só liberou o ambiente de homologação para as fabricantes. Dados para homologação: Após ativado, o próximo passo é a associação da Lucas Viana e Fabio Sosa - BSP Página 10

11 Clique em "Associar" e aguarde a mensagem de "associado com sucesso". Pronto, seu SAT está ativo e pronto para o uso! Associando Assinatura RB1000/2000 FI Para o S@T em produção, é necessário criar um arquivo de assinatura contendo o CNPJ da software house e do contribuinte, assinado pelo certificado digital da software house A1 ou A3. Esse procedimento pode ser feito no próprio software de ativação (a partir da versão ) como mostra a figura Lucas Viana e Fabio Sosa - BSP Página 11

12 01 Certificado A1 Selecionando a opção "Certificado A1", ele irá detectar automaticamente e irá gerar a assinatura no campo especificado - desde que o certificado digital esteja instalado pelo Internet Explorer, com a opção de chave exportável no computador! Duvidas de como instalar o certificado A1 como chave exportável? Clique Aqui 02 - CERTIFICADO - Lucas Viana e Fabio Sosa - BSP Página 12

13 Selecionando a opção "Certificado A3", ao selecionar A3, automaticamente será aberto o PIN solicitando a senha, insira a senha, após validação da senha cera 2 gerado a Hash da assinatura de 344 caracteres. Já possuo a Hash da assinatura de 344 caracteres, como faço? Simples, pelo próprio software de ativação clique no botão ABRIR ARQUIVO, em seguida selecione o arquivo.txt com a assinatura. Com a assinatura inserida, basta clicar no botão ASSOCIAR. Precisa validar a assinatura antes de associar? Simples siga o passo a passo: Validando assinatura: 1º => Selecione e copie toda a hash da assinatura (344 caracteres); 2º => Acesse o Site da Sefaz ; 3º => Acesso ao Guia do usuário / Acesso (Login) como Contribuinte 4º => Acesso ao SGRSAT. Lucas Viana e Fabio Sosa - BSP Página 13

14 Na aba Tratamento / Validar Código de Vinculação: 5º => Vá na aba Tratamento / Validar Código de Vinculação; 6º => Preencha os campos CNPJ Software House + CNPJ Contribuinte; 7º => Cole a hash da assinatura que Lucas Viana e Fabio Sosa - BSP Página 14

15 8º => Clique no botão validar. Para finalizar, somente clique no botão Associar, aguarde pala mensagem de retorno 'Assinatura AC Lucas Viana e Fabio Sosa - BSP Página 15

16 Pronto assinatura do SAT/Software de Ativação associado com sucesso. 4 - Instalando e Configurando o Fiscal Manager Linux Nota: Versão Ubuntu LTS 32 Bits Logue como root. Comando: sudo Lucas Viana e Fabio Sosa - BSP Página 16

17 Atualize o seu sistema Comando: apt-get Lucas Viana e Fabio Sosa - BSP Página 17

18 Instale o Socat e o Java 7 Comando: apt-get install socat openjdk-7-jdk Criar um diretório default para armazenar os arquivos. Sugestão "opt" Comando: mkdir opt Entre na pasta com o comando: cd opt Realize o download do instalador do Fiscal Manager. Comando: wget Lucas Viana e Fabio Sosa - BSP Página 18

19 Após isso, realize o download das bibliotecas Comando: wget Lucas Viana e Fabio Sosa - BSP Página 19

20 Após isso, realize o download do Cliente Remoto, onde vamos ativar o S@T. Comando: wget Lucas Viana e Fabio Sosa - BSP Página 20

21 Instale o pacote de bibliotecas. Comando: dpkg -i Lucas Viana e Fabio Sosa - BSP Página 21

22 Descompacte o arquivo.zip do instalador Fiscal Manager. Comando: unzip InstaladorBematechFiscalManagerLINUX.tar.zip Obs. Ao efetuar a descompactação lhe será gerado dois arquivos distintos, "Docs" arquivos relacionados para auxílio ao desenvolvimento e arquivos tar.gz voltado para a instalação da plataforma Sat Bematech. Descompacte o arquivo tar.gz Comando: tar vzxf Lucas Viana e Fabio Sosa - BSP Página 22

23 Entre na pasta BematechFiscalSAT. Comando: cd BematechFiscalSAT Para iniciar a instalação execute o Lucas Viana e Fabio Sosa - BSP Página 23

24 Após isso, basta seguir as opções abaixo. Obs: No cenário do tutorial, vamos instalar o All in-one. Escolha as opções: Estas informações estão corretas? Caso as informações estiverem corretas, escolha a opção "1" Escolha a modalidade para instalação do Fiscal Manager Caso a escolha seja All in-one (opção que está sendo instalada no manual) escolha a opção "3" Deseja instalar o VirtualECF? Caso deseje instalar o Virtual ECF, clique na opção Lucas Viana e Fabio Sosa - BSP Página 24

25 Atenção: Caso apareça alguma mensagem Ligue ou reinicie o Sat, e o Sat, esteja ligado e conectado, reinicie o mesmo, quando ele terminar de ligar, após aperte Enter para continuar. Obs. se tudo ocorrer bem, você receberá a mensagem :"Instalação efetuada com sucesso!! SAT (RB-1000 FI/RB-2000 FI) reconhecido corretamente." Em nosso exemplo, a figura abaixo mostra a instalação juntamente com o Virtual Lucas Viana e Fabio Sosa - BSP Página 25

26 Após isso, reinicie o computador. Comando: reboot Configurando o Fiscal Manager Nota: "Se estiver utilizando a API One, é possível configurar o FM utilizando o JSON de configuração. Clique aqui para acessar o manual e toda a documentação da API One. Entre na pasta raiz. Comando: cd / E execute o runfiscalmanagersat.sh localizado na pasta /BematechFiscal/SAT/app Lucas Viana e Fabio Sosa - BSP Página 26

27 Obs. caso queira verificar se o serviço está rodando, utilize o comando: ps aux grep javaw Após iniciar o serviço do Fiscal Manager, irá aparecer um ícone na sua área de notificação. Clique com o botão direito em cima do ícone e vá em Painel de Lucas Viana e Fabio Sosa - BSP Página 27

28 Aparecerá a tela inicial da configuração do Fiscal Manager. Utilize o Login admin e a senha Lucas Viana e Fabio Sosa - BSP Página 28

29 Clique em configurações e depois em Configurações do Fiscal Manager S@T "Se estiver configurando para homologação, utilize os dados do fabricante conforme Lucas Viana e Fabio Sosa - BSP Página 29

30 **Ou importe direto do JSON de exemplo (homologação): JSON FM(Fiscal Manager). {"CNPJ":" ","CUSTODY_ENABLE":"0","ENVIRONMENT_HOMOLOG":"1","ID_PDV":"PDV01","IE":" ","PRINTER_MP2500":"0","PRINT_LOGO":"1"," PRINT_LOGO_IMG":"/home/sat/imagens/Bematech.bmp","RAZAO_SOCIAL":"BEMATEC H S/A","SAT_ATIVACAO":"bema1234","SAT_SERIAL_PORT":" /dev/ttys43","uri_impressora":"spooler:// /dev/ttys45","api_port":"21212","custodia_local":"1","cut_extrato":"1","impr IMIR_EXTRATO":"1","PROXY":"0","PROXY_DOMAIN":"","PROXY_HOST":"","PROXY_PA SSWORD":"","PROXY_PORT":"","PROXY_USER":"","VALIDACAO":"0"} Obs: Os pontos em vermelhos devem ser preenchidos conforme a configuração do seu computador. O PRINT_LOGO_IMG é o caminho a onde a logo estará localizada. No nosso exemplo ela está em /home/sat/imagens/bematech.bmp. Obs: Na SAT_SERIAL_PORT, coloque o caminho da tty onde está o seu SAT e em URL da Impressora a tty da impressora. E na URI_IMPRESSORA a localização da impressora. Caso precise ver qual tty está o SAT ele se encontra em nosso exemplo como ttyacm0 com o link para a Lucas Viana e Fabio Sosa - BSP Página 30

31 O comando para verificar é o ls -lh /dev/ttys* Após preencher as informações, basta clicar em Salvar e a mensagem de confirmação que aparecerá é a Configuração alterada com sucesso Configurando o Virtual ECF Clique em configurações e depois em Configurações do Virtual Lucas Viana e Fabio Sosa - BSP Página 31

32 "Se estiver configurando para homologação, utilize os dados do fabricante conforme Lucas Viana e Fabio Sosa - BSP Página 32

33 **Ou importe direto do JSON de exemplo (homologação): JSON VECF(Virtual ECF). {"IM":"ISENTO","CRT":"3","portaSerial":"/home/sat/tty1","cUF":"41","xUF":"PR","xFant ":"BEMATECH S/A","xLgr":"Avenida Comendador Franco","nro":"930","xBairro":"Jardim botânico","cmun":" ","xmun":"curitiba","cep":" ","ncm":" "," orig":"0","cfop":"5101","loglevel":"1","salvararquivo":"0","pathout":"/bematechfiscal/ SAT/VirtualECF","timeoutBNF":"60"} Obs: O ponto em vermelho deve ser preenchido conforme a configuração do seu computador. Obs: A Porta Serial VCEF é a porta virtual criada pelo sistema. Ela é a /home/$user/tty1, no nosso caso /home/sat/tty1. Após preencher as informações, basta clicar em Salvar e a mensagem de confirmação que aparecerá é a Configuração alterada com sucesso. Reinicie o Sistema. Comando: reboot Para executar o Virtual ECF, primeiramente execute o Fiscal Manager e após isso execute o Virtual ECF. Comando: cd Lucas Viana e Fabio Sosa - BSP Página 33

34 E execute o runvirtualecf.sh localizado na pasta /BematechFiscal/SAT/VirtualECF Comando: /BematechFiscal/SAT/VirtualECF/runVirtualECF.sh ***Feito isso seu FM e o VECF estará funcional p/ operar no ambiente de Homologação*** Mas ainda precisa ativar o SAT com o Cliente Remoto. 5 - Ativando o SAT com o Cliente Remoto Antes de começar a instalar o cliente remoto para ativação do Sat, vamos explicar um pouco do Software de Ativação Remoto. O Software de Ativação Remoto veio para atender uma necessidade dos clientes da Bematech em configurar e consultar os equipamentos SAT em vários locais diferentes evitando o deslocamento e tempo perdido o que gera custos. Com ele é possível realizar operações no SAT de forma remota, utilizando um servidor concentrador para acessar os equipamentos disponíveis na rede. O Cliente SAT Remoto é um aplicativo que permite conectar-se com o servidor e disponibilizar o SAT para acesso. Para cada estação com SAT, deve-se instalar o Cliente SAT Remoto. Agora vamos iniciar a instalação e configuração do Cliente Lucas Viana e Fabio Sosa - BSP Página 34

35 Entre na pasta home/sat/opt e execute o clientesatremoto_1.0-1.deb. Comando 1: cd /home/sat/opt Comando 2: dpkg -i clientesatremoto_1.0-1.deb Entre na pasta /usr/lib/clientesatremoto e execute o ClienteSATRemoto Comando 1: cd /usr/lib/clientesatremoto Comando 2: ClienteSATRemoto & Após aparecer um ícone na barra de notificação, clique com o botão direito e depois em Lucas Viana e Fabio Sosa - BSP Página 35

36 Atenção: Caso encontre problemas com o path Java ao selecionar a OPc "inciar SAT Remoto", Edite o arquivo: da dll propeties alterando o lugar a onde a dll está salva. Comando: vi /usr/lib/clientesatremoto/dllproperties.prop No campo dlllocation altere para: dlllocation=/usr/lib/libbemasat.so Salve o Arquivo. Atenção: Caso o cliente remoto não inicie, edite o arquivo ClienteSATRemoto Comando: vi /usr/lib/clientesatremoto/clientesatremoto Para nohup java -jar /usr/lib/clientesatremoto/clientesatremoto.jar Lucas Viana e Fabio Sosa - BSP Página 36

37 5.1 - Configurando o Cliente Remoto e o Concentrador. A configuração do cliente remoto é: Ip do Concentrador: Ip do Computador a onde está localizado o concentrador e o software de ativação. Nesse caso é um computador Windows. Porta: 1883 (Porta Padrão). NomedoGrupo: GrupoBematech Nome do S@T: SatHomologacao *Obs: Esses dados podem ser editados, contanto que o Nome do Grupo seja o mesmo do Cliente (No exemplo é o Linux) e o Concentrador (No exemplo é um computador Windows). Clique em Salvar e Iniciar. No Windows, abra o Software de Ativação e Clique na opção Configuração Lucas Viana e Fabio Sosa - BSP Página 37

38 Na guia Configurar Concentrador vamos configurar o concentrador do software de ativação. No Nome do Grupo é o grupo que irá estar o SAT Linux, no caso GrupoBematech. Endereço (IP) Concentrador é o ip local do computador Obs: O preenchimento de todos os campos do Endereço (IP) é obrigatório. Como exemplo acima a onde todos os campos estão devidamente preenchidos com 0. A porta é a padrão Feito isso, clique em conectar para ativar o serviço. Na guia Conectar Sat após ativarmos o serviço ele irá aparecer o Sat que está conectado no Linux, clique em Lucas Viana e Fabio Sosa - BSP Página 38

39 Obs: O nome do Software de ativação pode ser editado sem problemas. Feito isso, caso queira efetuar um teste de verificação da ativação do SAT, basta ir no Menu -> Consulta. Atenção: Caso no software de ativação no Windows a opção de consulta aparecer a mensagem de erro de dll, verifique se a localização da dll do arquivo dllproperties se está com o caminho dlllocation=/usr/lib/libbemasat.so. 6 - Cenário de Lucas Viana e Fabio Sosa - BSP Página 39

40 Computador Linux Ubuntu LTS 32 bits Computador Windows Windows bits S.A.(Software de Ativação - Windows) = Configuração Remota Configurar Concentrador: Nome do Grupo Grupobematech (mesmo grupo do Concentrador) / IP: (ip do Concentrador) / Porta: 1883 (porta default que deve estar liberada no Concentrador e no firewall/proxy) Cliente (Cliente no Linux)= "cliente remoto.jar" >> responsável pela comunicação com Concentrador, no intuito de criar uma ponte entre o Software de Ativação em uma máquina Windows. Ip do Concentrador: Nome do Grupo: GrupoBematech - Porta: Nome do Sat: SatHomologacao Grupo: GrupoBematech (nome de sua preferência) / Nome do S@T: SatHomologacao (nome de sua preferência) 7 Controle de Versão do Manual Controle de Versão do Manual Versão Alteração Autor Primeira Versão Lucas Viana e Fabio Lucas Viana e Fabio Sosa - BSP Página 40