HelpAndManual_unregistered_evaluation_copy Manual da Plataforma Fiscal SAT BSP - Bematech Software Partners Manual da Plataforma Fiscal SAT - versão 1.0.0
HelpAndManual_unregistered_evaluation_copy Manual da Plataforma Fiscal SAT por Júlio César Bruno - BSP - Bematech Software Partners Esse é o Manual da Plataforma Fiscal SAT, desenvolvido por 2015 Júlio César Bruno - BSP - Bematech Software Partners - 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". outubro de 2015
Contents 1 Índice do Conteúdo Prefácio 0 2 Parte I Bem-vindo 1 Conhecendo a... Plataforma 2 3 Parte II Instalação e Configuração 1 RB-1000 FI... 3 Recebendo o RB... 1000 FI Ativando o RB... 1000 FI 3 7 2 Configuração... do Fiscal Manager 12 Instalação da... Plataforma Configurações... do Fiscal Manager SAT Configurações... do VECF Licenciamento... Tela de Operações... Parte III Fiscal Manager 12 20 25 28 29 30 1 Versões do Fiscal... Manager 31 Módulos de instalação... Versão SINGLE... Versão CLIENTE... Versão CONCENTRADOR... 32 35 35 37 Parte IV Tela de Informações do SAT 39 Parte V Usuário de Acesso ao Painel de Controle 42 Parte VI Backup 44 1
2 1 Manual da Plataforma Fiscal SAT Bem-vindo Obrigado por utilizar nossa Plataforma Fiscal SAT. Tenha certeza que esse produto foi desenvolvido para facilitar o desenvolvimento da sua aplicação para 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). Representação do funcionamento da Plataforma Fiscal atuando em modo de compatibilidade com a BemaFI32. dll
Instalação e Configuração 2 Instalação e Configuração 2.1 RB-1000 FI 2.1.1 Recebendo o RB 1000 FI 3 Ao adquirir seu equipamento RB 1000 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:
4 Manual da Plataforma Fiscal SAT Após isso, instale o Software de Ativação, que pode ser baixado no link: http://www.bematech.com.br/equipamento/rb-1000-fi Instalando o Software de Ativação: Iniciando a instalação
Instalação e Configuração 5 Instalando o Driver do RB 1000 Ao abrir o Software de ativação, verifique se será necessário configurar para sua rede, pois o SAT vem configurado como DHCP por padrão.
6 Manual da Plataforma Fiscal SAT Configuração de rede para ip fixo.
Instalação e Configuração 7 Opções de configuração do proxy. Configurado a rede, é 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 2.1.2 Ativando o RB 1000 FI A ativação do S@T é realizado nessa tela:
8 Manual da Plataforma Fiscal SAT Tela de ativação. 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: CNPJ softwarehouse: 16716114000172 CNPJ contribuinte: 82373077000171 Assinatura: SGR-SAT SISTEMA DE GESTAO E RETAGUARDA DO SAT Após ativado, o próximo passo é a associação da assinatura:
Instalação e Configuração 9 Tela de Associação de Assinatura, com os dados para homologação. 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. Temos uma ferramenta para fazer esse procedimento e facilitar a criação da assinatura, no link http://arquivospartners.bematech.com.br/suporte/temp/ S@T_SecNumber.zip. Para gerar a assinatura, coloque em um arquivo texto o CNPJ da software house e o do contribuinte concatenados, como na imagem: Após isso, abra o S@T_SecNumber e escolha o arquivo que acabou de criar:
10 Manual da Plataforma Fiscal SAT Veja que na opção "Certificado" o software já está indicando o certificado digital instalado no Windows. Feito isso, clique em "Assinar" e utilize o Hash da opção "Base 64":
Instalação e Configuração Coloque essa assinatura no momento da associação: 11
12 Manual da Plataforma Fiscal SAT Clique em "Associar" e aguarde a mensagem de "associado com sucesso". Pronto, seu SAT está ativo e pronto para o uso! 2.2 Configuração do Fiscal Manager 2.2.1 Instalação da Plataforma Instalando a Plataforma Fiscal SAT:
Instalação e Configuração 13 Após executado o instalador, clique em "Avançar". Nessa tela, selecione se deseja instalar a versão Single, Cliente ou Concentrador. Para entender cada uma das opções, vá na seção Versões do Fiscal Manager 32.
14 Manual da Plataforma Fiscal SAT Escolha a porta COM que será utilizada pelo seu aplicativo, lembrando que é essa que deve ser inserida no item "Porta" do BemaFI32.ini! BemaFI32.ini
Instalação e Configuração Gerenciador de Dispositivos 15
16 Manual da Plataforma Fiscal SAT Continue a instalação clicando em "Avançar"; Escolha se deseja que seja criado o ícone na área de trabalho; Se desejar pode conferir os dados da instalação, daí clique em "Instalar";
Instalação e Configuração 17 Aguarde a instalação... ***Caso você já tenha instalado a Plataforma Fiscal NFC-e no seu computador, essa mensagem aparecerá na instalação das portas COM, pois foi detectado que já existe um VECF instalado... você pode ignorar essa informaçaõ e clique em "Continuar";
18 Manual da Plataforma Fiscal SAT Caso o sistema solicite permissão para que o Firewall não bloqueie o Java, clique em "Permitir"; Clique em "Concluir" para finalizar a instalação.
Instalação e Configuração 19 Após a instalação, a tela de configuração do Fiscal Manager SAT 20 irá abrir. Lembrando que devem ser utilizado navegadores atuais, como o Chrome ou Firefox. Logo na tela inicial, é solicitado que entre com um login e senha. O padrão é login admin e a senha fmsat. Será apresentado um tutorial explicando o passo-a-passo, caso não queira, clique no.
20 2.2.2 Manual da Plataforma Fiscal SAT Configurações do Fiscal Manager SAT Após instalado, ele abrirá a tela inicial, com as informações e estatísticas do SAT. Clique na opção Configurações > Configurações do Fiscal Manager SAT e preencha de acordo com as informações abaixo:
Instalação e Configuração 21 CNPJ do contribuinte: Inserir o CNPJ do cliente, lembrando que não deve ser utilizado pontos ou barra! No caso de ambiente de homologação, colocar o valor 82373077000171. Custódia Remota: aqui você irá definir se deseja utilizar o armazenamento em nuvem, o Fiscal Cloud (disponível no Fiscal Manager PRO). Identificação do PDV: defina como quer identificar o PDV, para diferenciá-lo na rede. Imprimir Logotipo: caso tenha e queira a impressão no extrato CF-e. Caminho do arquivo do logotipo: Caminho da imagem a ser utilizada para impressão do logotipo no extrato CF-e. Código de ativação do SAT: Colocar o código utilizado para a ativação do SAT, conforme imagem abaixo:
22 Manual da Plataforma Fiscal SAT Porta Serial do SAT: Porta em que está instalado o RB-1000 FI no gerenciador de dispositivos: URI da Impressora: Nesse ponto deve ser indicado a impressora que será utilizada, sendo: Impressoras térmicas Bematech MP-4200 TH e MP-2500 TH: serial://com20 (porta COM onde está instalada) Impressoras comuns (deskjet, laser, PDF, outras térmicas): spooler://nome_da_impressora
Instalação e Configuração Ex: Impressora PDF: spooler://pdfcreator Impressora IP (via interface ethernet): tcp://ip_da_impressora:9100 Ex: tcp://192.168.10.51:9100 Na aba Avançado tem as opções: Porta TCP da API: altera a porta de execução TCP do Fiscal Manager. Custodiar Documento Fiscal: aqui pode-se escolher se deseja ou não custodiar os 23
24 Manual da Plataforma Fiscal SAT XML's das cupons emitidos. Imprime Extrato: define se quer imprimir o extrato do CF-e ou não. Validação dos dados de venda: aqui é possível escolher se quer que o Fiscal Manager faça a validação dos dados da venda, para prevenção de erros. Na aba Importar/Exportar você poderá fazer backup das configurações, para importar em outras instalações: Caso queira exportar as configurações, clique em "Exportar" e copie o conteúdo do campo de texto e crie um arquivo de bloco de notas com esses valores:
Instalação e Configuração 25 Para importar, faça o processo inverso: pegue o conteúdo salvo no bloco de notas e cole no campo de texto da aba Importar/Exportar do painel de controle do Fiscal Manager e clique no botão "Importar". 2.2.3 Configurações do VECF Na aba Configurações do VECF IE, IM, CRT, Sigla da UF, código da UF (Clique aqui para consultar), Razão Social, Nome Fantasia, Logradouro (rua), Número, Bairro, Código Município (Clique aqui para consultar), Nome do Município, CEP, Telefone: Dados do cliente. Porta Serial do VECF: Porta utilizada pelo VECF. NCM Padrão, Código da Origem do produto, CFOP: Parâmetros utilizados caso não sejam informados na venda, ou seja, sem utilizar a função VendeItemCompleto. Você pode colocar os seguintes valores: NCM Padrão: 62000000 Código da Origem do produto: 0 CFOP: 5101
26 Manual da Plataforma Fiscal SAT Na aba Avançado, escolha as opções: Level Log do VECF: determina o nível do log do VECF, sendo: 0 1 2 3 - Sem log; Nível mínimo de informação; Nível médio de informação; Nível máximo, com retorno da impressora, os comandos enviados e o xml. Gravar Espelho da MFD: habilitando essa opção, o Fiscal Manager irá criar um espelho da venda no formato texto e gravará na pasta C:\BematechFiscal\SAT\VirtualEcf.
Instalação e Configuração 27
28 Manual da Plataforma Fiscal SAT Arquivo de espelho criado Path para arquivos temporários: local onde são direcionados os arquivos temporários do VECF. Não é necessário alterá-lo. Timeout dos WebServices: define o tempo de espera de envio aos Webservices. Na aba Importar/Exportar segue o mesmo procedimento citado no capítulo Configurações do Fiscal Manager SAT 20. 2.2.4 Licenciamento Após as configurações, está na hora de licenciar o Fiscal Manager. Quando se grava as alterações, ele automaticamente criará um arquivo com o nome solution-info.txt na pasta C:\BematechFiscal\SAT, conforme a imagem abaixo: De posse desse arquivo, você deverá acessar o Sistema de Licenciamento do Fiscal Manager pelo link: http://ecfhelp.com.br/fml Para cadastrar-se no sistema, baixe o tutorial pelo link: http://arquivospartners. bematech.com.br/suporte/temp/fiscal Manager License Partner.pdf Após gerar a licença no sistema, coloque o arquivo settings.bin na mesma pasta do
Instalação e Configuração 29 solution-info.txt: Feito isso, o Fiscal Manager irá constar automaticamente como licenciado: 2.2.5 Tela de Operações Nessa tela pode-se visualizar as vendas realizadas, com detalhes sobre a venda, opções de visualização do CF-e e reimpressão e pesquisa por data.
30 3 Manual da Plataforma Fiscal SAT Fiscal Manager
Fiscal Manager 3.1 31 Versões do Fiscal Manager O Fiscal Manager é responsável por receber os comandos do VirtualECF e montar o XML, enviando para o SAT. Após a validação, recebe o XML do CF-e já assinado e com a chave de acesso. Em seguida, monta e envia o extrato do CF-e para ser impresso.
32 3.1.1 Manual da Plataforma Fiscal SAT Módulos de instalação Fiscal Manager Single O Single é um módulo All-In-One, que pode ser utilizado como um PDV e Concentrador ao mesmo tempo.
Fiscal Manager Fiscal Manager Cliente O módulo cliente serve para o PDV que não tem SAT e precisa enviar para um Concentrador, que pode ser o Single. 33
34 Manual da Plataforma Fiscal SAT Fiscal Manager Concentrador Com esse módulo é possível montar um servidor que pode receber as vendas de outros Pontos, mas não tem a opção de realizar vendas.
Fiscal Manager 3.1.2 35 Versão SINGLE Nessa versão, você pode utilizá-lo tanto para fazer vendas com o SAT como para concentrador. Para isso, instale conforme o capítulo Instalação da Plataforma 12. 3.1.3 Versão CLIENTE A versão CLIENTE será instalado no PDV que não possui SAT, mas irá enviar para o concentrador ou PDV Single. DEve-se definir no momento da instalação o módulo cliente, nesse ponto da instalação: Após a instalação, você deverá configurar o Fiscal Manager e o VECF, após isso basta clicar no botão Localizar Concentrador e ele mostrará o concentrador na rede:
36 Manual da Plataforma Fiscal SAT Caso tenha mais de um concentrador na rede, será mostrado uma tela para que você possa escolher para qual SAT quer direcionar:
Fiscal Manager 3.1.4 37 Versão CONCENTRADOR Essa versão define um computador como servidor do SAT, concentrando todas as notas das máquinas clientes. No momento da instalação, escolha a opção Fiscal Manager SAT - Concentrador:
38 Manual da Plataforma Fiscal SAT Siga com a instalação até o final. Após isso, será necessário licenciar o produto 28. CNPJ do contribuinte: Inserir o CNPJ do cliente, lembrando que não deve ser utilizado pontos ou barra!. No caso de ambiente de homologação, colocar o valor 82373077000171. Custódia Remota: aqui você irá definir se deseja utilizar o armazenamento em nuvem, o Fiscal Cloud (disponível no Fiscal Manager PRO). Identificação do Concentrador: Aqui você define como quer identificá-lo. Código de ativação do SAT: Colocar o código utilizado para a ativação do SAT.
Fiscal Manager 39 Porta Serial do SAT: Nesse ponto deve ser indicado a porta em que está instalado o SAT no gerenciador de dispositivos, conforme abaixo: No concentrador, é possível visualizar as vendas realizadas nas máquinas clientes: 4 Tela de Informações do SAT Na tela inicial do painel de controle, estão as informações da Instância e do SAT.
40 Manual da Plataforma Fiscal SAT
Tela de Informações do SAT 41
42 Manual da Plataforma Fiscal SAT E nas Informações da Instância, temos as estatísticas de uso do Fiscal Manager: 5 Usuário de Acesso ao Painel de Controle Para acessar o Painel de controle do Fiscal Manager, é necessário entrar com o login e senha de usuário. Por padrão, virá configurado com o login admin e a senha fmsat.
Usuário de Acesso ao Painel de Controle Para alterar a senha, acesse no painel de controle a opção abaixo: 43
44 6 Manual da Plataforma Fiscal SAT Backup É possível fazer o Backup do Banco de dados do VECF (usuários avançados) e das notas em custódia. Backup do Banco de Dados: Nessa opção serão salvos todos os arquivos do VECF, que poderão ser substituídos em uma nova instalação, preservando as configurações.
Backup 45 Backup das Notas em Custódia: salva um arquivo com todos os arquivos xml e pdf das vendas:
46 Manual da Plataforma Fiscal SAT