Home Soluções Saúde

Atalhos

Árvore de páginas

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 glosa8Caractere01234567x

healthProviderCode

Código da rede de atendimento/Prestador6Caractere012345x

formNumber

Número da guia8Caractere
x

operation

Código da operação1Caractere
x

items

Itens a serem recursados


x

sequential

Sequencial do item a ser recursado3Caractere012x

value

Valor do item a ser recursado3Decimal0.00x

justification

Justificativa do item a ser recursado256Caractere
x


Body:

JSON de envio
{
    "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"
        }
    ]
}
JSON de resposta
{
    "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

JSON de retorno protocolo de evento
{
    "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"
                }
            ]
        }
    ]
}
JSON de retorno protocolo de guia
{
    "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"
                }
            ]
        }
    ]
}
JSON de retorno de protocolo integral
{
    "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": []
        }
    ]
}
JSON Erro 400 padrão
{
    "code": 400,
    "message": "Solicitacao nao processada",
    "detailedMessage": "Protocolo informado nos atributos appealProtocole e healthProviderCode nao encontrado"
}



  • Sem rótulos