Plataforma Fiscal Varejo
Índice
1. Integrando a Plataforma Fiscal através da APIOne. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
2. O que é a a APIOne? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
3. Como utilizá-la para Integração? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
4. Vantagens ao utilizar a APIOne? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
5. Usando a APIOne . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
5.1. Integração da Plataforma Fiscal usando a BemaAPIOne + BemaOne.dll . . . . . . . . . . . . . . . . . . . . 3
6. O que é a BemaOne.dll . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
7. Declaração das funções da BemaOne.dll . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
7.1.JAVA(JNA) ........................................................................... 5
7.2.JAVA(JNI) ............................................................................ 5
7.3.C# ................................................................................... 6
8. Funções da biblioteca BemaOne.dll: . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
8.1. Bematech_Fiscal_AbrirNota . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
8.2. Bematech_Fiscal_EstornarNota . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
8.3. Bematech_Fiscal_FecharNota . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
8.4. Bematech_Fiscal_VenderItem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
8.5. Bematech_Fiscal_EstornarVendaItem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
8.6. Bematech_Fiscal_EfetuarPagamento. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
8.7. Bematech_Fiscal_EstornarPagamento . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
8.8. Bematech_Fiscal_ListarNotas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
8.9. Bematech_Fiscal_InutilizarNumeracao . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
8.10. Bematech_Fiscal_ConsultarNota . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
8.11. Bematech_Fiscal_EnviarNotaEmail . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
8.12. Bematech_Fiscal_CancelarNota . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
8.13. Bematech_Fiscal_ObterStatusImpressora . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
8.14. Bematech_Fiscal_ImprimirTextoLivre . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
8.15. Bematech_Fiscal_ImprimirDocumentoFiscal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
8.16. Bematech_Fiscal_AcionarGaveta . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
8.17. Bematech_Fiscal_ObterInformacoesSistema . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
8.18. Bematech_Fiscal_ListarConfiguracoes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
8.19. Bematech_EfetuarConfiguracoes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
8.20. Bematech_Fiscal_ObterInformacoesContingencia . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
8.21. Bematech_Fiscal_TrocaEstadoContingencia . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
9. Fluxos de operação usando a BemaOne.dll + APIOne. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
9.1. Venda Simples. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
9.2. Obter informações do Sistema.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
10. Usando Serviços RestFul . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
10.1. O que são Serviços RestFul? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
10.2. Entendendo o Funcionamento . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
10.3. Lista de Serviços RestFul . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
11. Recursos da API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
11.1. Abrir Cupom . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
11.2. Adicionar Item de venda . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
11.3. Estornar Item de venda . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
11.4. Adicionar Pagamento . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
11.5. Estornar Pagamento . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
11.6. Fechar Cupom . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
11.7. Estornar Cupom . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
11.8. Listar Documentos. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
11.9. Listar Documentos (Paginada) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
11.10. Buscar documento por ID . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
11.11. Cancelar um documento . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
11.12. Enviar documento por email (ID) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
11.13. Buscar documento através de série/número . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
11.14. Enviar documento por email (série/número) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
11.15. Consultar status de uma impressora Bematech . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
11.16. Impressão de documento genérico . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
11.17. Impressão de DANFE (Chave de acesso) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
11.18. Impressão de DANFE (Série/Número). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
11.19. Realizar abertura de gaveta . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
11.20. Informações sobre o sistema . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
11.21. Listagem de configurações do sistema . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
11.22. Realizar alteração de configurações do Fiscal Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
11.23. Localizar configuração específica do Fiscal Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
11.24. Obter informações sobre contingência . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
11.25. Alterar o modo de contingência . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
12. Exemplos JSON NFC-E. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
12.1. Método: GET (Fiscal Manager NFC-E e SAT) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
12.2. Método: POST (Utilizando Fiscal Manager NFC-e) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
12.3. Método: DELETE (Utilizando Fiscal Manager NFC-E) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
13. Exemplos JSON SAT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
13.1. Método: GET (Fiscal Manager NFC-E e SAT) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
13.2. Método: POST (Utilizando Fiscal Manager SAT) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
13.3. Método: POST (Utilizando Fiscal Manager SAT) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
13.4. Método: DELETE (Utilizando Fiscal Manager SAT) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
14. Fluxos de operação usando a integração direta através da APIOne. . . . . . . . . . . . . . . . . . . . . . . . . . 51
14.1. Venda Simples. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
14.2. Obter informações do Sistema.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
15. Plataforma Fiscal.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
15.1. Componentes da plataforma fiscal: . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
15.2. Pré-Requisitos da Plataforma Fiscal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
16.LEGISLAÇÃO........................................................................... 77
17.TERMOSEABREVIAÇÕES ............................................................... 78
18.CONTATOESUPORTETÉCNICO.......................................................... 78

1. Integrando a Plataforma Fiscal através da APIOne.

1. O que é a a APIOne?

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.





3. Como utilizá-la para Integraçã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.

O uso da BemaOne.dll lhe permite trabalhar com a APIOne, mesmo em
linguagens mais antigas,


Usar a APIOne reduz o número de componentes de integração, facilita a atualização e a manutenção em sua aplicação e também melhora a performance na emissão de documentos uma vez que toda a integração utilizará um componente único.
No gráfico abaixo apresentamos os componentes para integração através da API.



























Figure 1. Integração através da API.

Além da APIOne, a Plataforma Fiscal também oferece outros métodos
de integração como o modo compatibilidade apresentado no diagrama gráfico abaixo:



































Figure 2. Integração através do modo compatibilidade.
Compare os gráficos e veja a diferença entre os métodos de integração.

1. Vantagens ao 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.

5. Usando a 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.



5.1. Integração da Plataforma Fiscal usando a BemaAPIOne + 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.

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 é uma camada intermediária entre seu software e o Fiscal Manager.





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

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

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.
7.1. JAVA (JNA)
Declarando as funções em Java (JNA)

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 ();
}





7.2. JAVA (JNI)
Declarando as funções em JAVA (JNI)

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





7.3. C#
Declarando as funções em C#

\[DllImport(

string Bematech_Fiscal_AbrirNota(string dados); \[DllImport(

string Bematech_Fiscal_EstornarNota(); \[DllImport(

string Bematech_Fiscal_FecharNota(string dados); \[DllImport(

string Bematech_Fiscal_VenderItem(string dados); \[DllImport(

string Bematech_Fiscal_EstornarVendaItem(string dados); \[DllImport(

string Bematech_Fiscal_EfetuarPagamento(string dados); \[DllImport(

string Bematech_Fiscal_EstornarPagamento(string dados); \[DllImport(

string Bematech_Fiscal_ListarNotas(string dados); \[DllImport(

string Bematech_Fiscal_InutilizarNumeracao(string dados); \[DllImport(

string Bematech_Fiscal_ConsultarNota(string dados); \[DllImport(

string Bematech_Fiscal_EnviarNotaEmail(string dados); \[DllImport(

string Bematech_Fiscal_CancelarNota(string dados); \[DllImport(

string Bematech_Fiscal_ObterStatusImpressora(); \[DllImport(

string Bematech_Fiscal_ImprimirTextoLivre(string dados); \[DllImport(

string Bematech_Fiscal_ImprimirDocumentoFiscal(string dados); \[DllImport(

string Bematech_Fiscal_AcionarGaveta(string dados); \[DllImport(

string Bematech_Fiscal_ObterInformacoesSistema(); \[DllImport(

string Bematech_Fiscal_ListarConfiguracoes(); \[DllImport(

string Bematech_Fiscal_EfetuarConfiguracoes(string dados); \[DllImport(

string Bematech_Fiscal_ObterInformacoesContingencia(); \[DllImport(

8.1. Bematech_Fiscal_AbrirNota

Parâmetros de entrada da função.

{
"versao": "string",
"configuracao": {
"imprimir": false,
"email": false
},
"identificacao": {
"cuf": "string",
"cnf": "string",
"natOp": "string",
"indPag": 0,
"mod": "string",
"serie": "string",
"nnf": "string",
"dhEmi": "string",
"tpNF": "string",
"idDest": 0,
"tpImp": 0,
"tpEmis": 0,
"cdv": 0,
"tpAmb": 0,
"finNFe": 0,
"indFinal": 0,
"indPres": 0,
"procEmi": 0,
"verProc": "string",
"cMunFG": "string"
},
"emitente": {
"cnpj": "string",
"endereco": {
"nro": "string",
"uf": "string",
"cep": "string",
"fone": "string",
"xBairro": "string",
"xLgr": "string",
"cMun": "string",
"cPais": "string",
"xPais": "string",
"xMun": "string"
},
"ie": "string",
"crt": 0,
"xNome": "string",
"xFant": "string"
},
"destinatario": {
"cpf": "string",
"endereco": {
"nro": "string",
"uf": "string",
"cep": "string",
"fone": "string",
"xBairro": "string",
"xLgr": "string",
"cMun": "string",
"cPais": "string",
"xPais": "string",
"xMun": "string"
},
"indIEDest": 0,
"email": "string",
"xNome": "string"
}
}

Parâmetros de retorno da função.

{
"sucesso": false,
"codigo": 0,
"descricao": "string",
"numeroSessao": "string"
}
8.2. Bematech_Fiscal_EstornarNota

Parâmetros de retorno da função.

{
"sucesso": false,
"codigo": 0,
"descricao": "string",
"numeroSessao": "string"
}





8.3. Bematech_Fiscal_FecharNota

Parâmetros de entrada da função.

{
"total": {
"icmsTotal": {
"vbc": 0.00,
"vicms": 0.00,
"vicmsDeson": 0.00,
"vbcst": 0.00,
"vst": 0.00,
"vii": 0.00,
"vipi": 0.00,
"vpis": 0.00,
"vcofins": 0.00,
"vnf": 0.00,
"vtotTrib": 0.00,
"vdesc": 0.00,
"vprod": 0.00,
"voutro": 0.00,
"vseg": 0.00,
"vfrete": 0.00
}
},
"informacaoAdicional": {
"infCpl": "string",
"observacoesContribuintes"

: \[

Parâmetros de entrada da função.

{
"nItem": 0,
"produto": {
"cProd": "string",
"cean": "string",
"xProd": "string",
"ncm": "string",
"nve": "string",
"extipi": "string",
"cfop": "string",
"uCom": "string",
"qCom": "string",
"vUnCom": 0,
"vProd": 0,
"indRegra": 0,
"ceanTrib": "string",
"uTrib": "string",
"qTrib": 0,
"vUnTrib": "string",
"vFrete": 0,
"vSeg": 0,
"vDesc": 0,
"vOutro": 0,
"vItem": 0,
"vRatDesc": 0,
"vRatAcr": 0,
"indTot": 0,
"cest": "string",
"declaracoesImportacao"

: \[

: \[

: \[

: \[

: \[

: \[

Parâmetros de entrada da função.

{
"sessao": "string",
"sequencia": 0
}
Parâmetros de retorno da função.

{
"sucesso": false,
"codigo": 0,
"descricao": "string"
}





8.6. Bematech_Fiscal_EfetuarPagamento

Parâmetros de entrada da função.

{
"nItem": 0,
"tPag": 0,
"vPag": 0,
"cartao": {
"cnpj": "string",
"tBand": 0,
"cAut": "string",
"tpIntegra": 0
},
"cAdmC": "string"
}

Parâmetros de retorno da função.

{
"sucesso": false,
"codigo": 0,
"descricao": "string"
}
8.7. Bematech_Fiscal_EstornarPagamento

Parâmetros de entrada da função.

{
"sessao": "string",
"sequencia": 0
}

Parâmetros de retorno da função.

{
"sucesso": false,
"codigo": 0,
"descricao": "string"
}





8.8. Bematech_Fiscal_ListarNotas

Parâmetros de entrada.

{
"pagina": 0,
"dataInicial": "string",
"dataFinal": "string",
"serie": "string",
"numeroInicial": 0,
"numeroFinal": 0,
"status": "string",
"cancelado": false,
"inutilizado": false,
"situacaoSefaz": "string",
"pageSize": "string"
}

Parâmetros de retorno da função.

{
"sucesso": false,
"codigo": 0,
"descricao": "string"
}





8.9. Bematech_Fiscal_InutilizarNumeracao

Parâmetros de entrada da função.

{
"identificacao": {
"serie": "string",
"numero": "string"
},
"justificativa": "string"
}
Parâmetros de retorno da função.

{
"sucesso": false,
"codigo": 0,
"descricao": "string"
}





8.10. Bematech_Fiscal_ConsultarNota

Parâmetros de entrada da função.

{
"id": "string",
"formato": "string"
}

• Parâmetros de Retorno String de retorno em formato JSON. Parâmetros de retorno da função.

{
"serie": 0,
"numero": 0,
"formato": "string"
}





8.11. Bematech_Fiscal_EnviarNotaEmail

Parâmetros de entrada da função.

{
"id": "string",
"email": "string"
}

Parâmetros de retorno da função.

{
"id": "string",
"email": "string"
}





8.12. Bematech_Fiscal_CancelarNota

Parâmetros de entrada da função.

{
"id": "string",
"xJust": "string",
"dhEvento": "string"
}
Parâmetros de retorno da função.

{
"sucesso": false,
"codigo": 0,
"descricao": "string"
}





8.13. Bematech_Fiscal_ObterStatusImpressora

{
"ovr": "string",
"offline": "string",
"wait": "string",
"bufStat": "string",
"pnes": "string",
"ps": "string",
"drawer": "string",
"noPaper": "string",
"error": "string",
"cover": "string",
"ca": "string",
"ce": "string",
"nre": "string",
"re": "string",
"hoh": "string",
"cmd": "string",
"firmwareVersion": "string"
}





8.14. Bematech_Fiscal_ImprimirTextoLivre

Parâmetros de entrada da função.

"dados": 0,
"base64": false
}

Parâmetros de retorno da função.

{
"sucesso": false,
"codigo": 0,
"descricao": "string",
"numeroSessao": "string"
}





8.15. Bematech_Fiscal_ImprimirDocumentoFiscal

Parâmetros de entrada da função (Impressão via chave).

{
"chave": "string"
}

Parâmetros de entrada da função (Impressão através de série e número do doc).

{
"serie": 0,
"numero": 0
}

Parâmetros de retorno da função.

{
"sucesso": false,
"codigo": 0,
"descricao": "string",
"numeroSessao": "string"
}





8.16. Bematech_Fiscal_AcionarGaveta

Parâmetros de entrada da função.

{
"numero": 0
}
Parâmetros de retorno da função

{
"sucesso": false,
"codigo": 0,
"descricao": "string",
"numeroSessao": "string"
}





8.17. Bematech_Fiscal_ObterInformacoesSistema

Parâmetros de retorno da função.

{
"versao": "string",
"totalNotasRejeitadas": 0,
"totalNotasRejeitasEmitidasContingencia": 0,
"certificado": {
"situacao": "string",
"dataExpiracao": "2016-08-23T20:24:30.672Z",
"diasParaExpiracao": 0
}
}





8.18. Bematech_Fiscal_ListarConfiguracoes

Parâmetros de retorno da função.

{
"configuracao"

: \[

Parâmetros de entrada da função (Caso de configurações da dll).

{
"sistema":
{
"path": "string",
"nivelLog": "string"
}
"nfe":
{
"timeoutWebservice": "string",
}
}
Parâmetros de entrada da função (Caso de configurações do sistema).

{
"configuracao"

: \[

Parâmetros retornados pela função.

{
"situacao": "string",
"codigo": 0,
"notasEmContingencia": 0,
"dataEntradaContingencia": "2016-08-23T20:24:30.680Z",
"minutosEmContingencia": 0,
"minutosRestantesEmContingencia": 0
}
8.21. Bematech_Fiscal_TrocaEstadoContingencia

Parâmetros retornados pela função.

{
"situacao": "string",
"codigo": 0,
"notasEmContingencia": 0,
"dataEntradaContingencia": "2016-08-23T20:24:30.681Z",
"minutosEmContingencia": 0,
"minutosRestantesEmContingencia": 0
}

9. Fluxos de operação usando a BemaOne.dll + APIOne.
Para entender melhor o fluxo de integração mostramos abaixo,através de um passo a passo a ordem de execução das funções em uma rotina de venda, bem como a execução de uma função que irá consultar informações diretamente do Fiscal Manager.
9.1. Venda Simples.
Considerando uma venda (NFC-e ou SAT), que possua 2 produtos e uma única forma de pagamento, as seguintes funções serão utilizadas:

• 1. Bematech_Fiscal_AbrirNota

• 2. Bematech_Fiscal_VenderItem

• 3. Bematech_Fiscal_VenderItem

• 4. Bematech_Fiscal_EfetuarPagamento

• 5. Bematech_Fiscal_FecharNota

Ao executar cada uma das funções com seus respectivos parâmetros, conforme descrito neste manual, o xml da venda será criado e populado.
Por sua vez, assim que concluída a operação, o próprio Fiscal Manager se encarregará de assinar digitalmente o arquivo e posteriormente transmiti-lo à Sefaz.
Nos casos de sucesso, após a conclusão do "cupom", a DANFE poderá ser impressa através da função:

• 6. Bematech_Fiscal_ImprimirDocumentoFiscal (via chave)

Lembrando que cada uma das funções recebe um retorno de execução através de uma string com conteúdo em formato JSON, o tratamento destes retornos é de extrema importância para eventuais situações adversas durante a operação da
aplicação.

9.2. Obter informações do Sistema.
Nos casos onde serão capturadas informações do sistema, o fluxo operacional também é parecido, veja:

• 1. Bematech_Fiscal_ObterInformacoesSistema

Considere a execução da leitura das informações do certificado digital, para tal utilize a seguinte função:



A dll receberá o JSON de retorno dentro de uma variável String. O tratamento do
JSON deverá ser efetuado de acordo com a definição da linguagem utilizada para o desenvolvimento da aplicação.
Em caso de sucesso o retorno recebido pela função seguirá o seguinte padrão:
Retorno da função Bematech_Fiscal_ObterInformacoesSistema

{
"versao": "string",
"totalNotasRejeitadas": 0,
"totalNotasRejeitasEmitidasContingencia": 0,
"certificado": {
"situacao": "string",
"dataExpiracao": "2016-08-23T20:24:30.672Z",
"diasParaExpiracao": 0
}
}

10. Usando Serviços RestFul
A nova versão do Fiscal Manager contempla recursos para utilização de uma API RestFul.
Ao utilizar os serviços desta API a integração de seu aplicativo PDV pode ser ser executada diretamente através da API sem a utilização de nenhuma biblioteca para comunicação com o Fiscal Manager.

Ao efetuar as chamadas de funções (serviços) em seu software, é possível enviar e receber dados relacionados ao Fiscal Manager e também a impressora utilizada para impressão da DANFE ou CF-e (no caso do SAT).

Em um breve resumo utilizando a API você pode de forma nativa:

• Emitir Cupons.

• Registrar Pagamentos.

• Enviar emails.

• Obter informações diversas, como número de notas e etc.

10.1. O que são Serviços RestFul?
Antes de prosseguirmos com mais detalhes sobre este novo método de integração, é importante apresentarmos um breve resumo do que é uma API RestFul.
Bom, Rest é a abreviação de "Representational State Transfer". Que basicamente trata-se de um conjunto de princípios web standard que utiliza protocolo HTTP e URL´s para comunicação.
Serviços RestFul são largamente utilizados em web services através de uso APIS que por sua vez, permitem acesso aos serviços disponibilizados.



10.2. Entendendo o Funcionamento
Um dos principais itens na arquitetura RestFul são as URLs do sistema e os seus resources. Um recurso (resource), usa os métodos do protocolo HTTP para se comunicar: No gráfico abaixo, ilustramos esta interação.

Arquitetura RestFul.
image::images/rest_aplication_use.png]"center"]
As ações executadas para estes serviços, utilizam a tecnologia JSON para troca de informações entre a Plataforma Fiscal (APIOne) e sua aplicação comercial.



10.3. Lista de Serviços RestFul
Agora que já conhecemos um pouco sobre a arquitetura RestFul, podemos voltar ao processo de integração do Fiscal Manager. Como já visto anteriormente, a integração através da API de serviços RestFul, está disponível nas versões:

• 02.00.00: Fiscal Manager NFC-e

• 3.0.0: Fiscal Manager SAT

Cada recurso da API possui uma URL que dá acesso aos detalhes do mesmo, esta documentação está vinculada ao Fiscal Manager para acessá-la utilize a URL: {*}http://localhost:9999/docs/#/*

• imprescindível que o Fiscal Manager esteja instalado e em execução para que você tenha acesso a lista de serviços da API.

Para melhor visualização utilize o Google Chrome.
Nos próximos tópicos abordaremos em detalhes cada um dos serviços RestFul disponíveis na API de integração com o Fiscal Manager.



11. Recursos da API
Neste tópico, apresentamos todos os recursos disponíveis para a integração com o Fiscal Manager NFC-E e SAT.


11.1. Abrir Cupom

11.2. Adicionar Item de venda

Método: POST

11.3. Estornar Item de venda

11.4. Adicionar Pagamento

11.5. Estornar Pagamento

11.6. Fechar Cupom

11.7. Estornar Cupom

11.8. Listar Documentos

11.9. Listar Documentos (Paginada)

11.10. Buscar documento por ID

11.11. Cancelar um documento