Tópicos:
Índice
URL base API
| Ambientes | URL |
|---|---|
| Homologação | https://ms3.tapcore.com.br/mssuite/plataforma_beneficiario |
| Produção | https://ms3.tapcore.com.br/mssuite/plataforma_beneficiario |
Como configurar a URL de Callback
Acesse o seu painel administrativo em: painel.tapcore.com.br e no menu lateral busque a funcionalidade:
Beneficiário -> Solicitações de Cartão -> Configuração
Preencha o campo: URL de Callback com a URL que receberá a requisição de callback após inserção de uma nova solicitação de cartão.
Segurança das URLs
| Informações | ||
|---|---|---|
| ||
|
Por questões de segurança todas as imagens ou objetos disponíveis através de uma URL serão enviadas com uma assinatura, desta forma, o download dos objetos ou imagens disponíveis, só serão possíveis por um período de aproximadamente 15 minutos.
Recomenda-se que seja feito o download da imagem ou objeto assinado assim que receber este payload e não salve a URL pois ela ficará indisponível após o tempo pré-determinado.
Em casos que seja necessário o acesso a este objeto ou imagem depois desse período, re-envie o callback através do painel para receber uma nova assinatura válida por mais 15 minutos
Exemplo da url ->https://autorizacao.s3-sa-east-1.amazonaws.com/AWSAccessKeyId=ABC&Expires=1616095118&Signature=ABCD
Parâmetros
Endpoint
| Endpoint | Método | Descrição |
|---|---|---|
solicitacao/solicitacao_cartao | PUT | Responsável por inserir uma nova solicitação de segunda via de cartão para análise, o beneficiário informa os beneficiários que desejam novos cartões, motivo e forma de entrega, por fim os administradores autorizam ou não a segunda via. |
Parâmetros
| Parâmetro | Obrigatório | Tipo | Descrição | |||||||
|---|---|---|---|---|---|---|---|---|---|---|
| protocolo | true |
| ||||||||
mshash | true |
| HASH que identifica de qual ambiente (Homologação ou Produção) os dados serão buscados. | |||||||
| id_solicitacao_cartao | true |
| ||||||||
| id_operadora | true |
| Id da operadora para a qual serão buscados os grupos de menu | |||||||
| id_aplicacao | true |
| ||||||||
| id_status_cartao | true |
| ||||||||
| id_motivo_solic_cartao | true |
| ||||||||
| id_forma_entrega_cartao | true |
| ||||||||
| nome_titular | true |
| ||||||||
| cpf_titular | true |
| ||||||||
| matricula_titular | true |
| ||||||||
| telefone_titular | true |
| ||||||||
| estado_civil_titular | true |
| ||||||||
| email_titular | true |
| ||||||||
| patrocinadora_titular | false |
| ||||||||
| descricao | false |
| ||||||||
| protocolo | true |
| ||||||||
| data | true |
| ||||||||
| forma_entrega | true |
| ||||||||
| motivo | true |
| ||||||||
| arquivos | true |
| ||||||||
| arquivos.id_arquivo | true |
| ||||||||
| arquivos.nome | true |
| ||||||||
| arquivos.diretorio | true |
| ||||||||
| arquivos.url | true |
| ||||||||
| arquivos.id_solicitacao_cartao | true |
| ||||||||
| beneficiarios | true |
| ||||||||
| beneficiarios.id_beneficiario_cartao | true |
| ||||||||
| beneficiarios.nome | true |
| ||||||||
| beneficiarios.matricula | true |
| ||||||||
| beneficiarios.parentesco | true |
| ||||||||
| beneficiarios.data_nascimento | true |
| ||||||||
| beneficiarios.id_solicitacao_cartao | true |
| ||||||||
| endereco_alternativo | false |
| ||||||||
| status | true |
|
Parâmetros
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 | ||||||||
|---|---|---|---|---|---|---|---|---|
| ||||||||
{
"protocolo" : "xyz123",
"mshash" : "",
"id_solicitacao_cartao": 999,
"id_operadora": 99,
"id_aplicacao": 7,
"id_statusmotivo_solic_cartao": 16,
"id_motivoforma_solicentrega_cartao": 63,
"id_formastatus_entrega_cartao": 31,
"nomematricula_titular": "Nome de teste000100020003",
"cpfnome_titular": 12121166742 "Nome de teste",
"matriculacpf_titular": "000100020003"12121166742,
"telefone_titular": 27000666898,
"estado_civil_titular": "Solteiro",
"email_titular": "teste@gmail.com",
"patrocinadora_titular": null,
"descricao": null,
"protocolo": "3139042017080200355",
"data": "2017-08-02 13:34:38",
"endereco_alternativo": "",
"forma_entregaprotocolo" : "Entregar ao Titular pelos correiosxyz123",
"mshash" : "",
"motivo": "Perda",
"forma_entrega": "Entregar ao Titular pelos correios",
"arquivos": [{
"id_arquivo": 59,
"nome": "c094be33c587e163ee702662491cd1a55ca6f854f.pdf",
"diretorio": null,
"url": https://s3-sa-east-1.amazonaws.com/solicitacao-cartao-ms/teste.pdfAWSAccessKeyId=ABC&Expires=1616095118&Signature=ABCD,
"id_solicitacao_cartao": 117
}],
"beneficiarios": [{
"id_beneficiario_cartao": 133,
"id_solicitacao_cartao": 117,
"nome": "Teste Romano Teste Rizzi",
"matricula": "000100020003",
"parentesco": "Titular",
"data_nascimento": "1991-02-23",
"id_solicitacao_cartao": 117
}],
"endereco_alternativo": null,
"status": "Solicitado"
} |
Retornos de sucesso Callback - Segunda Via de Cartão
| Bloco de código | ||||||||
|---|---|---|---|---|---|---|---|---|
| ||||||||
{
"protocolo" : "3139042017080113117" ,
"mshash" : "NjA1ZDhkNjkzN2RjMzE3NTg2ZjUyMzgyZTk5ZTkyMGU4MDA2ZGFiNg==" ,
"id_status_cartao" : "2"
} |
| Nota | ||
|---|---|---|
| ||
| Todo callback executado, que tenha como retorno status header 200 será considerado uma conexão de sucesso, independente do seu retorno. É possível também alterar o status de uma solicitação de atualização cadastral, basta que o serviço de integração retorne em seu body um json no padrão abaixo. |