INTEGRAÇÃO CLINUX DICOMVIX

Genesis Tecnologia Ltda

Av. Fernando Ferrari, 1080 Ed. América Centro Empresarial, sala 306 - Torre Central
Mata da Praia – 29.066-380 - Vitória- ES
27 – 3327-6976 www.gtecnologia.com.br
 Clinux Dicomvix
__________________________________________________________________
Versão: 1.1

1 - Objetivo: Definir os procedimentos de integração de sistemas externos com o Clinux DicomVix.

Os sistemas externos podem ser:

• Sistemas Hospitalares (HIS)

• Sistemas de TeleRadiologia
• PACS de outros fornecedores

2- Responsabilidade:
É de responsabilidade dos integrantes da tecnologia auxiliar no processo de integração com o
sistema Clinux DicomVix, realizando a validação e esclarecendo o processo de negócio da
empresa.

3 - Propósito
3.1 - Sistemas Hospitalares (HIS)
Tem como objetivo receber os pedidos de exames originados pelo hospital, repassar o status que o
exame já foi realizado e envio o laudo no final do processo.
A integração tem com o propósito as seguintes funcionalidades:

• Solicitação de Exames
• Cancelamento de Pedidos de Exames
• Alteração de Pedidos de Exames
• Status de Exame Realizado
• Consulta de resultado de Exames (Laudos)
• Acesso as imagens do Paciente

A integração é realizado através de WebService seguindo o modelo Rest Json.

GENESIS TECNOLOGIA LTDA

Av. Fernando Ferrari, 1080 Ed. América Centro Empresarial, sala 306 - Torre Norte
Mata da Praia – 29.066-380 - Vitória- ES
27 – 3327-6976 www.gtecnologia.com.br
 Clinux Dicomvix
__________________________________________________________________

Solicitação de Exames, Cancelamento e Atualização de Exames

Após a solicitação/prescrição dos exames no HIS os pedidos devem ser enviados para o RIS
PACS, fazendo um POST para o endpoint http://<IP Servidor>:9090/clinuxpedidos com os
seguintes as seguintes características e dados.
Os campos no Json são case sensitive.
A autenticação é BasicAuth.
Na estrutura contem os dados do paciente, atendimento e uma lista de exames do pedido.
Os pedidos podem ser enviados no momento da prescrição ou no momento do
atendimento/solicitação de exame na recepção, dependendo da regra de negócio do cliente, pois
alguns procedimentos precisam ser agendados pela clínica (Sistema externo).
O CodigoPedido identifica unicamente o Pedido de exame e o CodigoItemPedido é a
identificação única do exame pedido no HIS, está relacionado com o AccessionNumber, porém no
AccessionNumber permite letras e números para diferenciação em múltiplas unidades integradas,
sendo o CodigoItemPedido apenas números inteiros pois é a chave primária.
As operações de Update e Cancelado, podem modificar um exame ou todos do pedido enviado,
desde que estejam na lista de exame no json enviado.
Segue exemplo resumido do Json:
Um pedido pode ter vários exames
{
"Operacao":"I",
"NomePaciente":"JOSE CARLOS DE SOUZA",
"CodigoPaciente":34,
"DataNascimento":"19790120",
"Sexo":"M",
"CodigoPedido":100,
"Exames":[
{
"CodigoItemPedido":234,
"AccessionNumber":"234",
"Modalidade":"US",
"CodigoModalidade":4,
"CodigoProcedimento":34,
"NomeProcedimento":"US-Abdomen Total"
},
{
"CodigoItemPedido":234,
"AccessionNumber":"234",
"Modalidade":"MR",
"CodigoModalidade":5,
"CodigoProcedimento":300,
"NomeProcedimento":"RM - Abdomen Superior"
}
]
}

GENESIS TECNOLOGIA LTDA

Av. Fernando Ferrari, 1080 Ed. América Centro Empresarial, sala 306 - Torre Norte
Mata da Praia – 29.066-380 - Vitória- ES
27 – 3327-6976 www.gtecnologia.com.br
 Clinux Dicomvix
__________________________________________________________________

Atendimento

Campo Obrigatório? Tipo/Tamanho Descrição

Operacao S String (1) Operação I – Insert, C – Cancelado – U -
Update
NomePaciente S String (64) Nome Completo do Paciente.
NomeSocial N String (64) Nome Social do Paciente.
CodigoPaciente S Integer Identificação Única do Paciente no banco
de dados.
DataNascimento S String (8) Data Nascimento no formato YYYYMMDD
Sexo N String (1) Sexo definidos como M ou F
Peso N Integer Peso do Paciente. Exemplo: 70
Altura N Float Altura do Paciente. Exemplo: 1.70
Telefone N String (10) Telefone do Paciente, somente os
números. Exemplo: 2733276976
Celular N String(10) Celular do Paciente, somente os números.
Exemplo: 27981228776
Whatsapp N String(10) Numero do Whatsapp, somente os
números.
Logradouro N String (128) Nome da Rua
Numero N String (10) Numero da Rua
Bairro N String (128) Bairro
Cidade N String (128) Cidade
Complemento N String (128) Complemento
CEP N String (8) CEP somente os números. 29090090
Estado N String (2) Sigla do Estado da Federação.
IBGE N String(16) Código do IBGE do Endereço.
Email N String(128) E-mail do Paciente
MaePaciente N String (64) Nome Mãe Paciente
PaiPaciente N String (64) Nome do Pai do Paciente
RG N String (64) RG do Paciente
EstadoCivil N String(32) Estado Civil (Casado, Divorciado,
Desquitado, Separado, Solteiro, Viúvo,
Outro).
Profissao N String(64) Profissão do Paciente.
Naturalidade N String (64) Naturalidade do Paciente.
ObservacaoPaciente N String (128) Observações do Paciente
FotoPaciente N Bytea Bytea da foto em Jpeg.
CodigoPedido S Integer Código do Pedido que identifica
unicamente o pedido de Exames. Um
código de Pedido pode ter vários exames
DataPedido S String (8) Data que foi realizado o pedido ou
atendimento. YYYYMMDD
HoraPedido S String (5) Hora que foi realizado o pedido ou
atendimento HH24:MM Exemplo: 16:35
Urgente S String (1) Status de Urgente U ou E
NomeSolicitante N String (64) Nome do Médico Solicitante
CRMSolicitante N String(8) CRM do Médico Solicitante
UFSolicitante N String (2) UF do Médico Solicitante
TelefoneSolicitante N String(10) Telefone do Médico Solicitante

GENESIS TECNOLOGIA LTDA

Av. Fernando Ferrari, 1080 Ed. América Centro Empresarial, sala 306 - Torre Norte
Mata da Praia – 29.066-380 - Vitória- ES
27 – 3327-6976 www.gtecnologia.com.br
 Clinux Dicomvix
__________________________________________________________________
CelularSolicitante N String (10) Celular do Médico Solicitante
DadosClinicosLinha N String (255) Dados Clínicos do Paciente, porém
resumido em uma linha
BBClinicos N Bytea Dados clínicos em texto ou arquivo RTF
BBProntuario N Bytea Resumo do Prontuário em PDF ou RTF.

Exames
Campo Obrigatório? Tipo/Tamanho Descrição
CodigoItemPedido S Integer Código do Item, identifica unicamente o
exame solicitado na base do HIS.
AccessionNumber S String (64) Identifica o exame unicamente. O mesmo
do CodigoItemPedido, porém permite
letras e números para regras de negócio.
Modalidade S String(8) Identifica a modalidade do Exame
solicitado
CodigoModalidade S integer Código que identifica a modalidade do HIS
CodigoProcedimento S Integer Código que identifica unicamente o
procedimento. Chave primaria da lista de
procedimentos no sistema HIS.
NomeProcedimento S String(128) Nome do Procedimento associado ao
Código Procedimento.

Retorno Sucesso
{

"Status":"Sucesso",

"CodigoStatus": 1

Retorno Erro
{

"Status":"Falha",

"CodigoStatus": 0

Status de Exame Realizado

Quando o exame é realizado é enviado para o HIS o status que foi realizado para evitar alteração
ou cancelamento equivocado, além de controlar o fluxo de trabalho dentro do HIS.
O status pode ser realizado de 2 formas:

• Enviado para o WebService do HIS

GENESIS TECNOLOGIA LTDA

Av. Fernando Ferrari, 1080 Ed. América Centro Empresarial, sala 306 - Torre Norte
Mata da Praia – 29.066-380 - Vitória- ES
27 – 3327-6976 www.gtecnologia.com.br
 Clinux Dicomvix
__________________________________________________________________
• Consultado pelo WebService do HIS

Enviado para o WebService do HIS

O Clinux envia para o endpoint definido pelo HIS o Json com as seguintes características.
O Endpoint deve ser http://<IP Servidor>:Porta/statusexame
{

"CodigoItemPedido": 23,

"AccessionNumber": "23",

"Status": "Realizado",

"CodigoStatus":1

Consultado pelo WebService do HIS

Será enviado um POST para o Endpoint http://<IP Servidor>:9090/consultaexame com o
CodigoItemPedido ou AccessionNumber

Solicitação:

"CodigoItemPedido": 23,

Retorno:

"CodigoItemPedido": 23,

"AccessionNumber": "23",

"Status": "Realizado",

"CodigoStatus":1

Código Status
1 Realizado
0 Não Realizado
-1 Não Encontrado (Somente Valido para
Consulta)
2 Laudo Realizado

GENESIS TECNOLOGIA LTDA

Av. Fernando Ferrari, 1080 Ed. América Centro Empresarial, sala 306 - Torre Norte
Mata da Praia – 29.066-380 - Vitória- ES
27 – 3327-6976 www.gtecnologia.com.br
 Clinux Dicomvix
__________________________________________________________________

Consulta de resultado de Exames (Laudos)

O laudo pode ser recebido pelo HIS de 2 formas:

• Enviado para o WebService do HIS

• Consulta pelo WebService do HIS

Enviado para o WebService do HIS

No momento da Assinatura do Laudo ou do Status de Conferido o laudo é enviado para o HIS
através do Endpoint definido, seguindo o seguinte padrão no Json.
O Endepoint deve ser http://<IP Servidor>:Porta/laudoexame
{

"CodigoItemPedido": 23,

"AccessionNumber": "23",

"CodigoPaciente": 11,

"BBLaudo":"asdfasdfasdf",

"BBPDF": "asdfadff",

"Medico":"Jose Carlos",

"MedicoCRM": "344",

"MedicoUF": "ES"

O campo BBLaudo é enviado o laudo em RTF codificado em base64.

O campo BBPDF é enviado o laudo em PDF codificado em base64

O médico é o responsável pela assinatura do laudo no RIS.

Consultado pelo WebService do HIS

Será enviado um POST para o Endpoint http://<IP Servidor>:9090/ConsultaLaudo com o

CodigoItemPedido ou AccessionNumber

Solicitação:

"CodigoItemPedido": 23,

GENESIS TECNOLOGIA LTDA

Av. Fernando Ferrari, 1080 Ed. América Centro Empresarial, sala 306 - Torre Norte
Mata da Praia – 29.066-380 - Vitória- ES
27 – 3327-6976 www.gtecnologia.com.br
 Clinux Dicomvix
__________________________________________________________________

O retorno é o mesmo Json enviado.

"CodigoItemPedido": 23,

"AccessionNumber": "23",

"CodigoPaciente": 11,

"BBLaudo":"asdfasdfasdf",

"BBPDF": "asdfadff",

"Medico":"Jose Carlos",

"MedicoCRM": "344",

"MedicoUF": "ES"

Acesso as Imagens do Paciente

O acesso as imagens do paciente pode ser consultado passando o CodigoItemPedido (Accession
Number) ou o Codigo do Pedido para os seguintes Endpoint.

http://<ip servidor>:9090/viewerpacs/codigoitempedido/<Codigo>
http://<ip servidor>:9090/ viewerpacs /codigopedido/<Codigo>
http://<ip servidor>:9090/ viewerpacs /acessionnumber/<Codigo>

GENESIS TECNOLOGIA LTDA

Av. Fernando Ferrari, 1080 Ed. América Centro Empresarial, sala 306 - Torre Norte
Mata da Praia – 29.066-380 - Vitória- ES
27 – 3327-6976 www.gtecnologia.com.br