View
17
Download
0
Category
Preview:
Citation preview
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 - Linux
@2017 Lucas Viana e Fabio Sosa - BSP Página 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 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
Manual da Plataforma Fiscal SAT - Linux
@2017 Lucas Viana e Fabio Sosa - BSP Página 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
Parte VII - 7 – Controle de Versão do Manual ...................................................... 40
Manual da Plataforma Fiscal SAT - Linux
@2017 Lucas Viana e Fabio Sosa - BSP Página 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;
Custódia simples dos arquivos ou por Cloud (nuvem).
Manual da Plataforma Fiscal SAT - Linux
@2017 Lucas Viana e Fabio Sosa - BSP Página 5
2 - Instalação e Configuração
Manual da Plataforma Fiscal SAT - Linux
@2017 Lucas Viana e Fabio Sosa - BSP Página 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).
Manual da Plataforma Fiscal SAT - Linux
@2017 Lucas Viana e Fabio Sosa - BSP Página 7
3 - Instalação do software de ativação no Windows.
Manual da Plataforma Fiscal SAT - Linux
@2017 Lucas Viana e Fabio Sosa - BSP Página 8
Manual da Plataforma Fiscal SAT - Linux
@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 As informações de ativação do S@T é realizado nessa tela:
Manual da Plataforma Fiscal SAT - Linux
@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:
Após ativado, o próximo passo é a associação da assinatura:
Manual da Plataforma Fiscal SAT - Linux
@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:
Manual da Plataforma Fiscal SAT - Linux
@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
02 - CERTIFICADO - A3
Manual da Plataforma Fiscal SAT - Linux
@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/
Manual da Plataforma Fiscal SAT - Linux
@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;
Manual da Plataforma Fiscal SAT - Linux
@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'
Manual da Plataforma Fiscal SAT - Linux
@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
Manual da Plataforma Fiscal SAT - Linux
@2017 Lucas Viana e Fabio Sosa - BSP Página 17
Atualize o seu sistema
Comando: apt-get update
Manual da Plataforma Fiscal SAT - Linux
@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
Manual da Plataforma Fiscal SAT - Linux
@2017 Lucas Viana e Fabio Sosa - BSP Página 19
Após isso, realize o download das bibliotecas
Comando: wget http://bematechpartners.com.br/wp01/upload-
files/downloads/linux/sat/Middleware/libbemasat_1.0.20-debian6_i386.deb
Manual da Plataforma Fiscal SAT - Linux
@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
Manual da Plataforma Fiscal SAT - Linux
@2017 Lucas Viana e Fabio Sosa - BSP Página 21
Instale o pacote de bibliotecas.
Comando: dpkg -i libbemasat_1.0.20-debian6_i386.deb
Manual da Plataforma Fiscal SAT - Linux
@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
Comando: tar vzxf InstaladorBematechFiscalManager_3.0.1_LINUX.tar.gz
Manual da Plataforma Fiscal SAT - Linux
@2017 Lucas Viana e Fabio Sosa - BSP Página 23
Entre na pasta BematechFiscalSAT.
Comando: cd BematechFiscalSAT
Para iniciar a instalação execute o comando: ./instalador_fiscal_manager_sat.sh
Manual da Plataforma Fiscal SAT - Linux
@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?
Caso deseje instalar o Virtual ECF, clique na opção "1"
Manual da Plataforma Fiscal SAT - Linux
@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."
Em nosso exemplo, a figura abaixo mostra a instalação juntamente com o Virtual ECF.
Manual da Plataforma Fiscal SAT - Linux
@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
Manual da Plataforma Fiscal SAT - Linux
@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.
Clique com o botão direito em cima do ícone e vá em Painel de Controle.
Manual da Plataforma Fiscal SAT - Linux
@2017 Lucas Viana e Fabio Sosa - BSP Página 28
Aparecerá a tela inicial da configuração do Fiscal Manager.
Utilize o Login admin e a senha fmsat
Manual da Plataforma Fiscal SAT - Linux
@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."
Manual da Plataforma Fiscal SAT - Linux
@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.
Manual da Plataforma Fiscal SAT - Linux
@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
Clique em configurações e depois em Configurações do Virtual ECF
Manual da Plataforma Fiscal SAT - Linux
@2017 Lucas Viana e Fabio Sosa - BSP Página 32
"Se estiver configurando para homologação, utilize os dados do fabricante conforme
abaixo."
Manual da Plataforma Fiscal SAT - Linux
@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.
Comando: cd /
Manual da Plataforma Fiscal SAT - Linux
@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.
Agora vamos iniciar a instalação e configuração do Cliente Remoto.
Manual da Plataforma Fiscal SAT - Linux
@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.
Manual da Plataforma Fiscal SAT - Linux
@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
Para nohup java -jar /usr/lib/clienteSatRemoto/ClienteSATRemoto.jar &
Manual da Plataforma Fiscal SAT - Linux
@2017 Lucas Viana e Fabio Sosa - BSP Página 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 Remota.
Manual da Plataforma Fiscal SAT - Linux
@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.
Manual da Plataforma Fiscal SAT - Linux
@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 .
6 - Cenário de Teste
Manual da Plataforma Fiscal SAT - Linux
@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
1.0.0 Primeira Versão Lucas Viana e Fabio Sosa
Recommended