Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.
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

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

Índice
minLevel1
maxLevel7
excludeÍndice
stylesquare

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
languagexml
 <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
languagexml
        <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
languagexml
<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.