Transmitir Proposta

Permite transmitir uma Proposta para a contratação de uma cobertura.

Índice:

1 Requisição (Envio)
- 1.1 Parâmetros disponíveis
2 Resposta (Retorno)
- 2.1 Exemplo Retornado da Transmissão de uma Proposta
3 Guia para contratação usando Cartão de Crédito

Requisição (Envio)

Especificação detalhada de como transmitir uma Proposta e os respectivos parâmetros disponíveis.

Parâmetros disponíveis

Campo (Key)	Tipo	Formato	Exemplo Valor	Obs/Restrições

Campo (Key)	Tipo	Formato	Exemplo Valor	Obs/Restrições
login	string	““	““	O mesmo Login utilizado para acessar o Cotador da Suhai. (o Login precisa estar vinculado a uma Corretora no cadastro do Cotador Suhai) obrigatório
senha	string	““	““	A mesma Senha utilizada para acessar o Cotador da Suhai. obrigatório
protocolo	integer	0	28370	Digite o ID do cálculo (Protocolo) gerado no retorno da cotação. obrigatório
email	string	““	“teste@suhai.com”	Digite o e-mail do segurado obrigatório
ddd_cel	integer	0	11	Digitar o número do DDD do celular do segurado OBRIgatório
num_cel	integer	0	999999999	Digitar o número do celular do segurado obrigatório
ddd_com	integer	0	11	Digitar o DDD comercial do segurado
num_com	integer	0	32222222	Digitar o número comercial do segurado
ramal_com	integer	0	0	Digitar o ramal comercial do segurado
ddd_res	integer	0	11	Digitar o DDD residencial do segurado
num_res	integer	0	32222222	Digitar o número residencial do segurado
ramal_res	integer	0	0	Digitar o número do ramal residencial do segurado
end_nom_log	string	““	“RUA TESTE“	Digite o endereço residencial do segurado obrigatório
end_num	string	““	“130“	Digite o número do endereço residencial do segurado Obrigatório
bairro	string	““	“VILA TESTE“	Digite o bairro residencial do segurado obrigatório
end_compl	string	““	““	Digite o complemento do endereço do segurado
uf	string	““	“SP“	Digite as siglas do estado residencial do segurado obrigatório
cidade	string	““	“SÃO PAULO“	Digite a cidade residencial do segurado obrigatório
cep	integer	0	04133001	Digite o CEP do endereço residencial do segurado. Formato de preenchimento = 99999999 (sempre com 8 dígitos) obrigatório
cod_ci	string	““	““	Em casos de seguro novo, deixar esse campo vazio, pois, esse campo é de preenchimento obrigatório apenas em renovações. Digitar o código CI da apólice anterior do segurado obrigatório Apenas para renovações.
nro_apolice_ant	string	““	““	Em casos de seguro novo, deixar esse campo vazio, pois, esse campo é de preenchimento obrigatório apenas em renovações. Digitar o número da apólice anterior do segurado. obrigatório Apenas para renovações.
cod_seg_ant	integer	0	0	Em casos de seguro novo, deixar esse campo vazio, pois, esse campo é de preenchimento obrigatório apenas em renovações. Digitar o código da seguradora anterior. obrigatório Apenas para renovações.
nome_seg_ant	string	““	““	Em casos de seguro novo, deixar esse campo vazio, pois, esse campo é de preenchimento obrigatório apenas em renovações. Digitar o nome da seguradora anterior. obrigatório Apenas para renovações.
chassi	string	““	““	Digite o chassi do veículo que será segurado. Obrigatório
placa	string	““	““	Digite a placa do veículo que será segurado, informando as Letras em Maiúsculo. Obs.: quando o Veículo for 0KM, informar a Placa como YYY9999 obrigatório
cor	integer	0	4	Digite o número correspondente a cor do veículo que será segurado. 1- Amarelo 2- Azul 3- Bege 4- Branco 5- Bronze 6- Cinza 7- Dourado 8- Laranja 9- Marrom 10- Prata 11- Preto 12- Rosa 13- Roxo 14- Verde 15- Vermelho 16- Vinho 18- Não Informado obrigatório
combustivel	integer	0	6	Digite o número correspondente ao tipo de combustível do veículo que será segurado. 1- Alcool 2- Diesel 3- Hibrido 4- Flex 5- GNV 6- Gasolina 8- Não Informado obrigatório
renavam	integer	0	0	Digite o Renavam do veículo que será segurado.
data_vig_ini	date	yyyy-mm-dd	2022-04-10	Digite a data do início de vigência da proposta. Se preencher a <data_vig_ini> com Data anterior à Data atual = a Proposta é gerada considerando essa Data informada como Início de Vigência; Se preencher a <data_vig_ini> com Data posterior à Data atual = a Proposta é gerada considerando essa Data informada como Início de Vigência (Vigência futura); Se preencher a <data_vig_ini> com a mesma Data atual = a Proposta é gerada considerando essa Data informada como Início de Vigência; Se não preencher a Tag <data_vig_ini> = é retornada a crítica ‘Início de vigência obrigatório’. A Data de Início de Vigência informada nessa Tag não pode ser posterior a um mês, em relação à data atual. obrigatório
tp_pagamento	integer	0	1	Digitar o número correspondente ao tipo de pagamento. 1 = Boleto - 1ª parcela 3 dias pós início vigência/mínimo 5 dias emissão (ver observação) 2 = Boleto - 1ª parcela 3 dias pós início vigência/mínimo 5 dias emissão 11 = Cartão Crédito - 1ª parcela + Boleto para demais parcelas - (Vide Observação 2) 14 = Parcelado Cartão Recorrente - (Vide Observação 2) Observação: Até dia 07/05/2022, a opção 1 era utilizada para forma de pagamento “Boleto - 1ª parcela antecipada”, em função da implantação do projeto Circular 642, passamos a considerar a opção 1 igual a opção 2. Pedimos não utilizar a opção 1, pois será descontinuada. Observação 2: Para contratar o seguro Suhai, utilizando as formas de pagamento de cartão de crédito (domínios 11 e 14 desta tag), é necessário também que o Parceiro realize a adequação de seus sistemas através do guia: Insere Dados de Pagamento Veja a sequencia de processamento nesse link : Como contratar com forma de pagamento cartão de crédito obrigatório
vect_demais_parcelas	integer	0	5	Dia de vencimento das demais parcelas. 1 a 31 obrigatório
qtd_parcelas	integer	0	12	Quantidade de parcelas. 1 a 12 obrigatório
cdCobertura	integer	0	1003	Digitar o número correspondente a cobertura que será contratada. 1003 = Seguro Roubo/Furto Total + Assistência 24h 1009 = Seguro Roubo/Furto Total e de Perda Total por Colisão/Danos + Assistência 24h 10031 = Seguro Roubo/Furto Total + Assistência 24h + RCF 10091 = Seguro Roubo/Furto Total e de Perda Total por Colisão/Danos + Assistência 24h + RCF 10111 = Compreensiva (Roubo + Furto + Perda Total por Colisão ou Danos + Perdas Parciais) + Assistência 24h - 200 km + RCF" 10010 = Terceiros (RCF) + Assistência 24h - 200 km obrigatório
data_saida_concessionaria	date	yyyy-mm-dd	2022-05-03	Se for informado “N” na Tag <zeroKM> na Cotação gerada, a informação Data de Saída da Concessionária não precisa ser enviada nessa Tag. Se for informado “S” na Tag <zeroKM> na Cotação gerada, a informação Data de Saída da Concessionária será de preenchimento obrigatório nessa Tag. obrigatório Apenas quando a Tag <zeroKM> na respectiva Cotação da Proposta for igual a “S”. Caso contrário, o preenchimento dessa Tag não é obrigatório.
data_vp_financeira	date	yyyy-mm-dd	2022-05-03	Preencher tag somente se configurado a funcionalidade de dispensa de vistoria prévia, demandado pela área Comercial da Suhai Seguradora, para o corretor ou parceiro de negócio associado. Se a data de transmissão da proposta, for menor ou igual a 3 dias da data da vistoria prévia, Liberar VP e não criar pendência de vistoria; Se o campo Data_VP_Financeira não for preenchido em tempo de proposta, ignorar a configuração no cadastro do corretor e aplicar a regra de vistoria normalmente, criando a pendência de VP.
cod_oper_co_corretagem	string	““	OP001	Código da operação de co-corretagem que define o percentual de participação dos corretores Obs: Quando informado um valor nessa tag, o código será validado de acordo com as configurações no cadastro do corretor que está realizando a cotação Obs2 : Esta tag não atende aos vínculos de representante e assessoria, somente corretor e co corretor. obrigatório Somente quando cpf_cnpj_co_corretor vier preenchido
cpf_cnpj_co_corretor	integer	0	12345678911	CPF (com 11 dígitos) ou CNPJ (com 14 dígitos) do co_corretor, sem separadores. O Corretor deve estar cadastrado no Cotador Obs : Esta tag não atende aos vínculos de representante e assessoria, somente corretor e co corretor. obrigatório Somente quando cod_oper_co_corretagem vier preenchido

Exemplo de uma Requisição para Transmitir Proposta

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:suh="http://suhaiseguradoracotacao.com.br:5155/">
   <soapenv:Header/>
   <soapenv:Body>
      <suh:TransmitirProposta>
         <suh:proposta>
            <suh:login>Conforme Especificação dessa Tag</suh:login>
            <suh:senha>Conforme Especificação dessa Tag</suh:senha>
            <suh:protocolo>28370</suh:protocolo>
            <suh:email>teste@suhai.com</suh:email>
            <suh:ddd_cel>11</suh:ddd_cel>
            <suh:num_cel>912345678</suh:num_cel>
            <suh:ddd_com></suh:ddd_com>
            <suh:num_com></suh:num_com>
            <suh:ramal_com></suh:ramal_com>
            <suh:ddd_res></suh:ddd_res>
            <suh:num_res></suh:num_res>
            <suh:ramal_res></suh:ramal_res>
            <suh:end_nom_log>Rua Afonso Celso</suh:end_nom_log>
            <suh:end_num>126</suh:end_num>
            <suh:bairro>Vila Mariana</suh:bairro>
            <suh:end_compl></suh:end_compl>
            <suh:uf>SP</suh:uf>
            <suh:cidade>São Paulo</suh:cidade>
            <suh:cep>04119000</suh:cep>
            <suh:cod_ci></suh:cod_ci>
            <suh:nro_apolice_ant></suh:nro_apolice_ant>
            <suh:cod_seg_ant></suh:cod_seg_ant>
            <suh:nome_seg_ant></suh:nome_seg_ant>
            <suh:chassi>9C6KE1940E0000171</suh:chassi>
            <suh:placa>FAV5452</suh:placa>
            <suh:cor>2</suh:cor>
            <suh:combustivel>6</suh:combustivel>
            <suh:renavam>111111111</suh:renavam>
            <suh:data_vig_ini>2019-11-11</suh:data_vig_ini>
            <suh:tp_pagamento>1</suh:tp_pagamento>
            <suh:vecto_demais_parcelas>5</suh:vecto_demais_parcelas>
            <suh:qtd_parcelas>5</suh:qtd_parcelas>
            <suh:cdCobertura>1009</suh:cdCobertura>
            <suh:data_saida_concessionaria></suh:data_saida_concessionaria>            
         </suh:proposta>
      </suh:TransmitirProposta>
   </soapenv:Body>
</soapenv:Envelope>

Resposta (Retorno)

Especificação detalhada das informações retornadas de uma Proposta transmitida.

Campo (Key)	Tipo	Formato	Exemplo Valor	Descrição

Campo (Key)	Tipo	Formato	Exemplo Valor	Descrição
protocolo	integer	0	28370	Retorna o protocolo utilizado para transmitir a proposta.
codMsgRet	integer	0	001 \| 503	Retorna um código padrão: 001 = Sucesso e 503 = Erro.
textoMsgRet	string	““	“Sucesso” \| “Erro”	Quando o codMsgRet for 001, retornará a mensagem padrão "Sucesso", quando o codMsgRet for 503, retornará uma mensagem informando o porque do erro.
Proposta	integer	0	30765	Retornará o número da proposta transmitida. É com este número que será possível encontrar a proposta dentro do cotador Suhai.

Exemplo Retornado da Transmissão de uma Proposta

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
   <soap:Body>
      <TransmitirPropostaResponse xmlns="http://suhaiseguradoracotacao.com.br:5155/">
         <TransmitirPropostaResult>
            <protocolo>28370</protocolo>
            <codMsgRet>001</codMsgRet>
            <textoMsgRet>Sucesso</textoMsgRet>
            <proposta>30765</proposta>
         </TransmitirPropostaResult>
      </TransmitirPropostaResponse>
   </soap:Body>
</soap:Envelope>

Guia para contratação usando Cartão de Crédito

Sequência de processamento para contratação de seguros Suhai com a forma de pagamento Cartão de Crédito:

Passo 1 - Realizar o processo de transmissão da proposta com o uso de um dos novos domínios disponibilizados para cartão de crédito na tag tp_pagamento:

<suh:tp_pagamento>11</suh:tp_pagamento> OU <suh:tp_pagamento>14</suh:tp_pagamento>

Passo 2 - Após o retorno com sucesso do método TransmitirProposta, deve-se acionar a API Insere Dados de Pagamento submetendo a ela o número da proposta obtido.

Diagrama de Sequência ilustrativo: