Versões comparadas

Chave

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

Tópicos:

Índice

Endpoint: reembolso/inserir

Descrição: Responsável por inserir um novo reembolso para análise, o beneficiário envia seus dados
pessoais, uma ou mais despesas e para cada despesa um ou mais comprovantes de reembolso.

Como Configurar a URL de Callback:

Acesse o seu painel administrativo em: painel.tapcore.com.br. No menu lateral, busque a funcionalidade: Beneficiário > Reembolso >

Informações
titleConfiguração

Preencha o campo: URL de callback com a URL que receberá a requisição de callback após inserção
de um novo reembolso.

Especificação do Callback do Reembolso Online:

O callback será feito através de uma requisição HTTP do tipo POST ao serviço cadastrado, os
parâmetros serão enviados via RAW no formato JSON, conforme as especificações abaixo:


Bloco de código
themeEclipse
firstline1
titleExemplo de RAW enviado para url de callback
linenumberstrue
{
	"protocolo": "3139042017080113117" ,
	"id_operadora": "71",
	"mshash": "NjA1ZDhkNjkzN2RjMzE3NTg2ZjUyMzgyZTk5ZTkyMGU4MDA2ZGFiNg==",
	"matricula_titular": "30000309100060",
	"matricula_beneficiario": "30000309100060",
	"cpf_titular": "04253582753",
	"telefone": "",
	"nome_titular": "",
	"operadora_ans": "",
	"despesas":
	[{
		"utilizador_matricula": "123",
		"utilizador_nome": "",
		"id_tipo_reembolso": "",
		"prestador_documento": "",
		"data_despesa": "2016-11-20",
		"valor_despsa": "200.40",
		"arquivos": [{
			"url": "http://mobilesaude.com.br/files/teste.txt",
			"nome": "teste.txt"
		},
		{
			"url": "http://mobilesaude.com.br/files/teste.txt",
			"nome": "teste.txt"
		}]
	},
	{
		"utilizado_matricula": "123",
		"utilizador_nome": "",
		"id_tipo_reembolso": "",
		"prestador_documento": "",
		"data_despesa": "2016-11-20",
		"valor_despsa": "200.40",
		"arquivos": [],
		"url": "http://mobilesaude.com.br/files/teste.txt",
		"nome": "teste.txt",
		"diretorio": "reembolsos"
	}]
}


Retornos de Sucesso Callback Reembolso On-line

Todo callback executado, que tenha como retorno status header 200 será considerado uma conexão de sucesso, independente do seu retorno.
É possível alterar o status do reembolso e a atribuição através de retornos padrões, basta que o serviço de integração retorne algum dos padrões abaixo:

Bloco de código
themeEclipse
firstline1
titleRetorno de alteração de status
linenumberstrue
{
	"protocolo" : "3139042017080113117" ,
	"mshash" : "NjA1ZDhkNjkzN2RjMzE3NTg2ZjUyMzgyZTk5ZTkyMGU4MDA2ZGFiNg==" ,
	"status" : "2"
}


Informações
titlePara lista de status, consultar o endpoint

/plataforma_beneficiario/reembolso_online/v1/api/status/listar

Retorno alteração de atribuição

Bloco de código
themeEclipse
firstline1
linenumberstrue
{
	"protocolo" : "3139042017080113117" ,
	"mshash" : "NjA1ZDhkNjkzN2RjMzE3NTg2ZjUyMzgyZTk5ZTkyMGU4MDA2ZGFiNg==" ,
	"id_ms_usuario" : "2"
}


Dica

Para lista de usuários, consultar painel administrativo


Retorno com Alteração de Valores

Bloco de código
themeEclipse
firstline1
titleOs valores devem ser atribuidos por despesas como no padrão abaixo
linenumberstrue
{
	"protocolo" : "3139042017080113117" ,
	"mshash" : "NjA1ZDhkNjkzN2RjMzE3NTg2ZjUyMzgyZTk5ZTkyMGU4MDA2ZGFiNg==" ,
	"despesas" : [{
		"id_status_reembolso" : "" ,
		"id_despesa_reembolso" : "" ,
		"valor_glosado" : 99.99,
		"valor_uso_indevido" : 99.99,
		"valor_coparticipacao" : 99.99 ,
		"valor_reembolsado" : 99.99 ,
		"observacao" : "Teste observacao"
	}]
}