Interface com Sistema Gerenciador – Via arquivo texto - 0/13

DESCRITIVO PARA COMUNICAÇÃO ON-LINE COM SISTEMA

GERENCIADOR DE TRANSAÇÕES

Documentação de Software

Interface para confirmação de transações eletrônicas

VIA ARQUIVO TEXTO

Versão 0.38

TVAT - Interface texto V.37

 Interface com Sistema Gerenciador – Via arquivo texto - 1/13

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

V.02 – inclusão de novos comandos PBM

V.03 – correção pág.14 códigos dos campos errados
v.12 – inclusão de comentário sobre como proceder com campos opcionais
v.21 – novo tratamento para reposta consulta/cheque, agora distribuída em vários campos
v.22 – Ajuste dos campos mandatórios para envio de transação cheque.
v.23 – Ajuste dos campos mandatórios de recepção de transação cheque.
v.24 – inclusão das transações padrão NetCard Convênio
v.25 - alterações diversas nas transações PBM
v.26 – alterada mensagem de confirmação (retirado campo 300, incluídos os campos 025 e 027)
v.29 – alterações nas mensagens solicita_pre_autorizacao, venda pre-autorizada e venda sem pre-autorizacao PBM.
v.30 – retirada de alguns layouts de mensagens.
v.31 – retirada de algumas definições de header e acréscimo de campo na mensagem de confirmação e na consulta cliente-
cartão.
v.33 – inclusão do campo 308 na consulta_cliente_cartão
v.34 – criado código de processamento para Consulta Mensagem-Item
v.35 – troca de código da transação de Consulta Mensagem-Item
v.36 –Acrescentado o texto: “ou possui as restrições: 26, 27 ou 28.” nas observações (1) de algumas transações.
v.37 – Inclusão campo “referência” nas msgs solicit_pre_autoriz, venda_pre_autoriz, cons pré_autoriz e venda s/pré_autoriz
v.38 – Exclusão de instruções para que seja gerada a pré-autorização ou venda direta. Documentação apenas para fins
de confirmação de transações

TVAT - Interface texto V.37

 Interface com Sistema Gerenciador – Via arquivo texto - 2/13

1 - INTRODUÇÃO

O Gerenciador de Transações, é um aplicativo que se propõe a facilitar a troca de mensagens

entre os aplicativos de automação na rede credenciada (lojas, supermercados, hospitais,
laboratórios, farmácias, etc) e um Sistema Autorizador, permitindo a estes aplicativos realizar
transações on-line, sem a necessidade de o desenvolvedor implementar rotinas de
comunicação e protocolos.
Este documento descreve a montagem das mensagens trocadas entre pontos de atendimento e
o Gerenciador de Transações. Aqui são apresentadas regras e definições para utilização desta
interface.

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.

TVAT - Interface texto V.37

 Interface com Sistema Gerenciador – Via arquivo texto - 3/13

4 – REGRAS PARA TROCA DE ARQUIVOS

 Para garantir o acesso sem utilização de semáforos, no momento da abertura de arquivo

para leitura, em caso de erro, deverão ser feitas até 3 novas tentativas, com um intervalo
de tempo (milisegundos) entre cada uma, antes de considerar o arquivo “em uso por outro
aplicativo”.

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

 A quantidade máxima de procedimentos ou medicamentos em uma mesma mensagem

SUD é de 10 (dez). Desta forma, caso seja necessário obter autorizações SUD, para um
grupo maior, é preciso separar em várias mensagens.
Obs: esta limitação pode ser ampliada no futuro.

 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 de confirmação, após gerar um arquivo

resposta. Padrão 60 segundos (configurável).

 Tempo máximo para aguardar um arquivo resposta após receber um arquivo de status. 40
segundos.

 No caso de transações que exigem mensagens de confirmação (três pernas), as

autorizações quando emitidas deverão estar sempre com o caráter de “pendentes” ( não
confirmadas) e o sistema Autorizador vai aguardar confirmação. Desta forma, o aplicativo
de Automação sempre deverá enviar um comando de confirmação de recebimento após
receber uma resposta de transação aprovada.

TVAT - Interface texto V.37

 Interface com Sistema Gerenciador – Via arquivo texto - 4/13

5 – FLUXO DAS MENSAGENS

Aplicativo
Automação

Gera arquivo solicitação

xxxxx.env

Verifica se
existe arq. Timeout 5 secs
status xxxx.sta

Apaga arquivo status

Verifica se
existe arquivo
Timeout 40 secs
resposta
xxxxx.rsp

Abre arquivo

Abertura
Tentou 3
arquivo com
vezes ?
sucesso ?

Lê arquivo

campo 001-000 é igual ao

Arquivo
do arquivo solicitacao
consistente ? enviado?

Apaga arquivo
resposta.
Processa resposta

Apresenta resposta. Apresenta msg de

Msg em tela ou erro
imprime comprovante.

Gera arquivo
confirmacao da
resposta

FIM

TVAT - Interface texto V.37

 Interface com Sistema Gerenciador – Via arquivo texto - 5/13

6 – LAYOUT PARA MONTAGEM DOS ARQUIVOS

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

AAA-BBBC formam a palavra chave que identifica o registro.

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)

Os tipos de operações possíveis são:

ATV Verifica se o Gerenciador está ativo

ERR Erro durante a operação de autorização
CHQ Pedido de autorização para operações de consulta/garantia de cheques
CRT Pedido de autorização para operações com Cartão Convênio

TVAT - Interface texto V.37

 Interface com Sistema Gerenciador – Via arquivo texto - 6/13

7 – DESCRIÇÃO DAS MENSAGENS

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.

7.1 Mensagem de Verificação

Opcionalmente, o aplicativo de automação pode gerar uma mensagem para saber se o

Gerenciador está ativo. Para isto, ele vai criar um arquivo com o layout definido abaixo, e
verificar se foi gerado um arquivo “.sta”. Neste caso, se o Gerenciador estiver ativo, ele vai
gerar o arquivo de status, mas não vai tentar realizar uma transação.

Código do Campo Tipo de Informação envio

000-000 HEADER M
001-000 IDENTIFICAÇÃO M
999-999 TRAILER – REGISTRO FINAL M

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.

7.2 PBM - Solicitação de Pré-Autorização PBM com cartão convênio

Descontinuada

7.3 PBM - Consulta Pré-Autorização

Descontinuada

7.4 PBM – Venda Pré-Autorizada

Código do Campo Tipo de Informação Envio Resposta
000-000 HEADER M M
001-000 IDENTIFICAÇÃO M M
002-000 NUMERO DO CUPOM FISCAL M M(1)
003-000 VALOR DA OPERACAO M M
009-000 CÓDIGO DA RESPOSTA - M
011-000 CODIGO DE PROCESSAMENTO M -
012-000 NÚMERO DA TRANSAÇÃO – NSU - M

TVAT - Interface texto V.37

 Interface com Sistema Gerenciador – Via arquivo texto - 7/13

013-000 NSU DO AUTORIZADOR - M

022-000 DATA DA TRANSAÇÃO - M
023-000 HORA DA TRANSAÇÃO - M
030-000 TEXTO PARA OPERADOR - M(2)
032-000 AUTENTICACAO - M
097-000 SALDO DO CARTÃO - M
098-000 TRILHA 2 DO CARTÃO M -
100-000 NOME DO PORTADOR - M
300-000 CODIGO DE PRÉ-AUTORIZAÇÃO M -
304-000 VALOR A PAGAR A VISTA M M(1)
312-000 QUANTIDADE DE MEDICAMENTOS M M(1)
313-yyy DATA DA RECEITA (ddmmaaaa) M M(1)
314-yyy INDICADOR DO TIPO DE CONSELHO M M(1)
315-yyy CODIGO DO CONSELHO ( CRM) M M(1)
316-yyy UF DO CONSELHO M M(1)
317-yyy TIPO DE PRODUTO M M(1)
318-yyy CODIGO EAN DO MEDICAMENTO M M(1)
319-yyy DESCRIÇÃO DO MEDICAMENTO - M(1)
320-yyy CONDIÇÃO DE VENDA - M(1)
321-yyy PREÇO MÁXIMO ( PMC) M M(1)
322-yyy PREÇO PBM - M(1)
323-yyy PRECO DIGITADO M -
324-yyy PREÇO DE VENDA - M(1)
325-yyy STATUS DO ITEM - M(1)
326-yyy QUANTIDADE RECEITADA M M(1)
327-yyy QUANTIDADE VENDIDA M M(1)
328-yyy REFERENCIA O O(1)
370-000 DESCRIÇÃO DA TRANSAÇÃO - M
999-999 TRAILER - REGISTRO FINAL M M

CODIGO DE PROCESSAMENTO 41

Obs: Os campos marcados com:

M – são mandatórios, devem obrigatoriamente existir.
O - são opcionais, quando não forem utilizados não devem existir no arquivo de envio.
(1)- somente existem se a transação foi aprovada ( código ‘00’) ou possui as restrições: 26, 27 ou 28.
(2)- somente existem se a transação foi reprovada.
(3)- Somente estarão preenchidos se a informação for preenchida no arquivo de envio correspondente.
(yyy)- Podem ocorrer varias vezes em um mesmo arquivo. O numero de sequencia é indicado pelos
três caracteres ( yyy) do campo correspondente, onde yyy é igual a 001, 002..., respectivamente.

7.5 PBM - Consulta Medicamentos

Descontinuada

7.6 PBM – Venda Normal (sem pré-autorização)

Descontinuada

7.7 PBM - Cancelamento

Descontinuada

7.8 PBM – Mensagem de confirmação da autorização

TVAT - Interface texto V.37

 Interface com Sistema Gerenciador – Via arquivo texto - 8/13

Código do Campo Tipo de Informação Envio Resposta

000-000 HEADER M M
001-000 IDENTIFICAÇÃO M M
003-000 VALOR DA OPERACAO M M
005-000 CODIGO DE PROCESSAMENTO P/ CONFIRMAÇAO M -
009-000 CÓDIGO DA RESPOSTA M M
011-000 CODIGO DE PROCESSAMENTO M -
012-000 NÚMERO DA TRANSAÇÃO – NSU - M
013-000 NSU DO AUTORIZADOR - -
022-000 DATA DA TRANSAÇÃO - M
023-000 HORA DA TRANSAÇÃO - M
025-000 NÚMERO DA TRANSAÇÃO CANCELADA - NSU M -
027-000 NSU AUTORIZADOR DA TRANSAÇÃO CONFIRMADA M -
030-000 TEXTO PARA OPERADOR - M(2)
032-000 AUTENTICACAO - M
370-000 DESCRIÇÃO DA TRANSAÇÃO - M
999-999 TRAILER - REGISTRO FINAL M M

CODIGO DE PROCESSAMENTO 106

ESTA mensagem serve para confirmar ou desfazer uma transação.

PARA confirmar, o campo “009”, no envio, deve ser preenchido com 00.
PARA desfazer, deve ser preenchido com 80.

Obs: Os campos marcados com:

M – são mandatórios, devem obrigatoriamente existir.
O - são opcionais, quando não forem utilizados não devem existir no arquivo de envio.
(1)- somente existem se a transação foi aprovada ( código ‘00’) , ou recusada com código ‘26’
( situação especial para este comando que vai permitir a autorização parcial.
(2)- somente existem se a transação foi reprovada.
(3)- Somente estarão preenchidos se a informação for preenchida no arquivo de envio correspondente.
(yyy)- Podem ocorrer varias vezes em um mesmo arquivo. O numero de sequencia é indicado pelos
tres caracteres ( yyy) do campo correspondente, onde yyy é igual a 001, 002..., respectivamente

7.9 PBM - Consulta Cliente-Cartão (para uso no balcão)

Descontinuada

7.10 PBM - Consulta MSG_Item (para uso no balcão)

Descontinuada

TVAT - Interface texto V.37

 Interface com Sistema Gerenciador – Via arquivo texto - 9/13

8 - DESCRIÇÃO DOS CAMPOS

Campo Conteúdo / Descrição

HEADER
Indica o início do arquivo e o tipo de operação relacionada ao arquivo.
Formato: Alfanumérico de 3 bytes.
Conteúdos válidos:
ATV - Verifica se o Gerenciador Padrão está ativo
000-000
CNF - Confirmação de finalização e/ou impressão do comprovante
NCN - Não confirmação de finalização.
SUD - Solicitação autorizacao para transacoes de convenio medico.
CHQ – Consulta de Cheques
CRT – Autorização para operações com cartão convênio.
IDENTIFICAÇÃO
Número de controle da solicitação que está sendo feita. Deve-se usar este mesmo número para identificar o
001-000 nome do arquivo. Este número é gerado pelo aplicativo de automação, e deverá ter um conteúdo diferente a
cada nova solicitação. O mesmo conteúdo é devolvido nos arquivos de resposta.
Formato: Numérico até 8 bytes.
NUMERO DO CUPOM FISCAL
002-000 Número do cupom fiscal relacionado a operação da venda PBM
Formato: Alfanumérico, 12 bytes
VALOR DA OPERAÇÃO
Valor total da operação. Nas operações com cartão contém o valor a pagar c/cartão (não inclui o valor a
003-000
vista).
Formato: Numérico até 12 bytes, sem ponto decimal.
CODIGO DE PROCESSAMENTO P/ CONFIRMAÇAO
Ocorre apenas nas mensagens de confirmação. Informa o tipo da transação (código do processamento) que
005-000
deverá ser confirmada.
Formato: Numérico até 3 bytes.
DATA DE ABERTURA DA CONTA CORRENTE
006-000
Campo “Cliente desde” que aparece no cheque (formato DDMMAAAA).
CPF/CNPJ
007-000 Indica o tipo e o número do documento do portador utilizado na operação.
Formato: X99999999999999 onde X indica o tipo de documento “P” = CPF, “G” = CGC/CNPJ.
CÓDIGO DA RESPOSTA
Indica se o status da transação. Se foi aprovada (=”00”) ou recusada. O código diferente de 00 indica o
009-000
motivo da recusa. Formato: Alfanumérico com até 3 bytes.
Conteúdos Válidos: 00 – para transação aprovada, qualquer outro valor – transação negada.
CÓDIGO DE PROCESSAMENTO ou TIPO DA TRANSAÇÃO
011-000 Código que identifica a transação que será executada.
Formato: Numérico até 3 bytes.
NÚMERO DA TRANSAÇÃO – NSU HOST
012-000 Indica o número de seqüência (NSU – Número Sequencial Único) da transação atribuído pelo Host
(Sistema Concentrador da Rede de Transações). Formato: Numérico até 12 bytes.
NSU DO AUTORIZADOR
013-000 Indica o número de seqüência (NSU – Número Sequencial Único) da transação atribuído pelo Sistema
Autorizador. Formato: Numérico até 12 bytes.
CODIGO DO OPERADOR
014-000
Usuário do serviço. Formato: Alfanumérico até 15 bytes
TIMESTAMP DA TRANSAÇÃO HOST
015-000
Indica a data e hora da transação no Host. Formato: Numérico – DDMMHHMMSS.
TIMESTAMP DA TRANSAÇÃO LOCAL
016-000
Indica a data e hora da transação no ponto de venda. Formato: Numérico – DDMMHHMMSS.
QUANTIDADE DE PARCELAS
018-000
Número de parcelas para as transações parceladas.
DATA DA TRANSAÇÃO – COMPROVANTE
022-000
Indica a data da transação. Formato: Numérico – DDMMAAAA.
023-000 HORA DA TRANSAÇÃO – COMPROVANTE.

TVAT - Interface texto V.37

 Interface com Sistema Gerenciador – Via arquivo texto - 10/13

Indica a hora da transação. Formato: Numérico – HHMMSS.

NÚMERO DA TRANSAÇÃO CANCELADA - NSU
025-000 Número de sequência (NSU) da transação cancelada.
Formato: Numérico até 12 bytes.
DATA DA TRANSAÇÃO CANCELADA
026-000 Contém a data que aparede no comprovante da transação que vai ser cancelada.
Formato: Numérico – DDMMAAAA.
NSU AUTORIZADOR DA TRANSAÇÃO CANCELADA
027-000 Indica o código de Autorização da transação que vai ser cancelada.
Formato: Numérico até 12 bytes.
TEXTO ESPECIAL OPERADOR
030-000 Texto que, quando presente, deve ser apresentado pelo aplicativo de Automação ao operador.
Formato: Alfanumérico até 40 bytes.
AUTENTICAÇÃO
032-000
Mensagem ou código de autenticação para impressão. Formato: Alfanumérico até 20 bytes.
QUANTIDADE DE CHEQUES (para uso com MODELO COMPRAS)
042-000
Formato Numérico: 2 bytes, máximo de 12 cheques
043-yyy CODIGO CMC-7
VALOR DO CHEQUE (para uso com MODELO COMPRAS)
044-yyy
Valor do cheque. Formato: Numérico até 12 bytes, sem ponto decimal.
DATA DO CHEQUE (para uso com MODELO COMPRAS)
045-yyy
Indica a data do cheque utilizado na operação. Formato: DDMMAAAA.
DIGITO C1
046-yyy
Digito C1 da folha de cheque
DIGITO C2
047-yyy
Digito C2 da folha de cheque
DIGITO C3
048-yyy
Digito C3 da folha de cheque
SALDO DO CARTÃO
Contém o saldo do cartão. Se a transação foi recusada é o saldo antes, se a transação foi aprovada é o saldo
097-000
depois.
Formato: Numérico até 12 bytes, sem ponto decimal.
TRILHA 2 DO CARTÃO
Se a captura da trilha foi efetuada via leitor, contém a imagem da trilha 2, sem sentinelas.
098-000
Se a captura foi manual (digitação), contém os dados capturados.
Formato: Alfanumerico até 37 bytes.
NOME PORTADOR DO CARTÃO OU EMITENTE
100-000
Formato: alfanumérico, até 40 posições.
DATA NASCIMENTO
101-000
Formato: DDMMAAAA
TIPO ENDERECO
102-000
Formato: R = Residencial, C= Comercial.
ENDERECO
103-000 Informa logradouro (Rua, Avenida, praça, etc.) e o endereço.
Formato: alfanumérico até 70 posições.
NUMERO (relativo ao endereço)
104-000
Informa o número do endereço. Formato: numérico até 10 posições.
COMPLEMENTO DO ENDERECO
105-000
Informa se é casa, apartamento, etc. Formato: alfanumérico até 20 posições.
BAIRRO
106-000
Formato: alfanumérico até 30 posições
CIDADE
107-000
Formato: alfanumérico até 40 posições
UF
108-000
Formato: alfanumérico, 2 posições.
CEP
109-000
Formato: numérico não formatado (99999999).
TIPO DE TELEFONE
110-000
Formato: R=Residencial, C=Comercial, M=Comunitário.

TVAT - Interface texto V.37

 Interface com Sistema Gerenciador – Via arquivo texto - 11/13

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.

TVAT - Interface texto V.37

 Interface com Sistema Gerenciador – Via arquivo texto - 12/13

Formato: Numérico 1 byte.

PMC (obtido via DLL)

321-yyy Preço máximo ao consumidor, obtido na base de dados do estabelecimento e enviado para a PBM.
Formato: numérico até 8 bytes sem ponto decimal.
PRECO PBM
322-yyy Preço definido pela empresa de PBM.
Formato: numérico até 8 bytes sem ponto decimal.
PREÇO DIGITADO
323-yyy Preço praticado informado pelo operador ou capturado (via dll) da tabela do estabelecimento.
Formato: numérico até 8 bytes sem ponto decimal.
PRECO DE VENDA
324-yyy Preço final para venda do produto.
Formato: numérico até 8 bytes sem ponto decimal.
STATUS DO ITEM
325-yyy Contém um código que identifica uma mensagem contida em tabela específica (ver com PBM)
Formato: Alfanumérico 2 bytes
QUANTIDADE RECEITADA
326-yyy Quantidade que consta na receita do medicamento.
Formato: Numérico até 4 bytes.
QUANTIDADE VENDIDA
327-yyy Quantidade efetivamente vendida/solicitada do medicamento. Sem frações.
Formato: Numerico até 4 bytes.
REFERENCIA.
328-yyy Contém um código que indica referência se a receita foi retida na farmácia ou não.
Formato: Numérico 1 byte ( 1 – Sim e 2 – Não ).
TEXTO DA MSG SOBRE O ITEM
350-000 Mensagem descritiva PBM sobre o item consultado.
Formato: string até 250 bytes.
DESCRIÇÃO DA TRANSAÇÃO
370-000
Formato: alfanumérico, 40 bytes.
CODIGO DE AUTORIZACAO DA TRANSAÇÃO
371-000 Código de autorização atribuído pelo Sistema Autorizador (diferente do NSU AUTORIZADOR). Nas
transações de Convênio médico identifica SENHA DO PACOTE. Formato: alfanumérico, 12 bytes.
TRAILER - REGISTRO FINAL
999-999
Indica fim do arquivo. Formato: Numérico de 1 byte – Constante zero

TVAT - Interface texto V.37