Ir para o final dos metadados
Ir para o início dos metadados

Você está vendo a versão antiga da página. Ver a versão atual.

Comparar com o atual View Version History

« Anterior Versão 7 Próxima »

Manual com objetivo de mostrar as instruções do passo a passo de como realizar a configuração para o bom funcionamento da integração via XML ou WEBSERVICE com laboratórios de Apoio.

Versão

Proprietário

Nota

Data

1.0

Rafael Carvalho

Criação de documento

24/05/2023

1.1

Rafael Carvalho

Conclusão do documento

30/05/2023

1.2

Rafael Carvalho

Inclusão Peculiaridades Pardini

26/01/2024

1.3

Rafael Carvalho

Inclusão parâmetro não importa referência

29/01/2024

Índice

Conceito da Integração com o Laboratório de Apoio

Compreende-se como Laboratório de Apoio, laboratório terceirizados que realizam exames de pacientes, oferecendo o serviço como apoio ao Laboratório para algum exame que não processa no laboratório ou de acordo com a necessidade de cada laboratório, possibilitando que seja feita integrações para que o laboratório consiga disponibilizar e ter via sistema os resultados das amostras, ou seja, realizar integração de envio de pedidos e retorno de resultados, via XML ou via WEB SERVICE.

Nesse caso, temos uma configuração onde é dinâmico e totalmente PERSONALIZÁVEL por cliente para usar o apoio desejado e configurar os exames que deseja enviar para cada apoio.

Sendo assim, abaixo estaremos mostrando como fazer uma configuração do cadastro de Apoio para posteriormente conseguir realizar a integração.

Nas telas, o sistema apresenta botões PADRÕES que serão utilizados para edição e manipulação dentro do sistema:

1 - Relatório: Gerar um relatório da Listagem de Cadastro do Apoio.

2 - Adicionar: Para incluir um novo registro.

3 - Outros Filtros (Gravar Ultima Pesquisa): Grava por máquina, os filtros que você faz no item “4”, ou seja, salva o último filtro que você fez e abre aquele filtro como padrão, sempre que entrar na tela específica.

4 - Limpar Filtros: Limpa todos os filtros que você faz no item “4” da tela.

5 - Menus para Filtro: Opções de Filtros e Ordenação dos campos clicando em cima das setas ⬆️ ⬇️ das respectivas colunas que deseja.

6 - Modificar/Alterar: Modifica/Altera informações do registro selecionado.

7 - Exclusão: Exclui um registro selecionado.

8 - Paginação: Muda a página para exibição de registros se houver mais de 1 página, podendo avançar/retornar 1 página, ou ir para a última/primeira página, respectivamente.

9 - Quantidade de Registros: Possibilidade de mudar a quantidade de registros exibido na tela.

10 - Histórico de Exclusão: Exibe em lista uma rastreabilidade de todos os registros deletados da tela específica.

Configuração do Apoio

Configuração para Envio de Exames

Para configurar o Apoio, devemos ir no Menu Cadastros > Apoio:

Feito isso, devemos abrir o cadastro do apoio desejado ou criar um novo.

Após abrir a tela para preenchimento de informações, devemos preencher os campos de cód. laboratório e senha laboratório (Esses dados o cliente deve preencher/disponibilizar para incluirmos no sistema, o laboratório de Apoio é quem deve fornecer esses dados ao cliente).

Caso seja WebService, devemos Selecionar qual o Layout do Apoio WebService, e marcar a opção “Enviar apoio via Web Service”, caso seja XML não marcar essa opção.

2 opções para Retorno de Resultados (APENAS PARA TIPO WEBSERVICE):

Por pedido: Por pedido o sistema irá checar todas as amostras que foram enviadas pra esse apoio, e irá checar se existem resultados disponíveis para essas amostras no apoio e caso tenha irá importar o resultado dos exames. - Geralmente é o mais utilizado.

Por Período: O usuário precisa preencher um período inicial e final na tela de importação de apoio (Ex.: 01/01/2001 a 10/01/2001) e o sistema irá solicitar para o WebService do Apoio as amostras desse período informado.

Endereço WebService: Preencher com o Endereço WebService do laboratório de Apoio (Apoio fornece esse endereço).

Rotina Web:

Devemos utilizar a Rotina do Apoio Desejado, exemplo abaixo com o laboratório de apoio DB:

Demais configurações na tela não é necessário para a integração.

Feito isso, devemos configurar os Exames que serão enviados para o Apoio, acessando a aba “Exames”, conforme imagem abaixo:

Cadastrando um novo, devemos selecionar o Exame, no Cód. Apoio devemos colocar o código do Exame no Apoio, Dias e Valor são opcionais (Dados apenas para consulta ou exibição em relatório), e devemos também selecionar o Layout (Clique aqui para acessar o manual de Configuração de Layout). (Caso não tenha layout informado, a importação do resultado não dará certo pois não há layout vinculado ao exame), aconselhamos ter um layout para cada apoio devido a ter mudança nas mascaras de apoios como quantidade de campos de resultados.

Exemplo:

Exemplo pesquisando o exame adicionado:

É necessário que o “Envia” esteja marcado como SIM na coluna envia para que o exame apareça na listagem de Envio de Pedidos para o Apoio.

Obs.: No ato do cadastro é cadastrado como enviado “SIM” por padrão, caso necessário editar, clicar no item de modificar e alterar o status.

Caso seja necessário vincular ao exame, dados como Material de Envio para o Apoio, campos obrigatórios, etc., devemos clicar no botão de Modificar 📝 .

image-20240129-163030.png

Opção “Não importa valor de referência” faz com que na importação de resultado, seja utilizado o valor de referência do layout e não o que vem do apoio.

Campos obrigatórios são preenchidos na tela de envio para apoio.

Para atualização do Status, quando o Status está INATIVO, é exibido o ícone (erro) no campo “Envia”.

Quando está ATIVO é exibido o ícone (seleção) no campo “Envia”.

Ao clicar no ícone, ele vai mudar o Status, ou seja, se tiver INATIVO e clicar no ícone (seleção) no botão de “Ações”, vai alterar o status para ATIVO e mudar o status na coluna “Envia” para (seleção), da mesma forma é feito a inativação do envio.

Se o laboratório tiver postos de coletas com acessos distintos, ou seja, login e senha diferentes, é necessário cadastrar todos os logins e senhas fornecidos pelo apoio.

Como padrão o sistema irá pegar o código e senha dos Dados Cadastrais, caso não tenha login e senha cadastrado para o posto.

Agora devemos ir para o Menu Cadastros > Exames > Exames.

Devemos marcar o checkbox Apoio, e selecionar o Apoio Padrão de envio (Apenas um padrão, porém o exame pode ser enviado para N apoios diferentes).

Caso o exame não esteja marcado que é enviado para Apoio, o mesmo não aparecerá na listagem de envios.


Envio de Pedidos (Manual)

Acessar no menu: Gerencial > Envio de Exames para Apoio

- Para filtrar é necessário selecionar o apoio e o período que o exame foi cadastrado (Data de Filtro é baseado na data de Coleta do Exame).

- Os demais campos são filtros adicionais para facilitar a busca.

- Com as informações preenchidas acionar o botão Filtrar para buscar os exames que serão enviados para os apoios.

Caso o exame tenha um apoio Padrão X no cadastro do exame (Figura 10), mas nessa remessa você quer enviar esse exame para o apoio Y, podemos marcar o checkbox “Permite enviar o mesmo exame para apoios diferentes”, com esse checkbox marcado é possível realizar o envio para o apoio diferente do padrão informado no cadastro do exame, lembrando que precisa estar configurado no cadastro do apoio selecionado.

Só será exibido os exames que estão devidamente configurados, e com status disponível para envio via Apoio.

Status Disponíveis para envio via Apoio: TR e AP (No caso o AP seria apenas para reenvio).

Depois que o exame for filtrado Marcar os exames na opção “Sel.” que deseja enviar e acionar o botão Enviar Pacientes.

Quando for via WebService é enviado para o WebService do Apoio e Gerado a Etiqueta.

Quando for via XML é feito o download do Arquivo XML para a máquina, e posteriormente o usuário deverá importar esse arquivo no site do Apoio e imprimir a etiqueta no site do apoio também.

Opção de Impressão de Etiqueta do APOIO só é disponível para apoios via WEBSERVICE.


Envio de pedidos (Via Recepção)

Acessar no Menu Cadastros > Posto de Coleta.

- Marcar a opção imprime etiqueta do apoio (ws) no cadastro de atendimento.

Acessar no menu Gerencial > Atendimento

- Selecionar o posto que foi marcado para ser enviado através do cadastro de Posto de Coleta.

- Selecionar o exame configurado para ser enviado para o apoio.

Quando o exame for enviado pela recepção é possível imprimir a 2ª via da etiqueta, marcando a opção destacada.

Todos os exames que foram enviados para o apoio aparecerão e será possível selecionar quais exames serão reimpressos.

REVISAR

Após realizar a leitura de etiqueta (via triagem) ou o Recebimento e Falta de Material o status será atualizado automaticamente para APOIO, facilitando a identificação dos exames.

REVISAR


Configuração de Exame para Retorno de Resultados

Agora, devemos configurar o De/Para das Linhas de Resultados, precisamos consultar no apoio o código das linhas de resultado do exame em específico, em alguns apoios essa informação e disponibilizada no site do apoio, como no cabo do DB por exemplo.

Em outros apoios, talvez seja necessário solicitar para o apoio ou verificar no XML/WebService, os códigos de retorno da linha.

Devemos Acessar o Menu Cadastros > Apoio:

Ir na aba Exames e clicar no ícone de Configuração do De/Para 🔁 dos resultados.

Ao clicar no ícone, abrirá a tela para configuração, conforme exemplo abaixo:

No nosso caso, o parâmetro GLIC (Código da linha no SIALAB) é correspondente ao parâmetro RES1 (Código da linha no APOIO), a OBS o apoio não retorna, então podemos marcar configurar como OBS (Não terá problema pois quando não encontra o parâmetro no retorno, apenas da um informativo no relatório de importação dos resultados).

Exemplo preenchido:

Após preencher os dados, clicamos em “Gravar”,

Feito isso, as alterações estão salvas, e podemos consultar no cadastro que a coluna “De/Para” já não está mais em branco, conforme exemplo abaixo:


Retorno de Resultados

Acessar no menu: Gerencial > Importação de Resultados para Apoio

  • Devemos selecionar o TIPO de retorno, Arquivo ou WebService.

Para o Tipo Arquivo, será exibido os campos para selecionar o APOIO, e o ARQUIVO XML do Resultado (Esse arquivo deve ser baixado no site do apoio).

Para o Tipo WebService, será exibido os campos para selecionar o APOIO, e o POSTO (Opcional) - Caso o posto esteja selecionado, só será filtrado para buscar os resultados das amostras desse posto em específico.

A seleção do Apoio só aparecerá os apoios correspondentes ao Tipo de Importação, ou seja, se for selecionado WebService, só irá listar no Apoio os Apoios que contenham a opção “Enviar Via Webservice” marcada, e para Arquivo essa opção deve estar desmarcada, conforme figura 4.

Após preencher o filtro, devemos clicar em Importar, em seguida irá gerar um Relatório contendo Todos os exames que foram Importados/Importados com Ressalvas (No caso de não ter encontrado algum parâmetro configurado no de/para do cadastro do apoio)\Não Importados, de acordo com o Filtro realizado ou Arquivo Selecionado.

O Relatório exibe os detalhes da importação, exemplo de relatório:

Peculiaridades Pardini

Para o Pardini, existem alguns resultados com campo de resultado duplo, como Eletroforese, Hemograma, etc.

Para esses casos, devemos colocar um “|1” ou “|2” junto com o nome do de/para para associar ao 1° resultado ou ao 2° resultado, caso não tenha essa checagem, será considerado o 1° resultado.

Para os campos de IMAGEM devemos colocar o de/para como IMG, caso tenha mais de 1 imagem, continuar nos demais campos como IMG2, IMG3, IMG4, …..etc.,.

Para os campos de Observação, o Pardini manda apenas um campo de Observação, devemos deixar o De/Para como “Observacao”.

Exemplo:

image-20240126-145406.png

Conclusão

Revisar

  • Sem rótulos