integracao vidalink host v4

verso 4.0

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

www.vidalink.com.br

MMooddeelloo ddee IInntteeggrraaoo ccoomm oo MMdduulloo PPDDVV(( FFrreennttee ddee LLoojjaa ))

1. Soluo - Host Vidalink ........................................................................................................ 22. Transferncia de arquivos - Host Vidalink e PDV ............................................................. 33. Layouts dos arquivos de transferncia............................................................................... 5

Teste de Atividade ................................................................................................................ 5Consulta ................................................................................................................................ 6Venda................................................................................................................................... 10

verso 4.0


www.vidalink.com.br

2

1. Soluo - Host Vidalink

TCP/IPInternet, X25, etc

HostVidalink

Balco PDV - 1 ECF

Vidalink

Modem

Servidor de Loja

PDV - 2 ECF

PBM

AutorizadorVidalink

Farmcia

PDV-1\EnvioPDV-1\Resposta

PDV-2\EnvioPDV-2\Resposta

PastasCompratilhadas

1

1

2

3

4

1 Solicitao do No.Autorizao ( Cotao )

2 No.Autorizao transportado pelo conveniadoat o PDV

3 No.Autorizao digitado no sistema do PDV quegera um arquivo de solicitao dos produtosautorizados na pasta de transferncia de dados

4 O Host Vidalink l o arquivo de solicitao e apsconsultar o PBM Vidalink retorna os produtosautorizados na pasta de resposta. Aps aconfirmao da venda o PDV gera o arquivo defechamento e o Host Vidalink informa a venda parao PBM Vidalink

Fluxo Operacional

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.

verso 4.0


www.vidalink.com.br

3

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\EnvioPasta 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:\PDV-1\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.

verso 4.0


www.vidalink.com.br

4

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:\PDV-1\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:\PDV-1\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.

verso 4.0


www.vidalink.com.br

5

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 n4 Nmero Sequencial da solicitao * M M.E

Id. Funo n2 Identificao da Funo Teste de Atividade

11 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:



11 M.E

Teste de Atividade

Transao enviada para o Host Vidalink para verificar se o mesmo est ativo.

Campo Atributo Descrio Farm...PBM PBM...Farm



11 M.E

Cdigo de Resposta

an2 Cdigo de Resposta da execuo:

(OK ou ER )

- M

Exemplo do Teste de Atividade:

Envio F:\PDV-1\Envio\TesteDeAtividade.txt

000111

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

000111OK

verso 4.0


www.vidalink.com.br

6

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.


Seqncia n4 Nmero Sequencial da solicitao * M M.E

Id. Funo n2 Identificao da Funo Consulta 12 M.E

Autorizao n12 Nmero da Autorizao M -

Cdigo de Resposta


(OK ou ER )

- M

Mensagem an40 Mensagem do erro ocorrido quando o Cdigo de Resposta for igual a ER

- M

Autorizao n12 Nmero da Autorizao - M

CNPJ do Convnio

n14 CNPJ do Convnio para o qual foi realizada a cotao.

- M

Plano do Convnio

an8 Plano do Convnio para o qual foi realizada a cotao.

- M

Cd. Conveniado

an30 Cdigo do Conveniado ( No. Carto ) - M

Nome Conveniado

an40 Nome do Conveniado - M

Tipo de Autorizao

an1 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

- M

2a linha

Resposta informado os seguintes dados para cada produto autorizado:

EAN n13 Cdigo de Barra do Produto - M

Qtde n2 Qtde. Autorizada do Produto - M

PMC n7 PMCPreo Mximo ao Consumidor, unitrio em centavos

- M

verso 4.0


www.vidalink.com.br

7


Preo de Venda

n7 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

- M

Preo Cliente A Vista

n7 Preo Cliente A VISTAValor de Venda ao Consumidor para pagamento VISTA, unitrio em centavos

- M

Preo Cliente Receber

n7 Preo Cliente RECEBERValor de Venda ao Consumidor com pagamento RECEBER, unitrio em centavos

- M

Subsdio n7 Valor do Subsdio

Valor Total Subsidiado pelo Convnio/Plano de Sade, unitrio em centavos

- M

Reembolso n7 Valor do ReembolsoValor de Reembolso ( Vidalink ) Farmcia pelos descontos concedidos na Lista Vidalink de Medicamentos, unitrio em centavos

- M

% Desconto Reposio

n5 % de ReposioPercentual 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%)

- M

% Comisso Vidalink -Reposio

n5 % Comisso Vidalink Reposio

Percentual da Comisso Vidalink na reposio do produto. (dois ltimos dgitos a direita so aps a vrgula exemplo: 00100 = 1,00%)

- M

* 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.

verso 4.0


www.vidalink.com.br

8

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.

verso 4.0


www.vidalink.com.br

9

Exemplo da Consulta:

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

000212000000501456

Resposta F:\PDV-1\Resposta\Consulta.txt Positiva

Tipo de Autorizao: 0 = Vista ( PBM )000212OK 00000050145633431859000100AVPBM025551237 JOAO DA SILVA 0

7891721000133010002641000199100019810000000000000000000100000000000

7896269900174010001650000099000007000000000000000000002900000000000

Tipo de Autorizao: 1 = RECEBER ( Vidalink Aberto )

000212OK 00000050145603735193000117AVCNV0254451256837 JOSE DA SILVA 1

7891721000133010002641000199100000000001981000000000000100000000000

7896269900174010001650000099000000000000700000000000002900000000000

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

000212OK 00000050145660343219300013AVEMPF2544512568372 MARIA DA SILVA 2

7891721000133010002641000199100000000001981000000000000100000000000

7896269900174010001650000099000000000000700000000000002900000000000

Resposta F:\PDV-1\Resposta\Consulta.txt Negativa

000212ERAutorizacao Invalida 00000050145600000000000000 0

verso 4.0


www.vidalink.com.br

10

Venda

Transao enviada para o Host Vidalink com a finalidade de informar o fechamento da venda.


Seqncia n4 Nmero Sequencial da solicitao * M M.E

Id. Funo n2 Identificao da Funo Venda 13 M.E

Impressora Fiscal

n4 Nmero da Impressora Fiscal ( No. PDV ) M -

Cupom Fiscal n6 Nmero do Cupom Fiscal M -

Autorizao n12 Nmero da Autorizao M

Cdigo de Resposta


(OK ou ER )

- M

Mensagem an40 Mensagem do erro ocorrido quando o Cdigo de Resposta for igual a ER

- M

Filler n7 Espao reservado. No considerar. - M

NSU n12 Nmero Sequencial nico para cada transao. Esse o nmero da Autorizao.

- M

2a linha

Solicitao - informado os seguintes dados para cada produto vendido:

EAN n13 Cdigo de Barra do Produto M -

Qtde n2 Qtde. Vendida do Produto M -

Preo n7 Preo unitrio, em centavos ( j com os descontos aplicados, sem reembolso)

M -

Resposta

Cupom Vidalink

Ans Comprovante PBM Vidalink a ser impresso, o caracter @ indica o incio de uma nova linha, a linha pode ter no mximo 40 caracteres

- M

Exemplo da Venda:

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

0003130001000123000000501456

789172100013301

789626990017401

Resposta F:\PDV-1\Resposta\Venda.txt

000313OK 000000501456

DEMONSTRATIVO PBM [email protected].: 501456

verso 4.0


www.vidalink.com.br

11

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 Caracteres Alfabticos de A a Z e de a a z

n Caracteres Numricos de 0 a 9

s Caracteres especiais

M Campo obrigatrio ( Mandatory )

ME Campo obrigatrio com o valor de retorno igual ao recebido ( Mandatory Echo )

integracao vidalink host v4

Documents