Layout Integração de Redes_V10.0

Rua Cerqueira Csar, 481 - 3 andar - Centro Ribeiro Preto - SP - CEP: 14010-130 Fone: (16) 3512-4801 - Fax: (16) 3512-4803

1

PEDIDO ELETRNICO

REDES

Verso 10.0 Entire

Diretrizes para a Homologao de Troca de Arquivos entre Laboratrio e Rede*

* o processo de homologao deve ser feito por projeto.


2

NDICE

1. TRANSMISSO DE ARQUIVOS ................................................................................................................................. 3

1.1. FTP ............................................................................................................................................................................ 3 1.1.1. Arquivo de Pedido ............................................................................................................................................. 3 1.1.2. Arquivo de Retorno ............................................................................................................................................ 3

1.2. WEB SERVICE (ETPENVIA) ......................................................................................................................................... 4 1.2.1. Funcionamento .................................................................................................................................................. 4

1.2. PERIODICIDADE .......................................................................................................................................................... 4 1.3. AMBIENTE .................................................................................................................................................................. 4

2. DEFINIES DOS ARQUIVOS .................................................................................................................................. 5

3. REQUISITOS PARA IMPLANTAO ...................................................................................................................... 5

3.1. REA DE FTP .......................................................................................................................................................... 5 3.1.1. Saida .................................................................................................................................................................. 5 3.1.2. Entrada .............................................................................................................................................................. 5

3.2. POLTICA DE ACESSOS ................................................................................................................................................ 6 3.3. PROCESSO DE ENVIO E BUSCA DOS ARQUIVOS NA REA ........................................................................................... 6

4. NOMENCLATURA DOS ARQUIVOS ........................................................................................................................ 6

4.1. ARQUIVO DE ENVIO .PED ....................................................................................................................................... 6 4.2. ARQUIVO DE RETORNO .RET .................................................................................................................................. 7

5. LAYOUT DOS ARQUIVOS .......................................................................................................................................... 7

5.1. LAYOUT DE ARQUIVOS DE PEDIDOS ........................................................................................................................... 7 5.1.1. Header ............................................................................................................................................................... 7 5.1.2. Detalhe............................................................................................................................................................... 8 5.1.3. Distribuidores .................................................................................................................................................... 8 5.1.4. Trailer ................................................................................................................................................................ 8 5.2. Arquivo de Pedido Simples ................................................................................................................................... 9 5.3. Arquivo de Pedido Composto ............................................................................................................................... 9

6.1. ARQUIVO DE RETORNO .............................................................................................................................................. 9 6.1.1. Cabealho .......................................................................................................................................................... 9 6.1.2. Cabealhos de Pedido ..................................................................................................................................... 10 6.1.3. Produtos........................................................................................................................................................... 10 6.1.4. Parcelas ........................................................................................................................................................... 10 6.1.5. Finalizador Pedido .......................................................................................................................................... 11 6.1.6. Finalizador ...................................................................................................................................................... 11

7. PROCESSO ................................................................................................................................................................... 12

7.1. OBSERVAES.......................................................................................................................................................... 13

8. CONTATOS .................................................................................................................................................................. 14


3

1. TRANSMISSO DE ARQUIVOS

A transmisso dos arquivos poder ser feita de duas formas, FTP ou Web Service.

1.1. FTP

A troca dos arquivos eletrnicos ser efetuada atravs do FTP da Rede para o FTP

da Entire, onde a mesma a responsvel pelo laboratrio.

Cada Rede que utilizar este modelo dever fornecer um endereo IP, usurio e

senha para conexo. A estrutura definida para o diretrio apresentada no captulo

3 - Requisitos para Implantao.

1.1.1. Arquivo de Pedido

A Rede dever enviar os arquivos de pedido na pasta ENVIO (ou Pedidos de

acordo com o combinado) do endereo especificado.

Os arquivos de pedido somente sero disponibilizados no endereo de rede

especificado aps serem totalmente gerados, sempre utilizando a extenso .PED.

1.1.2. Arquivo de Retorno

A Rede dever buscar os arquivos de retorno na pasta RETORNO do endereo

especificado.

Os arquivos de retorno somente podero ser disponibilizados no endereo de rede

especificado aps serem totalmente gerados, sempre utilizando a extenso .RET.


4

1.2. Web Service (etpEnvia)

A troca dos arquivos eletrnicos ser feita atravs de um web service chamado de

etpEnvia, que fornecido pela prpria Entire mediante uma solicitao prvia feita pela

Rede.

1.2.1. Funcionamento

O etpEnvia tem a funo de transmitir arquivos entre Entire e Rede, onde na Rede

instalado um aplicativo que uma vez parametrizado busca e envia arquivos

(extenso configurvel) de tempo em tempo (intervalo configurvel), tendo a opo

de armazenar os arquivos trafegados em uma pasta de backup, tornando uma

segurana a mais para Rede.

Caso a Rede opte por esta opo, ela deve solicitar o manual e o aplicativo com

antecedncia Entire. Lembrando que esta opo descartaria a opo do FTP.

1.2. Periodicidade

A Rede dever, em intervalos mximos de 15 minutos (ou um tempo mais especifico

da Rede), acessar a pasta de Retorno, no endereo FTP especificado, para verificar

a existncia de novos arquivos de pedido. Logo em seguida dever disponibilizar na

pasta de Envio, no mesmo FTP, os arquivos de pedido (.PED) devidamente

gerados.

Os arquivos de retorno devero ser processados no mesmo dia respeitando o

horrio limite de rota / roteiro da Rede.

1.3. Ambiente

A troca eletrnica de arquivos, inicialmente, ser realizada em ambiente de testes

com cpias dos pedidos reais. O processo somente entrar em ambiente de

produo (faturamento real) aps a realizao de todos os testes.


5

Os arquivos validados (arquivos finais de teste) que possibilitaram a homologao

do processo junto ao laboratrio devero ser enviados por e-mail, conforme contatos

apresentados neste documento, visando formalizar a finalizao da homologao de

troca de arquivos.

2. DEFINIES DOS ARQUIVOS

Os arquivos de pedido e retorno devero estar no formato texto (ANSI).

Os arquivos de pedido e retorno devero possuir um cabealho (Header) e um

rodap (Trailer) indicando incio e trmino do arquivo, respectivamente.

Todos os espaos em branco devem ser preenchidos com o nmero zero quando

forem do tipo inteiro. Essa regra vlida para todos os arquivos (Pedido e Retorno).

3. REQUISITOS PARA IMPLANTAO

3.1. rea de FTP

A Rede dever fornecer um diretrio FTP para troca de arquivos sob a seguinte estrutura:

Cada uma das pastas ser utilizada para troca de diferentes tipos de arquivos, conforme abaixo:

3.1.1. Saida

Todos os arquivos de pedidos sero gravados nesta pasta conforme nome

especificado no item 4.1.1.

3.1.2. Entrada

Todos os arquivos de retorno e devero ser gravados nesta pasta seguindo

especificao de nome conforme especificado nos itens 4.2.1 e 4.3.1.


6

3.2. Poltica de Acessos

O Laboratrio/Entire dever ter acesso para leitura / gravao (Read / Write) nas

pastas ENTRADA e SAIDA.

3.3. Processo de Envio e Busca dos Arquivos na rea

Quando o laboratrio envia um arquivo de retorno (.RET) para a pasta ENTRADA, a

Rede passa a ser responsvel por seu recorte e processamento. Cabe, portanto, a

Rede verificar freqentemente a existncia de arquivos de envio de pedidos,

conforme item 1.3 acima.

Quando a Rede envia um arquivo de pedido (.PED) para a pasta SAIDA, o

laboratrio fica responsvel por verificar a existncia do arquivo, bem como por

recort-lo e process-lo de acordo com as mesmas diretrizes de tempo

apresentadas neste documento.

4. Nomenclatura dos arquivos

4.1. Arquivo de Envio .PED

XXX00000000000000_ZZZZZZZZZZZZZZZ.PED

Descrio Contedo

XXX

Identificador de Arquivo

Tabela de nomenclatura abaixo.

00000000000000 CNPJ do solicitante

ZZZZZZZZZZZZZZZ

Nmero do pedido gerado pelo cliente ou seqencial nico escolhido pela rede (caso a rede utilize arquivos de pedidos composto)

PED Extenso do Arquivo

Nomenclaturas dos Laboratrios

Laboratrio Nomenclatura

APSEN APS

BOEHRINGER BOE

GSK GSK

SANDOZ SDZ

PFIZER PFI

NOVARTIS NOV


7

4.2. Arquivo de Retorno .RET

XXX00000000000000_ZZZZZZZZZZZZZZZ.RET

Descrio Contedo

XXX

Identificador de Arquivo

Tabela de nomenclatura acima (4.1)

00000000000000 CNPJ do Centro do solicitante

ZZZZZZZZZZZZZZZ Nmero do pedido gerado pelo cliente

RET Extenso do Arquivo

5. LAYOUT DOS ARQUIVOS

Os campos destacados com o smbolo * devem ser alinhados direita e completados

com nmeros zero esquerda, at que toda a extenso do campo esteja preenchida.

5.1. Layout de Arquivos de Pedidos

5.1.1. Header

Descrio do Campo Posio Formato Observao Obrig.

Registro 01 S

Tipo do registro

1 9(01) Fixo 1 - Header S

CNPJ Solicitante

2 X(14) CNPJ Solicitante - Preencher com zero a esquerda.

S

Nmero do pedido

16 X(12) Nmero do Pedido no Cliente - Nmero gerado pelo Cliente Medley.

S

Data do Pedido

28 9(08) Data em que o pedido foi efetuado (DDMMAAAA)

S

Tipo do Retorno

36 X(01) C - Cdigo D - Descrio Forma de apresentao do motivo no retorno do pedido. Cdigo. - O motivo do retorno pode ser em cdigo ou descrio.

S

Apontador Condio Comercial

37 9(05) (Apontador) da condio comercial -

Apontador negociado entre o cliente

e a Indstria

S

N. Pedido 42 X(15) Nmero do pedido para aparea na nota fiscal.

N


8

5.1.2. Detalhe


Registro 02

Tipo do registro

1 9(01) Fixo 2 Detalhe S

Cdigo do Produto

2 9(13) Cdigo EAN do produto - Preencher com zero a esquerda.

S

Quantidade 15 9(08) Quantidade do produto solicitado S

5.1.3. Distribuidores


Registro 03

Tipo do registro

1 9(01) Fixo 3 Distribuidores S

Cdigo do Distribuidor

2 9(14) CNPJ da OL de Faturamento S

Prioridade 16 9(2) Prioridade de atendimento S

5.1.4. Trailer

Descrio do Campo

Posio Formato Observao Obrig.

Registro 04

Tipo do registro

1 9(01) Fixo 4 - Trailer S

Quantidade de Itens

2 9(05) Quantidade de Itens solicitados S

Quantidade de Unidades

7 9(10) Quantidade de Unidades solicitadas S

Quantidade de Linhas

17 9(05) Quantidade de linhas no arquivo S


9

5.2. Arquivo de Pedido Simples

So os pedidos onde para cada arquivo de pedido enviado pela rede, existe somente um pedido dentro do arquivo, sendo a relao de pedido e arquivo um para um. Esta relao deve ser escolhida no momento da integrao e acordada entre o pessoal da Entire / Laboratrio e o consultor responsvel pela rede. Caso a rede opte por trabalhar utilizando arquivos de pedidos simples, o layout dos arquivos deve ser exatamente como descrito acima, contendo somente um pedido dentro do arquivo enviado.

5.3. Arquivo de Pedido Composto

So os pedidos onde para cada arquivo de pedido enviado pela rede, existe um ou mais pedidos dentro do arquivo, sendo a relao de pedido e arquivo um para n. Esta relao deve ser escolhida no momento da integrao e acordada entre o pessoal da Entire / Laboratrio e o consultor responsvel pela rede. Caso a rede opte por trabalhar utilizando arquivos de pedidos compostos, o layout do arquivo deve ser o demonstrado acima, contendo um ou mais pedidos dentro do arquivo, e para cada pedido repetindo o conjunto de linhas de tipo 1 at as linhas de tipo 4. Obs.1.: O nmero do pedido do cliente (terceiro campo do registro do tipo 1) muito importante caso a rede opte por esse tipo de pedido (composto), pois ele que identificar o pedido no arquivo de retorno. Obs.2.: O arquivo de retorno da rede, ficara retido at todos os pedidos enviados pela rede terem seu processo terminado, ou seja, at que todos os pedidos dentro do arquivo sejam atendidos, no atendidos ou cancelados.

6.1. Arquivo de Retorno

6.1.1. Cabealho

Registro Cabealho

Descrio Formato Posio

Observao Obrigatrio

Identificador do

tipo de registro 1 C (1) 1 Identificador da linha do registro. Fixo "1" S

CNPJ do cliente C (14) 2 CNPJ do solicitante S

Nmero do pedido do cliente

N (12) 16 Nmero do pedido no cliente S

Identificador de

rejeio do pedido (S ou N)

C (1) 28 Caso o pedido todo tenha sido rejeitado ou no.

S

Descrio do

motivo da rejeio

do pedido C (50) 29

Motivo da rejeio caso o identificador seja S. Conforme tabela abaixo.

N


10

6.1.2. Cabealhos de Pedido

Registro Cabealho de Pedidos

Descrio Formato Posio Observao Obrigatrio

Identificador do tipo de registro 2

C (1) 1 Identificador da linha do registro. Fixo "2" S

CNPJ do Distribuidor C (14)

2 CNPJ do distribuidor que recebeu o pedido para faturamento

S

Nmero do pedido gerado pelo distribuidor

C (12) 16 Nmero do pedido no distribuidor. N

Numero do Pedido gerado pela Laboratrio

C (12) 28 Nmero do pedido no portal do laboratrio S

Cdigo da promoo da

distribuidora C (10) 40 Se utilizado apontador envia o cdigo. N

6.1.3. Produtos

Registro Produto Pedido


Identificador do registro 3


Cdigo EAN do

Produto C (13) 2 Cdigo EAN do produto faturado S

Quantidade

atendida N (08) 15 Quantidade faturada S

Percentual de desconto dado pelo fornecedor

N (3,2) 23 Percentual de desconto para o item S

Quantidade No

atendida N (08) 28 Quantidade no faturada S

Motivo do no

atendimento C (50) 36 Se a quantidade no faturada for maior que zero informa o motivo. Conforme tabela abaixo.

N

6.1.4. Parcelas

Registro Parcelas do Pedido




Prazo Parcelado (S ou N)

C (1) 2 Se o prazo escolhido parcelado ou no N

Nmero de parcelas N (5)

3 Se for parcelado o nmero de parcelas maior que 1, seno igual a 1.

N


11

Nmero dias da primeira ou nica parcela

N (5) 8 Informa o nmero de dias at a primeira ou nica parcela do prazo.

N

Nmero de dias das parcelas C (20)

13 Parcelas em dias divididas por barra Ex.: "30/60/90"

N

6.1.5. Finalizador Pedido

Registro Finalizador Pedido


Identificador do

registro 5 C (1) 1 Identificador da linha do registro. Fixo "5" S

Quantidade total de itens (unidades) atendidos

N (08) 2 Soma dos itens faturados S

Quantidade total de itens (unid.) no atendidos

N (08) 10 Soma dos itens no faturados S

6.1.6. Finalizador

Registro Finalizador




Quantidade total de pedidos N (5)

2 Nmero de pedidos gerados para cada pedido da Grande Rede

S

Quantidade de linhas do arquivo de retorno

N (5) 7 Soma total de linhas do arquivo de retorno (incluindo a ultima)

S

Cdigo de

retorno da rede Descrio da Ocorrncia

0 Produto OK

1 Cliente com Problemas Cadastrais no distribuidor

2 Falta de Limite de Credito

3 Nao alcancou valor minimo

4 Layout incorreto

5 Produto nao cadastrado / desativado / EAN incorreto no distribuidor

6 Falta de estoque

7 Estoque insuficiente

8 Cliente sem alvara / vencido

9 Cliente nao Localizado no distribuidor

10 Produto bloqueado no distribuidor


12

11 Produto nao cadastrado no Projeto

13 Cliente bloqueado/Inativo no distribuidor

14 Cliente Inativo no Projeto

15 Cliente nao Localizado no Projeto

16 Condicao Comercial esta com periodo de validade expirado

17 Condicao Comercial esta inativa

18 Distribuidor Inativo no projeto

19 Distribuidor nao Localizado no projeto

20 Nao foram encontradas Condicoes Comerciais para o Distribuidor

21 Nao foram encontrados Condicoes Comerciais para o Produto

22 Nao foram encontrados Condicoes Comerciais para o Cliente

23 Produto Inativo no Projeto

99 Motivo nao especificado

7. PROCESSO


13

7.1. Observaes

* A Camada de Pedidos em tempo pr-determinado conecta no FTP

disponibilizado, e move todos os arquivos de pedido que esto dentro da pasta

SAIDA para uma pasta nos servidores da camada, e logo depois grava para sua

base de dados.

* A camada de retorno em tempo pr-determinado conecta no FTP disponibilizado,

abre e salva na pasta ENTRADA os pedidos de retorno, conforme layout

especificado.

Camada de Pedidos Laboratrio

Envio

Retorno

rea de FTP

4.1 4.2


14

8. CONTATOS

Julio - [email protected]

Amauri [email protected]

Telefone para contato: (16) 3512-4801

Documents

Layout Integração de Redes_V10.0