Mudanças entre as edições de "Web Service do DB"

Edição atual tal como às 11h12min de 14 de março de 2023

ATENÇÃO! ESTÁ PÁGINA FOI MIGRADA PARA A WIKI NOVA E NÃO VAI SER MAIS ATUALIZADA AQUI, PARA CONFERIR: http://wiki.uniware.net.br/pt-br/unilab/interfaceamentos/DB

Contato no Laboratório DB (versão 2)

Arthur Brugnari

IT Coordinator

Fone: +55 41 3299-3401 . Cel:+55 41 9890-1400

arthur.brugnari@dbdiagnosticos.com.br

Marcos Fernando Maichaki

Support Analyst

Fone: +55 41 3299-3413

Cel: +55 41 9890-0405

marcos.maichaki@dbdiagnosticos.com.br

Vitor AR informática

11 4193 8884 ** até hoje nunca atendeu neste número apesar de ser o número que o wagner da AR nos passou.

Wagner Gonçalves

11-7701-0830

107*55110 nextel

wagner@ar.inf.br

AR Informática

11-4193-8617

11-4193-8885

Contato no DB - Web Service:

Nome: Thiago Trincas

Função: Analista de Implantação

Telefone: +55 41 3299-3400

E-Mail: thiago.trincas@dbdiagnosticos.com.br

Endereço: BR 376, 11313 . São José dos Pinhais . PR . 83010-500

Pré Requisitos e Ativação de Interface

• O laboratório apoiado deve ter negociado com o DB quais exames serão interfaceados e seus valores.
• Solicitar ao DB seu código e chave de interfaceamento com o Unilab.
• Solicitar ao DB o arquivo de modelo de exames. (Quando o DB ou cliente nos envia esta tabela, anexamos o XML ao: \\svw-uniware2\SUPORTE\_Instalacao_UNILAB\Uniwarew\Unilabw\Apoio\defs\DB2)

OBS: TAMANHO DA ETIQUETA WEB SERVICE DB: 50mm X 25mm.

Após cliente passar ao suporte as informações necessárias descritas acima, é necessário acessar o Unilab e ir em: "Cadastro>Laboratórios" e incluir o laboratório Diagnósticos do Brasil como mostra a imagem abaixo:

• Nome do laboratório de apoio;
• Interfaceado - Informe 'SIM';
• Padrão de Interface - Informe a opção 'Laboratório DB (versão 2)';
• Código no Lab. Apoio - Este código é fornecido pelo DB (Possui 10 (dez) posições).
• Chave - Contem a chave do Laboratório de Apoio
• Prefixo Arq - Contém o prefixo do arquivo
• Utiliza Web Service - Caso o laboratório utilize envio de pedidos via web service, solicitar para o DB, além do código e chave, também a URL WS.

Obs.: Os pontos vermelhos são obrigatórios preenchimentos. Apesar de ter dois tipos de padrão de interface para o DB, sempre utilize o DB2.

Importação de Arquivo de Modelos

Depois que o DB enviar o arquivo de modelos (por meio do cliente ou diretamente para nós), coloque o arquivo dentro da pasta "Unilabw>Apoio>Defs>DB2" dentro da Uniwarew no servidor do cliente. Clique na aba do meio de "arquivos" e selecione o arquivo para importação. Quando terminar, apenas confirme. Já está ativo o interfaceamento, agora é necessário configurar aos exames.

*Obs.: Os arquivos mais recentes que o DB enviam para a Uniware, ficam armazenados em: \\svw-uniware2\suporte\_Instalacao_UNILAB\Uniwarew\Unilabw\Apoio\defs\DB2 (Linux: smb://svw-uniware2/suporte/_Instalacao_UNILAB/Uniwarew/Unilabw/Apoio/defs/DB2/)

São dois arquivos importados para o cliente, o EXAMES_DB_[data].xml e o RegiaoColeta.

Tratamento "Regiao de Coleta"

O região de coleta, o DB manda em XML, porém é necessário fazer um pequeno ajuste no arquivo antes de importar no cliente.

Deve-se abrir o RegiaoColeta.XML, salvar como .CSV e marcar as seguintes opções:

Arquivo XML (Como baixar)

O link direto para fazer download do arquivo é: https://wsg.diagnosticosdobrasil.com.br/portal/Uploaded/TabelaExames/TABELAEXAMES_DB.zip

Após baixar o arquivo "TABELAEXAMES_DB.zip", descompacte o mesmo e exclua todos os arquivos *.csv, pegue o arquivo XML e envia para dentro da pasta DB2 para realizar a importação.

Pasta para gravar os arquivos mais recentes: \\uniware-files1\suporte\_Instalacao_UNILAB\Uniwarew\Unilabw\Apoio\defs\DB2

Imagem de como baixar o arquivo do site do DB:

Configurações de exames

Em "Cadastros > Exames > Exames", selecionar o exame que se quer interfacear e alterá-lo, ou se o exame não estiver cadastrado, pedir ao cliente cadastrá-lo.

Aba Geral:

No campo Laboratório de apoio, informar o laboratório DB (versão 2).

No campo "Cód. Exam. (F2)" - com F2, selecionar o exame no DB. (Ao selecionar o exame os códigos do exame, MTBI, e a vigência são preenchidos conforme as informações constantes no arquivo de modelos.)

O Campo "Int. Ativo": Marcar como SIM que representa que aquele exame está pronto para ser interfaceado.

Quando o exame ficar marcado como ativado, a data da ativação será a de hoje e por segurança só serão incluídos em lotes de interfaceamento os exames que forem incluídos em um pedido um dia depois do dia em que o interfaceamento do exame foi ativado.

O Laboratório DB NÃO executa exames configurados como amostra adicional. Caso seja necessário deverá ser configurado um exame para cada amostra.

Aba Configuração:

• Apertar o botão F3 ou clique no botão de "Listas de Variáveis" e configure as variáveis do DB2.

Para copiar a variável do DB2, basta clicar nas variáveis em AZUL (ESTÁ DENOMINADA COMO NOME), que irá copiá-la para a área de transferência (Ctrl + C).

• O valor de referencia, na parte inferior direita possui o mesmo padrão, basta clicar no texto que será copiado

• NOTA: Dentro da lista de variaveis existe o valor de referencia (descrição), e a variável VR_RES1, então continuará sendo possível o cliente copiar dentro da lista de variável o texto do valor de referencia e colar dentro do Unilab como fazia antes ou importá-lo como uma variável (Na configuração de exame, ao invés da coluna ser do tipo "Valor de Referencia", mude ela para "Resultado texto" do tipo "Texto Livre" e cole a variável de valor de referencia para que seja importado junto com o resultado no retorno. As duas formas funcionarão.

• NOTA 2: O valor de referência na tela de variáveis está alinhado pois a fonte é monoespaçada (todos os caracteres possuem o mesmo tamanho), para ficar alinhado no exame, terá que usar uma fonte monoespaçada tambem, caso contrário, ira desalinhar. Exemplo de fontes monoespaçadas: BatangChe, Bitstream Vera Sans Mono, Consolas, Courier New, DejaVu Sans Mono, Liberation Mono, entre outras.

Caso tenha mais dúvidas sobre configuração de exames, ver documentação do Hermes Pardini (Interfaceamento_Hermes_Pardini). A única diferença que tem entre as interfaces do Unilab, é a tela de listas de variáveis, a função são exatamente todas iguais, o que muda é o designer.

Interface Envio/Retorno

Envio via Web Service:

• Ao enviar um pedido que possua exame(s) que são interfaceados com DB2 Web Service, estes exames interfaceados serão enviados para o DB no ato da confirmação do pedido.

Etiquetas no Envio via webservice

É necessário configurar um modelo de etiqueta com as informações necessárias com o mesmo tamanho da etiqueta que está na etiquetadora. Porém se houver comunicação com o DB irá ser impresso a etiqueta que o DB retornar, caso haja alguma recoleta ou o exame não foi enviado via WS poderá imprimir a etiqueta que foi configurada.

Defini-la como padrão para o DB em Cadastros > Configurações > Etiqueta MTBI.

ETIQUETA WS DO DB FUNCIONA SOMENTE COM ZEBRA, POIS NA INTERFACE ELES MANDAM NA LINGUAGEM EPL.

Mesmo depois de impresso uma vez a etiqueta que veio pela interface do DB, o cliente sempre conseguirá reimprimir as etiquetas com as informações que o DB mandou na primeira.

Retorno via Web Service:

• Basta ir no menu: Movimentação > Interfaceamento > Laboratório de Apoio.
• Clicar em Resultado
• Selecionar a forma que deseja importar o resultado:

- Pedido (Importação individual por pedido) - Período de liberação no DB2 (Importa os exames que foram liberados no DB, dentro do período que foi preenchido. (Intervalo máximo de 10 dias entre o período inicial e o período final)) - Importação manual (Onde o laboratório possui o arquivo de importação disponibilizado pelo DB. Basta selecionar esta opção, clicar em "Importa", selecionar o arquivo e clicar em "Abrir")

Envio Manual:

• Após ter os exames configurados e pedidos incluídos e impresso as etiquetas pelo sistema referentes a esses exames deverá seguir os passos (Obs.: Os exames interfaceados necessitam estar triados para irem ao lote):
• Ir em: "Movimentação > Interfaceamento > Laboratório de Apoio". Escolher o DB2.

As informações que são enviadas para o DB (versão 2) no arquivo de envio estão disponíveis no layout de envio em: "D:\CVS\light\documentacao\InterfaceLaboratórios\DB\novolayout\protocolo_padrao_DB_v 1_5_apoiado.pdf"

• Clicar em incluir, caso você tenha pedidos do Álvaro antigos, ele exibirá uma mensagem avisando e perguntando deseja gerar lotes Antigos.
• Caso escolha SIM: Irá aparecer para incluir lotes dos pedidos antigos.
• Caso escolha NÃO: Irá aparecer para incluir lotes dos pedidos novos.

• Se necessário preencher as informações adicionais clicando no lote, e no bota Info. Adic. em seguida.

• Após incluir é só clicar em GERAR ARQUIVO e enviar para o sistema do DB (esta questão é de responsabilidade do DB explicar ao cliente como funciona).

Obs.: Caso tenha dúvidas sobre informação adicional, veja documentação do Alvaro. http://svw-uniware2/wiki/index.php/Interfaceamento_com_%C3%81lvaro#Interface_Envio.2FRetorno

Os arquivos de lote são salvos sempre em uma pasta padrão dentro do Unilabw do cliente, se clicar com o botão auxiliar do mouse dentro da tela de interfaceamento, aparece um botão de "Abrir pasta", quando clicar nela, abrirá a pasta onde todos os arquivos de lote do DB estão, seleciona do último gerado. O Nome do arquivo na pasta é exatamente o mesmo que está na tela do Unilab.

É este o arquivo de lote que será enviado ao DB.

Retorno

• Já com o arquivo de retorno (esta questão é de responsabilidade do DB explicar ao cliente como funciona), deverá ir em: "Movimentação > Interfaceamento > Laboratório de Apoio". Escolher o DB2.
• É só clicar em RESULTADO e escolher o arquivo de retorno.

• O Unilab irá mostrar quantos resultados serão importados para que o cliente possa confirmar.

Na importação do retorno do DB (versão 2) várias verificações são feitas para garantir a integridade do resultado importado pela interface. Se algum resultado enviado pelo DB tem alguma divergência com as informações configuradas no Unilab, o resultado divergente não é importado e a causa é relatada no final da importação.

Cancelamento via Web Service

Agora é possível realizar o cancelamento dos exames no DB via Web Service diretamente pelo Unilab a partir da versão 5.00.000.

Basta ir na tela de pedidos, clicar no pedido desejado com o botão direito, e ir em "Comunicar com web service".

Em seguida selecionar a opção "Cancela", e irá exibir os exames que foram enviados ao DB, e para cancelar algum, basta marcar o exame desejado, selecionar se deseja um cancelamento definitivo ou temporário, e clicar em Cancela.

Após o processo realizado, é possível verificar pela rastreabilidade que o exame foi cancelado.

Obs.: Não é possível cancelar exame que já possui resultado digitado no Laboratório de Apoio.

Erros do web services DB

A etiqueta que está sendo impressa é a do unilab e não a do DB ?

Verificar primeiramente se o cliente esta com a questão financeira em dia no DB, basta pedir para ele fazer login no site do DB se aparecer a mensagem "Login desabilitado por questão financeira".

Falha na comunicação com o web service do DB2, é uma falha na comunicação que faz o pedido aparecer no DB porem o mesmo não devolve a etiqueta para ser impressa, neste caso o problema é especifico do pedido e da comunicação do ws, então o pedido deve ter a etiqueta impressa pelo site do DB.

OBS: Quando dá falha na comunicação, os exames aparecem lá na geração de lote manual

________________________________________________________________________________________________________________________

Se ocorrer o seguinte erro:

É referente a um exame no pedido ter um código que esta desativado no apoio(o DB não utiliza mais), no caso tem que verificar qual o novo código correto e fazer o ajuste;