Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

Painel
titleColorOrange
borderStylesolid
titleRefunds - Retorna os protocolos de reembolso

Retorna os protocolos de reembolso do beneficiário

/totvsHealthPlans/attendance/v1/refunds

GET

Nota
Expandir
titleParameters
Authorization (header)

string

Cabeçalho usado para autorização das requisições (Bearer token)*required

Content-Type (header)

string

'application/json' é o formato do conteúdo*required
subscriber-id subscriberId (query)string

Matricula do beneficiário (BA1_CODINT+BA1_CODEMP+BA1_MATRIC+BA1_TIPREG+BA1_DIGITO)

(obtido através da API Beneficiaries - v1.000 (Family Contract))

*required
request-date-initial requestDateInitial (query)string (date)

Data inicial de solicitação do protocolo

Obrigatório para quando não for informado o query param protocol


request-date-final requestDateFinal (query)string (date)

Data final de solicitação do protocolo

Obrigatório para quando não for informado o query param protocol


protocol (query)stringNumero do protocolo (BOW_PROTOC)
status (query)string

Status do protocolo de reembolso, sendo:

  • 0 - Solicitação não concluída
  • 1 - Protocolado
  • 2 - Em analise
  • 3 - Reembolso aprovado
  • 4 - Reembolso rejeitado
  • 5 - Aguardando informação do Beneficiário
  • 6 - Aprovado Parcialmente
  • 7 - Cancelado
  • 8 - Reembolso revertido

pode ser enviado mais de um status. Exemplo: 0,1,2,3


page (query)

string

Valor numérico (maior que zero) representando a página solicitada
pageSize (query)

string

Valor numérico (maior que zero) representando o total de registros retornados na consulta
order (query)

string

Lista de campos para ordenação, separada por virgula (,).
fields (query)

string

Lista com o nome das propriedades JSON que serão retornadas.
filter (query)

string

Filtros seguindo o padrão ODATA
Dica
Expandir
titleRequest

Body


Não possui body!

Dica
Expandir
title(200) - Operação realizada com sucesso
hasNextbooleanIndica se ainda existem registros a serem retornados
*required
remainingRecordsnumeric (integer)Quantidade de registros ainda existem para retorno
*required
itemsarrayLista de protocolos de reembolso retornados

items.statusstring

Status do protocolo:

  • 0 - Solicitação não concluída
  • 1 - Protocolado
  • 2 - Em analise
  • 3 - Reembolso aprovado
  • 4 - Reembolso rejeitado
  • 5 - Aguardando informação do Beneficiário
  • 6 - Aprovado Parcialmente
  • 7 - Cancelado
  • 8 - Reembolso revertido
BOW_STATUS*required
items.protocolstringNumero do protocolo de reembolsoBOW_PROTOC*required
items.request-daterequestDatestring (date)Data da solicitaçãoBOW_DTDIGI*required
items.presented-amountpresentedAmountnumeric (double)Valor apresentadoBOW_VLRAPR*required
items.refunded-amountrefundedAmountnumeric (double)Valor reembolsadoBOW_VLRREE
items.payment-datepaymentDatestring (date)Data de pagamento do reembolsoBOW_PGMTO
items.beneficiary-namebeneficiaryNamestring

Nome do beneficiário solicitante

BOW_NOMUSR*required
items.observationstringObservação do Protocolo

items.linksarray

links relacionados ao recurso refunds (Padrão HATEOAS):

  • rel: expenses (Despesas do protocolo)
  • rel: attachments (Anexos do protocolo)

*required
Bloco de código
languagec#
themeEmacs
titleExemplo
linenumberstrue
{
    "items": [
        {
            "status": "2",
            "protocol": "41750520230607000001",
            "request-daterequestDate": "2023-06-07",
            "presented-amountpresentedAmount": 250,
            "refunded-amountrefundedAmount": 0,
            "payment-datepaymentDate": "",
            "beneficiary-namebeneficiaryName": "HERNANDES ALVES DA SILVA",
            "observation": "",
            "links": [
                {
                    "rel": "expenses",
                    "href": "/totvsHealthPlans/attendance/v1/refunds/41750520230607000001/expenses"
                },
                {
                    "rel": "attachments",
                    "href": "/totvsHealthPlans/attendance/v1/refunds/41750520230607000001/attachments"
                }
            ]
        },
        {
            "status": "1",
            "protocol": "41750520230607000003",
            "request-daterequestDate": "2023-06-07",
            "presented-amountpresentedAmount": 250,
            "refunded-amountrefundedAmount": 0,
            "payment-datepaymentDate": "",
            "beneficiary-namebeneficiaryName": "HERNANDES ALVES DA SILVA",
            "observation": "",
            "links": [
                {
                    "rel": "expenses",
                    "href": "/totvsHealthPlans/attendance/v1/refunds/41750520230607000003/expenses"
                },
                {
                    "rel": "attachments",
                    "href": "/totvsHealthPlans/attendance/v1/refunds/41750520230607000003/attachments"
                }
            ]
        }
    ],
    "hasNext": false,
    "remainingRecords": 0
}
Aviso
Expandir
title(406) - Parâmetros obrigatórios
codestringCódigo identificador do erro.*required
messagestringLiteral no idioma da requisição descrevendo o erro para o usuário.*required
detailedMessagestringMensagem técnica e mais detalhada do erro.*required
detailsarrayLista de objetos de erro (recursiva) com mais detalhes sobre o erro principal.*required
Bloco de código
languagec#
themeEmacs
titleExemplo
linenumberstrue
{
    "code": "E001",
    "message": "as chaves do query param estão inválidos",
    "detailedMessage": "Verifique a lista de erros no campo details para mais detalhes.",
    "details": [
        {
            "code": "E001A-406",
            "message": "Campo request-date-initialrequestDateInitial não informado",
            "detailedMessage": "Não foi informado o campo request-date-initial."
        },
        {
            "code": "E001A-406",
            "message": "Campo request-date-finalrequestDateFinal não informado",
            "detailedMessage": "Não foi informado o campo request-date-final."
        },
        {
            "code": "E001A-406",
            "message": "Campo subscriber-idsubscriberId não informado",
            "detailedMessage": "Não foi informado o campo subscriber-id."
        }
    ]
}
Aviso
Expandir
title(404) - Beneficiário não encontrado
codestringCódigo identificador do erro.*required
messagestringLiteral no idioma da requisição descrevendo o erro para o usuário.*required
detailedMessagestringMensagem técnica e mais detalhada do erro.*required
detailsarrayLista de objetos de erro (recursiva) com mais detalhes sobre o erro principal.
Bloco de código
languagec#
themeEmacs
titleExemplo
linenumberstrue
{
    "code": "E002",
    "message": "Beneficiário não encontrado",
    "detailedMessage": "Não foi encontrado nenhum beneficiário com a matricula 00011008000027013 no cadastro (BA1)"
}

...

Painel
titleColorOrange
borderStylesolid
titleExpenses - Retorna as despesas do protocolo de reembolso

Retorna as despesas do protocolo de reembolso

/totvsHealthPlans/attendance/v1/refunds/{protocol}/expenses

GET

Nota
Expandir
titleParameters
Authorization (header)

string

Cabeçalho usado para autorização das requisições (Bearer token)*required

Content-Type (header)

string

'application/json' é o formato do conteúdo*required
protocol (path)stringNumero do protocolo de reembolso (BOW_PROTOC)*required
page (query)

string

Valor numérico (maior que zero) representando a página solicitada
pageSize (query)

string

Valor numérico (maior que zero) representando o total de registros retornados na consulta
order (query)

string

Lista de campos para ordenação, separada por virgula (,).
fields (query)

string

Lista com o nome das propriedades JSON que serão retornadas.
filter (query)

string

Filtros seguindo o padrão ODATA
Dica
Expandir
titleRequest

Body


Não possui body!

Dica
Expandir
title(200) - Operação realizada com sucesso
hasNextbooleanIndica se ainda existem registros a serem retornados
*required
remainingRecordsnumeric (integer)Quantidade de registros ainda existem para retorno
*required
itemsarrayLista de despesas do protocolo de reembolso

items.statusstring

Status da despesa, sendo: 

  • 0 - Negado
  • 1 - Autorizado
B1N_IMGSTA*required
items.subscriber-idsubscriberIdstringMatricula do beneficiário da despesaB1N_MATRIC*required
items.beneficiary-namebeneficiaryNamestringNome do beneficiárioBA1_NOMUSR*required
items.protocolstringNumero do protocolo B1N_PROTOC*required
items.sequentialstringSequencial da despesa no protocoloB1N_SEQUEN*required
items.procedure-classprocedureClassstring

Código do tipo de despesa utilizado

B1N_TIPSER*required
items.table-codetableCodestringCódigo da tabela da despesaB1N_CODPAD*required
items.procedure-codeprocedureCodestringCódigo da despesaB1N_CODPRO*required
items.procedure-descriptionprocedureDescriptionstringDescrição da despesaBR8_DESCRI*required
items.continuous-usecontinuousUsestring

Medicamento de uso continuo:

  • 0 - Não
  • 1 - Sim
B1N_USOCON*required
items.quantitynumeric (integer)Quantidade de despesaB1N_QTDPRO*required
items.expense-amountexpenseAmountnumeric (double)Valor apresentado da despesaB1N_VLRAPR*required
items.total-expense-amounttotalExpenseAmountnumeric (double)Valor total da despesaB1N_VLRTOT*required
items.refunded-amountrefundedAmountnumeric (double)Valor reembolsadoB1N_VLRREE*required
items.unreferenced-network-identifierunreferencedNetworkIdentifierstringCPF/CNPJ do prestador de serviçoB1N_PRCNPJ*required
items.unreferenced-network-nameunreferencedNetworkNamestringNome do prestador de serviçoB1N_PRNOME*required
items.state-abbreviationstateAbbreviationstringEstado do prestadorB1N_EST*required
items.city-codecityCodestring

Código do Município do prestador

B1N_CODMUN*required
items.document-codedocumentCodestring

Código do tipo de comprovante

B1N_TIPDOC (BBS_COD)*required
items.document-descriptiondocumentDescriptionstring

Descrição do tipo de comprovante

B1N_TIPDOC *required
items.document-numberdocumentNumberstringNumero do documentoB1N_NUMDOC
items.document-datedocumentDatestring (date)Data de emissão do documentoB1N_DATDOC*required
items.execution-dateexecutionDatestring (date)Data de execução da despesaB1N_DATPRO*required
Bloco de código
languagec#
themeEmacs
titleExemplo
linenumberstrue
{
    "items": [
        {
            "status": "1",
            "subscriber-idsubscriberId": "00011008000027010",
            "beneficiary-namebeneficiaryName": "HERNANDES ALVES DA SILVA",
            "protocol": "41750520230605000040",
            "sequential": "001",
            "procedure-classprocedureClass": "000001",
            "table-codetableCode": "01",
            "procedure-codeprocedureCode": "10101012",
            "procedure-descriptionprocedureDescription": "CONSULTA EM CONSULTORIO",
            "continuous-usecontinuousUse": "0",
            "quantity": 1,
            "expense-amountexpenseAmount": 1000,
            "total-expense-amounttotalExpenseAmount": 1000,
            "refunded-amountrefundedAmount": 0,
            "unreferenced-network-identifierunreferencedNetworkIdentifier": "77077733000159",
            "unreferenced-network-nameunreferencedNetworkName": "JOSE",
            "state-abbreviationstateAbbreviation": "SP",
            "city-codecityCode": "3500105",
            "document-codedocumentCode": "03",
            "document-descriptiondocumentDescription": "RECIBO",
            "document-numberdocumentNumber": "2222223",
            "document-datedocumentDate": "2023-06-02",
            "execution-dateexecutionDate": "2023-06-02"
        }
    ],
    "hasNext": false,
    "remainingRecords": 0
}
Aviso
Expandir
title(406) - Parâmetros obrigatórios
codestringCódigo identificador do erro.*required
messagestringLiteral no idioma da requisição descrevendo o erro para o usuário.*required
detailedMessagestringMensagem técnica e mais detalhada do erro.*required
detailsarrayLista de objetos de erro (recursiva) com mais detalhes sobre o erro principal.*required
Bloco de código
languagec#
themeEmacs
titleExemplo
linenumberstrue
{
    "code": "E001",
    "message": "as chaves do query param estão inválidos",
    "detailedMessage": "Verifique a lista de erros no campo details para mais detalhes.",
    "details": [
        {
            "code": "E001A-406",
            "message": "Campo request-date-initialrequestDateInitial não informado",
            "detailedMessage": "Não foi informado o campo request-date-initialrequestDateInitialrequestDateInitial."
        },
        {
            "code": "E001A-406",
            "message": "Campo request-date-finalrequestDateFinal não informado",
            "detailedMessage": "Não foi informado o campo request-date-finalrequestDateFinal."
        },
        {
            "code": "E001A-406",
            "message": "Campo subscriber-idsubscriberId não informado",
            "detailedMessage": "Não foi informado o campo subscriber-idsubscriberId."
        }
    ]
}
Aviso
Expandir
title(404) - Beneficiário não encontrado
codestringCódigo identificador do erro.*required
messagestringLiteral no idioma da requisição descrevendo o erro para o usuário.*required
detailedMessagestringMensagem técnica e mais detalhada do erro.*required
detailsarrayLista de objetos de erro (recursiva) com mais detalhes sobre o erro principal.
Bloco de código
languagec#
themeEmacs
titleExemplo
linenumberstrue
{
    "code": "E002",
    "message": "Beneficiário não encontrado",
    "detailedMessage": "Não foi encontrado nenhum beneficiário com a matricula 00011008000027013 no cadastro (BA1)"
}

...