...
HTML |
---|
<!-- esconder o menu -->
<style>
div.theme-default .ia-splitter #main {
margin-left: 0px;
}
.ia-fixed-sidebar, .ia-splitter-left {
display: none;
}
#main {
padding-left: 10px;
padding-right: 10px;
overflow-x: hidden;
}
.aui-header-primary .aui-nav, .aui-page-panel {
margin-left: 0px !important;
}
.aui-header-primary .aui-nav {
margin-left: 0px !important;
}
</style>
|
A Plataforma Fiscal da Bematech, é composta por uma série de componentes que juntos permitem a integração de softwares de automação comercial para a emissão documentos NFC-e e CF-e.
15.1. Componentes da plataforma fiscal:
- Fiscal Manager NFC-e: É o núcleo da Plataforma Fiscal, sendo o responsável por gerar e assinar digitalmente os arquivos XML para emissão da NFC-e. Ele também gerencia a entrada e saída de contingência bem como também realizar a impressão da DANFE ao final do processo.
Existe também a versão SAT do Fiscal Manager, suas funcionalidades são
similares a versão NFC-e no entanto, o Fiscal Manager não transmite as notas para Sefaz mas sim para o hardware SAT que se encarregará do processo.
Além do Fiscal Manager a Plataforma Fiscal possui também um conjunto de componentes que oferece várias formas de integração com sua aplicação, dentre eles podemos citar:
- Virtual ECF + Biblioteca Bemafi32.dll: Componentes para integração através de modo compatibilidade (aplicações já integradas com ECF). Obs. Válido tanto para NFC-e quanto para SAT.
- BemaNFCe.dll: Biblioteca para integração direta com o Fiscal Manager possui funções específicas para comunicação com serviços NFC-e da Bematech de forma mais simplificada pois não trabalha com modo compatibilidade. Obs. Exclusivo para NFC-e.
- APIOne: Todas as funcionalidades do Fiscal Manager, disponíveis em uma API que elimina o uso de dlls e também do Virtual ECF para a integração.
Para utilizar a APIOne é importante que o Fiscal Manager esteja atualizado para a versão 02.00.00 Build 01.
Versões anteriores a 02.00.00 não contemplam as funcionalidades da APIOne.
15.2. Pré-Requisitos da Plataforma Fiscal
15.2.1. Certificado Digital:
Legalmente todos os documentos transmitidos eletronicamente ao Fisco devem ser assinados digitalmente, para tal, adotamos como padrão a utilização do certificado digital do tipo "e-CNPJ A1", abaixo listamos alguns benefícios deste tipo de certificado:
- Uso simultâneo em vários computadores;
- Dispensa o uso de um hardware adicional (Leitor USB) conectado ao computador;
- Praticidade de aquisição e confiabilidade de uso;
- Permite o uso simultâneo até mesmo entre filiais diferentes, mas com mesma raiz de CNPJ (8 primeiros dígitos são iguais), por exemplo:
- Filial 1: 82373077 000278
- Filial 2: 82373077 000389
Durante a homologação e testes da Plataforma Fiscal, é a Software House quem deve providenciar um certificado digital. Concluídos os testes, fica à cargo do Contribuinte (Cliente) providenciar o certificado uso em ambiente de Produção.
O formato do arquivo para importação deve obedecer o padrão PFX.
15.2.2. Código CSC (Token do Contribuinte):
O CSC é um código de segurança alfanumérico disponibilizado pelo Fisco e de conhecimento apenas do Contribuinte. Sua função é, em conjunto com o Certificado Digital, garantir a autoria dos arquivos gerados e enviados aos servidores da Secretaria da Fazenda (SEFAZ).
Algumas observações pertinentes:
- É indispensável que o contribuinte possua uma Inscrição Estadual válida para emissão de notas.
- O pedido do Código CSC é de responsabilidade do cliente junto a Sefaz do estado.
- A geração do "Código CSC" depende diretamente de um Certificado Digital válido para o CNPJ em questão.
- Uma vez adquiridos, os códigos serão válidos para todos os estabelecimentos do Contribuinte dentro do mesmo Estado.
Caso a Software House ou o contribuinte não possuam uma IE (Inscrição Estadual) válida na UF, a homologação não precisa ser interrompida e para fins de desenvolvimento pode-se utilizar o código CSC genérico da SEFAZ Amazonas!
Para mais informações acesse: http://portalnfce.sefaz.am.gov.br/desenvolvedor/ambiente-de-homologacao-para-desenvolvedores/
15.2.3. Download
VocêpodefazerodownloaddoFiscalManageratualizadoatravésdolink:
suporte.totvs.com.br
Disponibilizamos também, alguns exemplos de utilização do Fiscal Manager no link:
suporte.totvs.com.br
15.2.4. Licenciamento Pensando na praticidade das operações de rollout em seus clientes, a Plataforma Fiscal adotou o modelo de licenciamento online para os produtos de NFC-e e S@T, através do portal License Admin (LA). O LA consiste em um ambiente online onde o próprio desenvolvedor possui autonomia para inserir, ampliar ou reduzir a quantidade de licenças disponíveis da Plataforma Fiscal aos seus clientes. Acessando o Portal LA pelo link: http://la.bematech.com.br/, para se cadastrar acesse o link "Novo Cadastro". Após preencher os dados do formulário, e confirmar seu cadastro, será enviado um link de para o email registrado. Concluído o cadastro e a confirmação do mesmo ao acessar o License Admin será exibido o DashBoard inicial da aplicação que apresenta as informações relevantes as licenças dos clientes vinculados a sua Software House. Todo o passo a passo para o cadastro e gestão de licenças, está disponível no link "Help" disponível no menu superior do portal (imagem abaixo) e sempre que necessário, você pode contar com nosso time suporte técnico para sanar eventuais dúvidas e questionamentos.
Image Added
Figure 3. Portal License Admin.
15.2.5. Instalação da Plataforma Fiscal (Fiscal Manager) 15.2.5.1. NFC-e Ao iniciar a instalação a seguinte tela será apresentada:
Image Added Figure 4. Configurando a instalação do Fiscal Manager. Clicando no botão "Avançar", a próxima tela apresenta os termos de aceite de uso do Fiscal Manager:
Image Added Figure 5. Termos de uso. O próximo passo da instalação é definir o caminho onde o Fiscal Manager será instalado.
Image Added Figure 6. Path da instalação. Definido o path de instalação, clique em "Instalar" para que o processo seja iniciado.
Image Added Figure 7. Iniciar Instalação. Com o processo de instalação concluído o próximo passo é a configuração do Fiscal Manager, na próxima tela apresentada você deverá configurar a senha de acesso ao Painel de controle da aplicação.
| Anote a senha mestre exibida na tela pois é através dela em caso de perda da |
|
| senha cadastrada que você poderá acessar novamente o Painel de Controle. |
|
|
|
|
Também devem ser cadastrados o CNPJ e UF do contribuinte emissor de acordo com o que mostramos na tela abaixo:
Image Added Figure 8. Senha de Acesso e CNPJ. Na próxima tela você poderá configurar a forma de utilização do Fiscal Manager, Como o foco deste manual é o uso da APIOne, sua instalação não é necessária então desmarque esta opção e prossiga para os próximos passos da configuração.
Image Added Figure 9. Virtual ECF e Modo compatibilidade. O passo seguinte, é a importação do Certificado Digital, um dos pré-requisitos dos quais falamos anteriomente. Para isso, basta selecionar o arquivo ".pfx", do certificado inserir a senha e clicar em "Importar Certificado":
| Com o certificado importado com sucesso os dados do mesmo serão apresentados |
|
| na tela. |
|
|
|
|
Image Added Figure 10. Certificado Digital (e-CNPJ). Com a importação do cerficado digital concluída, o próximo passo é o cadastro do do Código CSC e o cadastro do ID do PDV onde Plataforma será instalada, conforme exibido na tela abaixo:
Image Added Figure 11. Cadastro de CSC e ID do PDV. É imprescindível que o ID do PDV seja inserido, pois ele tem papel fundamental no processo de Licenciamento Online da Plataforma Fiscal. Na próxima tela é possível aplicar configurações de proxy caso a rede tenha esta necessidade:
Image Added Figure 12. Configuração de Proxy. Logo em seguida é possível carregar o arquivo bitmap com a logotipo da empresa, respeitando as medidas (em pixels) de 256 x 136. Neste momento é possível também configurar a impressora que será utilizada para impressão das notas. No exemplo abaixo, estamos configurando uma MP-4200 TH, previamente instalada:
Image Added Figure 13. Configuração de Impressora e Logotipo. Logotipo da empresa: Deverá ser na extensão ".bmp" (imagem bitmap). Impressão de notas: A impressora deverá estar previamente instalada no ambiente, de acordo com as orientações do fabricante. Ela também deverá estar ligada no momento da instalação. Finalizadas as configurações o Fiscal Manager exibirá um resumo dos dados configurados e clicando em "Finalizar", a instalação será concluída conforme telas abaixo:
Image Added Figure 14. Resumo de configurações.
Image Added Figure 15. Conclusão do processo de instalação. 15.2.5.2. Instalação do Fiscal Manager SAT Ao iniciar a instalação a seguinte tela será apresentada:
Image Added Figure 16. Tela inicial. Clicando no botão "Avançar", a próxima tela indicará o modo de instalação do Fiscal Manager SAT.
| Para usar o método de integração através da API selecione a opção "Fiscal |
|
| Manager SAT- SINGLE" |
|
|
|
|
Image Added
Figure 17. Modo de instalação.
O próximo passo da instalação é definir o caminho onde o Fiscal Manager será instalado.
Image Added Figure 18. Path da instalação. Definido o path de instalação, clique em "Instalar" para que o processo seja iniciado antes será exibida uma tela apresentando um resumo da instalação.
Image Added Figure 19. Resumo dos itens a serem instalados. Ao término do processo o instalador irá exibir a tela de conclusão, e não sequência iniciar o Painel de Controle do Fiscal Manager.
Image Added Figure 20. Término da instalação. O painel de controle do Fiscal Manager SAT é carregado através do browser padrão configurado em seu sistema operacional, para abrir a aplicação utilize: Senha:fmsat Usuário:admin
Image Added Figure 21. Login e primeiro acesso. Ao acessar o painel de controle em sua tela inicial você poderá visualizar algumas informações do SAT, nas telas abaixo apresentamos um resumo das informações apresentadas: • Informações da Instância
Image Added Figure 22. Informações Gerais. Esta tela apresenta informações do contribuinte e também do Hardware do SAT.
Image Added Figure 23. Estatísticas. Aqui são exibidas informações relacionadas a operação diária do SAT. • Informações do Hardware SAT
Image Added Figure 24. Informações gerais do SAT. Neste Menu são exibidas informações relacionadas ao Status Operacional do SAT.
Image Added Figure 25. Informações de rede. Aqui são apresentadas informações relacionadas a parametrização e configuração de rede do SAT.
Image Added Figure 26. Informações de transmissão. Aqui são apresentadas informações relacionadas a parametrização e configuração de rede do SAT.
Image Added Figure 27. Informações de hardware. Neste Menu é possível visualizar informações relacionadas ao Hardware do SAT, tais como nível de bateria, versão e informações de memória. Através do Painel de controle também é possível visualizar a lista de notas emitidas, para tal no Menu Superior acesse o link "Operações". Na imagem abaixo apresentamos um exemplo da Janela de operações:
Image Added Figure 28. Operações (Listagem de notas). Ao acessar o menu configurações será possível também parametrizar o Fiscal Manager para operação com o SAT, nas telas abaixo apresentamos as opções de configuração disponíveis: • Configurações do Fiscal Manager SAT
Image Added Figure 29. Configurar dados do contribuinte (Básico). Nesta são configurados os dados do contribuinte como CNPJ, IE IM e portas do SAT e da impressora utilizada para impressão das notas.
Image Added Figure 30. Configurar dados do contribuinte (Avançado). Na área de configurações avançadas podem ser configurados proxy e porta de comunicação entre outras informações. Adicionalmente também é possível através da opção Importar/Exportar. Utilizar uma string JSON que possibilitará a execuçao de configurações de forma mais ágil quando por exemplo o estabelecimento possuir vários PDVS.
Image Added Figure 31. Importar/Exportar Configurações. Nos casos onde será utilizada a APIOne não é necessário executar configuraçõesdo Virtual ECF, já que tais dados passam a ser enviados diretamente através da API. Ainda sobre a área de configurações também é possível através dela a execução de backup do banco de dados e das notas em custódia, para tal basta seguir os passos apresentados abaixo:
Image Added Figure 32. Iniciar o Backup.
Image Added Figure 33. Mensagem de alerta de execução.
Image Added Figure 34. Definição de local para gravação do backup. 16. LEGISLAÇÃO Para maiores informações e detalhes sobre a legislação, tanto em relação a NFC-E quanto ao SAT, você consultar os links abaixo:
17. TERMOS E ABREVIAÇÕES- API: Acrônimo para "Application Programming Interface",ou em português Interface de Programação de Aplicativos. De modo resumido, trata-se de uma API é um conjunto de funções ou padrões de programação para acesso a um software ou aplicativo web.
- CSC: Código de Segurança do Contribuinte. Código gerado pela Sefaz para fins de identificação digital do contribuinte.
- CF-e: Cupom Fiscal Eletrônico, documento fiscal eletrônico utilizado no estado de São Paulo e vinculado ao SAT.
- DANFE: Documento auxiliar da Nota Fiscal Eletrônica, representação gráfica da NF-e ou NFC-e.
- ECF: Emissor de cupom fiscal, ou Impressora Fiscal.
- JSON: Formato para troca de informações e dados entre aplicações, sendo similar ao XML, porém mais leveutilizado para troca de informações entre "Cliente <> Servidor".
- NFC-e: Nota Fiscal ao Consumidor Eletrônica.
- NF-e: Nota Fiscal Eletrônica.
- SAT: Conjunto de hardware e software embarcado, usado na autenticação e transmissão do Cupom Fiscal Eletrônico para a Sefaz.
- SEFAZ: Abreviação para Secretaria da Fazenda.
18. CONTATO E SUPORTE TÉCNICO
Nossa equipe está disponível para lhe apoiar! Para entrar em contato conosco, utilize um dos canais abaixo:
HTML |
---|
<!-- esconder o menu -->
<style>
div.theme-default .ia-splitter #main {
margin-left: 0px;
}
.ia-fixed-sidebar, .ia-splitter-left {
display: none;
}
#main {
padding-left: 10px;
padding-right: 10px;
overflow-x: hidden;
}
.aui-header-primary .aui-nav, .aui-page-panel {
margin-left: 0px !important;
}
.aui-header-primary .aui-nav {
margin-left: 0px !important;
}
</style> |