Árvore de páginas

Versões comparadas

Chave

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

...

  1. Visão Geral
  2. Exemplo de utilização
    1. Beneficiaries - Retorna os beneficiários da operadora de saúde
    2. SupplementaryHealth - Retorna os dados de saúde suplementar do beneficiário
    3. Eligibility - Retorna a elegibilidade do beneficiário
    4. RescissionFine - Retorna a multa contratual do beneficiário
    5. UtilizationStatement/base64 - Retorna pdf do extrato de utilização do beneficiário
    6. ReadjustmentStatementReadjustment/base64 - Retorna o pdf do extrato de reajuste do beneficiário
    7. IncomeTax/base64 - Retorna o pdf da declaração de imposto de renda do beneficiário
    8. FinanceStatement/base64 - Retorna o pdf do extrato financeiro do beneficiário
    9. AnnualStatementDebts/base64 - Retorna o pdf da declaração anual de quitação de débitos do beneficiário
    10. BlockContracts - Realiza o bloqueio direto do beneficiário/família
  3. Tela api beneficiaries
    1. Outras Ações / Ações relacionadas
  4. Tela api beneficiaries
    1. Principais Campos e Parâmetros
  5. Tabelas utilizadas

...

info
Dica
titleAutenticação das APIs

API para obtenção do token de acesso às API’s REST no Protheus

De posse então do access_token obtido na api token, basta fazer a requisição à API desejada incluindo no cabeçalho o parâmetro Authorization com o valor Bearer mais o token de acesso.

titleNomenclatura das APIs

Para nome composto, as APIs utilizam o padrão camelCase e quando a houver paginação será utilizado o padrão tudo minúsculo separado por hífen para os campos dentro do array items


02. EXEMPLO DE UTILIZAÇÃO

...

Painel
titleColorOrange
borderStylesolid
titleBeneficiaries - Retorna os beneficiários da operadora de saúde

Retorna os beneficiários cadastrados na operadora de saúde.

/totvsHealthPlans/familyContract/v1/beneficiaries

GET

Nota
Expandir
titleParameters
health-insurer-code all-family login-usercompany-code contract-code contract-version-code subcontract-code subcontract-version-code family-code social-name beneficiary-type page Valor numérico (maior que zero) representando
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
healthInsurerCode (query)stringCódigo da operadora (BA1_CODINT)*required
login-user (query)stringFiltro de beneficiários pelo usuário de login do portal (BSW_LOGUSR)
allFamily (query)string

Define se será retornado todos os beneficiários do login, quando utilizado o query param

loginUser, sendo:

  • 0 - Não
  • 1 - Sim

companyCode (query)stringFiltro de beneficiários por empresa (BA1_CODEMP)
contractcode (query)string

Filtro de beneficiários por contrato (BA1_CONEMP)


contractVersionCode (query)string

Filtro de beneficiários por versão do contrato (BA1_VERCON)


subcontractCode (query)string

Filtro de beneficiários por subcontrato (BA1_SUBCON)


subcontractVersioncode (query)string

Filtro de beneficiários por versão do subcontrato (BA1_VERSUB)


familycode (query)stringFiltro de beneficiários por código da família (BA1_MATRIC)
name (query)stringFiltro de beneficiários por nome
socialName (query)stringFiltro de beneficiários por nome social
beneficiaryType (query)string

Filtro de beneficiários por tipo (BA1_TIPUSU), sendo:

  • T - Titular
  • D - Dependente
  • A - Agregado

situation (query)string

Filtro de beneficiários por situação, sendo:

  • 1 - Ativo
  • 2 - Inclusão futura
  • 3 - Bloqueio futuro
  • 4 - Bloqueado

subscriberId (query)string

Filtro de beneficiários pela carteirinha (BA1_CODINT+BA1_CODEMP+BA1_TIPREG+BA1_DIGITO)


subscriberIdOrCpfstring

Filtro de beneficiários pela carteirinha ou cpf


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 beneficiários retornados

items.company-_codestring

Código da empresa do beneficiário

BA1_CODEMP*required
items.contract-_codestring

Código do contrato (Pessoa jurídica)

BA1_CONEMP
items.contract-_version-_codestringVersão do contrato (Pessoa jurídica)BA1_VERCON
items.subcontract-_codestringCódigo do subcontrato (Pessoa jurídica)BA1_SUBCON
items.subcontract-_version-_codestringVersão do subcontrato (Pessoa jurídica)BA1_VERSUB
items.family-_codestringCódigo da família do beneficiárioBA1_MATRIC*required
items.subscriber-_idstring

Matricula do beneficiário

BA1_CODINT+BA1_CODEMP+BA1_MATRIC+BA1_TIPREG+BA1_DIGITO*required
items.namestringNome do beneficiárioBA1_NOMUSR*required
items.social-_namestringNome social do beneficiárioBA1_NOMSOC
items.birth-_datestring (date)Data de nascimento do beneficiárioBA1_DATNAS*required
items.effective-_datestring (date)Data de inclusão do beneficiárioBA1_DATINC*required
items.beneficiary-_typestring

Tipo do beneficiário, sendo:

  • T - Titular
  • D - Dependente
  • A - Agregado
BA1_TIPUSU*required
items.situationstring

Situação do beneficiário, sendo:

  • 1 - Ativo
  • 2 - Inclusão futura
  • 3 - Bloqueio futuro
  • 4 - Bloqueado
BA1_DATINC e BA1_DATBLO*required
items.block-_datestring (date)Data de bloqueio do beneficiárioBA1_DATBLO
items.beneficiary-_cpfstringNumero do CPF do beneficiárioBA1_CPFUSR
Bloco de código
languagec#
themeEmacs
titleExemplo
linenumberstrue
{
    "items": [
        {
            "company-_code": "1008",
            "contract-_code": "000000000001",
            "contract-_version-_code": "001",
            "subcontract-_code": "000000001",
            "subcontract-_version-_code": "001",
            "family-_code": "000001",
            "subscriber-_id": "00011008000001010",
            "name": "CLODOALDO SILVA",
            "social-_name": "",
            "birth-_date": "1970-10-10",
            "effective-_date": "2021-02-12",
            "beneficiary-_type": "T",
            "situation": "1",
            "block-_date": "",
            "beneficiary-_cpf": "51351540009"
        },
        {
            "company-_code": "1008",
            "contract-_code": "000000000001",
            "contract-_version-_code": "001",
            "subcontract-_code": "000000002",
            "subcontract-_version-_code": "001",
            "family-_code": "000002",
            "subscriber-_id": "00011008000002017",
            "name": "FABIANA SOPHIA MELO",
            "social-_name": "",
            "birth-_date": "1986-12-12",
            "effective-_date": "2021-03-08",
            "beneficiary-_type": "T",
            "situation": "1",
            "block-_date": "",
            "beneficiary-_cpf": "77476519965"
        },
        {
            "company-code": "1008"],
            "contract-code"hasNext": "000000000001"true,
            "contract-version-coderemainingRecords": "001",
            "subcontract-code": "000000003",
            "subcontract-version-37
}
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": "001E001",
    "message": "Existem chaves obrigatórias que não   "family-code": "000003foram informadas.",
    "detailedMessage": "Verifique a lista de erros no campo details  "subscriber-id": "00011008000003013para mais detalhes.",
            "namedetails": "PAULO AZEVEDO",[
            "social-name": "",{
            "birth-datecode": "1980E001-10-13406",
            "effective-datemessage": "2021Chave health-04insurer-05code obrigatória",
            "beneficiary-typedetailedMessage": "T",
Não foi informado no queryParams da requisição a     "situation": "1",chave health-insurer-code."
        }
    "block-date": "",
            "beneficiary-cpf": "55555555555"
        },
        {
            "company-code": "1008",
            "contract-code"]
}


Âncora
supplementaryHealth
supplementaryHealth

Painel
titleColorOrange
borderStylesolid
titleSupplementaryHealth - Retorna os dados pessoais

Retorna os dados de saúde suplementar do beneficiário

/totvsHealthPlans/familyContract/v1/beneficiaries/{subscriberId}/supplementaryHealth

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
subscriberId (Path)stringMatricula do beneficiário (BA1_CODINT+BA1_CODEMP+BA1_MATRIC+BA1_TIPREG+BA1_DIGITO)*required
Dica
Expandir
titleRequest

Body


Não possui body!

Dica
Expandir
title(200) - Operação realizada com sucesso

name

stringNome do beneficiárioBA1_NOMUSR*required

subscriberId

stringMatrícula do beneficiárioBA1_CODINT+BA1_CODEMP+BA1_MATRIC+BA1_TIPREG+BA1_DIGITO*required

birthdate

string(date)Data de nascimento
*required

nationalHealthCard

string

Cartão nacional de saúde


*required

registrationPlanAns

string

Cod. plano na ANS


*required

assistSegmentationPlan

stringSegmentação Assistencial do Plano
*required

operatorRegistrationAns

stringCod. registro da operadora na ANS
*required

carrierContactInformation

stringInf. de contato com a Ope.
*required

ansContactInformation

stringInf. de contato ANS
*required

TemporaryPartialCoverageEndDate

string(date)

Dt. término da cobertura parcial temporária


*required

AccommodationStandard

stringPadrão de acomodação
*required

hiringType

stringTipo de contratação
*required

geographicCoverageArea

stringÁrea de abrangência geográfica
*required

productName

stringNome do produto
*required

carrierTradeName

string

Nome fantasia da operadora


*required

benefitAdministratorTradeName

string

Nome fantasia da administradora de benefícios


*required

nameLegalEntityContractingCollectivePlan

stringNome pessoa jurídica contratante do plano coletivo
*required

effectiveDatePlan

string(date)Dt. início da vigência do plano
*required

contractPolicyNumber

stringNúmero contrato/apólice
*required

dateContractingHealthPlan

stringDt. contratação do plano de saúde
*required

maximumPeriodProvidedContractGracePeriod

stringPrazo máximo previsto no contrato de carência
*required

planInformation

stringInformações do plano
*required

information

stringInformações
*required

timeOutpatientProcedures

stringCarência procedimentos ambulatoriais

waitingHospitalProcedures

stringCarência procedimentos hospitalares

termDeliveryProcedures

stringCarência procedimentos parto a termo

deficiencyDentalProcedures

stringCarência procedimentos odontológicos

socialName

stringNome social

Bloco de código
languagec#
themeEmacs
titleExemplo
linenumberstrue
{
    "name": "SHELDON COOPER",
    "subscriberId": "00011077000001013",
    "birthdate": "1990-05-01",
    "nationalHealthCard": "169217132120001",
    "registrationPlanAns": "123456: "000000000001",
    "assistSegmentationPlan": "AMBULATORIAL + HOSPITALAR COM OBSTETRICIA",
   "contract-version-code": "001",
            "subcontract-code": "000000003 "operatorRegistrationAns": "417505",
    "carrierContactInformation": "<strong>Endereço:</strong> Av. , nº  - Bairro  - São Paulo-SP -CEP: 00000-000 <br><strong>Disque: </strong>0800 000 0000<br><strong>Site: </strong>www.operadora.org.br",
    "ansContactInformation": "<strong>Endereço:</strong> Av. Bela Cintra,   986 "subcontract-version-code": "001",
            "family-code": "000004",
         9º andar - Edifício Rachid Saliba - Bairro Jardim Paulista -São Paulo-São Paulo-CEP: 01415-000 <br><strong>Disque ANS: </strong>0800 701 9656<br><strong>Site: </strong>www.ans.gov.br",
    "subscriber-idTemporaryPartialCoverageEndDate": "00011008000004010",
    "AccommodationStandard":    "APARTAMENTO SIMPLES",
    "namehiringType": "ANDRECOLETIVO EMPRESARIAL",
        "geographicCoverageArea": "NACIONAL",
    "social-nameproductName": "REDE CREDENCIADA",
    "carrierTradeName":    "OPERADORA 417505",
    "birth-datebenefitAdministratorTradeName": "1985-01-17GCG PJ",
    "nameLegalEntityContractingCollectivePlan":    "CLIENTE PADRAO",
    "effective-dateeffectiveDatePlan": "20212022-0402-2701",
    "contractPolicyNumber": "123456",
       "beneficiary-type"dateContractingHealthPlan": "T2022-02-01",
            "situation"maximumPeriodProvidedContractGracePeriod": "1",
    "planInformation":    "Plano Regulamentado",
    "block-dateinformation": "Informações",
    "timeOutpatientProcedures": "",
       "beneficiary-cpf"waitingHospitalProcedures": "53017895890",
        }
    ]"termDeliveryProcedures": "",
    "hasNextdeficiencyDentalProcedures": true"",
    "remainingRecordssocialName": 37""
}
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": "Existem chaves obrigatórias que não foram informadas.",
    "detailedMessage": "Verifique a lista de erros no campo details para mais detalhes.",
    "details": [
        {
            "code": "E001-406",
            "message": "Chave health-insurer-codesubscriberId obrigatória",
            "detailedMessage": "Não foi informado no queryParamspathParams da requisição a chave  health-insurer-codesubscriberId."
        }
    ]
}

...

 ]
}
Aviso

...

Painel
titleColorOrange
borderStylesolid
titleSupplementaryHealth - Retorna os dados pessoais

Retorna os dados pessoais do beneficiário

/totvsHealthPlans/familyContract/v1/beneficiaries/{subscriberId}/supplementaryHealth

GET

Body

Não possui body!

Nota
Authorization
Expandir
Parameters
title
(404) - Usuário não encontrado
code
header)
string
Cabeçalho usado para autorização das requisições (Bearer token)
Código identificador do erro.*required
Content-Type (header)
messagestring
'application/json' é o formato do conteúdo
Literal no idioma da requisição descrevendo o erro para o usuário.*required
subscriberId (Path)
detailedMessagestring
Matricula do beneficiário (BA1_CODINT+BA1_CODEMP+BA1_MATRIC+BA1_TIPREG+BA1_DIGITO)
Mensagem técnica e mais detalhada do erro.*required
Dica
Expandir
titleRequest
detailsarrayLista de objetos de erro (recursiva) com mais detalhes sobre o erro principal.
Bloco de código
languagec#
themeEmacs
titleExemplo
linenumberstrue
{
    "code": "E003",
    "message": "Usuário não encontrado.",
    "detailedMessage": "Não foi possível retornar os dados do beneficiário através da matrícula informada."
}


Âncora
eligibility
eligibility

Painel
titleColorOrange
borderStylesolid
titleEligibility - Retorna a elegibilidade do beneficiário

Retorna a elegibilidade do beneficiário

/totvsHealthPlans/familyContract/v1/beneficiaries/{subscriberId}/eligibility

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
subscriberId (Path)stringMatricula do beneficiário (BA1_CODINT+BA1_CODEMP+BA1_MATRIC+BA1_TIPREG+BA1_DIGITO)*required
Dica
Expandir
titleRequest

Body


Não possui body!

Dica
Expandir
title(200) - Operação realizada com sucesso
subscriberIdstringMatrícula do beneficiárioBA1_CODINT+BA1_CODEMP+BA1_MATRIC+BA1_TIPREG+BA1_DIGITO*required
oldSubscriberIdstringMatrícula antiga do beneficiárioBA1_MATANT
namestringNome do BeneficiárioBA1_NOMUSR*required
socialNamestring

Nome social do beneficiário

BA1_NOMSOC
interChangestring

Intercambio



originHealthInsurerCodestringOperadora OrigemBA1_OPEORI*required
healthPlanstringProdutoBA1_CODPLA*required

cardValidity

string(date)Validade do cartãoBA1_DTVLCR

nationalHealthCard

stringCartão nacional de saúdeBA1_NRCRNA*required

cardCopy

string

Via do cartão

BA1_VIACAR*required

coverage

stringAbrangência
*required

holder

stringTitular
*required

company

stringEmpresaBA1_CODEMP*required

blockDate

string (date)Data de bloqueioBA1_DATBLO

ansHealthInsurerCode

string

Reg. Operadora ANS


*required

eligible

string

Elegível


*required

negativeReasonCode

stringCod. motivo negativa

negativeReasonDescription

stringDesc. motivo negativa
Dica
Expandir
title(200) - Operação realizada com sucesso

name

stringNome do beneficiárioBA1_NOMUSR*required

subscriberId

stringMatrícula do beneficiárioBA1_CODINT+BA1_CODEMP+BA1_MATRIC+BA1_TIPREG+BA1_DIGITO*required

birthdate

string(date)Data de nascimento*required

nationalHealthCard

string

Cartão nacional de saúde

*required

registrationPlanAns

string

Cod. plano na ANS

*required

assistSegmentationPlan

stringSegmentação Assistencial do Plano*required

operatorRegistrationAns

stringCod. registro da operadora na ANS*required

carrierContactInformation

stringInf. de contato com a Ope.*required

ansContactInformation

stringInf. de contato ANS*required

TemporaryPartialCoverageEndDate

string(date)

Dt. término da cobertura parcial temporária

*required

AccommodationStandard

stringPadrão de acomodação*required

hiringType

stringTipo de contratação*required

geographicCoverageArea

stringÁrea de abrangência geográfica*required

productName

stringNome do produto*required

carrierTradeName

string

Nome fantasia da operadora

*required

benefitAdministratorTradeName

string

Nome fantasia da administradora de benefícios

*required

nameLegalEntityContractingCollectivePlan

stringNome pessoa jurídica contratante do plano coletivo*required

effectiveDatePlan

string(date)Dt. início da vigência do plano*required

contractPolicyNumber

stringNúmero contrato/apólice*required

dateContractingHealthPlan

stringDt. contratação do plano de saúde*required

maximumPeriodProvidedContractGracePeriod

stringPrazo máximo previsto no contrato de carência*required

planInformation

stringInformações do plano*required

information

stringInformações*required

timeOutpatientProcedures

stringCarência procedimentos ambulatoriais

waitingHospitalProcedures

stringCarência procedimentos hospitalares

termDeliveryProcedures

stringCarência procedimentos parto a termo

deficiencyDentalProcedures

stringCarência procedimentos odontológicos

socialName

stringNome social

Bloco de código
languagec#
themeEmacs
titleExemplo
linenumberstruetrue
{
    "subscriberId": "00011009000003020",
    "oldSubscriberId": "131664697",
    "name": "MARIO IGOR RAFAEL CARDOSO",{
    "namesocialName": "SHELDON COOPER",
    "subscriberIdinterChange": "00011077000001013NAO",
    "birthdateoriginHealthInsurerCode": "1990-05-010001",
    "nationalHealthCardhealthPlan": "169217132120001REDE CREDENCIADA",
    "registrationPlanAnscardValidity": "123456",
    "assistSegmentationPlannationalHealthCard": "223868970650002"AMBULATORIAL,
  + HOSPITALAR COM OBSTETRICIA"cardCopy": "0",
    "operatorRegistrationAnscoverage": "41750501",
    "carrierContactInformationholder": "<strong>Endereço:</strong> Av. , nº  - Bairro  - São Paulo-SP -CEP: 00000-000 <br><strong>Disque: </strong>0800 000 0000<br><strong>Site: </strong>www.operadora.org.brBRYAN RENATO RAUL DA PAZ",
    "company": "EMPRESA PTU A100 XML",
    "blockDate": "2021-03-10",
    "ansContactInformationansHealthInsurerCode": "<strong>Endereço:</strong> Av. Bela Cintra, nº 986 - 9º andar - Edifício Rachid Saliba - Bairro Jardim Paulista -São Paulo-São Paulo-CEP: 01415-000 <br><strong>Disque ANS: </strong>0800 701 9656<br><strong>Site: </strong>www.ans.gov.br","417505",
    "eligible": "NAO",
    "negativeReasonCode": "1016",
    "negativeReasonDescription": "BENEFICIARIO COM ATENDIMENTO SUSPENSO"
}
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
{
    "TemporaryPartialCoverageEndDatecode": "E001",
    "AccommodationStandardmessage": "APARTAMENTO SIMPLES",
    "hiringType": "COLETIVO EMPRESARIALExistem chaves obrigatórias que não foram informadas.",
    "geographicCoverageAreadetailedMessage": "NACIONAL",
Verifique a lista  "productName": "REDE CREDENCIADA",
    "carrierTradeName": "OPERADORA 417505de erros no campo details para mais detalhes.",
    "benefitAdministratorTradeNamedetails": "GCG PJ",[
    "nameLegalEntityContractingCollectivePlan": "CLIENTE PADRAO",
  {
  "effectiveDatePlan": "2022-02-01",
    "contractPolicyNumber": "123456",
    "dateContractingHealthPlancode": "2022E001-02-01406",
       "maximumPeriodProvidedContractGracePeriod": "",
    "planInformationmessage": "PlanoChave subscriberId Regulamentadoobrigatória",
    "information": "Informações",
        "timeOutpatientProceduresdetailedMessage": "",
Não foi informado no "waitingHospitalProcedures": "",
    "termDeliveryProcedures": "",
pathParams da requisição a chave  subscriberId."
       "deficiencyDentalProcedures": "", }
    "socialName": ""]
}
Aviso
Expandir
title(406404) - Parâmetros obrigatóriosUsuá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.*required
Bloco de código
languagec#
themeEmacs
titleExemplo
linenumberstrue
{
    "code": "E001E002",
    "message": "Existem chaves obrigatórias que Usuário não foram informadasencontrado.",
    "detailedMessage": "Verifique a lista de erros no campo details para mais detalhes.",
    "details": [
        {
            "code": "E001-406",
            "message": "Chave subscriberId obrigatória",
            "detailedMessage": "Não foi informado no pathParams da requisição a chave  subscriberId."
        }
    ]
}
Aviso
Não foi possível retornar os dados do beneficiário através da matrícula informada."
}


Âncora
rescissionFine
rescissionFine

Painel
titleColorOrange
borderStylesolid
titleRescissionFine - Retorna os dados da rescisão do beneficiário

Retorna os dados de rescisão de contrato do beneficiário

/totvsHealthPlans/familyContract/v1/beneficiaries/{subscriberId}/rescissionFine

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
subscriberId (path)stringMatricula do beneficiário (BA1_CODINT+BA1_CODEMP+BA1_MATRIC+BA1_TIPREG+BA1_DIGITO)*required
allFamily (query)stringRescisão de toda família ( 1- Sim)
Dica
Expandir
titleRequest

Body


Não possui body!

Dica
Expandir
title(200) - Operação realizada com sucesso
productstringCod. produto
*required
productDescriptionstringDesc. produto
*required
inclusionDatestring(date)Data de inclusão
*required
fidelityMonthsstringMeses de fidelidade
*required
fidelityFinalDatestring(date)Data final da fidelidade
*required
totalAmountFinestringValor total da multa
*required
beneficiariesarrayBeneficiários
*required
subscriberIdstringMatricula do beneficiário
*required
namestringNome do beneficiário
*required
amountFinestringValor multa
*required
Expandir
title(404) - Usuário não encontrado
Lista de objetos de erro (recursiva) com mais detalhes sobre o erro principal.
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
detailsarray
Bloco de código
languagec#
themeEmacs
titleExemplo
linenumberstruetrue
{
    "product": "0001",
    "productDescription": "PRODUTO EXEMPLO 1",
    "inclusionDate": "2023-04-18",
    "fidelityMonths": 12,
    "fidelityFinalDate": "2024-04-18",
    "totalAmountFine": 363,{
    "codebeneficiaries": "E003", [
        {
    "message        "subscriberId": "Usuário não encontrado.00011078000002018",
            "detailedMessagename": "FABIO ANDERSON"Não,
  foi possível retornar os dados do beneficiário através da matrícula informada."
}

...

"amountFine": 363
        }
    ]
}
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": "Os campos do json no body estão inválidos",
    "detailedMessage": "Verifique a lista de erros no campo details para mais detalhes.",
    "details": [
        {
            "code": "E001B-406",
            "message": "Campo subscriberId obrigatório",
            "detailedMessage": "Não foi informado valor do campo subscriberId."
        },
        {
            "code": "E001E-406",
            "message": "Tamanho inválido para o campo subscriberId",
            "detailedMessage": "O valor do campo subscriberId deve ter o tamanho 17."
        }
    ]
}
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.

...

Painel
titleColorOrange
borderStylesolid
titleEligibility - Retorna a elegibilidade do beneficiário

Retorna a elegibilidade do beneficiário

/totvsHealthPlans/familyContract/v1/beneficiaries/{subscriberId}/eligibility

GET

Body

Não possui body!

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
subscriberId (Path)stringMatricula do beneficiário (BA1_CODINT+BA1_CODEMP+BA1_MATRIC+BA1_TIPREG+BA1_DIGITO)*required
Dica
Expandir
titleRequest
Dica
Expandir
title(200) - Operação realizada com sucesso
Desc. motivo negativa
subscriberIdstringMatrícula do beneficiárioBA1_CODINT+BA1_CODEMP+BA1_MATRIC+BA1_TIPREG+BA1_DIGITO*required
oldSubscriberIdstringMatrícula antiga do beneficiárioBA1_MATANT
namestringNome do BeneficiárioBA1_NOMUSR*required
socialNamestring

Nome social do beneficiário

BA1_NOMSOCinterChangestring

Intercambio

originHealthInsurerCodestringOperadora OrigemBA1_OPEORI*required
healthPlanstringProdutoBA1_CODPLA*required

cardValidity

string(date)Validade do cartãoBA1_DTVLCR

nationalHealthCard

stringCartão nacional de saúdeBA1_NRCRNA*required

cardCopy

string

Via do cartão

BA1_VIACAR*required

coverage

stringAbrangência*required

holder

stringTitular*required

company

stringEmpresaBA1_CODEMP*required

blockDate

string (date)Data de bloqueioBA1_DATBLO

ansHealthInsurerCode

string

Reg. Operadora ANS

*required

eligible

string

Elegível

*required

negativeReasonCode

stringCod. motivo negativa

negativeReasonDescription

string
Bloco de código
languagec#
themeEmacs
titleExemplo
linenumberstrue
{
    "subscriberId": "00011009000003020",
    "oldSubscriberId": "131664697",
    "name": "MARIO IGOR RAFAEL CARDOSO",
    "socialName": "",
    "interChange": "NAO",
    "originHealthInsurerCode": "0001",
    "healthPlan": "REDE CREDENCIADA",
    "cardValiditycode": "E002",
    "nationalHealthCardmessage": "223868970650002Usuário não encontrado",
    "cardCopydetailedMessage": "0",
Não foi possível retornar "coverage": "01",
    "holder": "BRYAN RENATO RAUL DA PAZ",
    "company": "EMPRESA PTU A100 XML",
    "blockDate": "2021-03-10",
    "ansHealthInsurerCode": "417505",
    "eligible": "NAO",
    "negativeReasonCode": "1016",
    "negativeReasonDescription": "BENEFICIARIO COM ATENDIMENTO SUSPENSO"
}os dados do beneficiário através da matrícula informada."
}

Âncora
utilizationStatement/base64
utilizationStatement/base64

Painel
titleColorOrange
borderStylesolid
titleUtilizationStatement/base64 - Retorna o pdf do extrato de utilização do beneficiário

Retorna o pdf do Extrato de Utilização do beneficiário informado em base 64.

/totvsHealthPlans/familyContract/v1/beneficiaries/{subscriberId}/utilizationStatement/base64

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
subscriberId (path)stringMatricula do beneficiário (BA1_CODINT+BA1_CODEMP+BA1_MATRIC+BA1_TIPREG+BA1_DIGITO)*required
dateOf (query)DateDe Ano /Mês/Dia de referência da declaração

*required

Se o semester não for informado

untilDate (query)DateAté Ano /Mês/Dia de referência da declaração

*required

Se o semester não for informado

semester (query)string

Busca pelo semestre do ano informado.

Deve ser informado o seguinte formado S/YYYY. onde S pode ser 1 (primeiro semestre) e 2 (segundo semestre) e YYYY corresponde ao ano. Exemplo: 2/2023


Dica
Expandir
titleRequest

Body


Não possui body!

Dica
Expandir
title(200) - Operação realizada com sucesso
fileNamestringNome do arquivo em PDF
*required
filestringString do arquivo em base 64
*required
Bloco de código
languagec#
themeEmacs
titleExemplo
linenumberstrue
{
    "fileName": "plsr022_20230616_183833.pdf",
	"file" : "JVBERi0xLjMKJbe+raoKMSAwIG9iago8PAovVHlwZSAvQ2F0YWxvZwovUGFnZXMgMiAwIFIKPj4KZW5kb2JqCjIgMCBvYmoKPDwKL1R5cGUgL1BhZ2VzCi9L..."
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": "Existem chaves obrigatórias que não foram informadas.",
    "detailedMessage": "Verifique a lista de erros no campo details para mais detalhes.",
    "details": [
        {
            "code": "E001-406",
            "message": "Chave subscriberId obrigatória",
            "detailedMessage": "Não foi informado no pathParams da requisição a chave  subscriberId."
        }
    ]
}
Aviso
Expandir
title(404406) - Usuário não encontradoParâ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": "Os campos do json no body estão inválidos",
    "detailedMessage": "Verifique a lista de erros no campo details para mais detalhes.",
    "details": [
        
Bloco de código
languagec#
themeEmacs
titleExemplo
linenumberstrue
{
            "code": "E002E001B-406",
            "message": "Campo subscriberId obrigatório",
            "detailedMessage": "Usuário não encontrado.",
Não foi informado valor do campo subscriberId."
        },
        {
            "detailedMessagecode": "Não foi possível retornar os dados do beneficiário através da matrícula informada."
}

...

"E001E-406",
            "message": "Tamanho inválido para o campo subscriberId",
            "detailedMessage": "O valor do campo subscriberId deve ter o tamanho 17."
        }
    ]
}
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.

...

Painel
titleColorOrange
borderStylesolid
titleRescissionFine - Retorna os dados da rescisão do beneficiário

Retorna os dados de rescisão de contrato do beneficiário informado em base 64.

/totvsHealthPlans/familyContract/v1/beneficiaries/{subscriberId}/rescissionFine

GET

Body

Não possui body!

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
subscriberId (path)stringMatricula do beneficiário (BA1_CODINT+BA1_CODEMP+BA1_MATRIC+BA1_TIPREG+BA1_DIGITO)*required
allFamily (query)stringRescisão de toda família ( 1- Sim)
Dica
Expandir
titleRequest
Dica
Expandir
title(200) - Operação realizada com sucesso
Valor multa
productstringCod. produto*requiredproductDescriptionstringDesc. produto*requiredinclusionDatestring(date)Data de inclusão*requiredfidelityMonthsstringMeses de fidelidade*requiredfidelityFinalDatestring(date)Data final da fidelidade*requiredtotalAmountFinestringValor total da multa*requiredbeneficiariesarrayBeneficiários*requiredsubscriberIdstringMatricula do beneficiário*requirednamestringNome do beneficiário*requiredamountFinestring*required
Bloco de código
languagec#
themeEmacs
titleExemplo
linenumberstruetrue
{
    "code": "E001",
    "message": "Os campos do json no body estão inválidos",
    "detailedMessage": "Verifique a lista de erros no campo details para mais detalhes.{
    "product": "0001",
    "productDescriptiondetails": "PRODUTO EXEMPLO 1",
[
        {
            "inclusionDatecode": "2023E001A-04-18406",
      "fidelityMonths": 12,
      "fidelityFinalDatemessage": "2024-04-18Campo date-of não informado",
            "totalAmountFinedetailedMessage": 363,
"Não foi informado o campo date-of."
       "beneficiaries": [ },
        {
            "subscriberIdcode": "00011078000002018E001A-406",
            "namemessage": "FABIO ANDERSONCampo until-date não informado",
            "amountFinedetailedMessage": 363"Não foi informado o campo unilt-date."
        }
    ]
}
Aviso
Expandir
title(406400) - Parâmetros obrigatóriosExtrato não disponível
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": "E001E002",
    "message": "OsExtrato campos do json no body estão inválidosnão disponível",
    "detailedMessage": "VerifiqueNão foi possível realizar a impressão do listaExtrato de erros no campo details para mais detalhes.",
    "details": [
        {
            "code": "E001B-406",
         Utilização. Verificar o período informado."
}
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": "E003",
    "message": "CampoUsuário subscriberIdnão obrigatórioencontrado",
    "detailedMessage": "Não foi possível retornar os dados  "detailedMessage": "Não foi informado valor do campo subscriberId."
        },
        {
        do beneficiário através da matrícula informada."
}
Aviso
Expandir
title(400) - Período informado não permitido
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": "E001E-406E004",
            "message": "TamanhoPeríodo inválidoinformado para o campo subscriberIdnão permitido.",
            "detailedMessage": "OPeríodo valorpermitido do campo subscriberId deve tersomente para o tamanhomesmo 17."
        }
    ]ano. EX: dE 01/01/2023 A 31/12/2023."
}
Aviso
Expandir
title(404400) - Beneficiário Intervalo de dias não encontradopermitido
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": "E002E005",
    "message": "UsuárioIntervalo de dias não encontradopermitido.",
    "detailedMessage": "NãoPermitido foisomente possívelintervalo retornarde osno dadosmáximo do beneficiário através da matrícula informada180 dia(s)."
}

Âncora
utilizationStatementreadjustmentStatement/base64utilizationStatement
readjustmentStatement/base64

Painel
titleColorOrange
borderStylesolid
titleUtilizationStatementReadjustment/base64 - Retorna o pdf do extrato de utilização reajuste do beneficiário

Retorna o pdf do Extrato extrato de Utilização reajuste do beneficiário informado em base 64.

/totvsHealthPlans/familyContract/v1/beneficiaries/{subscriberId}/utilizationStatementreadjustment/base64

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
subscriberId (path)stringMatricula do beneficiário (BA1_CODINT+BA1_CODEMP+BA1_MATRIC+BA1_TIPREG+BA1_DIGITO)*required
date-of year (query)DateDe Ano /Mês/Dia de referência da declaração*required
until-date (query)DateAté Ano /Mês/Dia de referência da declaração*required
Dica
Expandir
titleRequest

Body


Não possui body!

Dica
Expandir
title(200) - Operação realizada com sucesso
fileNamestringNome do arquivo em PDF
*required
filestringString do arquivo em base 64
*required
Bloco de código
languagec#
themeEmacs
titleExemplo
linenumberstrue
{
    "fileName": "plsr022_20230616_183833extreajsc954870.pdf",
	"file" : "JVBERi0xLjMKJbe+raoKMSAwIG9iago8PAovVHlwZSAvQ2F0YWxvZwovUGFnZXMgMiAwIFIKPj4KZW5kb2JqCjIgMCBvYmoKPDwKL1R5cGUgL1BhZ2VzCi9L..."
}
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": "Os campos do json no body estão inválidos",
    "detailedMessage": "Verifique a lista de erros no campo details para mais detalhes.",
    "details": [
        {
            "code": "E001B-406",
            "message": "Campo subscriberId obrigatório",
            "detailedMessage": "Não foi informado valor do campo subscriberId."
        },
        {
            "code": "E001E-406",
            "message": "Tamanho inválido para o campo subscriberId",
            "detailedMessage": "O valor do campo subscriberId deve ter o tamanho 17."
        }
    ]
}
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": "Os campos do json no body estão inválidos",
    "detailedMessage": "Verifique a lista de erros no campo details para mais detalhes.",
    "details": [
        {
            "code": "E001A-406",
            "message": "Campo date-ofyear não informado",
            "detailedMessage": "Não foi informado o campo date-ofyear."
        },
        {
        ]
}
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": "E001A-406E001",
            "message": "Campo until-dateBeneficiário não informadoencontrado.",
            "detailedMessage": "Não foi informadopossível oretornar campo unilt-date."
        }
    ]
}
Aviso
Expandir
title(400) - Extrato não disponível
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": "Extrato não disponível",
    "detailedMessage": "Não foi possível realizar a impressão do Extrato de Utilização. Verificar o período informado."
}
Aviso
os dados do beneficiário através da matrícula informada."
}


Âncora
incomeTax/base64
incomeTax/base64

Painel
titleColorOrange
borderStylesolid
titleIncomeTax/base64 - Retorna o pdf do imposto de renda do beneficiário

Retorna o pdf do imposto de renda do beneficiário informado em base 64.

/totvsHealthPlans/familyContract/v1/beneficiaries/{subscriberId}/incomeTax/base64

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
subscriberId (path)stringMatricula do beneficiário (BA1_CODINT+BA1_CODEMP+BA1_MATRIC+BA1_TIPREG+BA1_DIGITO)*required
year (query)stringAno de referência da declaração*required
Dica
Expandir
titleRequest

Body


Não possui body!

Dica
Expandir
title(200) - Operação realizada com sucesso
fileNamestringNome do arquivo em PDF
*required
filestringString do arquivo em base 64
*required
Expandir
title(404) - Beneficiário não encontrado
Lista de objetos de erro (recursiva) com mais detalhes sobre o erro principal.
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
detailsarray
Bloco de código
languagec#
themeEmacs
titleExemplo
linenumberstrue
{
    "codefileName": "E003plsr99720230620174340.pdf",
    "message": "Usuário não encontrado",
    "detailedMessage": "Não foi possível retornar os dados do beneficiário através da matrícula informada	"file" : "JVBERi0xLjMKJbe+raoKMSAwIG9iago8PAovVHlwZSAvQ2F0YWxvZwovUGFnZXMgMiAwIFIKPj4KZW5kb2JqCjIgMCBvYmoKPDwKL1R5cGUgL1BhZ2VzCi9L..."
}
Aviso
Expandir
title(400406) - Período informado não permitidoParâ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": "Os campos do json no body estão inválidos",
    "detailedMessage": "Verifique a lista de erros no campo details para mais detalhes.",
    "details": [
        {
            "code": "E004E001B-406",

            "message": "PeríodoCampo informado não permitido.subscriberId obrigatório",
    "detailedMessage": "Período permitido somente para o mesmo ano. EX"detailedMessage": dE 01/01/2023 A 31/12/2023."
}
Aviso
Expandir
title(400) - Intervalo de dias não permitido
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
{
"Não foi informado valor do campo subscriberId."
        },
        {
            "code": "E005",
    "message": "Intervalo de dias não permitido.","E001E-406",
            "message": "Tamanho inválido para o campo subscriberId",
            "detailedMessage": "O valor do campo subscriberId deve ter o tamanho 17."
    "detailedMessage": "Permitido somente intervalo de}
 no máximo 180 dia(s)." ]
}

...

Aviso
Expandir

...

solid
Painel
titleColorOrange
borderStyle
title
ReadjustmentStatement/base64 - Retorna o pdf do extrato de reajuste do beneficiário
(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": "Os campos do json no body estão inválidos",
    "detailedMessage": "Verifique a lista de erros no campo details para mais detalhes.",
    "details": [
        {
            "code": "E001A-406",
            "message": "Campo year não informado",
            "detailedMessage": "Não foi informado o campo year."
        }
    ]

Retorna o pdf do extrato de reajuste do beneficiário informado em base 64.

/totvsHealthPlans/familyContract/v1/beneficiaries/{subscriberId}/readjustmentStatement/base64

GET

Body

Não possui body!

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
subscriberId (path)stringMatricula do beneficiário (BA1_CODINT+BA1_CODEMP+BA1_MATRIC+BA1_TIPREG+BA1_DIGITO)*required
year (query)DateAno de referência*required
Dica
Expandir
titleRequest
Dica
Expandir
title(200) - Operação realizada com sucesso
fileNamestringNome do arquivo em PDF*requiredfilestringString do arquivo em base 64*required
Bloco de código
languagec#
themeEmacs
titleExemplo
linenumberstrue
{
    "fileName": "extreajsc954870.pdf",
	"file" : "JVBERi0xLjMKJbe+raoKMSAwIG9iago8PAovVHlwZSAvQ2F0YWxvZwovUGFnZXMgMiAwIFIKPj4KZW5kb2JqCjIgMCBvYmoKPDwKL1R5cGUgL1BhZ2VzCi9L..."
}
Aviso
Expandir
title(406400) - Parâmetros obrigatóriosDemonstrativo não disponível
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.*requiredrecursiva) com mais detalhes sobre o erro principal.
Bloco de código
languagec#
themeEmacs
titleExemplo
linenumberstrue
{
    
Bloco de código
languagec#
themeEmacs
titleExemplo
linenumberstrue
{
    "code": "E001",
    "message": "Os campos do json no body estão inválidos",
    "detailedMessage": "Verifique a lista de erros no campo details para mais detalhes.",
    "details": [
        {
            "code": "E001B-406E002",
            "message": "CampoDemonstrativo subscriberIdnão obrigatóriodisponível.",
            "detailedMessage": "Não foi informado valor do campo subscriberId."
        },
        {
        : "Não encontrado imposto de renda referente ano informado."
}
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": "E001E-406E003",
            "message": "TamanhoUsuário inválido para o campo subscriberIdnão encontrado",
            "detailedMessage": "O valor do campo subscriberId deve ter o tamanho 17."
        }
    ]
}Não foi possível retornar os dados do beneficiário através da matrícula informada."
}


Âncora
financeStatement/base64
financeStatement/base64

Painel
titleColorOrange
borderStylesolid
titleFinanceStatement/base64 - Retorna o pdf do extrato financeiro do beneficiário

Retorna o pdf do extrato financeiro do beneficiário informado em base 64.

/totvsHealthPlans/familyContract/v1/beneficiaries/{subscriberId}/financeStatement/base64

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
subscriberId (path)stringMatricula do beneficiário (BA1_CODINT+BA1_CODEMP+BA1_MATRIC+BA1_TIPREG+BA1_DIGITO)*required
dateOf (query)stringDe Ano/ Mês/Dia de referência do extrato*required
untilDate (query)stringAté Ano/ Mês/Dia de referência do extrato*required
expenseDate (query)stringTipo de lançamento*required
Dica
Expandir
titleRequest

Body


Não possui body!

Dica
Expandir
title(200) - Operação realizada com sucesso
fileNamestringNome do arquivo em PDF
*required
filestringString do arquivo em base 64
*required
Bloco de código
languagec#
themeEmacs
titleExemplo
linenumberstrue
{
    "fileName": "extfinancsc957850.pdf",
	"file" : "JVBERi0xLjMKJbe+raoKMSAwIG9iago8PAovVHlwZSAvQ2F0YWxvZwovUGFnZXMgMiAwIFIKPj4KZW5kb2JqCjIgMCBvYmoKPDwKL1R5cGUgL1BhZ2VzCi9L..."
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": "Os campos do json no body estão inválidos",
    "detailedMessage": "Verifique a lista de erros no campo details para mais detalhes.",
    "details": [
        {
            "code": "E001A-406",
            "message": "Campo year não informado",
            "detailedMessage": "Não foi informado o campo year."
        }
    ]
}
Aviso
Expandir
title(404406) - Beneficiário não encontradoParâ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": "Beneficiário não encontrado,
    "message": "Os campos do json no body estão inválidos",
    "detailedMessage": "Verifique a lista de erros no campo details para mais detalhes.",
    "detailedMessagedetails": "Não[
 foi possível retornar os dados do beneficiário através da matrícula informada."
}

...

Painel
titleColorOrange
borderStylesolid
titleIncomeTax/base64 - Retorna o pdf do imposto de renda do beneficiário

Retorna o pdf do imposto de renda do beneficiário informado em base 64.

/totvsHealthPlans/familyContract/v1/beneficiaries/{subscriberId}/incomeTax/base64

GET

Body

Não possui body!

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
subscriberId (path)stringMatricula do beneficiário (BA1_CODINT+BA1_CODEMP+BA1_MATRIC+BA1_TIPREG+BA1_DIGITO)*required
year (query)stringAno de referência da declaração*required
Dica
Expandir
titleRequest
Dica
Expandir
title(200) - Operação realizada com sucesso
fileNamestringNome do arquivo em PDF*requiredfilestringString do arquivo em base 64*required
Bloco de código
languagec#
themeEmacs
titleExemplo
linenumberstrue
{
    "fileName": "plsr99720230620174340.pdf",
	"file" : "JVBERi0xLjMKJbe+raoKMSAwIG9iago8PAovVHlwZSAvQ2F0YWxvZwovUGFnZXMgMiAwIFIKPj4KZW5kb2JqCjIgMCBvYmoKPDwKL1R5cGUgL1BhZ2VzCi9L..."{
            "code": "E001B-406",
            "message": "Campo subscriberId obrigatório",
            "detailedMessage": "Não foi informado valor do campo subscriberId."
        },
        {
            "code": "E001E-406",
            "message": "Tamanho inválido para o campo subscriberId",
            "detailedMessage": "O valor do campo subscriberId deve ter o tamanho 17."
        }
    ]
}
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
Exemplo
linenumberstrue
{
    "code": "E001",
    "message": "Os campos do json no body estão inválidos",
    "detailedMessage": "Verifique a lista de erros no campo details para mais detalhes.",
    "details": [
        {
            {
    "code": "E001E001A-406",
            "message": "Os campos do json no body estão inválidos",
Campo dateOf não informado",
            "detailedMessage": "VerifiqueNão afoi lista de erros noinformado o campo detailsdateOf."
 para mais detalhes.",
    "details": [ },
        {
            "code": "E001BE001A-406",
            "message": "Campo untilDate subscriberIdnão obrigatórioinformado",
            "detailedMessage": "Não foi informado valor doo campo subscriberIduntilDate."
        },
        {
            "code": "E001EE001A-406",
            "message": "TamanhoCampo inválidoexpenseType para o campo subscriberIdnão informado",
            "detailedMessage": "O valor do campo subscriberId deve ter": "Não foi informado o tamanhocampo 17expenseType."
        }
    ]
}
Aviso
Expandir
title(406400) - Parâmetros obrigatóriosExtrato não disponível
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) com mais detalhes sobre o erro principal.
Bloco de código
languagec#
themeEmacs
titleExemplo
linenumberstrue
{
    
Bloco de código
languagec#
themeEmacs
titleExemplo
linenumberstrue
{
    "code": "E001",
    "message": "Os campos do json no body estão inválidos",
    "detailedMessage": "Verifique a lista de erros no campo details para mais detalhes.",
    "details": [
        {
            "code": "E001A-406E002",
            "message": "Campo yearExtrato não informadodisponível.",
            "detailedMessage": "Não foi informadopossível orealizar campo year."
        }
    ]a impressão do Extrato Financeiro. Verificar o período informado e tipo de despesa."
}
Aviso
Expandir
title(400404) - Demonstrativo Beneficiário não disponívelencontrado
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": "E002E003",
    "message": "DemonstrativoBeneficiário não disponível.encontrado",
    "detailedMessage": "Não encontrado imposto de renda referente ano informado foi possível retornar os dados do beneficiário através da matrícula informada."
}
Aviso
Expandir
title(404) - Beneficiário Tipo de lançamento 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": "E003E004",
    "message": "UsuárioTipo de lançamento não encontrado",
    "detailedMessage": "Não foi possível retornar os dados do beneficiáriolançamento através dado matrículacódigo informadainformado."
}

Âncora
financeStatementannualStatementDischargeDebts/base64financeStatement
annualStatementDischargeDebts/base64

Painel
titleColorOrange
borderStylesolid
titleFinanceStatementAnnualStatementDebts/base64 - Retorna o pdf do extrato financeiro da declaração anual de quitação de débitos do beneficiário

Retorna o pdf do extrato financeiro da declaração anual de quitação de débitos do beneficiário informado em base 64.

/totvsHealthPlans/familyContract/v1/beneficiaries/{subscriberId}/financeStatementannualStatementDebts/base64

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
subscriberId (path)stringMatricula do beneficiário (BA1_CODINT+BA1_CODEMP+BA1_MATRIC+BA1_TIPREG+BA1_DIGITO)*required
dateOf year (query)stringDe Ano / Mês/Dia de referência do extrato*required
untilDate (query)stringAté Ano/ Mês/Dia de referência do extrato*required
expenseDate (query)stringTipo de lançamentode referência da declaração*required
Dica
Expandir
titleRequest

Body


Não possui body!

Dica
Expandir
title(200) - Operação realizada com sucesso
fileNamestringNome do arquivo em PDF
*required
filestringString do arquivo em base 64
*required
Bloco de código
languagec#
themeEmacs
titleExemplo
linenumberstrue
{
    "fileName": "extfinancsc957850quitacao_13_6_2023_15_09_52.pdf",
	"file" : "JVBERi0xLjMKJbe+raoKMSAwIG9iago8PAovVHlwZSAvQ2F0YWxvZwovUGFnZXMgMiAwIFIKPj4KZW5kb2JqCjIgMCBvYmoKPDwKL1R5cGUgL1BhZ2VzCi9L..."
}
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": "Os campos do json no body estão inválidos",
    "detailedMessage": "Verifique a lista de erros no campo details para mais detalhes.",
    "details": [
        {
            "code": "E001B-406",
            "message": "Campo subscriberId obrigatório",
            "detailedMessage": "Não foi informado valor do campo subscriberId."
        },
        {
            "code": "E001E-406",
            "message": "Tamanho inválido para o campo subscriberId",
            "detailedMessage": "O valor do campo subscriberId deve ter o tamanho 17."
        }
    ]
}
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": "E001E002",
    "message": "Os campos do json no body estão inválidos",
    "detailedMessage": "Verifique a lista de erros no campo details para mais detalhes.",
    "details": [
        {
            "code": "E001A-406",
            "message": "Campo dateOf não informado",
            "detailedMessage": "Não foi informado o campo dateOf." mais detalhes.",
        },"details": [
        {
            "code": "E001AE002A-406",
            "message": "Campo untilDateyear não informado",
            "detailedMessage": "Não foi informado o campo untilDateyear."
        },
        {
                    }
    ]
}
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": "E001A-406E003",
            "message": "Campo expenseTypeBeneficiário não informadoencontrado",
            "detailedMessage": "Não foi informadopossível oretornar campo expenseType."
        }
    ]
os dados do beneficiário através da matrícula informada."
}
Aviso
Expandir
title(400404) - Extrato Declaração não disponívelencontrada
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": "E002E005",
    "message": "Extrato não disponível.",
    "detailedMessage": "Não foiencontrado possívelDeclaração realizarreferente aao impressão do Extrato Financeiro. Verificar o período informado e tipo de despesa."
}
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": "E003",
    "message": "Beneficiário não encontrado",
    "detailedMessage": "Não foi possível retornar os dados do beneficiário através da matrícula informada."
}
Aviso
Expandir
title(404) - Tipo de lançamento 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": "E004",
    "message": "Tipo de lançamento não encontrado",
    "detailedMessage": "Não foi possível retornar os dados do lançamento através do código informado."
}

...

ano informado.",
    "detailedMessage": ""
}


Âncora
blockContracts
blockContracts

Painel
titleColorOrange
borderStylesolid
titleBlockContracts - Realiza o Bloqueio direto do Beneficiário/família

Realiza o bloqueio do contrato do beneficiário ou da família

/totvsHealthPlans/familyContract/v1/beneficiaries/blockContracts

POST

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
subscriberId (body)stringMatricula do beneficiário (BA1_CODINT+BA1_CODEMP+BA1_MATRIC+BA1_TIPREG+BA1_DIGITO)*required
dateBlock (body)string(date)Data do bloqueio ("21-09-2023")*required
reason (body)stringCódigo do motivo de bloqueio*required
observation (body)stringObservação sobre o bloqueio
deathCodeSIP (body)stringCódigo do óbito SIP
dateRequested (body)string(date)Data da requisição do bloqueio ("12-09-2023")
blockFamily (body)booleanCampo lógico sobre bloqueio da família
Dica
Expandir
titleRequest

Body


{
    "subscriberId": "00011078000002018",
    "dateBlock": "2023-09-12",
    "reason": "001",
    "observation": "Bloqueio por pedido do Titular",
    "deathCodeSIP": "1.32",
    "dateRequested": "2023-09-12",
    "blockFamily": "false"
}

Dica
Expandir
title(200) - Operação realizada com sucesso
beneficiariesarrayBeneficiários
*required
subscriberId

...

Painel
titleColorOrange
borderStylesolid
titleAnnualStatementDebts/base64 - Retorna o pdf da declaração anual de quitação de débitos do beneficiário

Retorna o pdf da declaração anual de quitação de débitos do beneficiário informado em base 64.

/totvsHealthPlans/familyContract/v1/beneficiaries/{subscriberId}/annualStatementDebts/base64

GET

Nota
Expandir
titleParameters
Dica
subscriberId (path)
Expandir
title(200) - Operação realizada com sucesso
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
stringMatricula do beneficiário (BA1_CODINT+BA1_CODEMP+BA1_MATRIC+BA1_TIPREG+BA1_DIGITO)
*required
year (query)
namestring
Ano de referência da declaração*required
Dica Expandir
titleRequest

Body

Não possui body!

Nome do arquivo em PDFfileString do arquivo em base 64
fileNamestringNome do beneficiário
*required
datestring(date)Data do bloqueio
*required
code
reason
languagec#
themeEmacs
titleExemplo
linenumberstrue
{
    "fileName": "quitacao_13_6_2023_15_09_52.pdf",
	"file" : "JVBERi0xLjMKJbe+raoKMSAwIG9iago8PAovVHlwZSAvQ2F0YWxvZwovUGFnZXMgMiAwIFIKPj4KZW5kb2JqCjIgMCBvYmoKPDwKL1R5cGUgL1BhZ2VzCi9L..."
}
Aviso
stringCódigo do motivo de bloqueio
*required
reasonDescriptionstringDescrição do motivo de bloqueio
*required
observationarrayObservação sobre o bloqueio
*required
blockInvoicingstringBloqueia Faturamento (1=Sim, 0=Nao)
*required
dateRequestedstring(date)Data de requisição do bloqueio
*required
dateEntrystring(date)Data de lançamento do bloqueio
*required
hourRequestedstringHora do lançamento do bloqueio
Expandir
title(406) - Parâmetros obrigatórios
Lista de objetos de erro (recursiva) com mais detalhes sobre o erro principal.
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
detailsarray
*required
Bloco de código
languagec#
themeEmacs
titleExemplo
linenumberstrue
{
    "codebeneficiaries": "E001",[
    "message": "Os campos do json no body estão inválidos", {
    "detailedMessage": "Verifique a lista de erros no campo details para mais detalhes."subscriberId": "00011078000002034",
    "details": [
        "name": "ISABELLA YASMIN {MELO",
            "codedate": "E001B-40620230920",
            "messagereason": "Campo subscriberId obrigatório001",
            "detailedMessagereasonDescription": "NãoFIM foiDA informadoRELACAO valorBENEF do campo subscriberId."X TITULAR",
        },
    "observation": "Bloqueio por pedido do {Titular",
            "codeblockInvoicing": "E001E-4061",
            "messagedateRequested": "Tamanho inválido para o campo subscriberId20230912",
            "detailedMessagedateEntry": "O valor do campo subscriberId deve ter o tamanho 17."20230922",
            "hourRequested": "15:16:13"
        }
    ]
}
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": "E002E001",
    "message": "Os campos do json no body estão inválidos",
    "detailedMessage": "Verifique a lista de erros no campo details para mais detalhes.",
    "details": [
        {
            "code": "E002AE001B-406",
            "message": "Campo yearsubscriberId não informadoobrigatório",
            "detailedMessage": "Não foi informado valor odo campo yearsubscriberId."
        },
        ]
}
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": "E003E001E-406",
            "message": "Beneficiário não encontradoTamanho inválido para o campo subscriberId",
            "detailedMessage": "O valor do campo subscriberId deve ter o "Não foi possível retornar os dados do beneficiário através da matrícula informada."tamanho 17."
        }
    ]
}
Aviso
Expandir
title(404) - Declaração Beneficiário não encontradaencontrado
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": "E005E002",
    "message": "NãoUsuário não encontrado Declaração referente ao ano informado.",
    "detailedMessage": "Não foi possível retornar os dados do beneficiário através da matrícula informada."
}

03. TELA API BENEFICIARIES

...