Manual da Plataforma Fiscal SAT Linuxbematechpartners.com.br/wp01/upload-files/downloads/...Manual...

Manual da Plataforma Fiscal SAT - Linux

@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



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 14.04 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 2017



Í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

Parte VII - 7 – Controle de Versão do Manual ...................................................... 40



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;

Custódia simples dos arquivos ou por Cloud (nuvem).



2 - Instalação e Configuração



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



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



É 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 tela:



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:

Após ativado, o próximo passo é a associação da assinatura:



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:



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 - A3

http://bematechpartners.com.br/wp01/?p=1833



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/

https://portal.fazenda.sp.gov.br/servicos/sat/Paginas/Sobre.aspx

https://satsp.fazenda.sp.gov.br/COMSAT/



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;



8º => Clique no botão validar.

Para finalizar, somente clique no botão Associar, aguarde pala mensagem de retorno

'Assinatura AC registrada'



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



Atualize o seu sistema

Comando: apt-get update



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



Após isso, realize o download das bibliotecas


files/downloads/linux/sat/Middleware/libbemasat_1.0.20-debian6_i386.deb

http://bematechpartners.com.br/wp01/upload-files/downloads/linux/sat/Middleware/libbemasat_1.0.20-debian6_i386.deb

http://bematechpartners.com.br/wp01/upload-files/downloads/linux/sat/Middleware/libbemasat_1.0.20-debian6_i386.deb



Após isso, realize o download do Cliente Remoto, onde vamos ativar o S@T.


files/downloads/linux/sat/Utilitarios/clienteSatRemoto_1.0-1.deb



Instale o pacote de bibliotecas.

Comando: dpkg -i libbemasat_1.0.20-debian6_i386.deb



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 InstaladorBematechFiscalManager_3.0.1_LINUX.tar.gz



Entre na pasta BematechFiscalSAT.

Comando: cd BematechFiscalSAT

Para iniciar a instalação execute o comando: ./instalador_fiscal_manager_sat.sh



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 "1"



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



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

http://bematechpartners.com.br/wp01/?page_id=2134



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



Aparecerá a tela inicial da configuração do Fiscal Manager.

Utilize o Login admin e a senha fmsat



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



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



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

Clique em configurações e depois em Configurações do Virtual ECF



"Se estiver configurando para homologação, utilize os dados do fabricante conforme

abaixo."



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

Comando: cd /



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



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.



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 &



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



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.



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 Teste



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

1.0.0 Primeira Versão Lucas Viana e Fabio Sosa

Manual da Plataforma Fiscal SAT Linuxbematechpartners.com.br/wp01/upload-files/downloads/...Manual...

Documents

Transcript of Manual da Plataforma Fiscal SAT Linuxbematechpartners.com.br/wp01/upload-files/downloads/...Manual...