01. Consultar recursos

API: glossedAppeal
Funcionalidade: API utilizada para consultar as solicitações de recursos de glosa gravadas
Tipo de transação: GET
Endpoint: {apiversion}/glossedAppeal

Header:

Authorization: Token de autorização para comunicar com a API
idTenant: Id do tenant da operadora
tenantName: Nome do tenant da operadora

Parametros:

page: Quantidade de páginas
pageSize: Tamanho da página

healthProviderCode: Código da rede de atendimento/Prestador
expand:

02. Itens dos recursos

API: itemAppeal
Funcionalidade: API utilizada para consultar os itens das solicitações de recursos de glosa gravadas
Tipo de transação: GET
Endpoint: {apiversion}/itemAppeal

Header:

Authorization: Token de autorização para comunicar com a API
idTenant: Id do tenant da operadora
tenantName: Nome do tenant da operadora

Parametros:

page: Quantidade de páginas
pageSize: Tamanho da página

healthProviderCode: Código da rede de atendimento/Prestador

appealProtocol: Protocolo do recurso de glosa
expand:

03. Novo recurso

3.1 - Buscar protocolo

API: appealValid
Funcionalidade: API utilizada para consultar os itens das solicitações de recursos de glosa gravadas
Tipo de transação: GET
Endpoint: {apiversion}/appealValid

Header:

Authorization: Token de autorização para comunicar com a API
idTenant: Id do tenant da operadora
tenantName: Nome do tenant da operadora

Parametros:

protocol: Protocolo do lote a ser recursado

healthProviderCode: Código da rede de atendimento/Prestador

3.2 - Buscar guias do protocolo

API: appealValid
Funcionalidade: API utilizada para consultar os itens das solicitações de recursos de glosa gravadas
Tipo de transação: GET
Endpoint: {apiversion}/appealValid

Header:

Authorization: Token de autorização para comunicar com a API
idTenant: Id do tenant da operadora
tenantName: Nome do tenant da operadora

Parametros:

protocol: Protocolo do lote a ser recursado

healthProviderCode: Código da rede de atendimento/Prestador

formNumber: Número da guia

3.3 - Enviar protocolo de recurso de glosa

API: glossedAppeal
Funcionalidade: API utilizada para enviar um recurso de glosa
Tipo de transação: POST
Endpoint: {apiversion}/glossedAppeal

Header:

Authorization: Token de autorização para comunicar com a API
idTenant: Id do tenant da operadora
tenantName: Nome do tenant da operadora

Propriedades:

Propriedade	Descrição	Tamanho	Tipo	Formato	Obrigatório
protocol	Protocolo do lote a ser solicitado o recurso de glosa	8	Caractere	01234567	x
healthProviderCode	Código da rede de atendimento/Prestador	6	Caractere	012345	x
formNumber	Número da guia	8	Caractere		x
operation	Código da operação	1	Caractere		x
items	Itens a serem recursados				x
sequential	Sequencial do item a ser recursado	3	Caractere	012	x
value	Valor do item a ser recursado	3	Decimal	0.00	x
justification	Justificativa do item a ser recursado	256	Caractere		x

Body:

{
    "protocol": "Protocolo do lote",
    "healthProviderCode": "Código da rede de atendimento/Prestador",
    "formNumber": "Número da guia",
    "operation": "Código da operação",
    "items": [
        {
            "sequential": "Sequencial do item a ser recursado",
            "value": "Valor do item a ser recursado",
            "justification": "Justificativa do item a ser recursado"
        }
    ]
}

{
    "status": "Status do recurso (True/False)",
    "message": "Mensagem de resposta do recurso",
    "appealProtocol": "Protocolo do recurso se aprovado"
}

04. Relatório do Recurso

API: glossedAppeal/report

Funcionalidade: API utilizada para gerar o relatório do recurso no Portal Autorizador.
Tipo de transação: GET
Endpoint: {apiversion}/glossedAppeal/report

Header:

Authorization: Token de autorização para comunicar com a API
idTenant: Id do tenant da operadora
tenantName: Nome do tenant da operadora

Parametros:

appealProtocol: Número do protocolo

healthProviderCode: Código da rede de atendimento/Prestador

{
    "appealProtocol": "000000000001",
    "protocol": "00000501",
    "totalReconsideredValue": 151.41,
    "totalAcceptedValue": 0,
    "requestDate": "2026-01-28",
    "analysisDate": "2026-01-28",
    "status": "1",
    "appealObject": "3",
    "authType": "02",
    "guides": [
        {
            "idOnHealthInsurer": "0000050100000001",
            "subscriberId": "00010013000001003",
            "subscriberName": "CARLOS ROBERTO",
            "authorizationDate": "2026-01-28",
            "guidePaidValue": 232.16,
            "guideGlossedValue": 151.41,
            "events": [
                {
                    "eventCode": "10101012",
                    "eventDescription": "CONSULTA EM CONSULTORIO",
                    "quantity": 1,
                    "paidValue": 0,
                    "glossedValue": 151.41,
                    "reconsideredValue": 151.41,
                    "acceptedValue": 0,
                    "status": "1",
                    "gloss": "1007 - ATENDIMENTO DENTRO DA CARENCIA DO BENEFICIARIO",
                    "insurerJustification": "",
                    "providerJustification": "Teste de recurso de glosa - Nivel Evento"
                }
            ]
        }
    ]
}

{
    "appealProtocol": "000000000002",
    "protocol": "00000501",
    "totalReconsideredValue": 309.28,
    "totalAcceptedValue": 0,
    "requestDate": "2026-01-28",
    "analysisDate": "2026-01-28",
    "status": "1",
    "appealObject": "2",
    "authType": "02",
    "guides": [
        {
            "idOnHealthInsurer": "0000050100000003",
            "subscriberId": "00011008000029020",
            "subscriberName": "MARIA DO CARMO",
            "authorizationDate": "2026-01-28",
            "guidePaidValue": 0,
            "guideGlossedValue": 309.28,
            "insurerJustification": "",
            "providerJustification": "Solicitacao de guia teste",
            "events": [
                {
                    "eventCode": "10101012",
                    "eventDescription": "CONSULTA EM CONSULTORIO",
                    "quantity": 1,
                    "paidValue": 0,
                    "glossedValue": 77.12,
                    "reconsideredValue": 0,
                    "acceptedValue": 0,
                    "status": "",
                    "gloss": "1007 - ATENDIMENTO DENTRO DA CARENCIA DO BENEFICIARIO"
                },
                {
                    "eventCode": "40303136",
                    "eventDescription": "SANGUE OCULTO, PESQUISA NAS FEZES",
                    "quantity": 1,
                    "paidValue": 0,
                    "glossedValue": 232.16,
                    "reconsideredValue": 0,
                    "acceptedValue": 0,
                    "status": "",
                    "gloss": "1007 - ATENDIMENTO DENTRO DA CARENCIA DO BENEFICIARIO"
                }
            ]
        }
    ]
}

{
    "appealProtocol": "000000000003",
    "protocol": "00000502",
    "totalReconsideredValue": 383.57,
    "totalAcceptedValue": 0,
    "requestDate": "2026-01-28",
    "analysisDate": "2026-01-28",
    "status": "1",
    "appealObject": "1",
    "authType": "02",
    "insurerJustification": "",
    "providerJustification": "Justificativa Prestador teste de glosa de PEG integral",
    "guides": [
        {
            "idOnHealthInsurer": "0000050200000001",
            "subscriberId": "00010013000001011",
            "subscriberName": "LUIZ HENRIQUE",
            "authorizationDate": "2026-01-28",
            "guidePaidValue": 0,
            "guideGlossedValue": 383.57,
            "events": []
        }
    ]
}

{
    "code": 400,
    "message": "Solicitacao nao processada",
    "detailedMessage": "Protocolo informado nos atributos appealProtocole e healthProviderCode nao encontrado"
}