B MARCA P POS CMYK

1. Documentação técnica APIOne.

1.1. Apresentação

Buscamos com este manual oferecer todo o apoio e suporte para que o processo de integração e implementação da Solução Fiscal Bematech com o seu software ocorra da maneira mais rápida e simples possível.
Com o nosso pacote de ferramentas de integração você pode emitir documentos fiscais como: NFC-e e CF-e (SAT) e em breve NF-e e NFS-e.
O Foco deste manual é detalhar os comandos utilizados pela APIOne para o processo de configuração do Fiscal Manager S@T.


1.2. O que é a APIOne?

A APIOne é uma das ferramentas para integração da Plataforma Fiscal Bematech com sua aplicação comercial.
Ela possui um conjunto completo de funções para emissão de documentos fiscais e é uma interface de comunicação direta com o Fiscal Manager garantindo melhor performance e integridade com as legislações vigentes no mercado.


1.3. Como a APIOne funciona?

No gráfico abaixo apresentamos o fluxo operacional da APIOne:

APIOne

A API será utilizada por sua aplicação na execução de todo o processo de troca de informações com o Fiscal Manager.
Também é possível através da API efetuar todas as configurações da Solução Fiscal.
Atualmente a APIOne está disponível em dois formatos distintos de integração:

  • Consumo direto via serviços Restful

  • BemaOne.dll

Neste documento apresentamos todos os parâmetros e serviços disponíveis na API.
Para obter os métodos equivalentes da BemaOne.dll consulte o documento de ajuda que acompanha o pacote do arquivo, disponível em:
http://bematechpartners.com.br/wp01/?page_id=2159.

1.4. JSON Configuração do Fiscal Manager S@T

Os valores preenchidos aqui são exemplos de conteúdo dentro das tags do JSON.
Você deverá alterá-los de acordo com as informações de seu contribuinte.
 1{
 2        "configuracao": [{
 3                "nome": "PROXY",
 4                "valor": "0"
 5        },
 6        {
 7                "nome": "PRINT_LOGO",
 8                "valor": "1"
 9        },
10        {
11                "nome": "URI_IMPRESSORA",
12                "valor": "serial://COM4"
13        },
14        {
15                "nome": "RAZAO_SOCIAL",
16                "valor": "Bematech S/A"
17        },
18        {
19                "nome": "PROXY_USER",
20                "valor": ""
21        },
22        {
23                "nome": "VALIDACAO",
24                "valor": "0"
25        },
26        {
27                "nome": "PRINT_LOGO_IMG",
28                "valor": ""
29        },
30        {
31                "nome": "API_PORT",
32                "valor": "21212"
33        },
34        {
35                "nome": "ID_PDV",
36                "valor": "PDV001"
37        },
38        {
39                "nome": "IMPRIMIR_EXTRATO",
40                "valor": "1"
41        },
42        {
43                "nome": "CUSTODIA_LOCAL",
44                "valor": "1"
45        },
46        {
47                "nome": "FABRICANTE",
48                "valor": "Bematech"
49        },
50        {
51                "nome": "PROXY_PORT",
52                "valor": "0"
53        },
54        {
55                "nome": "SAT_ATIVACAO",
56                "valor": ""
57        },
58        {
59                "nome": "PROXY_HOST",
60                "valor": "192.168.1.2"
61        },
62        {
63                "nome": "CUT_EXTRATO",
64                "valor": ""
65        },
66        {
67                "nome": "CUSTODY_ENABLE",
68                "valor": "1"
69        },
70        {
71                "nome": "PRINTER_MP2500",
72                "valor": "1"
73        },
74        {
75                "nome": "SAT_SERIAL_PORT",
76                "valor": "0"
77        },
78        {
79                "nome": "PROXY_DOMAIN",
80                "valor": "COM12"
81        },
82        {
83                "nome": "ENVIRONMENT_HOMOLOG",
84                "valor": ""
85        },
86        {
87                "nome": "PROXY_PASSWORD",
88                "valor": "1"
89        },
90        {
91                "nome": "CNPJ",
92                "valor": "99999999999999"
93        },
94        {
95                "nome": "IE",
96                "valor": "9999999999"
97        }]
98}

Os valores preenchidos aqui são exemplos de conteúdo dentro das tags do JSON.
Você deverá alterá-los de acordo com as informações de seu contribuinte.

NOME: PROXY

VALOR: 0

Descrição: Configura o uso de servidor proxy para conexões externas.

Observações:
0 - Não Utiliza Servidor Proxy para conexão com os Web Services da Sefaz.
1 - Indica a necessidade de uso de um Servidor Proxy para conexão externa.

NOME: PRINT_LOGO

VALOR: 1

Descrição: Imprimir ou não o log na DANFE.

Observações:
0 - Não imprime a Logo na DANFE.
1 0 Imprime a Logo na DANFE.

NOME: URI_IMPRESSORA

VALOR: serial://COM4

Descrição: Porta de conexão da impressora.

Observações: No caso de utilização do driver Spooler a configuração deve ser executada da seguinte forma:
spooler:\\NomeImpressora.
O nome do compartilhamento (NomeImpressora) neste caso não deve possuir espaços.

NOME: RAZAO_SOCIAL

VALOR: Razão Social da empresa

Descrição: Deve-se preencher neste campo a razão social do contribuinte.

Observações: N/A.

NOME: PROXY_USER

VALOR: bema123

Descrição: Login do usuário para uso e acesso ao proxy.

Observações: N/A.

NOME: VALIDACAO

VALOR: 0

Descrição: Campo destinado a habilitar a validação dos dados de venda.

Observações: Deve ser utilizado somente em ambiente de homologação.
0 - Não Validar dados de venda.
1 - Validar dados de venda.

NOME: PRINT_LOGO_IMG

VALOR: c:\temp\logo.bmp

Descrição: Path da imagem do Logotipo a ser impresso.

Observações: N/A.

NOME: API_PORT

VALOR:[blue]21212

Descrição: Permite a configuração da porta pela qual a API fará comunicação com o Fiscal Manager.

Observações: O valor 21212 pode ser alterado de acordo com a configuração do ambiente.

NOME: ID_PDV

VALOR: PDV001

Descrição: Campo para preenchimento da identificação/número do PDV.

Observações: N/A.

NOME: IMPRIMIR_EXTRATO

VALOR: 1

Descrição: Permite configurar se a CF-e será ou não impressa.

Observações:
0 - Impressão da DANFE inativa.
1 - Impressão da DANFE ativa.

NOME: CUSTODIA_LOCAL

VALOR: 1

Descrição: Permite parametrizar a gravação de notas em custódia local.

Observações:
0 - Não fará custódia local.
1 - Custódia local ativada.

NOME: FABRICANTE

VALOR: Bematech

Descrição: Informar o Fabricante do SAT a ser configurado.

Observações: Fabricantes suportados pelo Fiscal Manager:
Bematech
Gertec
Kryptus
Nitere
Tanca
Urano

NOME: PROXY_PORT

VALOR: 3344

Descrição: Porta utilizado pelo Proxy para conexão externa.

Observações: N/A.

NOME: SAT_ATIVACAO

VALOR: bema1234

Descrição: Campo destinado ao preenchimento do Código de ativação do SAT.

Observações: Código deve ser informado de acordo com o modelo/fabricante do hardware S@T.

NOME: PROXY_HOST

VALOR: 192.168.1.2

Descrição: Endereço do servidor Proxy utilizado para conexão externa.

Observações: N/A.

NOME: CUT_EXTRATO

VALOR: 1

Descrição: Permite parametrização do corte de papel após impressão do CF-e.

Observações:
0 - Não fará o corte de papel.
1 - Fará o corte de papel ao final da impressão.

NOME: CUSTODY_ENABLE

VALOR: 1

Descrição: Permite ativar a custódia online de notas emitidas (Fiscal Cloud)

Observações:
0 - Custódia desativada.
1 - Custódia ativada.

NOME: PRINTER_MP2500

VALOR: 0

Descrição: Campo deve estar habilitado quando a impressora MP 2500 TH for utilizada.

Observações:
0 - Não configurado.
1 - Parametrizado para MP 2500 TH.

NOME: SAT_SERIAL_PORT

VALOR: serial:\\com4

Descrição: Porta de comunicação com o hardware SAT.

Observações: N/A.

NOME: PROXY_DOMAIN

VALOR: bematech.com

Descrição: Permite a configuração do domínio do servidor proxy.

Observações: N/A.

NOME: ENVIRONMENT_HOMOLOG

VALOR:[blue]0

Descrição: Configuração do ambiente.

Observações:
0 - Homologação
1 - Produção.

NOME: PROXY_PASSWORD

VALOR: 12345a

Descrição: Password do usuário para uso e acesso ao proxy.

Observações: N/A.

NOME: CNPJ

VALOR: 99999999999999

Descrição: Campo para registro do CNPJ do emitente da nota.

Observações: N/A.

NOME: IE

VALOR: 9999999999

Descrição: Campo para registro da Inscriçao Municipal do emitente da nota.

Observações: N/A.

2. CONTATO E SUPORTE TÉCNICO

A equipe BSP (Bematech Software Partners), está disponível para lhe apoiar!
Para entrar em contato conosco, utilize um dos canais abaixo: