Árvore de páginas

Versões comparadas

Chave

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

...

Painel
titleColorOrange
borderStylesolid
titleBankSlip - Retorna os dados do boleto bancário

Retorna os dados no json do boleto bancário informado. 

/totvsHealthPlans/invoicing/v1/titles/{titleId}/bankSlip

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
titleId (path)stringChave do Titulo (E1_PREFIXO+E1_NUM+E1_PARCELA+E1_TIPO)*required
fields (query)

string

Lista com o nome das propriedades JSON que serão retornadas.
expand (query)stringLista com o nome das propriedades para expandir, descritos no campo _expandables da api.
Dica
Expandir
titleRequest

Body


Não possui body!

Dica
Expandir
title(200) - Operação realizada com sucesso
digitableLinestringLinha digitável
*required
dueDatestring (date)Vencimento
*required
documentDatestring (date)Data do Documento
*required
documentNumberstringNro.Documento
*required
documentTypestringEspécie Doc.
*required
acceptancestringAceite
*required
processingDatestring (date)Data do Processamento
*required
documentValuenumber (double)(=)Valor do Documento
*required
otherAdditionsnumber (double)(+)Outros Acréscimos
*required
discountnumber (double)(-)Desconto/Abatimento
*required
competenceMonthstringMês Competencia
*required
competenceYearstringAno Competencia
*required
assignorobject (json)Operadora Saúde - Cedente do boleto
*required
assignor.namestringNome
*required
assignor.addressstringEndereço
*required
assignor.addressComplementstringComplemento de Endereço
*required
assignor.districtstringBairro
*required
assignor.cityCodeResidencestringCidade
*required
assignor.stateAbbreviationstringEstado
*required
assignor.zipCodestringCEP
*required
assignor.phoneNumberstringTelefone
*required
assignor.cnpjstringCNPJ
*required
assignor.codeSusepstringCódigo SUSEP - ANS
*required
assignor.observationstringObservação
*required
assignor.instructionsstringInstruções/Texto de responsabilidade do cedente
*required
draweeobject (json)Recibo do Sacado
*required
drawee.namestringNome do Cliente
*required
drawee.codestringCódigo do Cliente
*required
drawee.cpfstringCPF (Para pessoa física)
*required
drawee.cnpjstringCNPJ (Para pessoa jurídica)
*required
drawee.addressstringEndereço do Cliente
*required
drawee.districtstringBairro do Cliente
*required
drawee.cityCodeResidencestringCidade
*required
drawee.stateAbbreviationstringEstado
*required
drawee.zipCodestringCEP
*required
bankobject (json)Banco
*required
bank.namestringNome do Banco
*required
bank.codestringCódigo do Banco
*required
bank.agencyAssignorCodestringAgência/Código Cedente
*required
bank.ourNumberstringNosso Número
*required
bank.walletCodestringCarteira
*required
_expandablesarray

Propriedades expansíveis:

  • billingDetails
  • openMonths
  • users
  • userUsage


billingDetailsarrayDetalhes da Cobrança dos beneficiários

billingDetails.subscriberIdstringMatricula do Beneficiário

billingDetails.namestringNome do Beneficiário

billingDetails.compositionsarrayComposições do título do Beneficiário

billingDetails.compositions.typeCodestringCódigo do lançamento

billingDetails.compositions.typeDescriptionstringDescrição do lançamento

billingDetails.compositions.valuenumber (double)Valor

billingDetails.compositions.numberANSstringNúmero na ANS

openMonthsarrayMeses em aberto

openMonths.monthstringMês em aberto

openMonths.yearstringAno em aberto

usersarrayUsuários (Beneficiários da Família)

users.recordTypestringTipo de Registro do Beneficiário

users.namestringNome do Beneficiário

users.effectiveDatestring (date)Data de Inclusão

userUsagearrayDetalhes da Utilização

userUsage.subscriberNamestringNome do Beneficiário

userUsage.healthProviderNamestringNome da Rede de Atendimento

userUsage.procedureCodestringCódigo do Procedimento

userUsage.procedureNamestringDescrição do Procedimento

userUsage.executionDatestring (date)Data Utilização

userUsage.quantitynumber (double)Quantidade

userUsage.coPaymentValuenumber (double)Valor Total

Bloco de código
languagec#
themeRDark
titleExemplo
linenumberstrue
{
    "digitableLine": "",
    "dueDate": "2022-10-17",
    "documentDate": "2023-05-26",
    "documentNumber": "000007042",
    "documentType": "R$",
    "acceptance": "N",
    "processingDate": "2022-10-17",
    "documentValue": 0,
    "otherAdditions": 0,
    "discount": 0,
    "competenceMonth": "01",
    "competenceYear": "2022",
    "assignor": {
        "name": "OPERADORA 417505",
        "address": "RUA COPACABANA",
        "addressComplement": "",
        "district": "SAO PAULO",
        "cityCodeResidence": "SAO PAULO",
        "stateAbbreviation": "SP",
        "zipCode": "02461000",
        "phoneNumber": "",
        "cnpj": "54097504000109",
        "codeSusep": "417505",
        "observation": "",
        "instructions": ""
    },
    "drawee": {
        "name": "VITOR MIGUEL FREITAS",
        "code": "TMSWBI",
        "cpf": "40492401810",
        "cnpj": "",
        "address": "ALBERT BARTHOLOME ,100",
        "district": "JARDIM DAS VERTENTES",
        "cityCodeResidence": "SAO PAULO",
        "stateAbbreviation": "SP",
        "zipCode": "05541000"
    },
    "bank": {
        "name": "BANCO DO PRE FA",
        "code": "-9",
        "agencyAssignorCode": "00001/0000000001",
        "ourNumber": "",
        "walletCode": "9"
    },
    "_expandables": [
        "billingDetails",
        "openMonths",
        "users",
        "userUsage"
    ]
}
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.
Bloco de código
languagec#
themeRDark
titleExemplo
linenumberstrue
{
    "code": "E002",
    "message": "Existem chaves obrigatórias que não foram informadas.",
    "detailedMessage": "Verifique a lista de erros no campo details para mais detalhes.",
    "details": [
        {
            "code": "E002-406",
            "message": "Chave titleId obrigatória",
            "detailedMessage": "Não foi informado no pathParams da requisição a chave titleId."
        }
    ]
}
Aviso
Expandir
title(404) - Titulo não encontrada
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#
themeRDark
titleExemplo
linenumberstrue
{
    "code": "E003",
    "message": "Título não encontrado no Financeiro",
    "detailedMessage": "Não foi encontrada na tabela SE1 o título PLS000007942 DP (E1_PREFIXO+E1_NUM+E1_PARCELA+E1_TIPO)."
}
Aviso
Expandir
title(400) - Boleto 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#
themeRDark
titleExemplo
linenumberstrue
{
    "code": "E004",
    "message": "Boleto Bancário não disponível.",
    "detailedMessage": "O título PLS000007032 DP se encontra na situação em Carteira no Financeiro."
}

Âncora
bankSlipBase64
bankSlipBase64

Painel
titleColorOrange
borderStylesolid
titleBankSlip/Base64 - Retorna o boleto bancário em arquivo base 64

Retorna o boleto bancário informado em arquivo base 64. 

/totvsHealthPlans/invoicing/v1/titles/{titleId}/bankSlip/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
titleId (path)stringChave do Titulo (E1_PREFIXO+E1_NUM+E1_PARCELA+E1_TIPO)*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#
themeRDark
titleExemplo
linenumberstrue
{
    "fileName": "boletosc005630.pdf",
    "file": "JVBERi0xLjMKJbe+raoKMSAwIG9iago8PAovVHlwZSAvQ2F0YW..."
}
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.
Bloco de código
languagec#
themeRDark
titleExemplo
linenumberstrue
{
    "code": "E002",
    "message": "Existem chaves obrigatórias que não foram informadas.",
    "detailedMessage": "Verifique a lista de erros no campo details para mais detalhes.",
    "details": [
        {
            "code": "E002-406",
            "message": "Chave titleId obrigatória",
            "detailedMessage": "Não foi informado no pathParams da requisição a chave titleId."
        }
    ]
}
Aviso
Expandir
title(404) - Titulo não encontrada
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#
themeRDark
titleExemplo
linenumberstrue
{
    "code": "E003",
    "message": "Título não encontrado no Financeiro",
    "detailedMessage": "Não foi encontrada na tabela SE1 o título PLS000007942 DP (E1_PREFIXO+E1_NUM+E1_PARCELA+E1_TIPO)."
}
Aviso
Expandir
title(400) - Boleto 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#
themeRDark
titleExemplo
linenumberstrue
{
    "code": "E004",
    "message": "Boleto Bancário não disponível.",
    "detailedMessage": "O título PLS000007032 DP se encontra na situação em Carteira no Financeiro."
}


03. TELA API TITLES

Outras Ações / Ações relacionadas

...

CampoDescrição
E1_CODINTCódigo da operadora saúde
E1_CODEMPCódigo da empresa
E1_MATRICMatricula da família
E1_PREFIXOPrefixo do titulo
E1_NUMNúmero do titulo
E1_PARCELAParcela do titulo
E1_TIPOTipo do titulo
MV_RELTDiretório no servidor para gravar os boletos gerados pela api

05. TABELAS UTILIZADAS

  • Contas a Receber (SE1)



...