Especificação técnica para integração com o Easylab

Owned by Renan Mitsuo Oka, created
out. 01, 2020
11 min read

Manual ilustrativo para sistemas terceiros se comunicarem com o Easylab

Versão

Proprietário

Nota

Data

Versão

Proprietário

Nota

Data

1.0

@Renan Mitsuo Oka

Criação de documento

01/10/2020

 

 

 

 

TERMO DE CONFIDENCIALIDADE

Este documento é de propriedade da SOFTEASY. As informações aqui contidas são confidenciais e têm caráter técnico e informativo.

O mesmo não poderão ser copiadas ou reproduzidas sem a autorização da Softeasy.

Instrução

O uso da tecnologia XML permite a comunicação indireta entre o sistema de gestão laboratorial e os diversos sistemas utilizados pelos laboratórios de apoio ou terceirizados, tornando o processo de envio de exames e recebimento de resultados mais ágil, rápido e seguro.

 

Pré-requisitos do sistema de laboratório para integração

  • O sistema o laboratório de apoio ou terceiro deverá disponibilizar um XML que fará a comunicação com o Easylab. Para criação deste XML, foi disponibilizado o manual ‘Processo de envio de solicitação de exames e recebimento de resultados via XML.

  • x'O sistema do laboratório de apoio ou terceiro deverá ser capaz de receber e enviar os exames, materiais, conforme cadastrados no sistema de gestão laboratorial.

Dados a serem trafegados no processo

Os dados a serem integrados, envolvem dados de solicitação e dados de resultados, conforme modelos abaixo:

Requisição de solicitação

O método a ser criado no XML do sistema do laboratório terceiro deverá possuir o nome ‘Registro” e deverá ser capaz de receber e enviar os seguintes dados:

Solicitação

Parâmetros

Formato

Obrigatório

Descrição

Pedido

-

-

Grupo principal indica toda solicitação contida no XML

Paciente

-

-

Grupo informando os dados do prontuário a serem importados

CodPedLab

String(15)

SIM

Código do cliente (conveniado)

CodPacLab

String(15)

SIM

Código do paciente no cliente

DataNasc

Date

SIM

Data de nascimento do paciente

Sexo

String

SIM

Sexo (gênero) do paciente (Masculino, Feminino ou Indefinido).

Exame

-

-

Grupo informando os dados dos exames a serem realizados

CodExmApoio

String(5)

SIM

Código do exame apoio no Easylab

CodExmLab

String(15)

SIM

Código do exame no apoiado

DescMat

String(40)

SIM

Descrição do material biológico.

DataColeta

Date

SIM

Data da coleta do material

HoraColeta

Time(aaaa-mm-aa)

SIM

Hora da coleta do material

Exemplo da estrutura que deverá ser enviado

Requisição de solicitação de resultados

 

O método criado no XML da SOFTEASY possui o nome ‘Resultados’ e será capaz de receber os seguintes dados:

Parâmetros

Parâmetros

Formato

Obrigatório

Descrição

Resultados

-

-

Grupo principal contendo todos os resultados

CodPedApoio

String(30)

SIM

Indica o código do envio para apoio

CodPedLab

String(30)

SIM

Código do cliente (conveniado)

Nome

String(35)

SIM

Nome do paciente

SuperExame

-

-

Indica o resultado de cada exame

MaterialNome

String(40)

SIM

Material usado

CodExmApoio

String(15)

SIM

Código do exame no Easylab

CodigoFormato

String(30)

NÃO

Indica o formato

ValorDeReferenciaBlocoTexto

String(30)

SIM

Indica o valor de referência do exame

Exame IdExame

Int

SIM

Código do exame Easylab

Metodo

String(30)

SIM

Indica o método para realizar o exame

ItemDeExame IdItemExame

Int

SIM

Grupo Onde indica o resultado do exame

Nota

String(56)

Não

Observação do exame

Conteudo

-

SIM

Conteúdo de resultado do exame

Valor CasaDecimais

String(30)

SIM

Indica o resultado do exame

UnidadeMedida

String(30)

SIM

Indica a unidade do resultado

Exemplo da estrutura que deverá ser enviado

 

Exemplo: <?xml version="1.0" encoding="ISO-8859-1" ?> <Resultados> <Protocolo>1</Protocolo> <ControleDeLote> <Emissor>Easylab </Emissor> <DataEmissao>2015-02-11</DataEmissao> <HoraEmissao>17:18:46</HoraEmissao> <Periodo> <DataInicial>2015-02-01</DataInicial> <HoraInicial>00:00:00</HoraInicial> <DataFinal>2015-02-11</DataFinal> <HoraFinal>00:00:00</HoraFinal> </Periodo> <CodLab>2</CodLab> </ControleDeLote> <Pedido> <CodPedApoio>003000207</CodPedApoio> <CodPedLab>001000020</CodPedLab> <Nome>MARIO DIAS DA SILVA</Nome> <SuperExame> <MaterialNome>SORO</MaterialNome> <ExameNome>GLICOSE</ExameNome> <CodExmApoio>S|GLI|1</CodExmApoio> <CodExmLab>85</CodExmLab> <CodigoFormato>685</CodigoFormato> <ValorReferenciaBlocoTexto> Referência: Homens e não grávidas : 70 a 99 mg/dL Intolerância à Glicose: 100 a 125 mg/dL Grávidas : até 105 mg/dL </ValorReferenciaBlocoTexto> <Exame idExame="87"> <Metodo>ENZIMATICO</Metodo> <ItemDeExame idItemDeExame="1"> <Nota> testesasssssssssssssssssssssssssssssssssssssssssss sssssssssssssssssss1 sssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssss4 </Nota> <Nome>Resultado</Nome> <Resultado idResultado="1"> <Conteudo> <Valor idValor="1" Tipo="decimal" TamanhoMaximo="3" CasasDecimais="0">228</Valor> </Conteudo> <UnidadeDeMedida>mg/dL</UnidadeDeMedida> </Resultado> </ItemDeExame> <ItemDeExame idItemDeExame="2"> <Nome>Obs1</Nome> <Resultado idResultado="1"> <Conteudo> <Valor idValor="1" Tipo="alfanumerico" TamanhoMaximo="60" CasasDecimais="0">EXAME DE GLICOSE REPETIDO E CONFIRMADO</Valor> </Conteudo> </Resultado> </ItemDeExame> <ItemDeExame idItemDeExame="3"> <Nome>Obs2</Nome> <Resultado idResultado="1"> <Conteudo> <Valor idValor="1" Tipo="alfanumerico" TamanhoMaximo="60" CasasDecimais="0">SORO DA GLICOSE LIPEMICO ++++</Valor> </Conteudo> </Resultado> </ItemDeExame> </Exame> </SuperExame> <SuperExame> <MaterialNome>SORO</MaterialNome> <ExameNome>COLESTEROL TOTAL</ExameNome> <CodExmApoio>S|COL|1</CodExmApoio> <CodExmLab>86</CodExmLab> <CodigoFormato>994</CodigoFormato> <Exame idExame="44"> <ItemDeExame idItemDeExame="1"> <Nome></Nome> <Resultado idResultado="1"> <Conteudo> <Valor idValor="1" Tipo="alfanumerico" TamanhoMaximo="60" CasasDecimais="0">200</Valor> </Conteudo> </Resultado> </ItemDeExame> <ItemDeExame idItemDeExame="2"> <Nome></Nome> <Resultado idResultado="1"> <Conteudo> <Valor idValor="1" Tipo="alfanumerico" TamanhoMaximo="60" CasasDecimais="0">EXAME DE COLESTEROL REPETIDO E CONFIRMADO</Valor> </Conteudo> </Resultado> </ItemDeExame> <ItemDeExame idItemDeExame="3"> <Nome></Nome> <Resultado idResultado="1"> <Conteudo> <Valor idValor="1" Tipo="alfanumerico" TamanhoMaximo="60" CasasDecimais="0">SORO DO COLESTEROL LIPEMICO +</Valor> </Conteudo> </Resultado> </ItemDeExame> </Exame> </SuperExame> </Pedido> <Pedido> <CodPedApoio>003000208</CodPedApoio> <CodPedLab>001000027</CodPedLab> <Nome>teste</Nome> <SuperExame> <MaterialNome>SORO</MaterialNome> <ExameNome>GLICOSE</ExameNome> <CodExmApoio>S|GLI|1</CodExmApoio> <CodExmLab>231</CodExmLab> <CodigoFormato>685</CodigoFormato> <ValorReferenciaBlocoTexto> Referência: Homens e não grávidas : 70 a 99 mg/dL Intolerância à Glicose: 100 a 125 mg/dL Grávidas : até 105 mg/dL </ValorReferenciaBlocoTexto> <Exame idExame="87"> <Metodo>ENZIMATICO</Metodo> <ItemDeExame idItemDeExame="1"> <Nota> testesasssssssssssssssssssssssssssssssssssssssssss sssssssssssssssssss sssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssss4 </Nota> <Nome>Resultado</Nome> <Resultado idResultado="1"> <Conteudo> <Valor idValor="1" Tipo="decimal" TamanhoMaximo="3" CasasDecimais="0">88</Valor> </Conteudo> <UnidadeDeMedida>mg/dL</UnidadeDeMedida> </Resultado> </ItemDeExame> <ItemDeExame idItemDeExame="2"> <Nome>Obs1</Nome> <Resultado idResultado="1"> <Conteudo> <Valor idValor="1" Tipo="alfanumerico" TamanhoMaximo="60" CasasDecimais="0">REP E CONF</Valor> </Conteudo> </Resultado> </ItemDeExame> <ItemDeExame idItemDeExame="3"> <Nome>Obs2</Nome> <Resultado idResultado="1"> <Conteudo> <Valor idValor="1" Tipo="alfanumerico" TamanhoMaximo="60" CasasDecimais="0">EM DUAS AMOSTRAS</Valor> </Conteudo> </Resultado> </ItemDeExame> </Exame> </SuperExame> </Pedido> <Pedido> <CodPedApoio>003000209</CodPedApoio> <CodPedLab>001000029</CodPedLab> <Nome>teste</Nome> <SuperExame> <MaterialNome>SORO</MaterialNome> <ExameNome>GLICOSE</ExameNome> <CodExmApoio>S|GLI|1</CodExmApoio> <CodExmLab>235</CodExmLab> <CodigoFormato>685</CodigoFormato> <ValorReferenciaBlocoTexto> Referência: Homens e não grávidas : 70 a 99 mg/dL Intolerância à Glicose: 100 a 125 mg/dL Grávidas : até 105 mg/dL </ValorReferenciaBlocoTexto> <Exame idExame="87"> <Metodo>ENZIMATICO</Metodo> <ItemDeExame idItemDeExame="1"> <Nota> testesasssssssssssssssssssssssssssssssssssssssssss sssssssssssssssssss1 sssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssss4 </Nota> <Nome>Resultado</Nome> <Resultado idResultado="1"> <Conteudo> <Valor idValor="1" Tipo="decimal" TamanhoMaximo="3" CasasDecimais="0">88</Valor> </Conteudo> <UnidadeDeMedida>mg/dL</UnidadeDeMedida> </Resultado> </ItemDeExame> <ItemDeExame idItemDeExame="2"> <Nome>Obs1</Nome> <Resultado idResultado="1"> <Conteudo> <Valor idValor="1" Tipo="alfanumerico" TamanhoMaximo="60" CasasDecimais="0"></Valor> </Conteudo> </Resultado> </ItemDeExame> <ItemDeExame idItemDeExame="3"> <Nome>Obs2</Nome> <Resultado idResultado="1"> <Conteudo> <Valor idValor="1" Tipo="alfanumerico" TamanhoMaximo="60" CasasDecimais="0"></Valor> </Conteudo> </Resultado> </ItemDeExame> </Exame> </SuperExame> </Pedido> <Pedido> <CodPedApoio>003000210</CodPedApoio> <CodPedLab>001000033</CodPedLab> <Nome>teste</Nome> <SuperExame> <MaterialNome>SORO</MaterialNome> <ExameNome>GLICOSE</ExameNome> <CodExmApoio>S|GLI|1</CodExmApoio> <CodExmLab>522</CodExmLab> <CodigoFormato>685</CodigoFormato> <ValorReferenciaBlocoTexto> Referência: Homens e não grávidas : 70 a 99 mg/dL Intolerância à Glicose: 100 a 125 mg/dL Grávidas : até 105 mg/dL </ValorReferenciaBlocoTexto> <Exame idExame="87"> <Metodo>ENZIMATICO</Metodo> <ItemDeExame idItemDeExame="1"> <Nota> testesasssssssssssssssssssssssssssssssssssssssssss sssssssssssssssssss1 sssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssss4 </Nota> <Nome>Resultado</Nome> <Resultado idResultado="1"> <Conteudo> <Valor idValor="1" Tipo="decimal" TamanhoMaximo="3" CasasDecimais="0">228</Valor> </Conteudo> <UnidadeDeMedida>mg/dL</UnidadeDeMedida> </Resultado> </ItemDeExame> <ItemDeExame idItemDeExame="2"> <Nome>Obs1</Nome> <Resultado idResultado="1"> <Conteudo> <Valor idValor="1" Tipo="alfanumerico" TamanhoMaximo="60" CasasDecimais="0">TESTE OBS LINHA 1</Valor> </Conteudo> </Resultado> </ItemDeExame> <ItemDeExame idItemDeExame="3"> <Nome>Obs2</Nome> <Resultado idResultado="1"> <Conteudo> <Valor idValor="1" Tipo="alfanumerico" TamanhoMaximo="60" CasasDecimais="0">TESTE OBS LINHA 2</Valor> </Conteudo> </Resultado> </ItemDeExame> </Exame> </SuperExame> </Pedido> </Resultados>

Considerações finais

A forma de integração apresentada permite ao cliente realizar a solicitação de exames e o recebimento dos resultados via XML de uma maneira rápida e segura.

Fica a cargo do laboratório terceiro realizar a criação e configuração deste XML, bem como, atender aos pré-requisitos indicados no início do documento.  

Artigos relacionados

Filtrar por etiqueta

Não existem itens com as etiquetas selecionadas desta vez.