Escolar Documentos
Profissional Documentos
Cultura Documentos
Documentação de Software
Versão 0.38
A Telenet tem o direito de efetuar modificações ou correções das informações contidas neste
documento sem aviso prévio
REVISÃO: 0.38
Abril de 2019
INDICE DO DOCUMENTO
1 - INTRODUÇÃO...................................................................................................................................................2
2 – PREMISSAS BÁSICAS.....................................................................................................................................3
3 – DESCRIÇÃO DA SOLUÇÃO............................................................................................................................3
4 – REGRAS PARA TROCA DE ARQUIVOS........................................................................................................3
5 – FLUXO DAS MENSAGENS.............................................................................................................................5
6 – LAYOUT PARA MONTAGEM DOS ARQUIVOS...........................................................................................6
7 – DESCRIÇÃO DAS MENSAGENS....................................................................................................................6
7.1 Mensagem de Verificação...........................................................................................................................7
7.2 PBM - Solicitação de Pré-Autorização PBM com cartão convênio...........................................................7
7.3 PBM - Consulta Pré-Autorização...............................................................................................................7
7.4 PBM – Venda Pré-Autorizada.....................................................................................................................7
7.5 PBM - Consulta Medicamentos..................................................................................................................8
7.6 PBM – Venda Normal (sem pré-autorização).............................................................................................8
7.7 PBM - Cancelamento..................................................................................................................................8
7.8 PBM – Mensagem de confirmação da autorização....................................................................................8
7.9 PBM - Consulta Cliente-Cartão (para uso no balcão)...............................................................................9
7.10 PBM - Consulta MSG_Item (para uso no balcão).....................................................................................9
1 - INTRODUÇÃO
2 – PREMISSAS BÁSICAS
Troca de mensagens via arquivo texto em diretórios pré-definidos e parametrizáveis: um
diretório para entrada (arquivos gerados pela Automação) e um diretório de saída
(arquivos gerados pelo Gerenciador).
Os arquivos são gerados em formato texto, puro, um registro por linha.
3 – DESCRIÇÃO DA SOLUÇÃO
O aplicativo de Automação realiza todas as tarefas que tem interface com o usuário (telas de
entrada e saída, impressora, etc.). Captura os dados necessários para realizar a transação,
grava no diretório de entrada, um arquivo texto de solicitação (de acordo com layout
definido), contendo estes dados, e fica aguardando um arquivo de status para saber se o
Gerenciador esta ativo e acatou a solicitação (tempo máximo de 5 segs.). Caso a solicitação
tenha sido acatada (existe arquivo de status), o aplicativo de Automação passa a aguardar um
arquivo resposta (tempo máximo de 30 segs.).
O Gerenciador deverá ser instalado em uma máquina, que tenha acesso a Rede (Internet linha
discada ou banda larga, ou linha dedicada) e acesso à rede interna do estabelecimento. Uma
vez em execução, ele fica verificando o diretório de entrada.
O Gerenciador realiza todas as tarefas que tem interface com a Rede ( conexão, protocolos de
comunicação e troca de mensagens). Ele fica aguardando os arquivos de solicitação gerados
pela Automação. Quando o Gerenciador percebe que há um arquivo de solicitação, gera um
arquivo de status sinalizando para a Automação que recebeu o arquivo. Em seguida, faz a
leitura e consistência, se o arquivo for invalido, vai remove-lo e gerar no diretório de saída,
um arquivo resposta com um código de erro. Se o arquivo for válido, vai formatar os pacotes
de dados, efetuar uma conexão ao Sistema Autorizador, enviar o pacote, aguardar a resposta, e
gerar um arquivo resposta no diretório de saída, e registrar a operação no arquivo log. A partir
daí o Gerenciador passa a aguardar uma confirmação (tempo máximo de 5 segs.) de que o
aplicativo de Automação recebeu a resposta. Caso haja a mensagem, o Gerenciador vai
atualizar o status da transação.
O arquivo de confirmação, serve para indicar que a resposta foi recebida, e através dele o
aplicativo de Automação confirma ou não o processamento da resposta. Desta forma, caso o
aplicativo de Automação tenha recebido uma resposta positiva, mas não conseguir apresentar
a resposta em tela ou imprimir o comprovante, deverá gerar o arquivo indicando isto, assim a
transação poderá ser desfeita.
arquivos deverão ser numerados e sequenciais de acordo com número que identifica a
transação (veja campo Identificação), e o conteúdo do campo Identificação será utilizado
para montar o seu nome, e o nome do arquivo resposta. Exemplo: arquivo 156, será
gravado como 00000156.ENV no diretório de entrada, e vai gerar um arquivo
00000156.RSP no diretório de saída.
O processo de gravação dos arquivos, deverá ser de forma que o aplicativo que vai gravar,
tenha um buffer pronto, crie o arquivo, grave e feche no menor tempo possível. Evitando
fazer a montagem do buffer a ser gravado depois que o arquivo foi criado, porque o
aplicativo de interface pode tentar ler o arquivo imediatamente após o nome aparecer no
diretório. Também é importante criar o arquivo com um nome temporário (exemplo:
arquivo 156, criar como XXXXXXX.tmp para depois renomeá-lo para 00000156.ENV)
Sempre que um arquivo for lido com sucesso, ele será removido (esta regra vale para
todos os aplicativos envolvidos no processo).
Tempo máximo para aguardar um arquivo de status, após gerar um arquivo de solicitação.
5 segundos
Tempo máximo para aguardar um arquivo resposta após receber um arquivo de status. 40
segundos.
Aplicativo
Automação
Verifica se
existe arq. Timeout 5 secs
status xxxx.sta
Verifica se
existe arquivo
Timeout 40 secs
resposta
xxxxx.rsp
Abre arquivo
Abertura
Tentou 3
arquivo com
vezes ?
sucesso ?
Lê arquivo
Apaga arquivo
resposta.
Processa resposta
Gera arquivo
confirmacao da
resposta
FIM
As descrições aqui apresentadas exibem o formato que devem ter as mensagens geradas pelo
aplicativos.
As mensagens serão trocadas através de arquivo texto onde cada linha contém um tipo de
informação. As linhas possuem formato padrão e tamanho variável.
Para criar compatibilidade e aderência a outras interfaces, foi adotado um padrão já utilizado
no mercado, que utiliza o conceito de registros com palavra-chave. Utilizamos a mesma
lógica de funcionamento, fazendo-se as adaptações necessárias aos serviços disponíveis neste
Gerenciador, sem alterar o padrão. O formato genérico é:
AAA-BBBC=CDDDDDDD......DDDDDEF
Onde:
A- Identificação do tipo de informação ou campo
B- Nº de seqüência complementar ao tipo de informação ou campo
C- Posição fixa contendo espaço ou branco
D- Informação
E- Carriage Return (CR) =13 ( ASCII)
F- Line Feed (LF) = 10 ( ASCII)
A tabela abaixo mostra os tipos de informações (ou campos) que deverão estar presentes
nos arquivos enviados e recebidos pelo aplicativo de Automação. As informações (ou campos)
variam de acordo com o Código de Processamento e estão assinalados com ‘M’ quando
obrigatórios (mandatórios), ‘O’ quando opcionais e ‘-‘quando ausentes.
O aplicativo de Automação deve estar preparado para ignorar os tipos de registros
desconhecidos.
Quando houver diferença entre o conteúdo do campo enviado pelo Aplicativo de
Automação e o recebido pelo Gerenciador valerá o do Gerenciador.
Outra forma de fazer esta verificação é gerando realmente o arquivo de uma transação e
observando se o Gerenciador vai gerar o arquivo “.sta”, dentro do tempo máximo definido.
Descontinuada
CODIGO DE PROCESSAMENTO 41
Descontinuada
Descontinuada
Descontinuada
Descontinuada
Descontinuada
DDD
111-000
Formato: numérico, 3 posições
TELEFONE
112-000
Formato: numérico 8 posições.
RAMAL
113-000
Formato: numérico 5 posições.
PLACA CARRO
114-000
Formato: AAA99999
VALOR ENDIVIDAMENTO A VISTA
115-000
Formato: 99999999999,99
VALOR ENDIVIDAMENTO 30 DIAS
116-000
Formato: 99999999999,99
VALOR ENDIVIDAMENTO 60 DIAS
117-000
Formato: 99999999999,99
VALOR ENDIVIDAMENTO 90 DIAS
118-000
Formato: 99999999999,99
VALOR ENDIVIDAMENTO 120 DIAS
119-000
Formato: 99999999999,99
VALOR ENDIVIDAMENTO 150 DIAS
120-000
Formato: 99999999999,99
CÓDIGO DE PRE AUTORIZACAO
300-000
Formato: Alfanumérico até 12 bytes.
CRF DO FARMACEUTICO
301-000 Indica o código do profissional.
Formato: Alfanumerico até 10 bytes.
UF DO FARMACEUTICO
Utilizado nas transações de compra de medicamento.
302-000
Indica o UF do registro do profissional.
Formato: Alfanumerico até 2 posiçoes.
VALOR A PAGAR A VISTA
304-000
Formato: numérico até 12 bytes sem ponto decimal.
MAPA DE ACOES
307-000 Contém um grupo de bytes onde cada posição identifica ações necessárias para o cliente ou cartão utilizado
Formato: Alfanumérico, tamanho fixo 20 bytes. (preenchido com zero ascii)
MENSAGEM SOBRE O CLIENTE
308-00 Contém um texto com indicações sobre o cliente, para uso do operador.
Formato: Alfanumérico, tamanho 250 bytes.
QUANTIDADE DE MEDICAMENTOS
312-000
Formato: Numérico até 2 bytes
DATA DA RECEITA (DDMMAAAA)
313-yyy Indica a data da receita do medicamento.
Formato: DDMMAAAA.
INDICADOR DO TIPO DE CONSELHO
314-yyy Indica o tipo de conselho regional ao qual o profissional está vinculado.
Formato: 0-CRM e 1-CRO.
CODIGO DO CONSELHO
315-yyy
Formato: Alfanumérico até 10 bytes.
UF DO CONSELHO
316-yyy
Formato: Alfanumérico até 2 bytes.
TIPO DE PRODUTO
Tipo do medicamento: 01-Medicamento, 02-Perfumaria, 03-Manipulacao Homeopatia, 04-Manipulacao
317-yyy
Alopatia, 05-Correlato/Acessorios, 06-Instrumentos, 07-Material Cirúrgico, 08-Material Hospitalar.
Formato: Alfanumerico 2 bytes.
CODIGO EAN DO MEDICAMENTO
318-yyy
Formato: Numérico, 13 bytes com zeros a esquerda.
DESCRIÇÃO DO MEDICAMENTO
319-yyy
Formato: Alfanumérico, até 15 bytes
320-yyy CONDICAO DE VENDA
Determina a condição de venda do medicamento. Se o conteúdo for zero = Obrigatório Utilizar o Preço
PBM, se o conteúdo for 1 = Permite venda com preço inferior ao Preço PBM.