CONTEÚDO
- Visão Geral
- Rota
- Parâmetros de Entrada
- Retorno
- Regras de Negócio Aplicadas
- Exemplo de Utilização
01. VISÃO GERAL
O TOTVS Saúde Planos (Linha Datasul) oferece uma série de APIs para integração com o APP da Unimed Brasil.
A API Producao (Medico/Producao) tem por objetivo retornar a produção do médico naquele determinado intervalo.
A API foi desenvolvida seguindo as definições disponibilizadas no Swagger da Unimed Brasil:
a. Rota
/Medico/v1/Producao
b. Parâmetros de Entrada
Esta API deve receber os seguintes parâmetros via header ou via query parameters:
Parâmetro | Tipo de Parâmetro | Tipo de dados | Formato | Obrigatório? |
---|---|---|---|---|
header | Integer | 99999999 | Sim | |
dtInicio | query | Date | DD/MM/AAAA | Sim |
dtFim | query | Date | DD/MM/AAAA | Sim |
c. Retorno
O objeto Json de retorno da API possui a seguinte estrutura:
{ "Result": "Domínio: 0 = Erro na execução do serviço, 1 = Processamento Ok", "Message": "Mensagem de retorno que deverá ser exibida ao usuário (obrigatória em caso de erro, ou seja, Result = 0)", "Data": [ { "producaoId": 0, "nomePaciente": "Nome do paciente atendido pelo médico", "nrGuia": "Número da guia de atendimento da Unimed", "procedimentoId": 0, "nomeProcedimento": "Nome do procedimento realizado", "dtRealizacao": "Campo com a data de realização do procedimento no formato de exibição desejado", "quantidade": "Quantidade de procedimentos realizados." } ], "DebugMessage": "string" }
03. REGRAS DE NEGÓCIO APLICADAS
A API retorna uma lista contendo toda a produção médica naquele determinado intervalo.
04. EXEMPLO DE UTILIZAÇÃO
Realizada uma requisição na API utilizando a matrícula e a competência conforme abaixo:
Parâmetro | Valor |
---|---|
00004155 | |
dtInicio | 27/07/2021 |
dtFim | 27/07/2021 |
"Result": 1, "Data": [ { "quantidade": "1", "producaoId": 0, "procedimentoId": 41001010, "dtRealizacao": "27/07/2021 11:05", "nomeProcedimento": "CRANIO OU SELA TURSICA OU ORBITAS", "nrGuia": "202100001993", "nomePaciente": "ALLAN FELIPE LEMES" }, { "quantidade": "1", "producaoId": 0, "procedimentoId": 41001010, "dtRealizacao": "27/07/2021 10:53", "nomeProcedimento": "CRANIO OU SELA TURSICA OU ORBITAS", "nrGuia": "000000000000", "nomePaciente": "ALLAN FELIPE LEMES" } ], "DebugMessage": "", "Message": "" }
Por fim, os registros aqui listados podem ser validados pelo programa "Central TISS" do TOTVS 12.
--