| 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 | |
1.4 | Inclusão de Importação PDF + dados Álvaro + Cancelamento de Exame no Apoio | 10/10/2024 |
Índice
...
1.5 | Inclusão de Importação Informação Adicional Pardini | 24/12/2024 | |
1.6 | Inclusão de Importação Antibiograma Formato 999999v1. | 05/02/2025 |
Í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):
...
| 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
...
| 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:
...
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.
...
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:
...
...
Acessar no menu: Integrações > 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).
...
| Nota |
|---|
Múltiplo De/Para: É possível configurar vários de/paras para um resultado só, separando com “;”, então se vier na integração X ou Y, a primeira condição/parâmetro que ele encontrar será o valor utilizado para importação do resultado. Exemplo: (Caso que pegamos no Pardini por exemplo das Bilirrubinas) TOTAL|3;TOTAL INDIRETA|2;INDIRETA Nesse exemplo acima, irá procurar o valor “TOTAL|3”, caso não encontre irá procurar “TOTAL”, a mesma coisa para a INDIRETA. |
...
Retorno de Resultados
Acessar no menu: Integrações > 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 POSTO (Opcional) - Caso 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.
...
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 comopostoscompostos, ou seja, possuem mais de uma linha resultado (Ex.: Bilirrubinas, Psa livre e total, etc), e resultados com campo de resultado duplo (Ex.: 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.
...
Informação Adicional, pode ser importado o Valor ou a Descrição da informação Adicional.
Deverá ter o de/para para o campo, informando como “INFOAD” fixo, e o numero da informação adicional e qual o dado quer (Valor ou Descrição), exemplo: “INFOAD1|VALOR” ou “INFOAD1|DESC”
Exemplo do retorno do Pardini:
| Bloco de código | ||
|---|---|---|
| ||
<InfAdicional idInfAdicional="1">
<Descricao>Bloco analisado:</Descricao>
<Valor CasasDecimais="0" TamanhoMaximo="58" Tipo="alfanumerico" idValor="1" 10/>
</InfAdicional>
<InfAdicional idInfAdicional="2">
<Descricao>Porcentagem tumoral:</Descricao>
<Valor CasasDecimais="0" TamanhoMaximo="54" Tipo="alfanumerico" idValor="2" 25/>
</InfAdicional>
<InfAdicional idInfAdicional="3">
<Descricao>REFERÊNCIAS:</Descricao>
<Valor>- NCCN Clinical Practice Guidelines Genetic/Familial High Risk Assessment:
Colon/Rectal Cancer; Non-Small Cell Lung Cancer (<http://www.nccn.org/).</Valor>
</InfAdicional> |
...
Antibiograma Formato 999999v1
Possível importar até 3 bactérias, conforme layout de Antibiograma.
Separar da seguinte forma:
MIC1, MIC2, MIC3 para as bactérias, na MIC1 tem “;CT+ABU” pois pode vir uma cultura negativa, então não vai ter bactérias e antibióticos.
ANTIBIOGRAMA 1 (Descrição do Antibiótico 1)
ANTIBIOGRAMA 1 R1 (Resistência 1 do Antibiótico 1)
ANTIBIOGRAMA 1 M1 (MIC/CIM 1 do Antibiótico 1)
ANTIBIOGRAMA 1 R1 (Resistência 2 do Antibiótico 1)
ANTIBIOGRAMA 1 M1 (MIC/CIM 2 do Antibiótico 1)
E assim, sucessivamente.
...
Cancelamento de Exame
Para cancelar o envio de um exame que foi enviado para o apoio, devemos ir na tela de Integrações > Apoio - Envio de Exames:
...
| Nota |
|---|
Só funciona para integração via WEB SERVICE. |
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.
...