Guia de integração - Ministério da Saúde

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
4.1.3. MÉTODO PEGACONFIRMACAO ...................................................................... 9
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
DT_EMISSAO_RECEITA dd/mm/aaaa
cnpj
--CPF
cpf --CRM crm
--UF_CRM
ufCrm
–
--UF_CRM
ufCrm
–
Sintaxe (Sistema Operacional GNU/Linux):
./gbasmsb --solicitacao --CNPJ cnpj
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.
--CPF
cpf
--CRM
crm
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
NU_CUPOM_FISCAL nuCupomFiscal
cnpj
–NU_AUTORIZACAO
nuAutorizacao
–
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:
Retorno caso o módulo GBAS Server não for encontrado.