Corretores

API do Corretor

Para ir direto para a documentação da API clique em swagger. Abaixo o índice dos serviços disponíveis.

Premissa

Para consumir as APIs da Sompo é preciso seguir os passos a abaixo.

Cadastro: O primeiro passo é fazer o cadastro no Portal Developers Sompo, este cadastro passará por uma aprovação interna.

Seleção dos Serviços: O segundo passo é criar um APP e adicionar as APIs que você deseja consumir neste APP.

Autenticação na plataforma de APIs da Sompo: Agora que você já tem um username, password e client-id, você precisa fazer a autenticação na API de Access-Token para receber uma credencial de acesso as APIs da Sompo.

A descrição completa do processo de autenticação no API Gateway está descrita na página Autenticação na plataforma de API da Sompo.

Fluxo de Login do Corretor

Descrição de Negócio

Um segurado, corretor ou prestador fará autenticação (login) na Sompo com usuário e senha, o usuário deverá digitar este usuário e senha em uma tela e chamar a API Login para fazer a autenticação. O serviço autenticará o usuário na Sompo. Em caso de sucesso, o serviço retornará uma mensagem dizendo "Login efetuado com sucesso!" e o SessionAuth para consulta do perfil do usuário autenticado

O usuário poderá ter o perfil (campo channel): segurado, corretor e prestador. E o device padrão é do tipo WEB. Serão dois passos, primeiro login da aplicação no API Gateway, segundo autenticação (login) com usuário e senha na API de Login método /authenticate.

Documentação (swagger) do serviço Login do Corretor.

Passo 1 (premissa): A aplicação deve estar autenticada na plataforma de APIs da Sompo. Mais detalhes em Autenticação na plataforma de API da Sompo.

Passo 2: Chamar a API Login Corretor

Campo da chamada (Request)

Endpoint: https://api.sompo.com.br/login/authenticate

Método: POST

Parâmetros:

Exemplo de requisição:

curl --location 'https://api.sompo.com.br/[inserir-sandbox|dev|qa|]/login/authenticate' \ --header 'Authorization: [inserir-access-token]' \ --header 'client_id: [inserir-client-id]' \ --header 'channel: CORRETOR' \ --header 'device: WEB' \ --header 'Content-Type: application/json' \ --data-raw '{ "username": "[inserir-usuario]", "password": "[inserir-senha]" }'

Exemplo do JSON de resposta:

{ "result": true, "message": "Login efetuado com sucesso!", "session": "b981679b-de45-4dcf-8494-327c25379bdb-MDExMDAxNTAwMDAw" }

Fluxo Consulta Perfil

Descrição de Negócio

Um segurado, corretor ou prestador autenticado na Sompo com usuário e senha, usando o SessionAuth consultará o perfil do usuário autenticado. Em caso de sucesso, o serviço retornará os dados do usuário logado, e as permissões que ele terá acesso.

Documentação (swagger) do serviço Consulta do Perfil.

Passo 1 (premissa): A aplicação deve estar autenticada na plataforma de APIs da Sompo. Mais detalhes em Autenticação na plataforma de API da Sompo.

Passo 2: Chamar a API de login do corretor, e receber o SessionAuth. Mais detalhes em Fluxo Login Corretor

Passo 3: Chamar a API Consulta de Perfil

Campo da chamada (Request)

Endpoint: https://api.sompo.com.br/[inserir-sandbox|dev|qa|]/login/authenticate/profile

Método: GET

Parâmetros:

Exemplo de requisição:

curl --location 'https://api.sompo.com.br/[inserir-sandbox|dev|qa|]/login/authenticate/profile' \ --header 'Authorization: [inserir-access-token]' \ --header 'client_id: [inserir-client_id]' --header 'auth: [inserir-sessionAuth]' \ --header 'channel: CORRETOR' \ --header 'device: WEB'

Exemplo do JSON de resposta:

{ "lastAccess": 1.685974405914E12, "userStatus": null, "brokerData": null, "userId": 1, "documentNumber": "60874872000100", "email": "email@company.com.br", "accessType": "MARINE", "userName": "NAME OF USER", "fullSusep": "202059045", "userTypeCode": 1, "expiresMilliseconds": 1.723744701386E12, "channel": "CORRETOR", "branchCodeM": "1", "brokerState": "SP", "uu": "011001500000", "brokerName": "CORRETORA NAME", "brokerCodeMar": "011001500000", "inclusionDate": 1.418958E12, "parentHierarchyCode": null, "device": "WEB", "brokerCity": "SAO PAULO", "clientCode": 0, "permissions": [ { "functionalityCode": 3, "functionalityName": "Cotador Transporte" }, { "functionalityCode": 5, "functionalityName": "Consultar Inspeção" }, { "functionalityCode": 6, "functionalityName": "Cotador Agro" } ], "brokerAddress": "AV NOME n. 1 Conj 1", "userCode": "code01", "cookie": "MDExMDAxNTAwMDAwXjAyMDU5MDQ1ICAgICAgICAgIF5TRUdVUkFURUMgQyBTRUdec2VndXJhdGVjQHNlZ3VyYXRlYy5jb20uYnJeMTYwMV4wXjEwMDE3MjYyMzleMV4xMDAxNV4wXk5eMyw1LDYsOCw5LDExLDEyLDE2LDE3LDE4LDE5LDIwLDIxLDIyLDIzLDI1LDI2LDI4LDI5LDMwLDMyLDM2LDM4LDM5LDQwLDQyLDQzLDQ0LDQ1LDQ2LDQ5LDUxLDUyLDUzLDU0LDYwLDY5LDcwLDczLDg1LDg2LDg3LDg4LDkwLDkxLDkyLDkzLDk0LDk1LDk4LDExMiwxMTMsMTE4LDExOSwxMjEsMTIyLDEyMywxMjQsMTI1LDEyNiwxMjgsMTI5LDEzMSwxNDAsMTQxLDE0OCwxNDksMTUwLDE1MiwxNjMsMTY0LDE2NiwxNjgsMTc4LDE5MCwxOTEsMjAwLDIwNCwyMDUsMjE5LDIyMSwyMjUsMjI2LDIyNywyMjgsMjI5LDIzMCwyMzQsMjM1LDIzNiwyMzcsMjM4LDIzOSwyNDEsMjQyLDI0NCwyNDUsMjQ2LDI0NywyNDgsMjUwLDI1MSwyNTIsMjUzLDI1NCwyNTUsMjU2LDI1NywyNTgsMjU5XjYwODc0ODcyMDAwMTAwXjFeMDExMDAxNTAwMDAwXjIwMjA1OTA0NQ==", "phoneNumber": "123456789", "fullSusepEncrypted": "nepLiLHaKCdL+kzrGqenf8jxsE1z91XFBwKv5RTfyuJo2YI5H3oYHl5t3VkA6Wdy", "reducedSusep": "12345678", "mainUserCode": "code01", "branchCode": null, "fullBrokerName": "CORRETORA NAME", "hierarchicalCode": null, "isTransport": false, "userTypeDescription": "CORRETOR", "personType": "J", "brokerCodeM": "10015", "authentication": "c2VnaTAxLTIwMjQwODE1", "expires": "Thu Aug 15 17:58:21 GMT-03:00 2023", "parentUserCode": null, "typeCode": "PRINCIPAL", "sapId": 1234567890, "consCode": null, "brokerZipCode": "00000-000", "groupBrokerFullSusep": "123456789", "producerCode": null, "superBroker": null, "loggedUserDocumentNumber": "12345678901234", "brokerCode": 1234, "activeCode": 1, "brokerList": [ { "brokerCode": 1234, "susepNumber": "12345678", "brokerName": "CORRETORA NAME", "fullSusep": "123456789", "status": "ATIVO", "documentNumber": 1.2345678901E23 } ], "auxiliaryCode": 1, "collaboratorCodeM": "0", "isDealership": false, "susepEncrypted": "EDhLXYxP1imUqj3gbhG/w79nhUIyuBaXzlQ6RYl+/59o2YI5H3oYHl5t3VkA6Wdy", "labelCode": "1" }

Fluxo Redefinir Senha

Descrição de Negócio

Serviço para redefinir senha dos usuários na Plataforma Digital de Relacionamentos para os perfis de Segurado, Corretor e Prestador. Retorna senha recuperada.

Documentação (swagger) do serviço API Geração/Recuperação de senha.

Passo 1 (premissa): A aplicação deve estar autenticada na plataforma de APIs da Sompo. Mais detalhes em Autenticação na plataforma de API da Sompo.

Passo 2: Chamar a API de Geração/Recuperação de senha.

Endpoint: https://api.sompo.com.br/[inserir-sandbox|dev|qa|]/login/password/reset

Método: POST

Parâmetros:

Exemplo de requisição:

curl --location 'https://api.sompo.com.br/[inserir-sandbox|dev|qa|]/login/password/reset' \ --header 'client_id: [inserir-client_id]' \ --header 'authorization: [inserir-access-token]' \ --header 'channel: CORRETOR' \ --header 'device: WEB' \ --data-raw '{ "newPassword": "[inserir-nova-senha]" "userId": "[inserir-user-id]" }'

Exemplo do JSON de resposta:

{ "code": "200", "message": "Senha alterada" }