Hub de apoio laboratorial · tecnologia

Dados, sistemas e integração

O tubo viaja numa caixa térmica; o dado viaja num canal eletrônico. Quando os dois andam juntos, a terceirização é invisível e barata. Quando não andam, alguém digita tudo duas vezes — e é assim que a maioria dos laboratórios brasileiros ainda opera boa parte do que manda para fora.

o de/paracatálogo canônicoestruturado × PDFos 10 erros clássicos

01O que é um LIS

LIS é a sigla de Laboratory Information System — o sistema que governa a vida de um laboratório: cadastra o paciente, registra o pedido, identifica a amostra, recebe o resultado do equipamento, guarda o laudo e alimenta o faturamento. É o equivalente, no laboratório, do que um ERP é numa indústria.

Na relação com o apoio, o LIS aparece nas duas pontas: o do laboratório que envia precisa produzir um pedido que o outro entenda, e o do apoio precisa devolver um resultado que o primeiro consiga arquivar. Entre eles há normalmente um terceiro componente: um interfaceador (ou middleware), que traduz formatos e protocolos sem que nenhum dos dois sistemas precise conhecer o outro.

LIS

O sistema do laboratório: pedido, amostra, resultado, laudo, faturamento. Um de cada lado da relação.

Interfaceador / middleware

A camada que fala o protocolo do outro lado e converte para o vocabulário de casa. Existe também entre o LIS e os equipamentos.

Portal do apoio

A interface web que o apoio oferece ao cliente. Resolve o caso de quem não tem integração — e cria digitação onde ela poderia não existir.

02O de/para: o nó técnico do setor

O mesmo exame tem um nome e um código diferentes em cada sistema. Não por desleixo: cada laboratório e cada apoio construiu o próprio catálogo ao longo de décadas, antes de existir qualquer padrão. O resultado é que nenhuma automação funciona sem uma tabela de equivalência.

Vitamina D (25-hidroxi)um exame — a mesma coisa medidaSeu sistemaVITDApoio nacional A25OHVDApoio nacional BVD25Apoio regional CVITD3Convênio (TUSS)código da tabelaSem a tabela de equivalência· o pedido eletrônico não sabe o que pedir· o resultado que volta não encontra o item· a fatura do apoio não bate com o seu relatório· e alguém resolve tudo isso por telefoneO de/para é a tabela que responde: “ao falar com este parceiro, como se chama este exame?”
Um exame, cinco identidades. O de/para é a tabela que diz qual código usar ao falar com quem. Sem ela, o pedido eletrônico não roteia e o resultado que volta não encontra onde encaixar.

A tabela real é mais rica do que “meu código → código dele”. Um de/para que sustenta operação carrega, por exame e por apoio:

Campo do de/paraPara que serve
Código do exame no apoioé o que vai no pedido eletrônico — sem ele, nada roteia
Nome do exame no apoiopermite conferência humana quando algo não bate
Material e tubo exigidoso mesmo exame pode pedir material diferente em cada apoio
Volume mínimodefine se dá para fracionar a partir do tubo coletado
Condição de conservaçãoambiente, refrigerado, congelado, ao abrigo da luz
Prazo (TAT) do apoioé o insumo do prazo prometido ao paciente
Preço contratadoentra na margem e na conferência da fatura
Dias de envioalguns exames só são processados em dias específicos
Unidade devolvidapermite detectar divergência na importação
Campos clínicos obrigatórioso que precisa ser coletado no balcão para este exame neste apoio
!

Por que isso quase nunca está pronto: manter o de/para é trabalho contínuo e invisível: o apoio muda o menu, cria exame novo, descontinua método, reajusta preço. Sem dono e sem tela, a tabela envelhece — e a operação volta a resolver por telefone. É o único item deste guia que não é problema de tecnologia, e sim de rotina de manutenção.

03Catálogo canônico: um vocabulário no meio

Com dois apoios, mapear direto de um catálogo para o outro funciona. Com quatro, vira uma teia: cada novo parceiro exige mapear contra todos os outros. A saída é um catálogo canônico — uma definição única e interna de cada exame, à qual todos os catálogos externos se ligam.

PONTO A PONTOABCD4 parceiros = 6 ligações8 parceiros = 28 ligaçõesCOM CATÁLOGO CANÔNICOCatálogocanônicoABCDEF6 parceiros = 6 ligaçõescada parceiro novo custa exatamente uma
À esquerda, o mapeamento ponto a ponto cresce em curva: cada parceiro novo multiplica ligações. À direita, com um catálogo canônico no meio, cada parceiro novo custa uma tradução.

Existe também um vocabulário internacional para isso: LOINC (Logical Observation Identifiers Names and Codes), que identifica de forma única o que está sendo medido, em que material, por qual método e em que escala. É a referência para interoperabilidade de resultados e a âncora natural de um catálogo canônico.

A

O que esperar do LOINC na prática brasileira: ele resolve o significado do exame, não o comercial. O código do apoio, o preço e o prazo continuam sendo dele. Além disso, a adoção real de LOINC nos catálogos de laboratórios brasileiros ainda é baixa — o que significa que um catálogo canônico interno precisa ser construído de qualquer forma, com LOINC como campo de referência e não como substituto.

04Como o dado trafega, na prática

Quatro arranjos convivem no mercado brasileiro, muitas vezes no mesmo laboratório, com apoios diferentes.

ArranjoComo funcionaCusto de manutençãoQualidade do dado
Serviço web próprio do apoioo apoio publica uma interface e o LIS envia pedido e busca resultadoum conector por apoio, mantido para semprealta — resultado estruturado, status e pendência
Troca de arquivosarquivos em formato combinado depositados em um diretório ou servidor de arquivosbaixa para começar, frágil para mantermédia — costuma perder status intermediário
Mensageria em padrão de saúdemensagens em padrão como HL7 para pedido e resultadoalta na implantação, estável depoisalta — foi feito para isso
Portal do apoioalguém digita o pedido no site do apoio e depois copia o resultado de voltanenhuma — e é justamente o problemabaixa — digitação dupla e erro de transcrição
F

O que é verificável sobre o mercado: os grandes apoios brasileiros publicam serviços próprios de integração e portais de acompanhamento para os parceiros — a DB, por exemplo, descreve publicamente que seus clientes enviam pedidos por serviços que ela publica e que a sinalização de recoleta feita pelo setor técnico chega ao sistema do cliente. O que não existe é um formato comum entre eles: cada um tem o seu.

05O padrão que foi proposto e não chegou

Em 2021, a LISBrasil — associação das empresas desenvolvedoras de sistemas laboratoriais — anunciou o Projeto de Padronização do Protocolo de Comunicação entre Laboratórios Apoio e Laboratórios Apoiados. O diagnóstico do documento é preciso e vale citar: por razões históricas, cada apoio desenvolveu o seu próprio mecanismo de troca de informações, com protocolos proprietários e nomenclaturas próprias, mantendo até hoje uma complexidade desnecessária e prejudicial à adesão de novos parceiros.

A proposta era um protocolo único nacional, com governança da própria associação. Dois detalhes importam para quem constrói software hoje:

  • O projeto declarava que entraria “em breve” em fase de implementação — e, anos depois, não há evidência pública de adoção pelos grandes apoios.
  • O escopo excluía explicitamente a padronização da nomenclatura de exames, deixada para uma iniciativa futura. Ou seja: mesmo com o protocolo adotado, o de/para continuaria sendo problema de cada LIS.

Guarde: não construa esperando o padrão. A aposta segura é uma camada de adaptadores: um conector por apoio, todos falando com um contrato interno único. Se um padrão nacional vingar, ele entra como um adaptador a mais — e nada do que foi construído se perde.

06Resultado estruturado × PDF

Esta é a diferença mais consequente de todo o guia, e a mais fácil de subestimar na hora de fechar contrato.

Resultado estruturadoLaudo em PDF
O que chegavalor, unidade, referência e observação em campos separadosuma imagem do laudo do apoio
Trabalho humanoconferir e liberarler, digitar e conferir a digitação
Riscodivergência de unidade ou de referênciaerro de transcrição — o mais perigoso de todos
Histórico do pacienteo valor entra na série e dá para comparar com o anteriornada entra: o dado fica preso na imagem
Indicador e gestãopermite medir TAT, volume e custo por exameinvisível para qualquer indicador
Laudo únicoos itens terceirizados se juntam aos internos no mesmo laudocostuma sair como anexo separado — o paciente recebe dois papéis

Há um caso legítimo para o PDF: exames descritivos — anatomia patológica, citologia, laudos de genética com interpretação longa. Ali o conteúdo é o texto, e o PDF assinado pelo executante é o próprio resultado. O erro é usar PDF para valores numéricos, que poderiam trafegar em campo.

A

A chave de correlação: para amarrar ida e volta é preciso uma chave estávelcombinada entre os dois: normalmente o identificador do pedido na origem mais o identificador do item, espelhados no retorno. Chaves voláteis — número de lote, número de protocolo que muda a cada reenvio — quebram a conciliação e geram duplicidade. Quando o apoio não oferece uma chave estável, é preciso construir uma, e essa decisão condiciona todo o resto da integração.

07Os dez erros de integração mais comuns

Todos aparecem em qualquer integração de apoio, em qualquer sistema. O que varia é se o sistema os trata explicitamente ou os deixa para a operação descobrir.

1

Exame sem de/para

o pedido chega com um código que o apoio não reconhece, ou o resultado volta com um código que o laboratório não sabe onde encaixar.

Tratamento: fila de mapeamento pendente, visível e com responsável — nunca cadastro improvisado no meio da operação.

2

Unidade divergente

o apoio devolve em uma unidade e o sistema espera outra; o número entra certo e significa outra coisa.

Tratamento: unidade sempre junto do valor, e conversão explícita quando houver — jamais implícita.

3

Intervalo de referência ausente

volta o valor, não volta a referência do método do executante; o laudo imprime a referência interna, que é de outro método.

Tratamento: importar a referência textual do apoio e imprimi-la — é o que a norma espera e o que a auditoria cobra.

4

Resultado duplicado

o apoio reenvia o mesmo resultado e o sistema cria um segundo registro.

Tratamento: chave de correlação estável e importação idempotente: reenviar o mesmo dado não pode gerar dois resultados.

5

Resultado órfão

chega um resultado que não corresponde a nenhum pedido no sistema de origem.

Tratamento: fila de órfãos com tentativa de vínculo assistida — e nunca descarte silencioso.

6

Pedido não transmitido

a amostra viaja, o pedido eletrônico não; o tubo chega sem cadastro no apoio.

Tratamento: confirmação de recebimento do pedido antes de liberar a expedição.

7

Falha silenciosa de importação

a rotina de retorno quebrou e ninguém foi avisado; descobre-se pelo paciente dias depois.

Tratamento: conciliação diária do enviado versus retornado, com idade em dias e alerta por vencimento.

8

Mudança de layout sem aviso

o apoio altera um campo e a importação passa a ler errado ou a rejeitar tudo.

Tratamento: validação de contrato de dados na entrada e alerta ao primeiro registro rejeitado.

9

Parcial tratado como final

parte dos exames do pedido volta e o sistema encerra o pedido inteiro.

Tratamento: estado por item, não por pedido; o pedido fecha quando o último item fecha.

10

Retificação que não versiona

o apoio corrige um resultado já entregue e o sistema sobrescreve o valor antigo.

Tratamento: versionar o laudo, guardar a versão anterior e registrar quem já recebeu a errada.

Detectavalidação na entradaClassificatipo e gravidadeEncaminhafila com responsávelResolvemapeia, vincula ou devolveFecha com causaalimenta o indicadora causa recorrente volta como correção de cadastro ou de de/para — é assim que o erro para de repetir
O tratamento de exceção precisa ter destino. Um erro que só vai para o log é um erro que ninguém resolve; ele precisa virar item numa fila com responsável, idade e desfecho.

08A arquitetura que resolve

Reunindo tudo: o desenho que sustenta vários apoios sem virar uma colcha de retalhos tem três camadas e uma regra — o núcleo nunca conhece o parceiro.

Apoio AAdaptadorprotocolo · formato · authApoio BAdaptadorprotocolo · formato · authApoio CAdaptadorprotocolo · formato · authPortal manualAdaptadorprotocolo · formato · authCONTRATO INTERNO ÚNICOpedido · status · resultado (valor + unidade + referência do executante) · pendênciaNÚCLEO DO LISPedidoAmostraResultadoLaudoFaturamentoTrilha econciliaçãoenviado × retornado × idadeA regra: o núcleo não conhece nenhum apoio pelo nome — só sabe que aquele item tem destino externo.
Cada apoio tem o seu adaptador, que fala o protocolo daquele parceiro e traduz para um contrato interno único. O núcleo do sistema só conhece o contrato. Trocar de apoio, ou adicionar o quinto, não toca no núcleo.

Camada de adaptadores

Um por apoio. Sabe o protocolo, o formato, a autenticação e as manhas daquele parceiro. É a única parte que muda quando o apoio muda.

Contrato interno único

Pedido, status, resultado e pendência num formato só. É o vocabulário canônico em forma de mensagem.

Núcleo do LIS

Pedido, amostra, resultado, laudo e faturamento. Não sabe o nome de nenhum apoio — só que aquele item tem um destino externo.

Trilha e conciliação

Atravessa tudo: o que foi enviado, quando, o que voltou, quando, e o que está pendente há quantos dias. É o que transforma integração em gestão.

Resumo do guia: o de/para é o nó, o catálogo canônico é o desamarrador, o resultado estruturado é o que decide se há automação, e a arquitetura de adaptadores é o que impede que quatro parceiros virem quatro sistemas. Falta o assunto que decide se vale a pena: o dinheiro.

Ver o modelo comercial e make-or-buy →