Guia de integração
Projeto Farmácia Popular – Ministério da Saúde
G-Buster Access Origin Identification
Brasília, fevereiro de 2013
Versão 1.0
Sumário
1. COMPONENTES DA SOLUÇÃO... 3
1.1. COMPONENTE GBASMSB_LIBRARY.DLL... 3
1.2. COMPONENTE GBASMSB.EXE ... 3
1.3. COMPONENTE GBASMSB_LIBRARY.SO ... 3
1.4. COMPONENTE GBASMSB ... 3
2. INTERFACE DA BIBLIOTECA ... 4
2.1. PRÉ-REQUISITOS ... 4
2.1.1. MÉTODO IDENTIFICAESTACAO... 4
2.1.2. MÉTODO PEGASOLICITACAO... 4
2.1.3. MÉTODO PEGACONFIRMACAO ... 5
3. INTERFACE DA BIBLIOTECA – EXECUTÁVEIS... 6
3.1. PRÉ-REQUISITOS ... 6
3.1.1. MÉTODO IDENTIFICACAO... 6
3.1.2. MÉTODO SOLICITACAO ... 6
3.1.3. MÉTODO CONFIRMACAO... 7
4. INTERFACE DA BIBLIOTECA – WRAPPER JAVA ... 8
4.1. PRÉ-REQUISITOS ... 8
4.1.1. MÉTODO IDENTIFICAESTACAO... 8
4.1.2. MÉTODO PEGASOLICITACAO... 8
1. COMPONENTES DA SOLUÇÃO
1.1. COMPONENTE GBASMSB_LIBRARY.DLL
Biblioteca nativa para Sistemas Operacionais Windows (XP, Vista e 7) x86. Deverá ser utilizada em aplicações cuja linguagem de programação permite a utilização de bibliotecas externas.
1.2. COMPONENTE GBASMSB.EXE
Executável para Sistemas Operacionais Windows (XP, Vista e 7) x86. Deverá ser utilizado em aplicações cuja linguagem de programação não permite a utilização de bibliotecas externas.
1.3. COMPONENTE GBASMSB_LIBRARY.SO
Biblioteca nativa para Sistemas Operacionais GNU/Linux x86. Deverá ser utilizada em aplicações cuja linguagem de programação permite a utilização de bibliotecas externas.
1.4. COMPONENTE GBASMSB
Executável para Sistemas Operacionais GNU/Linux x86. Deverá ser utilizado em aplicações cuja linguagem de programação não permite a utilização de bibliotecas externas.
2. INTERFACE DA BIBLIOTECA
2.1. PRÉ-REQUISITOS
∑ Sistemas Operacionais GNU/Linux ou Windows, operando em plataforma X86 (Intel-compatível).
2.1.1. MÉTODO IDENTIFICAESTACAO
Este método preenche uma string com uma assinatura única e aleatória que é utilizada para geração do “DNA” da máquina.
Sintaxe:
const char* IdentificaEstacao();
Valor de retorno:
Uma string contendo o DNA da máquina.
2.1.2. MÉTODO PEGASOLICITACAO
Este método tem a finalidade de preencher uma string que será utilizada para etapa de solicitação de compra.
Sintaxe:
const char* PegaSolicitacao(
const char* CNPJ, const char* CPF, const char* CRM, const char* UF_CRM, const char* DT_EMISSAO );
Parâmetros: CNPJ: Número do CNPJ do estabelecimento; CPF: Número do CPF do cliente; CRM: Número do CRM; UF_CRM: Unidade federativa do CRM; DT_EMISSAO: Data da solicitação. Valor de retorno:
Uma string que será utilizada para validação da solicitação através da geração da assinatura da máquina.
2.1.3. MÉTODO PEGACONFIRMACAO
Este método tem a finalidade de preencher uma string que será utilizada para etapa de solicitação de compra.
Sintaxe:
const char* PegaConfirmacao(
const char* CNPJ,
const char* NU_AUTORIZACAO, const char* NU_CUPOM_FISCAL );
Parâmetros:
CNPJ:
Número do CNPJ do estabelecimento;
NU_AUTORIZACAO:
Número da autorização de compra;
NU_CUPOM_FISCAL:
Número do cupom fiscal de compra.
Valor de retorno:
Uma string que será utilizada para validação da confirmação através da geração da assinatura da máquina.
3. INTERFACE DA BIBLIOTECA – EXECUTÁVEIS
3.1. PRÉ-REQUISITOS
∑ Sistemas Operacionais GNU/Linux ou Windows, operando em plataforma X86 (Intel-compatível).
3.1.1. MÉTODO IDENTIFICACAO
Este método preenche uma string com uma assinatura única e aleatória que é utilizada para geração do “DNA” da máquina.
Sintaxe (Sistema Operacional Windows):
gbasmsb.exe --identificacao
Sintaxe (Sistema Operacional GNU/Linux):
./gbasmsb --identificacao
Valor de retorno:
Uma string contendo o DNA da máquina.
3.1.2. MÉTODO SOLICITACAO
Este método tem a finalidade de preencher uma string que será utilizada para etapa de solicitação de compra.
Sintaxe (Sistema Operacional Windows):
gbasmsb.exe --solicitacao --CNPJ cnpj --CPF cpf --CRM crm --UF_CRM ufCrm – DT_EMISSAO_RECEITA dd/mm/aaaa
Sintaxe (Sistema Operacional GNU/Linux):
./gbasmsb --solicitacao --CNPJ cnpj --CPF cpf --CRM crm --UF_CRM ufCrm – DT_EMISSAO_RECEITA dd/mm/aaaa Parâmetros: CNPJ: Número do CNPJ do estabelecimento; CPF: Número do CPF do cliente; CRM: Número do CRM; UF_CRM: Unidade federativa do CRM; DT_EMISSAO_RECEITA: Data da solicitação.
Valor de retorno:
Uma string que será utilizada para validação da solicitação através da geração da assinatura da máquina.
3.1.3. MÉTODO CONFIRMACAO
Este método tem a finalidade de preencher uma string que será utilizada para etapa de solicitação de compra.
Sintaxe (Sistema Operacional Windows):
gbasmsb.exe --confirmacao --CNPJ cnpj –NU_AUTORIZACAO nuAutorizacao – NU_CUPOM_FISCAL nuCupomFiscal
Sintaxe (Sistema Operacional GNU/Linux):
./gbasmsb --confirmacao --CNPJ cnpj –NU_AUTORIZACAO nuAutorizacao –NU_CUPOM_FISCAL nuCupomFiscal
Parâmetros:
CNPJ:
Número do CNPJ do estabelecimento;
NU_AUTORIZACAO:
Número da autorização de compra;
NU_CUPOM_FISCAL:
Número do cupom fiscal de compra.
Valor de retorno:
Uma string que será utilizada para validação da confirmação através da geração da assinatura da máquina.
4. INTERFACE DA BIBLIOTECA – WRAPPER JAVA
4.1. PRÉ-REQUISITOS
∑ Sistemas Operacionais GNU/Linux ou Windows, operando em plataforma X86 (Intel-compatível).
4.1.1. MÉTODO IDENTIFICAESTACAO
Este método preenche uma string com uma assinatura única e aleatória que é utilizada para geração do “DNA” da máquina.
Sintaxe:
public java.lang.String IdentificaEstacao()
throws java.lang.UnsatisfiedLinkError
Valor de retorno:
Uma string contendo o DNA da máquina.
Throws:
java.lang.UnsatisfiedLinkError:
Retorno caso o módulo GBAS não for encontrado.
4.1.2. MÉTODO PEGASOLICITACAO
Este método tem a finalidade de preencher uma string que será utilizada para etapa de solicitação de compra.
Sintaxe:
public java.lang.String PegaSolicitacao( java.lang.String CNPJ, java.lang.String CPF, java.lang.String CRM, java.lang.String UF_CRM, java.lang.String DT_EMISSAO ) throws java.lang.UnsatisfiedLinkError Parâmetros: CNPJ: Número do CNPJ do estabelecimento; CPF: Número do CPF do cliente; CRM: Número do CRM; UF_CRM:
Unidade federativa do CRM;
DT_EMISSAO:
Data da solicitação.
Valor de retorno:
Uma string que será utilizada para validação da solicitação através da geração da assinatura da máquina.
Throws:
java.lang.UnsatisfiedLinkError:
Retorno caso o módulo GBAS Server não for encontrado.
4.1.3. MÉTODO PEGACONFIRMACAO
Este método tem a finalidade de preencher uma string que será utilizada para etapa de solicitação de compra.
Sintaxe:
public java.lang.String PegaConfirmacao ( java.lang.String CNPJ,
java.lang.String NU_AUTORIZACAO, java.lang.String NU_CUPOM_FISCAL ) throws java.lang.UnsatisfiedLinkError Parâmetros: CNPJ: Número do CNPJ do estabelecimento; NU_AUTORIZACAO:
Número da autorização de compra;
NU_CUPOM_FISCAL:
Número do cupom fiscal de compra.
Valor de retorno:
Uma string que será utilizada para validação da confirmação através da geração da assinatura da máquina.
Throws:
java.lang.UnsatisfiedLinkError: