...
Índice minLevel 2 indent 10px style none
...
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.
...
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.
...
No gráfico abaixo apresentamos os componentes para integração através da API.
...
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.
...
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.
...
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.
...
Uma vez que o Fiscal Manager esteja instalado e configurado corretamente, as rotinas de integração podem ser iniciadas.
...
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.
...
Para baixar a biblioteca BemaOne.dll acesse nosso Portal: https://suporte.totvs.com/portal/p/10098/download?e=812690
...
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. |
...
...
Bloco de código | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||
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 (); } |
...
Bloco de código | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||
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"); } } |
...
Bloco de código | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||
[DllImport("BemaOne32.dll")] public static extern string Bematech_Fiscal_AbrirNota(string dados); [DllImport("BemaOne32.dll")] public static extern string Bematech_Fiscal_EstornarNota(); [DllImport("BemaOne32.dll")] public static extern string Bematech_Fiscal_FecharNota(string dados); [DllImport("BemaOne32.dll")] public static extern string Bematech_Fiscal_VenderItem(string dados); [DllImport("BemaOne32.dll")] public static extern string Bematech_Fiscal_EstornarVendaItem(string dados); [DllImport("BemaOne32.dll")] public static extern string Bematech_Fiscal_EfetuarPagamento(string dados); [DllImport("BemaOne32.dll")] public static extern string Bematech_Fiscal_EstornarPagamento(string dados); [DllImport("BemaOne32.dll")] public static extern string Bematech_Fiscal_ListarNotas(string dados); [DllImport("BemaOne32.dll")] public static extern string Bematech_Fiscal_InutilizarNumeracao(string dados); [DllImport("BemaOne32.dll")] public static extern string Bematech_Fiscal_ConsultarNota(string dados); [DllImport("BemaOne32.dll")] public static extern string Bematech_Fiscal_EnviarNotaEmail(string dados); [DllImport("BemaOne32.dll")] public static extern string Bematech_Fiscal_CancelarNota(string dados); [DllImport("BemaOne32.dll")] public static extern string Bematech_Fiscal_ObterStatusImpressora(); [DllImport("BemaOne32.dll")] public static extern string Bematech_Fiscal_ImprimirTextoLivre(string dados); [DllImport("BemaOne32.dll")] public static extern string Bematech_Fiscal_ImprimirDocumentoFiscal(string dados); [DllImport("BemaOne32.dll")] public static extern string Bematech_Fiscal_AcionarGaveta(string dados); [DllImport("BemaOne32.dll")] public static extern string Bematech_Fiscal_ObterInformacoesSistema(); [DllImport("BemaOne32.dll")] public static extern string Bematech_Fiscal_ListarConfiguracoes(); [DllImport("BemaOne32.dll")] public static extern string Bematech_Fiscal_EfetuarConfiguracoes(string dados); [DllImport("BemaOne32.dll")] public static extern string Bematech_Fiscal_ObterInformacoesContingencia(); [DllImport("BemaOne32.dll")] public static extern string Bematech_Fiscal_TrocarEstadoContingencia(); |
...
Bloco de código | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||
function Bematech_Fiscal_AbrirNota (dados:String) : PChar ; stdcall; External 'BemaOne32.dll'; function Bematech_Fiscal_EstornarNota () : PChar ; stdcall; External 'BemaOne32.dll'; function Bematech_Fiscal_FecharNota (dados:String) : PChar ; stdcall; External 'BemaOne32.dll'; function Bematech_Fiscal_VenderItem (dados:String) : PChar ; stdcall; External 'BemaOne32.dll'; function Bematech_Fiscal_EstornarVendaItem (dados:String) : PChar ; stdcall; External 'BemaOne32.dll'; function Bematech_Fiscal_EfetuarPagamento (dados:String) : PChar ; stdcall; External 'BemaOne32.dll'; function Bematech_Fiscal_EstornarPagamento (dados:String) : PChar ; stdcall; External 'BemaOne32.dll'; function Bematech_Fiscal_ListarNotas (dados:String) : PChar ; stdcall; External 'BemaOne32.dll'; function Bematech_Fiscal_InutilizarNumeracao (dados:String) : PChar ; stdcall; External 'BemaOne32.dll'; function Bematech_Fiscal_ConsultarNota (dados:String) : PChar ; stdcall; External 'BemaOne32.dll'; function Bematech_Fiscal_EnviarNotaEmail (dados:String) : PChar ; stdcall; External 'BemaOne32.dll'; function Bematech_Fiscal_CancelarNota (dados:String) : PChar ; stdcall; External 'BemaOne32.dll'; function Bematech_Fiscal_ObterStatusImpressora () : PChar ; stdcall; External 'BemaOne32.dll'; function Bematech_Fiscal_ImprimirTextoLivre (dados:String) : PChar ; stdcall; External 'BemaOne32.dll'; function Bematech_Fiscal_ImprimirDocumentoFiscal (dados:String) : PChar ; stdcall; External 'BemaOne32.dll'; function Bematech_Fiscal_AcionarGaveta (dados:String) : PChar ; stdcall; External 'BemaOne32.dll'; function Bematech_Fiscal_ObterInformacoesSistema () : PChar ; stdcall; External 'BemaOne32.dll'; function Bematech_Fiscal_ListarConfiguracoes () : PChar ; stdcall; External 'BemaOne32.dll'; function Bematech_Fiscal_EfetuarConfiguracoes (dados:String) : PChar ; stdcall; External 'BemaOne32.dll'; function Bematech_Fiscal_ObterInformacoesContingencia () : PChar ; stdcall; External 'BemaOne32.dll'; function Bematech_Fiscal_TrocarEstadoContingencia () : PChar ; stdcall; External 'BemaOne32.dll'; |
Declarando as funções em Visual Basic.
...
.
...
...
...