Manual da Plataforma Fiscal SAT Linux

(1)

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

Manual da Plataforma

Fiscal SAT – Linux

@ 2017 Lucas Viana e Fabio Sosa – BSP

BSP - Bematech Software Partners Manual da Plataforma Fiscal SAT – Linux – versão 1.0.0

(2)

Manual da Plataforma Fiscal SAT

© 2017 Lucas Viana e Fabio Sosa – BSP

por Lucas Viana e Fabio Sosa – BSP

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 2017

(3)

Índice de Conteúdo

Prefácio

Parte I - 1 - Bem-vindo ... 4

1.1 - Conhecendo a Plataforma ... 4

Parte II - 2 - Instalação e Configuração ... 5

2.1 - RB-1000_2000 FI ... 6

2.1.1 - Recebendo o RB 1000/2000 FI ... 6

Parte III - 3 - Instalação do software de ativação no Windows. ... 7

3.1 – Ativando o Software ... 9

3.2 - Associando Assinatura RB100/2000 FI ... 11

01 – Certificado – A1 ... 12

02 - CERTIFICADO - A3 ... 12

Parte IV - 4 - Instalando e Configurando o Fiscal Manager – Linux ... 16

4.1 - Configurando o Fiscal Manager ... 26

4.2 - Configurando o Virtual ECF ... 31

Parte V - 5 - Ativando o SAT com o Cliente Remoto ... 34

5.1 - Configurando o Cliente Remoto e o Concentrador. ... 37

Parte VI - 6 - Cenário de Teste ... 39

(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.

1.1 - 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;

(5)

2 - Instalação e Configuração

(6)

2.1 - RB-1000_2000 FI

2.1.1 - 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 Remoto).

(7)

3 - Instalação do software de ativação no Windows.

(8)

(9)

@2017 Lucas Viana e Fabio Sosa - BSP Página 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

(10)

@2017 Lucas Viana e Fabio Sosa - BSP Página 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 2.1.1 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:

(11)

@2017 Lucas Viana e Fabio Sosa - BSP Página 11 Clique em "Associar" e aguarde a mensagem de "associado com sucesso". Pronto, seu SAT está ativo e pronto para o uso!

3.2 - 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 02.00.05) como mostra a figura abaixo:

(12)

@2017 Lucas Viana e Fabio Sosa - BSP Página 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

(13)

@2017 Lucas Viana e Fabio Sosa - BSP Página 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

https://portal.fazenda.sp.gov.br/servicos/sat/Paginas/Sobre.aspx ; 3º => Acesso ao Guia do usuário / Acesso (Login) como Contribuinte 4º => Acesso ao SGRSAT. https://satsp.fazenda.sp.gov.br/COMSAT/

(14)

@2017 Lucas Viana e Fabio Sosa - BSP Página 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 copiou;

(15)

@2017 Lucas Viana e Fabio Sosa - BSP Página 15 8º => Clique no botão validar.

Para finalizar, somente clique no botão Associar, aguarde pala mensagem de retorno 'Assinatura AC registrada'

(16)

@2017 Lucas Viana e Fabio Sosa - BSP Página 16 Pronto assinatura do SAT/Software de Ativação associado com sucesso.

4 - Instalando e Configurando o Fiscal Manager – Linux

Nota: Versão Ubuntu 14.04 LTS 32 Bits

Logue como root. Comando: sudo su

(17)

@2017 Lucas Viana e Fabio Sosa - BSP Página 17 Atualize o seu sistema

(18)

@2017 Lucas Viana e Fabio Sosa - BSP Página 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

http://bematechpartners.com.br/wp01/upload-files/downloads/linux/sat/PlataformaFiscal/InstaladorBematechFiscalManagerLINUX.tar. zip

(19)

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

Comando: wget

(20)

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

Comando: wget http://bematechpartners.com.br/wp01/upload-files/downloads/linux/sat/Utilitarios/clienteSatRemoto_1.0-1.deb

(21)

@2017 Lucas Viana e Fabio Sosa - BSP Página 21 Instale o pacote de bibliotecas.

(22)

@2017 Lucas Viana e Fabio Sosa - BSP Página 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

(23)

@2017 Lucas Viana e Fabio Sosa - BSP Página 23 Entre na pasta BematechFiscalSAT.

Comando: cd BematechFiscalSAT

(24)

@2017 Lucas Viana e Fabio Sosa - BSP Página 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?

(25)

@2017 Lucas Viana e Fabio Sosa - BSP Página 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."

(26)

@2017 Lucas Viana e Fabio Sosa - BSP Página 26 Após isso, reinicie o computador.

Comando: reboot

4.1 - 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 Comando: ./BematechFiscal/SAT/app/runFiscalManagerSAT.sh

(27)

@2017 Lucas Viana e Fabio Sosa - BSP Página 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.

(28)

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

(29)

@2017 Lucas Viana e Fabio Sosa - BSP Página 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 abaixo."

(30)

@2017 Lucas Viana e Fabio Sosa - BSP Página 30 **Ou importe direto do JSON de exemplo (homologação):

JSON – FM(Fiscal Manager).

{"CNPJ":"82373077000171","CUSTODY_ENABLE":"0","ENVIRONMENT_HOMOLOG":"1" ,"ID_PDV":"PDV01","IE":"111111111111","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 ttyS43.

(31)

@2017 Lucas Viana e Fabio Sosa - BSP Página 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”.

4.2 - Configurando o Virtual ECF

(32)

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

(33)

@2017 Lucas Viana e Fabio Sosa - BSP Página 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":"4106902","xMun":"Curitiba","CEP":"78005260","NCM":"62000000"," 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.

(34)

@2017 Lucas Viana e Fabio Sosa - BSP Página 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.

(35)

@2017 Lucas Viana e Fabio Sosa - BSP Página 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 Configurar.

(36)

@2017 Lucas Viana e Fabio Sosa - BSP Página 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

(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.

(38)

@2017 Lucas Viana e Fabio Sosa - BSP Página 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 127.000.000.001.

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 1883.

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 Conectar.

(39)

@2017 Lucas Viana e Fabio Sosa - BSP Página 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 .

(40)

@2017 Lucas Viana e Fabio Sosa - BSP Página 40 Computador Linux – Ubuntu 14.04 LTS 32 bits

Computador Windows – Windows 10 64 bits

S.A.(Software de Ativação - Windows) = Configuração Remota

Configurar Concentrador: Nome do Grupo Grupobematech (mesmo grupo do

Concentrador) / IP: 127.000.000.001 (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: 10.12.100.29 - Nome do Grupo: GrupoBematech - Porta: 1883 - 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