Realiza a inclusão de uma nova despesa ao protocolo de reembolso /totvsHealthPlans/attendance/v1/refunds/expenses | |
Nota |
---|
Expandir |
---|
| Authorization (header) | | Cabeçalho usado para autorização das requisições (Bearer token) | *required | Content-Type (header) | | 'application/json' é o formato do conteúdo | *required |
|
|
Dica |
---|
Expandir |
---|
| protocol | string | Numero do protocolo de reembolso | BOW_PROTOC | *required | subscriberId | string | Matricula do beneficiário da despesa | B1N_MATRIC | *required | unreferencedNetworkIdentifier | string | CPF/CNPJ do prestador de serviço | B1N_PRCNPJ | *required | unreferencedNetworkName | string | Nome do prestador de serviço | B1N_PRNOME | *required | stateAbbreviation | string | Estado do prestador | B1N_EST | *required | cityCode | string | Código do Município do prestador (obtido através da api /totvsHealthPlans/locality/v1/cities) | B1N_CODMUN | *required | documentCode | string | Código do tipo de comprovante (obtido através da api /totvsHealthPlans/refundSetup/v1/documents) | B1N_TIPDOC (BBS_COD) | *required | documentNumber | string | Numero do documento | B1N_NUMDOC |
| documentDate | string (date) | Data de emissão do documento | B1N_DATDOC | *required | procedureClass | string | Código do tipo de despesa utilizado (obtido através da api totvsHealthPlans/procedure/v1/classes) | B1N_TIPSER | *required | tableCode | string | Código da tabela da despesa | B1N_CODPAD | *required | procedureCode | string | Código da despesa | B1N_CODPRO | *required | continuousUse | string | Quando a despesa for medicamento, informa se é de uso contínuo, sendo: | B1N_USOCON | *required | prescriptionCode | string | Código da receita do medicamento de uso continuo (obtivo através da api /totvsHealthPlans/refundSetup/v1/continuousMedications) Obrigatório quando continuousUse for igual a 1 | B1N_CODREC |
| expenseAmount | numeric (double) | Valor total da despesa | B1N_VLRTOT | *required | quantity | numeric (integer) | Quantidade de despesa | B1N_QTDPRO | *required | executionDate | string (date) | Data de execução da despesa | B1N_DATPRO | *required |
Bloco de código |
---|
language | c# |
---|
theme | Emacs |
---|
title | Exemplo |
---|
linenumbers | true |
---|
| {
"protocol" : "41750520230607000015",
"subscriberId": "00011008000027010",
"unreferencedNetworkIdentifier": "77077733000159",
"unreferencedNetworkName": "JOSE",
"stateAbbreviation": "SP",
"cityCode": "3500105",
"documentCode": "03",
"documentNumber": "0000012349",
"documentDate": "2023-04-23",
"procedureClass": "000001",
"tableCode": "01",
"procedureCode": "10101012",
"continuousUse": "0",
"prescriptionCode" : "",
"expenseAmount": 500,
"quantity": 1,
"executionDate": "2023-04-23"
} |
|
|
Dica |
---|
Expandir |
---|
title | (201) - Operação realizada com sucesso |
---|
| status | string | Status da despesa, sendo: | B1N_IMGSTA | *required | subscriberId | string | Matricula do beneficiário da despesa | B1N_MATRIC | *required | beneficiaryName | string | Nome do beneficiário | BA1_NOMUSR | *required | protocol | string | Numero do protocolo | B1N_PROTOC | *required | sequential | string | Sequencial da despesa no protocolo | B1N_SEQUEN | *required | procedureClass | string | Código do tipo de despesa utilizado (obtido através da api totvsHealthPlans/procedure/v1/classes) | B1N_TIPSER | *required | tableCode | string | Código da tabela da despesa | B1N_CODPAD | *required | procedureCode | string | Código da despesa | B1N_CODPRO | *required | procedureDescription | string | Descrição da despesa | BR8_DESCRI | *required | continuousUse | string | Medicamento de uso continuo: | B1N_USOCON | *required | quantity | numeric (integer) | Quantidade de despesa | B1N_QTDPRO | *required | expenseAmount | numeric (double) | Valor apresentado da despesa | B1N_VLRAPR | *required | totalExpenseAmount | numeric (double) | Valor total da despesa | B1N_VLRTOT | *required | refundedAmount | numeric (double) | Valor reembolsado | B1N_VLRREE | *required | unreferencedNetworkIdentifier | string | CPF/CNPJ do prestador de serviço | B1N_PRCNPJ | *required | unreferencedNetworkName | string | Nome do prestador de serviço | B1N_PRNOME | *required | stateAbbreviation | string | Estado do prestador | B1N_EST | *required | cityCode | string | Código do Município do prestador (obtido através da api /totvsHealthPlans/locality/v1/cities) | B1N_CODMUN | *required | documentCode | string | Código do tipo de comprovante (obtido através da api /totvsHealthPlans/refundSetup/v1/documents) | B1N_TIPDOC (BBS_COD) | *required | documentDescription | string | Descrição do tipo de comprovante (obtido através da api /totvsHealthPlans/refundSetup/v1/documents) | B1N_TIPDOC | *required | documentNumber | string | Numero do documento | B1N_NUMDOC |
| documentDate | string (date) | Data de emissão do documento | B1N_DATDOC | *required | executionDate | string (date) | Data de execução da despesa | B1N_DATPRO | *required |
Bloco de código |
---|
language | c# |
---|
theme | Emacs |
---|
title | Exemplo |
---|
linenumbers | true |
---|
| {
"status": "1",
"subscriberId": "00011008000027010",
"beneficiaryName": "HERNANDES ALVES DA SILVA",
"protocol": "41750520230607000015",
"sequential": "002",
"procedureClass": "000001",
"tableCode": "01",
"procedureCode": "10101012",
"procedureDescription": "CONSULTA EM CONSULTORIO",
"continuousUse": "0",
"quantity": 1,
"expenseAmount": 500,
"totalExpenseAmount": 500,
"refundedAmount": 0,
"unreferencedNetworkIdentifier": "77077733000159",
"unreferencedNetworkName": "JOSE",
"stateAbbreviation": "SP",
"cityCode": "3500105",
"documentCode": "03",
"documentDescription": "RECIBO",
"documentNumber": "0000012349",
"documentDate": "2023-04-23",
"executionDate": "2023-04-23"
} |
|
|
Aviso |
---|
Expandir |
---|
title | (406) - Json do body invalido |
---|
| code | string | Código identificador do erro. | *required | message | string | Literal no idioma da requisição descrevendo o erro para o usuário. | *required | detailedMessage | string | Mensagem técnica e mais detalhada do erro. | *required | details | array | Lista de objetos de erro (recursiva) com mais detalhes sobre o erro principal. |
|
Bloco de código |
---|
language | c# |
---|
theme | Emacs |
---|
title | Exemplo |
---|
linenumbers | true |
---|
| {
"code": "E001",
"message": "JSON inválido",
"detailedMessage": "Json Error: >>\"subscriberId\": \"00011008000027010\",\r\n \"unreferencedNetworkIdentifier\": \"77077733000159\",\r\n \"unreferencedNetworkName\": \"JOSE\",\r\n \"stateAbbreviation\": \"SP\",\r\n \"cityCode\": \"3500105\",\r\n \"documentCode\": \"03\",\r\n \"documentNumber\": \"0000012350\",\r\n \"documentDate\": \"2023-04-23\",\r\n \"procedureClass\": \"000001\",\r\n \"tableCode\": \"01\",\r\n \"procedureCode\": \"10101012\",\r\n \"continuousUse\": \"0\",\r\n \"prescriptionCode\" : \"\",\r\n \"expenseAmount\": 500,\r\n \"quantity\": 1,\r\n \"executionDate\": \"2023-04-23\"\r\n}<<"
} |
|
|
Aviso |
---|
Expandir |
---|
title | (406) - Campos do body inválidos |
---|
| code | string | Código identificador do erro. | *required | message | string | Literal no idioma da requisição descrevendo o erro para o usuário. | *required | detailedMessage | string | Mensagem técnica e mais detalhada do erro. | *required | details | array | Lista de objetos de erro (recursiva) com mais detalhes sobre o erro principal. |
|
Bloco de código |
---|
language | c# |
---|
theme | Emacs |
---|
title | Exemplo |
---|
linenumbers | true |
---|
| {
"code": "E002",
"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": "E002E-406",
"message": "Tamanho inválido para o campo protocol",
"detailedMessage": "O valor do campo protocol deve ter o tamanho 20."
},
{
"code": "E002B-406",
"message": "Campo subscriberId obrigatório",
"detailedMessage": "Não foi informado valor do campo subscriberId."
},
{
"code": "E002E-406",
"message": "Tamanho inválido para o campo subscriberId",
"detailedMessage": "O valor do campo subscriberId deve ter o tamanho 17."
},
{
"code": "E002A-406",
"message": "Campo stateAbbreviation não informado",
"detailedMessage": "Não foi informado o campo stateAbbreviation."
},
{
"code": "E002F-406",
"message": "Valor inválido para o campo continuousUse",
"detailedMessage": "O valor do campo continuousUse deve ser: 0;1"
}
]
} |
|
|
Aviso |
---|
Expandir |
---|
title | (400) - Dados do reembolso inválidosda despesa inválido |
---|
| code | string | Código identificador do erro. | *required | message | string | Literal no idioma da requisição descrevendo o erro para o usuário. | *required | detailedMessage | string | Mensagem técnica e mais detalhada do erro. | *required | details | array | Lista de objetos de erro (recursiva) com mais detalhes sobre o erro principal. | *required |
Bloco de código |
---|
language | c# |
---|
theme | Emacs |
---|
title | Exemplo |
---|
linenumbers | true |
---|
| {
"code": "E003",
"message": "Dados inválidos para realizar a inclusão da despesa",
"detailedMessage": "Verifique os detalhes dos erros no campo details",
"details": [
{
"code": "E005C-404",
"message": "Código do documento não encontrado",
"detailedMessage": "Não foi encontrado nenhum documento com o código 99 no cadastro (BBS)"
},
{
"code": "E005D-404",
"message": "Estado e Cidade não encontrado",
"detailedMessage": "Não foi encontrado nenhum estado SP e cidade 3500106 no cadastro (BID)"
}
]
} |
|
|
|