Histórico da Página

...

Visão Geral
Como realizar a integração com APIOne
Vantagens de se utilizar a APIOne
Usando a APIOne
1. Integração da Plataforma Fiscal usando a BemaAPIOne + BemaOne.dll
O que é a BemaOne.dll
Declaração das funções da BemaOne.dll
1. JAVA (JNA)
2. JAVA (JNI)
3. C#
Funções da biblioteca BemaOne.dll:
1. Bematech_Fiscal_AbrirNota
2. Bematech_Fiscal_EstornarNota
3. Bematech_Fiscal_FecharNota
4. Bematech_Fiscal_VenderItem
5. Bematech_Fiscal_EstornarVendaItem
6. Bematech_Fiscal_EfetuarPagamento
7. Bematech_Fiscal_EstornarPagamento
8. Bematech_Fiscal_ListarNotas
9. Bematech_Fiscal_InutilizarNumeracao
10. Bematech_Fiscal_ConsultarNota
11. Bematech_Fiscal_EnviarNotaEmail
12. Bematech_Fiscal_CancelarNota
13. Bematech_Fiscal_ObterStatusImpressora
14. Bematech_Fiscal_ImprimirTextoLivre
15. Bematech_Fiscal_ImprimirDocumentoFiscal
16. Bematech_Fiscal_AcionarGaveta
17. Bematech_Fiscal_ObterInformacoesSistema
18. Bematech_Fiscal_ListarConfiguracoes
19. Bematech_EfetuarConfiguracoes
20. Bematech_Fiscal_ObterInformacoesContingencia
21. Bematech_Fiscal_TrocaEstadoContingencia
Fluxos de operação usando a BemaOne.dll + APIOne.
1. Venda Simples.
2. Obter informações do Sistema.
Usando Serviços RestFul
1. O que são Serviços RestFul?
2. Entendendo o Funcionamento
3. Lista de Serviços RestFul
Recursos da API
1. Abrir Cupom
2. Adicionar Item de venda
3. Estornar Item de venda
4. Adicionar Pagamento
5. Estornar Pagamento
6. Fechar Cupom
7. Estornar Cupom
8. Listar Documentos
9. Listar Documentos (Paginada)
10. Buscar documento por ID
11. Cancelar um documento
12. Enviar documento por email (ID)
13. Buscar documento através de série/número
14. Enviar documento por email (série/número)
15. Consultar status de uma impressora Bematech
16. Impressão de documento genérico
17. Impressão de DANFE (Chave de acesso)
18. Impressão de DANFE (Série/Número)
19. Realizar abertura de gaveta
20. Informações sobre o sistema
21. Listagem de configurações do sistema
22. Realizar alteração de configurações do Fiscal Manager
23. Localizar configuração específica do Fiscal Manager
24. Obter informações sobre contingência
25. Alterar o modo de contingência
Exemplos JSON NFC-E
1. Método: GET (Fiscal Manager NFC-E e SAT)
2. Método: POST (Utilizando Fiscal Manager NFC-e)
3. Método: DELETE (Utilizando Fiscal Manager NFC-E)
Exemplos JSON SAT
1. Método: GET (Fiscal Manager NFC-E e SAT)
2. Método: POST (Utilizando Fiscal Manager SAT)
3. Método: POST (Utilizando Fiscal Manager SAT)
4. Método: DELETE (Utilizando Fiscal Manager SAT)
Fluxos de operação usando a integração direta através da APIOne.
1. Venda Simples.
2. Obter informações do Sistema.
Plataforma Fiscal Bematech.
1. Componentes da plataforma fiscal:
2. Pré-Requisitos da Plataforma Fiscal
LEGISLAÇÃO
TERMOS E ABREVIAÇÕES
CONTATO E SUPORTE TÉCNICO

01. VISÃO GERAL

A APIOne é ferramenta que integra a Plataforma Fiscal com a sua aplicação de automação comercial. Nossa API conta com um amplo conjunto de funções que permite a emissão de documentos fiscais (NFC-e e CF-e). Trabalhando com a tecnologia JSON, a integração de sua aplicação com a nossa plataforma fiscal agora pode ser executada de maneira direta, sem a necessidade de uso de middleware para interface com o Fiscal Manager. Ao utilizar a API você terá mais controle sobre o processo de emissão de notas, trazendo benefícios para a gestão de informações dentro da aplicação.

02. COMO REALIZAR A INTEGRAÇÃO COM APIONE

Por ser uma ferramenta versátil, você pode usar a API de forma direta, consumindo os recursos disponibilizados por ela, ou ainda se preferir você também pode usar a API através da BemaOne.dll, esta, por sua vez, atuará diretamente como uma interface entre o seu software e a Plataforma Fiscal a API.

...

03. VANTAGENS DE SE UTILIZAR A APIONE

Flexibilidade: Você pode usar a APIOne de forma nativa, consumindo os serviços REST para integração da Plataforma Fiscal com sua automação comercial. Mas se preferir também é possível utilizar a BemaOne.dll que através de um conjunto de funções também consumirá os serviços da APIOne. Utilizando os serviços REST ou a BemaOne.dll abrimos um leque de possibilidades para que o processo de desenvolvimento e integração atenda as principais necessidades do mercado de Software.
Integração MultiPlataforma: Uma única ferramenta, várias plataformas! A APIOne por permitir a integração nativa através de serviços RestFul, você poderá atender novas demandas do mercado de maneira rápida.
Várias legislações uma única ferramenta: Através da API você pode de maneira unificada emitir NFC-e e CF-e permitindo que a administração e atualização de componentes dentro do software ocorra de forma simplificada.
Maior controle para aplicação: Sua aplicação passa a ter maior controle sobre o processo de emissão de notas. Este controle ocorre desde a gestão da numeração de notas, data e hora de emissão até a gestão de tributos necessários nas operações de venda, bem como rotinas de cálculo de acréscimo e desconto.
Facilidade e agilidade na integração : A APIOne utiliza a tecnologia JSON, facilitando o envio e recebimento de comandos e reduzindo o tempo gasto no processo de integração.

04. USANDO APIONE

Agora que já apresentamos a você as vantagens e a arquitetura da nova API, vamos ver em detalhes como iniciar a integração da Plataforma Fiscal através da APIOne.

04. A INTEGRAÇÃO DA PLATAFORMA FISCAL USANDO APIONE + BEMAONE.DLL

Neste método de integração a dll torna-se uma camada intermediária entre a sua aplicação e o Fiscal Manager e a API.

Nota
Antes de iniciar a integração lembre-se, o Fiscal Manager deve estar instalado e configurado corretamente!

Dica
Para informações sobre o processo de instalação do Fiscal Manager, consulte:Pré-Requisitos da Plataforma Fiscal+Instalação da Plataforma Fiscal (Fiscal Manager)

Uma vez que o Fiscal Manager esteja instalado e configurado corretamente, as rotinas de integração podem ser iniciadas.

05. O QUE É A BEMAONE.DLL

A BemaOne.dll é um middleware intermediário que através de suas funções fará a integração entre a sua aplicação e o Fiscal Manager. Neste modelo de integração é a dll (através de seu conjunto de funções) quem consome os serviços disponibilizados na API.

Dica
O Fiscal Manager ao ser executado "sobe" também todas os serviços da API.

Vale lembrar que essa biblioteca foi desenvolvida utilizando um padrão de comunicação já conhecido no mercado de automação comercial, de forma que a sua utilização assemelha-se bastante a outras soluções já conhecidas do mercado como a Bemafi32.dll a BemaNFC-e.dll, porém com o diferencial que é a integração direta com a API.

Para baixar a biblioteca BemaOne.dll acesse nosso Portal: https://suporte.totvs.com/portal/p/10098/download?e=812690

06. DECLARAÇÃO DAS FUNÇÕES DA BEMAONE.DLL

Antes de conhecermos em detalhes as funções da biblioteca, listamos a declaração das funções da dll em alguns exemplos de linguagens, como Delphi, Java e etc.

Aviso
A BemaOne.dll está diretamente vinculada a APIOne portanto, o Fiscal Manager (NFC-e ou SAT) deve estar atualizado para o correto funcionamento da Plataforma Fiscal.

06A. JAVA (JNA)

Bloco de código

language	java
theme	DJango
firstline	1
title	Declarando as funções em JAVA (JNA)
linenumbers	true
collapse	true

package nome_do_pacote;
 import com.sun.jna.Library;
 import com.sun.jna.Native;
 import com.sun.jna.ptr.PointerByReference;
 
 public interface Bematech extends Library {
 
       public Bematech instance = (Bematech) Native.loadLibrary("BemaOne32.dll", Bematech.class);
       public String Bematech_Fiscal_AbrirNota (String dados);
       public String Bematech_Fiscal_EstornarNota ();
       public String Bematech_Fiscal_FecharNota (String dados);
       public String Bematech_Fiscal_VenderItem (String dados);
       public String Bematech_Fiscal_EstornarVendaItem (String dados);
       public String Bematech_Fiscal_EfetuarPagamento (String dados);
       public String Bematech_Fiscal_EstornarPagamento (String dados);
       public String Bematech_Fiscal_ListarNotas (String dados);
       public String Bematech_Fiscal_InutilizarNumeracao (String dados);
       public String Bematech_Fiscal_ConsultarNota (String dados);
       public String Bematech_Fiscal_EnviarNotaEmail (String dados);
       public String Bematech_Fiscal_CancelarNota (String dados);
       public String Bematech_Fiscal_ObterStatusImpressora ();
       public String Bematech_Fiscal_ImprimirTextoLivre (String dados);
       public String Bematech_Fiscal_ImprimirDocumentoFiscal (String dados);
       public String Bematech_Fiscal_AcionarGaveta (String dados);
       public String Bematech_Fiscal_ObterInformacoesSistema ();
       public String Bematech_Fiscal_ListarConfiguracoes ();
       public String Bematech_Fiscal_EfetuarConfiguracoes (String dados);
       public String Bematech_Fiscal_ObterInformacoesContingencia ();
       public String Bematech_Fiscal_TrocarEstadoContingencia ();
}

06B JAVA (JNI)

Bloco de código

language	java
theme	DJango
firstline	1
title	Declarando as funções em JAVA (JNI)
linenumbers	true
collapse	true

package nome_do_pacote;

public class Bematech {

       public static native int AlteraSimboloMoeda(String simboloMoeda);
       public static native String Bematech_Fiscal_AbrirNota (String dados);
       public static native String Bematech_Fiscal_EstornarNota ();
       public static native String Bematech_Fiscal_FecharNota (String dados);
       public static native String Bematech_Fiscal_VenderItem (String dados);
       public static native String Bematech_Fiscal_EstornarVendaItem (String dados);
       public static native String Bematech_Fiscal_EfetuarPagamento (String dados);
       public static native String Bematech_Fiscal_EstornarPagamento (String dados);
       public static native String Bematech_Fiscal_ListarNotas (String dados);
       public static native String Bematech_Fiscal_InutilizarNumeracao (String dados);
       public static native String Bematech_Fiscal_ConsultarNota (String dados);
       public static native String Bematech_Fiscal_EnviarNotaEmail (String dados);
       public static native String Bematech_Fiscal_CancelarNota (String dados);
       public static native String Bematech_Fiscal_ObterStatusImpressora ();
       public static native String Bematech_Fiscal_ImprimirTextoLivre (String dados);
       public static native String Bematech_Fiscal_ImprimirDocumentoFiscal (String dados);
       public static native String Bematech_Fiscal_AcionarGaveta (String dados);
       public static native String Bematech_Fiscal_ObterInformacoesSistema ();
       public static native String Bematech_Fiscal_ListarConfiguracoes ();
       public static native String Bematech_Fiscal_EfetuarConfiguracoes (String dados);
       public static native String Bematech_Fiscal_ObterInformacoesContingencia ();
       public static native String Bematech_Fiscal_TrocarEstadoContingencia ();

static

{
               String OSName = System.getProperty("os.name");
               OSName = OSName.toLowerCase();
                       System.loadLibrary("BemaOne32");
       }
}

12. EXEMPLO DE UTILIZAÇÃO

...

Árvore de páginas

Versões comparadas

Versão antiga 1

Nova versão 2

Chave