• Pronto para análise

    • Integração com Apoio

    Owned by Rafael Carvalho
    Last updated: nov. 05, 2024
    16 min read

    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

    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

    1.4

    @Rafael Carvalho

    Inclusão de Importação PDF + dados Álvaro + Cancelamento de Exame no Apoio

    10/10/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:

    Figura 1. Botões Padrões Cadastro de Apoio.
    Figura 2. Outros Filtros (Menu após clicar na opção3).

    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.

    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.

    Rotina Web:

    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.

    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 .

    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.

    Opção “Importa resultados em PDF do Apoio” faz com que na importação de resultado, seja consumido o PDF do apoio (Alvaro, Pardini e DB).

    Campos obrigatórios são preenchidos na tela de envio para apoio, e caso marcado faz com que tenha que ser digitado antes do envio para conseguir fazer o envio de fato.

    Opção “Teste para COVID-19” obriga preencher data de sintoma e envia pro apoio.

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

    Quando está ATIVO é exibido o ícone no campo “Envia”.

    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.

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

    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.

    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.

    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, ao finalizar o atendimento as etiquetas são impressas a depender do fluxo de coleta estabelecido via parâmetros do sistema, posteriormente será 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 Álvaro:

    Link: Guia de Exames - Álvaro

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

    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: 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).

    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.

    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 três formas de retorno dos resultados, alguns resultados que vem sem nome (Caso de resultado único), alguns resultados que são comopostos, 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).

    Para 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 os campos de resultado.

    Exemplo:

    Exemplo do XML para resultados simples:

    <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:

    <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), devemos colocar um “|1” ou “|2” junto com o nome do de/para para associar ao 1° resultado (O primeiro resultado é opcional colocar o |1 ou não) ou ao 2° resultado, caso não tenha essa checagem, será considerado o 1° resultado.

    Exemplo:

    Exemplo do XML para campo duplo:

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

    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:

    Filtrar o apoio desejado, e o período desejado.

    Após realizar o filtro, aparecerá um ícone de voltar transação no “Ações” da tabela, conforme imagem abaixo:

    Ao clicar no ícone, será gerado um toast de sucesso do cancelamento, e o exame voltará para “TR” caso já esteja com o status “AP”, caso esteja em qualquer outro status, será mantido o status do sistema porém o cancelamento será feito 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.