O TOTVS Saúde Planos (Linha Datasul) oferece uma série de APIs para integração.
A API Status do Documento/Movimentos tem o objetivo de buscar e enviar documentos para auditoria, e liberar documentos do Revisão de Contas.
As APIs foram desenvolvidas seguindo as definições disponibilizadas no Swagger da Unimed Brasil.
Os Campos apresentados estão detalhados na tabela abaixo:
| Campo | Descrição | ||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Documento | Campos chave do Documento.
| ||||||||||||||
Fatura | Campos chave da Fatura.
| ||||||||||||||
| Parâmetros | Parâmetros para liberar documentos do Revisão de Contas.
| ||||||||||||||
| Situação Guia | Descrição Situação | Situação Movimento |
|---|---|---|
| 1 | DIGITADA | DIGITADO |
| 2 | AUTORIZADA | AUTORIZADO Obs: Caso o procedimento conter a quantidade zerada o status do movimento será considerado NEGADO. |
| 3 | CANCELADA | CANCELADO |
| 4 | PROCESSADO PELO CONTAS | Se todas as quantidades do movimento já estiverem executadas pelo Contas, será considerado o status EXECUTADO. Obs: Caso o procedimento conter a quantidade zerada o status do movimento será considerado NEGADO. |
| 8 | NEGADA | NEGADO |
| Quando o procedimento não se enquadrar nas situação acima, será considerado o status EM ANALISE. | ||
Os resultados apresentados pela API podem ser validados e visualizados nos seguintes programas/relatórios:
Ao acessar o programa na tela inicial está disponível a opção de Busca Avançada:
Através da Busca Avançada é possível pesquisar o beneficiário pelo CPF ou pela Carteira do Beneficiário:
Ao informar um dos campos e clicar em buscar será retornado os dados do beneficiário e habilitado a opção Autorização:
Ao clicar em Autorização abrirá uma tela onde é possível selecionar o intervalo inicial e final. Ao clicar em pesquisar será retornado uma lista com todas as guias do beneficiário no período determinado:
Ao realizar a pesquisa através do programa Consulta Unificada de Pessoas ficará disponibilizado a opção Autorizações no menu. Ao clicar nesta opção o programa permitirá visualizar as guias de atendimento que estão associados ao beneficiário. Nesta tela estará presente o status da guia através da coluna Situação.
Ao clicar no número da guia será aberta o programa Manutenção Autorização Guias AT0110Z onde é possível verificar os dados da guia e seu status. Esta tela é apenas para consulta.
Mais detalhes sobre o programa Consulta Unificada de Pessoas pode ser visto através da documentação: https://tdn.totvs.com/x/oHQxHQ.
Ao clicar em Autorização e pesquisar uma guia será exibido os detalhes e disponibilizado a opção F8 - Infor. Adic:
Ao apertar F8 aparecerá a opção Mov AT:
Ao clicar nessa opção será exibida um filtro para selecionar as situações das guias. No caso deste exemplo serão retornadas as guias com as situações de 1- Digitada até 23 - Em Pericia:
Após a escolha serão exibidas todas as guias do beneficiário com sua situação:
Ao clicar em Autorização e pesquisar uma guia será exibido os detalhes e disponibilizado a opção F3 - Inf. Guia:
Ao apertar F3 irá aparecer a opção Guia:
Ao apertar na opção Guia irá aparecer uma dela com as informações sobre a guia e a opção Histórico:
Ao selecionar a opção será exibido uma tela com o histórico da situação da guia contendo todos os status e descrições que a guia teve:
Será exibido também a data de atualização de cada status:
Mais detalhes sobre o programa Manutenção Autorização Guias pode ser visto através da documentação: https://tdn.totvs.com/x/CfhYDQ
Exemplo de como pode ser realizada a validação da Listagem e Busca de Guias, explicada na sessão 3. Como Validar as Informações, que utiliza o programa Consulta Unificada de Pessoas (hvp.personInformation).
Para isso, foi realizada uma requisição na API utilizando a carteira do beneficiário, a data inicial e final do período desejado. Para uma melhor visualização foi utilizada a mesma data inicial e final para retornar apenas as guias de um dia, neste caso do dia 01/07/2020. Os parâmetros utilizados podem ser visualizados abaixo:
A API retornou os seguintes dados:
Pode-se observar que o retorno contém 3 guias: 202000001997, 202000001994 e 202000001993.
No programa Consulta Unificada de Pessoas foram utilizados os mesmos parâmetros da requisição da API, ou seja, a carteira do beneficiário, data inicial e final. O resultado pode ser visto abaixo:
Observando o retorno da API e da Consulta Unificada de Pessoas vemos que as guias retornadas e seus dados são os mesmos.