- Criado por Renan Sakai de Almeida, última alteração em 16 out, 2024
CONTEÚDO
- Visão Geral
- Configurações INI
- Verbos
- Path Param
- Exemplos de Jsons de Resposta
01. VISÃO GERAL
A API beneficiaryTeeth tem como objetivo retornar os dentes do último anexo de Situação Inicial recebido pelo beneficiário. Serão destacados os dentes que estão Ausentes. Essa implementação foi criada para gerar o Odontograma no Portal Autorizador HAT com os dentes ausentes destacados.
02. CONFIGURAÇÕES INI
Para iniciar a instalação do processo, devemos configurar seu INI Protheus com a funcionalidade REST para habilitar o acesso as API´s. Documentos auxiliares:
Com o INI Protheus configurado, a nomenclatura das API´s ficará no formato: <url + Porta + chave rest definidos no INI Protheus> + /totvsHealthPlans/v1/beneficiaryTeeth
Exemplo:

Logo, a minha URL será: http://localhost:8080/rest/totvsHealthPlans/v1/beneficiaryTeeth/{subscriberId}
03. VERBOS
Seguem os verbos disponíveis na API:
| Verbo | Path | Descrição |
|---|---|---|
| GET | /beneficiaryTeeth/{subscriberId} | Retorna dados do último anexo de Situação Inicial |
04. PATH PARAMS - GET
Lista de query params obrigatórios:
| Path Param | Descrição |
|---|---|
| subscriberId | Matrícula ou CPF do beneficiário |
Exemplo de solicitação para o beneficiário 00010101000007012:

05. EXEMPLOS DO JSON DE RESPOSTA
{
"items": [
{
"supranumerary": "0",
"subscriberId": "00010101000007012",
"healthProviderId": "000004",
"idOnHealthInsurer": "12341242143434444",
"observation": "",
"tooth": "11",
"toothStatus": 1
},
{
"supranumerary": "0",
"subscriberId": "00010101000007012",
"healthProviderId": "000004",
"idOnHealthInsurer": "12341242143434444",
"observation": "",
"tooth": "12",
"toothStatus": 1
},
{
"supranumerary": "0",
"subscriberId": "00010101000007012",
"healthProviderId": "000004",
"idOnHealthInsurer": "12341242143434444",
"observation": "",
"tooth": "13",
"toothStatus": 1
},
{
"supranumerary": "0",
"subscriberId": "00010101000007012",
"healthProviderId": "000004",
"idOnHealthInsurer": "12341242143434444",
"observation": "",
"tooth": "14",
"toothStatus": 1
},
{
"supranumerary": "0",
"subscriberId": "00010101000007012",
"healthProviderId": "000004",
"idOnHealthInsurer": "12341242143434444",
"observation": "",
"tooth": "15",
"toothStatus": 1
},
{
"supranumerary": "0",
"subscriberId": "00010101000007012",
"healthProviderId": "000004",
"idOnHealthInsurer": "12341242143434444",
"observation": "",
"tooth": "16",
"toothStatus": 1
},
{
"supranumerary": "0",
"subscriberId": "00010101000007012",
"healthProviderId": "000004",
"idOnHealthInsurer": "12341242143434444",
"observation": "",
"tooth": "85",
"toothStatus": 1
},
{
"supranumerary": "0",
"subscriberId": "00010101000007012",
"healthProviderId": "000004",
"idOnHealthInsurer": "12341242143434444",
"observation": "",
"tooth": "17",
"toothStatus": 1
},
{
"supranumerary": "0",
"subscriberId": "00010101000007012",
"healthProviderId": "000004",
"idOnHealthInsurer": "12341242143434444",
"observation": "",
"tooth": "18",
"toothStatus": 5
},
{
"supranumerary": "0",
"subscriberId": "00010101000007012",
"healthProviderId": "000004",
"idOnHealthInsurer": "12341242143434444",
"observation": "",
"tooth": "21",
"toothStatus": 1
},
{
"supranumerary": "0",
"subscriberId": "00010101000007012",
"healthProviderId": "000004",
"idOnHealthInsurer": "12341242143434444",
"observation": "",
"tooth": "22",
"toothStatus": 1
},
{
"supranumerary": "0",
"subscriberId": "00010101000007012",
"healthProviderId": "000004",
"idOnHealthInsurer": "12341242143434444",
"observation": "",
"tooth": "23",
"toothStatus": 1
},
{
"supranumerary": "0",
"subscriberId": "00010101000007012",
"healthProviderId": "000004",
"idOnHealthInsurer": "12341242143434444",
"observation": "",
"tooth": "24",
"toothStatus": 1
},
{
"supranumerary": "0",
"subscriberId": "00010101000007012",
"healthProviderId": "000004",
"idOnHealthInsurer": "12341242143434444",
"observation": "",
"tooth": "25",
"toothStatus": 1
},
{
"supranumerary": "0",
"subscriberId": "00010101000007012",
"healthProviderId": "000004",
"idOnHealthInsurer": "12341242143434444",
"observation": "",
"tooth": "26",
"toothStatus": 1
},
{
"supranumerary": "0",
"subscriberId": "00010101000007012",
"healthProviderId": "000004",
"idOnHealthInsurer": "12341242143434444",
"observation": "",
"tooth": "27",
"toothStatus": 1
},
{
"supranumerary": "0",
"subscriberId": "00010101000007012",
"healthProviderId": "000004",
"idOnHealthInsurer": "12341242143434444",
"observation": "",
"tooth": "28",
"toothStatus": 1
},
{
"supranumerary": "0",
"subscriberId": "00010101000007012",
"healthProviderId": "000004",
"idOnHealthInsurer": "12341242143434444",
"observation": "",
"tooth": "31",
"toothStatus": 5
},
{
"supranumerary": "0",
"subscriberId": "00010101000007012",
"healthProviderId": "000004",
"idOnHealthInsurer": "12341242143434444",
"observation": "",
"tooth": "32",
"toothStatus": 5
},
{
"supranumerary": "0",
"subscriberId": "00010101000007012",
"healthProviderId": "000004",
"idOnHealthInsurer": "12341242143434444",
"observation": "",
"tooth": "33",
"toothStatus": 5
},
{
"supranumerary": "0",
"subscriberId": "00010101000007012",
"healthProviderId": "000004",
"idOnHealthInsurer": "12341242143434444",
"observation": "",
"tooth": "34",
"toothStatus": 1
},
{
"supranumerary": "0",
"subscriberId": "00010101000007012",
"healthProviderId": "000004",
"idOnHealthInsurer": "12341242143434444",
"observation": "",
"tooth": "35",
"toothStatus": 1
},
{
"supranumerary": "0",
"subscriberId": "00010101000007012",
"healthProviderId": "000004",
"idOnHealthInsurer": "12341242143434444",
"observation": "",
"tooth": "36",
"toothStatus": 1
},
{
"supranumerary": "0",
"subscriberId": "00010101000007012",
"healthProviderId": "000004",
"idOnHealthInsurer": "12341242143434444",
"observation": "",
"tooth": "37",
"toothStatus": 5
},
{
"supranumerary": "0",
"subscriberId": "00010101000007012",
"healthProviderId": "000004",
"idOnHealthInsurer": "12341242143434444",
"observation": "",
"tooth": "38",
"toothStatus": 5
},
{
"supranumerary": "0",
"subscriberId": "00010101000007012",
"healthProviderId": "000004",
"idOnHealthInsurer": "12341242143434444",
"observation": "",
"tooth": "41",
"toothStatus": 5
},
{
"supranumerary": "0",
"subscriberId": "00010101000007012",
"healthProviderId": "000004",
"idOnHealthInsurer": "12341242143434444",
"observation": "",
"tooth": "42",
"toothStatus": 1
},
{
"supranumerary": "0",
"subscriberId": "00010101000007012",
"healthProviderId": "000004",
"idOnHealthInsurer": "12341242143434444",
"observation": "",
"tooth": "43",
"toothStatus": 1
},
{
"supranumerary": "0",
"subscriberId": "00010101000007012",
"healthProviderId": "000004",
"idOnHealthInsurer": "12341242143434444",
"observation": "",
"tooth": "44",
"toothStatus": 1
},
{
"supranumerary": "0",
"subscriberId": "00010101000007012",
"healthProviderId": "000004",
"idOnHealthInsurer": "12341242143434444",
"observation": "",
"tooth": "45",
"toothStatus": 1
},
{
"supranumerary": "0",
"subscriberId": "00010101000007012",
"healthProviderId": "000004",
"idOnHealthInsurer": "12341242143434444",
"observation": "",
"tooth": "46",
"toothStatus": 1
},
{
"supranumerary": "0",
"subscriberId": "00010101000007012",
"healthProviderId": "000004",
"idOnHealthInsurer": "12341242143434444",
"observation": "",
"tooth": "47",
"toothStatus": 5
},
{
"supranumerary": "0",
"subscriberId": "00010101000007012",
"healthProviderId": "000004",
"idOnHealthInsurer": "12341242143434444",
"observation": "",
"tooth": "48",
"toothStatus": 5
},
{
"supranumerary": "0",
"subscriberId": "00010101000007012",
"healthProviderId": "000004",
"idOnHealthInsurer": "12341242143434444",
"observation": "",
"tooth": "51",
"toothStatus": 1
},
{
"supranumerary": "0",
"subscriberId": "00010101000007012",
"healthProviderId": "000004",
"idOnHealthInsurer": "12341242143434444",
"observation": "",
"tooth": "52",
"toothStatus": 1
},
{
"supranumerary": "0",
"subscriberId": "00010101000007012",
"healthProviderId": "000004",
"idOnHealthInsurer": "12341242143434444",
"observation": "",
"tooth": "53",
"toothStatus": 1
},
{
"supranumerary": "0",
"subscriberId": "00010101000007012",
"healthProviderId": "000004",
"idOnHealthInsurer": "12341242143434444",
"observation": "",
"tooth": "54",
"toothStatus": 1
},
{
"supranumerary": "0",
"subscriberId": "00010101000007012",
"healthProviderId": "000004",
"idOnHealthInsurer": "12341242143434444",
"observation": "",
"tooth": "55",
"toothStatus": 1
},
{
"supranumerary": "0",
"subscriberId": "00010101000007012",
"healthProviderId": "000004",
"idOnHealthInsurer": "12341242143434444",
"observation": "",
"tooth": "61",
"toothStatus": 1
},
{
"supranumerary": "0",
"subscriberId": "00010101000007012",
"healthProviderId": "000004",
"idOnHealthInsurer": "12341242143434444",
"observation": "",
"tooth": "62",
"toothStatus": 1
},
{
"supranumerary": "0",
"subscriberId": "00010101000007012",
"healthProviderId": "000004",
"idOnHealthInsurer": "12341242143434444",
"observation": "",
"tooth": "63",
"toothStatus": 1
},
{
"supranumerary": "0",
"subscriberId": "00010101000007012",
"healthProviderId": "000004",
"idOnHealthInsurer": "12341242143434444",
"observation": "",
"tooth": "64",
"toothStatus": 1
},
{
"supranumerary": "0",
"subscriberId": "00010101000007012",
"healthProviderId": "000004",
"idOnHealthInsurer": "12341242143434444",
"observation": "",
"tooth": "65",
"toothStatus": 1
},
{
"supranumerary": "0",
"subscriberId": "00010101000007012",
"healthProviderId": "000004",
"idOnHealthInsurer": "12341242143434444",
"observation": "",
"tooth": "71",
"toothStatus": 1
},
{
"supranumerary": "0",
"subscriberId": "00010101000007012",
"healthProviderId": "000004",
"idOnHealthInsurer": "12341242143434444",
"observation": "",
"tooth": "72",
"toothStatus": 1
},
{
"supranumerary": "0",
"subscriberId": "00010101000007012",
"healthProviderId": "000004",
"idOnHealthInsurer": "12341242143434444",
"observation": "",
"tooth": "73",
"toothStatus": 1
},
{
"supranumerary": "0",
"subscriberId": "00010101000007012",
"healthProviderId": "000004",
"idOnHealthInsurer": "12341242143434444",
"observation": "",
"tooth": "74",
"toothStatus": 1
},
{
"supranumerary": "0",
"subscriberId": "00010101000007012",
"healthProviderId": "000004",
"idOnHealthInsurer": "12341242143434444",
"observation": "",
"tooth": "75",
"toothStatus": 1
},
{
"supranumerary": "0",
"subscriberId": "00010101000007012",
"healthProviderId": "000004",
"idOnHealthInsurer": "12341242143434444",
"observation": "",
"tooth": "81",
"toothStatus": 1
},
{
"supranumerary": "0",
"subscriberId": "00010101000007012",
"healthProviderId": "000004",
"idOnHealthInsurer": "12341242143434444",
"observation": "",
"tooth": "82",
"toothStatus": 1
},
{
"supranumerary": "0",
"subscriberId": "00010101000007012",
"healthProviderId": "000004",
"idOnHealthInsurer": "12341242143434444",
"observation": "",
"tooth": "83",
"toothStatus": 1
},
{
"supranumerary": "0",
"subscriberId": "00010101000007012",
"healthProviderId": "000004",
"idOnHealthInsurer": "12341242143434444",
"observation": "",
"tooth": "84",
"toothStatus": 1
}
],
"hasNext": false
}
{
"code": 400,
"message": "Matricula informada 90010101000007012 nao encontrada na tabela BA1.",
"detailedMessage": "Beneficiario nao encontrado"
}