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.
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.
...
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: Gerencial > 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.
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.
...
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
...
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.
Para esses casos, devemos colocar um “|1” ou “|2” junto com o nome os casos de resultado simples (Ex.: Albumina), devemos colocar o mesmo código do exame no apoio para realizar a configuração 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:
...
Conclusão
Revisaros campos de resultado.
Exemplo:
...
Exemplo do XML para resultados simples:
Bloco de código | ||
---|---|---|
| ||
<SuperExame>
<MaterialNome>SORO</MaterialNome>
<ExameNome>ALBUMINA, DOSAGEM</ExameNome>
<CodExmApoio>S|ALB-D|1</CodExmApoio>
<CodExmLab>175473</CodExmLab>
<CodigoFormato>12938</CodigoFormato>
<ValorReferenciaBlocoTexto> VALOR DE REFERÊNCIA: ADULTOS: DE 3,7 A 5,2 g/dL</ValorReferenciaBlocoTexto>
<Exame idExame="1">
<Metodo>COLORIMÉTRICO</Metodo>
<ItemDeExame idItemDeExame="1">
<Resultado idResultado="1">
<Conteudo>
<Valor CasasDecimais="1" TamanhoMaximo="6" Tipo="decimal" idValor="1">4,0</Valor>
</Conteudo>
<UnidadeDeMedida>g/dL</UnidadeDeMedida>
</Resultado>
</ItemDeExame>
<Observacao />
</Exame>
</SuperExame> |
Repare que não temos campo de nome para a linha de resultado, ou seja, consideraremos o código do Exame no Apoio.
...
Para os casos possuem mais de uma linha (Ex.: Bilirrubinas), devemos colocar o nome da linha como aparece no xml.
Exemplo:
...
Exemplo do XML para resultados com mais de uma linha:
Bloco de código | ||
---|---|---|
| ||
<ItemDeExame idItemDeExame="1">
<Resultado Nome="DIRETA" idResultado="1">
<Conteudo>
<Valor CasasDecimais="1" TamanhoMaximo="5" Tipo="decimal" idValor="1">0,1</Valor>
</Conteudo>
<UnidadeDeMedida>mg/dL</UnidadeDeMedida>
</Resultado>
</ItemDeExame>
<ItemDeExame idItemDeExame="2">
<Resultado Nome="INDIRETA" idResultado="1">
<Conteudo>
<Valor CasasDecimais="1" TamanhoMaximo="5" Tipo="decimal" idValor="1">0,3</Valor>
</Conteudo>
<UnidadeDeMedida>mg/dL</UnidadeDeMedida>
</Resultado>
</ItemDeExame>
<ItemDeExame idItemDeExame="3">
<Resultado Nome="TOTAL" idResultado="1">
<Conteudo>
<Valor CasasDecimais="1" TamanhoMaximo="5" Tipo="decimal" idValor="1">0,4</Valor>
</Conteudo>
<UnidadeDeMedida>mg/dL</UnidadeDeMedida>
</Resultado>
</ItemDeExame> |
Repare que temos na tag de resultado o nome do campo “DIRETA”, “INDIRETA” e “TOTAL”. Nesse cenário utilizaremos esse mesmo nome para associação dos campos e realização do de/para corretamente.
...
Para os casos de resultado duplo (Eletroforese, Hemograma), 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.
Exemplo:
...
Exemplo do XML para campo duplo:
Bloco de código | ||
---|---|---|
| ||
<Exame idExame="1">
<Metodo>ELETROFORESE CAPILAR</Metodo>
<ItemDeExame idItemDeExame="1">
<Nome>ALBUMINA</Nome>
<Resultado Nome="%" idResultado="1">
<Conteudo>
<Valor CasasDecimais="1" TamanhoMaximo="7" Tipo="decimal" idValor="1">63,5</Valor>
</Conteudo>
<UnidadeDeMedida>%</UnidadeDeMedida>
</Resultado>
<Resultado idResultado="2">
<Conteudo>
<Valor CasasDecimais="2" TamanhoMaximo="7" Tipo="decimal" idValor="1">3,75</Valor>
</Conteudo>
<UnidadeDeMedida>g/dL</UnidadeDeMedida>
</Resultado>
</ItemDeExame> |
Repare que temos o campo “NOME” = ALBUMINA, porém temos 2 idResultado, ou seja, resultado duplo. Nesse cenário o campo id “1” seria “ALBUMINA” e o id “2” seria “ALBUMINA|2”.
...
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”.
...
Valores de Referência do Pardini São importados via Bloco de texto, ou seja, será utilizado o campo de Valor de Referência Texto da linha do layout, conforme podem ver orientação no manual Cadastro de Layout de Exames SIALAB.
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.
Sendo assim, podemos concluir que, uma integração com laboratório de apoio auxilia no tempo de liberação do laudo, rastreabilidade do processo, e também confiabilidade do resultado, permitindo ganho de tempo em cadastros, digitação e liberação/conferência de laudos.