APIs integração laboratório
APIs para realizar a integração com laboratório, como funcionam:
Para as APIs de consulta (GET)
saude.suite.betha.cloud/dados/v1/laboratorioAtendimento/confirmados:
Deve retornar uma listagem de laboratorios com a situação 'Aguardando Coleta'.
É possível fazer a filtragem por data utilizando nos parametros o campo 'dataEntrada' enviando a data no formato 'yyyy-MM-dd'.
Se não for informado uma data ele busca para o dia atual. A consulta retorna uma listagem.
saude.suite.betha.cloud/dados/v1/laboratorioAtendimento/coletados:
Deve retornar uma listagem de laboratórios com registros de coleta realizado e que estejam com a situação 'Aguardando Resultado'.
É possível fazer a filtragem por data utilizando nos parâmetros o campo 'dataEntrada' enviando a data no formato 'yyyy-MM-dd'. Se não for informado uma data ele busca para o dia atual.
A consulta retorna uma listagem.
Para as APIs de escrita (POST):
saude.suite.betha.cloud/dados/v1/laboratorioAtendimento/registrarResultados:
Para retornar as informações do laboratório a ser gravado, deve-se ajustar o payload com a seguinte estrutura:
Campos obrigatórios:
"laboratorioAtendimentoId" O id informado deve ser de um registro consumido nas APIs de GET, pois será consultado o registro no Saúde Cloud, e que a situação do 'laboratorioAtendimento' seja: 'Aguardando Coleta' ou 'Aguardando Resultado". Caso contrário, não pode prosseguir.
"cnsCpfProfissionalLiberacao" é esperado o envio de CNS ou CPF do profissional, onde será consultado o registro no Saúde Cloud, portanto precisa estar cadastrado, caso contrário não deve prosseguir.
"codigoCboLiberacao" é esperado o envio do código CBO relacionado a especialidade do profissional, onde será consultado o registro no Saúde Cloud, portanto precisa estar cadastrado, caso contrário não deve prosseguir. Com o CBO localizado, é também verificado a informação da especialidade do profissional e tambem se no cadastro do profissional a relação do profissional x CBO esta com a permissão para liberar resultados de laboratório.
“lista de ‘resultados’ ou ‘anexos’” é obrigatório o envio de uma das listas, não sendo permitido o envio das duas.
"resultados" é esperado o envio da lista de resultados gerados para o Exame e Variáveis do laboratorioAtendimento. Nesta listagem espera-se o envio: "exame": é esperado o envio dos campos 'id" e/ou 'nome'. A consulta é feita utilizando o campo 'id', se não for informado, é utilizado o campo 'nome'. Este exame deve-se ser igual ao existente no laboratorioAtendimento, caso contrário não deve prosseguir.
"variavel" é esperado o envio dos campos 'id" e/ou 'nome'. A consulta é feita utilizando o campo 'id', se não for informado, é utilizado o campo 'nome'. Esta variável deve-se ser igual ao existente no laboratorioAtendimento, caso contrário não deve prosseguir.
"resultado" valor do resultado, deve ser enviado resultado ou anexo.
"anexos" permite-se enviar uma listagem de anexos com até 20mb total. Sendo obrigatório informar os campos: 'tipoArquivo, 'nomeArquivo' e 'conteudoArquivo' devem ser informados, deve ser enviado resultado ou anexo.
"tipoArquivo" é permitido enviar arquivos com os tipos: PDF, JPG, JPEG e PNG.
"nomeArquivo" nome do arquivo.
"conteudoArquivo" obrigatório enviar o conteúdo em String no formato base64.
Campos não obrigatórios:
"resultadoLiberadoPor" se não informado é preenchido automaticamente, se informado é no máximo 16 caracteres.
"resultadoInformadoPor" se não informado é preenchido com o 'resultadoLiberadoPor', se informado é no máximo 16 caracteres.
"dataHoraResultadoLiberado" se não informado é preenchido automaticamente.
"dataHoraResultadoInformado" se não informado é preenchido automaticamente.
Campos para informação de coleta
Só é registrado se não existir registro de "profissional coleta" já cadastrado no laboratorioAtendimento.
"cnsCpfProfissionalColeta" define se vai ser registrado informações de coleta, se não informado outros campos 'coleta' nao são gravados. É esperado o envio de CNS ou CPF do profissional, onde será consultado o registro no Saúde Cloud, portanto precisa estar cadastrado, caso contrário não deve prosseguir.
"codigoCboColeta" é obrigatório se for informado 'cnsCpfProfissionalColeta', é esperado o envio do código CBO relacionado a especialidade do profissional, onde será consultado o registro no Saúde Cloud, portanto precisa estar cadastrado, caso contrário não deve prosseguir. Com o CBO localizado, é também verificada a informação da especialidade do profissional.
"dataHoraColeta" se não informado é preenchido automaticamente.
"coletadoPor" se não informado é preenchido automaticamente, se informado é no máximo 16 caracteres.
As APIS já estão publicadas no Studio aplicações:
https://aplicacoes.studio.betha.cloud/aplicacoes/swagger-ui/index.html?api=334