Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

Índice
minLevel2
indent10px
stylenone

...

02VISÃ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.

...

03. 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.

...

No gráfico abaixo apresentamos os componentes para integração através da API.

diagrama APIOne

...

04. 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.

...

05. 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.

...

05.01. 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.

...

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

...

06. 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.

...

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

...


07. 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.

...

07.

...

01. JAVA (JNA)

Bloco de código
languagejava
themeDJango
firstline1
titleDeclarando as funções em JAVA (JNA)
linenumberstrue
collapsetrue
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 ();
}

...

07.02. JAVA (JNI)

Bloco de código
languagejava
themeDJango
firstline1
titleDeclarando as funções em JAVA (JNI)
linenumberstrue
collapsetrue
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");
       }
}

...

07.03. C#

Bloco de código
languagec#
themeDJango
firstline1
titleDeclarando as funções em C#
linenumberstrue
collapsetrue
[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();

...

07.04. DELPHI

Bloco de código
languagedelphi
themeDJango
firstline1
titleDeclarando as Funções em Delphi
linenumberstrue
collapsetrue
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';


07.05. VB

Declarando as funções em Visual Basic.

...

.

...



...

8. Funções da biblioteca BemaOne.dll:

...