verso 4.

Modelo de Integrao com o Mdulo PDV ( Frente de Loja )

1. 2. 3.

Soluo - Host Vidalink ........................................................................................................ 2 Transferncia de arquivos - Host Vidalink e PDV ............................................................. 3 Layouts dos arquivos de transferncia ............................................................................... 5 Teste de Atividade ................................................................................................................ 5 Consulta ................................................................................................................................ 6 Venda................................................................................................................................... 10

Rua Amazonas, 439 -2and. - So Caetano do Sul - SP - CEP: 09520-070 Tel.: (11) 4225-9090 Fax: (11) 4225-9091 www.vidalink.com.br

verso 4.0

1. Soluo - Host Vidalink

PBM Vidalink Farmcia

TCP/IP Internet, X25, etc

Fluxo Operacional 1 2 3 4
Solicitao do No.Autorizao ( Cotao ) No.Autorizao transportado pelo conveniado at o PDV No.Autorizao digitado no sistema do PDV que gera um arquivo de solicitao dos produtos autorizados na pasta de transferncia de dados O Host Vidalink l o arquivo de solicitao e aps consultar o PBM Vidalink retorna os produtos autorizados na pasta de resposta. Aps a confirmao da venda o PDV gera o arquivo de fechamento e o Host Vidalink informa a venda para o PBM Vidalink Modem Host Vidalink Servidor de Loja

Pastas Compratilhadas

PDV-1\Envio PDV-1\Resposta PDV-2\Envio PDV-2\Resposta

Autorizador Vidalink

Balco

PDV - 2

ECF

PDV - 1

ECF

Esta soluo consiste em centralizar, no software Host Vidalink instalado na farmcia, as transaes de cotao ( pr-venda ) realizadas pelo Autorizador Vidalink e o fechamento da venda realizado pelo software de frente de loja ( PDV ) atravs de uma interface simples de comunicao via arquivo texto. O Host Vidalink tem a funo de concentrar as requisies enviadas pelo Autorizador e o PDV em uma mquina que possibilite o acesso rede TCP/IP ( Internet, X25, etc ), compartilhando este acesso entre as mquinas da farmcia. Pr-requisitos: 1.Rede Local ( Windows, Novell, etc ) na farmcia trafegando o protocolo TCP/IP. 2.Micro Balco - Mquina com o Windows 95b ( 32 bits ) ou superior para executar o Autorizador Vidalink. 3.Micro Servidor de Loja Mquina com o Windows 95b ( 32 bits ) ou superior, e um dispositivo de acesso a rede externa ( modem/speedy ) instalado para executar o Host Vidalink.

2
Rua Amazonas, 439 -2and. - So Caetano do Sul - SP - CEP: 09520-070 Tel.: (11) 4225-9090 Fax: (11) 4225-9091 www.vidalink.com.br

verso 4.0

2. Transferncia de arquivos - Host Vidalink e PDV

A comunicao entre o Host Vidalink e o software de frente de loja ( PDV ) da farmcia realizada atravs de arquivos no padro ASCII armazenados em pastas pr-configuradas no ambiente da loja, estas pastas so compartilhadas entre as aplicaes que trocam informaes necessrias para o fechamento da venda. Os layouts dos arquivos utilizados na comunicao entre o Host e o PDV esto descritos no item iii. layouts dos arquivos de transferncia. Ambiente.: rea de transferncia de arquivos.: Pasta para armazenamento das solicitaes do sistema PDV: Ex.: F:\PDV-1\Envio Pasta para armazenamento das respostas do sistema Vidalink: Ex.: F:\PDV-1\Resposta Tais pastas so compartilhadas entre ambas aplicaes. Operao.: 1. Todo o processo de cotao realizado atravs do Autorizador Vidalink que retorna o Nmero da Autorizao para cada transao Vidalink. 2. No incio da venda o sistema PDV da loja identifica que o cliente um conveniado Vidalink e inicia o processo de venda criando um arquivo de checagem de atividade na pasta pr-configurada para solicitaes ( Ex: F:\PDV-1\Envio\TesteDeAtividade.txt ). 3. Aps a checagem, o Nmero da Autorizao prviamente gerado no Autorizador Vidalink que est localizado no balco, digitado no sistema PDV. 4. O sistema PDV cria um arquivo de consulta ( Ex.: F:\PDV-1\Envio\Consulta.txt ), contendo o Nmero da Autorizao digitada no passo 3 e a solicitao dos produtos cotados no Autorizador Vidalink. Neste momento o sistema PDV entra em estado de espera, aguardando a resposta do Host Vidalink. 5. O Host Vidalink identifica a existncia de um arquivo na pasta configurada para solicitaes, l o contedo do arquivo, identifica o cdigo da solicitao, acessa a base de dados central da Vidalink e recupera os produtos cotados disponibilizando-os no arquivo armazenado na pasta configurada para respostas ( Ex.: F:\PDV1\Resposta\Consulta.txt ). 6. O sistema PDV identifica a existncia do arquivo de resposta, l o contedo do arquivo, carrega os produtos informados para uma Tabela PBM Vidalink no PDV e inicia o processo de fechamento da venda. A cada produto que efetivamente vendido realizada uma busca na Tabela PBM Vidalink, caso o produto exista nesta tabela o sistema PDV efetua a operao com o preo de venda registrado na tabela, respeitando as quantidades autorizadas pela Vidalink para o fechamento da venda. Caso o produto no exista na Tabela PBM Vidalink este vendido com o preo praticado na farmcia. 3
Rua Amazonas, 439 -2and. - So Caetano do Sul - SP - CEP: 09520-070 Tel.: (11) 4225-9090 Fax: (11) 4225-9091 www.vidalink.com.br

verso 4.0

7. Aps a entrada dos dados da venda o sistema PDV cria um arquivo na pasta de solicitao informando os produtos vendidos naquela operao ( Ex.: F:\PDV1\Envio\Venda.txt ). 8. O Host Vidalink identifica a existncia do arquivo, l o contedo, registra a informao de venda na base de dados central e cria um arquivo de resposta contendo os dados do comprovante de venda Vidalink a ser impresso no ECF ( Ex.: F:\PDV1\Resposta\Venda.txt ). 9. O sistema PDV identifica a existncia do arquivo de resposta, l o contedo e imprime os dados no fiscais do comprovante de venda Vidalink.

4
Rua Amazonas, 439 -2and. - So Caetano do Sul - SP - CEP: 09520-070 Tel.: (11) 4225-9090 Fax: (11) 4225-9091 www.vidalink.com.br

verso 4.0

3. Layouts dos arquivos de transferncia

Obs.: 1: As linhas coloridas em amarelo indicam as incluses/alteraes efetuadas no layout em relao a verso anterior, por exemplo, abaixo a indicao que o campo Seqncia foi alterado:
Sequncia Id. Funo

n4 n2

Nmero Sequencial da solicitao * Identificao da Funo Teste de Atividade

M 11

M.E M.E

Obs.: 2: As linhas coloridas em cinza indicam as excluses efetuadas no layout em relao a verso anterior, por exemplo, abaixo a indicao que o campo Id.Funo foi excludo:
Sequncia Id. Funo

n4 n2

Nmero Sequencial da solicitao * Identificao da Funo Teste de Atividade

M 11

M.E M.E

Teste de Atividade
Campo
Sequncia Id. Funo

Transao enviada para o Host Vidalink para verificar se o mesmo est ativo. Atributo n4 n2 an2 Descrio Nmero Sequencial da solicitao * Identificao da Funo Teste de Atividade Cdigo de Resposta da execuo: (OK ou ER ) Farm...PBM M 11 PBM...Farm M.E M.E M

Cdigo de Resposta

Exemplo do Teste de Atividade: Envio F:\PDV-1\Envio\TesteDeAtividade.txt

000111

Resposta F:\PDV-1\Resposta\TesteDeAtividade.txt
000111OK

5
Rua Amazonas, 439 -2and. - So Caetano do Sul - SP - CEP: 09520-070 Tel.: (11) 4225-9090 Fax: (11) 4225-9091 www.vidalink.com.br

verso 4.0

Consulta
Transao enviada para o Host Vidalink com a finalidade de recuperar as informaes ( Qtde, PMC, Preo com Desconto, etc ) dos produtos anteriormente cotados no Autorizador Vidalink. Atributo n4 n2 n12 an2 an40 n12 n14 an8 an30 an40 an1 Descrio Nmero Sequencial da solicitao * Identificao da Funo Consulta Nmero da Autorizao Cdigo de Resposta da execuo: (OK ou ER ) Mensagem do erro ocorrido quando o Cdigo de Resposta for igual a ER Nmero da Autorizao CNPJ do Convnio para o qual foi realizada a cotao. Plano do Convnio para o qual foi realizada a cotao. Cdigo do Conveniado ( No. Carto ) Nome do Conveniado Tipo da Autorizao: 0 Vista ( PBM ) 1 Receber ( Vidalink Aberto) 2 Receber ( Convnio Fechado ) 3 Receber ( Convnio Aberto ) 4 Receber ( Vidalink Fechado) * Explicao detalhada abaixo
2 linha Resposta informado os seguintes dados para cada produto autorizado: EAN Qtde PMC
a

Campo
Seqncia Id. Funo Autorizao Cdigo de Resposta Mensagem

Farm...PBM M 12 M -

PBM...Farm M.E M.E M M M M M M M M

Autorizao CNPJ do Convnio Plano do Convnio Cd. Conveniado Nome Conveniado Tipo de Autorizao

n13 n2 n7

Cdigo de Barra do Produto Qtde. Autorizada do Produto PMC Preo Mximo ao Consumidor, unitrio em centavos

M M M

6
Rua Amazonas, 439 -2and. - So Caetano do Sul - SP - CEP: 09520-070 Tel.: (11) 4225-9090 Fax: (11) 4225-9091 www.vidalink.com.br

verso 4.0
Campo
Preo de Venda

Atributo n7

Descrio Preo de Venda Valor de Venda da Farmcia ( Preo Cliente A VISTA + Preo Cliente Receber + Subsdio + Reembolso ). Valor pelo qual incide os impostos, unitrio em centavos Preo Cliente A VISTA Valor de Venda ao Consumidor para pagamento VISTA, unitrio em centavos Preo Cliente RECEBER Valor de Venda ao Consumidor com pagamento RECEBER, unitrio em centavos Valor do Subsdio Valor Total Subsidiado pelo Convnio/Plano de Sade, unitrio em centavos Valor do Reembolso Valor de Reembolso ( Vidalink ) Farmcia pelos descontos concedidos na Lista Vidalink de Medicamentos, unitrio em centavos % de Reposio Percentual do Desconto Comercial concedido Farmcia na reposio do produto junto ao Laboratrio / Distribuidor. (dois ltimos dgitos a direita so aps a vrgula exemplo: 00100 = 1,00%) % Comisso Vidalink Reposio Percentual da Comisso Vidalink na reposio do produto. (dois ltimos dgitos a direita so aps a vrgula exemplo: 00100 = 1,00%)

Farm...PBM -

PBM...Farm M

Preo Cliente A Vista

n7

Preo Cliente Receber

n7

Subsdio

n7

Reembolso

n7

% Desconto Reposio

n5

% Comisso Vidalink Reposio

n5

* Tipo da Autorizao ( Explicao detalhada ) O objetivo desse campo informar o tipo de venda realizada deixando o fechamento de venda no caixa de forma automtica, direcionando a venda para convnio quando o contedo do campo for diferente de 0. 0 Vista ( PBM ) : Quando o contedo do campo for 0, isso significa que a venda deve ser fechada vista e o valor deve ser pago pelo cliente dessa forma, o valor deste pagamento indicado no campo Preo Cliente A Vista.

7
Rua Amazonas, 439 -2and. - So Caetano do Sul - SP - CEP: 09520-070 Tel.: (11) 4225-9090 Fax: (11) 4225-9091 www.vidalink.com.br

verso 4.0

RECEBER: Quando o contedo do campo for diferente de 0, isso significa que o pagamento daquela venda ser Receber, ou seja, ele no vai pagar nada no momento da compra. O objetivo agora que o sistema j obrigue o caixa a fechar a venda como convnio, afinal, a venda ser paga numa data futura. Os valores a serem debitados esto indicados no campo Preo Cliente RECEBER, caso a compra exceda o limite financeiro estabelecido pelo convnio, o pagamento ser efetuado vista pelo conveniado, neste caso, os valores excedentes esto registrados no campo Preo Cliente A Vista. 1 RECBER ( Vidalink Aberto ) : Quando o contedo for 1, significa que aquele valor deve ser atribudo para um convnio chamado VIDALINK, pois a Vidalink que estar reembolsando a farmcia posteriormente. Neste tipo Aberto, permitido a incluso de produtos no autorizados no mesmo cupom fiscal da autorizao. 2 RECEBER ( Convnio Fechado ) : Quando o contedo do campo for 2 , o valor da venda dever ser direcionado para um convnio especfico identificado no campo CNPJ do Convnio do arquivo de Consulta. O contedo 2 indica tambm que essa uma venda Fechada, ou seja, no permitido a incluso de produtos no autorizados no mesmo cupom fiscal sendo necessrio realizar outra venda para atender esses produtos. 3 RECEBER ( Convnio Aberto ) : Exatamente o mesmo caso citado acima (contedo 2) porm nesse caso a venda Aberta, ou seja, permitido a incluso de produtos no autorizados no mesmo cupom fiscal, porm, o pagamento dos produtos no autorizados dever ser realizada vista na hora da compra. 4 RECEBER ( Vidalink Fechado) : Exatamente o mesmo caso citado acima (contedo 1) porm nesse caso a venda Fechada, ou seja, no permitido a incluso de produtos no autorizados no mesmo cupom fiscal.

8
Rua Amazonas, 439 -2and. - So Caetano do Sul - SP - CEP: 09520-070 Tel.: (11) 4225-9090 Fax: (11) 4225-9091 www.vidalink.com.br

verso 4.0

Exemplo da Consulta:

Envio F:\PDV-1\Envio\Consulta.txt
000212000000501456

Resposta F:\PDV-1\Resposta\Consulta.txt
Tipo de Autorizao: 0
000212OK

Positiva
00000050145633431859000100AVPBM025551237 JOAO DA SILVA 0

= Vista ( PBM )

7891721000133010002641000199100019810000000000000000000100000000000 7896269900174010001650000099000007000000000000000000002900000000000

Tipo de Autorizao: 1

= RECEBER ( Vidalink Aberto )

JOSE DA SILVA 1

000212OK 00000050145603735193000117AVCNV0254451256837 7891721000133010002641000199100000000001981000000000000100000000000 7896269900174010001650000099000000000000700000000000002900000000000

Tipo de Autorizao: 2
000212OK

= RECEBER ( Convnio Fechado ) ( NO permite a incluso de produtos no autorizados no cupom fiscal )

00000050145660343219300013AVEMPF2544512568372 MARIA DA SILVA 2

7891721000133010002641000199100000000001981000000000000100000000000 7896269900174010001650000099000000000000700000000000002900000000000

Resposta F:\PDV-1\Resposta\Consulta.txt
000212ERAutorizacao Invalida 00000050145600000000000000

Negativa
0

9
Rua Amazonas, 439 -2and. - So Caetano do Sul - SP - CEP: 09520-070 Tel.: (11) 4225-9090 Fax: (11) 4225-9091 www.vidalink.com.br

verso 4.0

Venda
Transao enviada para o Host Vidalink com a finalidade de informar o fechamento da venda. Atributo n4 n2 n4 n6 n12 an2 an40 n7 n12 Descrio Nmero Sequencial da solicitao * Identificao da Funo Venda Nmero da Impressora Fiscal ( No. PDV ) Nmero do Cupom Fiscal Nmero da Autorizao Cdigo de Resposta da execuo: (OK ou ER ) Mensagem do erro ocorrido quando o Cdigo de Resposta for igual a ER Espao reservado. No considerar. Nmero Sequencial nico para cada transao. Esse o nmero da Autorizao. Farm...PBM M 13 M M M M M M M PBM...Farm M.E M.E -

Campo
Seqncia Id. Funo Impressora Fiscal Cupom Fiscal Autorizao Cdigo de Resposta Mensagem

Filler NSU 2a linha

Solicitao - informado os seguintes dados para cada produto vendido: EAN Qtde Preo

n13 n2 n7

Cdigo de Barra do Produto Qtde. Vendida do Produto Preo unitrio, em centavos ( j com os descontos aplicados, sem reembolso) Comprovante PBM Vidalink a ser impresso, o caracter @ indica o incio de uma nova linha, a linha pode ter no mximo 40 caracteres

M M M

Resposta Cupom Vidalink

Ans

Exemplo da Venda: Envio F:\PDV-1\Envio\Venda.txt

0003130001000123000000501456 789172100013301 789626990017401

Resposta F:\PDV-1\Resposta\Venda.txt
000313OK 000000501456 DEMONSTRATIVO PBM VIDALINK@No.Autorizacao.: 501456

10
Rua Amazonas, 439 -2and. - So Caetano do Sul - SP - CEP: 09520-070 Tel.: (11) 4225-9090 Fax: (11) 4225-9091 www.vidalink.com.br

verso 4.0
Observaes

* Nmero Sequencial da solicitao nmero utilizado para controle do software de frente de loja, caso este verifique se a sequncia do arquivo gerado na pasta de resposta, a mesma da pasta de envio.
Para atender as regras de negcio da Vidalink, as quais controlam limites de compra e quantidades autorizadas dos seus conveniados, o fechamento da venda deve ser informado para a Vidalink em tempo real. Para cada PDV deve ser criada uma pasta para compartilhamento dos arquivos de transferncia. Exemplo: para o primeiro PDV.: F:\PDV-1\Envio e F:\PDV-1\Resposta para o segundo PDV.: F:\PDV-2\Envio e F:\PDV-2\Resposta ... Aps a leitura dos arquivos de transferncia armazenados nas pastas compartilhadas, o mesmo deve ser excludo. O nome dos arquivos gerados para cada transao ( Teste de Atividade, Consulta e Venda ) fica a critrio do software de frente de loja. O mesmo nome utilizado no arquivo de envio, ser utilizado no arquivo de resposta.

Formatos apresentados Atributo Descrio a n s M ME Caracteres Alfabticos de A a Z e de a a z Caracteres Numricos de 0 a 9 Caracteres especiais Campo obrigatrio ( Mandatory ) Campo obrigatrio com o valor de retorno igual ao recebido ( Mandatory Echo )

11
Rua Amazonas, 439 -2and. - So Caetano do Sul - SP - CEP: 09520-070 Tel.: (11) 4225-9090 Fax: (11) 4225-9091 www.vidalink.com.br