| Informações |
|---|
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 | Criação de documento | 24/05/2023 | |
1.1 | Conclusão do documento | 30/05/2023 | |
1.2 | Inclusão Peculiaridades Pardini | 26/01/2024 | |
1.3 | Inclusão parâmetro não importa referência | 29/01/2024 |
Índice
| Í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.
...
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:
...
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.
Endereço WebService: Preencher com o Endereço WebService do laboratório de Apoio (Apoio fornece esse endereç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.
...
Devemos utilizar a Rotina do Apoio Desejado, exemplo abaixo com o laboratório de apoio DB:
...
...
Peculiaridades de Envio Álvaro (XML ou Webservice)
O Álvaro utiliza dois campos de login que são diferentes caso use XML ou Webservice):
Entidade= LOGIN (Quando utiliza Webservice)
Agente= Agente WS (Somente para Webservice).
Senha= Senha do Apoio (Mesma para XML ou Webservice)
Chave AOL = LOGIN (Quando utiliza XML)
Versão Web Service = Obrigatório (Versão no momento de criação do manual = 20190215)
...
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.
...
Ao clicar no ícone, ele vai mudar o Status, ou seja, se tiver INATIVO e clicar no ícone 
no botão de “Ações”, vai alterar o status para ATIVO e mudar o status na coluna “Envia” para , 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.
| Nota |
|---|
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).
| Nota |
|---|
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: Integrações > 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.
| Nota |
|---|
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/reimpressão de etiqueta ou cancelamento do exame no apoio). Será exibido também os exames com status “FM”,”FU” no filtro de enviados, caso tenha o envio automático para o apoio direto na tela de atendimento. (Também seria apenas para reenvio/reimpressão de etiqueta ou cancelamento do exame no apoio) |
...
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.
| Nota |
|---|
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 Rotina > 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.
...
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.
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.
...
o status para ATIVO e mudar o status na coluna “Envia” para , 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.
| Nota |
|---|
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).
| Nota |
|---|
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: Integrações > 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.
| Nota |
|---|
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/reimpressão de etiqueta ou cancelamento do exame no apoio). Será exibido também os exames com status “FM”,”FU” no filtro de enviados, caso tenha o envio automático para o apoio direto na tela de atendimento. (Também seria apenas para reenvio/reimpressão de etiqueta ou cancelamento do exame no apoio) |
...
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.
| Nota |
|---|
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 Rotina > 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.
...
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.
...
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.
Link: Guia de Exames - Diagnostico do Brasil
(Filtrar o exame desejado, e clicar na opção de “Mais Detalhes” ao lado do Método e ir nos “Parâmetro de Integração”).
Código Parâmetro > é o Código que deverá ser utilizado no De/Para.
...
Exemplo do Alvaro:
Link: Guia de Exames - Alvaro
(Filtrar o exame desejado, e clicar na opção de “Ver Parâmetros” na aba “INTEGRAÇÃO”).
Linhas de Resultado > Código da linha é o Código que deverá ser utilizado no De/Para.
...
Em outros apoios, talvez seja necessário solicitar para o apoio ou verificar no XML/WebService, os códigos de retorno da linha.
...
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: Integrações > Importação de Resultados para Apoio
...
O Relatório exibe os detalhes da importação, exemplo de relatório:
...
Peculiaridades Pardini
Para o Pardini, existem três formas de retorno dos resultados, alguns resultados que vem sem nome (Caso de resultado único), alguns resultados que são possuem mais de uma linha (Ex.: Bilirrubinas), e resultados com campo de resultado duplo, como Eletroforese, Hemograma, etc.
...
IMPORTANTE: O valor de referência, ficará na linha do último parâmetro enviado do apoio, ou seja, no exemplo da bilirrubina total, a referência ficaria abaixo da linha da BILIRRUBINA TOTAL, independente da ordem dela no layout dentro do sia, o que vale nesse cenário é a ordem que veio no apoio.
Conclusão
A integração com laboratórios de apoio, permite que o laboratório faça exames terceirizados de forma prática, confiável e rápida, visando diminuir o tempo de cadastro/digitação de resultado, fazendo isso via integração, possibilitando maior controle sobre os exames terceirizados, assim como evitar digitação incorreta de resultados.
...