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

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.

SUP - Manuais

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

Instrução

Artigos relacionados