Histórico da Página

...

Painel

titleColor	Orange
borderStyle	solid
title	ContinuousMedications - Inclusão de medicamentos de uso contínuo

Realiza a inclusão de novos medicamentos de uso contínuo para o beneficiário.

/totvsHealthPlans/refundSetup/v1/continuousMedications

POST

Nota

Expandir

title	Parameters

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

Dica

Expandir

title	Request

healthInsurerCode	string	Código da operadora de saúde no sistema	BB0_CODOPE	*required
subscriberId	string	Matricula do beneficiário (obtido através da API Beneficiaries - v1.000 (Family Contract))	B4F_MATRIC	*required
professionalCouncil	string	Sigla do conselho regional do profissional de saúde da receita (obtido através da api /totvsHealthPlans/attendanceNetwork/v1/regionalCouncils)	B4F_SIGLA	*required
professionalCouncilNumber	string	Numero do conselho regional do profissional de saúde da receita	B4F_REGSOL	*required
stateAbbreviation	string	Estado do conselho regional do profissional de saúde da receita	B4F_ESTSOL	*required
professionalName	string	Nome do profissional de saúde da receita (obtido através da API Professionals - v1.000 (Attendance Network))	BB0_NOME	*required
prescriptionDate	string (date)	Data da receita	B4F_DATINI	*required
medications	array	Medicamentos de uso contínuo		*required
medications.tableCode	string	Código da tabela do medicamento (obtido através da api /totvsHealthPlans/procedure/v1/medications)	B7D_CODPAD	*required
medications.medicationCode	string	Código do medicamento (obtido através da api /totvsHealthPlans/procedure/v1/medications)	B7D_CODMED	*required
attachments	array	Anexos dos medicamentos		*required
attachments.href	string	Url do arquivo para que seja realizado o download		*required

Bloco de código

language	c#
theme	Emacs
title	Exemplo
linenumbers	true

{
	"healthInsurerCode" : "0001",
	"subscriberId" : "00011008000027010",
	"professionalCouncil" : "CRM",
    "stateAbbreviation" : "SP",
    "professionalName" : "VINICIUS",
    "prescriptionDate" : "2023-04-03",
	"professionalCouncilNumber" : "334456",
	"medications" : [
        {
            "tableCode" : "04",
            "medicationCode" : "0490173961"
        }
	],
    "attachments" : [
        {
            "href" : "https://www.totvs.com/wp-content/uploads/2021/04/totvs-shared.png?teste"
        }
    ]
}

Dica

Expandir

title	(201) - Operação realizada com sucesso

prescriptionCode	string	Código da receita no sistema	B4F_CODREC	*required
status	string	Status da receita dos medicamentos, sendo: 0 - Solicitado (Portal) 1 - Protocolado 2 - Em Analise 3 - Deferido 4 - Indeferido 5 - Deferido Parcialmente 6 - Pendente Inf. beneficiário A - Solicitação não concluída	B4F_STATUS	*required
prescriptionDescription	string	Descrição da receita	B4F_DESCRI	*required
subscriberId	string	Matricula do beneficiário	B4F_MATRIC	*required
subscriberName	string	Nome do beneficiário	BA1_NOMUSR	*required
registrationDate	string (date)	Data de cadastro da receita do medicamento	B4F_DTCAD	*required
professionalCouncil	string	Sigla do conselho regional do profissional da receita	B4F_SIGLA	*required
stateAbbreviation	string	Estado do conselho regional do profissional da receita	B4F_ESTSOL	*required
professionalCouncilNumber	string	Numero do conselho regional do profissional da receita	B4F_REGSOL	*required
professionalName	string	Nome do profissional da receita	BB0_NOME	*required
startValidityDate	string (date)	Data inicial de validade da receita	B4F_DATINI	*required
endValidityDate	string (date)	Data final de validade da receita	B4F_DATFIN	*required
medications	array	Medicamentos de contínuo da receita		*required
medications.tableCode	string	Código da tabela do medicamento	B7D_CODPAD	*required
medications.medicationCode	string	Código do medicamento	B7D_CODMED	*required
medications.medicationDescription	string	Descrição do medicamento	BR8_DESCRI	*required

Bloco de código

language	c#
theme	Emacs
title	Exemplo
linenumbers	true

{
    "prescriptionCode": "41750520230619000003",
    "status": "1",
    "prescriptionDescription": "Receita Nº 41750520230619000003.",
    "subscriberId": "00011008000027010",
    "subscriberName": "HERNANDES ALVES DA SILVA",
    "registrationDate": "2023-06-19",
    "professionalCouncil": "CRM",
    "stateAbbreviation": "SP",
    "professionalCouncilNumber": "334457",
    "professionalName": "VINICIUS",
    "startValidityDate": "2023-04-03",
    "endValidityDate": "2023-04-03",
    "medications": [
        {
            "tableCode": "04",
            "medicationCode": "0490173961",
            "medicationDescription": "DRAMIN 100 MG COM CT BL AL PLAS INC X 20"
        }
    ]
}

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: >>\"professionalCouncil\" : \"CRM\",\r\n    \"stateAbbreviation\" : \"SP\",\r\n    \"professionalName\" : \"VINICIUS\",\r\n    \"prescriptionDate\" : \"2023-04-03\",\r\n\t\"professionalCouncilNumber\" : \"334457\",\r\n\t\"medications\" : [\r\n        {\r\n            \"tableCode\" : \"04\",\r\n            \"medicationCode\" : \"0490173961\"\r\n        }\r\n\t],\r\n    \"attachments\" : [\r\n        {\r\n            \"href\" : \"https://www.totvs.com/wp-content/uploads/2021/04/totvs-shared.png?teste\"\r\n        }\r\n    ]\r\n}<<"
}

Aviso

Expandir

title	(406) - Campos 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.	*required

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": "E002D-406",
            "message": "Tipo inválido para o campo professionalCouncilNumber",
            "detailedMessage": "O valor do campo professionalCouncilNumber deve ser do tipo (C)."
        },
        {
            "code": "E002A-406",
            "message": "Campo attachments não informado",
            "detailedMessage": "Não foi informado o campo attachments."
        }
    ]
}

Aviso

Expandir

title	(404) - Operadora não encontrada

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

Bloco de código

language	c#
theme	Emacs
title	Exemplo
linenumbers	true

{
    "code": "E003",
    "message": "Operadora de Saúde não encontrada",
    "detailedMessage": "Não foi encontrada nenhum operadora de saúde com o código 0099"
}

Aviso

Expandir

title	(404) - Beneficiário não encontrado

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

Bloco de código

language	c#
theme	Emacs
title	Exemplo
linenumbers	true

{
    "code": "E004",
    "message": "Beneficiário não encontrado",
    "detailedMessage": "Não foi encontrado nenhum beneficiário com a matricula 00011008000027012"
}

Aviso

Expandir

title	(400) - Dados 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.	*required

Bloco de código

language	c#
theme	Emacs
title	Exemplo
linenumbers	true

{
    "code": "E005",
    "message": "Erro ao incluir receita de medicamentos de uso continuo.",
    "detailedMessage": "Verifique a lista de erros para mais detalhes",
    "details": [
        {
            "code": "E005-1",
            "message": "Não existe registro relacionado a chave informada no alias BR8, ordenação 1.",
            "detailedMessage": "Id do campo de erro: B7D_CODMED; Id do erro: REGNOIS"
        },
        {
            "code": "E005-1",
            "message": "Erro ao realizar download do arquivo.",
            "detailedMessage": "Status code: 404; Erro: Not Found\r\n; Url: https://www.totvs.com/wp-content/uploads/2022/04/totvs-shared.png?teste"
        }
    ]
}

Âncora

	#continuousMedicationsGet
	#continuousMedicationsGet

Painel

titleColor	Orange
borderStyle	solid
title	ContinuousMedications - Retorna os medicamentos de uso contínuo

Retorna os medicamentos de uso contínuo do beneficiário

/totvsHealthPlans/refundSetup/v1/continuousMedications

GET

Nota

Expandir

title	Parameters

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 (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
prescription-code (query)	string	Filtro de medicamentos pelo código da receita no sistema
prescription-status (query)	string	Filtro de medicamentos pelo status da receita, sendo: 0 - Solicitado (Portal) 1 - Protocolado 2 - Em Analise 3 - Deferido 4 - Indeferido 5 - Deferido Parcialmente 6 - Pendente Inf. beneficiário A - Solicitação não concluída pode ser enviado mais de um status. Exemplo: 0,1,2,3
medication-code (query)	string	Filtro de medicamentos pelo código
expiration-date (query)	string	Filtro de medicamentos pela validade, sendo: 1 - Medicamentos dentro da validade 2 - Medicamentos fora da validade
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

title	Request

Body

Não possui body!

Dica

Expandir

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

hasNext	boolean	Indica se ainda existem registros a serem retornados		*required
remainingRecords	numeric (integer)	Quantidade de registros ainda existem para retorno		*required
items	array	Lista de medicamentos
items.prescription-status	string	Status da receita do medicamento: 0 - Solicitado (Portal) 1 - Protocolado 2 - Em Analise 3 - Deferido 4 - Indeferido 5 - Deferido Parcialmente 6 - Pendente Inf. beneficiário A - Solicitação não concluída	B4F_STATUS	*required
items.prescription-code	string	Código da receita do medicamento	B7D_CODREC	*required
items.initial-medication-date	string (date)	Data inicial da validade do medicamento	B7D_DTVINI	*required
items.final-medication-date	string (date)	Data final da validade do medicamento	B7D_DTFVAL	*required
items.medication-code	string	Código do medicamento	B7D_CODMED	*required
items.medication-description	string	Descrição do medicamento	BR8_DESCRI	*required
items.unit-measure	string	Unidade de consumo do medicamento	B7D_UNICON
items.quantity-authorized	numeric (integer)	Quantidade autorizada do medicamento	B7D_QTDAUT
items.quantity-executed	numeric (integer)	Quantidade utilizada (executada) do medicamento	B7D_QTDEXE
items.state-abbreviation	string	Estado do conselho regional do profissional da receita	B4F_ESTSOL	*required
items.professional-council	string	Sigla do conselho regional do profissional da receita	B4F_SIGLA	*required
items.professional-council_number	string	Numero do conselho regional do profissional da receita	B4F_REGSOL	*required
items.professional-name	string	Nome do profissional da receita	BB0_NOME	*required

Bloco de código

language	c#
theme	Emacs
title	Exemplo
linenumbers	true

{
    "items": [
        {
            "prescription-status": "3",
            "prescription-code": "41750520230419000001",
            "initial-medication-date": "2023-01-01",
            "final-medication-date": "2023-01-01",
            "medication-code": "0490269497",
            "medication-description": "AAS ADULTO 500 MG COM CT BL AL PLAS INC X 20",
            "unit-measure": "",
            "quantity-authorized": 9999,
            "quantity-executed": 0,
            "state-abbreviation": "SP",
            "professional-council": "CRM",
            "professional-council_number": "1244477111",
            "professional-name": "FRANCISCO"
        },
        {
            "prescription-status": "1",
            "prescription-code": "41750520230619000001",
            "initial-medication-date": "2023-04-03",
            "final-medication-date": "2023-04-03",
            "medication-code": "0490173961",
            "medication-description": "DRAMIN 100 MG COM CT BL AL PLAS INC X 20",
            "unit-measure": "",
            "quantity-authorized": 0,
            "quantity-executed": 0,
            "state-abbreviation": "SP",
            "professional-council": "CRM",
            "professional-council_number": "334456",
            "professional-name": "VINICIUS"
        }
    ],
    "hasNext": true,
    "remainingRecords": 3
}

Aviso

Expandir

title	(406) - Parâmetros obrigatórios

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": "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-initial não informado",
            "detailedMessage": "Não foi informado o campo request-date-initial."
        },
        {
            "code": "E001A-406",
            "message": "Campo request-date-final não informado",
            "detailedMessage": "Não foi informado o campo request-date-final."
        },
        {
            "code": "E001A-406",
            "message": "Campo subscriber-id não informado",
            "detailedMessage": "Não foi informado o campo subscriber-id."
        }
    ]
}

Aviso

Expandir

title	(404) - Beneficiário não encontrado

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": "Beneficiário não encontrado",
    "detailedMessage": "Não foi encontrado nenhum beneficiário com a matricula 00011008000027013 no cadastro (BA1)"
}

03. TELA API CONTINUOUSMEDICATIONS

...

Campo	Descrição
B4F_CODREC	Código da receita no sistema
B7D_CODMED	Código do medicamento
B4F_STATUS	Status da receita do medicamento
MV_PLVALRE	Valida os medicamentos na solicitação de reembolso no portal pela data da receita ou pela data dos medicamentos

05. TABELAS UTILIZADAS

Beneficiários (BA1)
Operadoras de Saúde (BA0)
Cab. Cad. Receitas (B4F)
Medicamentos da Receita (B7D)
Profissionais de Saúde (BB0)
Tabela Padrão (BR8)

...

Árvore de páginas

Versões comparadas

Versão antiga 5

Nova versão 6

Chave

03. TELA API CONTINUOUSMEDICATIONS

05. TABELAS UTILIZADAS