...
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.
...
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.
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.
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
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");
}
} |
...